動画タスクを送信

非同期動画生成の共通送信エンドポイント：Seedance、MiniMax Hailuo、Kling、Grok Imagine が共用し、model とキーのグループに応じて振り分けます。

POST/v1/video/generate

Seedance、MiniMax、Kling、Grok の動画はこの 1 つの送信エンドポイントを共用し、HopBase はリクエストの model とキーの所属グループに応じて対応するシリーズに処理を渡します。リクエストボディとステータス値はシリーズごとに異なります。下でシリーズを選ぶと対応するパラメータを確認できます。送信後は動画タスクを照会でポーリングします。

送信時は「利用可能残高 − 処理中タスクの見積もり費用 − 今回の見積もり費用」で判定し、足りなければ 402 insufficient_balance を返します。失敗したタスクは一切課金されません。タスクのキャンセルには対応していません。Seedance のタスクは 24 時間を超えても終了しない場合、自動的に失敗と判定されます（The task did not finish within 24 hours and was terminated automatically）。送信に成功したら再送信しないでください。再送信のたびに別の課金タスクになります。

Wan 3.0 / HappyHorse はネイティブの動画パス POST /api/v1/services/aigc/video-generation/video-synthesis（先頭に /v1 は付きません）を使います。Wan と HappyHorse を参照してください。Gemini Omni は同期で返ります。Gemini Omni 動画を参照してください。

動画タスクを送信

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      {
        "type": "text",
        "text": "日差しの中の草原を走る茶トラの猫、カメラが追いかける"
      }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

200application/json

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "pending",
    "outputs": [],
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": null
  }
}

ヘッダー

Authorization:必須string

Bearer sk-…：コンソールの「API キー」で作成したキー。キーのグループにリクエストするモデルが含まれている必要があります

リクエストボディJSON

シリーズ

モデルのドキュメント

型は厳密です：整数や真偽値を文字列で書くと拒否されます。frames、seed、camera_fixed、draft、draft_task、service_tier は 400 を返します。size、seconds、n、aspect_ratio は Seedance のパラメータではなく、エラーにはなりませんが無視されます。リクエストボディの上限は 64 MB です。

model:必須string

Seedance のモデル ID。中国版グループでは海外版の dreamina-* ID も互換エイリアスとして受け付けます（4K は引き続き拒否）

取りうる値doubao-seedance-2-0-260128-adoubao-seedance-2-0-fast-260128-adoubao-seedance-2-0-mini-260615-adoubao-seedance-2-5-260628-adreamina-seedance-2-0-260128dreamina-seedance-2-0-epdreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-fast-epdreamina-seedance-2-0-fast-hcdreamina-seedance-2-0-hcdreamina-seedance-2-0-mini-260615dreamina-seedance-2-0-mini-epdreamina-seedance-2-0-mini-hcdreamina-seedance-2-5-260628

content:必須array of object

プロンプトと参照素材。プロンプトは text 要素に書きます。トップレベルの prompt だけを渡すと拒否されます（missing content）

個数≥ 1 個上限参照画像 2.0 ≤ 9、2.5 ≤ 30。動画 2.0 ≤ 3、2.5 ≤ 10。音声 2.0 ≤ 3（画像または動画との併用が必須）、2.5 ≤ 10。先頭・末尾フレームは最大 2 枚

duration:任意integer

2.0：4–15 または -1（自動）、2.5：4–30 または -1。既定値は 2.0 が 5、2.5 が -1。-1 の場合は最長の長さで残高を引き当てます

範囲-1–30

resolution:任意string

利用できる解像度はモデルにより異なります（海外版 2.0 標準版は 4K を含む。Fast / Mini は 480p / 720p のみ。2.5 は 4K 非対応）

取りうる値480p720p1080p4k

デフォルト"720p"

ratio:任意string

アスペクト比

取りうる値16:94:31:13:49:1621:9adaptive

デフォルト"adaptive"

generate_audio:任意boolean

2.5 は既定で true。2.0 は自動補完しないため、明示的に指定してください

watermark:任意boolean

