本文へスキップ
NEWNano Banana 2.1 が登場 — Google の最新画像生成モデル、1 枚 $0.0336 から、ネイティブ 4K、前世代の約半額モデルを見る
HopBase
← ブログに戻る

統一動画生成 API:Seedance・Kling・Hailuo | HopBase

HopBase 2026年11月5日 15 分で読めます

あります。HopBase は複数の動画モデルファミリーを 1 つの非同期タスク API で提供しています。Seedance(2.0 / 2.5)、Kling(4.0 を含む)、MiniMax Hailuo(H3 / H3-Max)、Grok Imagine の動画は、いずれも POST /v1/video/generate で投入し、GET /v1/video/tasks/{task_id} でポーリングします。Alibaba の Wan 3.0 と HappyHorse 1.1 は公式のパス(POST /api/v1/services/aigc/video-generation/video-synthesis、ポーリングは GET /api/v1/tasks/{task_id})をそのまま使います。1 本のキーに最大 10 グループを含められるので、1 つのキーと 1 つの米ドル残高で全ファミリーをカバーできます。共通化されているのは「投入 → ポーリング → ダウンロード」の流れとアカウント・残高で、リクエスト本文は各ファミリー固有のフィールドで書きます。失敗した動画タスクは課金されず、結果リンクはタスク完了から 24 時間有効です。

共通化されている部分とされていない部分

まず各ファミリーの最小リクエストと結果の位置を確認します。ポーリング処理が吸収すべき差分はこの表のとおりです。

ファミリー投入 / ポーリング最小リクエスト投入時の応答完了後に読む場所
Seedance/v1/video/generate / /v1/video/tasks/{task_id}model + 空でない content[]200、task.id(vt…)task.outputs
Grok Imagine 動画同上model + prompt または content + resolution200、task.id(vt…)task.outputs
MiniMax Hailuo同上model + content + resolution + duration(テキストのみなら ratio も必須)202、id(mmt…)outputs
Kling同上model + prompt または images[] / videos[]202、id(kt…)outputs
Wan 3.0 / HappyHorse 1.1/api/v1/services/aigc/video-generation/video-synthesis / /api/v1/tasks/{task_id}model + input(parameters は任意)200、output.task_idoutput.video_url

投入成功時のステータスコードは 200 と 202 があるので、2xx なら受理と扱います。Seedance と Grok は応答が task で包まれ、Kling と Hailuo はトップレベルのフィールドです。処理中の値も異なります(Seedance は pending / processing、Kling と Hailuo は queued / processing)が、終了状態は必ず completed か failed です。Wan と HappyHorse は output.task_status を読み、終了状態は SUCCEEDED か FAILED です。

動画モデルファミリーの比較

以下の値はすべて HopBase のドキュメントから取っています。バリアントは、キーに対して GET /v1/models が返す完全な ID を基準にしてください。

ファミリーとモデル ID解像度長さ(秒)参照入力音声
Seedance 2.0:dreamina-seedance-2-0-260128(Standard)、-fast-260128、-mini-260615。中国版 doubao-seedance-2-0-*-aStandard は 480p / 720p / 1080p、海外版 Standard のみ 4K も可。Fast・Mini は 480p / 720p4–15 または -1content:画像 ≤9、動画 ≤3、音声 ≤3generate_audio(2.0 では明示が必要)
Seedance 2.5:dreamina-seedance-2-5-260628。中国版 doubao-seedance-2-5-260628-a480p / 720p / 1080p(海外版の 1080p はグループ次第、4K なし)4–30 または -1content:画像 ≤30、動画 ≤10、音声 ≤10generate_audio、既定値 true
Kling 4.0:kling-v4720p / 1080p3–30テキストから動画、先頭フレーム画像から動画のみ常に音声付き。audio は料金に影響しない
Kling 3:kling-v3、kling-v3-omni、kling-v3-turbo720p / 1080p / 2k / 4k3–15images[] / videos[]、サブジェクト。v3 と v3-omni は shots の絵コンテに対応v3・v3-omni は音声あり / なしを選択
Hailuo H3:MiniMax-H3768P / 2K4–15content:画像 ≤9、動画 ≤3、音声 ≤3、合計 ≤12映像と同時に生成
Hailuo H3-Max:MiniMax-H3-Max480P / 768P5–15テキストまたは先頭・末尾フレームのみ。reference_* は不可映像と同時に生成
Grok Imagine:grok-imagine-video-1.5480p / 720p / 1080p(参照画像ありは 480p / 720p のみ)1–15トップレベルの reference_images ≤14、公開 URL のみ音声パラメータなし(generate_audio は拒否)
Wan 3.0:wan3.0-video480P / 720P / 1080P2–30input.media[]:画像 ≤10、動画 ≤5、音声 ≤5、ドキュメントまたは Web ページ ≤1audio スイッチ、同一料金
HappyHorse 1.1:happyhorse-1.1-t2v / -i2v / -r2v480P / 720P / 1080P3–15t2v なし、i2v は先頭フレーム 1 枚ちょうど、r2v は参照画像 1–9 枚—

