Nội dungĐọc hình ảnh
ドキュメントに戻る

画像・音声・動画

形式とジョブの状態遷移を確認。

画像・音声・動画の送信前にモデルの対応機能を確認してください。非同期動画ではジョブ ID を保存して状態を照会し、応答が途切れても自動で再作成しないでください。

画像認識

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モデルがOpenAI標準のimage_url形式を /v1/chat/completions で直接サポート。ゲートウェイは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
動画生成

例はソース確認とローカル検証の対象であり、全アプリバージョンの実機検証を意味しません。実運用前に設定、小さなリクエスト、使用量を確認してください。

Support