Skip to main content
byteplus/seedance-1-5-pro-251215 の API リファレンス。BytePlus から Comfy Router によって提供されます。

クイックスタート

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

Schema

入力

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]。範囲: 230
integer
タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。範囲: 3600259200
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 呼び出しでは必ず指定する必要があり、proxy はそれ以外の値、および省略された場合は 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 に設定すると、「ビデオ生成タスクの情報を取得する」を呼び出すことでラストフレーム画像を取得できます。ラストフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオのラストフレームを次のビデオタスクの最初のフレームとして使用することで、複数の連続したビデオを素早く生成できます。 false: 生成されたビデオのラストフレーム画像を返しません。
integer
ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。範囲: -1 から 4294967295
string
処理に使用するサービステア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしていません。指定可能な値: defaultflex
boolean
デフォルト:"false"
生成されたビデオにウォーターマークを含めるかどうか。
GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json で Router が配信するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。

出力

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 時間しかない URL が返されることがあります。再ホストを実行できなかった場合、このフィールドは代わりに 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 時間しかない URL が返されることがあります。再ホストを実行できなかった場合、このフィールドは代わりに 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 のビデオタスクで返され、そのまま転送されます。形式: 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 が現在対応していないことと、代替手段。