動画生成

HopBase は 7 つの動画モデルファミリーを提供しています。下表は各ファミリーのモデル、プラン、送信時のレスポンスをまとめたものです。各ファミリーの完全なパラメータはそれぞれの専用ページにあり、このページの後半は Seedance の完全ガイドです。

すべての動画モデル

エンドポイントと共通ルール

POST /v1/video/generate と GET /v1/video/tasks/{task_id} は、Seedance、Grok Imagine、MiniMax、Kling が共有する送信・照会用のエンドポイントで、タスク一覧は GET /v1/video/tasks?page=1&limit=20 にあります。HopBase はリクエストの model とキーが属するプランに基づいて、適切なファミリーにリクエストを振り分けます。リクエストボディとステータス値はファミリーごとに異なるため、各ファミリーのページに従ってください。Wan 3.0 と HappyHorse は独自のパスを使用し続けており、送信は POST /api/v1/services/aigc/video-generation/video-synthesis、照会は GET /api/v1/tasks/{task_id} で、一覧エンドポイントはありません。Gemini Omni は同期処理でタスクを作成しません。ファミリーごとに送信成功時のステータスコードが異なるため、2xx であれば送信成功として扱ってください。

• プラン:各ファミリーは専用のプランに属しており、あるファミリーに到達できるキーが他のファミリーにも到達できるとは限りません。Gemini Omni は Gemini のチャット・画像生成とプランを共有しています。実際に使用するキーで GET /v1/models を呼び出し、レスポンスから完全なモデル ID を取得してください。モデル ID は完全一致で判定され、未知の名前は拒否されるだけで、近い名前へのルーティングは行われません。
• 残高:動画の送信時には「利用可能残高 − 実行中タスクの見積もり額 − 今回のリクエストの見積もり額」で判定されます。不足している場合は 402 が返り、code は insufficient_balance、message は Insufficient balance: available $X, reserved in flight $Y, this request estimated $Z のような形式になります。見積もり額はタスク終了時に自動的に解放されます。Kling のリップシンクは見積もりができないため予約は行われません。Gemini Omni も予約を行いません。
• 課金:失敗した動画タスクは一切課金されません。
• タイムアウトと取り消し:作成から 24 時間経っても完了しないタスクは、error_code が stale_timeout として自動的に失敗扱いになります。動画タスクを取り消すことはできません。
• 結果リンク:出力 URL は api.hop-base.com 上の署名付き URL で、タスク完了時点から有効になります。Seedance と Grok Imagine は 30 日間、Kling、MiniMax、Wan 3.0、HappyHorse は 6 時間です。再度照会しても同じ URL が返るだけで有効期限は延長されず、期限切れの URL は 410 を返します。Gemini Omni は動画をレスポンスボディで返すため、リンクはありません。

Seedance

プランとモデル ID

中国国内向けモデルは Seedance 国内（Doubao） プランから、海外向けモデルは Seedance 海外 · Seedream プランから提供されます。

中国国内向けプランは Standard、Fast、Mini、Seedance 2.5 をすべてカバーしており、4K だけが海外向け Standard モデルを必要とします。中国国内向けプランは、上表の海外 dreamina-* ID を互換エイリアスとしても受け付けます(4K は引き続き拒否されます)。そのため、海外から中国国内へ移行する既存のクライアントはキーを差し替えるだけでよく、base_url、API パス、リクエストパラメータ、ポーリングロジックはすべて変わりません。切り替え後は、新しいキーで GET /v1/models を呼び出して完全なモデル ID を選択してください。以前に送信したタスクは、元のタスク ID のまま引き続き照会できます。

Seedance 2.5 の通常のテキストから動画生成や参照メディアを使った生成では、duration はデフォルトで -1 となり、4〜30 秒の整数値または -1 を受け付けます。resolution はデフォルトで 720p となり、海外版は 480p または 720p、中国国内版はさらに 1080p を受け付けます。ratio は 16:9、4:3、1:1、3:4、9:16、21:9、adaptive を受け付けます。一部のタスクモードにはより厳しい要件があります。動画編集では duration: -1 と ratio: adaptive を使用し、拡張モードと先頭/末尾フレームモードでは ratio: adaptive が必須です。音声生成あり、透かしなし、return_last_frame: true がデフォルトで、完了したタスクには last_frame_url が含まれます。Seedance 2.5 はアセットライブラリの ID(asset25-*)に対応していないため、参照メディアは直接 content に含めてください。

1. 生成タスクを送信する

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
  }'

送信に成功すると 200 が返り、task.id に vt… のような値が入り、後のステータス照会に使用します。画像から動画を生成する場合は、content に以下のオブジェクトを追加してください。

{
  "type": "image_url",
  "image_url": { "url": "https://example.com/reference.jpg" },
  "role": "reference_image"
}

この表にないその他の対応パラメータは、そのまま透過されます。

2. タスクのステータスをポーリングする

# Single task; polling every 5 seconds is recommended
curl https://api.hop-base.com/v1/video/tasks/vt-your-task-id \
  -H "Authorization: Bearer sk-your-key"

# Task list; optionally append ?page=1&limit=20
curl https://api.hop-base.com/v1/video/tasks \
  -H "Authorization: Bearer sk-your-key"

status は pending、processing、completed、failed のいずれかで、終了状態は completed と failed のみです。それ以外の値は実行中として扱ってください。完了したら outputs から動画の URL を取得します。usage.completion_tokens には課金対象のトークン数が入ります。480p と 720p の生成は通常 2〜5 分、1080p と 4K はそれ以上かかります。

3. Seedance 2.0 の参照メディアをアップロードする

curl https://api.hop-base.com/v1/sd/assets \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "URL": "https://example.com/your-image.jpg",
    "Name": "character_front",
    "AssetType": "Image"
  }'

返された data.Id がアセット ID です。Seedance 2.0 での生成時に asset://asset-id として参照してください。参照する項目に合わせて AssetType を Image、Video、Audio のいずれかに設定し、GET /v1/sd/assets/{asset-id} でアセットの準備が整うまで照会します。アップロードは公開アクセス可能な URL のみを受け付け、base64 やマルチパートには対応していないため、先にファイルをアクセス可能な場所にホストしておく必要があります。通常の参照画像ではアップロードは任意ですが、実在の人物を含む画像では必須です。

参照メディアの検証ルール

すべての参照メディアは送信時に同期的に検証されます。無効なメディアは、具体的なエラーコード(invalid_image_aspect_ratio など)とともに即座に 400 が返り、タスク費用は発生しません。以下の表に沿って事前にチェックしておくことで、無駄な呼び出しの大部分を回避できます。

メディアの URL はパブリックにアクセス可能な http(s) アドレスである必要があります。プライベート / ループバック / リンクローカルアドレスや、認証情報を含む URL は拒否され、リダイレクトは最大 3 回までです。画像と音声は data: base64 形式でインラインに渡すこともできます。役割の制約として、フレームモードでは画像は最大 2 枚までで、1 枚だけの場合は必ず first_frame にする必要があり、2 枚の場合はちょうど 1 つが first_frame、もう 1 つが last_frame である必要があります。マルチモーダル参照は明示的に reference_image として宣言する必要があり、フレームモードと混在させることはできません。

料金

公式のリスト価格は料金ページに掲載されています。実際の適用レートはログイン後のモデル広場に表示され、各リクエストの実際の課金額はコンソールの使用状況ページで確認できます。