Skip to main content
byteplus/seedance-1-0-pro-250528 の API リファレンス。Comfy Router が BytePlus から提供しています。

クイックスタート

あなたの Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。cURL スニペットは、同じ呼び出しを raw HTTP で実行するものです。 モデル ID: byteplus/seedance-1-0-pro-250528 エンドポイント: POST https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528

スキーマ

入力

string (uri)
この生成タスクの結果を受け取るコールバック通知先形式: uri
object[]
必須
モデルがビデオを生成するための入力コンテンツ
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_framelast_framereference_imagereference_videoreference_audio
string
モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。パラメータ(任意): テキストプロンプトの後に —[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)
例: “A beautiful landscape —ratio 16:9 —resolution 720p —duration 5”Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は テキスト長の制限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 バイト数ではなく文字数をカウントするため、マルチバイトのプロンプトでは 転送時のサイズがこの数倍になることがあります。これはこの 1 つのフィールドを制限するものであり、 リクエスト全体を制限するものではありません。content は配列であり、 ドキュメント全体を制限するのはリクエストごとのボディ制限です。これを適用する窓口となるのは Comfy Router(/v2/models/byteplus/{model})です。v1 の /proxy を直接呼び出した場合は、 代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、 正当なプロンプトがこれで判定されることはありません。呼び出し元がさらに必要とする場合は 引き上げてください。
string
必須
入力コンテンツの種類指定可能な値: textimage_urlvideo_urlaudio_url
object
入力ビデオオブジェクト。ビデオ入力に対応するのは 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 から 30
integer
タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。範囲: 3600 から 259200
boolean
デフォルト:"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、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)。色精度が高くポストプロダクションに適していますが、ファイルサイズは大きくなります。指定可能な値: mp4mov
string
生成されるビデオのアスペクト比。Seedance 2.0 と 2.0 fast、1.5 pro のデフォルト: adaptive。指定可能な値: 16:94:31:13:49:1621:99:21adaptive
string
ビデオの解像度。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 をサポートしています。指定可能な値: 480p720p1080p4k
boolean
デフォルト:"false"
生成済みビデオの最後のフレーム画像を返すかどうか。 true: 生成済みビデオの最後のフレーム画像を返します。このパラメータを true に設定した後、「ビデオ生成タスクの情報を照会する」APIを呼び出すことで、最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成済みビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。つまり、先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオをすばやく生成できます。 false: 生成済みビデオの最後のフレーム画像を返しません。
integer
ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。範囲: -1 から 4294967295
string
処理に使用するサービステア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしていません。指定可能な値: defaultflex
boolean
デフォルト:"false"
生成済みビデオにウォーターマークが含まれるかどうか。
Router が GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json で提供するスキーマ、すなわちリクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントから生成されています。

出力

object
ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。video_urllast_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 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。
object
エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合は、エラー情報が返されます。
string
エラーコード
string
エラーメッセージ
string
ビデオ生成タスクの ID
string
タスクで使用されたモデルの名前とバージョン
string
生成済みビデオのコンテナ形式 (mp4 または mov) で、content の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここに返します。BytePlus 自身のフィールドで、そのまま転送されます。
string
生成済みビデオの解像度 (たとえば 1080p) です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。
integer
タスクで実際に使用された生成シードです。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。形式: int64
string
タスクの状態取り得る値: queuedrunningcancelledsucceededfailedexpired
integer
タスクが最後に更新された時間です。値は秒単位の UNIX タイムスタンプです。
object
リクエストのトークン使用量
integer
モデルによって生成されたトークン数
integer
ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens となります。

入力

出力

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。 上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズ を参照してください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。