2.5 は既定で false。2.0 は自動補完しないため、明示的に指定してください

return_last_frame:任意boolean

末尾フレームを取得できた場合は task.last_frame_url を返します。2.5 は既定で true、2.0 は保証されません

priority:任意integer

タスクの優先度

範囲0–9

execution_expires_after:任意integer

秒。24 時間の最終タイムアウトは変わりません

範囲3600–259200

callback_url:任意string

HTTP(S) URL。ポーリングの代わりにはなりません

safety_identifier:任意string

1–64 文字の ASCII

長さ1–64 文字

model:必須string

正確な ID。エイリアスはありません

取りうる値MiniMax-H3MiniMax-H3-Max

content:必須array of object

text 要素をちょうど 1 つと、任意のメディア要素。先頭・末尾フレームと reference_* は同一リクエスト内で排他で、メディアは合計最大 12 個

個数≥ 1 個

resolution:必須string

H3：768P / 2K、H3-Max：480P / 768P。課金レベルも同時に決まります

取りうる値480P768P2K

duration:必須integer

整数秒。H3：4–15、H3-Max：5–15。自動の長さには非対応

範囲4–15

ratio:任意string

テキストからの動画生成でのみ必須で、adaptive は使えません。マルチモーダル参照では既定で adaptive、先頭・末尾フレームモードでは完成動画は常に adaptive です

取りうる値21:916:94:31:13:49:16adaptive

aigc_watermark:任意boolean

完成動画に AI 生成コンテンツの透かしを入れます

model:必須string

モデル一覧にある動画 ID。画像生成の ID を渡すと 400 を返します

取りうる値kling-avatarkling-lip-synckling-o1kling-v1-6kling-v2-0kling-v2-1kling-v2-5-turbokling-v2-6kling-v2-6-motion-controlkling-v3kling-v3-motion-controlkling-v3-omnikling-v3-turbo

prompt:任意string

素材がない場合は必須。images / videos がある場合のみ空にできます。リップシンクでは不要です

長さ≤ 2500 文字

duration:任意integer

モデルごとの範囲は Kling のモデル一覧を参照。kling-v2-6 は 5 / 10 のみ。モーションコントロール、アバター、リップシンクでは指定せず、長さは素材から決まります

デフォルト5

resolution:任意string

大文字小文字を区別しません。モデルごとの対応解像度は Kling のページを参照

取りうる値720p1080p2k4k

デフォルト"720p"

aspect_ratio:任意string

省略時、ゲートウェイは値を補いません

取りうる値16:99:161:1

audio:任意boolean

音声を生成するかどうか。モデルごとの対応は Kling のページを参照

デフォルトfalse

images:任意array of object

先頭・末尾フレームまたは参照画像。モーションコントロール / アバターでは必須。枚数はモデル一覧を参照

videos:任意array of object

参照 / 編集用の動画。1 項目以下。モーションコントロールでは必須

個数≤ 1 個

subjects:任意array of object

カスタムサブジェクト。kling-v3-turbo、kling-v3、kling-v3-omni のみ

shots:任意object

ショット分割。6 段以下。kling-v3、kling-v3-omni のみ

extra:任意object

アバター / リップシンクでは必須。モーションコントロールでは character_orientation を渡せます。通常の動画モデルでは任意のキーで 400 を返します

レスポンス

200Seedance / Grok の送信成功

202MiniMax / Kling の送信成功

シリーズ

task:任意object

エラー

400パラメータ検証の失敗。同期で返され、タスクは作成されず、課金されません。多くは error.message のみで code はありません

402insufficient_balance：残高が処理中の引当 + 今回の見積もりに足りません。メンバーのクォータ不足の場合、message は Insufficient quota: で始まります

404モデルがこのキーのグループにない：The current group does not support the requested model: <モデル ID>

413リクエストボディが上限を超えた

503参照素材のダウンロードと解析が 2 分以内に完了しなかった（upstream_timeout、media validation timed out, please retry later）。しばらくしてからそのまま再試行してください

ヘッダー

リクエストボディJSON

レスポンス

エラー

関連ページ