이미지·오디오·비디오

이미지 읽기

Vision 라벨 모델은 PNG/JPEG/WebP/GIF 이미지를 받습니다. Anthropic Messages의 Claude에는 질문과 같은 content 배열에 base64 이미지를 보내세요:

curl https://apivn.dev/v1/messages \
  -H "x-api-key: ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 512,
    "messages": [{
      "role": "user",
      "content": [
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/png",
            "data": "iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAIAAAAlC+aJAAAAXElEQVR4nO3PIREAIBAAsI+DQaPJhKbVF0JTggiIt7tbgcUds6LlKur7VISAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAwM8D31WVS4B9/IAAAAAASUVORK5CYII="
          }
        },
        {"type": "text", "text": "이 이미지 내용 설명"}
      ]
    }]
  }'

16개 GPT 모델이 /v1/chat/completions에서 직접 OpenAI image_url 표준을 사용합니다. 게이트웨이는 base64 데이터 URL과 http(s) 이미지 URL 모두 지원합니다:

{
  "model": "gpt-5.6-sol",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "이 이미지 내용 읽기"},
      {
        "type": "image_url",
        "image_url": {"url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAIAAAAlC+aJAAAAXElEQVR4nO3PIREAIBAAsI+DQaPJhKbVF0JTggiIt7tbgcUds6LlKur7VISAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAwM8D31WVS4B9/IAAAAAASUVORK5CYII="}
      }
    ]
  }]
}

공급자가 반환한 이미지 토큰은 입력 토큰으로 기록되어 요금이 부과됩니다. 전송 전에 이미지를 압축하고 전체 요청 내용을 20 MB 제한 이내로 유지하는 것이 좋습니다.

이미지·오디오·비디오

이미지 생성 및 편집

이미지 생성, 참조 이미지, 결과 처리와 요금을 위한 JSON 안내입니다.

전체 가이드 보기

/v1/images/generations

curl https://apivn.dev/v1/images/generations \
  -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "req/gpt-image-2",
    "prompt": "a tiny red circle on white",
    "size": "1024x1024",
    "n": 1
  }'

/v1/images/edits

curl https://apivn.dev/v1/images/edits \
  -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "req/gpt-image-2",
    "prompt": "keep the same subject, soft studio lighting",
    "image": "https://example.com/reference.png",
    "size": "1024x1024",
    "n": 1
  }'

# image / image_url / reference_image / ref_image:
# data URL, base64 thuần, hoặc URL http(s) công khai