byteplus/dreamina-seedance-2-0-fast-260128 の API Reference です。Comfy Router が BytePlus から提供しています。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用します。cURL のスニペットは同じ呼び出しを生の HTTP で行うものです。
Model ID: byteplus/dreamina-seedance-2-0-fast-260128
Endpoint: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128
- Wait for the result
- Queue and collect later
スキーマ
入力
string (uri)
この生成タスクの結果を受け取るコールバック通知先形式:
uriobject[]
必須
モデルがビデオを生成するための入力コンテンツ
object
入力オーディオオブジェクト。オーディオ入力に対応するのは Seedance 2.5、2.0、2.0 fast のみです。Seedance 2.0 と 2.0 fast はオーディオ単体では使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応します。
string
必須
オーディオURL、Base64 エンコード、またはアセット ID。
オーディオURL: オーディオの公開URL(wav、mp3)。
Base64: 形式 data:audio/<format>;base64,<content>
アセット ID: 形式 asset://<ASSET_ID>
object
string
必須
画像から動画への生成に使用する画像コンテンツ(type が “image_url” の場合)
画像URL: 画像URLにアクセスできることを確認してください。
Base64 エンコードされたコンテンツ: 形式は data:image/<format>;base64,<content> である必要があります
アセット ID: 形式 asset://<ASSET_ID>
string
コンテンツ項目の役割/位置。
画像の場合: first_frame、last_frame、または reference_image。
ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast のみ)。
オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast のみ)。指定可能な値:
first_frame, last_frame, reference_image, reference_video, reference_audiostring
モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。パラメータ(任意): テキストプロンプトの後に —[parameters] を追加してビデオの仕様を制御します:
- —resolution(—rs): 480p、720p、1080p(デフォルト: 720p)
- —ratio(—rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive)
- —duration(—dur): 3~12 秒(デフォルト: 5)
- —framepersecond(—fps): 24(デフォルト: 24)
- —watermark(—wm): true/false(デフォルト: false)
- —seed(—seed): -1~2^32-1(デフォルト: -1)
- —camerafixed(—cf): true/false(デフォルト: false)
string
必須
入力コンテンツのタイプ指定可能な値:
text, image_url, video_url, audio_urlobject
入力ビデオオブジェクト。ビデオ入力に対応するのは Seedance 2.5、2.0、2.0 fast のみです。
string
必須
ビデオURLまたはアセット ID。
ビデオURL: ビデオの公開URL(mp4、mov)。
アセット ID: 形式 asset://<ASSET_ID>
`-1` | object
ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみに対応)。Seedance 2.0 と 2.0 fast: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。範囲:
2 ~ 30integer
タスクのタイムアウトしきい値(秒)。デフォルト 172800(48時間)。範囲: [3600, 259200]。範囲:
3600 ~ 259200boolean
デフォルト:"true"
Seedance 2.5、2.0、2.0 fast、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。
true: モデルは同期したオーディオ付きのビデオを出力します。
false: モデルは無音のビデオを出力します。
string
呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、seedance-1-0-lite-t2v-250428、seedance-1-0-lite-i2v-250428、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接 v1 呼び出しでは、これを必ず指定する必要があります。プロキシはそれ以外の値、および省略された値を 400 で拒否します。これはこのスキーマの
required リストには含まれていません。Comfy Router が /v2/models/byteplus/{model} の {model} パスセグメントから入力するため、Router の呼び出し元は省略します。string
デフォルト:"\"mp4\""
Seedance 2.5 のみ。出力ビデオのコンテナ形式。
mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さなファイルサイズ。
mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。指定可能な値:
mp4, movstring
生成されるビデオのアスペクト比。Seedance 2.0 と 2.0 fast、1.5 pro のデフォルト: adaptive。指定可能な値:
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 9:21, adaptivestring
ビデオ解像度。Seedance 2.5、2.0 と 2.0 fast、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。
注: Seedance 2.0 と 2.0 fast は 1080p に対応していません。Seedance 2.5 は 480p、720p、1080p に対応します。指定可能な値:
480p, 720p, 1080p, 4kboolean
デフォルト:"false"
生成されたビデオの最後のフレーム画像を返すかどうか。true: 生成済みビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を取得するを呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル幅と高さは生成済みビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最後のフレームが次のビデオタスクの最初のフレームとして使用され、複数の連続したビデオをすばやく生成できます。
false: 生成済みビデオの最後のフレーム画像を返しません。
integer
ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。範囲:
-1 から 4294967295string
処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしていません。取り得る値:
default、flexboolean
デフォルト:"false"
生成済みビデオにウォーターマークが含まれるかどうか。
GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するのと同じドキュメントです。
出力
object
ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最後のフレームのダウンロード URL を含みます。
video_url と last_frame_url はどちらも Comfy ストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 独自のものです。Null 許容です。BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした succeeded ドキュメントでは content が存在しないか null になっていることがあります。string
生成されたビデオの最後のフレームのダウンロード URL。リクエストで
return_last_frame を設定した場合に返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最後のフレームを PNG としてドキュメント化していますが、Router は提供されたバイトをそのまま再ホストし、上流の Content-Type またはコンテンツスニッフから型を判定します。image/jpeg はその両方が失敗した場合の最後の手段のフォールバックにすぎません。Router は最後のフレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返されることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持します。これは BytePlus がタスクの 24 時間後にクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。string
生成されたビデオのコンテナ形式(mp4 または mov)。BytePlus がこれを
content の中にネストして返す場合に含まれます。Seedance モデルでは、content のトップレベルの兄弟として返すことの方が一般的です。トップレベルの output_format フィールドを参照してください。Router はどちらか存在する方を読み取ります。string
出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返されることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持します。これは BytePlus がタスクの 24 時間後にクリアし、一部のモデルではダウンロード回数が 100 回に制限されます。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。
integer
タスクが作成された時間。値は秒単位の UNIX タイムスタンプです。
number
生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは整数秒が返されることが観察されており、同系列の BytePlus のサーフェスでは小数の再生時間が報告されています。そのため、クライアントは整数値を前提にしてはなりません。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。
object
エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。
string
エラーコード
string
エラーメッセージ
string
ビデオ生成タスクの ID
string
タスクで使用されたモデルの名前とバージョン
string
生成されたビデオのコンテナ形式(mp4 または mov)。
content の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリが返すのはここです。BytePlus 独自のフィールドで、そのまま転送されます。string
生成されたビデオの解像度。例えば
1080p です。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。integer
タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。形式:
int64string
タスクの状態取り得る値:
queued、running、cancelled、succeeded、failed、expiredinteger
タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。
object
リクエストのトークン使用量
integer
モデルによって生成されたトークン数
integer
ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens となります。
例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。