Kling にはモーションコントロール(kling-v3-motion-control)、デジタルヒューマン(kling-avatar)、リップシンク(kling-lip-sync)もあり、同じタスク API で使えます。

完全な例:Seedance 2.5 の投入とポーリング

1. タスクを投入します。フィールドはすべてトップレベルに置き、parameters の中に入れないでください。

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      { "type": "text", "text": "An orange cat runs across sunlit grass as the camera follows" }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

2. 投入に成功すると 200 が返ります。task.id を控えます。

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

3. task.status が completed か failed になるまで 5 秒ごとにポーリングします。ポーリングは課金されず、同時実行数も消費しません。

curl https://api.hop-base.com/v1/video/tasks/vt-your-task-id \
  -H "Authorization: Bearer sk-your-key"

4. 完了したら task.outputs(文字列の配列)から動画 URL を取得します。トップレベルの usage.cost_usd がそのタスクで実際に差し引かれた米ドル額です。リンクは完了から 24 時間有効で、期限後は 410 になるため早めに保存してください。480p と 720p は通常 2〜5 分で生成されます。

別のファミリーに切り替えるときは、ポーリング処理はそのままでリクエスト本文だけを変えます。Kling は prompt + aspect_ratio、Hailuo は MiniMax v2 形式の content + resolution + duration です。注意点として、Seedance は size、seconds、n、aspect_ratio をエラーなしで無視し、既定の長さと 720p で生成します。duration、resolution、ratio を必ず送ってください。

各ベンダーのコンソールを個別に使う場合との比較

観点ベンダーごとに個別利用統一タスク API(HopBase)
アカウントプラットフォームごとに登録・本人確認・入金1 アカウント、1 キー(最大 10 グループ)
リクエスト形式ベンダーごとに異なるファミリーごとのままだが、投入とポーリングのパスは共通(Wan / HappyHorse を除く)
課金単位ベンダーごとに異なり、自前で換算単位は異なる:Seedance は 100 万動画トークン単位、Kling・Hailuo・Wan・Grok は秒単位。すべて同じ米ドル残高から差し引き
タスクごとのコスト各ベンダーの請求書を確認タスク終了後の照会で usage.cost_usd を返す
結果リンク有効期限がまちまち全ファミリー 24 時間

料金と課金ルール

  • 料金 = 各ベンダーの公式定価 × グループ倍率です。料金ページを参照してください。公式定価の例:MiniMax-H3-Max 480p 1 秒 $0.05、kling-v4 720p 1 秒 $0.1471、wan3.0-video 480p 1 秒 $0.04412。
  • 失敗した動画タスクは課金されません。投入時の 400 も課金されません。
  • 投入時に「利用可能残高 − 処理中タスクの見積り − このタスクの見積り」を確認し、不足すると 402 insufficient_balance が返ります。
  • タスクはキャンセルできません。投入成功後に再投入すると、その都度新しい課金タスクになります。

関連記事:中国の AI 動画モデルを中国国外から 1 つの API で使う方法では各ファミリーの手順を、Seedance API の料金を徹底解説では秒あたりコストの換算を、Kling 4.0 API 実装ガイドでは kling-v4 のパラメータを解説しています。全フィールドは動画生成ドキュメントにあります。試すには 登録してキーを作成し、必要な動画グループを選んでください。

よくある質問

Seedance、Kling、Hailuo をまとめて使える API はありますか?

あります。HopBase ではこの 3 つと Grok Imagine 動画が POST /v1/video/generate と GET /v1/video/tasks/{task_id} を共有しており、1 本のキーに該当グループを追加すれば使えます。リクエスト本文は各ファミリーのフィールドで書き、ポーリング処理は共通化できます。

動画生成に失敗した場合も課金されますか?

課金されません。失敗した動画タスクは無料で、照会結果の usage.cost_usd は 0 になります。パラメータ誤りによる 400 など、投入時に拒否されたリクエストも課金されません。

海外の開発者は Seedance のどの ID を使えばよいですか?

ID が 2 系統あるのは Seedance だけです。海外版 dreamina-seedance-* と中国版 doubao-seedance-*-a で、それぞれ対応するグループを含むキーが必要です。4K は海外版 2.0 Standard のみです。Kling、Hailuo、Wan、Grok の ID は 1 系統です。GET /v1/models でキーが使える ID を確認してください。

ガイド