Seedance 2.0 は Volcengine(火山引擎)傘下の動画生成大モデルで、テキスト・画像・音声・動画の4モダリティ入力に対応し、現在中国国内で商用利用可能な SOTA(同レベル最良)の動画生成 API のひとつとされます。本ガイドは開発者向けに、「API を呼び出して最初の動画を生成する」までの完全な流れをゼロから通します。アカウント開通、インターフェース呼び出し、結果の取得、オブジェクトストレージの設定、コスト管理まで含みます。

Seedance 2.0 API にできること

• テキストから動画:テキストの記述から動画を生成
• 画像から動画:画像を1枚アップロードし、画面を動かす
• 音声/動画から動画:参照音声または動画素材から新しい動画を生成
• マルチモーダル組み合わせ入力:画像・テキスト・音声・動画の混合プロンプト

モデルはタスク単位の非同期呼び出しです:タスクを投入 → task_id を取得 → ポーリングで状態を確認 → 動画 URL を受け取る(有効期限は24時間。速やかに転送保存が必要です)。

動画生成は非同期タスクです。リクエストを同期呼び出しとして扱うと、クライアントが固まります。

始める前の準備

必要なアカウントと権限

• Volcengine アカウント:法人/個人の実名認証を完了
• Ark(方舟)大モデルサービスプラットフォーム:Seedance 2.0 モデルの権限を開通(一部のモデルは申請が必要)
• API Key:Ark コンソールで取得。volc-sk-xxx のような形式
• TOS バケット(任意だが推奨):生成結果を安定保存し、24時間で URL が切れる問題を回避

技術要件

• 任意の言語での HTTP 呼び出し(Python/Node.js/Go どれでも可)
• 署名プロセスを簡略化するため公式 SDK の利用を推奨
• 初回の接続完了までの想定:30分

主要ドキュメント一覧

具体的な手順

ステップ1:Ark プラットフォームを開通し API Key を取得

1. Volcengine Ark 大モデルサービスプラットフォームにログイン
2. 「モデル広場」で Seedance 2.0 シリーズを見つけて開通を申請
3. 「API Key 管理」で Key を作成し、大切に保管(一度しか表示されません)
4. モデル ID(seedance-2.0-xxx のような形式)を控える。後続の呼び出しで使います

ヒント:開通審査は通常1〜3営業日です。画像から動画とテキストから動画の2バリアントを同時に申請しておくのがおすすめです。

ステップ2:「動画生成タスク作成」インターフェースを呼び出す

コアとなるエンドポイント(Ark の公式を正としてください):

POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
Authorization: Bearer {API_KEY}
Content-Type: application/json

リクエストボディの例(テキストから動画):

{
  "model": "seedance-2.0-text-to-video",
  "content": [
    {
      "type": "text",
      "text": "一只柯基在草地上奔跑，慢镜头，阳光逆光"
    }
  ],
  "parameters": {
    "duration": 5,
    "resolution": "720p",
    "fps": 24
  }
}

レスポンスの例:

{
  "id": "task-xxxxxxxxxxxx"
}

この id を控えておきます。

ヒント:パラメータの順序や命名は公式の API リファレンスを正としてください。モデルのバージョンアップでフィールドが変わることがあるため、接続のたびに最新ドキュメントと突き合わせることをおすすめします。

ステップ3:タスク状態を照会し動画をダウンロード

照会インターフェースをポーリングします(間隔は10〜15秒を推奨。5秒の動画なら通常1〜3分で完了):

GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{task_id}
Authorization: Bearer {API_KEY}

成功時のレスポンス例:

{
  "id": "task-xxxxxxxxxxxx",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-video-xxx.volces.com/xxx.mp4"
  }
}

video_url を取得したら直ちにダウンロードしてください——URL の有効期限は24時間のみで、タスク記録も直近7日分しか照会できません。

ステップ4(推奨):TOS オブジェクトストレージへ転送保存

本番環境では、URL の失効を避けるため Volcengine TOS(オブジェクトストレージ)への転送保存を強く推奨します:

import requests, tos

# 1. 下载
video = requests.get(video_url).content

# 2. 上传到 TOS
client = tos.TosClientV2(ak, sk, endpoint, region)
client.put_object(Bucket="your-bucket", Key="videos/corgi.mp4", Body=video)

イントラネット加速を使う場合は、VPC 専用のネットワーク環境を設定でき、レイテンシと公網トラフィック費用をさらに削減できます。

ステップ5:公式 SDK で呼び出しを簡略化

HTTP リクエストを直接書くと署名を自前で処理する必要があるため、公式 SDK の利用をおすすめします:

• Python:pip install volcengine-python-sdk
• Node.js:npm install @volcengine/openapi
• 完全な多言語サンプル:https://www.volcengine.com/docs/82379/2298881

SDK には認証とリトライのロジックがすでに組み込まれており、数行のコードで動かせます。

検証結果

成功の目安:

• タスク状態が queued → running → succeeded と遷移する
• video_url から mp4 ファイルをダウンロードできる
• 動画の長さ、解像度がリクエストパラメータと一致する

初回接続では短めのプロンプト(5秒動画)で全チェーンを検証し、その後徐々に複雑さを上げることをおすすめします。

コストとクォータの注意点

• 課金方式:通常は動画の長さ(秒)単位の課金で、解像度が上がるほど単価も上がります。正確な価格は Ark コンソールの表示をご確認ください
• 同時実行制限:新規アカウントのデフォルト同時実行数は低めです。本番運用前にクォータの引き上げを申請してください
• 失敗タスク:コンテンツ審査による失敗は原則課金されませんが、パラメータミスによる失敗は部分的に課金される場合があります。呼び出し前に必ずパラメータを検証してください

よくある質問

• タスクがずっと queued のまま:アカウントの未払い、モデル権限の未開通、同時実行数の上限到達を確認してください。
• video_url が 403 / 失効する:URL が24時間で失効するのは仕様です。URL を取得したら直ちにダウンロードするか TOS に転送保存してください。
• 生成コンテンツが審査でブロックされる:Seedance にはコンテンツセーフティ機能が組み込まれており、プロンプトのセンシティブな語は避けてください。通常の業務シーンで引っかかることはまずありません。
• 画像から動画で画面がつながらない:先頭フレームの画像品質が鍵です。解像度は720p 以上で、主体が中央に明瞭に写っている画像を推奨します。
• 大量生成をしたい:SDK の非同期タスクキューを使い、同時実行をクォータ内に抑え、TOS への自動アーカイブと組み合わせてください。

関連リンク

• タスク作成 API:https://www.volcengine.com/docs/82379/1520757
• タスク照会 API:https://www.volcengine.com/docs/82379/1521309
• SDK サンプル:https://www.volcengine.com/docs/82379/2298881
• 接続全体ガイド:https://www.volcengine.com/article/42393