Seedance 2.5：参照から動画への変換と動画編集

短い回答

Seedance 2.5 には、専用の「参照から動画」スイッチはありません。content に参照動画が含まれるとすぐに、モデルはprompt の意図を読み取り、タスクが参照から動画、動画編集、または動画拡張のどれであるかを判断します。

prompt が元動画を変更する場合（追加、削除、修正、置換、何かを変更せずに維持）→ 動画編集
prompt が元動画を前方または後方へ継続する場合（拡張、継続）→ 動画拡張
prompt が、アセットからキャラクター、動き、またはスタイルを借りて新しいクリップを撮影するだけの場合 → 参照から動画

タスクが編集として分類されると、ratio は adaptive である必要があり、duration は -1 である必要があります。特定のアスペクト比または長さを渡すと 400 が返され、通常は TaskTypeConstraint に言及されます。

このページは Seedance 2.5（doubao-seedance-2-5-260628）にのみ適用されます。Seedance 2.0 ファミリーには動画編集または動画拡張タスクがないため、そこでこの問題は発生しません。

中核的な違い：アセットは出力に残るか？

	参照から動画	動画編集
アセットの役割	意味的な参照のみ：外見、動き、カメラワーク、スタイル、音声	ソース動画が出力のベースとなり、その上にモデルが要素を追加、削除、または変更します
出力アスペクト比	選択可能（7つの`ratio`値のいずれか）	ソース動画に固定されます。`ratio`は`adaptive`である必要があります
出力時間	選択可能（`duration`は4〜30）	ソース動画に固定されます。`duration`は`-1`である必要があります
ソース動画の要件	なし	長さは4〜30秒である必要があります。20秒未満が最適です
代表的なprompt	「ビーチで踊るダンサー、画像1のキャラクター、動画1を参照した振り付け」	「動画1の人物を画像1に置き換える」、「動画1から背景音楽を削除する」

簡単な判定方法：出力内にソース動画そのものがまだ見えますか？ 見える場合は、編集（または拡張）です。その「雰囲気」だけが引き継がれる場合は、参照から動画です。動画拡張は編集に似ています。アスペクト比はソース動画に固定されますが、時間は引き続き設定できます。

モデルの判定方法

判定は2段階で行われます。まずアセット role、次にpromptです。

タスクタイプ	アセット条件	promptのトリガーワード（プロバイダドキュメント）	`ratio`	`duration`
リファレンスから動画	`reference_image` / `reference_video` / `reference_audio` のうち少なくとも1つ	編集または延長の意図がない	任意	任意
動画編集	`reference_video` が少なくとも1つ	動画を編集、追加、削除、変更 / 置換 / ～に変更	`adaptive` である必要があります	`-1` である必要があります
動画延長	`reference_video` が少なくとも1つ	前方 / 後方へ延長、続ける	`adaptive` である必要があります	任意
第1フレーム / 第1・最終フレーム	`role` が `first_frame` / `last_frame`	promptに依存しません	`adaptive` である必要があります	任意

トリガーワードのリストは網羅的ではありません。モデルは完全一致する単語ではなく意味を判断します。「動画内のすべてを変更しないままにする」「動画1をHDにアップスケールする」「衣装を同じままにする」といったフレーズはリストにありませんが、いずれも元の映像を処理することを示しているため、動画編集として分類される場合があります。

リファレンス画像はあるもののリファレンス動画がないリクエストは、編集または延長として分類されることはありません。これは reference_video が存在する場合にのみ確認する必要があります。

実例

このリクエストでは、4:3と15秒も設定しながら「動画をアップスケール」しようとしていました。

{
  "model": "doubao-seedance-2-5-260628",
  "ratio": "4:3",
  "duration": 15,
  "resolution": "1080p",
  "content": [
    { "type": "text", "text": "Upscale reference video 1 to HD, keep all elements in the video unchanged, keep the outfits unchanged" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "asset://asset-xxxx" } }
  ]
}

このリクエストは直ちに400で拒否されました。

The parameters `ratio` and `duration` specified in the request are not valid.
Seedance identified your task as video editing based on your prompt. ...
Issues: [0] `ratio` must be `adaptive`. [1] `duration` must be -1.

「アップスケール」と「変更せずに維持」の組み合わせは元の映像を処理することを意味するため、モデルはこれを編集として分類しました。編集タスクでは、カスタムのアスペクト比や尺を指定できません。このリクエストは実際に編集であるため、正しい修正は次のとおりです。

"ratio": "adaptive",
"duration": -1

変更後、出力は元動画のアスペクト比と尺に従います。

パラメータで参照から動画への変換を強制できますか？

いいえ。 2.5 では、omni_reference_task_type は次の 3 つの値のみを受け付けます。

値	効果
`auto`（デフォルト）	モデルがアセットと prompt から判断します
`edit`	動画編集を宣言します。編集制約は送信時に検証されます
`extend`	動画拡張を宣言します。拡張制約は送信時に検証されます

「参照から動画への変換」という値はありません。また、edit / extend は 早期に検証する のみであり、タスクタイプを強制しません。宣言したタイプが、モデルが prompt から推論する内容と異なる場合でも、タスクは InvalidParameter.TaskTypeMismatch で失敗します。要するに、タスクタイプを決定するのは prompt です。パラメータはそれに合わせることしかできません。

信頼性の高い3つのアプローチ

出力サイズを問わない
アスペクト比と長さを固定する
コードで再試行する

