Seedance 2.0 動画生成 API クイックスタート

結論から言うと、HopBase での Seedance 2.0 動画生成は非同期です。ジョブを投入し、ステータスをポーリングし、結果をダウンロードします。キーを付けて https://api.hop-base.com/v1/video/generate に POST し、"model": "dreamina-seedance-2-0-260128"（中国本土向けグループでは doubao-seedance-2-0-260128-a）、content 内のプロンプト、尺（duration）、解像度を指定します。レスポンスで返る task.id を使い、GET /v1/video/tasks/{task_id} を 5〜10 秒ごとにポーリングし、生成には通常 1 分から数分かかります。課金は動画トークン単位で、尺と解像度に応じてトークン数が増えるため、まず 5 秒・720p でテストし、出力が気に入ったら 1080p に上げましょう。5〜10 秒の尺に収まるのは 1 ショットなので、プロンプトはストーリーではなくカメラ演出（「slow push」「逆光のシルエット」「固定カメラ」）として書き、ブランド用途では先頭フレーム画像を渡して見た目を固定します。返される動画 URL の署名は 24 時間有効なので、URL を埋め込むのではなく、生成完了直後に自社ストレージへダウンロードしてください。まず少量で始め、使える出力の割合を測ってからスケールしましょう。

Seedance 2.0 は、テキストから動画を生成する分野で際立ったコストパフォーマンスを誇ります。滑らかな動き、自然なカメラワーク、そしてトップクラスのモデルのごく一部で済む料金。私たちはこれをゲートウェイに完全に統合しました。ここでは、ジョブ投入から完成動画までの最短ルートを紹介します。

動画生成は非同期

チャット補完と異なり、動画生成は「ジョブ投入 → ステータスのポーリング → 動画のダウンロード」という非同期パターンで動きます。

# 1. Submit video generation job
curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer your-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-260128",
    "content": [
      {"type": "text", "text": "A serene boardwalk at sunrise, camera slowly tracking forward, seagulls gliding past"}
    ],
    "duration": 5,
    "resolution": "1080p"
  }'

# 2. Poll GET /v1/video/tasks/{task_id} with the returned task.id; when status is completed, read the video URL from task.outputs

生成には通常 1 分から数分かかります。ポーリングは 5〜10 秒間隔で行ってください。例では海外向けグループの dreamina-seedance-2-0-260128 を使っています。中国本土向けグループでは doubao-seedance-2-0-260128-a を指定してください。全モデル、パラメータ、レスポンス形式は Seedance ドキュメントをご覧ください。

パラメータと料金の対応

尺と解像度で費用が決まる：課金は動画トークン単位で、尺が長く解像度が高いほどトークン数が増えます。テストするなら 5 秒・720p が最も安く、結果が気に入ってから 1080p に上げましょう。
「ストーリー」ではなく「カメラの動き」を書く。5〜10 秒に収まるのは 1 ショットです。あらすじを説明するより、「slow push」「逆光のシルエット」「固定カメラ」といった映像言語のほうがうまく機能します。
先頭フレーム画像でスタイルを制御：画像を最初のフレームとして渡すと、見た目や雰囲気を固定できます。ブランド素材の量産に最適です。

動画 URL の有効期限は 24 時間。すぐにダウンロードを

返される動画 URL には 24 時間の期限付き署名が付いています。期限を過ぎると取得できません。生成が完了したらすぐに動画をダウンロードし、自社のストレージに保存してください。返された URL をそのままアプリに埋め込むのは避けましょう。

活躍する場面

ショート動画、商品紹介アニメーション、SNS 広告の A/B テスト素材の制作など、量が多く、コストに敏感で、出来の良いカットを選別する前提が許容できるシーンです。まずは少額のクレジットで小さく始め、使える出力の割合を把握してから制作をスケールする。それが最も安全な立ち上げ方です。