Seedance 公式版 動画 API 仕様
seedance-2.0、seedance-2.5、seedance-2.0-mini、seedance-2.0-fast の解像度別課金による呼び出し方法と、長さ、アスペクト比、参照素材、開始・終了フレーム、音声、動画編集・延長、最終フレーム、タスクのキャンセルのルール。
このページは、Seedance 公式版の動画モデルの呼び出し仕様です。これらのモデルは、他の動画モデルと同じく POST /v1/videos で作成し、GET /v1/videos/{id} でポーリングします。認証、素材のアップロード、ポーリングのステータス、結果のダウンロード、エラー処理は動画 API 完全呼び出し仕様を参照してください。このページでは、このモデル群に固有のフィールドとルールだけを説明します。
このモデル群は Seedance 公式 API で生成され、完成動画には C2PA コンテンツクレデンシャルが埋め込まれます。デフォルトでは目に見える透かしは入りません。ポーリングのみに対応しており、作成時に
callback_urlを設定するとリクエストは拒否されます。Seedance 公式中継は別のモデル群で、パラメーターや機能は共通ではありません。
モデル一覧
| モデル | 選択可能な解像度 | 長さ | 画像/動画/音声の上限 | 開始・終了フレーム | 音声生成 |
|---|---|---|---|---|---|
seedance-2.0 | 480p、720p(デフォルト)、1080p、4k | 4–15 秒または -1、デフォルト 5 秒 | 9 / 3 / 3 | 対応、通常の参照素材とは排他 | デフォルトで生成、オフ可 |
seedance-2.5 | 480p、720p(デフォルト)、1080p | 4–30 秒または -1、デフォルト -1(自動) | 30 / 10 / 10 | 対応、通常の参照素材とは排他。アスペクト比は adaptive が必須 | デフォルトで生成、オフ可 |
seedance-2.0-mini | 480p、720p(デフォルト) | 4–15 秒または -1、デフォルト 5 秒 | 9 / 3 / 3 | 対応、通常の参照素材とは排他 | デフォルトで生成、オフ可 |
seedance-2.0-fast | 480p、720p(デフォルト) | 4–15 秒または -1、デフォルト 5 秒 | 9 / 3 / 3 | 対応、通常の参照素材とは排他 | デフォルトで生成、オフ可 |
各モデルのモデル名は 1 つだけで、resolution で出力解像度を選択し、その解像度で課金されます。例:"model": "seedance-2.5", "resolution": "1080p"、"model": "seedance-2.0", "resolution": "4k"。解像度ごとの単価はモデルスクエアを参照してください。
共通ルール
- 解像度:
resolutionに上表の解像度を指定します。大文字・小文字は区別されず(4kと4Kは同じ扱いです)、数値(480など)でも指定できます。省略すると720pになります。そのモデルが対応していない解像度を指定すると 400 が返され、自動的に解像度を下げることはありません。 - 長さ:
duration(またはseconds。整数または数値の文字列)に整数の秒数を指定します。-1は長さをモデルに任せる指定です。課金は実際に生成された秒数で行われます。-1の場合と、seedance-2.5で長さを省略した場合は、作成時に最大の長さで仮押さえし、完了後に実際の秒数で精算します。 - アスペクト比:
ratio(またはaspect_ratio)に16:9、4:3、1:1、3:4、9:16、21:9、adaptiveを指定できます。autoはadaptiveと同じ扱いです。省略するとadaptiveになり、開始フレームがある場合はその画像に合わせ、テキストのみの場合はモデルが決定します。 - プロンプト:参照素材または開始・終了フレームを指定した場合は
promptを省略できます。何も指定しない場合は 400 が返されます。 - 音声生成:デフォルトで同期した音声を生成します。
"generate_audio": falseを指定すると無音の動画を出力します。 - 透かし:デフォルトでは目に見える透かしは入りません。
"watermark": trueを指定すると右下に「AI 生成」の透かしを入れます。 - 任意フィールド:
seed(-1 から 2147483647 までの整数)、priority(0–9 の整数。キューの優先度)、return_last_frame(ブール値。最終フレームを参照)。negative_promptは残してもエラーにはなりませんが、効果は保証されません。避けたい内容はpromptに書いてください。 - 非対応:サンプル動画(
draft)、Web 検索(tools、web_search)、camera_fixed、frames、service_tier、callback_urlは、指定すると作成時に 400 が返されます。
参照素材
- 参照画像はトップレベルの
images配列に指定します(referenceImages、reference_images、image_urls、image、input_referenceも使用できます)。 - 参照動画は
metadata.referenceVideosに指定します(トップレベルのvideos、video_urls、referenceVideos、reference_videosも使用できます)。公開されている HTTPS の URL のみ受け付けます。 - 参照音声は
metadata.referenceAudiosに指定します(トップレベルのaudios、audio_urls、referenceAudios、reference_audiosも使用できます)。 - 複数のフィールドに指定した同じ種類の素材はマージされ、同じ URL は 1 つとして数えます。マージ後の数は上表の上限に従い、超えると 400 が返されます。
- 画像には HTTPS の URL または
data:image/...;base64,のインラインデータを使えます。参照動画と参照音声は、先にローカル素材のアップロードの手順で URL を取得してください。 seedance-2.0、seedance-2.0-mini、seedance-2.0-fastで参照音声を使う場合は、参照画像または参照動画も必ず指定してください。seedance-2.5は参照音声だけでも指定できます。- 実在の人物の写真も、そのまま開始フレームや参照画像として使えます。肖像の使用許諾を得ていることを確認してください。
- Volcengine Ark の
content配列形式(text、image_url、video_url、audio_urlのコンテンツ項目。画像のroleにはfirst_frame、last_frame、reference_imageを指定可能)をそのまま使うこともできます。
{
"model": "seedance-2.5",
"resolution": "1080p",
"prompt": "参照画像の製品の外観、参照動画のカメラのテンポ、参照音声のサウンドの雰囲気を使ってテック系の広告を作る",
"duration": 10,
"ratio": "16:9",
"images": [
"https://cdn.example.com/product-front.jpg",
"https://cdn.example.com/product-detail.jpg"
],
"metadata": {
"referenceVideos": ["https://cdn.example.com/motion-reference.mp4"],
"referenceAudios": ["https://cdn.example.com/sound-reference.mp3"]
}
}開始・終了フレーム
開始フレームと終了フレームは metadata.firstFrame と metadata.lastFrame に指定します(トップレベルの firstFrame、first_frame、lastFrame、last_frame も使用できます)。画像の上限数に含まれます。
lastFrameは必ずfirstFrameと一緒に指定します。- 開始・終了フレームは、参照画像、参照動画、参照音声と併用できません。
seedance-2.5で開始フレームまたは開始・終了フレームを使う場合、ratioはadaptive(または省略)にする必要があります。
{
"model": "seedance-2.0",
"resolution": "720p",
"prompt": "早朝の誰もいない広場から、夜に明かりが灯った同じ構図へなめらかに移り変わる",
"duration": 8,
"metadata": {
"firstFrame": "https://cdn.example.com/start.jpg",
"lastFrame": "https://cdn.example.com/end.jpg"
}
}動画編集と延長
seedance-2.5 では、omni_reference_task_type で参照タスクの種類を指定できます。auto(デフォルト。プロンプトからモデルが判断)、reference(参照生成)、edit(参照動画の編集)、extend(参照動画の延長)です。プロンプトは種類に合わせて書いてください。たとえば編集なら「……を……に変える」、延長なら「……を続ける」のように書きます。
edit:参照動画が必須で、ratioはadaptive、durationは-1にします。出力の長さは参照動画に従い、実際に出力された秒数で課金されます。extend:参照動画が必須で、ratioはadaptive、durationには新たに生成する長さまたは-1を指定します。- 参照動画付きの
autoタスクは、モデルに編集と判断されることがあります。その場合も長さは参照動画に従います。 output_formatにはmp4(デフォルト)またはmovを指定でき、seedance-2.5のみ対応しています。
{
"model": "seedance-2.5",
"resolution": "720p",
"prompt": "動画の中の上着を赤に変え、構図とカメラワークはそのままにする",
"ratio": "adaptive",
"duration": -1,
"omni_reference_task_type": "edit",
"metadata": {
"referenceVideos": ["https://cdn.example.com/source.mp4"]
}
}最終フレーム
リクエストで "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 とは限りません。
タスクのキャンセル
生成が始まる前のタスクはキャンセルできます。
curl -X DELETE https://api.88api.ai/v1/videos/task_xxx \
-H "Authorization: Bearer sk-あなたのAPIキー"キャンセルに成功すると "status": "cancelled" が返されます。その後タスクを照会すると failed になり、エラーメッセージは「任务已被用户取消」(ユーザーによりキャンセル済み)で、課金されません。すでに生成が始まったタスクはキャンセルできない場合があるため、引き続き結果をポーリングしてください。
ファイルのアップロード
multipart/form-data でローカルの画像ファイルを直接アップロードし、参照画像として使うこともできます。フィールド名は input_reference で、この場合は images、image、content を同時に送れません。参照動画と参照音声はファイルとして送れないため、先にローカル素材のアップロードの手順で URL を取得してください。
旧モデル名
以下の旧モデル名は 2026-11-01 に提供を終了しており、呼び出すとエラーが返されます。新しいモデル名に切り替えてください。パラメーターの書き方はほぼ変わりませんが、新モデルは resolution を省略すると 720p になります(以前は多くが 480p)。480P が必要な場合は "resolution": "480p" を明示してください。
| 旧モデル名 | 新モデル名 |
|---|---|
SD2.0、seedance-2.0官方版 | seedance-2.0 |
SD2.5、seedance-2.5官方版 | seedance-2.5 |
seedance-2.0-mini官方版 | seedance-2.0-mini |
seedance-2.0-fast官方版 | seedance-2.0-fast |
さらに以前の解像度接尾辞付きの旧名称(SD2.5 720P、SD2.0 4K、Seedance-2.5-720p官方版、seedance-2.0-mini-480p など)は、すでに提供を終了しています。