Seedance 2.0

Seedance 2.0 は ByteDance の動画生成モデル（Dreamina Seedance 2.0）です。ModelArk 公式のタスクのリクエストボディを送信し、返されたタスク ID を保持して、そのタスクから完成した動画を読み取ります。画像・動画・音声は URL として content に入れます。

モデル ID

3 つの ID はいずれも同じパラメータを受け付けます。現在の価格はモデルページを参照してください。

クイックサンプル

curl https://api.seedrouter.ai/v1/contents/generations/tasks \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "content": [{"type": "text", "text": "A red paper boat drifts across a calm pond at sunrise, slow dolly-in"}],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

エンドポイント

POST https://api.seedrouter.ai/v1/contents/generations/tasks

リクエストボディは、ModelArk 公式の「動画生成タスクの作成」リクエストそのものです。すでに ModelArk を呼び出している場合は、ベース URL を https://api.seedrouter.ai/v1 に、API キーを差し替えるだけです。レスポンスは {"id": "task_..."} であり、完成した動画ではありません。API キーはサーバー側のコードに保管してください。

パラメータ

content の項目

未知のフィールドは拒否されます。次のものには対応していません: seed、callback_url（代わりにタスクをポーリングしてください）、draft と draft_task、tools、1.x 専用の frames と camera_fixed、そして output_format と omni_reference_task_type（Seedance 2.5 専用）。タスクのキャンセルや削除はできません。

モード

モードは content の項目から決まります。モードを指定するパラメータはありません。

最初のフレームを使うモードは、参照項目と組み合わせられません。画像が複数ある場合や他のメディアを含む場合は、すべての画像に role が必要です。

参照の例

curl https://api.seedrouter.ai/v1/contents/generations/tasks \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "content": [
      {"type": "text", "text": "The character from the image walks through the market in the video, same camera move"},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/market.mp4"}, "role": "reference_video"}
    ],
    "ratio": "adaptive",
    "duration": 8
  }'

例の URL は、ご自身のアクセス可能なファイルに置き換えてください。

メディア入力

この API は URL 参照のみを受け付けます。base64、data: URL、asset:// ID、multipart アップロードは受け付けません。Playground は選択されたファイルをストレージにアップロードしてから、その URL を送信します。

メディアは公開 HTTP(S) URL で、モデルの公式の制限を満たす必要があります:

実在の人物の顔を含む参照画像・参照動画には、モデルが対応していません。

メディアはタスクの開始時、生成の前に検証されます。メディアがこれらの制限のいずれかに違反したタスクは、invalid_request_error と、違反した規則を示すメッセージ（例: The request was rejected: content reference videos must total at most 15 seconds.）とともに failed で終了し、課金されません。その時点で読み取れないファイルはそのままモデルに渡され、モデルが受け付けるか拒否するかを判断します。いずれの場合も、失敗したタスクは課金されません。

課金に影響する要素

現在のレートはモデルの料金セクションで確認してください。Seedance 2.0 は公式の単位である動画トークンで課金されます:

video tokens = (output seconds + reference video seconds) × width × height × 24 / 1024

100 万トークンあたりのレートは、出力解像度と、リクエストに参照動画が含まれるかどうかで決まります。参照動画を含むリクエストは、すべてのトークンに低いレートが適用されます。テキスト・画像・音声の入力は課金されません。16:9 の場合、1 秒あたりのトークン数は 480p（864×496）で 10,044、720p で 21,600、1080p で 48,600、4K で 194,400 です。

課金額は完成した動画が報告するトークン数（usage.completion_tokens）に基づくため、duration: -1 は実際に生成された長さで課金されます。レンダリングされたクリップは、指定した長さをわずかに超えます。5 秒・720p・16:9 のリクエストは 121 フレームをレンダリングし、108,000 ではなく 108,900 トークンを報告します。最終的な課金額はアカウントの使用履歴で確認してください。失敗したタスクと期限切れのタスクは課金されません。

出力スキーマ

送信するとタスク ID が返ります:

{"id": "task_..."}

タスクを取得する

curl https://api.seedrouter.ai/v1/contents/generations/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

status が succeeded、failed、expired のいずれかになるまで、10〜20 秒ごとにポーリングしてください。ポーリング中のネットワークタイムアウトは生成の失敗を意味しません。タスク ID を保持して確認を再開してください。進捗確認のために別のタスクを作成しないでください。

ポーリングの完全な例

上記の Python 送信例のあとに実行してください。

import time

deadline = time.monotonic() + 1800
while time.monotonic() < deadline:
    result = requests.get(
        f"https://api.seedrouter.ai/v1/contents/generations/tasks/{task_id}",
        headers={"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"},
        timeout=30,
    )
    result.raise_for_status()
    task = result.json()
    if task["status"] == "succeeded":
        print(task["content"]["video_url"])
        break
    if task["status"] in ("failed", "expired"):
        raise RuntimeError(task["error"]["message"])
    time.sleep(15)
else:
    raise TimeoutError(f"Still waiting. Resume polling task {task_id}.")

成功したタスク

{
  "id": "task_...",
  "model": "dreamina-seedance-2-0",
  "status": "succeeded",
  "content": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "last_frame_url": "https://static.seedrouter.ai/media/tasks/task_example/last_frame/0.jpg"
  },
  "usage": {"completion_tokens": 108900, "total_tokens": 108900},
  "seed": 42,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "draft": false,
  "output_format": "mp4",
  "service_tier": "default",
  "execution_expires_after": 172800,
  "priority": 0,
  "created_at": 1790321515,
  "updated_at": 1790321652
}

動画 URL は当社のストレージでホストされています。長期保存が必要な場合は、ファイルをご自身のストレージに保存してください。

タスクの一覧

curl "https://api.seedrouter.ai/v1/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

過去 7 日間のタスクオブジェクトを新しい順に並べた {"total": N, "items": [...]} を返します。page_num と page_size は 1〜500 です（既定値は 1 と 20）。フィルター: filter.status、filter.model、filter.task_ids（複数指定可）、filter.service_tier。

エラー

タスク作成前に拒否されたリクエストは、HTTP エラーと error オブジェクトを返し、課金されません。受理後に失敗したタスクは、照会時に HTTP 200 と status: "failed"（または "expired"）、そして error オブジェクトを返します。コンテンツフィルタリングによって出力が差し止められた場合は content_policy_violation で失敗し、execution_expires_after を超えて実行されたタスクは task_expired とともに expired で終了します。

コード・HTTP ステータス・リトライの指針は共通エラーカタログを参照してください。

{
  "id": "task_...",
  "model": "dreamina-seedance-2-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

送信自体がタイムアウトした場合は、再送信の前にタスクの一覧を確認してください。最初のリクエストが受理されている可能性があります。

ヒント

• 被写体・動作・カメラワーク・照明を、完全な文で記述してください。
• 下書きは 480p と短い duration で作り、採用するものを高い解像度でレンダリングしてください。
• return_last_frame でショットをつなげます。返されたフレームを次のタスクの first_frame として使ってください。

関連情報

• Seedance 2.0 の Playground と料金
• OpenAPI をダウンロード
• コピー可能な Markdown