動画 API

概要

動画 API は タスク方式 で動画生成リクエストを送ります。送信エンドポイントは画像 API と共通の POST /api/generate/submit で、違いは model フィールドと input フィールド（動画用に duration / seconds が追加で受け付けられます）。送信すると即座に task_id が返るので、GET /api/generate/status/{task_id} を status=finished までポーリングしてください。

認証

AI API と同じ Bearer トークン：Authorization: Bearer sk-xxxxxx。

共通リクエスト構造

{
  "model": "sora-2 | sora-2-pro | veo-3.0-generate-001 | veo-3.1-generate-preview | ...",
  "input": {
    "prompt": "動画の説明",
    "size": "WxH ピクセル、例：1280x720 / 1920x1080 / 720x1280",
    "duration": 4,
    "seconds": "4",
    "image": "先頭フレーム参照画像 URL（任意）",
    "images": ["先頭フレーム参照画像 URL リスト（任意）"],
    "metadata": { /* モデル固有パラメータ */ }
  }
}

input の直下に置けるのは prompt / size / image / images / duration / seconds のみ。それ以外のフィールド（aspectRatio、resolution、negativePrompt など）は input.metadata に入れる必要があります。直下に置くと 400 が返ります。

file_type は現在 `image` 固定

完了レスポンスの data.files[].file_type は現在の実装ではメディアタイプに関係なく常に "image" を返します。動画かどうかの判定は file_url の拡張子や呼び出し元のコンテキストで行ってください。

概要

共通リクエスト構造

モデル

sora-2

veo-3

目次