Comfy Router で Seedance 1.5 Pro 251215 を使用する

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

クイックスタート

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

結果を待つ
キューに送信して後で取得

from comfy_sdk import Comfy

# 環境変数から COMFY_API_KEY を読み取ります。
# SDK は冪等性キーを自動的に作成し、自動リトライのために再利用します。
with Comfy() as client:
    result = client.models.run(
        "byteplus/seedance-1-5-pro-251215",
        {
            "content": [
                {
                    "text": "A red fox trotting through a snowy pine forest",
                    "type": "text",
                },
            ],
            "duration": 5,
            "ratio": "16:9",
            "resolution": "720p",
        },
    )

print(result)

import { comfy } from "@comfyorg/sdk";

// 環境変数から COMFY_API_KEY を読み取ります。
// SDK は冪等性キーを自動的に作成し、自動リトライのために再利用します。
const { data } = await comfy.models.run("byteplus/seedance-1-5-pro-251215", {
  content: [
    {
      text: "A red fox trotting through a snowy pine forest",
      type: "text",
    },
  ],
  duration: 5,
  ratio: "16:9",
  resolution: "720p",
});

console.log(data);

import Foundation
import ComfySwiftSDK

// 環境変数から COMFY_API_KEY を読み取ります。
// SDK は呼び出しごとに冪等性キーを発行し、自動リトライのために再利用します。
let client = ComfyCloudClient(apiKey: ProcessInfo.processInfo.environment["COMFY_API_KEY"]!)
let result = try await client.models.run(
    "byteplus/seedance-1-5-pro-251215",
    input: [
        "content": [
            [
                "text": "A red fox trotting through a snowy pine forest",
                "type": "text",
            ],
        ],
        "duration": 5,
        "ratio": "16:9",
        "resolution": "720p",
    ]
)

print(result.output)

curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215 \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"content\": [{\"text\":\"A red fox trotting through a snowy pine forest\",\"type\":\"text\"}], \"duration\": 5, \"ratio\": \"16:9\", \"resolution\": \"720p\"}"

同じボディを POST https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests に送信します。Router は実行が受け付けられ次第 201 と request_id を返し、結果は準備が整った時点で、このプロセスからでも別のプロセスからでも取得できます。ステータス、キャンセル、結果の取得の詳細はキュー配信を参照してください。

from comfy_sdk import Comfy

# 環境から COMFY_API_KEY を読み取ります。
# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。
with Comfy() as client:
    handle = client.models.submit(
        "byteplus/seedance-1-5-pro-251215",
        {
            "content": [
                {
                    "text": "A red fox trotting through a snowy pine forest",
                    "type": "text",
                },
            ],
            "duration": 5,
            "ratio": "16:9",
            "resolution": "720p",
        },
    )
    print("request_id:", handle.request_id)  # モデル ID と合わせて、別のプロセスに必要なものはこれだけです

    # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After だけ待機します。
    for update in handle.iter_events():
        print(update.status, update.queue_position)

    # プロバイダー自身のペイロードで、models.run() が返す値と同じです。
    # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。
    result = handle.get()

print(result)

import { comfy } from "@comfyorg/sdk";

// 環境から COMFY_API_KEY を読み取ります。
// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。
const handle = await comfy.models.submit("byteplus/seedance-1-5-pro-251215", {
  content: [
    {
      text: "A red fox trotting through a snowy pine forest",
      type: "text",
    },
  ],
  duration: 5,
  ratio: "16:9",
  resolution: "720p",
});
console.log("requestId:", handle.requestId); // モデル ID と合わせて、別のプロセスに必要なものはこれだけです

// リクエストが完了するまでポーリングし、サーバーが指定する Retry-After だけ待機します。
for await (const update of handle.events()) {
  console.log(update.status, update.queuePosition);
}

// models.run() が返すのと同じ結果です。失敗またはキャンセルされたリクエストはここで reject されます。
const result = await handle.get();

console.log(result.data);

import Foundation
import ComfySwiftSDK

// 環境から COMFY_API_KEY を読み取ります。
// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。
let client = ComfyCloudClient(apiKey: ProcessInfo.processInfo.environment["COMFY_API_KEY"]!)
let handle = try await client.models.submit(
    "byteplus/seedance-1-5-pro-251215",
    input: [
        "content": [
            [
                "text": "A red fox trotting through a snowy pine forest",
                "type": "text",
            ],
        ],
        "duration": 5,
        "ratio": "16:9",
        "resolution": "720p",
    ]
)
print("requestId:", handle.requestId)  // モデル ID と合わせて、別のプロセスに必要なものはこれだけです

// リクエストが完了するまでポーリングし、サーバーが指定する Retry-After だけ待機します。
for try await update in handle.events() {
    print(update.state.rawValue, update.queuePosition.map(String.init) ?? "unknown")
}

