Seedance 公式中継動画 API 仕様

Seedance 2.0 Mini、2.0、2.0 Fast、2.5 の解像度、長さ、アスペクト比、参照素材、仮想人物ライブラリ、サンプル動画、最終フレーム、Web 検索、タスクのキャンセル、動画編集・延長のルール。

このページは、Seedance 公式中継の動画モデルの呼び出し仕様です。これらのモデルは、他の動画モデルと同じく POST /v1/videos で作成し、GET /v1/videos/{id} でポーリングします。認証、素材のアップロード、ポーリングのステータス、結果のダウンロード、エラー処理は動画 API 完全呼び出し仕様を参照してください。このページでは、このモデル群に固有のフィールドとルールだけを説明します。

2026-10-13 更新。このモデル群は火山引擎（Volcengine）の Seedance 公式 API を中継したもので、Seedance 公式版や SD クラウド版とは別のモデル群で、パラメーターや機能は共通ではありません。このモデル群は callback_url に対応していません。空でない callback_url を含むリクエストは 400 を返し、タスクは作成されず課金もされません（空文字列は未指定として扱われます）。結果は GET /v1/videos/{id} のポーリングで取得してください。

モデル一覧

次の表にこのモデル群の model ID を示します。対応するグループが有効になっている API キーにのみ表示され、有効でない場合は GET /v1/models もこれらの ID を返しません。

モデル	モデル ID	解像度	長さ	デフォルトの長さ	画像／動画／音声の上限
Seedance 2.0 Mini（マルチ解像度）	`doubao-seedance-2.0-mini`	480P / 720P	`-1` または 4–15 秒	5 秒	9 / 3 / 3
Seedance 2.0（マルチ解像度）	`doubao-seedance-2.0`	480P / 720P / 1080P / 4K	`-1` または 4–15 秒	5 秒	9 / 3 / 3
Seedance 2.0 Fast（マルチ解像度）	`doubao-seedance-2.0-fast`	480P / 720P	`-1` または 4–15 秒	5 秒	9 / 3 / 3
Seedance 2.5（マルチ解像度）	`doubao-seedance-2.5`	480P / 720P / 1080P	`-1` または 4–30 秒	`-1`（自動）	30 / 10 / 10

以前のモデル ID doubao-seedance-2-0-mini-260615、doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-5-260628 も引き続き呼び出せ、上表の同名モデルとまったく同じです。これらはモデル一覧ページには表示されなくなったため、新しく接続する場合は上表の ID を使ってください。

共通ルール

解像度：resolution で出力解像度を選びます。値は上表のとおりで（大文字・小文字は問いません。例：720p、4k）、デフォルトは 720p です。
長さ：duration（または seconds）に整数の秒数を指定します。-1 はモデルが長さを自動で決めることを表します。
アスペクト比：ratio（または aspect_ratio）に 16:9、4:3、1:1、3:4、9:16、21:9、adaptive を指定でき、デフォルトは adaptive（入力素材に合わせて自動調整）です。size にアスペクト比や解像度（例：16:9、1080p）を書くこともでき、ratio、aspect_ratio、resolution と矛盾すると 400 が返ります。
プロンプト：参照素材または開始・終了フレームを指定した場合は prompt を省略できます。どちらもない場合は 400 が返されます。
音声生成：generate_audio（ブール値）を false にすると音声をオフにできます。省略した場合は音声付きで生成されます。
任意フィールド：watermark（ブール値。true のとき右下に「AI 生成」の透かしを入れます。デフォルトは透かしなし）、priority（0–9 の整数。キューの優先度）、return_last_frame（ブール値。最終フレームを参照）。
非対応のフィールド：seed、camera_fixed、frames、service_tier を送ると 400 が返されます。draft は Seedance 2.5 のみ対応しています。サンプル動画と本番動画を参照してください。

課金について

このモデル群は、タスク完了後にモデルプラットフォームが返す出力トークン数で精算され、「解像度 × 参照動画の有無」に応じた単価が適用されます。送信時に料金は事前に差し引かれません。利用ログにはまず「操作 …」という送信記録（金額 0）が表示され、タスク完了後に「任务用量表达式结算」（タスク使用量の式による精算）という記録が追加され、実際の使用量に応じて課金されます。

長さをモデルが決める場合（duration が -1、または Seedance 2.5 で長さを指定しない場合）、送信記録の秒数は最大の長さに基づく見積もりで、「seconds: 30（预估）」（見積もり）と表示されます。実際の課金額は精算記録を基準とします。失敗したタスクやキャンセルされたタスクは課金されません。

参照素材

