Dreamina Seedance 2.0 260128 を Comfy Router で使用する

BytePlus から Comfy Router が提供する byteplus/dreamina-seedance-2-0-260128 の API リファレンスです。

クイックスタート

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

結果を待つ
キューに送信して後で収集

from comfy_sdk import Comfy

# 環境変数から COMFY_API_KEY を読み取ります。
# SDK は自動的に冪等キーを作成し、自動リトライのために再利用します。
with Comfy() as client:
    result = client.models.run(
        "byteplus/dreamina-seedance-2-0-260128",
        {
            "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/dreamina-seedance-2-0-260128", {
  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/dreamina-seedance-2-0-260128",
    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/dreamina-seedance-2-0-260128 \
  -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/dreamina-seedance-2-0-260128/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/dreamina-seedance-2-0-260128",
        {
            "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/dreamina-seedance-2-0-260128", {
  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() が返すのと同じ結果です。失敗またはキャンセル済みのリクエストはここで拒否されます。
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/dreamina-seedance-2-0-260128",
    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/dreamina-seedance-2-0-260128/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/dreamina-seedance-2-0-260128/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. 収集。モデルネイティブの出力とともに 200、まだ実行中はステータスボディとともに 202 を返します。
curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"

サービングプロバイダー

このモデルは、リクエストで別のプロバイダーを指定しない限り、Comfy Router が直接サービングします。以下のプロバイダーも同じエンドポイント、同じモデル ID でこのモデルをサービングしており、model_provider クエリパラメータで選択します。

Comfy（デフォルト）: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128
fal、fal/fal-seedance-2.0 として: POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=fal

strict_mode のデフォルトは false であるため、Router はこのページに記載されているネイティブのリクエストボディをプロバイダー独自のスキーマに変換し、レスポンスを元に戻します。API リファレンスの model_provider、strict_mode、fallback_provider を参照してください。この方法でルーティングされるすべてのモデルについては、サービングプロバイダーを参照してください。

スキーマ

入力

string (uri)

この生成タスクの結果を受け取るコールバック通知先アドレス形式: uri

object[]

必須

モデルがビデオを生成するための入力コンテンツ

object

入力オーディオオブジェクト。オーディオ入力に対応するのは Seedance 2.5、2.0、2.0 fast のみです。Seedance 2.0 と 2.0 fast はオーディオ単体では使用できず、少なくとも 1 枚の画像または 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_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 はテキスト長の制限を公開しておらず、テスト（2026-09-17）では 40,000 文字を受け付けました。これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトでは転送時のサイズがこの数倍になることがあります。この制限が対象とするのはこの 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 またはアセット 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）で、色精度が高くポストプロダクションに適していますが、ファイルサイズは大きくなります。指定可能な値: 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/dreamina-seedance-2-0-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 時間しかない 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 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。

object

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

string

アップストリームの ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証およびプロバイダーの失敗を表します。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": "dreamina-seedance-2-0-260128",
  "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

Dreamina Seedance 2.0 260128 を Comfy Router で使用する

クイックスタート

サービングプロバイダー

スキーマ

入力

出力

例

入力

出力

出荷前の確認

ヘッダー

Router API の利用

制限事項

​クイックスタート

​サービングプロバイダー

​スキーマ

​入力

​出力

​例

​入力

​出力

​出荷前の確認

ヘッダー

Router API の利用

制限事項

クイックスタート

サービングプロバイダー

スキーマ

入力

出力

例

入力

出力

出荷前の確認