プロバイダのドキュメントで推奨されている汎用的な設定です。参照アセットがある場合は、常に以下を送信してください。モデルがどのサブタスクを選択しても、パラメータ制約によってリクエストが失敗することはありません。

"omni_reference_task_type": "auto",
"ratio": "adaptive",
"duration": -1

トレードオフとして、タスクがリファレンスから動画として分類される場合、モデルが長さを選択します（テストでは10秒以上）。そのため、コストは長さに応じて変動します。コスト重視のワークロードには推奨されません。

ratio と duration を自分で設定するには、モデルがタスクをリファレンスから動画として分類する必要があります。これは prompt によって決まります。

アセットを参照、借用、または模倣する対象として説明し、何を参照するか（動き、カメラワーク、スタイル、キャラクターの見た目）を明示します
元動画に何をするかではなく、作成したい新しいシーンに焦点を当てます
追加 / 削除 / 修正 / 置換 / 変更、「…を変更せず維持」、「アップスケール / 復元」、または「延長 / 続き」といった表現は避けます

編集として解釈されやすい表現	リファレンスから動画として書き換えた表現
動画1の人物を画像1の女の子に置き換える	画像1の女の子がビーチ沿いを走る。動きとカメラワークは動画1を参照する
動画1のシーンを維持して猫を追加する	猫が街角を通り過ぎる。街のスタイルは動画1のものにする
動画1をアップスケールし、衣装は変更しない	動画1のキャラクターの見た目と衣装を取り入れた新しいランウェイ映像

prompt がエンドユーザーから渡され、制御できない場合は、この400をキャッチして一度だけ再送信してください。エラーは送信時に返されるため、タスクは作成されず、400のパラメータエラーには課金されません。

import os
import requests

URL = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"
HEADERS = {
    "Authorization": f"Bearer {os.environ['APIYI_API_KEY']}",
    "Content-Type": "application/json",
    "Accept-Encoding": "identity",
}

def submit(payload: dict) -> str:
    resp = requests.post(URL, headers=HEADERS, json=payload, timeout=300)
    if resp.status_code == 400 and "TaskTypeConstraint" in resp.text:
        # Classified as edit / extend / first-frame: release ratio and duration, then resubmit
        payload = {**payload, "ratio": "adaptive", "duration": -1}
        resp = requests.post(URL, headers=HEADERS, json=payload, timeout=300)
    resp.raise_for_status()
    return resp.json()["id"]

再試行後は、アスペクト比や長さを制御できなくなります。製品で出力仕様を保証する必要がある場合は、サイレントに再試行するのではなく、エラーをユーザーに返して言い換えを依頼してください。

エラーが発生するタイミング

シナリオ	失敗するタイミング	エラーコード
`edit` / `extend` を明示的に指定し、パラメータが制約に違反している場合	送信時に400	`InvalidParameter.TaskTypeConstraint`
省略した場合、または `auto` で、モデルが編集として分類し、パラメータが制約に違反している場合	プロバイダーのドキュメントではタスクは非同期で失敗するとされていますが、送信時に400が返ることもあります（上記のケースのように）	`InvalidParameter.TaskTypeConstraint`
指定したタイプがモデルの分類と異なる場合	タスクの実行開始後に失敗します	`InvalidParameter.TaskTypeMismatch`

この2つのエラーには異なる修正が必要です。TaskTypeConstraint の場合はパラメータを変更し、TaskTypeMismatch の場合は prompt を変更します（または omni_reference_task_type を auto に戻します）。

コストに関する注意事項

動画編集の出力は、希望した長さではなく元動画と同じ長さになります。25秒の元動画は、およそ25秒分として課金されます。
参照動画を使用するタスクでは、入力動画のフレームも課金対象のtokensに変換されます。より長く、高解像度の元動画ほどコストが高くなります。
参照から動画へのタスクでduration: -1を使用すると、モデルが長さを選択するため、想定より長くなる場合があります。

送信前に元動画の長さを確認すると、ほとんどの想定外を回避できます。タスクの実際の料金を確認するには、task_idでSeedance動画の実際のコストを調べる方法は？を参照してください。

動画生成 API

タスクタイプとパラメータ制約の比較、完全なリクエストパラメータ

Seedance 2.0 / 2.5 概要

2.5 と 2.0 の違い、完全な編集および拡張の使用方法

基本

基本API

画像API（公式）

動画API（公式）

マルチモーダル理解API

テキスト生成

音声API（公式）

検索と安全性

Seedance 2.5：参照から動画への変換と動画編集

短い回答

中核的な違い：アセットは出力に残るか？

モデルの判定方法

実例

パラメータで参照から動画への変換を強制できますか？

信頼性の高い3つのアプローチ

エラーが発生するタイミング

コストに関する注意事項

関連ドキュメント

動画生成 API

Seedance 2.0 / 2.5 概要

​短い回答

​中核的な違い：アセットは出力に残るか？

​モデルの判定方法

​実例

​パラメータで参照から動画への変換を強制できますか？

​信頼性の高い3つのアプローチ

​エラーが発生するタイミング

​コストに関する注意事項

​関連ドキュメント

動画生成 API

Seedance 2.0 / 2.5 概要

短い回答

中核的な違い：アセットは出力に残るか？

モデルの判定方法

実例

パラメータで参照から動画への変換を強制できますか？

信頼性の高い3つのアプローチ

エラーが発生するタイミング

コストに関する注意事項

関連ドキュメント