参照画像は images 配列、参照動画は metadata.referenceVideos、参照音声は metadata.referenceAudios に指定します。
単数形のフィールドも使えます。image、input_reference は参照画像、video は参照動画、audio は参照音声として扱われます。同じ素材を複数のフィールドに書いても 1 つとして数えます。
各要素は URL 文字列でも、{ "url": "...", "role": "..." } でもかまいません。
画像は公開 https:// URL または data: の Data URI を受け付けます。音声も公開 https:// URL または data: の Data URI を受け付けます。
参照動画は公開 https:// URL のみ受け付け、http://、data:、Base64、ローカルファイルは受け付けません。ローカルの動画は、先にローカル素材のアップロードの手順で URL を取得してください。リンクはログインなしでアクセスでき、タスク完了まで有効である必要があります。
2.0 シリーズ（Mini、2.0、Fast）は参照音声だけを送ることはできず、参照画像または参照動画も必要です。
参照動画と参照音声の合計の長さは、2.0 シリーズではそれぞれ 15 秒以内、2.5 ではそれぞれ 30 秒以内を推奨します。超えると、送信後にモデルプラットフォームが失敗を返すことがあります。
Volcengine Ark の content 配列形式（text、image_url、video_url、audio_url のコンテンツ項目。画像の role には first_frame、last_frame、reference_image を指定可能）をそのまま使うこともできます。トップレベルと metadata のどちらに置いてもかまいません。

{
  "model": "doubao-seedance-2.0",
  "prompt": "参照画像の人物が参照音声のリズムに合わせて踊り、動きは参照動画のスタイルに合わせる",
  "duration": 8,
  "resolution": "1080p",
  "ratio": "16:9",
  "images": ["https://cdn.example.com/dancer.jpg"],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/dance-motion.mp4"],
    "referenceAudios": ["https://cdn.example.com/music.mp3"]
  }
}

仮想人物ライブラリ（アセットモード）

デフォルトでは、参照素材は生成 API に直接送られて審査されます。素材を先に仮想人物ライブラリに登録し、登録審査を通過してから生成に使うこともできます。

画像には "image_source_mode": "asset"、参照動画には "video_source_mode": "asset" を設定します（動画は引き続き公開 https:// URL である必要があります）。2 つのフィールドはトップレベルと metadata のどちらにも置け、互いに独立しています。
multipart/form-data でアップロードしたローカル画像は自動的に仮想人物ライブラリに登録され、アセットモードで送信されます。別途設定する必要はありません。ファイルのアップロードを参照してください。
登録審査は素材が使用可能かどうかだけを確認するもので、本人の実名確認、顔認証、生体認証ではありません。現在、実在の人物の許諾を伴う登録フローは提供していないため、実在の人物の写真はアセットモードでも審査を通過しないことがあります。
現在、独立した素材管理機能（単独アップロード、素材一覧、素材 ID）は提供していないため、生成リクエストのたびに素材を含めてください。

{
  "model": "doubao-seedance-2.5",
  "prompt": "画像 1 の人物が画像 2 のネックレスを着け、明るい撮影スタジオでゆっくり振り返って見せる",
  "duration": 6,
  "resolution": "720p",
  "ratio": "9:16",
  "image_source_mode": "asset",
  "images": [
    { "url": "https://cdn.example.com/model.png", "role": "reference_image" },
    { "url": "https://cdn.example.com/necklace.png", "role": "reference_image" }
  ]
}

複数の参照画像は送信順に保持されます。人物や物の対応が混同されないよう、プロンプトで「画像 1」「画像 2」がそれぞれ何に対応するかを明記してください。

開始・終了フレーム

開始フレームと終了フレームは metadata.firstFrame と metadata.lastFrame に指定し、画像の上限数に含まれます。

lastFrame は必ず firstFrame と一緒に指定します。
開始・終了フレームは、参照画像、参照動画、参照音声と併用できません。
Seedance 2.5（マルチ解像度）で開始・終了フレームを使う場合、ratio は adaptive（または省略）にする必要があります。

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "早朝の誰もいない広場から、夜に明かりが灯った同じ構図へなめらかに移り変わる",
  "duration": 5,
  "resolution": "720p",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Seedance 2.5 の動画編集と延長

Seedance 2.5（マルチ解像度）に参照動画を渡す場合、omni_reference_task_type でタスクを指定できます。

値	説明	条件
`auto`（デフォルト）	素材に応じてモデルが判断	出力の長さは入力動画に従う（`duration` は `-1` として扱われる）
`reference`	参照生成	—
`edit`	動画編集	参照動画が必須。`ratio` は `adaptive`、`duration` は `-1`
`extend`	動画延長	参照動画が必須。`ratio` は `adaptive`

また、output_format で mp4 または mov を選べます。この 2 つのフィールドは 2.5 でのみ有効で、2.0 シリーズで送ると 400 が返されます。

{
  "model": "doubao-seedance-2.5",
  "prompt": "昼間のシーンを雨の夜に変え、人物の動きはそのまま残す",
  "omni_reference_task_type": "edit",
  "duration": -1,
  "ratio": "adaptive",
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/source.mp4"]
  }
}

サンプル動画と本番動画（Seedance 2.5）

Seedance 2.5（マルチ解像度）では、まず低コストの 480p サンプル動画を生成し、仕上がりを確認してから、そのサンプル動画をもとに 1080p の本番動画を生成できます。他のモデルはサンプル動画に対応していません。