// プロバイダー自身のペイロードで、models.run() が返す値と同じです。
// 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーをスローします。
let result = try await handle.result()

print(result.output)

# 1. 送信。Router は request_id、status_url、response_url、cancel_url を含む 201 を返します。
curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"content\": [{\"text\":\"A red fox trotting through a snowy pine forest\",\"type\":\"text\"}], \"duration\": 5, \"ratio\": \"16:9\", \"resolution\": \"720p\"}"

# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。
REQUEST_ID="<request_id from the 201 body>"
curl -i https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. 取得。実行完了時はモデルのネイティブ出力とともに 200、まだ実行中の場合はステータスボディとともに 202 を返します。
curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"

スキーマ

入力

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 エンコード、または Asset ID。オーディオURL: オーディオの公開URL（wav、mp3）。 Base64: 形式 data:audio/<format>;base64,<content> Asset ID: 形式 asset://<ASSET_ID>

object

string

必須

画像から動画への生成に使用する画像コンテンツ（type が “image_url” の場合）画像URL: 画像URLにアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/<format>;base64,<content> である必要があります Asset 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_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

必須

入力コンテンツの種類可能な値: text、image_url、video_url、audio_url

object

入力ビデオオブジェクト。ビデオ入力に対応するのは Seedance 2.5、2.0、2.0 fast のみです。

string

必須

ビデオURL または Asset ID。ビデオURL: ビデオの公開URL（mp4、mov）。 Asset 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）で色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。可能な値: mp4、mov

string

生成されるビデオのアスペクト比。Seedance 2.0 と 2.0 fast、1.5 pro のデフォルト: adaptive。可能な値: 16:9、4:3、1:1、3:4、9:16、21:9、9:21、adaptive

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 に対応しています。可能な値: 480p、720p、1080p、4k

boolean

デフォルト:"false"

生成されたビデオのラストフレーム画像を返すかどうか。 true: 生成されたビデオのラストフレーム画像を返します。このパラメーターを true に設定すると、動画生成タスク情報の照会を呼び出すことでラストフレーム画像を取得できます。ラストフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオのラストフレームが次のビデオタスクの最初のフレームとして使用され、複数の連続したビデオをすばやく生成できます。 false: 生成されたビデオのラストフレーム画像を返しません。

integer

ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。範囲: -1 から 4294967295

string

処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex（オフライン推論）をサポートしていません。指定可能な値: default、flex

boolean

デフォルト:"false"

生成されたビデオにウォーターマークが含まれるかどうか。

Router が GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するドキュメントと同じものです。

出力

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 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。

object

エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。

string

上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは enum ではなくオープンな文字列で、その他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。

string

エラーメッセージ

string

ビデオ生成タスクの ID

string

タスクで使用されたモデルの名前とバージョン

string

生成されたビデオのコンテナ形式 (mp4 または mov)。content の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリが返すのはこちらです。BytePlus 自身のフィールドで、そのまま転送されます。

string

生成されたビデオの解像度。たとえば 1080p です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。

integer

タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。形式: int64

string

タスクの状態取り得る値: queued、running、cancelled、succeeded、failed、expired

integer

タスクが最後に更新された時刻。値は秒単位の UNIX タイムスタンプです。

object

リクエストのトークン使用量

integer

モデルによって生成されたトークン数

integer

ビデオ生成モデルでは、入力トークン数は計算されず 0 が既定値です。したがって total_tokens = completion_tokens となります。

例

入力

{
  "content": [
    {
      "text": "A red fox trotting through a snowy pine forest",
      "type": "text"
    }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}

出力

{
  "content": {
    "last_frame_url": "https://example.invalid/byteplus/seedance-1-0-pro-250528/last-frame",
    "video_url": "https://example.invalid/byteplus/seedance-1-0-pro-250528/generated.mp4"
  },
  "created_at": 1767225600,
  "duration": 5,
  "error": null,
  "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60",
  "model": "seedance-1-5-pro-251215",
  "output_format": "mp4",
  "resolution": "1080p",
  "seed": 1234567890123,
  "status": "succeeded",
  "updated_at": 1767225730
}

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは結果 URL の有効期限があるため、早めにダウンロードしてください。上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズを参照してください。このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。

ヘッダー

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

Router API の利用

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

制限事項

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

Comfy で開発する

ワークフローの実行

Comfy Router

Comfy CLI

仕様

Demo Apps

Comfy Router で Seedance 1.5 Pro 251215 を使用する

クイックスタート

スキーマ

入力

出力

例

入力

出力

出荷前の確認

ヘッダー

Router API の利用

制限事項

​クイックスタート

​スキーマ

​入力

​出力

​例

​入力

​出力

​出荷前の確認

ヘッダー

Router API の利用

制限事項

クイックスタート

スキーマ

入力

出力

例

入力

出力

出荷前の確認