Seedance 1.0 Pro Fast 251015 を Comfy Router で使用する

byteplus/seedance-1-0-pro-fast-251015 の 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-0-pro-fast-251015 エンドポイント: POST https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015

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

from comfy_sdk import Comfy

# 環境から COMFY_API_KEY を読み取ります。
# SDK は冪等性キーを自動的に作成し、自動再試行のために再利用します。
with Comfy() as client:
    result = client.models.run(
        "byteplus/seedance-1-0-pro-fast-251015",
        {
            "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-0-pro-fast-251015", {
  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-0-pro-fast-251015",
    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-0-pro-fast-251015 \
  -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-0-pro-fast-251015/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-0-pro-fast-251015",
        {
            "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-0-pro-fast-251015", {
  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-0-pro-fast-251015",
    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-0-pro-fast-251015/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. status が COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。
REQUEST_ID="<request_id from the 201 body>"
curl -i https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. 取得。モデルのネイティブ出力とともに 200、まだ実行中はステータスボディとともに 202 を返します。
curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/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 エンコード、またはアセット 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/seedance-1-0-pro-fast-251015/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に、Router が呼び出しを検証する際に使用する同じドキュメントです。

出力

object

ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。video_url と last_frame_url はどちらも Comfy のストレージに再ホストされ、ここにあるその他のフィールドはすべて BytePlus 自身のものです。null 許容です。BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みドキュメントでは 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-0-pro-fast-251015",
  "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

Seedance 1.0 Pro Fast 251015 を Comfy Router で使用する

クイックスタート

スキーマ

入力

出力

例

入力

出力

出荷前の確認

ヘッダー

Router API の利用

制限事項

​クイックスタート

​スキーマ

​入力

​出力

​例

​入力

​出力

​出荷前の確認

ヘッダー

Router API の利用

制限事項

クイックスタート

スキーマ

入力

出力

例

入力

出力

出荷前の確認