サンプル動画を生成する：リクエストに "draft": true を追加します。出力は 480p 固定です。サンプル動画では return_last_frame を同時に設定できません。
サンプル動画の成功を待つ：通常どおり GET /v1/videos/{id} をポーリングし、ステータスが completed になったらサンプル動画を確認します。
本番動画を生成する：content には draft_task を 1 つだけ入れ、id にサンプル動画タスクの id（サンプル動画の作成時に返された task_…）を指定します。本番動画は 1080p 固定で、プロンプト、素材、長さ、アスペクト比、音声などはすべてサンプル動画から引き継がれます。prompt、素材、duration、ratio、generate_audio、omni_reference_task_type、return_last_frame を重ねて送らないでください。送ると 400 が返されます。

{
  "model": "doubao-seedance-2.5",
  "content": [
    { "type": "draft_task", "draft_task": { "id": "task_REPLACE_WITH_YOUR_DRAFT_TASK_ID" } }
  ],
  "watermark": false
}

使用できるのは、このアカウントで作成し、成功したサンプル動画タスクだけです。本番動画はサンプル動画の作成から 7 日以内に生成してください。
サンプル動画と本番動画は、それぞれ独立して課金される 2 つのタスクです。本番動画は 1080p の単価で精算され、サンプル動画に参照動画が含まれていた場合は、本番動画も参照動画ありの単価で精算されます。

最終フレーム

リクエストで "return_last_frame": true を設定すると、タスク成功後に動画の最後のフレームの画像を取得できます。続きの撮影や、次の動画の開始フレームとして使えます。

curl https://api.88api.ai/v1/tasks/task_xxx/artifacts \
  -H "Authorization: Bearer sk-あなたのAPIキー"

返された artifacts のうち、key が last_frame の項目が最終フレームの画像です。その content_url からダウンロードしてください（同じく API キーが必要です）。最終フレームは GET /v1/videos/{id} のレスポンスには含まれません。画像形式はダウンロード結果の Content-Type に従い、PNG とは限りません。

Web 検索

Seedance 2.0 シリーズと 2.5 は tools による Web 検索に対応しており、リアルタイムの情報が必要なプロンプトに向いています。

{
  "model": "doubao-seedance-2.0",
  "prompt": "今日の上海の天気に合わせて、外灘の街並みの動画を生成する",
  "duration": 5,
  "resolution": "720p",
  "tools": [{ "type": "web_search" }]
}

tools は {"type": "web_search"} のみ対応しています。
実際に検索するかどうかは、プロンプトに応じてモデルが判断します。実際に検索が行われた場合のみ、検索回数に応じて追加料金がかかります（単価はコンソールの料金説明を参照）。検索が行われなければ追加料金はかかりません。

タスクのキャンセル

タスクがキュー待ちで、まだ生成が始まっていない間はキャンセルできます。

curl -X DELETE https://api.88api.ai/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-あなたのAPIキー"

キャンセルに成功すると {"id": "task_xxx", "object": "video", "status": "cancelled", "cancelled": true} が返されます。その後タスクは失敗として表示され（理由は「任务已被用户取消」、つまりユーザーによりキャンセル済み）、課金されません。
すでに準備や生成が始まっているタスクや、終了したタスクはキャンセルできず、409 task_not_cancellable が返されます。引き続きタスクの結果を照会してください。
DELETE /v1/video/generations/{id} でも同じ効果があります。

公式タスク ID

タスクが Volcengine Ark に受理されると、GET /v1/videos/{id} は official_task_id（例：cgt-20261012120000-abcde）を返し、コンソールのタスクログにも「官方任务 ID」（公式タスク ID）が表示されます。生成結果について問い合わせる場合は、タスクの id と公式タスク ID の両方をお知らせください。タスクがまだキュー待ちで受理されていない間は、このフィールドは返されません。

ファイルのアップロード

multipart/form-data でローカルの画像を直接アップロードでき、複数枚にも対応しています。同じフィールド名（例：image）を繰り返してアップロードすると、送信順に「画像 1」「画像 2」に対応します。アップロードした画像は自動的に仮想人物ライブラリに登録され、アセットモードで送信されます。

curl https://api.88api.ai/v1/videos \
  -H "Authorization: Bearer sk-あなたのAPIキー" \
  -F model=doubao-seedance-2.5 \
  -F "prompt=画像 1 の人物が画像 2 のネックレスを着けてゆっくり振り返る" \
  -F duration=6 \
  -F resolution=720p \
  -F "image=@./model.png" \
  -F "image=@./necklace.png"

ローカルファイルを使う場合、images、image、input_reference、または content 内の画像を同時に送ることはできません。
1 ファイルあたり 64 MB 以下、リクエスト全体で 128 MB 以下にしてください。
ローカルの動画と音声は multipart/form-data で直接アップロードできません。先にローカル素材のアップロードの手順で https:// URL を取得し、参照動画または参照音声のフィールドに指定してください。参照音声は data: の Data URI も使えます。

Seedance 公式中継 動画 API 仕様

目次