From cc48c03eb44fe05e8a99ba8b963ec747edb00b29 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 11:22:02 +0800 Subject: [PATCH 01/36] i18n: sync zh/ja/ko and es translations with upstream/main (2026-11-10) --- ja/development/comfy-router/models.mdx | 13 +- .../models/kling/kling-4-0/code.mdx | 7 +- .../models/kling/kling-v2-5-turbo/code.mdx | 107 +++---- .../models/kling/kling-v2-6/code.mdx | 87 +++--- .../models/kling/kling-v3/code.mdx | 84 +++--- .../models/wan/happyhorse-1-0-i2v/code.mdx | 276 ++++++++--------- .../models/wan/happyhorse-1-0-r2v/code.mdx | 259 ++++++++-------- .../models/wan/happyhorse-1-1-i2v/code.mdx | 227 ++++++++------ .../models/wan/happyhorse-1-1-r2v/code.mdx | 269 ++++++++--------- .../models/wan/wan2-5-i2i-preview/code.mdx | 82 ++--- .../models/wan/wan2-5-i2v-preview/code.mdx | 210 ++++++++----- .../models/wan/wan2-6-t2v/code.mdx | 280 +++++++++--------- .../models/wan/wan2-7-t2v/code.mdx | 221 +++++++++----- .../models/wan/wan2-7-videoedit/code.mdx | 185 ++++++------ ja/development/comfy-router/reference.mdx | 196 ++++++------ ko/development/comfy-router/models.mdx | 13 +- .../models/kling/kling-4-0/code.mdx | 7 +- .../models/kling/kling-v2-5-turbo/code.mdx | 65 ++-- .../models/kling/kling-v2-6/code.mdx | 81 ++--- .../models/kling/kling-v3/code.mdx | 80 ++--- .../models/wan/happyhorse-1-0-i2v/code.mdx | 225 +++++++------- .../models/wan/happyhorse-1-0-r2v/code.mdx | 207 ++++++------- .../models/wan/happyhorse-1-1-i2v/code.mdx | 210 ++++++------- .../models/wan/happyhorse-1-1-r2v/code.mdx | 215 +++++++------- .../models/wan/wan2-5-i2i-preview/code.mdx | 32 +- .../models/wan/wan2-5-i2v-preview/code.mdx | 201 +++++++------ .../models/wan/wan2-6-t2v/code.mdx | 197 ++++++------ .../models/wan/wan2-7-t2v/code.mdx | 216 +++++++------- .../models/wan/wan2-7-videoedit/code.mdx | 214 +++++++------ ko/development/comfy-router/reference.mdx | 201 +++++++------ zh/development/comfy-router/models.mdx | 23 +- .../models/kling/kling-4-0/code.mdx | 7 +- .../models/kling/kling-v2-5-turbo/code.mdx | 53 ++-- .../models/kling/kling-v2-6/code.mdx | 73 ++--- .../models/kling/kling-v3/code.mdx | 84 +++--- .../models/wan/happyhorse-1-0-i2v/code.mdx | 195 +++++------- .../models/wan/happyhorse-1-0-r2v/code.mdx | 202 +++++-------- .../models/wan/happyhorse-1-1-i2v/code.mdx | 196 +++++------- .../models/wan/happyhorse-1-1-r2v/code.mdx | 185 ++++-------- .../models/wan/wan2-5-i2i-preview/code.mdx | 46 +-- .../models/wan/wan2-5-i2v-preview/code.mdx | 212 +++++++------ .../models/wan/wan2-6-t2v/code.mdx | 218 +++++++------- .../models/wan/wan2-7-t2v/code.mdx | 222 +++++++------- .../models/wan/wan2-7-videoedit/code.mdx | 194 +++++------- zh/development/comfy-router/reference.mdx | 198 ++++++------- 45 files changed, 3342 insertions(+), 3433 deletions(-) diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index fed0111ba8..8dcb7e4ba9 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -2,7 +2,7 @@ title: "Comfy Router モデル" sidebarTitle: "すべてのモデル" description: "Comfy Router で利用できるすべてのモデルを、各モデルの入力と出力のモダリティとあわせて、プロバイダー別にまとめています。" -translationSourceHash: c9297323 +translationSourceHash: 947ab0cb translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 @@ -20,7 +20,7 @@ translationBlockHashes: "HeyGen": 76fe1a0d "Higgsfield": 0ce2b918 "Ideogram": c22a0e5e - "Kling": 2b95e99f + "Kling": aec38bcd "Krea": 16b83e5e "LTX": 32595bf9 "Luma": 8cd2a7ce @@ -47,6 +47,7 @@ translationBlockHashes: + {/* 生成済みファイル。Router カタログから `pnpm code-pages:gen` によって生成されます。 */} 以下に挙げるすべてのモデルは、同じルート `POST /v2/models/{provider}/{model}` で提供され、それぞれのモデル固有の JSON ボディを使用します。各ページには、Python、TypeScript、cURL で動作するリクエスト例を掲載しています。ディスカバリー、スキーマ、エラー、リトライ、課金については、[Comfy Router API の使用](/ja/development/comfy-router/api) を参照してください。 @@ -548,12 +549,12 @@ translationBlockHashes: | モデル | ID | 入力 | 出力 | | --- | --- | --- | --- | | [Kling 3.0 Turbo](/ja/development/comfy-router/models/kling/kling-3-0-turbo/code) | `kling/kling-3.0-turbo` | テキスト | ビデオ | -| [Kling 4.0](/ja/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | テキスト | ビデオ | +| [Kling 4.0](/ja/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | テキスト, 画像, ビデオ | ビデオ | | [Kling Image O1](/ja/development/comfy-router/models/kling/kling-image-o1/code) | `kling/kling-image-o1` | テキスト, 画像 | 画像 | -| [Kling V2.5 Turbo](/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code) | `kling/kling-v2-5-turbo` | テキスト | ビデオ | -| [Kling V2.6](/ja/development/comfy-router/models/kling/kling-v2-6/code) | `kling/kling-v2-6` | テキスト | ビデオ | +| [Kling V2.5 Turbo](/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code) | `kling/kling-v2-5-turbo` | 画像, テキスト | ビデオ | +| [Kling V2.6](/ja/development/comfy-router/models/kling/kling-v2-6/code) | `kling/kling-v2-6` | 画像, テキスト | ビデオ | | [Kling V3 Omni](/ja/development/comfy-router/models/kling/kling-v3-omni/code) | `kling/kling-v3-omni` | テキスト, 画像, ビデオ | ビデオ | -| [Kling V3](/ja/development/comfy-router/models/kling/kling-v3/code) | `kling/kling-v3` | テキスト | ビデオ | +| [Kling V3](/ja/development/comfy-router/models/kling/kling-v3/code) | `kling/kling-v3` | 画像, テキスト | ビデオ | | [Kling Video O1](/ja/development/comfy-router/models/kling/kling-video-o1/code) | `kling/kling-video-o1` | テキスト, 画像, ビデオ | ビデオ | | [Videos Avatar Image 2video](/ja/development/comfy-router/models/kling/videos-avatar-image2video/code) | `kling/videos-avatar-image2video` | 画像, オーディオ | ビデオ | | [Videos Lip Sync](/ja/development/comfy-router/models/kling/videos-lip-sync/code) | `kling/videos-lip-sync` | ビデオ, オーディオ | ビデオ | diff --git a/ja/development/comfy-router/models/kling/kling-4-0/code.mdx b/ja/development/comfy-router/models/kling/kling-4-0/code.mdx index 1d83c9119a..537e988d8a 100644 --- a/ja/development/comfy-router/models/kling/kling-4-0/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-4-0/code.mdx @@ -2,21 +2,22 @@ title: "Kling 4.0 を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-4.0 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling 4.0" -translationSourceHash: ed37a731 +translationSourceHash: df75d2dd translationFrom: development/comfy-router/models/kling/kling-4-0/code.mdx translationBlockHashes: - "_intro": a4fab55c + "_intro": 1eb48be4 "Quick start": 44d4a538 "Schema": 659ba1ad "Examples": c9f5b052 --- + {/* GENERATED FILE. `router-schemas/kling/kling-4.0.json` から `pnpm code-pages:gen` により生成されたファイル。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; `kling/kling-4.0` の API リファレンスです。Comfy Router が Kling から提供しています。 -**入力:** テキスト · **出力:** ビデオ +**入力:** テキスト、画像、ビデオ · **出力:** ビデオ ## クイックスタート diff --git a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index f5f740e601..7fab3ca53b 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,23 +2,22 @@ title: "Kling V2.5 Turbo を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-v2-5-turbo を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1671e7b6 +translationSourceHash: 06b3d8e9 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: - "_intro": 2495a4d3 + "_intro": 785eeca2 "Quick start": dc63b3ac - "Schema": 3bcb036e + "Schema": e36b5646 "Examples": 8623c725 --- - {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v2-5-turbo.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; `kling/kling-v2-5-turbo` の API リファレンスです。Comfy Router が Kling から提供しています。 -**入力:** テキスト · **出力:** ビデオ +**入力:** 画像、テキスト · **出力:** ビデオ ## クイックスタート @@ -162,11 +161,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID ビデオのアスペクト比 - 指定可能な値: `16:9`、`9:16`、`1:1` + 取り得る値: `16:9`, `9:16`, `1:1` - コールバック通知先アドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。 + コールバック通知先のアドレス。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router がユーザーに代わってポーリングします。 形式: `uri` @@ -180,69 +179,69 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - カメラの水平軸(x軸)に沿った移動を制御します。負の値は左、正の値は右を示します。 + カメラの水平軸(x軸)に沿った動きを制御します。負の値は左、正の値は右を示します。 - 範囲: `-10` ~ `10` + 範囲: `-10` から `10` - 垂直面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。 + 垂直面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。 - 範囲: `-10` ~ `10` + 範囲: `-10` から `10` - カメラのロール量(z軸)を制御します。負の値は反時計回り、正の値は時計回りを示します。 + カメラのロール量(z軸)を制御します。負の値は反時計回り、正の値は時計回りを示します。 - 範囲: `-10` ~ `10` + 範囲: `-10` から `10` - 水平面内でのカメラの回転(y軸)を制御します。負の値は左への回転、正の値は右への回転を示します。 + 水平面内でのカメラの回転(y軸)を制御します。負の値は左回転、正の値は右回転を示します。 - 範囲: `-10` ~ `10` + 範囲: `-10` から `10` - カメラの垂直軸(y軸)に沿った移動を制御します。負の値は下向き、正の値は上向きを示します。 + カメラの垂直軸(y軸)に沿った動きを制御します。負の値は下、正の値は上を示します。 - 範囲: `-10` ~ `10` + 範囲: `-10` から `10` - カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。 + カメラの焦点距離の変化を制御します。負の値は狭い視野、正の値は広い視野を示します。 - 範囲: `-10` ~ `10` + 範囲: `-10` から `10` - 定義済みのカメラワークの種類。simple: カスタマイズ可能なカメラワーク。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 + 定義済みのカメラの動きの種類。simple: カスタマイズ可能なカメラの動き。down_back: カメラが下降して後退します。forward_up: カメラが前進して上に傾きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 - 指定可能な値: `simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` + 取り得る値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` ビデオ生成における柔軟性。値が高いほどモデルの柔軟性が低くなり、ユーザーのプロンプトとの関連性が強くなります。 - 範囲: `0` ~ `1` + 範囲: `0` から `1` 形式: `float` - ビデオの長さ(秒) + ビデオの長さ(秒) - 指定可能な値: `3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 取り得る値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - カスタムタスクID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。 + カスタマイズされたタスク ID。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router がユーザーに代わってポーリングします。 - ビデオ生成モード。std: コスト効率の良いスタンダードモード。pro: プロフェッショナルモードで、より長い再生時間と高品質な出力のビデオを生成します。 + ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロモード。より長い再生時間のビデオを高品質な出力で生成します。 - 指定可能な値: `std`、`pro` + 取り得る値: `std`, `pro` @@ -250,51 +249,51 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大6つのストーリーボードをサポートし、最低1つ必要です。multi_shot が true かつ shot_type が customize の場合に必須です。 + 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大 6 つのストーリーボードをサポートし、最小は 1 です。multi_shot が true かつ shot_type が customize の場合に必須です。 - このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 + このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 - ショットの順番 + ショットの連番 - このストーリーボードのプロンプト。最大長は512文字です。 + このストーリーボードのプロンプト。最大長は 512 文字です。 - マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効になります。false の場合、shot_type および multi_prompt パラメータは無効になります。 + マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type と multi_prompt パラメータは無効です。 - ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文を追加して補うことを推奨します。 + ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接否定文で補足することが推奨されます。 - ポジティブテキストプロンプト。\<\<\>> を使用して、voice_list パラメータの順序に対応するボイスを指定します。1つのタスクで最大2つの音声トーンを参照できます。トーンを指定する場合、sound パラメータの値は on にする必要があります。 + ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには \<\<\>> を使用します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。 - 指定可能な値: `customize`、`intelligence` + 取り得る値: `customize`, `intelligence` - ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータはモデルの V2.6 以降のバージョンのみがサポートします。 + ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のモデルのみです。 - 指定可能な値: `on`、`off` + 取り得る値: `on`, `off` - 動画生成時に参照するボイスのリストです。最大 2 つのボイスに対応し、`prompt` 内でリスト順に \<\<\>> と \<\<\>> として参照します。`sound` を "on" にする必要があり、これに対応するのは V2.6 以降のモデルのみです。それより前のモデル、または `sound` が既定値の "off" のままの場合、ボイスは適用されません。 + ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順序に従って `prompt` 内で \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これをサポートするのは V2.6 以降のモデルのみです。それ以前のモデルの場合、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。 - ボイスカスタマイズ API が返すボイス ID、またはシステムのプリセットボイス ID。 + 音声カスタマイズ API を通じて返される音声 ID、またはシステムプリセットの音声 ID。 @@ -305,7 +304,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID true は透かしを生成することを意味し、false は生成しないことを意味します。 -`GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 + + 参照画像 - URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 + + + + 参照画像 - 終了フレームの制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。 + + +Router が `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 ### 出力 @@ -318,7 +325,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - タスク作成時間、Unix タイムスタンプ(ミリ秒) + タスクの作成時間(Unix タイムスタンプ、ミリ秒単位) @@ -346,37 +353,37 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - ビデオの合計再生時間(秒) + ビデオの合計再生時間(秒単位) - 生成されたビデオの ID + 生成されたビデオ ID 生成されたビデオの URL - フォーマット: `uri` + 形式: `uri` - ウォーターマーク付きの生成されたビデオの URL、直リンク防止形式 + ウォーターマーク付きで生成されたビデオの URL(ホットリンク防止形式) - フォーマット: `uri` + 形式: `uri` - タスクステータス + タスクのステータス - 有効な値: `submitted`、`processing`、`succeed`、`failed` + 取り得る値: `submitted`、`processing`、`succeed`、`failed` - タスクステータス情報。タスクが失敗した場合は失敗理由を表示します + タスクのステータス情報。タスクが失敗した場合は失敗理由が表示されます - タスク更新時間、Unix タイムスタンプ(ミリ秒) + タスクの更新時間(Unix タイムスタンプ、ミリ秒単位) diff --git a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx index 73d67c2e0f..3e6eed5a07 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router で Kling V2.6 を使用する" description: "Comfy Router 経由で kling/kling-v2-6 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.6" -translationSourceHash: c445a7bd +translationSourceHash: 94eb0863 translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: - "_intro": 04868509 + "_intro": c2065202 "Quick start": 48a3d970 - "Schema": a61a551f + "Schema": cd52808d "Examples": 8623c725 --- - {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v2-6.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; `kling/kling-v2-6` の API リファレンスです。Kling が提供し、Comfy Router が配信します。 -**入力:** テキスト · **出力:** ビデオ +**入力:** 画像、テキスト · **出力:** ビデオ ## クイックスタート @@ -160,13 +159,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ ### 入力 - ビデオのアスペクト比 + ビデオのアスペクト比率 - 指定可能な値: `16:9`、`9:16`、`1:1` + 指定可能な値: `16:9`, `9:16`, `1:1` - コールバック通知先アドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。 + コールバック通知のアドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 形式: `uri` @@ -210,19 +209,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広がることを示します。 + カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。 範囲: `-10` から `10` - 定義済みのカメラの動きの種類。simple: カスタマイズ可能なカメラの動き。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上を向きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 + 定義済みのカメラワークの種類。simple: カスタマイズ可能なカメラワーク。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上に傾きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 - 指定可能な値: `simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` + 指定可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - ビデオ生成における柔軟性。値が高いほどモデルの柔軟性の度合いが低くなり、ユーザーのプロンプトとの関連性が強くなります。 + ビデオ生成における柔軟性。値が高いほどモデルの柔軟性が低くなり、ユーザーのプロンプトとの関連性が強くなります。 範囲: `0` から `1` @@ -232,17 +231,17 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ ビデオの長さ (秒) - 指定可能な値: `3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 指定可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。 + カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間で、より高品質な出力のビデオを生成します。 + ビデオ生成モード。std: スタンダードモードで、コスト効率に優れています。pro: プロフェッショナルモードで、より長い再生時間で高品質なビデオを生成します。 - 指定可能な値: `std`、`pro` + 指定可能な値: `std`, `pro` @@ -250,11 +249,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 各ストーリーボードに関する情報 (プロンプトや再生時間など)。最大 6 つのストーリーボードをサポートし、最小は 1 です。multi_shot が true かつ shot_type が customize の場合に必須です。 + 各ストーリーボードのプロンプトや再生時間などの情報。最大 6 つのストーリーボードをサポートし、最小で 1 つです。multi_shot が true かつ shot_type が customize の場合に必須です。 - このストーリーボードの再生時間 (秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 + このストーリーボードの再生時間 (秒)。タスク全体の再生時間を超えてはならず、1 未満にすることもできません。すべてのストーリーボードの再生時間の合計がタスク全体の再生時間と等しくなります。 @@ -266,46 +265,54 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type および multi_prompt パラメータは無効です。 + マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type と multi_prompt パラメータは無効です。 - ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文として補足することを推奨します。 + ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接否定的な文で補うことが推奨されます。 - ポジティブテキストプロンプト。\<\<\>> を使用して、voice_list パラメータの順序に対応するボイスを指定します。1 つのタスクで最大 2 つのトーンを参照できます。トーンを指定する場合、sound パラメータの値は on である必要があります。 + ポジティブテキストプロンプト。\< \<\>> を使用して voice_list パラメータの順序に対応する音声を指定します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。 - 指定可能な値: `customize`、`intelligence` + 指定可能な値: `customize`, `intelligence` - ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のバージョンのモデルのみです。 + ビデオ生成時に同時にサウンドを生成するかどうか。V2.6 以降のモデルのみがこのパラメータをサポートします。 - 指定可能な値: `on`、`off` + 指定可能な値: `on`, `off` - 動画生成時に参照するボイスのリストです。最大 2 つのボイスに対応し、`prompt` 内でリスト順に \<\<\>> と \<\<\>> として参照します。`sound` を "on" にする必要があり、これに対応するのは V2.6 以降のモデルのみです。それより前のモデル、または `sound` が既定値の "off" のままの場合、ボイスは適用されません。 + ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順に `prompt` 内で \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これは V2.6 以降のモデルのみがサポートします。それ以前のモデルの場合、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。 - ボイスカスタマイズ API が返すボイス ID、またはシステムのプリセットボイス ID。 + 音声カスタマイズ API から返された音声 ID、またはシステムプリセットの音声 ID。 - ウォーターマーク付きの結果を同時に生成するかどうか。現時点ではカスタムウォーターマークはサポートされていません。 + 透かし入りの結果を同時に生成するかどうか。現時点ではカスタム透かしはサポートされていません。 - true はウォーターマークを生成することを意味し、false は生成しないことを意味します。 + true は透かしを生成することを意味し、false は生成しないことを意味します。 + + + + 参照画像: URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 + + + + 参照画像: 終了フレーム制御。URL または Base64 エンコード文字列で、10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。 -Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 +これは Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるのと同じドキュメントです。 ### 出力 @@ -318,15 +325,15 @@ Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキ - タスク作成時間。Unix タイムスタンプ(ミリ秒) + タスク作成時間、Unixタイムスタンプ(ミリ秒) - タスクの消費ユニット数 + タスクの控除単位 - タスク ID + タスクID @@ -350,33 +357,33 @@ Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキ - 生成されたビデオの ID + 生成済みビデオID - 生成されたビデオの URL + 生成済みビデオのURL 形式: `uri` - ウォーターマーク付きの生成ビデオの URL。直リンク防止形式 + ウォーターマーク付き生成済みビデオのURL、ホットリンク保護形式 形式: `uri` - タスクのステータス + タスクステータス - 指定可能な値: `submitted`、`processing`、`succeed`、`failed` + 可能な値: `submitted`、`processing`、`succeed`、`failed` - タスクのステータス情報。タスクが失敗した場合は失敗理由を表示します + タスクステータス情報。タスクが失敗した場合は失敗理由を表示します - タスク更新時間。Unix タイムスタンプ(ミリ秒) + タスク更新時間、Unixタイムスタンプ(ミリ秒) @@ -392,7 +399,7 @@ Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキ - リクエスト ID + リクエストID ## 例 diff --git a/ja/development/comfy-router/models/kling/kling-v3/code.mdx b/ja/development/comfy-router/models/kling/kling-v3/code.mdx index 23629b0a48..e5ce98e2fb 100644 --- a/ja/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,25 +2,23 @@ title: "Comfy Router で Kling V3 を使用する" description: "Comfy Router 経由で kling/kling-v3 を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V3" -translationSourceHash: e22b6413 +translationSourceHash: f5127eab translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: - "_intro": 74a12e0f + "_intro": 6b9cddba "Quick start": 09c0a41a "Serving providers": b4093d36 - "Schema": 8e8b04e6 + "Schema": 2fce4523 "Examples": 8623c725 --- - - {/* GENERATED FILE. Generated from router-schemas/kling/kling-v3.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; -`kling/kling-v3` の API リファレンス。Kling から提供され、Comfy Router 経由で配信されます。 +`kling/kling-v3` の API リファレンス。Kling から提供され、Comfy Router が配信します。 -**入力:** テキスト · **出力:** ビデオ +**入力:** 画像、テキスト · **出力:** ビデオ ## クイックスタート @@ -181,7 +179,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - コールバック通知先アドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。 + コールバック通知のアドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 形式: `uri` @@ -195,13 +193,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 水平軸(x軸)に沿ったカメラの移動を制御します。負の値は左、正の値は右を示します。 + カメラの水平軸(x軸)方向の移動を制御します。負の値は左、正の値は右を示します。 範囲: `-10` から `10` - 垂直面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。 + 垂直平面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。 範囲: `-10` から `10` @@ -213,31 +211,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 水平面内でのカメラの回転(y軸)を制御します。負の値は左回転、正の値は右回転を示します。 + 水平平面内でのカメラの回転(y軸)を制御します。負の値は左への回転、正の値は右への回転を示します。 範囲: `-10` から `10` - 垂直軸(y軸)に沿ったカメラの移動を制御します。負の値は下、正の値は上を示します。 + カメラの垂直軸(y軸)方向の移動を制御します。負の値は下方向、正の値は上方向を示します。 範囲: `-10` から `10` - カメラの焦点距離の変化を制御します。負の値は画角が狭くなり、正の値は画角が広がることを示します。 + カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。 範囲: `-10` から `10` - 定義済みのカメラ動作タイプ。simple: カスタマイズ可能なカメラ動作。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上方向に傾きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 + 定義済みのカメラ移動タイプ。simple: カスタマイズ可能なカメラ移動。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上方向にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 指定可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - ビデオ生成における柔軟性。値が高いほどモデルの柔軟性が低くなり、ユーザーのプロンプトとの関連性が強くなります。 + ビデオ生成における柔軟性。値が高いほどモデルの柔軟性は低くなり、ユーザーのプロンプトとの関連性が強くなります。 範囲: `0` から `1` @@ -251,25 +249,25 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - カスタムタスクID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。 + カスタマイズされたタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間のビデオを生成しますが、出力品質は高くなります。 + ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間で高品質な出力のビデオを生成します。 指定可能な値: `std`, `pro` - モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。 + モデル名。Comfy Router を使用する場合は省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。 - 各ストーリーボードの情報(プロンプトや再生時間など)。最大 6 つのストーリーボードをサポートし、最小は 1 です。multi_shot が true かつ shot_type が `customize` の場合に必須です。 + 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大 6 個のストーリーボードをサポートし、最小 1 個です。multi_shot が true かつ shot_type が customize の場合に必須です。 - このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 + このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にはできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 @@ -277,7 +275,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - このストーリーボードのプロンプトワード。最大長 512 文字。 + このストーリーボードのプロンプト。最大長は 512 文字です。 @@ -285,31 +283,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文を加えて補足することを推奨します。 + ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接否定文を記述して補うことが推奨されます。 - ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには、\<\<\>> を使用します。1 つのタスクで参照できるトーンは最大 2 つです。トーンを指定する場合、sound パラメータの値は on である必要があります。 + ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには、\<\<\>> を使用します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 - ストーリーボード方法。multi_shot パラメータが true に設定されている場合に必須です。 + ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。 指定可能な値: `customize`, `intelligence` - ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のモデルのみです。 + ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータはモデルの V2.6 以降のバージョンのみがサポートします。 指定可能な値: `on`, `off` - 動画生成時に参照するボイスのリストです。最大 2 つのボイスに対応し、`prompt` 内でリスト順に \<\<\>> と \<\<\>> として参照します。`sound` を "on" にする必要があり、これに対応するのは V2.6 以降のモデルのみです。それより前のモデル、または `sound` が既定値の "off" のままの場合、ボイスは適用されません。 + ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順序に従って `prompt` 内で \<\<\>> と \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これはモデルの V2.6 以降のバージョンのみがサポートします。それ以前のモデルでは、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。 - ボイスカスタマイズ API が返すボイス ID、またはシステムのプリセットボイス ID。 + 音声カスタマイズ API を通じて返される音声 ID、またはシステムプリセットの音声 ID。 @@ -317,10 +315,18 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - true はウォーターマークを生成することを意味し、false は生成しないことを意味します。 + true は透かしを生成することを意味し、false は生成しないことを意味します。 + + + + 参照画像: URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 -Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に Router が使用するドキュメントと同じです。 + + 参照画像: 終了フレーム制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。 + + +`GET /v2/models/kling/kling-v3/openapi.json` で Router が提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 ### 出力 @@ -333,7 +339,7 @@ Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキー - タスク作成時間、Unix タイムスタンプ(ミリ秒) + タスクの作成時間。Unix タイムスタンプ(ミリ秒) @@ -365,33 +371,33 @@ Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキー - 生成済みビデオ ID + 生成されたビデオの ID - 生成済みビデオの URL + 生成されたビデオの URL - フォーマット: `uri` + 形式: `uri` - ウォーターマーク付き生成済みビデオの URL、直リンク防止フォーマット + ウォーターマーク付きの生成されたビデオの URL(ホットリンク防止形式) - フォーマット: `uri` + 形式: `uri` - タスクステータス + タスクのステータス - 取り得る値: `submitted`、`processing`、`succeed`、`failed` + 取りうる値: `submitted`、`processing`、`succeed`、`failed` - タスクステータス情報。タスク失敗時に失敗理由を表示します + タスクのステータス情報。タスクが失敗した場合は失敗理由を表示します - タスク更新時間、Unix タイムスタンプ(ミリ秒) + タスクの更新時間。Unix タイムスタンプ(ミリ秒) diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index 5d4fa8c101..c67089d71c 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で HappyHorse 1.0 I2V を使用する" description: "Comfy Router 経由で HTTP により wan/happyhorse-1.0-i2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "HappyHorse 1.0 I2V" -translationSourceHash: fd06ba6e +translationSourceHash: da380385 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx translationBlockHashes: "_intro": 7d98975f "Quick start": c7e0bda8 - "Schema": 8445191f + "Schema": 229263d1 "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -206,127 +207,124 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-i2v/requests/$REQUEST_ID ### 入力 - プロンプトワードなどの基本情報を入力します。 + プロンプト文などの基本情報を入力します。 - オーディオファイルのダウンロードURL。対応形式: mp3 および wav。reference_video_urls とは併用できません。 + 音声ファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls と併用できません。 - 先頭フレームの画像URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の指定では、先頭フレームをここで受け取りません。 -type が first_frame の media 要素として受け取ります(後述の media を参照)。また、wan2.6-i2v で成功する -img_url ボディは、happyhorse-1.0-i2v および happyhorse-1.1-i2v ではプロバイダーに拒否されます。 -さらに wan2.7/wan3.0 系の指定も、参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 + 最初のフレーム画像のURL、またはBase64エンコードされたデータ。wan2.5-i2v-preview および +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、最初のフレームをここでは +受け取りません。最初のフレームは type が first_frame のメディア要素として受け取ります +(下記の media を参照)。wan2.6-i2v で成功する img_url ボディは、happyhorse-1.0-i2v および +happyhorse-1.1-i2v ではプロバイダーに拒否されます。また wan2.7/wan3.0 の表記でも参照 +アセットは media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 解像度: 360〜2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を指定します。 -各要素は type と url フィールドを含みます。このフィールドは、このコンポーネントから提供される -すべてのモデルで共通です。あるモデルがどの type 値を受け付けるか、また画像またはビデオの入力を -img_url や reference_video_urls ではなくここで渡すかどうかは、モデルによって異なります。 + メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントから提供される +すべてのモデルで共通であり、あるモデルがどの type 値を受け付けるのか、また画像やビデオの入力を +img_url や reference_video_urls ではなくここで行うのかどうかは、モデルによって異なります。 モデルごとの対応 type 値: - wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺あたり 240〜8000 ピクセル、アスペクト比 1:8〜8:1、 - 最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2〜30 秒、最大 15MB)および first_clip(MP4/MOV、2〜10 秒、 - 1辺あたり 240〜4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの - data: URL は受け付けられません。 + 最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2〜30 秒、最大 15MB)と first_clip(MP4/MOV、2〜10 秒、 + 1辺あたり 240〜4096 ピクセル、最大 100MB): パブリックな HTTP/HTTPS URL。 + インラインの data: URL は受け付けられません。 - wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。少なくとも - 1 つの reference_image または reference_video が必要で、参照画像と参照ビデオの合計は - 最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、 - 1辺あたり 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、公開URLまたは - data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの - data: URL は受け付けられません。 + 1 つの reference_image または reference_video が必要で、reference_image と + reference_video の合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺あたり 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 + 20MB、パブリック URL または data:\{MIME_type};base64,... URL。reference_video: パブリックな + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 - wan2.7-videoedit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、2〜10 秒、 - 1辺あたり 240〜4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL + 1辺あたり 240〜4096 ピクセル、最大 100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0〜4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、公開URLまたは - data:\{MIME_type};base64,... URL)。 + 1辺あたり 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、パブリック URL + または data:\{MIME_type};base64,... URL)。 - wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 - reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、 - reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link とは - 併用できません)、link(最大 1、file とは併用できません)。reference_*/file/link の type と - first_frame/last_frame の type は、同じリクエスト内では同時に使用できません。配列の順序が、 - プロンプト内のアセットの参照順(Image 1、Video 1、Audio 1、...)を定義します。first_frame、 - last_frame および reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺あたり 240〜8000 ピクセル、 - アスペクト比は最大 8:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。 - reference_video、reference_audio、file および link: 公開 HTTP/HTTPS URL。インラインの - data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの指定は - 先頭フレームを img_url ではなくここで受け取ります。少なくとも 300x300 ピクセル、アスペクト比 - 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開URLまたは + reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、 + reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link と併用不可)、 + link(最大 1、file と併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは + 同じリクエスト内では排他的です。配列の順序がプロンプト内でのアセットの参照順序を定義します + (Image 1、Video 1、Audio 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1辺あたり 240〜8000 ピクセル、アスペクト比最大 8:1、最大 20MB、パブリック URL または + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: パブリックな + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの表記では + 最初のフレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、 + アスペクト比 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。 - happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9 個。これがこのモデルの - 唯一の参照入力です。最短辺は少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、 - 公開URLまたは data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプ - ではありません。 + 唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、 + パブリック URL または data:\{MIME_type};base64,... URL。reference_video はこの操作の + 入力タイプではありません。 - happyhorse-1.0-video-edit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、3〜60 秒、 - 長辺は最大 4096 ピクセル、短辺は少なくとも 360 ピクセル、アスペクト比 1:2.5〜2.5:1、 - 最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、 - 任意で 0〜5 個の reference_image(JPEG/JPG/PNG/WEBP、少なくとも 300x300 ピクセル、 - アスペクト比 1:2.5〜2.5:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL)。 + 長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5〜2.5:1、 + 最大 100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に + 加えて、任意で 0〜5 個の reference_image(JPEG/JPG/PNG/WEBP、少なくとも 300x300 ピクセル、 + アスペクト比 1:2.5〜2.5:1、最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。これらの対応するパートナーのリファレンスには media 入力の記載が - ないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントは、これらの指定向けの - media ボキャブラリを列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを + テキストから動画への操作。これらの表記に対応するパートナーのリファレンスにはメディア入力が + 記載されていないため、このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対して + media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初のフレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの個数はパートナーの制約であり、このスキーマのものではありません。media には +上記のモデルごとの個数はこのスキーマの制約ではなく、パートナーの制約です。media には minItems/maxItems が宣言されていません。許容される type とその上限はモデルごとに異なるためです。 -スキーマが受け入れることはプロバイダーが受け入れることを意味しません。逆に、上記のアセット単位の -「最大 20MB」という数値(画像入力の上限であり、インラインで送信できる唯一の入力)は、パートナーが -最終的に受け取るアセットに対する上限であり、アセットが公開URLである場合にはそのまま適用されます。 -そのバイト列が Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... -URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の POST ボディは合計 -100 MiB に制限され、それを超えると 413 で応答されます。また base64 はペイロードを約 4/3 に -膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに記述されたパートナーの -ルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限であればインラインで余裕をもって収まります。そのため、1 つのアセットについてはパートナーのルールが制約となります。複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 +スキーマが受け付けることはプロバイダーが受け付けることを意味しません。逆方向についても、 +上記のアセットごとの「最大 20MB」という数値は、インラインで送信できる唯一の入力である画像入力の +上限であり、パートナーが最終的に受け取るアセットに対する上限です。アセットがパブリック URL の +場合はそのまま適用されます。そのバイト列は Comfy を経由しないためです。インラインの +data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の上限にも直面します。 +Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。また base64 は +ペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに +挙げたパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限はインラインでも余裕を持って収まるため、アセット 1 つの場合はパートナーのルールが制約となります。複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 メディアアセットの種類 - 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明が各モデルについて列挙しているまさにその画像入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、そして happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力がインラインの data: URL を受け付けることはありません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されることなくパートナーへそのまま転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: パブリックな HTTP/HTTPS URL、または(上記の `media` の説明で各モデルについて列挙されている IMAGE 入力、すなわち wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image に限ります)インラインの `data:{MIME_type};base64,...` URL。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開しないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します + 逆プロンプトの言葉は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これは prompt と同じ入力予算にカウントされます。 - テキストプロンプト。中国語と英語をサポートし、長さは 800 文字以内です -(wan3.0-video では最大 20,000 文字。制限を超えたコンテンツは切り捨てられます)。 -複数の参照ビデオを使用する wan2.6-r2v では、参照ビデオの順序に従って被写体を -'character1'、'character2' などで参照します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを -'Image 1'、'Video 1'、'Audio 1' などで参照します。 + テキストプロンプトの言葉。中国語と英語をサポートします。文書化された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。プロバイダーは、prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 の中国語文字)を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に従って被写体を指すために 'character1'、'character2' などを使用します。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを指すために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 本のビデオ URL の配列です。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列。 入力の制限: - 形式: mp4、mov -- 本数: 1~3 本 -- 単一ビデオの長さ: 2~30 秒 +- 数量: 1〜3 本のビデオ +- 単一ビデオの長さ: 2〜30 秒 - 単一ファイルサイズ: 最大 30MB - audio_url と併用できません -参照再生時間: 単一ビデオで最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合は比例して短くなります。 -課金: 実際に使用された参照再生時間に基づきます。 +参照の再生時間: 単一ビデオは最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合は比例して短くなります。 +課金: 使用した実際の参照再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされているもの: squish、flying、carousel。使用すると、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているもの: squish、flying、carousel。使用すると、prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しではこれを必ず指定しなければならず、受け付けられる綴りの enum は、そのオペレーション自身のコンポーネントである `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -334,30 +332,30 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについて、そのような切り替えを文書化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。プロバイダーは他の wan モデルについてそのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプト内容に基づいてインテリジェントに判断します +- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 指定可能な値: `auto`, `origin` + 指定可能な値: `auto`、`origin` 生成されるビデオの再生時間(秒): - wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 +- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 - wan2.6-r2v: 5 秒または 10 秒のみ(15 秒はサポートされません) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は、 - 入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 は - スマート再生時間モードを有効にし、モデルが適切な再生時間を選択します -このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合、 + 入力ビデオの再生時間と出力ビデオの再生時間の合計は 30 秒を超えてはなりません。-1 を指定すると + スマート再生時間モードが有効になり、モデルが適切な再生時間を選択します +このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 - 範囲: `-1`~`30` + 範囲: `-1` から `30` @@ -365,55 +363,57 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 + 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用。 wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 +wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 - 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルトは 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上流のデフォルトは 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -このプロキシは、解像度もサイズも指定していないビデオ生成リクエストを拒否します。これは、課金レートを選択するのが解像度のティアだからです。チェックの前に解像度を大文字化し、その大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P がないと記載されている wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P に対して(解像度として送信された場合でも 480P のサイズとして送信された場合でも)400 を返します。 - - 可能な値: `480P`, `720P`, `1080P` +- wan2.6 モデル (t2v、i2v、r2v): 720P、1080P のみ (480P 非サポート) +- wan2.7 モデル (i2v、t2v、r2v、videoedit): 720P、1080P (デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P (上流のデフォルト 1080P) +- happyhorse-1.0-* (t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-* (t2v、i2v、r2v): 480P、720P、1080P +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。resolution のティアが課金レートを決めるためです。チェックの前に resolution を大文字化して転送し、この列挙にない値には 400 を返します。また、上記で 480P 非対応と記載されている wan2.6、wan2.7、happyhorse-1.0 の各モデルでは、480P (resolution として送信された場合も、480P の size として送信された場合も) に対して 400 を返します。 + + 指定可能な値: `480P`、`720P`、`1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 - 範囲: `0` から `2147483647` まで + 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。wan2.6 および wan2.7-r2v モデル向けです。 -- single: 単一ショットのビデオ(デフォルト) + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 +wan2.6 および wan2.7-r2v モデル向け。 +- single: 単一ショットのビデオ (デフォルト) - multi: マルチショットのビデオ - 可能な値: `multi`, `single` + 指定可能な値: `multi`、`single` - width*height 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P (480*832, 832*480, 624*624), 720P, 1080P の各サイズ -wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -サイズと解像度の両方を送信した場合、課金対象のティアを選択するのはサイズであり、解像度はそのモデルに対してこのプロキシが受け入れる値である必要があります。480P のサイズは、解像度の説明で 480P がないものとして挙げられているすべてのモデルで 400 を返します。 + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P (480*832、832*480、624*624)、720P、1080P の各サイズ +wan2.6 T2V/R2V の場合 (480P なし): + 720P: 1280*720、720*1280、960*960、1088*832、832*1088 + 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +size と resolution の両方を送信した場合、課金ティアを選択するのは size で、 +resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、 +解像度の説明で 480P 非対応と記載されているすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -`GET /v2/models/wan/happyhorse-1.0-i2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同一のドキュメントです。 +`GET /v2/models/wan/happyhorse-1.0-i2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同じドキュメントです。 ### 出力 @@ -426,7 +426,7 @@ wan2.6 T2V/R2V の場合(480P なし): - オーディオ生成を伴う I2V タスク用のオーディオ URL + オーディオ生成を伴うI2Vタスク用のオーディオURL @@ -434,15 +434,15 @@ wan2.6 T2V/R2V の場合(480P なし): - タスクの完了時間 + タスク完了時間 - 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) - オリジナルの入力プロンプト(ビデオタスク用) + 元の入力プロンプト(ビデオタスク用) @@ -454,57 +454,57 @@ wan2.6 T2V/R2V の場合(480P なし): - 画像のエラーコード(一部のタスクが失敗した場合に返されます) + 画像エラーコード(一部のタスクが失敗した場合に返されます) - 画像のエラー情報(一部のタスクが失敗した場合に返されます) + 画像エラー情報(一部のタスクが失敗した場合に返されます) - オリジナルの入力プロンプト + 元の入力プロンプト - 生成された画像の URL アドレス + 生成された画像のURLアドレス - タスクの実行時間 + タスク実行時間 - タスクの送信時間 + タスク送信時間 - タスク ID + タスクID - 画像生成タスクのタスク結果の統計 + 画像生成タスクのタスク結果統計 - 失敗したタスクの数 + 失敗したタスク数 - 成功したタスクの数 + 成功したタスク数 - タスクの総数 + タスクの合計数 - タスクのステータス + タスクステータス - 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 完了したビデオ生成タスクのビデオ URL。リンクの有効期間は24時間です + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 @@ -516,55 +516,55 @@ wan2.6 T2V/R2V の場合(480P なし): - ビデオ解像度レベル(I2V および wan3.0-video タスク) + ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) - 生成されたビデオの再生時間(秒)(I2V および wan3.0-video タスク) + 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-video タスク) + 生成されたビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2I および I2I タスク) + 生成された画像数(T2IおよびI2Iタスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間(秒)(wan3.0-video タスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) - 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-video タスク) + 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) - 画像の解像度(T2I および I2I タスク) + 画像解像度(T2IおよびI2Iタスク) - 生成されたビデオの数(T2V タスク) + 生成されたビデオ数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2V タスク) + 生成されたビデオの再生時間(秒)(T2Vタスク) - ビデオ解像度の比率(T2V タスク) + ビデオ解像度比率(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなくエンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストに関する詳細情報。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなくエンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index 0c3be8cbfe..83bc8937c3 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で HappyHorse 1.0 R2V を使用する" description: "Comfy Router 経由で HTTP から wan/happyhorse-1.0-r2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "HappyHorse 1.0 R2V" -translationSourceHash: d2eee702 +translationSourceHash: 93ba1a2d translationFrom: development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx translationBlockHashes: "_intro": 39853fc0 "Quick start": eafea158 - "Schema": 5a777640 + "Schema": 3deb0e2f "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -209,81 +210,82 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v/requests/$REQUEST_ID - オーディオファイルのダウンロードURL。対応形式: mp3 と wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls とは併用できません。 - 先頭フレームの画像URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、先頭フレームをここでは受け取りません。 -代わりに type が first_frame のメディア要素として受け取ります(下記 media を参照)。 -wan2.6-i2v で成功する img_url ボディは、happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーに -拒否されます。また wan2.7/wan3.0 の表記も参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレームの画像URL、またはBase64エンコードされたデータ。wan2.5-i2v-preview と +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の表記では先頭フレームをここで受け取りません +-- 先頭フレームは type が first_frame のメディア要素として受け取ります(下記の media を参照)。そして +wan2.6-i2v で成功する img_url ボディは、happyhorse-1.0-i2v と happyhorse-1.1-i2v では +プロバイダーに拒否されます -- また wan2.7/wan3.0 系の表記も参照アセットを +media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360〜2000ピクセル。ファイルサイズ: 最大10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を指定します。 -各要素は type フィールドと url フィールドを含みます。このフィールドは、このコンポーネントから -提供されるすべてのモデルで共通ですが、あるモデルがどの type 値を受け入れるか、また img_url や -reference_video_urls ではなくここに画像またはビデオ入力を渡すかどうかは、モデルによって異なります。 -モデルごとの対応 type 値: + メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントから提供される +すべてのモデルで共通であり、あるモデルがどの type 値を受け付けるか -- そして画像やビデオの入力を +img_url や reference_video_urls ではなくここで持つかどうか -- はモデルごとに異なります。 +モデル別の対応 type 値: - wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺あたり 240-8000 ピクセル、アスペクト比 1:8~8:1、 - 最大 20MB、公開URL または data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2~30 秒、最大 15MB)と first_clip(MP4/MOV、2~10 秒、 - 1辺あたり 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの + last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺240〜8000ピクセル、アスペクト比 1:8 + 〜8:1、最大20MB、公開URL または data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2〜30秒、最大15MB)と first_clip(MP4/MOV、2〜10 + 秒、1辺240〜4096ピクセル、最大100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 - wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。少なくとも - 1つの reference_image または reference_video が必要で、reference_image と - reference_video を合わせて最大5つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、1辺あたり 240-8000 ピクセル、アスペクト比 1:8~8:1、最大 + 1つの reference_image または reference_video が必要で、reference 画像と + reference ビデオの合計は最大5つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺240〜8000ピクセル、アスペクト比 1:8〜8:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、2~10 秒、 - 1辺あたり 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL - は受け付けられません)に加えて、任意で 0~4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり 240-8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開URL +- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、2〜10秒、 + 1辺240〜4096ピクセル、最大100MB、公開 HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で0〜4つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺240〜8000ピクセル、アスペクト比 1:8〜8:1、最大20MB、公開URL または data:\{MIME_type};base64,... URL)。 - wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 - reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15s)、 - reference_audio(最大5クリップ、合計再生時間 \<= 15s)、file(最大1、link と併用不可)、 - link(最大1、file と併用不可)。reference_*/file/link タイプと first_frame/last_frame - タイプは、同じリクエスト内で相互に排他的です。配列の順序が、プロンプト内のアセットの - 参照順序(Image 1、Video 1、Audio 1、...)を定義します。first_frame、last_frame、 - reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺あたり 240-8000 ピクセル、アスペクト比 - 最大 8:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video、 - reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は - 受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記は - 先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、 - アスペクト比 1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開URL または + reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15秒)、 + reference_audio(最大5クリップ、合計再生時間 \<= 15秒)、file(最大1、link とは併用 + 不可)、link(最大1、file とは併用不可)。reference_*/file/link の type と + first_frame/last_frame の type は、同一リクエスト内で同時に使用できません。 + 配列の順序がプロンプト内でのアセットの参照順序を定義します(Image 1、Video 1、 + Audio 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1辺240〜8000ピクセル、アスペクト比 最大8:1、最大20MB、公開URL または + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記では + 先頭フレームをここで受け取り、img_url では受け取りません。最小300x300ピクセル、アスペクト比 + 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、公開URL または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9 個。これが - このモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 - 最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video は - この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、3~60 - 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 - 1:2.5~2.5:1、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: - URL は受け付けられません)に加えて、任意で 0~5 個の reference_image(JPEG/JPG/PNG/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比 1:2.5~2.5:1、最大 20MB、公開URL +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9つ。これは + このモデル唯一の参照入力です。最短辺 最小400ピクセル、JPEG/JPG/PNG/WEBP、 + 最大20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video は + この操作の入力 type ではありません。 +- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、3〜60 + 秒、長辺 最大4096ピクセル、短辺 最小360ピクセル、アスペクト比 + 1:2.5〜2.5:1、最大100MB、公開 HTTP/HTTPS URL。インラインの data: + URL は受け付けられません)に加えて、任意で0〜5つの reference_image(JPEG/JPG/PNG/WEBP、 + 最小300x300ピクセル、アスペクト比 1:2.5〜2.5:1、最大20MB、公開URL または data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。対応するパートナーのリファレンスにはメディア入力の記載がないため、 - このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントは、これらの表記に対して + テキストから動画への操作。これらの対応リファレンスにはメディア入力の記載がないため、このフィールドは + 未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対して media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの個数はパートナー側の制約であり、このスキーマのものではありません。media には -minItems/maxItems が宣言されていません。許容されるタイプとその上限がモデルごとに異なるためです。 -スキーマが受け入れることはプロバイダーが受け入れることを意味しません。逆に、上記のアセット -ごとの「最大 20MB」という数値は、画像入力の上限であり(これらはインラインで送信できる唯一の -入力です)、最終的に受け取るアセットに対するパートナー側の上限であり、アセットが公開URL の場合は -そのまま適用されます。そのバイト列は Comfy を経由しないためです。インラインの -data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上限にも直面します。Comfy Router -の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。また base64 はペイロードを -約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに記載された -パートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の20MB の上限はインラインに余裕で収まるため、1つのアセットについてはパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 +上記のモデル別の個数はパートナーの制約であり、このスキーマの制約ではありません。media には +minItems/maxItems が宣言されていません。受け付け可能な type とその上限はモデルごとに +異なるためです。スキーマが受け付けることはプロバイダーが受け付けることを意味しません -- そして +逆方向として、上記のアセット単位の「最大20MB」という数値 -- 画像入力(インラインで送信できる +唯一の入力)の上限 -- は、最終的にパートナーが持つアセットに対するパートナーの上限であり、 +アセットが公開URLの場合はそのまま適用されます。これらのバイト列は Comfy を経由しないためです。 +インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも +直面します。Comfy Router の POST ボディは合計100 MiB に制限され、超えると 413 が返り、 +base64 はペイロードを約4/3に膨らませるため、およそ75 MB を超える単一のインラインアセットは +ここに記されたパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限はインラインに余裕で収まるため、1つのアセットではパートナーのルールが制約となります。複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 @@ -293,51 +295,50 @@ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上限 - メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明が各モデルについて挙げているまさに画像の入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、そして happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL。 - これらのモデルのいずれでも、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデル呼び出しを行い、アップロード経路を公開しないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: パブリックな HTTP/HTTPS URL、または(上記の `media` の説明でモデルごとに列挙されている画像入力に限り)インラインの `data:{MIME_type};base64,...` URL です。対象となる画像入力は、wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、そして happyhorse-1.0-video-edit の reference_image です。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit の場合)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディの上限については、`media` の説明を参照してください。 - ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します + 逆プロンプトは、ビデオ画面に映したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルはそれを拒否せずに切り捨てます。prompt と同じ入力予算にカウントされます。 - テキストプロンプト。中国語と英語に対応し、長さは800文字以内(wan3.0-video では最大20,000文字。制限を超えたコンテンツは切り捨てられます)。 - wan2.6-r2v で複数の参照ビデオを使用する場合は、参照ビデオの順序に従って被写体を 'character1'、'character2' などで参照します。例: "Character1 sings on the roadside, Character2 dances beside it" - wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを参照するために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 + テキストプロンプトです。中国語と英語をサポートします。ドキュメントに記載された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます: wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 文字の中国語)を超えるリクエストは、プロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 + 複数の参照ビデオを指定する wan2.6-r2v では、参照ビデオの順序に対応させて 'character1'、'character2' などで被写体を参照します。例: "Character1 sings on the roadside, Character2 dances beside it" + wan3.0-video の参照モードでは、media 配列内の対応する順序で 'Image 1'、'Video 1'、'Audio 1' などを使ってメディアアセットを参照します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3本のビデオ URL の配列。 + wan2.6-r2v モデル専用の参照ビデオ URL。1-3 本のビデオ URL の配列です。 入力の制限: -- フォーマット: mp4、mov -- 本数: 1~3本のビデオ -- 単一ビデオの長さ: 2~30秒 -- 単一ファイルサイズ: 最大30MB +- 形式: mp4、mov +- 数量: 1-3 本 +- 単一ビデオの長さ: 2-30 秒 +- 単一ファイルのファイルサイズ: 最大 30MB - audio_url と併用できません -参照の再生時間: 単一ビデオは最大5秒、2本の場合は各最大2.5秒、3本の場合はそれに比例して短くなります。 +参照の再生時間: 単一ビデオは最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合は比例して短くなります。 課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用すると、prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はその操作自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付ける表記の enum はそのオペレーション自身のコンポーネントである `WanVideoGenerationRequest` にあります。 - ビデオ処理パラメータ + ビデオ処理のパラメータ - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルについては、プロバイダーはそのような切り替えをドキュメント化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。他の wan モデルについては、プロバイダーはそのような切り替えをドキュメント化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します +- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: `auto`、`origin` @@ -345,15 +346,15 @@ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上限 生成されるビデオの再生時間(秒): -- wan2.5 モデル: 5秒または10秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または15秒 -- wan2.6-r2v: 5秒または10秒のみ(15秒はサポートされません) +- wan2.5 モデル: 5 秒または 10 秒 +- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が30秒を超えてはなりません。-1 はモデルが適切な再生時間を選ぶスマート再生時間モードを有効にします -このプロキシは [-1, 30] の範囲外の再生時間に対して400を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、モデルが適切な再生時間を選択するスマート再生時間モードが有効になります +このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 - 範囲: `-1` ~ `30` + 範囲: `-1` から `30` @@ -362,8 +363,8 @@ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上限 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 +wan2.7 モデルでは、指定しない場合は解像度のティアに基づいてデフォルトが決まります。 +wan3.0-video では、adaptive(デフォルト)が適切なものを自動的に推奨しますアスペクト比は入力メディアの比率と意図に基づいて決まります。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -371,47 +372,45 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) +- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P 非対応) - wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルト 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、解像度も size も指定されていないビデオ生成リクエストを拒否します。解像度のティアが課金レートを選択するためです。このプロキシは、解像度をチェックする前に大文字に変換し、その大文字に変換した値をそのまま転送します。この enum に含まれない値には 400 を返し、上記で 480P を持たないものとして記載されている wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P(解像度として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 +このプロキシは、resolution と size のどちらも指定されていないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決めるためです。チェックの前に resolution を大文字化して、その大文字化した値を転送します。この列挙にない値には 400 を返し、上記の 480P 非対応として挙げた wan2.6、wan2.7、happyhorse-1.0 モデルでは 480P に対して(resolution として送られた場合も、480P の size として送られた場合も)400 を返します。 - 指定可能な値: `480P`, `720P`, `1080P` + 指定可能な値: `480P`、`720P`、`1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 - 範囲: `0` ~ `2147483647` + 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合のみ機能します。 -wan2.6 および wan2.7-r2v モデル用です。 + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 +wan2.6 および wan2.7-r2v モデル用。 - single: シングルショットビデオ(デフォルト) - multi: マルチショットビデオ - 指定可能な値: `multi`, `single` + 指定可能な値: `multi`、`single` - width*height 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size と resolution の両方を送信した場合、課金ティアを選択するのは size であり、 -resolution はモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、 -resolution の説明で 480P を持たないと記載されているすべてのモデルで 400 を返します。 + 720P: 1280*720、720*1280、960*960、1088*832、832*1088 + 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +size と resolution の両方を送信した場合、課金階層を選ぶのは size であり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、解像度の説明で 480P 非対応として挙げたすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + 透かしロゴを追加するかどうか。透かしは右下隅に配置されます。 -`GET /v2/models/wan/happyhorse-1.0-r2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 +`GET /v2/models/wan/happyhorse-1.0-r2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 @@ -424,7 +423,7 @@ resolution の説明で 480P を持たないと記載されているすべての - オーディオ生成を伴う I2V タスク用のオーディオ URL + 音声生成を伴うI2Vタスク用のオーディオURL @@ -432,15 +431,15 @@ resolution の説明で 480P を持たないと記載されているすべての - タスクの完了時間 + タスク完了時間 - 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) - オリジナルの入力プロンプト(ビデオタスク用) + 元の入力プロンプト(ビデオタスク用) @@ -452,43 +451,43 @@ resolution の説明で 480P を持たないと記載されているすべての - 画像のエラーコード(一部のタスクが失敗した場合に返されます) + 画像エラーコード(一部のタスクが失敗した場合に返されます) - 画像のエラー情報(一部のタスクが失敗した場合に返されます) + 画像エラー情報(一部のタスクが失敗した場合に返されます) - オリジナルの入力プロンプト + 元の入力プロンプト - 生成済み画像の URL アドレス + 生成された画像URLアドレス - タスクの実行時間 + タスク実行時間 - タスクの送信時間 + タスク送信時間 - タスク ID + タスクID - 画像生成タスクのタスク結果の統計 + 画像生成タスクのタスク結果統計 - 失敗したタスク数 + 失敗したタスクの数 - 成功したタスク数 + 成功したタスクの数 @@ -498,11 +497,11 @@ resolution の説明で 480P を持たないと記載されているすべての タスクステータス - 取り得る値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` - 完了したビデオ生成タスクのビデオ URL。リンクの有効期間は 24 時間 + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 @@ -514,47 +513,47 @@ resolution の説明で 480P を持たないと記載されているすべての - ビデオ解像度レベル(I2V および wan3.0-video タスク) + ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) - 生成されたビデオの再生時間(秒)(I2V および wan3.0-video タスク) + 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-video タスク) + 生成されたビデオのフレームレート(wan3.0-videoタスク) - 生成された画像数(T2I および I2I タスク) + 生成された画像の数(T2IおよびI2Iタスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間(秒)(wan3.0-video タスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) - 生成されたビデオのアスペクト比。例: 16:9(wan3.0-video タスク) + 生成されたビデオのアスペクト比、例: 16:9(wan3.0-videoタスク) - 画像の解像度(T2I および I2I タスク) + 画像解像度(T2IおよびI2Iタスク) - 生成されたビデオ数(T2V タスク) + 生成されたビデオの数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2V タスク) + 生成されたビデオの再生時間(秒)(T2Vタスク) - ビデオの解像度比率(T2V タスク) + ビデオ解像度比率(T2Vタスク) @@ -562,7 +561,7 @@ resolution の説明で 480P を持たないと記載されているすべての - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを確認してください。 + 失敗したリクエストに関する詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを読んでください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index 9c3c796a4f..e3f0f20da6 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -2,12 +2,12 @@ title: "HappyHorse 1.1 I2V を Comfy Router で使用する" description: "Comfy Router 経由で HTTP により wan/happyhorse-1.1-i2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "HappyHorse 1.1 I2V" -translationSourceHash: ee562b54 +translationSourceHash: 8d29660e translationFrom: development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx translationBlockHashes: "_intro": 2419a89f "Quick start": c705001d - "Schema": 54511f6f + "Schema": bb6bb958 "Examples": 5ffd46d7 --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* 生成済みファイル。このディレクトリの code.yaml を編集し、`pnpm code-pages:gen` を実行してください。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -207,29 +208,90 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v/requests/$REQUEST_ID ### 入力 - プロンプトなどの基本的な情報を入力します。 + プロンプトなどの基本情報を入力します。 - オーディオファイルのダウンロードURL。対応形式は mp3 と wav です。reference_video_urls とは併用できません。 + 音声ファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls とは併用できません。 - 先頭フレームの画像URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の表記では、先頭フレームをここでは受け取りません。これらの表記は先頭フレームを type が first_frame の media 要素として受け取ります(下記の media を参照)。また、wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーに拒否されます。そして wan2.7/wan3.0 の表記でも、参照アセットは同様に media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレーム画像のURL、またはBase64エンコードされたデータ。wan2.5-i2v-preview および +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記は先頭フレームをここでは +受け取りません。先頭フレームは type が first_frame の media 要素として渡します +(後述の media を参照)。また、wan2.6-i2v では成功する img_url のボディも、 +happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーに拒否されます。 +wan2.7/wan3.0 の表記も参照アセットを media で受け取ります。 +画像形式: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360~2000ピクセル。ファイルサイズ: 最大10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素には type フィールドと url フィールドが含まれます。このフィールドはこのコンポーネントから提供されるすべてのモデルで共通ですが、どの type 値を特定のモデルが受け付けるか、また画像やビデオの入力を img_url や reference_video_urls ではなくここで受け取るかどうかは、モデルによって異なります。モデルごとの対応する type 値は次のとおりです: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240-8000 ピクセル、アスペクト比は 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 秒、1辺 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。reference_image または reference_video が少なくとも 1 つ必要で、reference_image と reference_video を合わせて最大 5 つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、1辺 240-8000 ピクセル、アスペクト比は 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(正確に 1 つ、編集対象のクリップ: MP4/MOV、2-10 秒、1辺 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)と、任意で 0 から 4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、1辺 240-8000 ピクセル、アスペクト比は 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link とは併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link の type と first_frame/last_frame の type は、同じリクエスト内では同時に使用できません。配列の順序が、プロンプト内のアセットの参照順序(Image 1、Video 1、Audio 1、...)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺 240-8000 ピクセル、アスペクト比は最大 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、正確に 1 つ。これらの表記では先頭フレームを「ここで」受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、アスペクト比は 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 つ。これがこのモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(正確に 1 つ、編集対象のクリップ: MP4/MOV、3-60 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比は 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)と、任意で 0 から 5 つの reference_image(JPEG/JPG/PNG/WEBP、少なくとも 300x300 ピクセル、アスペクト比は 1:2.5 から 2.5:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作。これらのパートナーリファレンスには media 入力の記載がないため、このフィールドは未設定のままにします。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントは、これらの表記に対する media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの数は、このスキーマの制約ではなくパートナーの制約です: media には minItems/maxItems が宣言されていません。これは、許容される type とその上限がモデルごとに異なるためです。スキーマが受け入れることは、プロバイダーが受け入れることを意味しません。逆に、上記のアセットごとの「最大 20MB」という数値(画像入力の上限であり、インラインで送信できる唯一の入力)は、最終的に受け取るアセットに対するパートナーの上限であり、アセットが公開 URL の場合には記載どおりに適用されます。そのバイト列は Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、トランスポートの上限にも直面します: Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。また base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに示したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の20MB の上限ならインラインで問題なく収まります。そのため、アセットが 1 つの場合はパートナーのルールが制約となります。複数のアセットにまたがる場合は転送の上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 + メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を +指定します。各要素は type と url フィールドを持ちます。このフィールドはこの +コンポーネントから提供されるすべてのモデルで共通ですが、どの type 値を +受け付けるか、また画像やビデオの入力を img_url や reference_video_urls では +なくここで受け取るかどうかは、モデルごとに異なります。モデル別の対応 type 値: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と + last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺240~8000ピクセル、アスペクト比1:8~ + 8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2~30秒、最大15MB)と first_clip(MP4/MOV、2~10秒、 + 1辺240~4096ピクセル、最大100MB): 公開HTTP/HTTPS URL。インラインの + data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。 + reference_image または reference_video が少なくとも1つ必要で、reference 画像と + reference ビデオの合計は最大5です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺240~8000ピクセル、アスペクト比1:8~8:1、最大 + 20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video: 公開 + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、2~10秒、 + 1辺240~4096ピクセル、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で0~4個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺240~8000ピクセル、アスペクト比1:8~8:1、最大20MB、公開URL + または data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 + reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15秒)、 + reference_audio(最大5クリップ、合計再生時間 \<= 15秒)、file(最大1、link とは + 併用不可)、link(最大1、file とは併用不可)。reference_*/file/link タイプと + first_frame/last_frame タイプは同一リクエスト内で相互排他です。配列の順序が + プロンプト内でのアセットの参照順(Image 1、Video 1、Audio 1、...)を定義します。 + first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1辺240~8000ピクセル、アスペクト比最大8:1、最大20MB、公開URLまたは + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: + 公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの + 表記は先頭フレームを img_url ではなくここで受け取ります。少なくとも300x300ピクセル、 + アスペクト比1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、公開URLまたは + data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9個。これは + モデル唯一の参照入力です。最短辺が少なくとも400ピクセル、JPEG/JPG/PNG/WEBP、 + 最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video は + この操作の入力タイプではありません。 +- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、3~60 + 秒、長辺が最大4096ピクセル、短辺が少なくとも360ピクセル、アスペクト比 + 1:2.5~2.5:1、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL は + 受け付けられません)に加えて、任意で0~5個の reference_image(JPEG/JPG/PNG/WEBP、 + 少なくとも300x300ピクセル、アスペクト比1:2.5~2.5:1、最大20MB、公開URL + または data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: + テキストから動画への操作。これらのパートナー向け参照ドキュメントにはメディア入力の + 記載がないため、このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に + ついてメディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭 + フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で + 受け取ります。 +上記のモデル別の個数はこのスキーマの制約ではなくパートナーの制約です。media には +minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに +異なるためです。スキーマが受け付けることはプロバイダーが受け付けることを意味しません。 +逆に、上記のアセットごとの「最大20MB」という数値(画像入力の上限であり、インラインで +送信できる唯一の入力です)は、パートナーが最終的に受け取るアセットに対する +パートナーの上限であり、アセットが公開URLの場合はそのまま適用されます。そのバイト列が +Comfy を通ることはないためです。インラインの data:\{MIME_type};base64,... URL は +Comfy を通るため、転送上の上限にも直面します。Comfy Router の POST ボディは合計 +100 MiB に制限され、超えると 413 で返されます。また base64 はペイロードを約4/3に +膨らませるため、およそ75 MB を超える単一のインラインアセットは、ここに挙げた +パートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットが +パートナー自身の20MB の上限であればインラインでも余裕を持って収まるため、1 つのアセットについてはパートナーのルールが拘束条件になります。一方、複数のアセットをまとめる場合は転送量の上限が拘束します。これは 100 MiB の Router の上限が個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 @@ -239,29 +301,29 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v/requests/$REQUEST_ID - メディアファイルの URL。パブリックな HTTP/HTTPS URL、または(上記の `media` の説明がモデルごとに列挙しているまさに IMAGE 入力、すなわち wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame と reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image に限ります)インラインの `data:{MIME_type};base64,...` URL。これらのモデルのいずれにおいても、video、audio、file、link の入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明でモデルごとに列挙されている IMAGE 入力に限り、インラインの `data:{MIME_type};base64,...` URL を指定できます。対象となる IMAGE 入力は次のとおりです: wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、そして happyhorse-1.0-video-edit の reference_image です。これらのモデルのビデオ、オーディオ、ファイル、リンクのいずれの入力も、インラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または (wan2.7-videoedit では) Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出すためアップロード経路を公開しておらず、呼び出し元自身の oss:// URL や asset_id はサポート対象の入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - 逆プロンプトの単語は、ビデオ画面に表示したくないコンテンツを記述するために使用します + リバースプロンプトの単語は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルはそれを拒否せずに切り捨てます。これは prompt と同じ入力予算にカウントされます。 - テキストプロンプトの単語。中国語と英語をサポートし、長さは 800 文字以内(wan3.0-video では最大 20,000 文字。制限を超えたコンテンツは切り捨てられます)。 -複数の参照ビデオを使用する wan2.6-r2v では、'character1'、'character2' などを使用して、参照ビデオの順序で被写体を参照します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' などを使用して、media 配列内の対応する順序でメディアアセットを参照します。 + テキストプロンプトの単語。中国語と英語をサポートします。文書化された独自の長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます: wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字まで受け付けます。プロバイダーは、prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト (約 20,000 文字の中国語) を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +wan2.6-r2v で複数の参照ビデオを使用する場合は、参照ビデオの順序に合わせて 'character1'、'character2' などで被写体を参照してください。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の参照モードでは、media 配列内の対応する順序に合わせて 'Image 1'、'Video 1'、'Audio 1' などでメディアアセットを参照してください。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 個のビデオ URL の配列。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列です。 入力の制限: -- フォーマット: mp4、mov -- 数量: 1~3 本のビデオ -- 単一ビデオの長さ: 2~30 秒 -- 単一ファイルサイズ: 最大 30MB +- 形式: mp4、mov +- 本数: 1〜3 本 +- 1 本あたりの長さ: 2〜30 秒 +- 1 ファイルあたりのサイズ: 最大 30MB - audio_url と併用できません -参照の再生時間: 単一ビデオは最大 5 秒、2 本のビデオはそれぞれ最大 2.5 秒、3 本のビデオは比例してより短くなります。 -課金: 実際に使用された参照の再生時間に基づきます。 +参照の再生時間: ビデオ 1 本なら最大 5 秒、2 本ならそれぞれ最大 2.5 秒、3 本なら比例してさらに短くなります。 +課金: 実際に使用した参照の再生時間に基づきます。 @@ -269,7 +331,7 @@ wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' など - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` を直接 v1 で呼び出す場合は必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -277,54 +339,55 @@ wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' など - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。プロバイダーは他の wan モデルにはそのような切り替えをドキュメント化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてそのような切り替えを文書化していません。 - wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します + wan2.7-videoedit モデル用のビデオオーディオ設定。 +- auto (デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: `auto`、`origin` - 生成されるビデオの再生時間(秒): + 生成されるビデオの再生時間 (秒): - wan2.5 モデル: 5 または 10 秒 - wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 -- wan2.6-r2v: 5 または 10 秒のみ(15 秒はサポートなし) +- wan2.6-r2v: 5 または 10 秒のみ (15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は入力ビデオの再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 はモデルが適切な再生時間を選ぶスマート再生時間モードを有効にします -このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数、ビデオ入力ありの場合は入力ビデオの + 再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると + スマート再生時間モードが有効になり、モデルが適切な再生時間を選択します +このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 - 範囲: `-1` ~ `30` + 範囲: `-1` から `30` - プロンプトのインテリジェントなリライトを有効にするかどうか。デフォルトは true + プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 +wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 +wan3.0-video では、adaptive (デフォルト) が適切なアスペクト比は、入力メディアの比率と意図に基づいて決まります。 - 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` 解像度レベル。サポートされる値はモデルによって異なります: -- wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートなし) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video, wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P -- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P - -このプロキシは、resolution も size も指定していないビデオ生成リクエストを拒否します。解像度のティアが課金レートを選択するためです。チェックの前に resolution を大文字化して、その大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P 非対応として挙げられている wan2.6、wan2.7、happyhorse-1.0 モデルでは 480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 - - 指定可能な値: `480P`、`720P`、`1080P` +- wan2.5-i2v-preview: 480P, 720P, 1080P +- wan2.6 系モデル (t2v, i2v, r2v): 720P, 1080P のみ (480P 非対応) +- wan2.7 系モデル (i2v, t2v, r2v, videoedit): 720P, 1080P (デフォルト 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (上流のデフォルト 1080P) +- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P +- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P +このプロキシは、resolution と size のどちらも指定されていないビデオ生成リクエストを拒否します。これは、解像度の階層が課金レートを決めるためです。チェックの前に resolution を大文字化し、大文字化した値をそのまま転送します。この enum に含まれない値には 400 を返し、上記で 480P 非対応とされている wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P に対して 400 を返します (resolution として送信された場合も、480P の size として送信された場合も同様です)。 + + 指定可能な値: `480P`, `720P`, `1080P` @@ -335,29 +398,27 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデル用です。 -- single: シングルショットビデオ(デフォルト) -- multi: マルチショットビデオ +wan2.6 および wan2.7-r2v モデル向け。 +- single: 単一ショットのビデオ (デフォルト) +- multi: マルチショットのビデオ - 指定可能な値: `multi`、`single` + 指定可能な値: `multi`, `single` - 幅*高さ 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ -wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720、720*1280、960*960、1088*832、832*1088 - 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -size と resolution の両方を送信した場合、課金ティアを選択するのは size であり、 -resolution もこのプロキシがそのモデルに対して受け付ける値である必要があります。480P の size は、 -解像度の説明で 480P 非対応として挙げられているすべてのモデルで 400 を返します。 + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P (480*832, 832*480, 624*624)、720P、1080P の各サイズ +wan2.6 T2V/R2V の場合 (480P 非対応): + 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 + 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 +size と resolution の両方を送信した場合、課金階層を決めるのは size であり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、解像度の説明で 480P 非対応とされているすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -`GET /v2/models/wan/happyhorse-1.1-i2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +このスキーマは、Router が `GET /v2/models/wan/happyhorse-1.1-i2v/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 ### 出力 @@ -366,11 +427,11 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用) + インテリジェントな書き換え後の実際のプロンプト(ビデオタスク向け) - オーディオ生成を伴うI2Vタスク用のオーディオURL + 音声生成を伴うI2Vタスク用のオーディオURL @@ -378,7 +439,7 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - タスクの完了時間 + タスク完了時間 @@ -386,11 +447,11 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - オリジナルの入力プロンプト(ビデオタスク用) + 元の入力プロンプト(ビデオタスク向け) - 画像生成タスクのタスク結果のリスト + 画像生成タスクのタスク結果リスト @@ -406,7 +467,7 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - オリジナルの入力プロンプト + 元の入力プロンプト @@ -414,11 +475,11 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - タスクの実行時間 + タスク実行時間 - タスクの送信時間 + タスク送信時間 @@ -426,15 +487,15 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - 画像生成タスクのタスク結果の統計 + 画像生成タスクのタスク結果統計 - 失敗したタスクの数 + 失敗したタスク数 - 成功したタスクの数 + 成功したタスク数 @@ -444,7 +505,7 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 タスクステータス - 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 取り得る値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` @@ -472,7 +533,7 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - 生成された画像の数(T2IおよびI2Iタスク) + 生成された画像数(T2IおよびI2Iタスク) @@ -484,7 +545,7 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) + 生成されたビデオのアスペクト比。例: 16:9(wan3.0-videoタスク) @@ -492,7 +553,7 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - 生成されたビデオの数(T2Vタスク) + 生成されたビデオ数(T2Vタスク) @@ -500,15 +561,15 @@ resolution もこのプロキシがそのモデルに対して受け付ける値 - ビデオ解像度の比率(T2Vタスク) + ビデオ解像度比率(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、envelope の ROOT で報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストの詳細情報。`output` の下ではなく、envelope の ROOT で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx index b28ebdec7d..1a4c535a6b 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx @@ -2,17 +2,18 @@ title: "HappyHorse 1.1 R2V を Comfy Router で使用する" description: "Comfy Router 経由で HTTP を通して wan/happyhorse-1.1-r2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "HappyHorse 1.1 R2V" -translationSourceHash: afb02787 +translationSourceHash: 53cf60f2 translationFrom: development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx translationBlockHashes: "_intro": 320590bd "Quick start": 8eb3cc23 - "Schema": b9d2c334 + "Schema": 57b62b59 "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -205,131 +206,126 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-r2v/requests/$REQUEST_ID ### 入力 - プロンプトワードなどの基本情報を入力します。 + プロンプトなどの基本情報を入力します。 - オーディオファイルのダウンロード URL。対応形式: mp3 および wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式: mp3 および wav。reference_video_urls と併用できません。 - 先頭フレーム画像の URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の呼称は、先頭フレームをここでは -受け取りません。type が first_frame の media 要素として受け取ります(後述の media を参照)。 -また、wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v と -happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 系の呼称も、 -参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレーム画像のURL、またはBase64エンコードされたデータ。wan2.5-i2v-preview と +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、先頭フレームをここでは受け取りません。 +先頭フレームは type が first_frame のメディア要素として受け取ります(後述の media を参照)。 +また、wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v と happyhorse-1.1-i2v +ではプロバイダーに拒否されます。wan2.7/wan3.0 の表記も参照アセットを media で受け取ります。 +画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360~2000ピクセル。ファイルサイズ: 最大10MB。 - メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を -指定します。各要素は type と url フィールドを含みます。このフィールドはこの -コンポーネントから提供されるすべてのモデルで共通であり、どのモデルがどの type 値を -受け入れるか、また画像やビデオの入力を img_url や reference_video_urls ではなく -ここで渡すかどうかは、モデルによって異なります。モデルごとの対応 type 値: + メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントが提供するすべての +モデルで共通であり、あるモデルが受け付ける type の値、および画像やビデオの入力を img_url や +reference_video_urls ではなくここで受け取るかどうかは、モデルによって異なります。モデルごとの +対応する type の値: - wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺あたり 240-8000 ピクセル、アスペクト比 1:8 - から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 - 秒、1辺あたり 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの + last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240~8000ピクセル、アスペクト比 1:8~8:1、 + 最大20MB、公開URL または data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2~30秒、最大15MB)と first_clip(MP4/MOV、2~10秒、 + 1辺 240~4096ピクセル、最大100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。少なくとも - reference_image または reference_video が 1 つ必要で、参照画像と - 参照ビデオの合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、1辺あたり 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 - 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。 + reference_image または reference_video が少なくとも1つ必要で、reference_image と + reference_video を合わせて最大5つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺 240~8000ピクセル、アスペクト比 1:8~8:1、最大 + 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど 1 つ。編集対象のクリップ: MP4/MOV、2-10 秒、 - 1辺あたり 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL - は受け付けられません)に加えて、任意で 0 から 4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL +- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、2~10秒、 + 1辺 240~4096ピクセル、最大100MB、公開 HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で 0~4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺 240~8000ピクセル、アスペクト比 1:8~8:1、最大20MB、公開URL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 - reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、 - reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link とは - 併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link の type +- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 + reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15秒)、 + reference_audio(最大5クリップ、合計再生時間 \<= 15秒)、file(最大1、link と併用 + 不可)、link(最大1、file と併用不可)。reference_*/file/link の type と first_frame/last_frame の type は、同じリクエスト内では同時に使用できません。 - 配列の順序が、プロンプト内でのアセットの参照順序を定義します(画像 1、ビデオ 1、 - オーディオ 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり 240-8000 ピクセル、アスペクト比は最大 8:1、最大 20MB、公開 URL または + 配列の順序は、プロンプト内でのアセットの参照順(画像1、ビデオ1、オーディオ1、...)を定義します。 + first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1辺 240~8000ピクセル、アスペクト比 最大 8:1、最大20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの呼称 - は先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 - ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL - または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 個。これが - このモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 - 最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video は - この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど 1 つ。編集対象のクリップ: MP4/MOV、3-60 - 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト - 比 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: - URL は受け付けられません)に加えて、任意で 0 から 5 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 20MB、公開 URL +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記 + では先頭フレームを img_url ではなくここで受け取ります。最小 300x300ピクセル、アスペクト比 + 1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、公開URL または + data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9個。これが + このモデル唯一の参照入力です。最短辺 400ピクセル以上、JPEG/JPG/PNG/WEBP、 + 最大20MB、公開URL または data:\{MIME_type};base64,... URL。この操作では + reference_video は入力タイプではありません。 +- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、3~60 + 秒、長辺 最大4096ピクセル、短辺 360ピクセル以上、アスペクト + 比 1:2.5~2.5:1、最大100MB、公開 HTTP/HTTPS URL。インラインの data: + URL は受け付けられません)に加えて、任意で 0~5 個の reference_image(JPEG/JPG/PNG/WEBP、 + 最小 300x300ピクセル、アスペクト比 1:2.5~2.5:1、最大20MB、公開URL または data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。これらのパートナーのリファレンスには media 入力の記載が - ないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの呼称に - ついて media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭 - フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で - 受け取ります。 -上記のモデルごとの個数は、このスキーマの制約ではなくパートナーの制約です。media -には minItems/maxItems が宣言されていません。許容される type とその上限は -モデルごとに異なるためです。スキーマで受け入れられることは、プロバイダーが受け入れ -ることを意味しません。また逆に、上記のアセットごとの「最大 20MB」という数値 -(画像入力の上限であり、インラインで送信できる唯一の入力です)は、最終的に -受け取るアセットに対するパートナーの上限であり、アセットが公開 URL の場合は -そのまま適用されます。そのバイト列が Comfy を経由することはないためです。 -インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、 -転送時の上限にも当てはまります。Comfy Router の POST ボディは合計で 100 MiB に -制限され、それを超えると 413 が返されます。また base64 はペイロードを約 4/3 に -膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここにある -パートナーのルールのいずれかに到達する前に拒否されます。そのサイズでは、 -パートナー自身の20MB の上限であればインラインで問題なく収まるため、アセットが 1 つの場合はパートナーのルールが制約となります。複数のアセットにまたがる場合は、転送時の上限が制約となります。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは public URL として送信してください。 + テキストから動画への操作。これらのパートナーのリファレンスにはメディア入力の記載がないため、 + このフィールドは未設定のままにします。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対する + メディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭 + フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。media には +minItems/maxItems が宣言されていません。許容される type とその上限が +モデルごとに異なるためです。スキーマが受け付けることは、プロバイダーが受け付けることを意味しません。また逆に、 +上記のアセットごとの「最大20MB」という数値(画像入力の上限であり、インラインで送信できる唯一の入力)は、 +最終的にパートナーが保持するアセットに対するパートナーの上限であり、アセットが公開URLの場合は +そのまま適用されます。そのバイト列が Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... +URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router +の POST ボディは合計 100 MiB に制限され、超えると 413 で応答され、base64 は +ペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、 +ここに示したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の +20MB の上限はインラインで余裕をもって収まるため、1 つのアセットについてはパートナーのルールが制約となります。複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは公開 URL として送信してください。 メディアアセットの種類 - 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL: 公開 HTTP/HTTPS URL、または(上記の `media` の説明で各モデルごとに挙げられているまさに IMAGE 入力、すなわち wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image に限られます)インラインの `data:{MIME_type};base64,...` URL。これらのモデルの video、audio、file、link 入力はいずれもインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード用のルートを公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されることなく、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: 公開 HTTP/HTTPS URL、または、上記の `media` の説明が各モデルについて列挙している IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または (wan2.7-videoedit では) Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーに転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します + ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。prompt と同じ入力バジェットにカウントされます。 - テキストプロンプトの語句。中国語と英語をサポートし、長さは 800 文字以内です -(wan3.0-video では最大 20,000 文字。上限を超えた内容は切り捨てられます)。 -複数の参照ビデオを使用する wan2.6-r2v では、参照ビデオの順序に合わせて 'character1'、'character2' などで被写体を参照してください。例:「Character1 が道端で歌い、Character2 がその横で踊る」 -wan3.0-video の参照モードでは、media 配列内の対応する順序に合わせて 'Image 1'、'Video 1'、'Audio 1' などでメディアアセットを参照してください。 + テキストプロンプト。中国語と英語をサポートします。文書化された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字です。プロバイダーは、prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト (約 20,000 の中国語文字) を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +wan2.6-r2v で複数の参照ビデオを使用する場合は、'character1'、'character2' などを使用して、参照ビデオの順に被写体を参照します。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' などを使用して、media 配列内の対応する順序でメディアアセットを参照します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 本のビデオ URL の配列です。 + wan2.6-r2v モデル専用の参照ビデオ URL。1~3 本のビデオ URL の配列。 入力の制限: - 形式: mp4、mov -- 本数: 1~3 本のビデオ +- 本数: 1~3 本 - 単一ビデオの長さ: 2~30 秒 - 単一ファイルサイズ: 最大 30MB - audio_url と併用できません -参照の再生時間: 単一ビデオは最大 5 秒、2 本のビデオはそれぞれ最大 2.5 秒、3 本のビデオはそれに比例して短くなります。 +参照の再生時間: 単一ビデオは最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合は比例して短くなります。 課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はその操作自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はその操作自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -337,89 +333,84 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序に - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてはこのような切り替えを文書化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされており、プロバイダーは他の wan モデルについてそのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します -- origin: 入力ビデオのオリジナルオーディオを強制的に保持します +- auto (デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します +- origin: 入力ビデオのオリジナルのオーディオを強制的に保持します - 指定可能な値: `auto`, `origin` + 指定可能な値: `auto`、`origin` - 生成されるビデオの再生時間(秒): -- wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 -- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒はサポートされません) + 生成されるビデオの再生時間 (秒): +- wan2.5 モデル: 5 または 10 秒 +- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 +- wan2.6-r2v: 5 または 10 秒のみ (15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は - 入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると - スマート再生時間モードが有効になり、モデルが適切な再生時間を選択します -このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数、ビデオ入力ありの場合は入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、モデルが適切な再生時間を選択するスマート再生時間モードが有効になります +このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 範囲: `-1` ~ `30` - プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です + プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合、解像度の階層に基づいてデフォルト値が決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの縦横比と意図に基づいて -適切なアスペクト比を自動的に推奨します。 +wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 +wan3.0-video では、adaptive (デフォルト) が適切な値を自動的に推奨しますマージン比は入力メディアの比率と意図に基づいて決まります。 - 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video, wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P、1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P、720P、1080P -このプロキシは、解像度もサイズも指定されていないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決定するためです。解像度はチェックの前に大文字に変換し、変換後の値を転送します。この enum に含まれない値には 400 を返し、上記で 480P 非対応として挙げられている wan2.6、wan2.7、happyhorse-1.0 モデルでは、480P(解像度として送信された場合も、480P のサイズとして送信された場合も)に対して 400 を返します。 - - 可能な値: `480P`, `720P`, `1080P` +- wan2.6 モデル (t2v、i2v、r2v): 720P、1080P のみ (480P は非サポート) +- wan2.7 モデル (i2v、t2v、r2v、videoedit): 720P、1080P (デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P (上流のデフォルトは 1080P) +- happyhorse-1.0-* (t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-* (t2v、i2v、r2v): 480P、720P、1080P +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。これは、解像度ティアが課金レートを決定するためです。チェックの前に resolution を大文字化し、大文字化した値を転送します。この enum にない値には 400 を返し、上記で 480P 非サポートとされている wan2.6、wan2.7、happyhorse-1.0 のモデルでは 480P に対して (resolution として送られた場合も、480P の size として送られた場合も) 400 を返します。 + + 指定可能な値: `480P`、`720P`、`1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 - 範囲: `0` から `2147483647` まで + 範囲: `0` から `2147483647` インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 wan2.6 および wan2.7-r2v モデル向け。 -- single: シングルショットビデオ(デフォルト) -- multi: マルチショットビデオ +- single: 単一ショットのビデオ (デフォルト) +- multi: マルチショットのビデオ - 可能な値: `multi`, `single` + 指定可能な値: `multi`、`single` - 幅*高さ形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ -wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -サイズと解像度の両方を送信した場合、課金される階層はサイズによって決まり、 -解像度は依然としてこのプロキシがそのモデルに対して受け付ける値である必要があります。480P のサイズは、 -解像度の説明で 480P 非対応として挙げられているすべてのモデルで 400 を返します。 + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P (480*832、832*480、624*624)、720P、1080P の各サイズ +wan2.6 T2V/R2V の場合 (480P なし): + 720P: 1280*720、720*1280、960*960、1088*832、832*1088 + 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +size と resolution の両方が送信された場合、課金ティアを選択するのは size であり、resolution は引き続きこのプロキシがそのモデルで受け付ける値である必要があります。480P の size は、解像度の説明で 480P 非サポートとされているすべてのモデルで 400 を返します。 - 透かしロゴを追加するかどうか。透かしは右下隅に配置されます + ウォーターマークロゴを付加するかどうか。ウォーターマークは右下隅に配置されます。 -Router が `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 +`GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同一のドキュメントです。 ### 出力 @@ -432,7 +423,7 @@ Router が `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で提供する - オーディオ生成を伴うI2Vタスク用のオーディオURL + オーディオ生成を伴うI2VタスクのオーディオURL @@ -440,15 +431,15 @@ Router が `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で提供する - タスクの完了時間 + タスク完了時間 - 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) - オリジナルの入力プロンプト(ビデオタスク用) + 元の入力プロンプト(ビデオタスク用) @@ -468,19 +459,19 @@ Router が `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で提供する - オリジナルの入力プロンプト + 元の入力プロンプト - 生成された画像のURLアドレス + 生成済み画像のURLアドレス - タスクの実行時間 + タスク実行時間 - タスクの送信時間 + タスク送信時間 @@ -492,11 +483,11 @@ Router が `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で提供する - 失敗したタスクの数 + 失敗したタスク数 - 成功したタスクの数 + 成功したタスク数 @@ -526,15 +517,15 @@ Router が `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で提供する - 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) + 生成済みビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-videoタスク) + 生成済みビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2IおよびI2Iタスク) + 生成済み画像数(T2IおよびI2Iタスク) @@ -546,19 +537,19 @@ Router が `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で提供する - 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) + 生成済みビデオのアスペクト比、例: 16:9(wan3.0-videoタスク) - 画像の解像度(T2IおよびI2Iタスク) + 画像解像度(T2IおよびI2Iタスク) - 生成されたビデオの数(T2Vタスク) + 生成済みビデオ数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2Vタスク) + 生成済みビデオの再生時間(秒)(T2Vタスク) @@ -566,11 +557,11 @@ Router が `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` で提供する - 失敗したリクエストのエラーコード。`output` の下ではなくエンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストに関する詳細情報。`output` の下ではなくエンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx b/ja/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx index 208e092b75..2bf9449e14 100644 --- a/ja/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Wan 2.5 I2I Preview を使用する" description: "Comfy Router 経由で wan/wan2.5-i2i-preview を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Wan 2.5 I2I Preview" -translationSourceHash: c19a12c9 +translationSourceHash: 11080daf translationFrom: development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx translationBlockHashes: "_intro": d8f59ebb "Quick start": a98c2f62 - "Schema": 8bff936f + "Schema": c4c53620 "Examples": 3d10fc60 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/wan/wan2.5-i2i-preview.json から生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -176,23 +177,23 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID ### 入力 - プロンプト、画像などの基本情報を入力します。 + プロンプトや画像などの基本情報を入力します。 - 画像から画像への生成に使用する画像 URL の配列 + 画像から画像への生成に使用する1〜3枚の画像URLの配列 - 画像に表示したくないコンテンツを記述するネガティブプロンプト + 画像に含めたくない内容を記述するためのネガティブプロンプト。prompt と同じ入力上限にカウントされます。 - 期待する画像の要素や視覚的特徴を記述するポジティブプロンプト。中国語と英語をサポートし、長さは 2000 文字以内です + 期待する画像の要素や視覚的特徴を記述するポジティブプロンプト。中国語と英語に対応しています。モデルが読み取る長さを超えたプロンプトは拒否されず、切り捨てられます。プロバイダーは、prompt と negative_prompt を合わせて約60,850バイトのUTF-8テキスト(約20,000文字の中国語)を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 - 画像から画像への生成に呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定します。`POST /proxy/wan/api/v1/services/aigc/image2image/image-synthesis` への直接の v1 呼び出しではこれを必ず指定する必要があり、受け入れられる表記の enum はそのオペレーション自身のコンポーネント `WanImage2ImageGenerationRequest` にあります。 + 画像から画像への生成に呼び出すモデルのID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定します。`POST /proxy/wan/api/v1/services/aigc/image2image/image-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け入れられる表記の enum はそのオペレーション自身のコンポーネント `WanImage2ImageGenerationRequest` に定義されています。 @@ -200,26 +201,27 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 生成する画像の数。範囲は 1~4、デフォルトは 4 + 生成する画像の枚数。範囲は1〜4、デフォルトは4です。 - 範囲: `1` ~ `4` + 範囲: `1`〜`4` - ランダム性を制御する乱数シード。範囲 [0, 2147483647] + ばらつきを制御するためのランダムシード。範囲 [0, 2147483647] - 範囲: `0` ~ `2147483647` + 範囲: `0`〜`2147483647` - 幅*高さ形式の出力画像の解像度。デフォルトは 1280*1280 です。API は 589824 (768*768) から 1638400 (1280*1280) までのピクセル面積を、1:4 から 4:1 までのアスペクト比で受け付けます + 出力画像の解像度を幅*高さの形式で指定します。デフォルトは1280*1280です。APIは589824(768*768)から1638400(1280*1280)までのピクセル面積を、1:4から4:1までの比率で受け付けます。 - 右下隅に透かしロゴを追加するかどうか + 右下隅にウォーターマークロゴを追加するかどうか -Router が `GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` で提供するスキーマから生成されます。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 +`GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 + ### 出力 @@ -227,11 +229,11 @@ Router が `GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` で提供する - インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用) + インテリジェントなリライト後の実際のプロンプト(ビデオタスク用) - オーディオ生成を伴う I2V タスク用のオーディオ URL + 音声生成を伴うI2VタスクのオーディオURL @@ -255,15 +257,15 @@ Router が `GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` で提供する - インテリジェントな書き換え後の実際のプロンプト(有効な場合) + インテリジェントなリライト後の実際のプロンプト(有効な場合) - 画像エラーコード(一部のタスクが失敗した場合に返されます) + 画像のエラーコード(一部のタスクが失敗した場合に返されます) - 画像エラー情報(一部のタスクが失敗した場合に返されます) + 画像のエラー情報(一部のタスクが失敗した場合に返されます) @@ -271,23 +273,23 @@ Router が `GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` で提供する - 生成された画像の URL アドレス + 生成済み画像のURLアドレス - タスクの実行時間 + タスク実行時間 - タスクの送信時間 + タスク送信時間 - タスク ID + タスクID - 画像生成タスクのタスク結果統計 + 画像生成タスクのタスク結果の統計 @@ -299,17 +301,17 @@ Router が `GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` で提供する - タスクの合計数 + タスクの総数 - タスクステータス + タスクのステータス 取り得る値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 完了したビデオ生成タスクのビデオ URL。リンクの有効期間は 24 時間です + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です @@ -321,55 +323,55 @@ Router が `GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` で提供する - ビデオ解像度レベル(I2V および wan3.0-video タスク) + ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) - 生成されたビデオの再生時間(秒)(I2V および wan3.0-video タスク) + 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-video タスク) + 生成されたビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2I および I2I タスク) + 生成された画像の数(T2IおよびI2Iタスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間(秒)(wan3.0-video タスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) - 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-video タスク) + 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) - 画像解像度(T2I および I2I タスク) + 画像の解像度(T2IおよびI2Iタスク) - 生成されたビデオの数(T2V タスク) + 生成されたビデオの数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2V タスク) + 生成されたビデオの再生時間(秒)(T2Vタスク) - ビデオ解像度の比率(T2V タスク) + ビデオの解像度比率(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/ja/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index a51b7d9c43..bdee107166 100644 --- a/ja/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -2,18 +2,19 @@ title: "Wan 2.5 I2V Preview を Comfy Router で使用する" description: "Comfy Router 経由で HTTP を使用して wan/wan2.5-i2v-preview を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 2.5 I2V Preview" -translationSourceHash: 76630e35 +translationSourceHash: cf342bd4 translationFrom: development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx translationBlockHashes: "_intro": 630a0d10 "Quick start": 8713537b - "Schema": 8ddb2e5e + "Schema": 483bc30d "Examples": 2b581e5f --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -186,30 +187,88 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2v-preview/requests/$REQUEST_ID ### 入力 - プロンプトなどの基本情報を入力します。 + プロンプト語句などの基本情報を入力します。 - オーディオファイルのダウンロードURL。対応フォーマット: mp3 および wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式: mp3 と wav。reference_video_urls とは併用できません。 - 先頭フレーム画像のURL、またはBase64エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の表記では、先頭フレームをここでは受け取りません。type が first_frame の media 要素として受け取ります(下記の media を参照)。また、wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v および happyhorse-1.1-i2v ではプロバイダーに拒否されます。さらに wan2.7/wan3.0 系の表記も参照アセットを media で受け取ります。画像フォーマット: JPEG、JPG、PNG、BMP、WEBP。解像度: 360~2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレーム画像のURL、またはBase64エンコードされたデータ。wan2.5-i2v-preview と +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、先頭フレームをここで受け取りません。 +先頭フレームは type が first_frame のメディア要素として受け取ります(後述の media を参照)。 +また、wan2.6-i2v で成功する img_url ボディは、happyhorse-1.0-i2v と +happyhorse-1.1-i2v ではプロバイダーに拒否されます。さらに wan2.7/wan3.0 の表記では、 +参照アセットを media でも受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットの一覧。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type フィールドと url フィールドを含みます。このフィールドはこのコンポーネントから提供されるすべてのモデルで共有されています。あるモデルがどの type 値を受け入れるか、また画像やビデオの入力を img_url や reference_video_urls ではなくそもそもここで受け取るかどうかは、モデルによって異なります。モデルごとの対応 type 値: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2~30 秒、最大 15MB)と first_clip(MP4/MOV、2~10 秒、1辺 240~4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。reference_image または reference_video が少なくとも 1 つ必要で、reference_image と reference_video を合計して最大 5 つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、1辺 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、2~10 秒、1辺 240~4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0~4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、1辺 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link とは併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link の type と first_frame/last_frame の type は、同じリクエスト内では同時に使用できません。配列の順序が、プロンプト内のアセットの参照順(Image 1、Video 1、Audio 1、...)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺 240~8000 ピクセル、アスペクト比 最大 8:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの表記では先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、アスペクト比 1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9 つ。これはこのモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、3~60 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5~2.5:1、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0~5 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、少なくとも 300x300 ピクセル、アスペクト比 1:2.5~2.5:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作です。これらのパートナーのリファレンスには media 入力の記載がないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対する media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの個数は、このスキーマの制約ではなくパートナーの制約です。media には minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに異なるためです。スキーマが受け入れることは、プロバイダーが受け入れることを意味しません。逆に、上記のアセットごとの「最大 20MB」という数値は、インラインで送信できる唯一の入力である画像入力に対する上限であり、最終的にパートナーが扱うアセットに対するパートナーの上限です。アセットが公開URLである場合、そのバイト列が Comfy を経由しないため、これらの数値は記載どおりに適用されます。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限されており、それを超えると 413 が返されます。また base64 はペイロードを約 4/3 に膨らませます。そのため、およそ 75 MB を超える単一のインラインアセットは、ここに記載したパートナーのルールのいずれかに到達する前に拒否されます。そのサイズでは、パートナー自身の -20MB の上限はインラインでも問題なく収まるため、単一のアセットではパートナーのルールが制約となり、複数のアセットにまたがる場合は転送の上限が制約となります。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、パブリック URL として送信してください。 + メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドは本コンポーネントが提供するすべての +モデルで共有されますが、あるモデルがどの type 値を受け付けるか、また画像やビデオの入力を +img_url や reference_video_urls ではなくここで受け取るかどうかはモデルによって異なります。 +モデルごとの対応 type 値: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と + last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240-8000 ピクセル、アスペクト比 1:8 + から 8:1 の間、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 + 秒、1辺 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの + data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。少なくとも + reference_image または reference_video が1つ必要で、参照画像と + 参照ビデオは合計で最大5つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 + 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video: 公開 + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(正確に1つ、編集対象のクリップ: MP4/MOV、2-10 秒、 + 1辺 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で 0〜4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開URL + または data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 + reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15s)、 + reference_audio(最大5クリップ、合計再生時間 \<= 15s)、file(最大1、link とは + 併用不可)、link(最大1、file とは併用不可)。reference_*/file/link の type + と first_frame/last_frame の type は同一リクエスト内で同時に使用できません。 + 配列の順序がプロンプト内のアセットの参照順序(Image 1、Video 1、 + Audio 1、...)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1辺 240-8000 ピクセル、アスペクト比 最大 8:1、最大 20MB、公開URL または + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: + 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、正確に1つ。これらの表記 + では先頭フレームを img_url ではなくここで受け取ります。最小 300x300 ピクセル、アスペクト比 + 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開URL または + data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9 個。これは + モデル唯一の参照入力です。短辺は最小 400 ピクセル、JPEG/JPG/PNG/WEBP、 + 最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video は + この操作の入力タイプではありません。 +- happyhorse-1.0-video-edit: video(正確に1つ、編集対象のクリップ: MP4/MOV、3-60 + 秒、長辺 最大 4096 ピクセル、短辺 最小 360 ピクセル、アスペクト + 比 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: + URL は受け付けられません)に加えて、任意で 0〜5 個の reference_image(JPEG/JPG/PNG/WEBP、 + 最小 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 20MB、公開URL + または data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: + テキストから動画への操作です。これらのパートナーの参照ドキュメントにはメディア入力が + 記載されていないため、このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対する + メディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭 + フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で + 受け取ります。 +上記のモデルごとの件数はパートナーの制約であり、このスキーマの制約ではありません。media には +minItems/maxItems が宣言されていません。許容される type とその上限が +モデルごとに異なるためです。スキーマが受け付けることはプロバイダーが受け付けることを意味しません。 +また逆に、上記のアセットごとの「最大 20MB」という値、つまり画像 +入力(インラインで送信できる唯一の入力)に対する上限は、パートナーが最終的に +受け取るアセットに対するパートナーの上限であり、アセットが公開URLである場合には +そのまま適用されます。そのバイト列は Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... +URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の +POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。さらに base64 は +ペイロードを約 4/3 に膨張させるため、およそ 75 MB を超える単一のインラインアセットは、ここに挙げた +パートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限はインラインに余裕で収まるため、1つのアセットについてはパートナーのルールが制約となります。複数のアセットにまたがる場合は転送の上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 @@ -219,71 +278,68 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2v-preview/requests/$REQUEST_ID - メディアファイルの URL。パブリックな HTTP/HTTPS URL、または(上記の `media` の説明が各モデルについて列挙しているまさにその画像入力に限り)インラインの `data:{MIME_type};base64,...` URL です。その対象は、wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、および happyhorse-1.0-video-edit の reference_image です。これらのモデルのいずれにおいても、video、audio、file、link の入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されることなく、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明でモデルごとに列挙されている IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を指定できます。これらのモデルのビデオ、オーディオ、ファイル、リンクのいずれの入力も、インラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されることなく、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを合計で制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します + 逆プロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これは prompt と同じ入力予算にカウントされます。 - テキストプロンプト。中国語と英語をサポートし、長さは 800 文字以内です -(wan3.0-video では最大 20,000 文字。制限を超えたコンテンツは切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に従って被写体を指すために -'character1'、'character2' などを使用します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを指すために -'Image 1'、'Video 1'、'Audio 1' などを使用します。 + テキストプロンプトの語句。中国語と英語をサポートします。文書化された長さを超えると、wan2.x モデルは拒否せずにプロンプトを切り捨てます。wan2.5 と wan2.6 は 1,500 文字、wan2.7 は 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字まで受け付けます。prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 文字の中国語)を超えるリクエストは、プロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に従って被写体を 'character1'、'character2' などで参照します。例:「Character1 が道端で歌い、Character2 がその横で踊る」 +wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを 'Image 1'、'Video 1'、'Audio 1' などで参照します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 本のビデオ URL の配列です。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列。 入力の制限: - 形式: mp4、mov -- 本数: 1~3 本 -- 1 本あたりのビデオの長さ: 2~30 秒 +- 本数: 1〜3 本 +- 1 本あたりの長さ: 2〜30 秒 - 1 ファイルあたりのサイズ: 最大 30MB -- audio_url とは併用できません -参照の再生時間: 1 本の場合は最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合は比例して短くなります。 +- audio_url と併用できません +参照の再生時間: ビデオ 1 本なら最大 5 秒、2 本ならそれぞれ最大 2.5 秒、3 本なら比例して短くなります。 課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への v1 の直接呼び出しでは必ず指定する必要があり、受け入れられる表記の enum はその操作自身のコンポーネントである `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 - ビデオ処理パラメータ + ビデオ処理のパラメータ - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。その他の wan モデルについては、プロバイダーはそのような切り替えを文書化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてこのような切り替えを文書化していません。 - wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します + wan2.7-videoedit モデル用のビデオオーディオ設定。 +- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: `auto`、`origin` - 生成されるビデオの再生時間(秒): + 生成するビデオの再生時間(秒): - wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 -- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒はサポートされません) +- wan2.6-t2v、wan2.6-i2v: 5、10、15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの - 再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 は - スマート再生時間モードを有効にし、モデルが適切な再生時間を選択します +- wan3.0-video: ビデオ入力なしなら [2, 30] の整数。ビデオ入力ありの場合、 + 入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると + スマート再生時間モードが有効になり、モデルが適切な再生時間を選択します このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 - 範囲: `-1` ~ `30` + 範囲: `-1` から `30` @@ -291,57 +347,57 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 + 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が、入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に提案します。 +wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 - 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` 解像度レベル。サポートされる値はモデルによって異なります: -- wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルトは 1080P) - - -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (アップストリームのデフォルトは 1080P) +- wan2.5-i2v-preview: 480P, 720P, 1080P +- wan2.6 モデル (t2v, i2v, r2v): 720P, 1080P のみ (480P はサポートされません) +- wan2.7 モデル (i2v, t2v, r2v, videoedit): 720P, 1080P (デフォルト 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (上流のデフォルト 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -このプロキシは、解像度とサイズのどちらも指定されていないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決定するためです。解像度は検証の前に大文字へ変換され、その大文字化された値が転送されます。この enum に含まれない値に対しては 400 を返し、上記で 480P 非対応として示されている wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P (解像度として送信された場合でも、480P のサイズとして送信された場合でも) に対して 400 を返します。 +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。解像度ティアが課金レートを選択するためです。このプロキシは検証の前に resolution を大文字化し、大文字化した値を転送します。この列挙に含まれない値には 400 を返し、上記で 480P がないとされている wan2.6、wan2.7、happyhorse-1.0 モデルでは、480P に対して 400 を返します (resolution として送信された場合も、480P の size として送信された場合も同様です)。 指定可能な値: `480P`, `720P`, `1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。wan2.6 および wan2.7-r2v モデル用です。 -- single: 単一ショットのビデオ (デフォルト) -- multi: マルチショットのビデオ + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 +wan2.6 および wan2.7-r2v モデル向けです。 +- single: シングルショットビデオ (デフォルト) +- multi: マルチショットビデオ 指定可能な値: `multi`, `single` - 幅*高さ 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P (480*832, 832*480, 624*624), 720P, 1080P のサイズ + width*height 形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P (480*832, 832*480, 624*624)、720P、1080P のサイズ wan2.6 T2V/R2V の場合 (480P なし): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size と resolution の両方を送信した場合、課金階層を選択するのは size であり、resolution は引き続きこのプロキシがそのモデルで受け入れる値である必要があります。480P の size は、resolution の説明で 480P 非対応として挙げられているすべてのモデルで 400 を返します。 +size と resolution の両方が送信された場合、課金ティアを選択するのは size であり、 +resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、 +resolution の説明で 480P がないと記載されているすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます -Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に Router が使用するドキュメントと同じものです。 +Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 @@ -366,7 +422,7 @@ Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供する - 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) @@ -394,7 +450,7 @@ Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供する - 生成済み画像のURLアドレス + 生成済み画像のURL @@ -414,11 +470,11 @@ Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供する - 失敗したタスクの数 + 失敗したタスク数 - 成功したタスクの数 + 成功したタスク数 @@ -428,7 +484,7 @@ Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供する タスクステータス - 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 取り得る値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` @@ -448,15 +504,15 @@ Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供する - 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) + 生成済みビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-videoタスク) + 生成済みビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2IおよびI2Iタスク) + 生成済み画像数(T2IおよびI2Iタスク) @@ -468,7 +524,7 @@ Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供する - 生成されたビデオのアスペクト比(例:16:9)(wan3.0-videoタスク) + 生成済みビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) @@ -476,23 +532,23 @@ Router が `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` で提供する - 生成されたビデオの数(T2Vタスク) + 生成済みビデオ数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2Vタスク) + 生成済みビデオの再生時間(秒)(T2Vタスク) - ビデオ解像度比率(T2Vタスク) + ビデオ解像度比(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなくエンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストに関する詳細情報。`output` の下ではなくエンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan2-6-t2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-6-t2v/code.mdx index 6f3bee1c79..73515bde5b 100644 --- a/ja/development/comfy-router/models/wan/wan2-6-t2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-6-t2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Wan 2.6 T2V を使用する" description: "Comfy Router 経由で HTTP を通じて wan/wan2.6-t2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 2.6 T2V" -translationSourceHash: af081f28 +translationSourceHash: 00873331 translationFrom: development/comfy-router/models/wan/wan2-6-t2v/code.mdx translationBlockHashes: "_intro": 93b4f6f5 "Quick start": b919757c - "Schema": dd8ddc51 + "Schema": 35961ffb "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -186,128 +187,120 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-t2v/requests/$REQUEST_ID \ - オーディオファイルのダウンロードURL。対応フォーマット: mp3 と wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式: mp3 および wav。reference_video_urls とは併用できません。 - 最初のフレームの画像URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview と -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記は最初のフレームをここでは -受け取りません。type が first_frame のメディア要素として受け取ります(下記の media を -参照してください)。また、wan2.6-i2v で成功する img_url ボディは、 -happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーに拒否されます。 -wan2.7/wan3.0 の表記も同様に参照アセットを media で受け取ります。 -画像フォーマット: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360~2000ピクセル。ファイルサイズ: 最大10MB。 + 先頭フレーム画像のURLまたはBase64エンコードされたデータ。wan2.5-i2v-preview と +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、先頭フレームをここでは +受け取りません。先頭フレームは type が first_frame のメディア要素として渡します(下記の +media を参照)。また、wan2.6-i2v で成功する img_url のボディは、happyhorse-1.0-i2v と +happyhorse-1.1-i2v ではプロバイダーによって拒否されます。さらに wan2.7/wan3.0 の表記では +参照アセットも media で渡します。画像形式: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットのリスト。動画生成の参照素材(画像、オーディオ、ビデオ)を指定します。 -各要素は type フィールドと url フィールドを持ちます。このフィールドはこのコンポーネントから -提供されるすべてのモデルで共有されており、どのモデルがどの type 値を受け入れるか、 -また画像やビデオの入力を img_url や reference_video_urls ではなくここで受け取るかどうかは、 -モデルごとに異なります。モデルごとの対応 type 値: + メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントで提供される +すべてのモデルで共通ですが、あるモデルがどの type 値を受け付けるか、また画像やビデオの +入力をここで受け取るのか img_url や reference_video_urls で受け取るのかは、モデルごとに +異なります。モデルごとの対応 type 値: - wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240~8000ピクセル、アスペクト比 1:8 - ~8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2~30秒、最大 15MB)と first_clip(MP4/MOV、2~10 - 秒、1辺 240~4096ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの + last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240-8000 ピクセル、アスペクト比 1:8 から + 8:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 秒、 + 1辺 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。少なくとも - 1つの reference_image または reference_video が必要で、reference_image と - reference_video を合計して最大5つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、1辺 240~8000ピクセル、アスペクト比 1:8~8:1、最大 - 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 +- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。 + reference_image または reference_video が少なくとも 1 つ必要で、reference_image と + reference_video の合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1、最大 + 20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、2~10秒、 - 1辺 240~4096ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL - は受け付けられません)と、任意で0~4つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1辺 240~8000ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開 URL +- wan2.7-videoedit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、2-10 秒、 + 1辺 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で 0 から 4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 - reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15秒)、 - reference_audio(最大5クリップ、合計再生時間 \<= 15秒)、file(最大1、link - と併用不可)、link(最大1、file と併用不可)。reference_*/file/link タイプ - と first_frame/last_frame タイプは、同じリクエスト内で同時に使用できません。 - 配列の順序が、プロンプト内のアセットの参照順序(Image 1、Video 1、 - Audio 1、...)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 - 1辺 240~8000ピクセル、アスペクト比 最大 8:1、最大 20MB、公開 URL または - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: - 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記 - は最初のフレームを img_url ではなくここで受け取ります。少なくとも 300x300 ピクセル、 - アスペクト比 1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または +- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 + reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、 + reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link とは + 併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link タイプと + first_frame/last_frame タイプは同一リクエスト内で排他的です。配列の順序が + プロンプト内でのアセットの参照順(Image 1、Video 1、Audio 1、…)を定義します。 + first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1辺 240-8000 ピクセル、アスペクト比 最大 8:1、最大 20MB、公開URLまたは + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの表記 + では先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、 + アスペクト比 1:2.5 から 2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9つ。これが - このモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 - 最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video は - この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、3~60 - 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト - 比 1:2.5~2.5:1、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: - URL は受け付けられません)と、任意で0~5つの reference_image(JPEG/JPG/PNG/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比 1:2.5~2.5:1、最大 20MB、公開 URL - または data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 個。これが + このモデル唯一の参照入力です。短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 + 最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。この操作で reference_video は + 入力タイプではありません。 +- happyhorse-1.0-video-edit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、3-60 + 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5 から 2.5:1、 + 最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、 + 任意で 0 から 5 つの reference_image(JPEG/JPG/PNG/WEBP、少なくとも 300x300 ピクセル、 + アスペクト比 1:2.5 から 2.5:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。これらのパートナー向けリファレンスにはメディア入力の記載がないため、 + テキストから動画への操作。これらのパートナーのリファレンスにはメディア入力の記載がないため、 このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記向けの - メディア語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初の - フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。media には -minItems/maxItems が宣言されていません。許容される type とその上限はモデルごとに -異なるためです。スキーマが受け入れることは、プロバイダーが受け入れることを意味しません。 -逆に、上記のアセットごとの「最大 20MB」という数値(画像入力の上限であり、インラインで -送信できる唯一の入力です)は、パートナーが最終的に受け取るアセットに対する上限であり、 -アセットが公開 URL の場合はそのまま適用されます。そのバイト列は Comfy を -経由しないためです。インラインの data:\{MIME_type};base64,... -URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の -POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。また base64 は -ペイロードを約 4/3 に膨らませるため、約 75 MB を超える単一のインラインアセットは、 -ここに示したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットがパートナー自身の -20MB の上限にはインラインで余裕をもって収まるため、1 つのアセットではパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントは、これらの表記に対して + メディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを + img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの個数はこのスキーマの制約ではなくパートナーの制約です。media には +minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに異なるためです。 +スキーマが受け付けることはプロバイダーが受け付けることを意味しません。また逆方向についても、 +上記のアセットごとの「最大 20MB」という数値(画像入力の上限であり、インラインで送信できる +唯一の入力です)は、最終的に受け取るアセットに対するパートナーの上限であり、アセットが +公開URLの場合はそのまま適用されます。そのバイト列が Comfy を経由することはないためです。 +インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の上限にも +直面します。Comfy Router の POST ボディは合計で 100 MiB に制限され、超えると 413 が返され、 +また base64 はペイロードを約 4/3 に膨らませるため、約 75 MB を超える単一のインラインアセットは、 +ここに挙げたパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットは +パートナー自身の20MBの上限ならインラインで問題なく収まるため、単一のアセットではパートナーのルールが制約となります。複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 - メディアアセットのタイプ + メディアアセットの種類 - 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明で各モデルごとに列挙されているまさに IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を指定できます。これらのモデルのビデオ、オーディオ、ファイル、リンク入力はいずれもインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または (wan2.7-videoedit では) Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデル呼び出しを行い、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされない入力です。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されることなくパートナーへそのまま転送されます。モデルごとのサイズとピクセルの制限、およびインラインペイロード全体を制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明で各モデル向けに列挙されている IMAGE 入力に限り、インラインの `data:{MIME_type};base64,...` URL を使用できます。対象は wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、そして happyhorse-1.0-video-edit の reference_image です。これらのモデルの video、audio、file、link のいずれの入力もインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを合計で制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します + 逆プロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否するのではなく切り詰めます。これは prompt と同じ入力バジェットにカウントされます。 - テキストプロンプト。中国語と英語をサポートし、長さは 800 文字を超えません -(wan3.0-video では最大 20,000 文字。制限を超えた内容は切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、'character1'、'character2' などを使用して、 -参照ビデオの順序に従って被写体を参照します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' などを使用して、 -media 配列内の対応する順序でメディアアセットを参照します。 + テキストプロンプト。中国語と英語をサポートします。自身に定められた長さを超えると、wan2.x モデルは拒否するのではなくプロンプトを切り詰めます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。プロバイダーは、prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 文字の中国語)を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に対応させて「character1」「character2」などで被写体を指定します。例: "Character1 sings on the roadside, Character2 dances beside it"。wan3.0-video の参照モードでは、media 配列内の対応する順序に従って「Image 1」「Video 1」「Audio 1」などでメディアアセットを指定します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1 ~ 3 本のビデオ URL の配列です。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列です。 入力の制限: -- フォーマット: mp4、mov -- 本数: 1 ~ 3 本のビデオ -- 1 本のビデオの長さ: 2 ~ 30 秒 -- 1 ファイルのサイズ: 最大 30MB +- 形式: mp4、mov +- 数量: 1〜3 本のビデオ +- 1 本あたりの長さ: 2〜30 秒 +- 1 ファイルあたりのサイズ: 最大 30MB - audio_url と併用できません -参照の再生時間: ビデオ 1 本の場合は最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合はそれに比例して短くなります。 -課金: 実際に使用した参照再生時間に基づきます。 +参照再生時間: 1 本の場合は最大 5 秒、2 本の場合は各最大 2.5 秒、3 本の場合はそれに比例して短くなります。 +課金: 実際に使用された参照再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意です。現在サポートされているもの: squish、flying、carousel。使用した場合、prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への v1 の直接呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への v1 直接呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -315,28 +308,26 @@ media 配列内の対応する順序でメディアアセットを参照しま - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされています。その他の wan モデルについて、プロバイダーはそのような切り替えを記載していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてそのような切り替えを記載していません。 - wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto (デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します + wan2.7-videoedit モデル用のビデオオーディオ設定。 +- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 指定可能な値: `auto`, `origin` + 指定可能な値: `auto`、`origin` 生成されるビデオの再生時間(秒): - wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 +- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 - wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) -- wan2.7-i2v、wan2.7-t2v: [2, 15] の範囲の整数 -- wan2.7-r2v、wan2.7-videoedit: [2, 10] の範囲の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の範囲の整数。ビデオ入力ありの場合は - 入力ビデオの再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 は - モデルが適切な再生時間を選ぶスマート再生時間モードを有効にします -このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 +- wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 +- wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力を伴う場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、モデルが適切な再生時間を選択するスマート再生時間モードが有効になります +このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 範囲: `-1` から `30` @@ -347,57 +338,54 @@ media 配列内の対応する順序でメディアアセットを参照しま 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 +wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 +wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 - 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 取り得る値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P は非サポート) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(アップストリームのデフォルトは 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P -- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、解像度もサイズも指定していないビデオ生成リクエストを拒否します。解像度のティアが課金レートを決定するためです。チェックの前に解像度を大文字に変換し、その大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P を持たないと記載されている wan2.6、wan2.7、および happyhorse-1.0 モデルでは、480P(解像度として送信された場合も、480P のサイズとして送信された場合も)に対して 400 を返します。 - - 指定可能な値: `480P`, `720P`, `1080P` +- wan2.6 モデル (t2v、i2v、r2v): 720P、1080P のみ (480P 非サポート) +- wan2.7 モデル (i2v、t2v、r2v、videoedit): 720P、1080P (デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P (上流のデフォルトは 1080P) +- happyhorse-1.0-* (t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-* (t2v、i2v、r2v): 480P、720P、1080P +このプロキシは、resolution と size のどちらも指定されていないビデオ生成リクエストを拒否します。解像度ティアが課金レートを決定するためです。resolution はチェック前に大文字へ変換され、大文字化された値が転送されます。この enum に含まれない値には 400 を返し、480P を持たないと上記で説明されている wan2.6、wan2.7、happyhorse-1.0 の各モデルでは、480P (resolution として送信された場合も、480P の size として送信された場合も) に対して 400 を返します。 + + 取り得る値: `480P`、`720P`、`1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ動作します。 + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 wan2.6 および wan2.7-r2v モデル向け。 -- single: シングルショットビデオ(デフォルト) -- multi: マルチショットビデオ +- single: 単一ショットのビデオ (デフォルト) +- multi: マルチショットのビデオ - 指定可能な値: `multi`, `single` + 取り得る値: `multi`、`single` - width*height 形式のビデオ解像度。サポートされる解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ -wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -サイズと解像度の両方を送信した場合、課金ティアを選択するのはサイズであり、 -解像度はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P のサイズは、 -解像度の説明で 480P を持たないと記載されているすべてのモデルで 400 を返します。 + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P (480*832、832*480、624*624)、720P、1080P の各サイズ +wan2.6 T2V/R2V の場合 (480P なし): + 720P: 1280*720、720*1280、960*960、1088*832、832*1088 + 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +size と resolution の両方が送信された場合、課金ティアを選択するのは size であり、resolution はそのモデルに対してこのプロキシが受け入れる値である必要があります。480P の size は、解像度の説明で 480P を持たないと記載されているすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -`GET /v2/models/wan/wan2.6-t2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +スキーマから生成されたもので、Router は `GET /v2/models/wan/wan2.6-t2v/openapi.json` で提供し、リクエストがプロバイダーに到達する前に呼び出しを検証する際に同じドキュメントを使用します。 ### 出力 @@ -410,7 +398,7 @@ wan2.6 T2V/R2V の場合(480P なし): - オーディオ生成を伴うI2Vタスク用のオーディオURL + オーディオ生成を伴う I2V タスク用のオーディオ URL @@ -450,7 +438,7 @@ wan2.6 T2V/R2V の場合(480P なし): - 生成された画像のURLアドレス + 生成済み画像の URL アドレス @@ -462,33 +450,33 @@ wan2.6 T2V/R2V の場合(480P なし): - タスクID + タスク ID - 画像生成タスクのタスク結果統計 + 画像生成タスクのタスク結果の統計 - 失敗したタスク数 + 失敗したタスクの数 - 成功したタスク数 + 成功したタスクの数 - タスクの合計数 + タスクの総数 - タスクのステータス + タスクステータス - 取り得る値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 + 完了したビデオ生成タスクのビデオ URL。リンクの有効期間は 24 時間です @@ -500,47 +488,47 @@ wan2.6 T2V/R2V の場合(480P なし): - ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) + ビデオ解像度レベル(I2V および wan3.0-video タスク) - 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) + 生成済みビデオの再生時間(秒)(I2V および wan3.0-video タスク) - 生成されたビデオのフレームレート(wan3.0-videoタスク) + 生成済みビデオのフレームレート(wan3.0-video タスク) - 生成された画像の数(T2IおよびI2Iタスク) + 生成済み画像の数(T2I および I2I タスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) - 出力ビデオの再生時間(秒)(wan3.0-videoタスク) + 出力ビデオの再生時間(秒)(wan3.0-video タスク) - 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) + 生成済みビデオのアスペクト比。例: 16:9(wan3.0-video タスク) - 画像の解像度(T2IおよびI2Iタスク) + 画像の解像度(T2I および I2I タスク) - 生成されたビデオの数(T2Vタスク) + 生成済みビデオの数(T2V タスク) - 生成されたビデオの再生時間(秒)(T2Vタスク) + 生成済みビデオの再生時間(秒)(T2V タスク) - ビデオ解像度の比率(T2Vタスク) + ビデオの解像度比率(T2V タスク) diff --git a/ja/development/comfy-router/models/wan/wan2-7-t2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-7-t2v/code.mdx index 2efa4c720d..cd324231b0 100644 --- a/ja/development/comfy-router/models/wan/wan2-7-t2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-7-t2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Wan 2.7 T2V を使用する" description: "Comfy Router を通じて HTTP で wan/wan2.7-t2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 2.7 T2V" -translationSourceHash: ff10f4b6 +translationSourceHash: 700c3a5c translationFrom: development/comfy-router/models/wan/wan2-7-t2v/code.mdx translationBlockHashes: "_intro": 89db521b "Quick start": d9034773 - "Schema": 6e6cd92f + "Schema": ffbd0afd "Examples": 12f77722 --- + {/* 生成済みファイル。このディレクトリの code.yaml を編集して `pnpm code-pages:gen` を実行してください。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -182,72 +183,129 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-t2v/requests/$REQUEST_ID \ ### 入力 - プロンプトワードなどの基本情報を入力します。 + プロンプトなどの基本情報を入力します。 - オーディオファイルのダウンロードURL。対応形式: mp3 と wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls とは併用できません。 - 先頭フレームの画像URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の表記はここでは先頭フレームを受け取りません。先頭フレームは type が first_frame の media 要素として渡します(後述の media を参照)。また、wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v および happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 系の表記も参照アセットは media で渡します。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360~2000 ピクセル。ファイルサイズ: 最大 10MB。 + 最初のフレーム画像のURLまたはBase64エンコードされたデータ。wan2.5-i2v-preview および +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、ここで最初のフレームを +受け取りません。タイプ first_frame の media 要素として受け取ります(下記の media を参照)。 +また、wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v と +happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 の表記も、参照アセットを +media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360〜2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type フィールドと url フィールドを持ちます。このフィールドはこのコンポーネントから提供されるすべてのモデルで共有されますが、特定のモデルがどの type 値を受け付けるか、またそもそも画像やビデオの入力を img_url や reference_video_urls ではなくここで渡すかどうかは、モデルごとに異なります。モデルごとの対応 type 値は次のとおりです。 -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、各辺 240~8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2~30 秒、最大 15MB)と first_clip(MP4/MOV、2~10 秒、各辺 240~4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。reference_image または reference_video のうち少なくとも 1 つが必要で、reference_image と reference_video の合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、各辺 240~8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、2~10 秒、各辺 240~4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0~4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、各辺 240~8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video, wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link とは併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは同じリクエスト内では同時に使用できません。配列の順序がプロンプト内のアセットの参照順序を定義します(Image 1、Video 1、Audio 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、各辺 240~8000 ピクセル、アスペクト比最大 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの表記は先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image のみ、1~9 個。これはこのモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、3~60 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0~5 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: テキストから動画への操作です。これらのパートナー参照ドキュメントにはメディア入力が記載されていないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: このコンポーネントはこれらの表記に対してメディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。許容されるタイプとその上限がモデルごとに異なるため、media には minItems/maxItems が宣言されていません。スキーマが受け付けることはプロバイダーが受け付けることを意味しません。逆に、上記のアセットごとの「最大 20MB」という数値(画像入力の上限であり、インラインで送信できる唯一の入力です)は、パートナーが最終的に受け取るアセットに対する上限であり、アセットが公開 URL である場合はそのまま適用されます。そのバイトは Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送の上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。また base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに示したパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限はインラインに余裕で収まるため、1 つのアセットについてはパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となり、これは 100 MiB の Router 上限が各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべて公開 URL として送信してください。 + メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素には type フィールドと url フィールドが含まれます。このフィールドは、この +コンポーネントで提供されるすべてのモデルで共有され、特定のモデルが受け入れる type 値、 +および画像またはビデオの入力を img_url や reference_video_urls ではなく、そもそもここで +受け取るかどうかは、モデルによって異なります。モデルごとの対応 type 値: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と + last_frame: JPEG/JPG/PNG/BMP/WEBP、各辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、 + 最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2〜30 秒、最大 15MB)と first_clip(MP4/MOV、2〜10 秒、 + 各辺 240〜4096 ピクセル、最大 100MB): パブリック HTTP/HTTPS URL。インラインの + data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。 + 少なくとも 1 つの reference_image または reference_video が必要で、reference_image と + reference_video の合計は最大 5 です。first_frame と reference_image: + JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、各辺 240〜8000 ピクセル、 + アスペクト比 1:8〜8:1、最大 20MB、パブリック URL または + data:\{MIME_type};base64,... URL。reference_video: パブリック HTTP/HTTPS URL。 + インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(正確に 1 つ。編集対象のクリップ: MP4/MOV、2〜10 秒、 + 各辺 240〜4096 ピクセル、最大 100MB、パブリック HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)と、任意で 0〜4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 各辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、パブリック URL または + data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 + reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、 + reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link とは + 併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link タイプと + first_frame/last_frame タイプは、同じリクエスト内では同時に使用できません。配列の順序が、 + プロンプト内のアセットの参照順序(Image 1、Video 1、Audio 1、...)を定義します。 + first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、各辺 240〜8000 + ピクセル、アスペクト比は最大 8:1、最大 20MB、パブリック URL または + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: + パブリック HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、正確に 1 つ。これらの表記では + 最初のフレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 + ピクセル、アスペクト比 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、パブリック URL + または data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9 個。これはこの + モデル唯一の参照入力です。最短辺は少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 + 最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。reference_video は + この操作の入力タイプではありません。 +- happyhorse-1.0-video-edit: video(正確に 1 つ。編集対象のクリップ: MP4/MOV、3〜60 秒、 + 長辺は最大 4096 ピクセル、短辺は少なくとも 360 ピクセル、アスペクト比 + 1:2.5〜2.5:1、最大 100MB、パブリック HTTP/HTTPS URL。インラインの data: URL は + 受け付けられません)と、任意で 0〜5 個の reference_image(JPEG/JPG/PNG/WEBP、 + 少なくとも 300x300 ピクセル、アスペクト比 1:2.5〜2.5:1、最大 20MB、パブリック URL + または data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: + テキストから動画への操作。これらのパートナーのリファレンスには media 入力の記載が + ないため、このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対する + media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初のフレームを + img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの件数はパートナーの制約であり、このスキーマの制約ではありません。 +media には minItems/maxItems が宣言されていません。許容されるタイプとその上限は +モデルごとに異なるためです。スキーマが受け入れることは、プロバイダーが受け入れることを +意味しません。また、逆に、上記のアセットごとの「最大 20MB」という数値(画像入力に対する +上限であり、インラインで送信できる唯一の入力です)は、最終的にパートナーが扱うアセットに +対するパートナーの上限であり、アセットがパブリック URL の場合は記載どおりに適用されます。 +そのバイト列は Comfy を経由しないためです。インラインの +data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。 +Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。 +また、base64 はペイロードを約 4/3 に膨らませるため、約 75 MB を超える単一の +インラインアセットは、ここに記載されたパートナーのルールに到達する前に拒否されます。 +そのサイズでは、単一のアセットはパートナー自身の20MB の上限はインラインで余裕を持って収まるため、1 つのアセットについてはパートナーのルールが制約となります。転送の上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 - メディアアセットのタイプ + メディアアセットの種類 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL: 公開 HTTP/HTTPS URL、または、上記の `media` の説明がモデルごとに挙げているまさにその画像入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL です。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデル呼び出しを行い、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されることなく、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明が各モデルについて列挙している IMAGE 入力に限り、インラインの `data:{MIME_type};base64,...` URL。IMAGE 入力とは、wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、そして happyhorse-1.0-video-edit の reference_image です。これらのモデルのビデオ、オーディオ、ファイル、リンク入力はいずれもインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - 逆プロンプトの単語は、ビデオ画面に表示したくないコンテンツを記述するために使用されます + ネガティブプロンプト(逆方向のプロンプト語)は、ビデオ画面に映したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り詰めます。これは prompt と同じ入力予算に計上されます。 - テキストプロンプトの単語。中国語と英語をサポートし、長さは 800 文字を超えないこと -(wan3.0-video では最大 20,000 文字。制限を超えるコンテンツは切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に従って被写体を指すために 'character1'、'character2' などを使用します。 -例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを指すために -'Image 1'、'Video 1'、'Audio 1' などを使用します。 + テキストプロンプト語。中国語と英語をサポートします。文書化された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り詰めます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。プロバイダーは、prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(中国語で約 20,000 文字)を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に従って被写体を参照するために「character1」「character2」などを使用してください。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の参照モードでは、media 配列内の対応する順序に従ってメディアアセットを参照するために「Image 1」「Video 1」「Audio 1」などを使用してください。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 個のビデオ URL の配列。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列。 入力の制限: -- フォーマット: mp4、mov -- 数量: 1~3 本のビデオ -- 単一ビデオの長さ: 2~30 秒 -- 単一ファイルサイズ: 最大 30MB +- 形式: mp4、mov +- 数量: 1〜3 本のビデオ +- 1 本あたりのビデオの長さ: 2〜30 秒 +- 1 ファイルあたりのファイルサイズ: 最大 30MB - audio_url と併用できません -参照の再生時間: 単一ビデオは最大 5 秒、2 本のビデオはそれぞれ最大 2.5 秒、3 本のビデオはそれに比例して短くなります。 -課金: 使用した実際の参照再生時間に基づきます。 +参照の再生時間: ビデオ 1 本なら最大 5 秒、2 本なら各最大 2.5 秒、3 本ならそれぞれ比例して短くなります。 +課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しではこれを必ず指定する必要があり、受け付けられる表記の列挙は、その操作自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -255,12 +313,12 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルについては、プロバイダーはそのような切り替えを文書化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてはそのような切り替えを記載していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します +- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: `auto`、`origin` @@ -270,39 +328,38 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で 生成されるビデオの再生時間(秒): - wan2.5 モデル: 5 秒または 10 秒 - wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 -- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒はサポートされません) +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は、入力ビデオの - 再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、 - モデルが適切な再生時間を選択するスマート再生時間モードが有効になります +- wan3.0-video: ビデオ入力なしなら [2, 30] の整数、ビデオ入力ありの場合は入力ビデオの + 再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると + モデルが適切な再生時間を選ぶスマート再生時間モードが有効になります このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 範囲: `-1` から `30` - プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です + プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true - 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合、解像度のティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 + 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 +wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 +wan3.0-video では、adaptive(デフォルト)が適切なものを自動的に推奨しますaspect ratio based on the input media proportions and intent. - 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルトは 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (アップストリームのデフォルトは 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -このプロキシは、解像度も size も指定していないビデオ生成リクエストを拒否します。解像度のティアが課金レートを選択するためです。プロキシはチェックの前に解像度を大文字に変換し、その大文字に変換した値を転送します。この enum に含まれない値には 400 を返し、480P に対しては(resolution として送信された場合でも 480P の size として送信された場合でも)上記で 480P 非対応として記載されている wan2.6、wan2.7、happyhorse-1.0 モデルで 400 を返します。 +- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P 非対応) +- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(アップストリームのデフォルトは 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。解像度ティアが課金レートを決めるためです。resolution はチェックの前に大文字化され、大文字化された値がそのまま転送されます。この enum に含まれない値には 400 を返し、上記で 480P 非対応とされている wan2.6、wan2.7、happyhorse-1.0 モデルでは、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 指定可能な値: `480P`, `720P`, `1080P` @@ -310,32 +367,32 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 - 範囲: `0` から `2147483647` + 範囲: `0` から `2147483647` まで - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデル用。 -- single: シングルショットビデオ(デフォルト) -- multi: マルチショットビデオ + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ動作します。 +wan2.6 および wan2.7-r2v モデル用です。 +- single: 単一ショットのビデオ(デフォルト) +- multi: マルチショットのビデオ 指定可能な値: `multi`, `single` - width*height 形式のビデオ解像度。対応する解像度はモデルによって異なります: + width*height 形式で指定するビデオ解像度。サポートされる解像度はモデルによって異なります: wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ wan2.6 T2V/R2V の場合(480P なし): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size と解像度の両方を送信した場合、課金ティアを選択するのは size であり、解像度はそのモデルに対してこのプロキシが受け入れる値である必要があります。480P の size は、解像度の説明で 480P 非対応と記載されているすべてのモデルで 400 を返します。 +size と resolution の両方を送信した場合、課金ティアは size で決まり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、resolution の説明で 480P 非対応と記載されているすべてのモデルで 400 を返します。 ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -Router が `GET /v2/models/wan/wan2.7-t2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 +`GET /v2/models/wan/wan2.7-t2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。 ### 出力 @@ -348,7 +405,7 @@ Router が `GET /v2/models/wan/wan2.7-t2v/openapi.json` で提供するスキー - 音声生成を伴う I2V タスクのオーディオ URL + 音声生成を伴うI2VタスクのオーディオURL @@ -356,7 +413,7 @@ Router が `GET /v2/models/wan/wan2.7-t2v/openapi.json` で提供するスキー - タスクの完了時刻 + タスク完了時間 @@ -388,15 +445,15 @@ Router が `GET /v2/models/wan/wan2.7-t2v/openapi.json` で提供するスキー - 生成された画像のURLアドレス + 生成済み画像のURLアドレス - タスクの実行時間 + タスク実行時間 - タスクの送信時刻 + タスク送信時間 @@ -416,17 +473,17 @@ Router が `GET /v2/models/wan/wan2.7-t2v/openapi.json` で提供するスキー - タスクの総数 + タスクの合計数 タスクステータス - 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 取り得る値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` - 完了したビデオ生成タスクのビデオ URL。リンクの有効期間は24時間 + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 @@ -434,59 +491,59 @@ Router が `GET /v2/models/wan/wan2.7-t2v/openapi.json` で提供するスキー - 出力情報の統計。成功した結果のみが集計されます + 出力情報の統計。成功した結果のみがカウントされます - ビデオの解像度レベル(I2V および wan3.0-video タスク) + ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) - 生成されたビデオの再生時間(秒)(I2V および wan3.0-video タスク) + 生成済みビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-video タスク) + 生成済みビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2I および I2I タスク) + 生成済み画像の数(T2IおよびI2Iタスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間(秒)(wan3.0-video タスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) - 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-video タスク) + 生成済みビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) - 画像の解像度(T2I および I2I タスク) + 画像解像度(T2IおよびI2Iタスク) - 生成されたビデオの数(T2V タスク) + 生成済みビデオの数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2V タスク) + 生成済みビデオの再生時間(秒)(T2Vタスク) - ビデオの解像度比率(T2V タスク) + ビデオ解像度の比率(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx b/ja/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx index c04d75327d..37a12e2c7f 100644 --- a/ja/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Wan 2.7 Video Edit を使用する" description: "Comfy Router 経由で HTTP を使って wan/wan2.7-videoedit を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 2.7 Video Edit" -translationSourceHash: 11c6064b +translationSourceHash: b970d117 translationFrom: development/comfy-router/models/wan/wan2-7-videoedit/code.mdx translationBlockHashes: "_intro": 164c9f6a "Quick start": ec8ca64c - "Schema": b7895256 + "Schema": cff0bda0 "Examples": 622d1416 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -210,36 +211,29 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-videoedit/requests/$REQUEST_ID \ - 音声ファイルのダウンロード URL。対応形式: mp3 と wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式:mp3、wav。reference_video_urls と併用できません。 - 最初のフレーム画像の URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview と -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の名称は、最初のフレームを -ここでは受け取りません。type が first_frame の media 要素として受け取ります(後述の -media を参照)。また、wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v と -happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 系の名称も参照アセットを -media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 + 最初のフレーム画像のURLまたはBase64エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、ここで最初のフレームを受け取りません。最初のフレームは type が first_frame の media 要素として受け取ります(後述の media を参照)。また、wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーによって拒否されます。wan2.7/wan3.0 系の表記も参照アセットを media で受け取ります。画像形式:JPEG、JPG、PNG、BMP、WEBP。解像度:360~2000ピクセル。ファイルサイズ:最大10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type と url のフィールドを持ちます。このフィールドは本コンポーネントから提供されるすべてのモデルで共通であり、どのモデルがどの type 値を受け付けるか、またそもそも画像やビデオの入力を img_url や reference_video_urls ではなくここで持つかどうかは、モデルによって異なります。モデルごとの対応 type 値: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、各辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 秒、各辺 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。reference_image または reference_video が少なくとも 1 つ必要で、reference_image と reference_video は合計で最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、各辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(正確に 1 つ、編集対象のクリップ: MP4/MOV、2-10 秒、各辺 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0 から 4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、各辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link とは併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは、同一リクエスト内では相互に排他的です。配列の順序が、プロンプト内のアセットの参照順序を定義します(Image 1、Video 1、Audio 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、各辺 240-8000 ピクセル、アスペクト比は最大 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、正確に 1 つ。これらの名称は最初のフレームを img_url ではなくここで受け取ります。少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 つ。これはこのモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(正確に 1 つ、編集対象のクリップ: MP4/MOV、3-60 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5 から 2.5:1、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0 から 5 つの reference_image(JPEG/JPG/PNG/WEBP、少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作です。これらのパートナーリファレンスには media 入力の記載がないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: 本コンポーネントは、これらの名称に対する media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初のフレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの件数は本スキーマの制約ではなくパートナーの制約です。media には minItems/maxItems が宣言されていません。許容されるタイプとその上限がモデルごとに異なるためです。スキーマが受理しても、プロバイダーが受理するとは限りません。逆に、上記のアセットごとの「最大 20MB」という数値(画像入力の上限であり、インラインで送信できる唯一の入力です)は、最終的にパートナーが受け取るアセットに対するパートナーの上限であり、アセットが公開 URL の場合はそのまま適用されます。そのバイト列は Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。また base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに示したパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MBの上限はインラインで問題なく収まるため、単一のアセットではパートナーのルールが制約となります。 -トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiBのRouter上限は -各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、すべてパブリック -URLとして送信してください。 + メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素には type フィールドと url フィールドが含まれます。このフィールドはこのコンポーネントから提供されるすべてのモデルで共有されますが、どの type 値を受け付けるか、また画像やビデオの入力を img_url や reference_video_urls ではなくそもそもここで受け取るかどうかは、モデルによって異なります。モデルごとの対応 type 値は次のとおりです: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame:JPEG/JPG/PNG/BMP/WEBP、各辺240~8000ピクセル、アスペクト比1:8~8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2~30秒、最大15MB)と first_clip(MP4/MOV、2~10秒、各辺240~4096ピクセル、最大100MB):公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。reference_image または reference_video が少なくとも1つ必要で、参照画像と参照ビデオの合計は最大5つです。first_frame と reference_image:JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、各辺240~8000ピクセル、アスペクト比1:8~8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video:公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ:MP4/MOV、2~10秒、各辺240~4096ピクセル、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で0~4個の reference_image(JPEG/JPG/PNG/BMP/WEBP、各辺240~8000ピクセル、アスペクト比1:8~8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL)。 +- wan3.0-video, wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15s)、reference_audio(最大5クリップ、合計再生時間 \<= 15s)、file(最大1、link と併用不可)、link(最大1、file と併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは同じリクエスト内では同時に使用できません。配列の順序が、プロンプト内のアセットの参照順序(Image 1、Video 1、Audio 1、...)を定義します。first_frame、last_frame、reference_image:JPEG/JPG/PNG/BMP/WEBP、各辺240~8000ピクセル、アスペクト比は最大8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link:公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記では最初のフレームをここで受け取り、img_url では受け取りません。最低300x300ピクセル、アスペクト比1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image のみ、1~9個。これはモデルの唯一の参照入力です。最短辺は最低400ピクセル、JPEG/JPG/PNG/WEBP、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。この操作で reference_video は入力 type ではありません。 +- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ:MP4/MOV、3~60秒、長辺は最大4096ピクセル、短辺は最低360ピクセル、アスペクト比1:2.5~2.5:1、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で0~5個の reference_image(JPEG/JPG/PNG/WEBP、最低300x300ピクセル、アスペクト比1:2.5~2.5:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: テキストから動画への操作。これらのパートナーリファレンスには media 入力の記載がないため、このフィールドは未設定のままにします。 +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: このコンポーネントはこれらの表記向けの media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初のフレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 + +上記のモデルごとの件数はこのスキーマの制約ではなくパートナーの制約です。media には minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに異なるためです。スキーマが受け入れることはプロバイダーが受け入れることを意味しません。逆に、上記のアセットごとの「最大20MB」という数値は、画像入力(インラインで送信できる唯一の入力)に対する上限であり、パートナーが最終的に受け取るアセットに対する上限です。アセットが公開URLの場合は記載どおりに適用されます。そのバイト列はComfyを経由しないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の POST ボディは合計100 MiBに制限され、超えると413が返されます。また base64 はペイロードを約4/3に膨らませるため、約75 MBを超える単一のインラインアセットは、ここに記載したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の +20MB の上限はインラインで余裕を持って収まるため、1 つのアセットについてはパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべて公開 URL として送信してください。 メディアアセットのタイプ @@ -247,40 +241,35 @@ URLとして送信してください。 - メディアファイルのURL。パブリックなHTTP/HTTPS URL、または(上記の`media`の説明が各モデルについて列挙しているまさにIMAGE入力、すなわちwan2.7-i2vのfirst_frameとlast_frame、wan2.7-r2vのfirst_frameとreference_image、wan2.7-videoeditのreference_image、wan3.0-videoとwan3.0-video-primeのfirst_frame、last_frame、reference_image、happyhorse-1.0-i2vとhappyhorse-1.1-i2vのfirst_frame、happyhorse-1.0-r2vとhappyhorse-1.1-r2vのreference_image、そしてhappyhorse-1.0-video-editのreference_imageに限り)インラインの`data:{MIME_type};base64,...` URLです。これらのモデルのいずれにおいても、video、audio、file、linkの入力はインラインのdata: URLを受け付けません。パートナー自身のアップロードサービスから得られるoss://dashscope-instantの一時URL、または(wan2.7-videoeditでは)Asset Centerのasset_idは、それをアップロードしたAlibaba Cloudアカウントに対してのみ解決されます。Comfyは自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身のoss:// URLやasset_idはサポートされた入力ではありません。このフィールドはURLスキームを検証しないため、そのような値はここで拒否されることなく、そのままパートナーに転送されます。モデルごとのサイズとピクセル制限、およびインラインのペイロードを合計で制限する100 MiBのRouterリクエストボディ上限については、`media`の説明を参照してください。 + メディアファイルの URL: 公開 HTTP/HTTPS URL、または、上記の `media` の説明で各モデルに対して列挙されている IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデル呼び出しを行い、アップロード経路を公開しないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーに転送されます。各モデルのサイズとピクセル制限、およびインラインペイロードを合計で制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプト語は、ビデオ画面に表示したくないコンテンツを記述するために使用します + ネガティブプロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これは prompt と同じ入力予算に計上されます。 - テキストプロンプト語。中国語と英語をサポートし、長さは800文字以内です -(wan3.0-videoでは最大20,000文字。制限を超えたコンテンツは切り捨てられます)。 -複数の参照ビデオを使用するwan2.6-r2vでは、参照ビデオの順序に従って被写体を参照するために -「character1」「character2」などを使用します。例:「Character1 sings on the roadside, Character2 dances beside it」 -wan3.0-videoの参照モードでは、media配列内の対応する順序でメディアアセットを参照するために -「Image 1」「Video 1」「Audio 1」などを使用します。 + テキストプロンプトの語句。中国語と英語をサポートします。文書化された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。プロバイダーは、prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 中国語文字)を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。複数の参照ビデオを使用する wan2.6-r2v では、参照ビデオの順序に従って被写体を指すために 'character1'、'character2' などを使用します。例: "Character1 sings on the roadside, Character2 dances beside it"。wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを指すために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 - wan2.6-r2vモデル専用の参照ビデオURL。1-3本のビデオURLの配列。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列です。 入力の制限: -- フォーマット: mp4, mov -- 数量: 1-3本のビデオ -- 単一ビデオの長さ: 2-30秒 -- 単一ファイルサイズ: 最大30MB -- audio_urlとは併用できません -参照の長さ: 単一ビデオは最大5秒、2本のビデオはそれぞれ最大2.5秒、3本のビデオはそれに比例して短くなります。 -課金: 実際に使用された参照の長さに基づきます。 +- 形式: mp4、mov +- 数量: 1〜3 本のビデオ +- 単一ビデオの長さ: 2〜30 秒 +- 単一ファイルサイズ: 最大 30MB +- audio_url と併用できません +参照の再生時間: 単一ビデオは最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合は比例して短くなります。 +課金: 実際に使用された参照の再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされている値: squish, flying, carousel。使用した場合、promptパラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 - 呼び出すモデルのID。このコンポーネントでは制約されません。Comfy Routerは`POST /v2/models/wan/{model}`の`{model}`パスセグメントからこれを埋めるため、Routerの呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`への直接のv1呼び出しでは必ず指定する必要があり、受け付けられる表記のenumはそのオペレーション自身のコンポーネント`WanVideoGenerationRequest`にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -288,86 +277,86 @@ wan3.0-videoの参照モードでは、media配列内の対応する順序でメ - ビデオにオーディオを追加するかどうか。wan3.0-videoとwan3.0-video-primeでのみサポートされます。他のwanモデルについては、プロバイダーはそのような切り替えを文書化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてそのような切り替えを文書化していません。 - wan2.7-videoeditモデルのビデオオーディオ設定。 -- auto (デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します -- origin: 入力ビデオのオリジナルオーディオを強制的に保持します + wan2.7-videoedit モデルのビデオオーディオ設定。 +- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します +- origin: 入力ビデオの元のオーディオを強制的に保持します 指定可能な値: `auto`, `origin` - 生成されるビデオの再生時間(秒): -- wan2.5モデル: 5秒または10秒 -- wan2.6-t2v、wan2.6-i2v: 5秒、10秒、または15秒 -- wan2.6-r2v: 5秒または10秒のみ(15秒はサポートされません) -- wan2.7-i2v、wan2.7-t2v: [2, 15]の整数 -- wan2.7-r2v、wan2.7-videoedit: [2, 10]の整数 -- wan3.0-video: ビデオ入力なしの場合は[2, 30]の整数。ビデオ入力ありの場合は、入力ビデオの再生時間 + - 出力ビデオの再生時間の合計が30秒を超えてはなりません。-1は、 - モデルが適切な再生時間を選択するスマート再生時間モードを有効にします -このプロキシは[-1, 30]の範囲外の再生時間に対して400を返します。 - - 範囲: `-1` から `30` まで + 生成されるビデオの長さ(秒): +- wan2.5 モデル: 5 秒または 10 秒 +- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) +- wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 +- wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力を伴う場合、入力ビデオの合計再生時間 + 出力ビデオの再生時間は 30 秒を超えてはなりません。-1 はモデルが適切な再生時間を選ぶスマート再生時間モードを有効にします +このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 + + 範囲: `-1` から `30` - プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトはtrueです + プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です - 生成されるビデオのアスペクト比。wan2.7およびwan3.0モデル専用です。 -wan2.7モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 -wan3.0-videoでは、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 + 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 +wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが設定されます。 +wan3.0-video では、adaptive(デフォルト)が適切なものを自動的に推奨します入力メディアの比率と意図に基づくアスペクト比。 - 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: -- wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6モデル(t2v、i2v、r2v): 720P, 1080Pのみ(480Pはサポートされません) -- wan2.7モデル(i2v、t2v、r2v、videoedit): 720P, 1080P(デフォルトは1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上流のデフォルトは 1080P) -- happyhorse-1.0-*(t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-*(t2v, i2v, r2v): 480P, 720P, 1080P -このプロキシは、resolution と size のどちらも指定されていないビデオ生成リクエストを拒否します。解像度のティアが課金レートを決定するためです。チェックの前に resolution を大文字化し、大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P を持たないものとして記載されている wan2.6、wan2.7、happyhorse-1.0 のモデルに対しては、480P(resolution として送信された場合でも、480P の size として送信された場合でも)に 400 を返します。 - - 指定可能な値: `480P`, `720P`, `1080P` +- wan2.5-i2v-preview: 480P、720P、1080P +- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P 非対応) +- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P +このプロキシは、resolution と size のどちらも指定されていないビデオ生成リクエストを拒否します。解像度のティアが課金レートを決めるためです。チェックの前に resolution を大文字化して転送し、この enum にない値には 400 を返します。また、上記で 480P 非対応と記載した wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P に対して 400 を返します(resolution として送信した場合も、480P の size として送信した場合も同様です)。 + + 指定可能な値: `480P`、`720P`、`1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 - 範囲: `0` ~ `2147483647` + 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。wan2.6 および wan2.7-r2v モデル用です。 -- single: 単一ショットのビデオ(デフォルト) -- multi: マルチショットのビデオ + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 +wan2.6 および wan2.7-r2v モデル向け。 +- single: シングルショットビデオ(デフォルト) +- multi: マルチショットビデオ - 指定可能な値: `multi`, `single` + 指定可能な値: `multi`、`single` - width*height 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832, 832*480, 624*624)、720P、1080P の各サイズ + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size と resolution の両方を送信した場合、課金ティアを選択するのは size であり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、resolution の説明で 480P なしと記載されているすべてのモデルで 400 を返します。 + 720P: 1280*720、720*1280、960*960、1088*832、832*1088 + 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +size と resolution の両方を送信した場合、課金ティアを決めるのは size であり、 +resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、 +解像度の説明で 480P 非対応と記載されているすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -Router が `GET /v2/models/wan/wan2.7-videoedit/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となる同一のドキュメントです。 +`GET /v2/models/wan/wan2.7-videoedit/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 @@ -376,11 +365,11 @@ Router が `GET /v2/models/wan/wan2.7-videoedit/openapi.json` で提供するス - インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用) + インテリジェントな書き換え後の実際のプロンプト(ビデオタスク向け) - 音声生成を伴うI2Vタスク用のオーディオURL + オーディオ生成を伴うI2VタスクのオーディオURL @@ -388,15 +377,15 @@ Router が `GET /v2/models/wan/wan2.7-videoedit/openapi.json` で提供するス - タスク完了時間 + タスクの完了時間 - 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) - オリジナルの入力プロンプト(ビデオタスク用) + オリジナルの入力プロンプト(ビデオタスク向け) @@ -404,7 +393,7 @@ Router が `GET /v2/models/wan/wan2.7-videoedit/openapi.json` で提供するス - インテリジェントな書き換え後の実際のプロンプト(有効になっている場合) + インテリジェントな書き換え後の実際のプロンプト(有効な場合) @@ -452,13 +441,13 @@ Router が `GET /v2/models/wan/wan2.7-videoedit/openapi.json` で提供するス - タスクのステータス + タスクステータス - 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期限は24時間です + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です @@ -466,7 +455,7 @@ Router が `GET /v2/models/wan/wan2.7-videoedit/openapi.json` で提供するス - 出力情報の統計。成功した結果のみが集計されます + 出力情報の統計。成功した結果のみがカウントされます @@ -514,11 +503,11 @@ Router が `GET /v2/models/wan/wan2.7-videoedit/openapi.json` で提供するス - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのROOTで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 + 失敗したリクエストに関する詳細情報。`output` の下ではなく、エンベロープのROOTで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、この値を確認してください。 ## 例 diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index 0438383b30..9d49a61c07 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API リファレンス" description: "Comfy API 契約から生成済みの、Comfy Router のすべてのエンドポイント、パラメータ、レスポンスボディ、エラーバケット。" sidebarTitle: "API リファレンス" -translationSourceHash: e2c5f523 +translationSourceHash: f49adc91 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 @@ -12,7 +12,7 @@ translationBlockHashes: "Pre-flight cost estimates": 7405db0d "Result assets": 3520a8bf "Per-model input and output schemas": 61c6bde8 - "Schemas": 663ae766 + "Schemas": 9738e3aa --- @@ -29,6 +29,7 @@ translationBlockHashes: + {/* 生成済みファイル: 手動で編集しないでください。 @@ -1102,12 +1103,12 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 ### RouterBilledWorkspace -拒否された呼び出しが請求しようとしていたウォレットで、`RouterErrorResponse.billed_workspace` に含まれます。「どのウォレットが空なのか?」に答えるものです。呼び出し元の UI で現在選択済みのワークスペースとは限らず、チームメンバーが個人の認証情報を使っている場合は、資金のあるチームが開かれていてもここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と一緒にのみ存在します。 +拒否された呼び出しが課金対象としていたウォレット。`RouterErrorResponse.billed_workspace` 上に現れます。「どのウォレットが空なのか」に答えるものであり、呼び出し元の UI で現在選択済みのワークスペースとは限りません。また、チームメンバーが個人の資格情報を使っている場合、資金のあるチームが開かれていても、ここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と同時にのみ存在します。 **フィールド** - クラウドのワークスペース ID。レガシーレールでは存在しません。 + クラウドのワークスペース id。レガシーレールでは存在しません。 @@ -1115,121 +1116,120 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - 呼び出しがクラウドワークスペースではなく、呼び出し元のワークスペース以前の Metronome 顧客に請求する場合は `legacy`。その顧客にはワークスペース ID がありません。クラウドワークスペースの場合は存在しません。 + 呼び出しがクラウドのワークスペースではなく、呼び出し元のワークスペース導入以前の Metronome 顧客に課金される場合は `legacy`。その顧客にはワークスペース id がありません。クラウドのワークスペースの場合は存在しません。 ### RouterChargesOnPolicyRejection -コンテンツポリシーによる拒否がこのモデルで課金されるかどうか。不明な値は課金される可能性があるものとして扱ってください。 +このモデルでコンテンツポリシーによる拒否が課金対象になるかどうか。不明な値は課金対象となる可能性があるものとして扱います。 型: `string` ### RouterCostEstimate -この呼び出しにかかるコストを、ディスパッチ前に Comfy の標準リスト価格で、または、ベンダーが報告するコストで課金されるモデルの場合はベンダーの公開価格表に基づいて算出した、米ドル建ての事前見積もりです。このベンダー報告のケースでは、`source: exact` が返されるのは、オプトインした少数のモデルに対してのみであり、かつ、公開価格表がその金額を完全に決定できる場合に限られます(価格を左右するすべてのフィールドが明示されているか、金額を変え得ないデフォルトのままである場合)。それ以外のベンダー報告の見積もりは、価格表で完全に決定できるものを含め、すべて `estimated` です。いずれの場合も、実行が完了した後はベンダーが報告する金額が請求され、見積もり額がそのまま請求されることはありません。契約料金や顧客固有の料金は反映されません。価格交渉を行っているワークスペースにはリスト価格が見積もられ、契約料金が請求されます。その場合の `source: exact` はリスト価格に対して正確という意味であり、そのワークスペースへの請求額が正確という意味ではありません。これは最終請求額ではありません。実際に支払うのは、ワークスペースの使用状況と請求記録にある確定した請求額です。実行後に報告される `X-Comfy-Credits-Used` は、事後に丸められた数値であり、領収書ではありません。`source` は、この数値をどの程度信頼できるかを示します。`exact` は `amount` を持ちます。`free` は `amount` "0" を持ちます(レートカードではこのリクエストの価格がゼロになります)。`estimated` は `min_amount` と `max_amount` を持ち、`amount` は持ちません。`unknown` はどちらも持たず、`reason` を持ちます。`amount` がないことを無料と解釈しないでください。価格の固定ではありません。`pricing_as_of` を参照してください。 +この呼び出しにかかるコストを米ドルで事前に見積もったものです。ディスパッチ前に Comfy の標準リスト価格で価格設定されます。ただし、ベンダーが報告するコストで課金されるモデルの場合は、ベンダーの公開価格リストから価格設定されます。このベンダー報告のケースでは、`source: exact` が返されるのは、オプトインした少数のモデルのみであり、かつ公開価格リストが金額を完全に決定できる場合(価格を左右するすべてのフィールドが明示されているか、金額を変え得ないデフォルトのままである場合)に限られます。それ以外のベンダー報告の見積もりは、リストから完全に決定できるものを含め、すべて `estimated` です。いずれの場合も、実行は完了後にベンダーが報告する金額で課金され、見積もり額がそのまま請求されることはありません。契約料率や顧客固有の料率は反映されません。交渉済みの価格設定があるワークスペースは、リスト価格で見積もられ、契約料率で課金されます。その場合の `source: exact` はリスト価格において正確であることを意味し、そのワークスペースの請求額が正確であることを意味するものではありません。最終的な請求額ではありません。実際に支払うのは、ワークスペースの使用量および請求記録にある確定額です。実行後に報告される `X-Comfy-Credits-Used` は丸められた事後的な数値であり、領収書ではありません。`source` はその数値をどこまで信頼できるかを示します。`exact` は `amount` を持ち、`free` は `amount` が「0」で(このリクエストはレートカード上ゼロと価格設定されています)、`estimated` は `min_amount` と `max_amount` を持ち `amount` を持たず、`unknown` はいずれも持たず `reason` を持ちます。`amount` がないことを無料と解釈してはいけません。価格の固定ではありません。`pricing_as_of` を参照してください。 **フィールド** - `exact` | `estimated` | `free` | `unknown`。その他の値は `unknown` として扱います。`exact` と `estimated` はどちらも見積もりを示すもので、どちらも最終請求額ではありません。`free` はレートカードがこのリクエストをゼロと価格設定していることを意味するため、`amount` は "0" です。`unknown` は数値を持ちません。 + `exact` | `estimated` | `free` | `unknown`。これ以外の値は `unknown` として扱ってください。`exact` と `estimated` はいずれも見積もりを表すラベルであり、どちらも最終的な請求額ではありません。`free` はこのリクエストがレートカード上ゼロと価格設定されていることを意味するため、`amount` は「0」です。`unknown` は数値を持ちません。 - 常に `USD`。 + 常に `USD` です。 - 推定コストをドル建ての小数文字列で表したもの(例: "0.04")。最大 8 桁の小数部を持ち、指数表記は使用しません。課金対象の 1 セント未満の価格が "0" として表示されることはなく、"0" になるのは `free` の見積もりだけです。`source` が `exact` または `free` の場合にのみ存在します。最終請求額ではありません。最終的な請求額は、ワークスペースの使用量と請求記録にある確定請求額です。 + 推定コストをドルで表した10進文字列です(例: "0.04")。最大8桁の小数で、指数表記はありません。課金対象の1セント未満の価格が「0」と表示されることはなく、「0」と表示されるのは `free` の見積もりだけです。`source` が `exact` または `free` の場合にのみ存在します。最終的な請求額ではありません。ワークスペースの使用量および請求記録にある確定額が最終的な請求額です。 - 見積もりの下限をドル建ての小数文字列で表したものです。これは見積もりであり、保証された下限ではありません。たとえば、プロバイダーがリクエストした量より少ない結果を返した場合(画像がない場合など)、見積もりが過去の呼び出しから学習した典型的な価格である場合、またはリクエスト量に対して価格が一定に上昇しない場合には、請求額がこれより少なくなることがあります。`source` が `estimated` の場合にのみ存在します。 + 見積もりの下限をドルで表した10進文字列です。これは見積もりであり、保証された下限ではありません。たとえば、プロバイダーがリクエストより少ない結果を返した場合(画像が0枚など)、見積もりが過去の呼び出しから学習した典型的な価格である場合、または価格がリクエスト量に対して安定的に上昇しない場合には、実際の請求額がこれより少なくなることがあります。`source` が `estimated` の場合にのみ存在します。 - 見積もりの上限をドル建ての小数文字列で表したものです。これは見積もりであり、保証された上限ではありません。たとえば、プロバイダーが要求より多く返した場合(要求より多くの画像が返る場合など)、見積もりが過去の呼び出しから学習されたものである場合、またはリクエスト量に対して価格が一定に上昇しない場合には、請求額がこれより多くなることがあります。`source` が `estimated` の場合にのみ存在します。 + 見積もりの上限をドルで表した10進文字列です。これは見積もりであり、保証された上限ではありません。たとえば、プロバイダーが要求より多くの結果を返した場合(要求したより多くの画像など)、見積もりが過去の呼び出しから学習されたものである場合、または価格がリクエスト量に対して安定的に上昇しない場合には、実際の請求額がこれより多くなることがあります。`source` が `estimated` の場合にのみ存在します。 - 同じ数値を米セント単位で表したもの(四捨五入なし、計算用)。`amount` と共に存在します。 + 同じ金額を米セントで表した、丸めていない計算用の値です。`amount` とともに存在します。 double - `min_amount` を米セント単位で表したもの(四捨五入なし)。`min_amount` と共に存在します。 + `min_amount` を米セントで表した、丸めていない値です。`min_amount` とともに存在します。 double - `max_amount` を米セント単位で表したもの。`max_amount` と共に存在します。 + `max_amount` を米セントで表した値です。`max_amount` とともに存在します。 double - `amount` をプラットフォームの換算($1 = 211 クレジット)で Comfy クレジットに変換し、小数第 2 位で四捨五入したもの。`exact` の見積もりで `X-Comfy-Credits-Used` が持つと想定される数値です。このヘッダーは四捨五入された事後的な数値であり、領収書ではありません。最終的な請求額は、ワークスペースの使用量と請求記録にある確定請求額です。 + プラットフォームの換算($1 = 211 クレジット)を用いて `amount` を Comfy クレジットで表し、小数第2位に丸めた値です。`exact` の見積もりに対して `X-Comfy-Credits-Used` が持つと想定される数値です。このヘッダーは丸められた事後的な数値であり、領収書ではありません。ワークスペースの使用量および請求記録にある確定額が最終的な値です。 double - この見積もりが対象とするプロバイダー側のレッグ。キュー中の送信では、実行されるレッグです。 + この見積もりが対象とするプロバイダーのレッグです。キュー中の送信では、実行されるレッグになります。 - 正規の Comfy Router モデル ID で、`{provider}/{model}` の形式です。`POST /v2/models/{provider}/{model}` でモデルを指定する際の値とまったく同じであるため、呼び出し側は何かから再導出することなく、そのパスにそのまま埋め込むことができます。その `pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で結合したもので、`maxLength` はそれらの合計に区切り文字を加えた長さです。 + 正規の Comfy Router モデル ID で、`{provider}/{model}` の形式です。`POST /v2/models/{provider}/{model}` でモデルを指定する値とまったく同じであるため、呼び出し元は他の何かから再導出することなくこれをパスに埋め込めます。その `pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で結合したもので、`maxLength` はそれらの長さの合計にこの区切り文字を加えたものです。 - 型: [`RouterModelId`](#routermodelid)。モデル ID、例: `anthropic/claude-opus-4-6`、最大 193 文字 + 型: [`RouterModelId`](#routermodelid) -- モデル ID(例: `anthropic/claude-opus-4-6`)、最大193文字 - この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` 見積もり(ベンダーが報告するコストで請求されるモデル)では、代わりにその価格表を読み取った日付を持ちます。請求数量をベンダーの公開スケジュールから予測し、その後レートカードで価格設定する見積もりは、`exact` の回答でも `estimated` の回答でも、そのスケジュールの読み取り日とカードの取得時刻のうち古い方を持ちます(ベンダーが報告するクレジットで請求されるモデルが `estimated` の場合です)。レートカードを読み取らなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、これは見積もりに回答した時点です。 + この見積もりの価格設定に使用したレートカードを取得した日時です。見積もりは価格の固定ではありません。実行は、課金が評価される時点で有効な料率で請求され、この時点の料率では請求されません。ベンダーの公開価格リストから取得した `estimated` の見積もり(ベンダーが報告するコストで課金されるモデル)では、代わりにそのリストを読み取った日付を持ちます。課金される数量が公開されたベンダーのスケジュールから予測され、その後レートカードから価格設定される見積もりは、そのスケジュールの読み取り日とカードの取得時刻のうち古い方を持ちます。これは `exact` の回答でも `estimated` の回答でも同様です(ベンダーが報告するクレジットで課金されるモデルは `estimated` のケースです)。レートカードが読み取られなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、常にこの見積もりが回答された日時です。 date-time - - `source` が `unknown` の場合にのみ存在します。`not_quotable`(Router は実行前にこの呼び出しの価格を決定できません。価格がプロバイダーから返される内容に依存するか、リクエスト本文が請求対象の数量を制限していないためです)、`unpriced_model`(レートカードがこのリクエストを価格設定していません)、`byok`(キュー中の送信のみ:実行はユーザー自身のプロバイダーキーを使用するため、Comfy はその実行に対して何も請求しません)、または `pricing_unavailable`(キュー中の送信のみ:リクエストの受け付け時にレートカードを読み取れませんでした。これは一時的なもので、実行は通常どおり請求されます)。その他の値は `not_quotable` として扱います。 +`source` が `unknown` の場合にのみ表示されます:`not_quotable`(Router は実行前にこの呼び出しの価格を算出できません。価格はプロバイダーが返す内容に依存するか、リクエストボディが課金対象の数量を制限していないためです)、`unpriced_model`(レートカードがこのリクエストの価格を定めていません)、`byok`(キュー中の送信時のみ:実行はあなた自身のプロバイダーキーを使用するため、Comfy はそれに対して何も請求しません)、または `pricing_unavailable`(キュー中の送信時のみ:リクエストが受け付けられたときにレートカードを読み取れませんでした。これは一時的なもので、実行は通常どおり課金されます)。その他の値は `not_quotable` として解釈してください。 ### RouterErrorResponse -認証、アクセス、モデル検索、クォータ、プロバイダーのトランスポート失敗に対するエラーボディです。 +認証、アクセス、モデル検索、クォータ、プロバイダーのトランスポート障害に対するエラーボディです。 **フィールド** - 失敗についての人間が読める説明で、エンドユーザーに提示しても安全です。機械的にパースされることは想定されていません。代わりに `error_type` で分岐してください。退役したモデルに対する `model_not_found` では、後継モデルが記録されていて呼び出し元から参照できる場合、`detail` は ` was retired on ; use ` となり、そうでない場合は通常の候補リストの代わりに ` was retired on ` だけになります。ここに示される後継モデルは、常に呼び出しを再ポイントできる有効なカタログIDです。サンセット日がまだ未来であるモデルは退役していません。`GET /v2/models` にリストされ続け、その日付まで実行可能なままです。`detail` の他の部分と同様、この退役に関する文言は表示用であり、互換性の保証はありません。機械的にパースされないというルールには、文書化された2つの例外があります。`POST /v2/models/{provider}/{model}` では、`409` は `invalid_input` バケットを共有する3つの無関係な条件に対して返され、それらを区別するのは `detail` だけです。「this request's `image` selects the edit operation」で始まる `detail` はマルチパートの `model_provider` 拒否であり、「this request resolved a BYOK credential」で始まる `detail` は BYOK の `model_provider` 拒否です。どちらも新しい `Idempotency-Key` では解消されません。そのルート上の他の `invalid_input` の `409` はキーの競合です。どちらのプレフィックスも安定した契約用語であり、マッチングに使用できます。他のどこでも、`detail` での分岐に互換性の保証はありません。 + 失敗の人間が読める説明で、エンドユーザーに提示しても安全です。機械的にパースされるものではありません。代わりに `error_type` で分岐してください。退役したモデルに対する `model_not_found` の場合、`detail` は、後継モデルが記録されていて呼び出し元から参照できるときは ` was retired on ; use `、そうでないときは通常の候補リストの代わりに単に ` was retired on ` となります。ここで示される後継モデルは常に、呼び出しの向き先を変更できる有効なカタログ ID です。提供終了日がまだ未来であるモデルは退役していません。`GET /v2/models` に引き続き掲載され、その日付までは実行可能なままです。`detail` の他の部分と同様、この退役に関する文言は表示用であり、互換性の保証はありません。機械的にパースされないというルールには、文書化された 2 つの例外があります。`POST /v2/models/{provider}/{model}` では、`409` は `invalid_input` バケットを共有する 3 つの無関係な条件に対して返され、それらを区別するのは `detail` だけです。`detail` が "this request's `image` selects the edit operation" で始まる場合はマルチパートの `model_provider` 拒否であり、`detail` が `this request resolved a BYOK credential` で始まる場合は BYOK の `model_provider` 拒否です。どちらも新しい `Idempotency-Key` では解消されません。そのルート上の他の `invalid_input` の `409` はキーの競合です。両方のプレフィックスは安定した契約上の用語であり、マッチングに使用できます。それ以外の場所では、`detail` による分岐に互換性の保証はありません。 - Router の失敗を表す粗い機械可読なバケットで、`X-Comfy-Error-Type` レスポンスヘッダーにも反映されるため、呼び出し元はボディをパースせずに分岐できます。集合は20個の値で閉じています。6つのリクエストレベルのバケット `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits`、`model_not_found` に加えて、トランスポートレベルの `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full`、`result_expired` です。「閉じている」とは、今日文書化されている時点での集合を指し、永久に成り立つ境界ではありません。集合は増えることが想定されており、そのためこれは意図的に `enum` ではなくプレーンな文字列になっています。したがってクライアントは、認識できない値を `internal_error` として扱うべきであり、上記のリストを網羅的に switch して次の追加で壊れてはいけません。 + Router の失敗を表す粗い機械可読なバケットで、`X-Comfy-Error-Type` レスポンスヘッダーにも反映されるため、呼び出し元はボディをパースせずに分岐できます。この集合は 20 個の値で閉じています。6 つのリクエストレベルのバケット `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits`、`model_not_found` に加え、トランスポートレベルの `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full`、`result_expired` です。「閉じている」とは今日文書化されている集合を指し、永遠に成り立つ上限ではありません。集合は増えることが想定されているため、これは意図的に `enum` ではなく単なる文字列になっています。したがってクライアントは、未知の値を `internal_error` として扱うべきであり、上記のリストを網羅的に switch して次の追加で壊れるべきではありません。 Type: [`RouterErrorType`](#routererrortype) - モデルプロバイダーがリクエストを拒否した理由のうち、範囲を限定してサニタイズしたものです。`error_type` が `invalid_input` で、`X-Comfy-Upstream-Status` がプロバイダーの `4xx` または `2xx` の場合にのみ存在します。つまり、プロバイダーがリクエストを不正な形式として拒否し、その理由を述べた場合です。通常そのステータスは `4xx` です。プロバイダーが拒否された生成を成功のエンベロープ内で報告する場合(BytePlus の失敗タスクのポーリングは HTTP `200` で、理由がボディに含まれます)は `2xx` になります。プロバイダーの `5xx`、トランスポート失敗、コンテンツポリシー拒否、Router 自身に関するあらゆる拒否など、他のすべての失敗では存在しません。`X-Comfy-Upstream-Detail` ヘッダーを反映します。 + モデルプロバイダーがリクエストを拒否した際に示した、範囲を限定してサニタイズした理由で、`error_type` が `invalid_input` かつ `X-Comfy-Upstream-Status` がプロバイダーの `4xx` または `2xx` である場合にのみ存在します。つまり、プロバイダーがリクエストを不正なものとして拒否し、その理由を述べた場合です。通常そのステータスは `4xx` です。成功エンベロープの中で拒否された生成を報告するプロバイダーの場合は `2xx` になります(BytePlus の失敗タスクポーリングは HTTP `200` で、理由はボディに含まれます)。その他のすべての失敗では存在しません。プロバイダーの `5xx`、トランスポート障害、コンテンツポリシーによる拒否、および Router 自身に関するあらゆる拒否が含まれます。`X-Comfy-Upstream-Detail` ヘッダーを反映します。`invalid_input` で終了した実行のキュー中コレクト(`GET /v2/models/{provider}/{model}/requests/{request_id}`)は、最初のコレクト時にこのフィールドに同じ理由を含み、その後リクエストから削除します。後のコレクトは通常、それを含まない同じ `error_type` と `detail` を返すため、最初のコレクトから読み取ってください。この読み取りはいずれのヘッダーも送信しません。 - コンテンツポリシー拒否がどの入力または出力に関するものかを、Router レベルの閉じた語彙で示します。`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio` です。プロバイダーがモダリティを指定しなかった場合、素の `input` / `output` 値がどちら側かを示します。`error_type` が `content_policy_violation` で、プロバイダーが拒否対象を機械可読なコードで指定した場合にのみ存在し、それ以外では存在しません。プロバイダーのテキストでは決してありません。現在、BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI、Wan の拒否と、MiniMax Router の Nano Banana レグの Gemini 拒否について名前が付きます。拒否がどちら側に関するものかを示さないプロバイダーでは存在しません。`X-Comfy-Refusal-Subject` ヘッダーを反映します。 + コンテンツポリシーによる拒否がどの入力または出力に関するものだったかを、Router レベルの閉じた語彙で示します。`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio` です。プロバイダーがモダリティを特定しなかった場合、単なる `input` / `output` の値がどちら側かを示します。`error_type` が `content_policy_violation` で、プロバイダーが拒否された対象を機械可読なコードで示した場合にのみ存在し、それ以外では存在しません。プロバイダーのテキストでは決してありません。現在は BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI、Wan の拒否、および MiniMax Router の Nano Banana レグの Gemini 拒否について設定されています。拒否がどちら側に関するものかを示さないプロバイダーでは存在しません。`X-Comfy-Refusal-Subject` ヘッダーを反映します。 - パートナーノードの支出拒否に対する請求のポリシー分岐です。請求対象のウォレットが空の場合は `no_funds`、資金の読み取りがそう示さずに呼び出しが拒否された場合は `unspecified` です。`error_type` が `insufficient_credits` で、デプロイメントがウォレットの情報を報告する場合にのみ存在し、それ以外では存在しません。表示テキストではなく機械可読なコードです。`detail` を表示し、分岐はこの値で行ってください。 + パートナーノードの支出拒否に対する Billing のポリシー分岐です。課金対象のウォレットが空の場合は `no_funds`、資金の読み取りがそう示さずに呼び出しが拒否された場合は `unspecified` です。`error_type` が `insufficient_credits` で、デプロイメントがウォレットの情報を報告する場合にのみ存在し、それ以外では存在しません。表示用テキストではなく機械可読なコードです。`detail` を表示し、分岐にはこちらを使用してください。 - 拒否された呼び出しが請求するはずだったウォレットを、`RouterErrorResponse.billed_workspace` で示します。「どのウォレットが空なのか?」に答えるものであり、呼び出し元の UI が現在選択しているワークスペースとは限りません。資金のあるチームが開いていても、チームメンバーの個人クレデンシャルはここに個人ウォレットを示します。`denied_reason` と一緒にのみ存在します。 + 拒否された呼び出しが課金するはずだったウォレットを、`RouterErrorResponse.billed_workspace` で示します。「どのウォレットが空なのか?」に答えるものであり、呼び出し元の UI で現在選択済みのワークスペースとは限りません。また、チームメンバーの個人クレデンシャルは、資金のあるチームが開いていても、ここではその人の個人ウォレットを示します。`denied_reason` と併せてのみ存在します。 Type: [`RouterBilledWorkspace`](#routerbilledworkspace) - 拒否されたリクエストがどのように認証されたかを示します。`personal_api_key`、`team_api_key`、`personal_session`、`team_session` のいずれかです。「もう一方のウォレットに請求するには、どのクレデンシャルに切り替えればよいか?」に答えます。これは権限ではなく、何も付与しません。`denied_reason` と一緒にのみ存在します。 + 拒否されたリクエストがどのように認証されたかを示します。`personal_api_key`、`team_api_key`、`personal_session`、`team_session` のいずれかです。「もう一方のウォレットに課金するにはどのクレデンシャルに切り替えればよいか?」に答えるものです。権限ではなく、何も付与しません。`denied_reason` と併せてのみ存在します。 ### RouterErrorType {#routererrortype} @@ -1240,27 +1240,27 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 ### RouterModelBilling -モデルを呼び出す前に確認すべき課金動作。価格や使用量は含まれません。 +モデルを呼び出す前に確認すべき課金動作。価格や使用量は含みません。 **フィールド** - このモデルがコンテンツポリシーを理由に拒否した呼び出しが、それでも呼び出し元に課金されるかどうか。プロバイダーごとに異なり、その違いは呼び出し時には見えず、同じ呼び出しに対してエラーと課金の両方を見たユーザーには知りようがありません。そのため、プロバイダーごとの言い伝えに任せるのではなく、呼び出し前にモデルごとに明記しています。`yes` の場合、同期ルートの `content_policy_violation` エラーは `X-Comfy-Credits-Used` を含むことがあります。プロバイダーがモデルの生成済み出力を拒否し、Comfy がその拒否された生成に対して使用量を記録した場合に含まれ、その量が示されます。入力側の拒否、同一キーのリプレイ(`Idempotent-Replayed: true`)、およびヘッダーの小数点以下2桁に表示されないほど少額の課金には含まれません。ヘッダーのない拒否は報告されないだけで、無料だった証拠ではありません。 + このモデルがコンテンツポリシー上の理由で拒否した呼び出しが、それでも呼び出し元に課金されるかどうか。プロバイダーによって異なり、その違いは呼び出し時には見えず、同じ呼び出しに対してエラーと課金の両方を目にしたユーザーには知りようがありません。そのため、プロバイダーごとの言い伝えに任せるのではなく、呼び出し前にモデルごとに明示しています。`yes` の場合、同期ルートの `content_policy_violation` エラーに `X-Comfy-Credits-Used` が付くことがあります。プロバイダーがモデルの生成済み出力を拒否し、Comfy がその拒否された生成について使用量を記録した場合に付き、その量が記載されます。入力側の拒否、同一キーでのリプレイ(`Idempotent-Replayed: true`)、およびヘッダーの小数点以下2桁に現れないほど少額の課金には付きません。ヘッダーのない拒否は報告されるものではなく、無料だった証拠でもありません。 型: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -1つの Comfy Router モデルに関するモデルごとの詳細: カタログ一覧がそのモデルについて報告するすべての内容に加え、単一モデルルートのみが持つモデルごとのフィールド。 +1つの Comfy Router モデルごとの詳細: カタログ一覧がそのモデルについて報告するすべての情報に加え、単一モデルのルートだけが持つモデルごとのフィールド。 -[`RouterModelListEntry`](#routermodellistentry)、[`RouterModelDetailFields`](#routermodeldetailfields) を構成します。 +以下を合成します: [`RouterModelListEntry`](#routermodellistentry)、[`RouterModelDetailFields`](#routermodeldetailfields)。 型: `object` ### RouterModelDetailFields -モデル詳細エンドポイントが返す任意のフィールド。 +モデル詳細エンドポイントが返す任意フィールド。 **フィールド** @@ -1274,52 +1274,52 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 `POST /v2/models/{provider}/{model}` で使用されるモデル ID。 -型: `string`。モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字。 +型: `string`。モデル ID(例: `anthropic/claude-opus-4-6`)。最大 193 文字 ### RouterModelInput -モデル入力オブジェクトです。フィールドと検証については、選択済みモデルの OpenAPI ドキュメントを参照してください。 +モデル入力オブジェクトです。フィールドと検証については、選択済みモデルのOpenAPIドキュメントを参照してください。 型: `object` ### RouterModelInputSchemaDocument -1つのモデルの入力と出力のためのスタンドアロンOpenAPIドキュメントです。 +1つのモデルの入力と出力のためのスタンドアロンOpenAPIドキュメント。 -Type: `object` +型: `object` ### RouterModelListEntry -モデルの ID と課金情報。 +モデルのIDと課金情報。 **フィールド** - 正規の Comfy Router モデル ID である `{provider}/{model}`。これは `POST /v2/models/{provider}/{model}` でモデルを指定する値そのものであり、呼び出し元は何かから再導出することなく、そのままこのパスに埋め込むことができます。`pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で連結したもので、`maxLength` は両者の長さの合計にその区切り文字を加えた値です。 + Comfy Router の正規モデルID `{provider}/{model}` です。これは `POST /v2/models/{provider}/{model}` でモデルを指定する際の値とまったく同じなので、呼び出し元は他の情報から再導出せずにそのパスへ埋め込めます。`pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で連結したもので、`maxLength` は両者の長さの合計にその区切り文字を加えたものです。 - 型: [`RouterModelId`](#routermodelid):モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字 + 型: [`RouterModelId`](#routermodelid) -- モデルID。例: `anthropic/claude-opus-4-6`、最大193文字 - 正規の `{provider}/{model}` モデル ID のうち小文字の `provider` セグメント。対象となるモデルを提供するパートナーを指します。呼び出しルートの `provider` パスパラメーターとカタログエントリの `provider` フィールドはどちらもこの 1 つのスキーマを参照しており、これによって一覧に載る ID と受け付ける ID が食い違わないようになっています。 + 正規モデルID `{provider}/{model}` の小文字の `provider` セグメントです。対象となるモデルを提供するパートナーを表します。呼び出しルートの `provider` パスパラメータとカタログエントリの `provider` フィールドはどちらもこの単一のスキーマを参照しており、これにより一覧に表示されるIDと受け付けられるIDがずれるのを防いでいます。 - 型: [`RouterProviderSegment`](#routerprovidersegment):英数字スラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ。例: `anthropic`、最大64文字 - 正規の `{provider}/{model}` モデル ID のうち小文字の `model` セグメント。そのプロバイダー内で実行するモデルを指します。呼び出しルートの `model` パスパラメーターとカタログエントリの `model` フィールドで共有されており、`RouterProviderSegment` と同じく食い違いを防ぐための構成です。 + 正規モデルID `{provider}/{model}` の小文字の `model` セグメントです。そのプロバイダー内で実行するモデルを表します。呼び出しルートの `model` パスパラメータとカタログエントリの `model` フィールドで共有されており、`RouterProviderSegment` と同じくずれ防止の理由によります。 - 型: [`RouterModelSegment`](#routermodelsegment):英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ。例: `claude-opus-4-6`、最大128文字 - 呼び出し元が呼び出しの前に必要とする、モデルごとの課金情報。価格ではありません。使用量やコストの数値がここに現れることはありません。 + 呼び出し前に呼び出し元が必要とするモデルごとの課金情報です。価格ではありません。使用量やコストの数値はここには決して表示されません。 型: [`RouterModelBilling`](#routermodelbilling) - このモデルの `GET /v2/models/{provider}/{model}/openapi.json` ドキュメントの現在の strong `ETag`。スキーマが変わっていない間に `304` を得たい場合は、その読み取りで `If-None-Match` として送信します。また、前回確認した値と比較すれば、すべてのドキュメントを取得しなくても、どのモデルのスキーマが変更されたかを知ることができます。この呼び出し元に対してその読み取りが現時点で `200` を返さない場合、この値は省略されます。スキーマサービスが利用不可である、モデルのドキュメントをレンダリングできない、またはレスポンスの構築中にそのモデルがこの呼び出し元にとって利用不可になった場合です。タグが存在しないことはスキーマの変更を意味しません。現在のタグを知るには、モデルのドキュメントを再読み取りしてください。 + このモデルの `GET /v2/models/{provider}/{model}/openapi.json` ドキュメントの現在の強い `ETag` です。スキーマが変更されていない間は、その読み取りで `If-None-Match` として送信すると `304` を取得できます。または、前回確認した値と比較することで、すべてのドキュメントを取得せずに、どのモデルのスキーマが変更されたかを知ることができます。その読み取りがこの呼び出し元に対して現時点で `200` を返さない場合は、常に存在しません。スキーマサービスが利用不可である、モデルのドキュメントをレンダリングできない、またはレスポンスの構築中にモデルがこの呼び出し元にとって利用不可になった場合です。タグが存在しないことはスキーマの変更ではありません。現在のタグを知るには、モデルのドキュメントを再読み取りしてください。 ### RouterModelListResponse @@ -1335,166 +1335,166 @@ Router モデルカタログの 1 ページ分です。 - このページより後に別のページが存在するかどうか。この値が true の間は取得を続けてください。`data` が短い、または空であることからカタログの終端を推測しないでください。 + このページより後に別のページが存在するかどうか。これが true の間はページを辿り続けてください。短い、または空の `data` からカタログの終端を推測しないでください。 - Router のリストを指す不透明なカーソルです。これはサーバーが生成するもので、往復してそのまま渡すことだけが想定されています。オフセットではなく、モデル ID でもなく、順序を持たず、カタログの再構築をまたいで安定もしません。そのため、パースする、インクリメントする、取得元の走査を超えて永続化する、といった扱いはすべて契約の範囲外です。オフセットではなくカーソルを使うのは、カタログが動的に変化するリストだからです。オフセットによる走査では、走査の途中でエントリが追加または削除されると、エントリを暗黙にスキップしたり重複して返したりしますが、呼び出し側はそれが起きたことを判別できません。 + Router のリストを指す不透明なカーソルです。サーバーが生成し、そのまま往復させることだけを想定しています。オフセットではなく、モデル ID でもなく、順序付けもされておらず、カタログの再構築をまたいで安定もしません。そのため、カーソルを解析する、インクリメントする、あるいは取得元の走査以外で永続化することは、いずれも契約の範囲外です。オフセットではなくカーソルを使うのは、カタログが変化し続けるリストだからです。オフセットによる走査では、走査中にエントリが追加または削除されると、気づかないうちにエントリを飛ばしたり繰り返したりしますが、呼び出し側はそれが起きたことを判別できません。 - 型: [`RouterPageCursor`](#routerpagecursor) -- `next_cursor` として返される不透明なカーソル、1〜512 文字 + 型: [`RouterPageCursor`](#routerpagecursor)。`next_cursor` として返される不透明なカーソルで、1–512 文字です。 - 実際に返されたページサイズ。最大値を超える `limit` を要求した場合は拒否されず最大値に切り詰められるため、要求した値より小さくなることがあります。送信した値ではなくこの数値でページングしてください。そうしないと、実際には受け取っていない行が存在するとみなしてしまいます。 + 実際に返されたページサイズ。最大値を超える `limit` を要求した場合は、拒否されるのではなく最大値に切り詰められるため、要求した値より小さくなることがあります。ページネーションには送信した値ではなくこの数値を使ってください。そうしないと、実際には受け取っていない行があるものとみなしてしまいます。 - 1〜100 + 1–100 ### RouterModelOutput -モデルの結果オブジェクトです。正確な形状については、選択済みモデルの出力スキーマを参照してください。 +モデル結果オブジェクトです。正確な形状については、選択済みモデルの出力スキーマを参照してください。 型: `object` ### RouterModelSegment -`{provider}/{model}` 形式のモデル ID のうち、モデル部分を表します。 +`{provider}/{model}` というモデル ID のうち、モデル部分。 -型: `string`。英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字です。 +型: `string`。英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 ### RouterPageCursor -不透明なカタログカーソルです。受け取った値は変更せず、そのまま `cursor` として渡してください。 +不透明なカタログカーソル。変更せずにそのまま `cursor` として返してください。 -型: `string` -- `next_cursor` として返される不透明なカーソル、1–512文字 +Type: `string` -- `next_cursor` として返される不透明なカーソル。1–512 文字 ### RouterProviderSegment -`{provider}/{model}` 形式のモデル ID のうち、プロバイダー部分です。 +`{provider}/{model}` モデル ID のプロバイダー部分。 -型: `string`。英数字スラッグ(例: `anthropic`)、最大 64 文字です。 +型: `string`。英数字のスラッグ(例: `anthropic`)、最大64文字 ### RouterQueueCancelResponse -このルートが解決したリクエストを表す2つのステータス(`202` と `409`)における、キャンセル要求への応答です。成功エンベロープとエラーエンベロープに分けるのではなく、両方で1つのボディ形状を共有します。どちらも同じ内容(キャンセルで見つかったこと)を表しており、ステータスコードごとに異なる型をパースしなければならないクライアントは、分割から何も得られないからです。 +このルートが解決したリクエストを表す2つのステータス(`202` と `409`)に対する、キャンセル要求への応答です。成功エンベロープとエラーエンベロープに分けず、両方で1つのボディ形状を共有します。どちらも同じ内容(キャンセルで何が見つかったか)を表しており、ステータスコードごとに異なる型を解析しなければならないクライアントにとって、分けることに利点はないためです。 **フィールド** - キュー中の Router リクエスト1件の識別子。呼び出し元がポーリング、キャンセル、結果の収集に使用するハンドルです。 + キュー中の Router リクエスト1件の識別子。呼び出し元がポーリング、キャンセル、結果取得に使用するハンドルです。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid)、`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大36文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 - キャンセル要求で見つかった内容を、このルートが実際に解決したリクエストを表す2つの結果について示します。どちらも HTTP ステータスに反映されるため、クライアントはどちらで分岐してもかまいません。 + このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求で見つかった内容です。どちらも HTTP ステータスに反映されるため、クライアントはどちらで分岐してもかまいません。 型: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求が見つけた内容を示します。どちらもHTTPステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。 +キャンセル要求で判明した内容です。このルートが実際に解決したリクエストを表す2つの結果について示します。どちらも HTTP ステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。 型: `string` ### RouterQueuePosition -レスポンスが生成された時点で、このリクエストよりキュー内で先行しているリクエストの数。0 はこのリクエストが先頭であることを意味します。 +レスポンスが構成された時点で、キュー内でこのリクエストより先行しているリクエストの数。0 は、このリクエストが先頭にあることを意味します。 -型: `integer`、0 以上。 +型: `integer` -- 0 以上 ### RouterQueueRequestId キュー中の Router リクエスト1件の識別子。呼び出し元がポーリング、キャンセル、結果の取得に使用するハンドルです。 -型: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 +型: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大36文字 ### RouterQueueStatus -キュー中の Router リクエストの状態です。値はちょうど3つで、`RouterErrorType` と違いこちらは閉じた `enum` です。これは、2つのスキーマが意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えていくことが想定されています。そのため、未知のバケットを厳密に拒否する生成済みクライアントは、何かがすでにうまくいっていないときにこそ最も激しく失敗することになります。一方こちらはライフサイクルであり、後で4番目の状態が追加されたライフサイクルは、enum として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更になります。そのため enum として宣言され、制約はクライアントが見られる場所に記述されています。 +キュー中の Router リクエストの状態です。値はちょうど3つあり、`RouterErrorType` と異なり、こちらは閉じた `enum` です。これは、2つのスキーマが意図的に逆方向に閉じられているためです。`RouterErrorType` は失敗を分類し、その集合は拡大することが想定されているため、認識できないバケットを厳格に拒否する生成済みクライアントは、すでに何かが問題を起こしているまさにそのときに最も深刻に失敗することになります。こちらはライフサイクルであり、後で4番目の状態が追加されたライフサイクルは、enum として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更になります。そのため enum として宣言され、制約はクライアントから見える場所に明記されています。 型: `string` ### RouterQueueStatusFields -`RouterQueueStatusResponse` のうち URL ブロックではない半分です。キュー中の 1 リクエストの識別子、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す粗い分類を持ちます。 +`RouterQueueStatusResponse` のうち URL ブロック以外の半分です。キュー中の 1 リクエストの識別子、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す粗い分類を含みます。 **フィールド** - キュー中の 1 つの Router リクエストの識別子。呼び出し側がポーリング、キャンセル、結果の取得に使うハンドルです。 + キュー中の Router リクエスト 1 件の識別子。呼び出し元がポーリング、キャンセル、結果の取得に使うハンドルです。 Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 - キュー中の Router リクエストの状態。値はちょうど 3 つしかなく、`RouterErrorType` と違ってこれは閉じた `enum` です。これは 2 つのスキーマが意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えていくことが想定されているため、未知の分類を厳格に拒否する生成済みクライアントは、何かがすでに失敗したまさにその場面で最も大きく失敗することになります。こちらはライフサイクルであり、後から 4 つ目の状態が追加されるライフサイクルは、enum として宣言されているかどうかに関係なく、それに合わせて書かれたすべてのポーリングループにとって破壊的変更になります。そのため enum として宣言され、制約はクライアントから見える場所に明記されています。 + キュー中の Router リクエストの状態です。値はちょうど 3 つで、`RouterErrorType` と違い、こちらは閉じた `enum` です。2 つのスキーマは意図的に逆方向へ閉じられているからです。`RouterErrorType` は失敗を分類するもので、その集合は増えていくことが想定されているため、未知の分類をハードに拒否する生成クライアントは、まさに何かがすでに失敗したときに最も激しく失敗することになります。こちらはライフサイクルであり、後から 4 つ目の状態を追加するライフサイクルは、enum として宣言されているかどうかに関わらず、それに対して書かれたすべてのポーリングループにとって破壊的変更になります。だからこそこれは enum として宣言され、その制約はクライアントが見える場所に明記されています。 Type: [`RouterQueueStatus`](#routerqueuestatus) - レスポンスが構成された瞬間に、このリクエストより前のキューに並んでいるリクエストの数。0 はこのリクエストが先頭であることを意味します。 + レスポンスが構成された時点で、キューのうちこのリクエストより前に何件のリクエストがあるか。0 はこのリクエストが先頭であることを意味します。 Type: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 - 成功しなかった `COMPLETED` リクエストにのみ存在し、結果の読み取りがその失敗を返すときに `X-Comfy-Error-Type` に載せるのと同じ粗い分類を持ちます。これは、成功したターミナルリクエストと、失敗またはキャンセルされたリクエストを区別するためのものであり、どちらにも別個のターミナルステータスはありません。また成功時には null ではなく存在しないため、その有無で分岐してください。 + 成功しなかった `COMPLETED` リクエストにのみ存在し、結果の読み取りがその失敗を返すときに `X-Comfy-Error-Type` に載せるのと同じ粗い分類を持ちます。これが、成功したターミナルリクエストと、失敗またはキャンセル済みのリクエストを区別するものです(どちらにも別個のターミナルステータスはありません)。また成功時には null ではなく存在しないため、その有無で分岐してください。 Type: [`RouterErrorType`](#routererrortype) ### RouterQueueStatusResponse -キュー中のリクエスト1件の現在の状態を、送信時に返されたものと同じ3つのURLと組み合わせたものです。 +キュー中の1つのリクエストの現在の状態であり、送信時に返されたものと同じ3つのURLを組み合わせたものです。 -[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueStatusFields`](#routerqueuestatusfields) を組み合わせます。 +[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueStatusFields`](#routerqueuestatusfields)を組み合わせます。 型: `object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse` のうち URL ブロックではない半分です。新しいリクエストの識別情報と、それが受け付けられた瞬間の状態を表します。 +`RouterQueueSubmitResponse` のうち URL ブロックではない半分です。新しいリクエストの識別情報と、受け付けられた瞬間のその状態を表します。 **フィールド** - キュー中の Router リクエスト 1 件の識別子。呼び出し元がポーリング、キャンセル、結果の取得に使うハンドルです。 + キュー中の Router リクエスト 1 件の識別子。呼び出し元がポーリング、キャンセル、結果取得に使うハンドルです。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大 36 文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 - キュー中の Router リクエストの状態です。値はちょうど 3 つしかなく、`RouterErrorType` とは異なり、これは閉じた `enum` です。2 つのスキーマは意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えることが想定されるため、未知の分類を生成済みクライアントが厳格に拒否すると、何かがすでに失敗したまさにそのときに最も大きく失敗することになります。一方こちらはライフサイクルであり、後から 4 つ目の状態を追加するライフサイクルは、enum として宣言されているかどうかに関わらず、それに合わせて書かれたすべてのポーリングループにとって破壊的変更となります。だからこそ enum として宣言し、その制約をクライアントから見える場所に明記しているのです。 + キュー中の Router リクエストの状態です。値はちょうど 3 つで、`RouterErrorType` と違いこちらは閉じた `enum` です。2 つのスキーマは意図的に逆方向へ閉じているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えることが想定されるため、未知のバケットを厳格に拒否する生成済みクライアントは、何かがすでにうまくいっていないまさにその時に最も激しく失敗することになります。こちらはライフサイクルであり、後から 4 つ目の状態を追加するライフサイクルは、enum として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更となります。だからこそ enum として宣言され、その制約はクライアントが確認できる場所に明記されています。 型: [`RouterQueueStatus`](#routerqueuestatus) - レスポンスが構成された瞬間に、このリクエストよりキューで前に並んでいるリクエストの数です。0 はこのリクエストが先頭であることを意味します。 + レスポンスが組み立てられた時点で、このリクエストよりキューの先頭側に何件あるか。0 はこのリクエストが先頭であることを意味します。 型: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 - このリクエストの事前コスト見積もりです。呼び出し元に対してコスト見積もりが有効になっている場合、新規受け付け時に含まれます。このリクエストがピン留めされたプロバイダー側のレグを見積もります(キューにはフォールバックループがないため、`fallback_provider` が実行されるレグを変えることはありません)。数値を提示できない場合でも `source: unknown` として存在し、見積もりのせいで送信が失敗することはありません。冪等なリプレイ時(`Idempotent-Replayed: true`)には、オリジナルの見積もりが保存されていないため省略されます。これは見積もりであって最終的な請求額ではなく、価格の固定でもありません。実行はレーティング時点で有効なレートで課金され、ワークスペースの使用量および請求記録に確定した請求額が最終となります。 + このリクエストの事前コスト見積もりで、呼び出し元に対してコスト見積もりが有効な場合、新規受け付け時に含まれます。このリクエストがピン留めされたプロバイダーレッグを提示します(キューにはフォールバックループがないため、`fallback_provider` が実行されるレッグを変えることはありません)。数値を出せない場合でも `source: unknown` として存在します。見積もりのせいで送信が失敗することはありません。冪等なリプレイ(`Idempotent-Replayed: true`)では、オリジナルの見積もりが保存されていないため省略されます。これは見積もりであり、最終的な請求額でも価格の固定でもありません。実行はレーティング時点で有効なレートで課金され、ワークスペースの使用量と請求記録にある確定済みの請求額が最終です。 型: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -実行がキューに受け入れられたときに返されるハンドル。リクエストの識別情報と状態を、そのライフサイクルの残りを扱う3つのURLと組み合わせたものです。 +実行がキューに受け入れられたときに返されるハンドル。リクエストの識別情報と状態を、その残りのライフサイクルを扱う3つのURLと組み合わせたものです。 -[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueSubmitFields`](#routerqueuesubmitfields) を組み合わせます。 +[`RouterQueueUrls`](#routerqueueurls) と [`RouterQueueSubmitFields`](#routerqueuesubmitfields) を組み合わせます。 -型: `object` +Type: `object` ### RouterQueueUrls -キュー中の1つのリクエストの残りのライフサイクルを扱う3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューのURLを自分で組み立てることはありません。 +キュー中の1つのリクエストの残りのライフタイムに対応する3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューのURLを自身で組み立てることはありません。 **フィールド** @@ -1518,52 +1518,52 @@ Router モデルカタログの 1 ページ分です。 ### RouterValidationErrorContext -失敗した検証ルールに関するプロバイダー提供の詳細。 +検証に失敗したルールについて、プロバイダーが提供する詳細情報。 型: `object` ### RouterValidationErrorDetail -1 件のフィールドレベルの検証失敗。 +フィールド単位の検証失敗を 1 件表します。 **フィールド** - 問題のあるフィールドへのパス。最も外側のセグメントが先頭です。たとえば `["body", "image_url"]`、または整数が配列内のインデックスを表す場合は `["body", "images", 0]` のようになります。 + 問題のあるフィールドへのパス。最も外側のセグメントが先頭になります。たとえば `["body", "image_url"]`、あるいは整数で配列内のインデックスを指す `["body", "images", 0]` のような形式です。 - この 1 件の失敗についての人間が読める説明。 + この 1 件の失敗についての、人間が読める形式の説明。 - この失敗の具体的で機械可読な理由。プロバイダーから変更されずにそのまま渡されます。型付き SDK の例外階層が分岐に使うのはこの値です。レスポンスヘッダーの `error_type` は、その大まかな分類にすぎません。 + この失敗の具体的で機械可読な理由で、プロバイダーから変更されずにそのまま渡されます。型付き SDK の例外階層が分岐に使う値であり、レスポンスヘッダーの `error_type` はその大まかな分類にすぎません。 - 1 つの `RouterValidationErrorDetail` で違反した境界値。プロバイダーからそのまま渡されます。たとえば `greater_than` に対応する `{"limit_value": 8}`、`image_too_small` に対応する `{"min_width": 512}`、`file_too_large` に対応する `{"max_size_bytes": 10485760}` などです。キー集合はプロバイダーとエラー種別に固有であるため、これは意図的にオープンなオブジェクトとしています。固定のフィールドリストに絞り込んだり、`msg` 文字列に畳み込んだりすると、移植された統合はまさにコンパイルは通るものの、境界値を読んでいた分岐を黙って失うことになります。エラー種別が境界値を持たない場合は省略されます。 + 1 つの `RouterValidationErrorDetail` において違反した境界値で、プロバイダーからそのまま引き継がれます。たとえば `greater_than` とともに `{"limit_value": 8}`、`image_too_small` とともに `{"min_width": 512}`、`file_too_large` とともに `{"max_size_bytes": 10485760}` のようになります。キー集合はプロバイダーとエラータイプに固有であるため、これは意図的にオープンなオブジェクトとしています。固定のフィールド一覧に絞り込んだり、`msg` 文字列に折り畳んだりすると、移植した統合がコンパイルは通るものの、境界値を読んでいた分岐を黙って失うことになります。エラータイプが境界値を持たない場合は存在しません。 - Type: [`RouterValidationErrorContext`](#routervalidationerrorcontext) + 型: [`RouterValidationErrorContext`](#routervalidationerrorcontext) - 問題のある入力値。呼び出し元が `loc` から再計算しなくても何が拒否されたかを確認できるよう、そのまま返されます。文字列、数値、ブール、配列、オブジェクト、null のいずれの JSON 型も取り得るため、このスキーマはオブジェクトに絞り込まず、意図的に型なしのままにしています。プロバイダーが入力をそのまま返さない場合は省略されます。 + 問題のある入力値で、呼び出し元が `loc` から再導出することなく何が拒否されたかを確認できるよう、そのままの形で返されます。文字列、数値、ブール、配列、オブジェクト、null のいずれの JSON 型でもよいため、このスキーマはオブジェクトに絞り込まず、意図的に型なしのままにしています。プロバイダーが入力をそのまま返さない場合は存在しません。 - Type: [`RouterValidationErrorInput`](#routervalidationerrorinput) + 型: [`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -プロバイダーが拒否された入力値を含める場合、その値です。 +プロバイダーが値を含める場合の、拒否された入力値です。 ### RouterValidationErrorResponse -`422` 検証エラーのレスポンス本文です。カテゴリは `X-Comfy-Error-Type` を参照してください。 +`422` 検証エラーのレスポンスボディです。カテゴリは `X-Comfy-Error-Type` を参照してください。 **フィールド** - リクエストで見つかったすべての検証失敗。問題のあるフィールドごとに1エントリです。 + リクエストで検出されたすべての検証失敗。問題のあるフィールドごとに1エントリです。 型: [`RouterValidationErrorDetail`](#routervalidationerrordetail) の配列 diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index c94e409c66..b579bf7798 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 모델" sidebarTitle: "모든 모델" description: "Comfy Router에서 사용할 수 있는 모든 모델을 제공자별로 정리하고, 각 모델의 입력 및 출력 모달리티를 함께 표시합니다." -translationSourceHash: c9297323 +translationSourceHash: 947ab0cb translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 @@ -20,7 +20,7 @@ translationBlockHashes: "HeyGen": 76fe1a0d "Higgsfield": 0ce2b918 "Ideogram": c22a0e5e - "Kling": 2b95e99f + "Kling": aec38bcd "Krea": 16b83e5e "LTX": 32595bf9 "Luma": 8cd2a7ce @@ -47,6 +47,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from the Router catalog by `pnpm code-pages:gen`. */} 아래의 모든 모델은 동일한 라우트인 `POST /v2/models/{provider}/{model}`를 통해 제공되며, 각 모델 고유의 JSON 본문을 사용합니다. 각 페이지에는 Python, TypeScript, cURL로 작성된 실제 동작하는 요청 예시가 있습니다. 검색, 스키마, 오류, 재시도, 청구에 대해서는 [Comfy Router API 사용하기](/ko/development/comfy-router/api)를 참고하세요. @@ -548,12 +549,12 @@ translationBlockHashes: | 모델 | ID | 입력 | 출력 | | --- | --- | --- | --- | | [Kling 3.0 Turbo](/ko/development/comfy-router/models/kling/kling-3-0-turbo/code) | `kling/kling-3.0-turbo` | 텍스트 | 비디오 | -| [Kling 4.0](/ko/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | 텍스트 | 비디오 | +| [Kling 4.0](/ko/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | 텍스트, 이미지, 비디오 | 비디오 | | [Kling Image O1](/ko/development/comfy-router/models/kling/kling-image-o1/code) | `kling/kling-image-o1` | 텍스트, 이미지 | 이미지 | -| [Kling V2.5 Turbo](/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code) | `kling/kling-v2-5-turbo` | 텍스트 | 비디오 | -| [Kling V2.6](/ko/development/comfy-router/models/kling/kling-v2-6/code) | `kling/kling-v2-6` | 텍스트 | 비디오 | +| [Kling V2.5 Turbo](/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code) | `kling/kling-v2-5-turbo` | 이미지, 텍스트 | 비디오 | +| [Kling V2.6](/ko/development/comfy-router/models/kling/kling-v2-6/code) | `kling/kling-v2-6` | 이미지, 텍스트 | 비디오 | | [Kling V3 Omni](/ko/development/comfy-router/models/kling/kling-v3-omni/code) | `kling/kling-v3-omni` | 텍스트, 이미지, 비디오 | 비디오 | -| [Kling V3](/ko/development/comfy-router/models/kling/kling-v3/code) | `kling/kling-v3` | 텍스트 | 비디오 | +| [Kling V3](/ko/development/comfy-router/models/kling/kling-v3/code) | `kling/kling-v3` | 이미지, 텍스트 | 비디오 | | [Kling Video O1](/ko/development/comfy-router/models/kling/kling-video-o1/code) | `kling/kling-video-o1` | 텍스트, 이미지, 비디오 | 비디오 | | [Videos Avatar Image 2video](/ko/development/comfy-router/models/kling/videos-avatar-image2video/code) | `kling/videos-avatar-image2video` | 이미지, 오디오 | 비디오 | | [Videos Lip Sync](/ko/development/comfy-router/models/kling/videos-lip-sync/code) | `kling/videos-lip-sync` | 비디오, 오디오 | 비디오 | diff --git a/ko/development/comfy-router/models/kling/kling-4-0/code.mdx b/ko/development/comfy-router/models/kling/kling-4-0/code.mdx index 40b80737b5..9845246f45 100644 --- a/ko/development/comfy-router/models/kling/kling-4-0/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-4-0/code.mdx @@ -2,21 +2,22 @@ title: "Comfy Router로 Kling 4.0 사용하기" description: "Comfy Router를 통해 kling/kling-4.0을 호출합니다. 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Kling 4.0" -translationSourceHash: ed37a731 +translationSourceHash: df75d2dd translationFrom: development/comfy-router/models/kling/kling-4-0/code.mdx translationBlockHashes: - "_intro": a4fab55c + "_intro": 1eb48be4 "Quick start": 44d4a538 "Schema": 659ba1ad "Examples": c9f5b052 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-4.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; `kling/kling-4.0`의 API 레퍼런스이며, Kling에서 Comfy Router를 통해 제공됩니다. -**입력:** 텍스트 · **출력:** 비디오 +**입력:** 텍스트, 이미지, 비디오 · **출력:** 비디오 ## 빠른 시작 diff --git a/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index bd4708d308..c1bdec8983 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router로 Kling V2.5 Turbo 사용하기" description: "Comfy Router를 통해 kling/kling-v2-5-turbo를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1671e7b6 +translationSourceHash: 06b3d8e9 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: - "_intro": 2495a4d3 + "_intro": 785eeca2 "Quick start": dc63b3ac - "Schema": 3bcb036e + "Schema": e36b5646 "Examples": 8623c725 --- - {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/kling/kling-v2-5-turbo.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; `kling/kling-v2-5-turbo`의 API 레퍼런스이며, Comfy Router가 Kling에서 제공합니다. -**입력:** 텍스트 · **출력:** 비디오 +**입력:** 이미지, 텍스트 · **출력:** 비디오 ## 빠른 시작 @@ -166,7 +165,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 콜백 알림 주소. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. + 콜백 알림 주소입니다. 무시됨: comfy-api가 전달 전에 이 필드를 삭제하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -180,19 +179,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 카메라의 수평 축(x축) 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 나타냅니다. + 수평 축(x축)을 따른 카메라의 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 나타냅니다. 범위: `-10` ~ `10` - 수직 평면(x축)에서의 카메라 회전을 제어합니다. 음수는 아래 방향 회전, 양수는 위 방향 회전을 나타냅니다. + 수직 평면(x축)에서의 카메라 회전을 제어합니다. 음수는 아래쪽 회전, 양수는 위쪽 회전을 나타냅니다. 범위: `-10` ~ `10` - 카메라의 롤링 수량(z축)을 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 나타냅니다. + 카메라의 롤링 정도(z축)를 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 나타냅니다. 범위: `-10` ~ `10` @@ -204,7 +203,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 카메라의 수직 축(y축) 이동을 제어합니다. 음수는 아래, 양수는 위를 나타냅니다. + 수직 축(y축)을 따른 카메라의 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 나타냅니다. 범위: `-10` ~ `10` @@ -216,13 +215,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 미리 정의된 카메라 움직임 유형입니다. simple: 사용자 정의 가능한 카메라 움직임. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하고 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하고 앞으로 이동합니다. + 미리 정의된 카메라 이동 유형입니다. simple: 사용자 정의 가능한 카메라 이동. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하며 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하며 앞으로 이동합니다. 가능한 값: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - 비디오 생성의 유연성입니다. 값이 높을수록 모델의 유연성 정도가 낮아지고, 사용자 프롬프트와의 관련성이 강해집니다. + 비디오 생성에서의 유연성입니다. 값이 높을수록 모델의 유연성 정도가 낮아지고 사용자 프롬프트에 대한 관련성이 강해집니다. 범위: `0` ~ `1` @@ -236,21 +235,21 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 사용자 정의 Task ID. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. + 사용자 지정 작업 ID입니다. 무시됨: comfy-api가 전달 전에 이 필드를 삭제하며, Comfy Router가 대신 폴링합니다. - 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드(Standard Mode). pro: 더 긴 재생 시간으로 더 높은 품질의 출력을 생성하는 프로페셔널 모드(Professional Mode). + 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드입니다. pro: 더 긴 재생 시간과 더 높은 품질의 출력을 생성하는 전문가 모드입니다. 가능한 값: `std`, `pro` - 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 전송하세요. 모델은 요청 경로에 따라 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. + 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내십시오. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. - 각 스토리보드에 대한 정보(프롬프트, 재생 시간 등)입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize일 때 필수입니다. + 프롬프트와 재생 시간 등 각 스토리보드에 대한 정보입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize인 경우 필수입니다. @@ -266,15 +265,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 멀티 샷 비디오를 생성할지 여부입니다. true일 때 prompt 파라미터는 무효입니다. false일 때 shot_type과 multi_prompt 파라미터는 무효입니다. + 멀티 샷 비디오를 생성할지 여부입니다. true이면 prompt 파라미터가 무효입니다. false이면 shot_type 및 multi_prompt 파라미터가 무효입니다. - 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 포지티브 프롬프트 내에 직접 부정 문장으로 보완하는 것이 권장됩니다. + 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 긍정 프롬프트 내에서 네거티브 문장으로 직접 보충하는 것을 권장합니다. - 포지티브 텍스트 프롬프트입니다. \<\<\>>을 사용하여 voice_list 파라미터 순서에 맞는 음성을 지정할 수 있습니다. 하나의 작업은 최대 2개의 톤을 참조할 수 있습니다. 톤을 지정할 때에는 sound 파라미터 값이 on이어야 합니다. + 긍정 텍스트 프롬프트입니다. \<\<\>>을 사용하여 voice_list 파라미터 순서에 맞는 음성을 지정할 수 있습니다. 하나의 작업은 최대 2개의 톤을 참조할 수 있습니다. 톤을 지정할 때는 sound 파라미터 값이 on이어야 합니다. @@ -284,28 +283,36 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 비디오 생성 시 사운드를 동시에 생성할지 여부입니다. V2.6 이후 버전의 모델만 이 파라미터를 지원합니다. + 비디오 생성 시 사운드를 함께 생성할지 여부입니다. V2.6 및 이후 버전의 모델만 이 파라미터를 지원합니다. 가능한 값: `on`, `off` - 동영상 생성 시 참조할 음성 목록입니다. 최대 2개의 음성을 지원하며, `prompt`에서 목록 순서대로 \<\<\>> 및 \<\<\>>로 참조합니다. `sound`를 "on"으로 설정해야 하며, 이는 V2.6 이후 버전의 모델에서만 지원됩니다. 이전 모델이거나 `sound`가 기본값 "off"로 남아 있으면 음성이 적용되지 않습니다. + 비디오 생성 시 참조되는 음성 목록입니다. 최대 2개의 음성을 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>>로 참조합니다. `sound`가 "on"으로 설정되어야 하며, 이는 V2.6 및 이후 버전의 모델만 지원합니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 음성이 적용되지 않습니다. - 음성 커스터마이즈 API가 반환한 음성 ID 또는 시스템 기본 제공 음성 ID입니다. + 음성 사용자 정의 API를 통해 반환된 음성 ID 또는 시스템 사전 설정 음성 ID입니다. - 워터마크가 있는 결과물을 동시에 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. + 워터마크가 적용된 결과를 함께 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. - true는 워터마크를 생성함을, false는 생성하지 않음을 의미합니다. + true는 워터마크를 생성함을 의미하고, false는 생성하지 않음을 의미합니다. + + + + 참조 이미지: URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. + + + + 참조 이미지: 종료 프레임 제어. URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. dynamic_masks/static_mask 또는 camera_control과 동시에 사용할 수 없습니다. -Router가 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +`GET /v2/models/kling/kling-v2-5-turbo/openapi.json`에서 Router가 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -318,7 +325,7 @@ Router가 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json`에서 제공하 - 작업 생성 시간, 밀리초 단위의 Unix 타임스탬프 + 작업 생성 시간, Unix 타임스탬프(밀리초) @@ -360,7 +367,7 @@ Router가 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json`에서 제공하 - 워터마크가 포함된 생성된 비디오의 URL, 핫링크 보호 형식 + 워터마크가 포함된 생성된 비디오의 URL, 핫링크 방지 형식 형식: `uri` @@ -372,11 +379,11 @@ Router가 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json`에서 제공하 - 작업 상태 정보로, 작업 실패 시 실패 사유를 표시합니다 + 작업 상태 정보로, 작업이 실패하면 실패 사유를 표시합니다 - 작업 업데이트 시간, 밀리초 단위의 Unix 타임스탬프 + 작업 업데이트 시간, Unix 타임스탬프(밀리초) diff --git a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx index 414979a62a..df16fa460a 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router로 Kling V2.6 사용하기" description: "Comfy Router를 통해 kling/kling-v2-6을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답." sidebarTitle: "Kling V2.6" -translationSourceHash: c445a7bd +translationSourceHash: 94eb0863 translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: - "_intro": 04868509 + "_intro": c2065202 "Quick start": 48a3d970 - "Schema": a61a551f + "Schema": cd52808d "Examples": 8623c725 --- - {/* 생성됨 파일. `pnpm code-pages:gen`이 router-schemas/kling/kling-v2-6.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; `kling/kling-v2-6`의 API 레퍼런스입니다. Kling에서 제공하며 Comfy Router가 서비스합니다. -**입력:** 텍스트 · **출력:** 비디오 +**입력:** 이미지, 텍스트 · **출력:** 비디오 ## 빠른 시작 @@ -166,7 +165,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 콜백 알림 주소. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. + 콜백 알림 주소입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -180,43 +179,43 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 카메라의 수평 축(x축) 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 나타냅니다. + 수평 축(x축)을 따른 카메라의 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 나타냅니다. - 범위: `-10` ~ `10` + 범위: `-10`부터 `10`까지 - 수직 평면에서의 카메라 회전(x축)을 제어합니다. 음수는 아래로 회전, 양수는 위로 회전을 나타냅니다. + 수직 평면(x축)에서의 카메라 회전을 제어합니다. 음수는 아래쪽 회전, 양수는 위쪽 회전을 나타냅니다. - 범위: `-10` ~ `10` + 범위: `-10`부터 `10`까지 카메라의 롤링 정도(z축)를 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 나타냅니다. - 범위: `-10` ~ `10` + 범위: `-10`부터 `10`까지 - 수평 평면에서의 카메라 회전(y축)을 제어합니다. 음수는 왼쪽으로 회전, 양수는 오른쪽으로 회전을 나타냅니다. + 수평 평면(y축)에서의 카메라 회전을 제어합니다. 음수는 왼쪽으로 회전, 양수는 오른쪽으로 회전을 나타냅니다. - 범위: `-10` ~ `10` + 범위: `-10`부터 `10`까지 - 카메라의 수직 축(y축) 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 나타냅니다. + 수직 축(y축)을 따른 카메라의 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 나타냅니다. - 범위: `-10` ~ `10` + 범위: `-10`부터 `10`까지 카메라 초점 거리의 변화를 제어합니다. 음수는 좁은 화각, 양수는 넓은 화각을 나타냅니다. - 범위: `-10` ~ `10` + 범위: `-10`부터 `10`까지 - 미리 정의된 카메라 움직임 유형입니다. simple: 사용자 정의 가능한 카메라 움직임. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하며 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하며 앞으로 이동합니다. + 미리 정의된 카메라 이동 유형입니다. simple: 사용자 정의 가능한 카메라 이동. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하고 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하고 앞으로 이동합니다. 가능한 값: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` @@ -224,7 +223,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ 비디오 생성의 유연성입니다. 값이 높을수록 모델의 유연성 정도가 낮아지고 사용자 프롬프트와의 관련성이 강해집니다. - 범위: `0` ~ `1` + 범위: `0`부터 `1`까지 형식: `float` @@ -236,21 +235,21 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 사용자 정의 작업 ID. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. + 사용자 지정 작업 ID입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. - 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드. pro: 더 긴 재생 시간과 더 높은 품질의 출력을 생성하는 프로페셔널 모드. + 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드입니다. pro: 더 긴 재생 시간의 비디오를 생성하지만 출력 품질이 더 높은 전문가 모드입니다. 가능한 값: `std`, `pro` - 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내면 되며, 모델은 요청 경로에 따라 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. + 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내십시오. 모델은 요청 경로로 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. - 프롬프트와 재생 시간 등 각 스토리보드에 대한 정보입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize일 때 필수입니다. + 프롬프트와 재생 시간 등 각 스토리보드에 대한 정보입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize인 경우 필수입니다. @@ -266,15 +265,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 멀티 샷 비디오를 생성할지 여부입니다. true이면 prompt 파라미터가 무효화됩니다. false이면 shot_type 및 multi_prompt 파라미터가 무효화됩니다. + 멀티 샷 비디오를 생성할지 여부입니다. true인 경우 prompt 파라미터는 유효하지 않습니다. false인 경우 shot_type 및 multi_prompt 파라미터는 유효하지 않습니다. - 네거티브 텍스트 프롬프트입니다. 긍정 프롬프트 내에 부정 문장을 직접 포함하여 네거티브 프롬프트 정보를 보완하는 것을 권장합니다. + 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 긍정 프롬프트 안에 부정문으로 직접 보충하는 것이 권장됩니다. - 긍정 텍스트 프롬프트입니다. \<\<\>>를 사용하여 voice_list 파라미터 순서에 맞는 음성을 지정할 수 있습니다. 하나의 작업은 최대 2개의 톤을 참조할 수 있습니다. 톤을 지정할 때는 sound 파라미터 값이 on이어야 합니다. + 긍정 텍스트 프롬프트입니다. \<\<\>>을 사용하여 voice_list 파라미터 순서에 맞는 목소리를 지정할 수 있습니다. 하나의 작업은 최대 2개의 목소리를 참조할 수 있습니다. 목소리를 지정할 때는 sound 파라미터 값이 on이어야 합니다. @@ -284,28 +283,36 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 비디오 생성 시 사운드를 동시에 생성할지 여부입니다. V2.6 이상 버전의 모델만 이 파라미터를 지원합니다. + 비디오 생성 시 사운드를 함께 생성할지 여부입니다. V2.6 및 이후 버전의 모델만 이 파라미터를 지원합니다. 가능한 값: `on`, `off` - 동영상 생성 시 참조할 음성 목록입니다. 최대 2개의 음성을 지원하며, `prompt`에서 목록 순서대로 \<\<\>> 및 \<\<\>>로 참조합니다. `sound`를 "on"으로 설정해야 하며, 이는 V2.6 이후 버전의 모델에서만 지원됩니다. 이전 모델이거나 `sound`가 기본값 "off"로 남아 있으면 음성이 적용되지 않습니다. + 비디오 생성 시 참조되는 목소리 목록입니다. 최대 2개의 목소리를 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>>로 참조할 수 있습니다. `sound`를 "on"으로 설정해야 하며, 이는 V2.6 및 이후 버전의 모델만 지원합니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 목소리는 적용되지 않습니다. - 음성 커스터마이즈 API가 반환한 음성 ID 또는 시스템 기본 제공 음성 ID입니다. + 목소리 사용자 정의 API를 통해 반환된 목소리 ID 또는 시스템 사전 설정 목소리 ID입니다. - 워터마크가 적용된 결과물을 동시에 생성할지 여부입니다. 사용자 정의 워터마크는 현재 지원되지 않습니다. + 워터마크가 있는 결과를 함께 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. - true는 워터마크를 생성함을, false는 생성하지 않음을 의미합니다. + true는 워터마크를 생성함을 의미하고, false는 생성하지 않음을 의미합니다. + + + + 참조 이미지 - URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사가 포함되어서는 안 됩니다. + + + + 참조 이미지 - 종료 프레임 제어. URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사가 포함되어서는 안 됩니다. dynamic_masks/static_mask 또는 camera_control과 동시에 사용할 수 없습니다. -Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스키마로부터 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용되는 것과 동일한 문서입니다. +Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 기준이 되는 것과 동일한 문서입니다. ### 출력 @@ -318,11 +325,11 @@ Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스 - 작업 생성 시간, Unix 타임스탬프(밀리초) + 작업 생성 시간, 밀리초 단위의 Unix 타임스탬프 - 작업의 차감 단위 + 작업의 차감 단위 수 @@ -354,13 +361,13 @@ Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스 - 생성된 비디오 URL + 생성된 비디오의 URL 형식: `uri` - 워터마크가 포함된 생성된 비디오 URL, 핫링크 보호 형식 + 워터마크가 포함된 생성 비디오의 URL, 핫링크 보호 형식 형식: `uri` @@ -372,11 +379,11 @@ Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스 - 작업 상태 정보, 작업 실패 시 실패 이유 표시 + 작업 상태 정보로, 작업이 실패할 때 실패 사유를 표시합니다 - 작업 업데이트 시간, Unix 타임스탬프(밀리초) + 작업 업데이트 시간, 밀리초 단위의 Unix 타임스탬프 diff --git a/ko/development/comfy-router/models/kling/kling-v3/code.mdx b/ko/development/comfy-router/models/kling/kling-v3/code.mdx index d41c7111ca..6010d60f36 100644 --- a/ko/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,25 +2,23 @@ title: "Comfy Router로 Kling V3 사용하기" description: "Comfy Router를 통해 kling/kling-v3 호출하기: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling V3" -translationSourceHash: e22b6413 +translationSourceHash: f5127eab translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: - "_intro": 74a12e0f + "_intro": 6b9cddba "Quick start": 09c0a41a "Serving providers": b4093d36 - "Schema": 8e8b04e6 + "Schema": 2fce4523 "Examples": 8623c725 --- - - {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/kling/kling-v3.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; `kling/kling-v3`에 대한 API 레퍼런스이며, Kling에서 Comfy Router를 통해 제공됩니다. -**입력:** 텍스트 · **출력:** 비디오 +**입력:** 이미지, 텍스트 · **출력:** 비디오 ## 빠른 시작 @@ -181,7 +179,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 콜백 알림 주소. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. + 콜백 알림 주소입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 사용자를 대신해 폴링합니다. 형식: `uri` @@ -195,49 +193,49 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 카메라의 수평 축(x축) 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 나타냅니다. + 카메라의 수평축(x축) 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 의미합니다. 범위: `-10` ~ `10` - 수직 평면(x축)에서의 카메라 회전을 제어합니다. 음수는 아래쪽 회전, 양수는 위쪽 회전을 나타냅니다. + 수직 평면에서의 카메라 회전(x축)을 제어합니다. 음수는 아래쪽 회전, 양수는 위쪽 회전을 의미합니다. 범위: `-10` ~ `10` - 카메라의 롤링 양(z축)을 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 나타냅니다. + 카메라의 롤링 양(z축)을 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 의미합니다. 범위: `-10` ~ `10` - 수평 평면(y축)에서의 카메라 회전을 제어합니다. 음수는 왼쪽 회전, 양수는 오른쪽 회전을 나타냅니다. + 수평 평면에서의 카메라 회전(y축)을 제어합니다. 음수는 왼쪽으로 회전, 양수는 오른쪽으로 회전을 의미합니다. 범위: `-10` ~ `10` - 카메라의 수직 축(y축) 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 나타냅니다. + 카메라의 수직축(y축) 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 의미합니다. 범위: `-10` ~ `10` - 카메라 초점 거리의 변화를 제어합니다. 음수는 좁은 화각, 양수는 넓은 화각을 나타냅니다. + 카메라 초점 거리의 변화를 제어합니다. 음수는 좁은 시야각, 양수는 넓은 시야각을 의미합니다. 범위: `-10` ~ `10` - 사전 정의된 카메라 이동 유형입니다. simple: 사용자 정의 가능한 카메라 이동입니다. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하고 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하고 앞으로 이동합니다. + 미리 정의된 카메라 이동 유형입니다. simple: 사용자 정의 가능한 카메라 이동. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하며 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하며 앞으로 이동합니다. 가능한 값: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - 비디오 생성에서의 유연성입니다. 값이 높을수록 모델의 유연성은 낮아지고 사용자 프롬프트와의 관련성은 강해집니다. + 비디오 생성의 유연성입니다. 값이 높을수록 모델의 유연성 정도가 낮아지고 사용자 프롬프트와의 관련성이 강해집니다. 범위: `0` ~ `1` @@ -245,31 +243,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 비디오 재생 시간(초) + 비디오 길이(초) 가능한 값: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 사용자 정의 작업 ID. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. + 사용자 지정 작업 ID입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 사용자를 대신해 폴링합니다. - 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드입니다. pro: 전문가 모드로, 재생 시간이 더 길고 출력 품질이 더 높은 비디오를 생성합니다. + 비디오 생성 모드입니다. std: 표준 모드로 비용 효율적입니다. pro: 전문가 모드로, 더 긴 재생 시간의 비디오를 더 높은 품질로 생성합니다. 가능한 값: `std`, `pro` - 모델 이름입니다. Comfy Router를 사용할 때는 이를 생략하거나 null을 전송하세요. 모델은 요청 경로에 따라 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. + 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내십시오. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. - 프롬프트와 재생 시간 등 각 스토리보드에 대한 정보입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize인 경우 필수입니다. + 프롬프트와 재생 시간 등 각 스토리보드에 대한 정보입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize일 때 필수입니다. - 이 스토리보드의 재생 시간(초)입니다. 전체 작업 재생 시간을 초과할 수 없으며 1보다 작을 수 없습니다. 모든 스토리보드 재생 시간의 합은 전체 작업 재생 시간과 같습니다. + 이 스토리보드의 재생 시간(초)입니다. 전체 작업 재생 시간을 초과할 수 없으며 1보다 작을 수 없습니다. 모든 스토리보드 재생 시간의 합은 전체 작업 재생 시간과 같아야 합니다. @@ -277,50 +275,58 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 이 스토리보드의 프롬프트입니다. 최대 길이는 512자입니다. + 이 스토리보드의 프롬프트 단어입니다. 최대 길이는 512자입니다. - 멀티 샷 비디오를 생성할지 여부입니다. true이면 prompt 파라미터가 무효입니다. false이면 shot_type 및 multi_prompt 파라미터가 무효입니다. + 멀티 샷 비디오를 생성할지 여부입니다. true일 때 prompt 파라미터는 유효하지 않습니다. false일 때 shot_type 및 multi_prompt 파라미터는 유효하지 않습니다. - 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 포지티브 프롬프트 내에 직접 네거티브 문장으로 보완하는 것을 권장합니다. + 네거티브 텍스트 프롬프트입니다. 포지티브 프롬프트 안에 직접 부정 문장을 넣어 네거티브 프롬프트 정보를 보완하는 것을 권장합니다. - 포지티브 텍스트 프롬프트입니다. `voice_list` 파라미터 순서와 일치하는 음성을 지정하려면 \<\<\>>을 사용하세요. 하나의 작업은 최대 2개의 톤을 참조할 수 있습니다. 톤을 지정할 때는 sound 파라미터 값이 on이어야 합니다. + 포지티브 텍스트 프롬프트입니다. \<\<\>> 을 사용해 voice_list 파라미터 순서에 맞는 음성을 지정할 수 있습니다. 작업 하나에서 최대 2개의 톤을 참조할 수 있습니다. 톤을 지정할 때는 sound 파라미터 값이 on이어야 합니다. - 스토리보드 방식입니다. multi_shot 파라미터가 true로 설정된 경우 필수입니다. + 스토리보드 방법입니다. multi_shot 파라미터가 true로 설정된 경우 필수입니다. 가능한 값: `customize`, `intelligence` - 비디오를 생성할 때 사운드도 함께 생성할지 여부입니다. 모델 V2.6 이상 버전에서만 이 파라미터를 지원합니다. + 비디오 생성 시 사운드를 동시에 생성할지 여부입니다. 모델 V2.6 이상 버전만 이 파라미터를 지원합니다. 가능한 값: `on`, `off` - 동영상 생성 시 참조할 음성 목록입니다. 최대 2개의 음성을 지원하며, `prompt`에서 목록 순서대로 \<\<\>> 및 \<\<\>>로 참조합니다. `sound`를 "on"으로 설정해야 하며, 이는 V2.6 이후 버전의 모델에서만 지원됩니다. 이전 모델이거나 `sound`가 기본값 "off"로 남아 있으면 음성이 적용되지 않습니다. + 비디오 생성 시 참조하는 음성 목록입니다. 최대 2개의 음성을 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>> 로 참조하십시오. `sound`를 "on"으로 설정해야 하며, 이는 모델 V2.6 이상 버전만 지원합니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 음성은 적용되지 않습니다. - 음성 커스터마이즈 API가 반환한 음성 ID 또는 시스템 기본 제공 음성 ID입니다. + 음성 사용자 정의 API를 통해 반환된 음성 ID 또는 시스템 사전 설정 음성 ID입니다. - 워터마크가 포함된 결과를 함께 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. + 워터마크가 있는 결과물을 동시에 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. - true는 워터마크를 생성함을, false는 생성하지 않음을 의미합니다. + true는 워터마크를 생성한다는 의미이고, false는 생성하지 않는다는 의미입니다. + + + + 참조 이미지: URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. + + + + 참조 이미지: 종료 프레임 제어. URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. dynamic_masks/static_mask 또는 카메라 제어와 동시에 사용할 수 없습니다. -Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 문서와 동일합니다. ### 출력 @@ -333,7 +339,7 @@ Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키 - 작업 생성 시간, Unix timestamp(밀리초) + 작업 생성 시간, Unix 타임스탬프(밀리초) @@ -369,13 +375,13 @@ Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키 - 생성된 비디오의 URL + 생성된 비디오 URL 형식: `uri` - 워터마크가 포함된 생성된 비디오의 URL, 핫링크 보호 형식 + 워터마크가 적용된 생성된 비디오 URL, 핫링크 방지 형식 형식: `uri` @@ -387,11 +393,11 @@ Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키 - 작업 상태 정보, 작업 실패 시 실패 이유를 표시합니다 + 작업 상태 정보로, 작업 실패 시 실패 이유를 표시합니다 - 작업 업데이트 시간, Unix timestamp(밀리초) + 작업 업데이트 시간, Unix 타임스탬프(밀리초) diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index 7c8a61bffb..20b60709ce 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 HappyHorse 1.0 I2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/happyhorse-1.0-i2v을 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "HappyHorse 1.0 I2V" -translationSourceHash: fd06ba6e +translationSourceHash: da380385 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx translationBlockHashes: "_intro": 7d98975f "Quick start": c7e0bda8 - "Schema": 8445191f + "Schema": 229263d1 "Examples": 5ffd46d7 --- + {/* GENERATED FILE. 이 디렉터리의 code.yaml을 편집한 뒤 `pnpm code-pages:gen`을 실행하세요. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -210,85 +211,84 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-i2v/requests/$REQUEST_ID - 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 -사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 -받지 않습니다. 이들은 first_frame 유형의 media 요소로 첫 프레임을 받으며(아래 media -참조), wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 -happyhorse-1.1-i2v에서 공급자가 거부합니다. 그리고 wan2.7/wan3.0 표기도 참조 -에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. +wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 +받지 않습니다. 이들은 first_frame 유형의 media 요소로 받으며(아래 media 참조), +wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 +공급자가 거부합니다. 그리고 wan2.7/wan3.0 표기는 참조 에셋을 media로 받습니다. +이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 -모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 비디오 -입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지 여부는 모델마다 -다릅니다. 모델별로 지원되는 type 값은 다음과 같습니다: -- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame과 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 종횡비 1:8에서 8:1 사이, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio(WAV/MP3, 2-30초, 최대 15MB)와 first_clip(MP4/MOV, 2-10초, - 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 + 미디어 에셋 목록입니다. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 +제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 +이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아닌 여기에서 받는지 +여부는 모델마다 다릅니다. 모델별 지원 type 값: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, + 최대 20MB, 공용 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB): 공용 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video가 최소 하나 필요하며, 참조 이미지와 - 참조 비디오를 합쳐 최대 5개입니다. first_frame과 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 변당 240-8000 픽셀, 종횡비 1:8에서 8:1 사이, 최대 - 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 - 허용되지 않음)와 선택적 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 변당 240-8000 픽셀, 종횡비 1:8에서 8:1 사이, 최대 20MB, 공개 URL +- wan2.7-r2v: first_frame (선택 사항, 최대 1), reference_image, reference_video. + reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 + reference 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: + JPEG/JPG/PNG/BMP/WEBP (알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 + 1:8~8:1, 최대 20MB, 공용 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공용 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB, 공용 HTTP/HTTPS URL이며 인라인 data: URL은 + 허용되지 않음)와 선택적 reference_image 0~4개 (JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 20MB, 공용 URL 또는 data:\{MIME_type};base64,... URL). -- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), - reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 - 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 - 순서는 프롬프트에서 에셋의 참조 순서(이미지 1, 비디오 1, 오디오 1, ...)를 - 정의합니다. first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, - 변당 240-8000 픽셀, 종횡비 최대 8:1, 최대 20MB, 공개 URL 또는 +- wan3.0-video, wan3.0-video-prime: first_frame (최대 1), last_frame (최대 1), + reference_image (최대 10), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1, link와 함께 + 사용 불가), link (최대 1, file과 함께 사용 불가). reference_*/file/link 유형과 + first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 순서가 + 프롬프트 내 에셋의 참조 순서를 정의합니다(Image 1, Video 1, Audio 1, ...). + first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공용 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: - 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. + 공용 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. - happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 - 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 종횡비 - 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 + 1:2.5~2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공용 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이 모델의 - 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 - 이 작업의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 종횡비 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 - 선택적 0~5개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, - 종횡비 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL). +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 + 모델의 유일한 참조 입력입니다. 짧은 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, + 최대 20MB, 공용 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 + 이 연산의 입력 유형이 아닙니다. +- happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5~2.5:1, + 최대 100MB, 공용 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택적 + reference_image 0~5개 (JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 + 1:2.5~2.5:1, 최대 20MB, 공용 URL 또는 data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 - 문서화되어 있지 않으므로 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 media + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 media 입력이 + 문서화되어 있지 않으므로 이 필드를 설정하지 않은 채로 두십시오. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 media 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. 허용되는 유형과 그 -상한이 모델마다 다르므로 media에는 minItems/maxItems가 선언되어 있지 않습니다. 스키마가 -받아들인다고 해서 공급자가 받아들인다는 뜻은 아닙니다. 그리고 반대 방향으로, 위의 -에셋별 "최대 20MB" 수치, 즉 인라인으로 전송될 수 있는 유일한 입력인 이미지 입력의 -상한은 파트너가 최종적으로 받게 되는 에셋에 대한 파트너의 상한이며, 해당 바이트는 -Comfy를 거치지 않으므로 에셋이 공개 URL일 때는 적힌 그대로 적용됩니다. 인라인 -data:\{MIME_type};base64,... URL은 실제로 Comfy를 거치며 전송 상한도 함께 적용됩니다. Comfy -Router의 POST 본문은 총 100 MiB로 제한되어 이를 초과하면 413으로 응답되며, base64는 -페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기의 어떤 파트너 -규칙에 도달하기 전에 거부됩니다. 그 크기에서는 파트너 자체의20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나일 때는 파트너 규칙이 제약이 됩니다. -전송 한도는 여러 에셋에 걸쳐 적용되는데, 100 MiB Router 상한이 각 요소가 아니라 -요청 전체를 제한하기 때문입니다. 이러한 한도에 근접하는 값은 공개 URL로 전송하세요. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 +minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한이 모델마다 +다르기 때문입니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 그리고 +반대 방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 +입력인 이미지 입력의 상한이며, 파트너가 최종적으로 보유하는 에셋에 대한 파트너의 +상한입니다. 이 수치는 에셋이 공용 URL일 때 그대로 적용되는데, 해당 바이트가 Comfy를 +거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 +전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 넘으면 +413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 +인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 +자체의 단일 에셋은20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. +전송 한도는 여러 에셋에 걸쳐 구속력을 가지는데, 100 MiB Router 상한이 각 요소가 아니라 +요청 전체를 제한하기 때문입니다. 이 한도에 근접하는 것은 무엇이든 공개 URL로 보내십시오. @@ -298,40 +298,37 @@ Router의 POST 본문은 총 100 MiB로 제한되어 이를 초과하면 413으 - 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 (위 `media` 설명에서 각 모델별로 나열한 바로 그 IMAGE 입력, 즉 wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image에 한해) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기에서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명에서 각 모델별로 나열한 IMAGE 입력에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 해당 IMAGE 입력은 wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame과 last_frame과 reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, 그리고 happyhorse-1.0-video-edit의 reference_image입니다. 이 모델들 중 어느 것에서도 video, audio, file, link 입력은 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스가 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그런 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참조하십시오. - 역 프롬프트 단어는 비디오 화면에 나타나지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다. + 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 거부하지 않고 이를 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 제한을 초과하는 콘텐츠는 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용해 -참조 비디오 순서대로 피사체를 지칭합니다. 예: "Character1이 길가에서 노래하고, Character2가 옆에서 춤춥니다" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 media 배열 내 -해당 순서의 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 자체적으로 문서화된 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자를 받습니다. 공급자는 prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)를 넘는 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. +여러 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 참조 비디오 순서대로 피사체를 지칭하십시오. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내의 해당 순서에 있는 미디어 에셋을 지칭하십시오. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개 비디오 URL의 배열입니다. -입력 제한 사항: + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. +입력 제한: - 형식: mp4, mov -- 개수: 비디오 1-3개 +- 수량: 1-3개 비디오 - 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없음 -참조 재생 시간: 단일 비디오는 최대 5초, 비디오 2개는 각각 최대 2.5초, 비디오 3개는 그보다 비례적으로 짧습니다. +참조 재생 시간: 단일 비디오 최대 5초, 두 비디오는 각각 최대 2.5초, 세 비디오는 그에 비례하여 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원되는 값: squish, flying, carousel. 사용하면 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 enum은 해당 작업 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 열거형은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -339,12 +336,12 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 +- auto (기본값): 모델이 프롬프트 콘텐츠를 바탕으로 지능적으로 판단합니다 - origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 가능한 값: `auto`, `origin` @@ -354,26 +351,26 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 생성되는 비디오의 재생 시간(초)입니다: - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 가능 (15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 입력 - 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 초과할 수 없습니다. -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30]을 벗어나는 재생 시간에 대해 400을 반환합니다. +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 총 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 + 모델이 적합한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능적 재작성 활성화 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 true입니다 - 생성된 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. -wan2.7 모델의 경우 제공하지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -화면 비율을 자동으로 추천합니다. + 생성된 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)가 적합한aspect ratio based on the input media proportions and intent. +입력 미디어의 비율과 의도에 따라 결정되는 종횡비입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -381,18 +378,18 @@ wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 이 프록시는 확인하기 이전에 해상도를 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 속하지 않는 값에는 400을 반환하고, 위에 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 보내든 480P size로 보내든)에는 400을 반환합니다. +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) +- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) +- happyhorse-1.0-*(t2v, i2v, r2v, video-edit): 720P, 1080P +- happyhorse-1.1-*(t2v, i2v, r2v): 480P, 720P, 1080P +이 프록시는 해상도와 size를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. 해상도 등급이 과금 요율을 결정하기 때문입니다. 해상도는 검사 전에 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P를 지원하지 않는다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 보내든 480P 크기로 보내든)에 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다. 범위: `0` ~ `2147483647` @@ -400,7 +397,7 @@ wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오 (기본값) +- single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 가능한 값: `multi`, `single` @@ -408,20 +405,18 @@ wan2.6 및 wan2.7-r2v 모델용입니다. width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V의 경우 (480P 없음): +wan2.5 T2V: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해상도는 여전히 -이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 -480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 과금 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 해상도 설명에서 480P를 지원하지 않는다고 나열한 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부입니다. 워터마크는 오른쪽 아래 모서리에 표시됩니다. -`GET /v2/models/wan/happyhorse-1.0-i2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 기준이 되는 동일한 문서입니다. +`GET /v2/models/wan/happyhorse-1.0-i2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -430,7 +425,7 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 지능형 재작성 이후의 실제 프롬프트 (비디오 작업용) + 지능형 재작성 이후의 실제 프롬프트 (비디오 작업의 경우) @@ -450,7 +445,7 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 원본 입력 프롬프트 (비디오 작업용) + 원본 입력 프롬프트 (비디오 작업의 경우) @@ -462,11 +457,11 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 이미지 오류 코드 (일부 작업이 실패할 때 반환됨) + 이미지 오류 코드 (일부 작업이 실패하면 반환됨) - 이미지 오류 정보 (일부 작업이 실패할 때 반환됨) + 이미지 오류 정보 (일부 작업이 실패하면 반환됨) @@ -516,11 +511,11 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 고유 요청 식별자 + 고유한 요청 식별자 - 출력 정보 통계. 성공한 결과만 집계됩니다 + 출력 정보 통계. 성공한 결과만 집계됨 @@ -540,7 +535,7 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 입력 비디오의 재생 시간(초), 비디오 입력이 없으면 0.0 (wan3.0-video 작업) + 입력 비디오의 재생 시간(초), 비디오 입력이 없을 때는 0.0 (wan3.0-video 작업) @@ -568,11 +563,11 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아닌 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 항목을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아닌 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 먼저 이 값을 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index 456dca8a6f..37cc1fcfea 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 HappyHorse 1.0 R2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/happyhorse-1.0-r2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "HappyHorse 1.0 R2V" -translationSourceHash: d2eee702 +translationSourceHash: 93ba1a2d translationFrom: development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx translationBlockHashes: "_intro": 39853fc0 "Quick start": eafea158 - "Schema": 5a777640 + "Schema": 3deb0e2f "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -213,79 +214,79 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v/requests/$REQUEST_ID - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기서 받지 -않습니다. 대신 first_frame 유형의 media 요소로 받으며(아래 media 참조), wan2.6-i2v에서 -성공하는 img_url 본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 공급자가 -거부합니다. 또한 wan2.7/wan3.0 표기도 참조 에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 않습니다. +first_frame 유형의 미디어 요소로 받으며(아래 media 참조), wan2.6-i2v에서 성공하는 +img_url 본문은 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서 공급자가 거부합니다. +또한 wan2.7/wan3.0 표기는 참조 에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아니라 여기서 받는지 -여부는 모델마다 다릅니다. 모델별 지원 type 값: -- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame과 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변당 240-8000 픽셀, 가로세로 비율 1:8 - ~ 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio(WAV/MP3, 2-30초, 최대 15MB)와 first_clip(MP4/MOV, 2-10초, - 한 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 + 미디어 에셋 목록. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 지정합니다. +각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 모든 +모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 비디오 입력을 +img_url 또는 reference_video_urls가 아닌 여기에서 받는지 여부는 모델마다 다릅니다. +모델별 지원 type 값은 다음과 같습니다: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8 + 에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 - reference 비디오를 합쳐 최대 5개입니다. first_frame과 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 한 변당 240-8000 픽셀, 가로세로 비율 1:8 ~ 8:1, 최대 +- wan2.7-r2v: first_frame (선택 사항, 최대 1), reference_image, reference_video. 최소 + 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 + reference 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP + (알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 한 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 - 허용되지 않음)와 선택 사항인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 한 변당 240-8000 픽셀, 가로세로 비율 1:8 ~ 8:1, 최대 20MB, 공개 URL + HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 + 허용되지 않음)와 선택적 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). -- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), - reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 - 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 같은 요청 안에서 상호 배타적입니다. 배열 - 순서가 프롬프트에서 에셋의 참조 순서를 정의합니다(Image 1, Video 1, Audio 1, ...). +- wan3.0-video, wan3.0-video-prime: first_frame (최대 1), last_frame (최대 1), + reference_image (최대 10), reference_video (최대 5개 클립, 총 재생 시간 \<= 15s), + reference_audio (최대 5개 클립, 총 재생 시간 \<= 15s), file (최대 1, link와 함께 + 사용 불가), link (최대 1, file과 함께 사용 불가). reference_*/file/link 유형과 + first_frame/last_frame 유형은 같은 요청 안에서 상호 배타적입니다. 배열 순서가 + 프롬프트 내 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 정의합니다. first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, - 한 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: - 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. + 각 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 + HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. - happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 - 첫 프레임을 img_url이 아니라 여기서 받습니다. 최소 300x300 픽셀, 가로세로 비율 - 1:2.5 ~ 2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 + 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 - 모델의 유일한 참조 입력입니다. 최단 변이 최소 400 픽셀, JPEG/JPG/PNG/WEBP, +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 + 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5 ~ 2.5:1, - 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택 - 사항인 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 - 비율 1:2.5 ~ 2.5:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). +- happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 + 사이, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음)와 + 선택적 0~5개의 reference_image (JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, + 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 media 입력이 - 문서화되어 있지 않으므로 이 필드를 설정하지 마세요. + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 기재되어 있지 않으므로 이 필드를 설정하지 마십시오. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 - 어떤 media 어휘도 나열하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 - 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한이 모델마다 다르기 -때문입니다. 스키마가 받아들인다고 해서 공급자가 받아들인다는 뜻은 아니며, 반대 -방향으로 위의 에셋별 "최대 20MB" 수치(인라인으로 전송될 수 있는 유일한 입력인 -이미지 입력에 대한 상한)는 파트너가 최종적으로 갖게 되는 에셋에 대한 파트너의 -상한이며, 해당 바이트가 결코 Comfy를 거치지 않으므로 에셋이 공개 URL일 때는 그대로 -적용됩니다. 인라인 data:\{MIME_type};base64,... -URL은 실제로 Comfy를 거치므로 전송 상한도 함께 적용됩니다. Comfy Router -POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 -페이로드를 약 4/3만큼 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기의 -어떤 파트너 규칙에도 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나일 때는 파트너 규칙이 구속력을 갖습니다. -전송 상한은 여러 에셋에 걸칠 때 구속력을 갖습니다. 100 MiB Router 상한이 각 요소가 아니라 -요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 공개 URL로 보내세요. + 어떤 미디어 유형도 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 + 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 + 받습니다. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 +minItems/maxItems가 선언되어 있지 않습니다. 허용되는 유형과 그 상한이 모델마다 +다르기 때문입니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아니며, 반대 +방향도 마찬가지입니다. 위의 에셋별 "최대 20MB" 수치는 이미지 입력, 즉 인라인으로 +전송될 수 있는 유일한 입력에 대한 상한이며, 파트너가 최종적으로 받는 에셋에 대한 +상한입니다. 에셋이 공개 URL일 때는 그대로 적용되는데, 그 바이트가 Comfy를 거치지 +않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 +전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 +초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 +넘는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 +크기에서는 파트너 자체의20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. 여러 에셋에 걸치면 전송 한도가 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 한도에 가까운 것은 공개 URL로 보내세요. @@ -295,42 +296,26 @@ POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하 - 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 위의 `media` 설명이 각 모델에 대해 나열한 바로 그 IMAGE 입력 -(wan2.7-i2v의 first_frame과 last_frame; wan2.7-r2v의 first_frame과 reference_image; wan2.7-videoedit의 -reference_image; wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image; -happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame; happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 -reference_image; 그리고 happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 -`data:{MIME_type};base64,...` URL입니다. 이 모델들에서 비디오, 오디오, 파일 또는 링크 입력은 인라인 -data: URL을 받지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL이나 -(wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 -확인됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// -URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 -여기에서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 -총합으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 정확히 위의 `media` 설명에서 각 모델별로 나열한 IMAGE 입력에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 해당 대상은 wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image입니다. 이 모델들 중 어떤 비디오, 오디오, 파일, 링크 입력도 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스가 발급하는 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다 + 네거티브 프롬프트 단어는 비디오 화면에 나타나지 않기를 원하는 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 제한을 초과하는 콘텐츠는 잘립니다). -참조 비디오가 여러 개인 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 참조 비디오 -순서대로 주체를 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내 해당 -순서대로 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 문서화된 자체 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자까지 받습니다. prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000자의 중국어)를 넘으면 공급자는 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. 참조 비디오가 여러 개인 wan2.6-r2v에서는 참조 비디오 순서대로 'character1', 'character2' 등을 사용해 피사체를 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" wan3.0-video 참조 모드에서는 media 배열 내 해당 순서대로 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 미디어 에셋을 지칭합니다. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. -입력 제한 사항: + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. +입력 제한: - 형식: mp4, mov -- 개수: 비디오 1~3개 -- 단일 비디오 길이: 2~30초 +- 개수: 1-3개 비디오 +- 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB -- audio_url과 함께 사용할 수 없음 -참조 재생 시간: 비디오 하나는 최대 5초, 비디오 둘은 각각 최대 2.5초, 비디오 셋은 그보다 비례적으로 짧습니다. +- audio_url과 함께 사용할 수 없습니다 +참조 재생 시간: 비디오 1개는 최대 5초, 2개는 각각 최대 2.5초, 3개는 그보다 비례적으로 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. @@ -339,7 +324,7 @@ wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 열거형은 해당 작업 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -347,7 +332,7 @@ wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않았습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에는 그러한 전환을 문서화하지 않았습니다. @@ -359,29 +344,28 @@ wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 생성되는 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초)입니다. - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 총 입력 - 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 모델이 적절한 - 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30] 범위를 벗어나는 재생 시간에 대해 400을 반환합니다. +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 합니다. -1은 + 모델이 적합한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능형 재작성 활성화 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성 사용 여부입니다. 기본값은 true입니다 - 생성된 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델에만 적용됩니다. + 생성되는 비디오의 가로세로 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -화면 비율을 자동으로 추천합니다. +wan3.0-video의 경우 adaptive(기본값)가 자동으로 적합한 값을 추천합니다입력 미디어의 비율과 의도에 따라 결정되는 종횡비입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -389,46 +373,45 @@ wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의 해상도 수준입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본 1080P) +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) +- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P - -이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 선택하기 때문입니다. 해상도를 검사하기 이전에 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 속하지 않는 값에 대해서는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P size로 보내든)에 대해 400을 반환합니다. +이 프록시는 resolution과 size를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. 해상도 등급이 과금 요율을 결정하기 때문입니다. 확인하기 전에 resolution을 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(resolution으로 보내든 480P size로 보내든)에 대해 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 모델이 생성한 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다. 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. + 지능형 다중 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오 (기본값) -- multi: 멀티 샷 비디오 +- single: 단일 샷 비디오(기본값) +- multi: 다중 샷 비디오 가능한 값: `multi`, `single` width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V의 경우 (480P 없음): +wan2.5 T2V: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 과금 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에서 허용하는 값이어야 합니다. 480P size는 resolution 설명에서 480P가 없다고 나열된 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부입니다. 워터마크는 오른쪽 아래 모서리에 위치합니다. -`GET /v2/models/wan/happyhorse-1.0-r2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 대상이 되는 동일한 문서입니다. +Router가 `GET /v2/models/wan/happyhorse-1.0-r2v/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. ### 출력 @@ -509,7 +492,7 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 총 작업 수 + 전체 작업 수 diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index 6fadc9db7a..3946c61ca1 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 HappyHorse 1.1 I2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/happyhorse-1.1-i2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "HappyHorse 1.1 I2V" -translationSourceHash: ee562b54 +translationSourceHash: 8d29660e translationFrom: development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx translationBlockHashes: "_intro": 2419a89f "Quick start": c705001d - "Schema": 54511f6f + "Schema": bb6bb958 "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -210,85 +211,84 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v/requests/$REQUEST_ID - 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3, wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 -않습니다. 해당 표기들은 이를 first_frame 유형의 media 요소로 받으며(아래 media -참조), wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 -happyhorse-1.1-i2v에서 공급자가 거부합니다. 그리고 wan2.7/wan3.0 표기도 참조 에셋을 -media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 +받지 않습니다. first_frame 유형의 media 요소로 받으며(아래 media 참조), +wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 +공급자가 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 media로 받습니다. +이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아닌 여기에서 전달하는지 -여부는 모델마다 다릅니다. 모델별로 지원되는 type 값은 다음과 같습니다: + 미디어 에셋 목록입니다. 비디오 생성에 사용할 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소에는 type과 url 필드가 포함됩니다. 이 필드는 이 컴포넌트에서 +제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 +비디오 입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지 여부는 +모델마다 다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 - 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, - 한 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 - data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 - reference 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 한 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, + 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, + 한 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 + 허용되지 않습니다. +- wan2.7-r2v: first_frame(선택, 최대 1개), reference_image, reference_video. 최소 + 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 + reference 비디오는 합쳐 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP + (알파 채널 없음), 한 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집할 클립: MP4/MOV, 2-10초, - 한 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 - 허용되지 않음)와 선택적 0개에서 4개까지의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 한 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL +- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 한 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 + 허용되지 않음) 및 선택적 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 한 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). - wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 - 순서가 프롬프트에서 에셋의 참조 순서를 정의합니다(Image 1, Video 1, - Audio 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 유형과 first_frame/last_frame 유형은 같은 요청 안에서 상호 배타적입니다. + 배열 순서가 프롬프트에서 에셋의 참조 순서(이미지 1, 비디오 1, 오디오 1, ...)를 + 정의합니다. first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 한 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: - 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 + HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. - happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 - 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + 1:2.5~2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1개에서 9개까지. 이것이 - 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 + 모델의 유일한 참조 입력입니다. 최단 변 400 픽셀 이상, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집할 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않음)와 선택적 - 0개에서 5개까지의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, - 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL). +- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5~2.5:1, 최대 + 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음) 및 선택적 + 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 + 1:2.5~2.5:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 media 입력이 문서화되어 있지 않으므로 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 media - 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url에서 - 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 media + 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 + img_url로 받고, wan2.6-r2v는 참조 클립을 reference_video_urls로 받습니다. 위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. media에는 minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한이 모델마다 다르기 -때문입니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 반대 방향으로, -위의 에셋별 "최대 20MB" 수치는 이미지 입력, 즉 인라인으로 전송될 수 있는 유일한 -입력에 대한 상한이며, 최종적으로 처리되는 에셋에 대한 파트너의 상한이고, 해당 -바이트는 Comfy를 거치지 않으므로 에셋이 공개 URL일 때는 명시된 그대로 적용됩니다. -인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 적용됩니다. -Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, -base64는 페이로드를 약 4/3로 부풀리므로, 대략 75 MB를 넘는 단일 인라인 에셋은 여기 -있는 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서는 단일 에셋이 파트너 자체의20MB 상한은 인라인으로 무리 없이 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 적용됩니다. -전송 상한은 여러 에셋에 걸쳐 적용되는데, 100 MiB Router 상한은 각 요소가 아니라 -전체 요청을 제한하기 때문입니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 -전송하세요. +때문입니다. 스키마가 통과되었다고 해서 공급자가 받아들인다는 뜻은 아니며, 반대 +방향으로도 마찬가지입니다. 위의 에셋별 "최대 20MB" 수치, 즉 인라인으로 전송될 수 있는 +유일한 입력인 이미지 입력의 상한은 파트너가 최종적으로 받게 되는 에셋에 대한 파트너의 +상한이며, 에셋이 공개 URL일 때는 그대로 적용됩니다. 그 바이트는 Comfy를 거치지 않기 +때문입니다. 인라인 data:\{MIME_type};base64,... URL은 실제로 Comfy를 거치므로 전송 +상한도 함께 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 넘으면 +413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 +인라인 에셋은 여기 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의 +단일 에셋이20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나일 때는 파트너 규칙이 제약이 됩니다. +여러 개일 때는 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 +전체를 제한하기 때문입니다. 이 상한에 가까운 것은 무엇이든 공개 URL로 보내세요. @@ -298,32 +298,35 @@ base64는 페이로드를 약 4/3로 부풀리므로, 대략 75 MB를 넘는 단 - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명이 각 모델에 대해 나열하는 바로 그 IMAGE 입력(wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 대해서만 인라인 `data:{MIME_type};base64,...` URL을 사용할 수 있습니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL이거나, 정확히 위의 `media` 설명이 각 모델에 대해 나열한 IMAGE 입력의 경우 인라인 `data:{MIME_type};base64,...` URL입니다. 해당 IMAGE 입력은 wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 확인됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참조하세요. - 역방향 프롬프트 단어는 비디오 화면에 나타나지 않길 원하는 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자, 제한을 초과하는 콘텐츠는 잘립니다). -참조 비디오가 여러 개인 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 -참조 비디오 순서대로 피사체를 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 -media 배열 내 해당 순서의 미디어 에셋을 지칭하세요. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 자체적으로 문서화된 길이를 넘으면 wan2.x 모델은 +프롬프트를 거부하지 않고 잘라냅니다: wan2.5 및 wan2.6은 1,500자, wan2.7은 5,000자입니다. +wan3.0-video 및 wan3.0-video-prime은 최대 20,000자를 받습니다. 공급자는 prompt와 negative_prompt를 +합쳐 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)보다 긴 요청을 거부하며, +InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. +여러 참조 비디오가 있는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 참조 비디오 +순서대로 피사체를 가리키세요. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내 +해당 순서의 미디어 에셋을 가리키세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. -입력 제한 사항: + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. +입력 제한: - 형식: mp4, mov -- 개수: 비디오 1-3개 -- 단일 비디오 길이: 2-30초 +- 수량: 비디오 1~3개 +- 단일 비디오 길이: 2~30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없음 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그보다 비례하여 짧아짐. -과금: 실제 사용된 참조 재생 시간을 기준으로 함. +참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그보다 비례적으로 짧습니다. +과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. @@ -331,7 +334,7 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭하세요. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 이를 반드시 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 열거형은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -339,13 +342,13 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭하세요. - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원됩니다. 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video 및 wan3.0-video-prime만 지원하며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 +- auto (기본값): 모델이 prompt 콘텐츠를 기반으로 지능적으로 판단합니다. +- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다. 가능한 값: `auto`, `origin` @@ -354,72 +357,77 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭하세요. 생성되는 비디오의 재생 시간(초)입니다: - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 가능 (15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없음, -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화함 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수; 비디오 입력이 있으면 총 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다; -1은 + 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다. 이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능형 재작성이 활성화되었는지 여부입니다. 기본값은 true입니다 + 프롬프트 지능적 재작성 활성화 여부입니다. 기본값은 참입니다. - 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. + 생성된 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -화면 비율을 자동으로 추천합니다. +wan3.0-video의 경우 adaptive(기본값)가 적절한 값을 자동으로 추천합니다.aspect ratio는 입력 미디어의 비율과 의도에 따라 결정됩니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 수준입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 가능(480P 미지원) +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) - wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 이 프록시는 검사하기 전에 resolution을 대문자로 변환하고 변환된 값을 전달하며, 이 열거형에 없는 값에 대해서는 400을 반환하고, 위에 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(resolution으로 보내든 480P size로 보내든)에 대해서는 400을 반환합니다. +이 프록시는 resolution과 size를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. +해상도 등급이 청구 요율을 결정하기 때문입니다. 검사 전에 resolution을 대문자로 +변환하고 변환된 값을 그대로 전달하며, 이 열거형 밖의 값에는 400을 반환하고, +위에서 480P 미지원으로 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 +480P에 대해(resolution으로 보내든 480P size로 보내든) 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 난수 시드이며, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 - 범위: `0`부터 `2147483647`까지 + 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. + 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오 (기본값) +- single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 가능한 값: `multi`, `single` - 너비*높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V의 경우 (480P 없음): + width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 미지원): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, +resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 +resolution 설명에서 480P 미지원으로 나열된 모든 모델에서 400을 반환합니다. 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 -`GET /v2/models/wan/happyhorse-1.1-i2v/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 대상과 동일한 문서입니다. +`GET /v2/models/wan/happyhorse-1.1-i2v/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -432,7 +440,7 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 오디오 생성이 포함된 I2V 작업의 오디오 URL + 오디오 생성이 포함된 I2V 작업용 오디오 URL @@ -460,11 +468,11 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 이미지 오류 코드 (일부 작업이 실패할 때 반환됨) + 이미지 오류 코드 (일부 작업이 실패하면 반환됨) - 이미지 오류 정보 (일부 작업이 실패할 때 반환됨) + 이미지 오류 정보 (일부 작업이 실패하면 반환됨) @@ -522,7 +530,7 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 비디오 해상도 수준 (I2V 및 wan3.0-video 작업) + 비디오 해상도 등급 (I2V 및 wan3.0-video 작업) @@ -566,11 +574,11 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아닌 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아닌 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx index ae690f185b..5194c435e2 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 HappyHorse 1.1 R2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/happyhorse-1.1-r2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "HappyHorse 1.1 R2V" -translationSourceHash: afb02787 +translationSourceHash: 53cf60f2 translationFrom: development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx translationBlockHashes: "_intro": 320590bd "Quick start": 8eb3cc23 - "Schema": b9d2c334 + "Schema": 57b62b59 "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -209,82 +210,82 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-r2v/requests/$REQUEST_ID - 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 -받지 않습니다: first_frame 유형의 미디어 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 -happyhorse-1.1-i2v에서 공급자가 거부합니다. 그리고 wan2.7/wan3.0 표기는 참조 -에셋도 media로 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. -해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 +않습니다. 즉 first_frame 유형의 미디어 요소로 받으며(아래 media 참조), wan2.6-i2v에서 +성공하는 img_url 본문은 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서 공급자가 +거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 media에서 받습니다. 이미지 형식: +JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 + 미디어 에셋 목록입니다. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지 -여부는 모델마다 다릅니다. 모델별로 지원되는 type 값은 다음과 같습니다. +이미지 또는 비디오 입력을 img_url이나 reference_video_urls가 아닌 여기에서 +받는지는 모델마다 다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변당 240-8000 픽셀, 가로세로 비율 1:8 - 에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, 한 변당 - 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 - 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video가 최소 하나 필요하며, 참조 이미지와 참조 - 비디오의 합계는 최대 5개입니다. first_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 한 변당 240-8000 픽셀, 가로세로 비율 1:8 - 에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - reference_video: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, 한 변당 - 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 - 않음)에 더해 선택적으로 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 한 변당 - 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL)를 받습니다. -- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), - reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 - 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 - 순서가 프롬프트에서 에셋의 참조 순서(이미지 1, 비디오 1, 오디오 1, ...)를 - 정의합니다. first_frame, last_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP, 한 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, - 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, - file 및 link: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기는 - 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 종횡비 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, + 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 + data: URL은 허용되지 않습니다. +- wan2.7-r2v: first_frame (선택 사항, 최대 1), reference_image, reference_video. + reference_image 또는 reference_video 중 최소 하나가 필요하며, reference 이미지와 + reference 비디오의 합계는 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP + (알파 채널 없음), 변당 240-8000 픽셀, 종횡비 1:8에서 8:1 사이, 최대 + 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 + HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 + 허용되지 않음) plus 선택적 0에서 4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, + 변당 240-8000 픽셀, 종횡비 1:8에서 8:1 사이, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL). +- wan3.0-video, wan3.0-video-prime: first_frame (최대 1), last_frame (최대 1), + reference_image (최대 10), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1, link와 + 함께 사용할 수 없음), link (최대 1, file과 함께 사용할 수 없음). reference_*/file/link + 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. + 배열 순서는 프롬프트 내 에셋의 참조 순서를 정의합니다(이미지 1, 비디오 1, + 오디오 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 변당 240-8000 픽셀, 종횡비 최대 8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 + HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 허용, 정확히 1개. 이 표기는 + 첫 프레임을 img_url이 아닌 여기에서 받습니다. 최소 300x300 픽셀, 종횡비 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 - 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 허용, 1에서 9개. 이것이 + 모델의 유일한 참조 입력입니다. 최단 변이 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 - 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않음)에 더해 - 선택적으로 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, - 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL)를 받습니다. + 이 연산에서 입력 유형이 아닙니다. +- happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 종횡비 1:2.5에서 2.5:1 사이, + 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않음) plus + 선택적 0에서 5개의 reference_image (JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, + 종횡비 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 - 문서화되어 있지 않으므로 이 필드를 설정하지 마세요. + 기술되어 있지 않으므로 이 필드를 설정하지 않은 채로 둡니다. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 - 미디어 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 - img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다: 허용되는 유형과 그 -상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 않습니다. -스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 그리고 반대 방향으로, -위의 에셋별 "최대 20MB" 수치는(이미지 입력의 상한이며, 인라인으로 전송될 수 있는 -유일한 입력입니다) 파트너가 최종적으로 갖게 되는 에셋에 대한 파트너의 상한이고, -에셋이 공개 URL일 때는 그대로 적용됩니다. 해당 바이트는 Comfy를 거치지 않기 -때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치며 전송 상한도 -적용됩니다: Comfy Router POST 본문은 총 100 MiB로 제한되고 초과하면 413으로 -응답하며, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 초과하는 단일 인라인 -에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의 단일20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 갖습니다. 여러 에셋을 보낼 때는 전송 상한이 구속력을 갖는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 근접하는 데이터는 공개 URL로 전송하세요. + 어떤 미디어 용어도 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 + 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. +위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. 허용되는 유형과 +그 상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되지 않습니다. +스키마 수락이 공급자의 수락을 의미하지는 않습니다. 그리고 반대 방향으로, 위의 +에셋별 "최대 20MB" 수치들(이미지 입력에 대한 상한이며, 인라인으로 전송될 수 있는 +유일한 입력입니다)은 파트너가 최종적으로 받는 에셋에 대한 파트너의 상한이며, +에셋이 공개 URL인 경우 작성된 그대로 적용됩니다. 왜냐하면 그 바이트들은 Comfy를 +거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치며 +전송 상한도 만납니다. Comfy Router POST 본문은 총 100 MiB로 제한되어 이를 넘으면 +413으로 응답하며, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB가 넘는 +단일 인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서는 +파트너 자체의 단일 에셋이20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 보내십시오. @@ -294,31 +295,26 @@ happyhorse-1.1-i2v에서 공급자가 거부합니다. 그리고 wan2.7/wan3.0 - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명이 각 모델별로 나열한 정확히 그 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 허용하지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자의 자체 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명이 모델별로 나열한 정확히 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 대해서만 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일, 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하십시오. - 네거티브 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에 나타나지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 제한을 초과하는 콘텐츠는 잘립니다). -참조 비디오가 여러 개인 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 참조 비디오 -순서대로 피사체를 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내의 -해당 순서대로 미디어 에셋을 지칭하세요. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 문서화된 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자를 받습니다. 공급자는 prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000자의 중국어)를 넘는 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. 참조 비디오가 여러 개인 wan2.6-r2v의 경우, 참조 비디오 순서대로 대상(subject)을 가리킬 때 'character1', 'character2' 등을 사용하십시오. 예: "Character1 sings on the roadside, Character2 dances beside it" wan3.0-video 참조 모드에서는 media 배열 내 해당 순서대로 미디어 에셋을 가리킬 때 'Image 1', 'Video 1', 'Audio 1' 등을 사용하십시오. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개 비디오 URL의 배열입니다. -입력 제한 사항: + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. +입력 제한: - 형식: mp4, mov - 개수: 비디오 1-3개 - 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB -- audio_url과 함께 사용할 수 없음 -참조 재생 시간: 비디오 한 개는 최대 5초, 비디오 두 개는 각각 최대 2.5초, 비디오 세 개는 그보다 비례하여 짧습니다. +- audio_url과 함께 사용할 수 없습니다 +참조 재생 시간: 비디오 1개는 최대 5초, 2개는 각각 최대 2.5초, 3개는 그에 비례해 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. @@ -327,7 +323,7 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 이를 반드시 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`를 직접 v1 방식으로 호출할 때는 반드시 제공해야 하며, 허용되는 표기 목록은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -335,62 +331,61 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 다른 wan 모델에 대해서는 공급자가 그러한 전환을 문서화하지 않습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 보존합니다 +- auto (기본값): 모델이 prompt 콘텐츠를 기반으로 지능적으로 판단합니다 +- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 가능한 값: `auto`, `origin` - 생성되는 비디오의 재생 시간(초)입니다: -- wan2.5 모델: 5 또는 10초 -- wan2.6-t2v, wan2.6-i2v: 5, 10 또는 15초 -- wan2.6-r2v: 5 또는 10초만 (15초 미지원) + 생성되는 비디오의 재생 시간(초)입니다. +- wan2.5 모델: 5초 또는 10초 +- wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이며, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없고, -1은 모델이 - 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30]을 벗어난 재생 시간에 대해 400을 반환합니다. +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 총 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 넘지 않아야 하며, -1은 + 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능적 재작성을 활성화할지 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성 활성화 여부입니다. 기본값은 true입니다 - 생성된 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델에만 해당합니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어 비율과 의도를 기반으로 적절한 -화면 비율을 자동으로 추천합니다. +wan3.0-video의 경우 adaptive(기본값)가 적절한 값을 자동으로 추천합니다입력 미디어의 비율과 의도에 따른 화면 비율입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 수준. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P (기본 1080P) +- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 (480P 지원 없음) +- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 크기를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 이 프록시는 해상도를 검사하기 전에 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P 크기로 보내든)에 대해 400을 반환합니다. +이 프록시는 해상도도 size도 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 선택하기 때문입니다. 확인하기 전에 해상도를 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에 대해서는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 보내든 480P size로 보내든)에 대해서도 400을 반환합니다. - Possible values: `480P`, `720P`, `1080P` + 가능한 값: `480P`, `720P`, `1080P` - 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다. - 범위: `0` ~ `2147483647` + 범위: `0`부터 `2147483647`까지 @@ -399,23 +394,23 @@ wan2.6 및 wan2.7-r2v 모델용입니다. - single: 단일 샷 비디오 (기본값) - multi: 멀티 샷 비디오 - Possible values: `multi`, `single` + 가능한 값: `multi`, `single` - 너비*높이 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: + width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V (480P 없음)의 경우: +wan2.6 T2V/R2V의 경우 (480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -크기와 해상도를 모두 보내면 크기가 청구 등급을 선택하며, 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 해상도를 모두 보내는 경우, size가 청구 등급을 선택하며 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에 480P가 없다고 나열된 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부입니다. 워터마크는 오른쪽 아래 모서리에 표시됩니다. -`GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +Router가 `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 기준이 되는 동일한 문서입니다. ### 출력 @@ -424,7 +419,7 @@ wan2.6 T2V/R2V (480P 없음)의 경우: - 지능형 재작성 이후의 실제 프롬프트 (비디오 작업용) + 지능형 재작성 후의 실제 프롬프트 (비디오 작업용) @@ -452,7 +447,7 @@ wan2.6 T2V/R2V (480P 없음)의 경우: - 지능형 재작성 이후의 실제 프롬프트 (활성화된 경우) + 지능형 재작성 후의 실제 프롬프트 (활성화된 경우) @@ -496,7 +491,7 @@ wan2.6 T2V/R2V (480P 없음)의 경우: - 전체 작업 수 + 총 작업 수 @@ -514,7 +509,7 @@ wan2.6 T2V/R2V (480P 없음)의 경우: - 출력 정보 통계. 성공한 결과만 집계됩니다 + 출력 정보 통계. 성공한 결과만 집계됨 @@ -562,11 +557,11 @@ wan2.6 T2V/R2V (480P 없음)의 경우: - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아닌 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아닌 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx b/ko/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx index 546185a62a..3764b46374 100644 --- a/ko/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx @@ -2,16 +2,17 @@ title: "Wan 2.5 I2I Preview를 Comfy Router와 함께 사용하기" description: "Comfy Router를 통해 wan/wan2.5-i2i-preview를 호출합니다. 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Wan 2.5 I2I Preview" -translationSourceHash: c19a12c9 +translationSourceHash: 11080daf translationFrom: development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx translationBlockHashes: "_intro": d8f59ebb "Quick start": a98c2f62 - "Schema": 8bff936f + "Schema": c4c53620 "Examples": 3d10fc60 --- + {/* GENERATED FILE. Generated from router-schemas/wan/wan2.5-i2i-preview.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -180,19 +181,19 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 이미지 기반 이미지 생성을 위한 이미지 URL 배열 + 이미지 기반 이미지 생성을 위한 1~3개의 이미지 URL 배열 - 이미지에 나타나지 않았으면 하는 콘텐츠를 설명하는 부정 프롬프트 단어 + 이미지에 나타나지 않았으면 하는 콘텐츠를 설명하는 역방향 프롬프트 단어입니다. 프롬프트와 동일한 입력 예산에 산입됩니다. - 기대하는 이미지 요소와 시각적 특징을 설명하는 긍정 프롬프트 단어입니다. 중국어와 영어를 지원하며, 길이는 2000자를 초과할 수 없습니다. + 기대하는 이미지 요소와 시각적 특징을 설명하는 긍정 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 모델이 읽는 길이보다 긴 프롬프트는 거부되지 않고 잘립니다. 프롬프트와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000자의 중국어 문자)를 초과하는 요청은 공급자가 거부하며, InvalidParameter `Range of input length should be [1, 61440]`를 응답합니다. - 이미지 기반 이미지 생성에 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채웁니다. `POST /proxy/wan/api/v1/services/aigc/image2image/image-synthesis`에 대한 직접 v1 호출에서는 반드시 이 값을 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanImage2ImageGenerationRequest`에 있습니다. + 이미지 기반 이미지 생성에 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채웁니다. `POST /proxy/wan/api/v1/services/aigc/image2image/image-synthesis`에 대한 직접 v1 호출은 반드시 이 값을 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanImage2ImageGenerationRequest`에 있습니다. @@ -200,7 +201,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 생성되는 이미지 수입니다. 범위 1-4, 기본값은 4입니다. + 생성할 이미지 수입니다. 범위 1-4, 기본값은 4입니다. 범위: `1` ~ `4` @@ -212,14 +213,15 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 너비*높이 형식의 출력 이미지 해상도입니다. 기본값은 1280*1280입니다. API는 픽셀 면적 589824(768*768)에서 1638400(1280*1280) 사이, 가로세로 비율 1:4에서 4:1 사이를 허용합니다. + 출력 이미지 해상도로, 너비*높이 형식입니다. 기본값은 1280*1280입니다. API는 589824(768*768)에서 1638400(1280*1280) 사이의 픽셀 면적과 1:4에서 4:1 사이의 종횡비를 허용합니다. 오른쪽 아래 모서리에 워터마크 로고를 추가할지 여부 -`GET /v2/models/wan/wan2.5-i2i-preview/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +`GET /v2/models/wan/wan2.5-i2i-preview/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 동일한 문서입니다. + ### 출력 @@ -227,11 +229,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 지능형 재작성 이후의 실제 프롬프트 (비디오 작업용) + 지능형 재작성 후의 실제 프롬프트 (비디오 작업용) - 오디오 생성을 포함한 I2V 작업용 오디오 URL + 오디오 생성이 포함된 I2V 작업의 오디오 URL @@ -255,7 +257,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 지능형 재작성 이후의 실제 프롬프트 (활성화된 경우) + 지능형 재작성 후의 실제 프롬프트 (활성화된 경우) @@ -321,7 +323,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 비디오 해상도 레벨 (I2V 및 wan3.0-video 작업) + 비디오 해상도 등급 (I2V 및 wan3.0-video 작업) @@ -365,11 +367,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 실패한 요청의 오류 코드로, `output` 아래가 아닌 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 본문의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아닌 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 본문의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index 0be02604a4..b77fe93ac5 100644 --- a/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Wan 2.5 I2V Preview 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.5-i2v-preview를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 2.5 I2V Preview" -translationSourceHash: 76630e35 +translationSourceHash: cf342bd4 translationFrom: development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx translationBlockHashes: "_intro": 630a0d10 "Quick start": 8713537b - "Schema": 8ddb2e5e + "Schema": 483bc30d "Examples": 2b581e5f --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -190,83 +191,85 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2v-preview/requests/$REQUEST_ID - 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3, wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기서 받지 않습니다. -즉, first_frame 타입의 media 요소로 받으며(아래 media 참조), wan2.6-i2v에서 성공하는 -img_url 본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 공급자가 거부합니다. 또한 wan2.7/wan3.0 -표기도 참조 에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 +않습니다. 해당 표기들은 first_frame 유형의 미디어 요소로 첫 프레임을 받으며(아래 media +참조), wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 +happyhorse-1.1-i2v에서 공급자가 거부합니다. 그리고 wan2.7/wan3.0 표기는 참조 에셋을 +media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 지정합니다. -각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 모든 모델이 -공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 비디오 입력을 img_url이나 -reference_video_urls가 아니라 여기서 받는지 여부는 모델마다 다릅니다. 모델별 지원 type 값: + 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 +모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 비디오 +입력을 img_url이나 reference_video_urls가 아닌 여기에서 받는지 여부는 모델마다 +다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame과 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio(WAV/MP3, 2-30초, 최대 15MB)와 first_clip(MP4/MOV, 2-10초, 한 변당 - 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 + driving_audio(WAV/MP3, 2-30초, 최대 15MB)와 first_clip(MP4/MOV, 2-10초, 각 변 + 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. - wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video 중 최소 하나가 필요하며, reference 이미지와 - reference 비디오를 합쳐 최대 5개입니다. first_frame과 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 한 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 - 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집할 클립: MP4/MOV, 2-10초, - 한 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 - 허용되지 않음)와 선택적 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 한 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL - 또는 data:\{MIME_type};base64,... URL). + reference_image 또는 reference_video가 최소 1개 필요하며, reference 이미지와 + reference 비디오는 합쳐서 최대 5개입니다. first_frame과 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video(정확히 1개, 편집할 클립: MP4/MOV, 2-10초, 각 변 240-4096 + 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택 + 사항인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 + 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)가 + 필요합니다. - wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 - 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link 타입과 - first_frame/last_frame 타입은 같은 요청 안에서 상호 배타적입니다. 배열 순서가 + 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link + 유형과 first_frame/last_frame 유형은 같은 요청 안에서 상호 배타적입니다. 배열 순서는 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 정의합니다. - first_frame, last_frame, reference_image: JPEG/JPG/PNG/BMP/WEBP, - 한 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. reference_video, reference_audio, file, link: 공개 - HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 해당, 정확히 1개. 이 표기들은 - 첫 프레임을 img_url이 아니라 여기서 받습니다. 최소 300x300 픽셀, 가로세로 비율 - 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 + 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... + URL. reference_video, reference_audio, file 및 link: 공개 HTTP/HTTPS URL이며 인라인 + data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 해당하며 정확히 1개입니다. 이 + 표기들은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 + 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 해당, 1~9개. 이것이 - 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. 이 작업에서 reference_video는 - 입력 타입이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집할 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택적 - 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 - 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 해당하며 1~9개입니다. 이것이 + 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 + 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 이 연산의 + 입력 유형이 아닙니다. +- happyhorse-1.0-video-edit: video(정확히 1개, 편집할 클립: MP4/MOV, 3-60초, 긴 변 최대 + 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 100MB, + 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택 사항인 0~5개의 + reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 + 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)가 필요합니다. - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 - 문서화되어 있지 않으므로 이 필드를 설정하지 마십시오. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 - 미디어 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 + 없으므로 이 필드를 설정하지 마세요. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 어떤 + 미디어 어휘도 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. 허용되는 타입과 상한이 -모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 않습니다. 스키마가 -허용한다고 해서 공급자가 허용하는 것은 아니며, 반대 방향으로 위의 에셋별 "최대 20MB" -수치(이미지 입력, 즉 인라인으로 전송될 수 있는 유일한 입력의 상한)는 파트너가 최종적으로 -갖게 되는 에셋에 대한 파트너의 상한이며, 해당 바이트가 Comfy를 거치지 않으므로 에셋이 -공개 URL일 때는 그대로 적용됩니다. 인라인 data:\{MIME_type};base64,... -URL은 Comfy를 거치므로 전송 상한도 적용됩니다: Comfy Router -POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, base64는 -페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기의 파트너 -규칙에 도달하기 전에 거부됩니다. 그 크기에서는 단일 에셋이 파트너 자체의20MB 한도까지는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 실제 제약이 됩니다. -100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하므로, 여러 에셋에 걸치면 -전송 한도가 제약이 됩니다. 이 한도에 근접하는 값은 모두 공개 URL로 전송하세요. +위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. media에는 +minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한이 모델마다 다르기 +때문입니다. 스키마가 받아들인다고 해서 공급자가 받아들인다는 뜻은 아닙니다. 그리고 +반대 방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 +입력인 이미지 입력의 상한이며, 파트너가 최종적으로 갖게 되는 에셋에 대한 파트너의 +상한입니다. 이 수치는 에셋이 공개 URL일 때 그대로 적용되는데, 그 바이트는 Comfy를 +거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 +전송 상한도 함께 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 +넘으면 413으로 응답하고, base64는 페이로드를 약 4/3으로 부풀리므로 약 75 MB를 초과하는 +단일 인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서 +파트너 자체의 단일 에셋은 +20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 공개 URL로 보내세요. 미디어 에셋 유형 @@ -274,40 +277,43 @@ POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답 - 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 위의 `media` 설명이 각 모델에 대해 나열한 바로 그 이미지 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들에서는 비디오, 오디오, 파일, 링크 입력 중 어느 것도 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명에 각 모델별로 나열된 바로 그 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스가 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총량으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참조하세요. - 역방향 프롬프트 단어는 비디오 화면에 나타나지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. 이는 prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 한도를 초과하는 콘텐츠는 잘립니다). -참조 비디오가 여러 개인 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 -참조 비디오 순서대로 피사체를 지칭합니다. 예: "Character1이 길가에서 노래하고, Character2가 그 옆에서 춤춥니다" -wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 -media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어. 중국어와 영어를 지원합니다. 문서화된 자체 길이를 넘으면 wan2.x 모델은 +프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. +wan3.0-video와 wan3.0-video-prime은 최대 20,000자를 받습니다. 공급자는 prompt와 negative_prompt를 +합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)를 넘는 요청을 거부하며, +InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. +참조 비디오가 여러 개인 wan2.6-r2v의 경우, 참조 비디오 순서대로 주체를 가리키려면 +'character1', 'character2' 등을 사용하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드에서는 media 배열 내 해당 순서의 미디어 에셋을 가리키려면 +'Image 1', 'Video 1', 'Audio 1' 등을 사용하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. + wan2.6-r2v 모델 전용 참조 비디오 URL. 1-3개의 비디오 URL 배열입니다. 입력 제한: - 형식: mp4, mov -- 개수: 비디오 1~3개 -- 단일 비디오 길이: 2~30초 +- 수량: 1-3개 비디오 +- 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB -- audio_url과 함께 사용할 수 없습니다 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 2개는 각각 최대 2.5초, 비디오 3개는 그보다 비례하여 더 짧습니다. +- audio_url과 함께 사용할 수 없음 +참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 비디오 세 개는 그보다 비례적으로 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용하는 경우 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름. 선택 사항. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 이를 반드시 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 열거형은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -315,41 +321,40 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. + 비디오에 오디오를 추가할지 여부. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않습니다. - wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto(기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 + wan2.7-videoedit 모델의 비디오 오디오 설정. +- auto (기본값): 모델이 프롬프트 내용을 기반으로 지능적으로 판단 +- origin: 입력 비디오의 원본 오디오를 강제로 유지 가능한 값: `auto`, `origin` - 생성된 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초): - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 지원(15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 가능 (15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 - 입력 비디오 재생 시간과 출력 비디오 재생 시간의 합이 30초를 초과할 수 없습니다. -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수. 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 합니다. -1은 + 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다. 이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 true입니다 + 프롬프트 지능적 재작성 활성화 여부. 기본값은 true - 생성된 비디오의 종횡비입니다. wan2.7 및 wan3.0 모델 전용입니다. -wan2.7 모델의 경우 제공하지 않으면 해상도 등급을 기준으로 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도를 기반으로 -적절한 종횡비를 자동으로 추천합니다. + 생성되는 비디오의 화면 비율. wan2.7 및 wan3.0 모델 전용. +wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)가 적절한 값을 자동으로 추천합니다.aspect ratio(화면 비율)는 입력 미디어의 비율과 의도에 따라 결정됩니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -359,10 +364,10 @@ wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의 - wan2.5-i2v-preview: 480P, 720P, 1080P - wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) - wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 선택하기 때문입니다. 이 프록시는 해상도를 확인하기 전에 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum 밖의 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P를 해상도로 보내든 480P size로 보내든 400을 반환합니다. +이 프록시는 해상도도 크기도 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 검사 전에 해상도를 대문자로 변환하고 그 대문자 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P를 지원하지 않는 것으로 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 480P에 대해(해상도로 보내든 480P 크기로 보내든) 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` @@ -376,7 +381,7 @@ wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오 (기본값) +- single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 가능한 값: `multi`, `single` @@ -384,15 +389,17 @@ wan2.6 및 wan2.7-r2v 모델용입니다. width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V의 경우(480P 없음): +wan2.5 T2V의 경우: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 없음)의 경우: 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, +resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 +해상도 설명에서 480P를 지원하지 않는다고 나열한 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다. + 워터마크 로고를 추가할지 여부입니다. 워터마크는 오른쪽 아래 모서리에 위치합니다. Router가 `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. @@ -408,7 +415,7 @@ Router가 `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json`에서 제공하 - 오디오 생성을 포함한 I2V 작업의 오디오 URL + 오디오 생성이 포함된 I2V 작업의 오디오 URL @@ -486,7 +493,7 @@ Router가 `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json`에서 제공하 - 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간 24시간 + 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간은 24시간입니다 @@ -546,7 +553,7 @@ Router가 `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json`에서 제공하 - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하십시오. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-6-t2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-6-t2v/code.mdx index a01ebdf88f..f2d9af91a4 100644 --- a/ko/development/comfy-router/models/wan/wan2-6-t2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-6-t2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Wan 2.6 T2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.6-t2v를 호출하기 위한 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 2.6 T2V" -translationSourceHash: af081f28 +translationSourceHash: 00873331 translationFrom: development/comfy-router/models/wan/wan2-6-t2v/code.mdx translationBlockHashes: "_intro": 93b4f6f5 "Quick start": b919757c - "Schema": dd8ddc51 + "Schema": 35961ffb "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -186,81 +187,83 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-t2v/requests/$REQUEST_ID \ - 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3, wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 -받지 않습니다. 이들은 first_frame 유형의 media 요소로 첫 프레임을 받으며(아래 media -참조), wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 -happyhorse-1.1-i2v에서 공급자가 거부합니다. wan2.7/wan3.0 표기도 참조 에셋을 media에서 -받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. +받지 않습니다. first_frame 유형의 미디어 요소로 받으며(아래 media 참조), +wan2.6-i2v에서 성공하는 img_url 본문도 happyhorse-1.0-i2v 및 +happyhorse-1.1-i2v에서는 공급자가 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 +에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 어떤 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 -비디오 입력을 img_url이나 reference_video_urls가 아니라 여기에서 전달하는지 여부는 -모델마다 다릅니다. 모델별로 지원되는 type 값은 다음과 같습니다: + 미디어 에셋 목록입니다. 비디오 생성에 사용할 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 +제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 +이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아닌 이곳에서 받는지 +여부는 모델마다 다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 - 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, + 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, - 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 + 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. - wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 - reference 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 - 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. + reference_image 또는 reference_video가 최소 1개 필요하며, reference 이미지와 + reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 + 1:8~8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. - wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 - 허용되지 않음)와 선택적 reference_image 0~4개(JPEG/JPG/PNG/BMP/WEBP, - 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL - 또는 data:\{MIME_type};base64,... URL). + 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 + 허용되지 않음)와 선택 사항인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL)입니다. - wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), - reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 - 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link 유형과 - first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 순서가 - 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 정의합니다. - first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15s), + reference_audio(최대 5개 클립, 총 재생 시간 \<= 15s), file(최대 1개, link와 함께 + 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link + 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. + 배열 순서는 프롬프트에서 에셋의 참조 순서를 정의합니다(Image 1, Video 1, + Audio 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 - HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: + 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기는 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 - 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + 1:2.5~2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 - 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, + 이 모델의 유일한 참조 입력입니다. 짧은 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 이 연산의 입력 유형이 아닙니다. - happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 - 사이, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 - 선택적 reference_image 0~5개(JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, 가로세로 - 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5~2.5:1, + 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음)와 선택 + 사항인 0~5개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, + 가로세로 비율 1:2.5~2.5:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL)입니다. - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 - 기재되어 있지 않으므로 이 필드를 설정하지 않은 채로 두십시오. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 - 미디어 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 없으므로 이 필드는 설정하지 않습니다. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 미디어 + 어휘를 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한이 모델마다 다르기 -때문입니다. 스키마가 허용한다고 해서 공급자가 허용한다는 뜻은 아닙니다. 반대 -방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 -입력인 이미지 입력의 상한이며, 파트너가 최종적으로 받게 되는 에셋에 대한 파트너의 -상한이고, 에셋이 공개 URL일 때는 그대로 적용됩니다. 그 바이트는 Comfy를 거치지 -않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 -상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 넘으면 -413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 -인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서 파트너 자체의 단일20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나일 때는 파트너 규칙이 제약이 됩니다. 여러 개일 때는 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 값은 무엇이든 공개 URL로 보내세요. +위의 모델별 개수는 파트너의 제약 사항이며 이 스키마의 제약이 아닙니다. 허용되는 +유형과 상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 +않습니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 반대 방향으로, +위의 에셋별 "최대 20MB" 수치는(이미지 입력, 즉 인라인으로 전송될 수 있는 유일한 +입력의 상한) 파트너가 최종적으로 받게 되는 에셋에 대한 상한이며, 에셋이 공개 +URL일 때는 그대로 적용됩니다. 해당 바이트는 Comfy를 거치지 않기 때문입니다. +인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 +적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되어 이를 초과하면 413으로 +응답하며, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 초과하는 단일 인라인 +에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의 +단일 에셋은20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 전송 상한은 여러 에셋에 걸쳐 구속력을 가지는데, 100 MiB Router 상한이 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 공개 URL로 보내세요. @@ -270,40 +273,35 @@ minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위 `media` 설명에서 각 모델별로 나열한 이미지 입력에만 해당하는 경우(wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기에서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참조하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명에 각 모델별로 나열된 IMAGE 입력에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 해당 IMAGE 입력은 wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 사용하지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에서만 확인됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자가 직접 가진 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다 + 네거티브 프롬프트 단어는 비디오 화면에 나타나지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 거부하지 않고 잘라냅니다. 이는 prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video는 최대 20,000자, 한도를 초과한 콘텐츠는 잘립니다). -참조 비디오가 여러 개인 wan2.6-r2v의 경우, 'character1', 'character2' 등을 사용해 참조 비디오 순서대로 -대상을 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우, 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 media 배열 내 -해당 순서의 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 문서에 명시된 자체 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자를 받습니다. 공급자는 prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000자의 중국어)를 넘는 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. 여러 참조 비디오를 사용하는 wan2.6-r2v의 경우, 참조 비디오 순서대로 피사체를 가리킬 때 'character1', 'character2' 등을 사용하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" wan3.0-video 참조 모드에서는 media 배열 내 해당 순서대로 미디어 에셋을 가리킬 때 'Image 1', 'Video 1', 'Audio 1' 등을 사용하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. 입력 제한: - 형식: mp4, mov -- 개수: 비디오 1~3개 -- 단일 비디오 길이: 2~30초 +- 수량: 비디오 1-3개 +- 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB -- audio_url과 함께 사용할 수 없습니다 -참조 재생 시간: 비디오 1개는 최대 5초, 2개는 각각 최대 2.5초, 3개는 그보다 비례하여 짧아집니다. +- audio_url과 함께 사용할 수 없음 +참조 재생 시간: 비디오 1개는 최대 5초, 2개는 각각 최대 2.5초, 3개는 그에 비례해 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용하는 경우 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`로 직접 v1 호출을 할 때는 반드시 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`로 직접 v1 호출을 할 때는 반드시 제공해야 하며, 허용되는 표기법의 열거형은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -311,62 +309,61 @@ wan3.0-video 참조 모드의 경우, 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video 및 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto(기본값): 모델이 프롬프트 콘텐츠에 따라 지능적으로 판단합니다 +- auto (기본값): 모델이 prompt 콘텐츠를 기반으로 지능적으로 판단합니다 - origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 가능한 값: `auto`, `origin` - 생성된 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초)입니다: - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 지원(15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없으며, -1은 모델이 - 적합한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 하며, -1은 + 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +이 프록시는 [-1, 30]을 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능적 재작성의 활성화 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성 활성화 여부입니다. 기본값은 true입니다 - 생성된 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. -wan2.7 모델의 경우 제공하지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어 비율과 의도에 따라 적합한 -화면 비율을 자동으로 추천합니다. + 생성되는 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)가 자동으로 적절한aspect ratio based on the input media proportions and intent. - 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + Possible values: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델마다 다릅니다: + 해상도 레벨. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P - wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) - wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 이 프록시는 값을 확인하기 이전에 해상도를 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에 대해서는 400을 반환하고, 위에 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 전송되든 480P size로 전송되든)에 대해 400을 반환합니다. +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 과금 요율을 결정하기 때문입니다. 이 프록시는 검사 전에 resolution을 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 열거형에 없는 값에 대해서는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(resolution으로 보내든 480P size로 보내든)에 대해 400을 반환합니다. - 가능한 값: `480P`, `720P`, `1080P` + Possible values: `480P`, `720P`, `1080P` 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 - 범위: `0` ~ `2147483647` + Range: `0` to `2147483647` @@ -375,23 +372,23 @@ wan2.6 및 wan2.7-r2v 모델용입니다. - single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 - 가능한 값: `multi`, `single` + Possible values: `multi`, `single` - 너비*높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 + width*height 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V의 경우: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 wan2.6 T2V/R2V(480P 없음)의 경우: 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 해상도를 모두 전송하는 경우 size가 청구 등급을 선택하며, 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 과금 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 -`GET /v2/models/wan/wan2.6-t2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +Router가 `GET /v2/models/wan/wan2.6-t2v/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. ### 출력 @@ -404,7 +401,7 @@ size와 해상도를 모두 전송하는 경우 size가 청구 등급을 선택 - 오디오 생성이 포함된 I2V 작업의 오디오 URL + 오디오 생성을 포함하는 I2V 작업의 오디오 URL @@ -416,7 +413,7 @@ size와 해상도를 모두 전송하는 경우 size가 청구 등급을 선택 - 실패한 요청에 대한 자세한 정보 (요청이 성공하면 반환되지 않음) + 실패한 요청에 대한 상세 정보 (요청이 성공하면 반환되지 않음) @@ -482,7 +479,7 @@ size와 해상도를 모두 전송하는 경우 size가 청구 등급을 선택 - 완료된 비디오 생성 작업의 비디오 URL입니다. 링크 유효 기간은 24시간입니다 + 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간 24시간 @@ -490,11 +487,11 @@ size와 해상도를 모두 전송하는 경우 size가 청구 등급을 선택 - 출력 정보 통계입니다. 성공한 결과만 집계됩니다 + 출력 정보 통계. 성공한 결과만 집계됩니다 - 비디오 해상도 수준 (I2V 및 wan3.0-video 작업) + 비디오 해상도 레벨 (I2V 및 wan3.0-video 작업) @@ -538,11 +535,11 @@ size와 해상도를 모두 전송하는 경우 size가 청구 등급을 선택 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 자세한 정보로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하십시오. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-7-t2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-7-t2v/code.mdx index 57e1e06032..c241a7b632 100644 --- a/ko/development/comfy-router/models/wan/wan2-7-t2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-7-t2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Wan 2.7 T2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.7-t2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 2.7 T2V" -translationSourceHash: ff10f4b6 +translationSourceHash: 700c3a5c translationFrom: development/comfy-router/models/wan/wan2-7-t2v/code.mdx translationBlockHashes: "_intro": 89db521b "Quick start": d9034773 - "Schema": 6e6cd92f + "Schema": ffbd0afd "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -190,77 +191,80 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-t2v/requests/$REQUEST_ID \ - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 -않습니다. first_frame 타입의 media 요소로 받으며(아래 media 참조), wan2.6-i2v에서 -성공하는 img_url body는 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 공급자가 -거부합니다. 또한 wan2.7/wan3.0 표기도 참조 에셋을 media로 받습니다. 이미지 형식: -JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 +받지 않습니다. first_frame 유형의 미디어 요소로 받으며(아래 media 참조), +wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 +공급자가 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 media에서 받습니다. +이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 + 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아니라 여기에서 받는지 -여부는 모델마다 다릅니다. 모델별 지원 type 값: -- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, 각 변 - 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 - 않습니다. -- wan2.7-r2v: first_frame (선택 사항, 최대 1개), reference_image, reference_video. +이미지나 비디오 입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지는 +모델마다 다릅니다. 모델별 지원 type 값: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame과 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 측면당 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio(WAV/MP3, 2-30초, 최대 15MB)와 first_clip(MP4/MOV, 2-10초, + 측면당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 + data: URL은 허용되지 않습니다. +- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 - reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP (알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 - 1:8~8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - reference_video: 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, 각 변 - 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 - 않음)와 선택적으로 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, 각 변 - 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL). -- wan3.0-video, wan3.0-video-prime: first_frame (최대 1개), last_frame (최대 1개), - reference_image (최대 10개), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1개, link와 함께 - 사용할 수 없음), link (최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 타입과 first_frame/last_frame 타입은 동일한 요청 내에서 상호 배타적입니다. 배열 - 순서가 프롬프트에서 에셋의 참조 순서를 정의합니다 (Image 1, Video 1, Audio 1, ...). - first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 각 변 - 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: - 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 해당, 정확히 1개입니다. 이 - 표기들은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, - 가로세로 비율 1:2.5~2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + reference 비디오를 합쳐 최대 5개입니다. first_frame과 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 측면당 240-8000 픽셀, 가로세로 비율 + 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 측면당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 + 허용되지 않음)와 선택적 reference_image 0~4개(JPEG/JPG/PNG/BMP/WEBP, + 측면당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL). +- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), + reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 + 함께 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). + reference_*/file/link 유형과 first_frame/last_frame 유형은 같은 요청 안에서 + 상호 배타적입니다. 배열 순서가 프롬프트에서 에셋의 참조 순서를 정의합니다 + (Image 1, Video 1, Audio 1, ...). first_frame, last_frame, reference_image: + JPEG/JPG/PNG/BMP/WEBP, 측면당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, + 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, + file, link: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 사용하며 정확히 1개입니다. + 이 표기들은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, + 가로세로 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 해당, 1~9개입니다. +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 사용하며 1~9개입니다. 이것이 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - reference_video는 이 연산의 입력 타입이 아닙니다. -- happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, 긴 - 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5~2.5:1, 최대 100MB, - 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택적으로 0~5개의 - reference_image (JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 - 1:2.5~2.5:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). -- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, - wan2.5-t2v-preview: 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 - 문서에는 미디어 입력이 없으므로 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 - 미디어 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 + reference_video는 이 연산의 입력 유형이 아닙니다. +- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, + 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택적 + reference_image 0~5개(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 + 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). +- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 문서화되어 있지 않으므로 이 필드는 설정하지 않습니다. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 미디어 + 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 수량은 이 스키마가 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되어 있지 않은데, 허용되는 타입과 그 상한이 모델마다 -다르기 때문입니다. 스키마가 받아들인다고 해서 공급자가 받아들인다는 뜻은 아닙니다. -반대 방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 -입력인 이미지 입력의 상한이며, 파트너가 최종적으로 갖게 되는 에셋에 대한 파트너의 -상한입니다. 이 수치는 에셋이 공개 URL일 때 그대로 적용되는데, 해당 바이트가 Comfy를 -거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 실제로 Comfy를 -거치며 전송 상한도 적용됩니다. Comfy Router POST body는 총 100 MiB로 제한되며 이를 -초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 약 75 MB를 넘는 -단일 인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서는 파트너 자체의 20MB 상한에 해당하는 단일 에셋도 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 한도가 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 보내세요. +위의 모델별 개수는 파트너의 제약이며 이 스키마의 제약이 아닙니다. 허용되는 type과 +그 상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 +않습니다. 스키마가 허용한다고 해서 공급자가 허용한다는 뜻은 아니며, 반대 방향으로 +위의 에셋별 "최대 20MB" 수치(인라인으로 전송될 수 있는 유일한 입력인 이미지 입력의 +상한)는 파트너가 최종적으로 갖게 되는 에셋에 대한 파트너의 상한이고, 해당 바이트는 +Comfy를 거치지 않으므로 에셋이 공개 URL일 때 그대로 적용됩니다. 인라인 +data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 적용됩니다. +Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, +base64는 페이로드를 약 4/3로 부풀리므로 대략 75MB를 넘는 단일 인라인 에셋은 여기의 +파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의 단일 에셋이20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. +여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 +요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 무엇이든 +공개 URL로 보내세요. @@ -270,38 +274,43 @@ minItems/maxItems가 선언되어 있지 않은데, 허용되는 타입과 그 - 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 (위 `media` 설명이 모델별로 나열한 정확히 IMAGE 입력, 즉 wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image에 한해) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참고하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명이 각 모델에 대해 나열한 정확히 IMAGE 입력의 경우(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에서만 확인됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역방향 프롬프트 단어는 비디오 화면에 표시되기를 원하지 않는 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 거부하는 대신 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자, 제한을 초과하는 콘텐츠는 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우, 참조 비디오 순서에 따라 'character1', 'character2' 등으로 피사체를 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우, media 배열 내 해당 순서의 미디어 에셋을 지칭할 때 'Image 1', 'Video 1', 'Audio 1' 등을 사용하세요. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 문서화된 자체 길이를 넘으면 wan2.x 모델은 +프롬프트를 거부하는 대신 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. +wan3.0-video와 wan3.0-video-prime은 최대 20,000자까지 받습니다. 공급자는 prompt와 +negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)를 넘는 요청을 +거부하며, InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. +여러 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용해 참조 비디오 +순서대로 피사체를 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 media 배열 내의 해당 +순서대로 미디어 에셋을 지칭합니다. - wan2.6-r2v 모델 전용 참조 비디오 URL. 1-3개의 비디오 URL로 이루어진 배열입니다. + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. 입력 제한: - 형식: mp4, mov -- 수량: 비디오 1-3개 +- 수량: 1-3개 비디오 - 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없음 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례하여 더 짧습니다. +참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례해 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름. 선택 사항. 현재 지원: squish, flying, carousel. 사용하는 경우 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -309,77 +318,76 @@ wan3.0-video 참조 모드의 경우, media 배열 내 해당 순서의 미디 - 비디오에 오디오를 추가할지 여부. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. - wan2.7-videoedit 모델의 비디오 오디오 설정. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 + wan2.7-videoedit 모델의 비디오 오디오 설정입니다. +- auto (기본값): 모델이 프롬프트 콘텐츠에 따라 지능적으로 판단합니다 +- origin: 입력 비디오의 원본 오디오를 강제로 보존합니다 가능한 값: `auto`, `origin` - 생성되는 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초)입니다. - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 입력 + 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 하며, -1은 모델이 + 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +이 프록시는 [-1, 30]을 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능적 재작성을 활성화할지 여부. 기본값은 true입니다 + 프롬프트 지능형 재작성 사용 여부입니다. 기본값은 참입니다. - 생성된 비디오의 비율. wan2.7 및 wan3.0 모델 전용입니다. -wan2.7 모델의 경우, 제공되지 않으면 해상도 등급을 기준으로 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -비율을 자동으로 추천합니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)가 적절한 비율을 자동으로 추천합니다aspect ratio based on the input media proportions and intent. - 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + Possible values: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 수준. 지원되는 값은 모델에 따라 다릅니다: + 해상도 레벨입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) +- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 지원 (480P 미지원) - wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 이 프록시는 해상도를 검사하기 이전에 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에 대해서는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P size로 보내든)에 대해 400을 반환합니다. +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 검사 전에 resolution을 대문자로 변환하고 그 대문자 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 (resolution으로 보내든 480P size로 보내든) 480P에 대해 400을 반환합니다. - 가능한 값: `480P`, `720P`, `1080P` + Possible values: `480P`, `720P`, `1080P` - 무작위 숫자 시드로, 모델이 생성한 콘텐츠의 무작위성을 제어하는 데 사용됩니다 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 - 범위: `0` ~ `2147483647` + Range: `0` ~ `2147483647` 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. -wan2.6 및 wan2.7-r2v 모델용입니다. +wan2.6 및 wan2.7-r2v 모델 대상입니다. - single: 단일 샷 비디오 (기본값) - multi: 멀티 샷 비디오 - 가능한 값: `multi`, `single` + Possible values: `multi`, `single` - 너비*높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V의 경우(480P 없음): + width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V (480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. @@ -389,7 +397,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 -Router가 `GET /v2/models/wan/wan2.7-t2v/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 대상이 되는 동일한 문서입니다. +`GET /v2/models/wan/wan2.7-t2v/openapi.json`에서 Router가 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -484,7 +492,7 @@ Router가 `GET /v2/models/wan/wan2.7-t2v/openapi.json`에서 제공하는 스키 - 고유 요청 식별자 + 고유한 요청 식별자 @@ -540,7 +548,7 @@ Router가 `GET /v2/models/wan/wan2.7-t2v/openapi.json`에서 제공하는 스키 - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 필드를 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx b/ko/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx index 204502061b..2996bce324 100644 --- a/ko/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Wan 2.7 Video Edit 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.7-videoedit을 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 2.7 Video Edit" -translationSourceHash: 11c6064b +translationSourceHash: b970d117 translationFrom: development/comfy-router/models/wan/wan2-7-videoedit/code.mdx translationBlockHashes: "_intro": 164c9f6a "Quick start": ec8ca64c - "Schema": b7895256 + "Schema": cff0bda0 "Examples": 622d1416 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -213,79 +214,78 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-videoedit/requests/$REQUEST_ID \ - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 않습니다. -즉, media의 first_frame 타입 요소로 받으며(아래 media 참조), wan2.6-i2v에서 -성공하는 img_url 본문은 공급자가 happyhorse-1.0-i2v 및 -happyhorse-1.1-i2v에서 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 -media에서도 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 +받지 않습니다. 첫 프레임은 first_frame 유형의 미디어 요소로 받으며(아래 media +참조), wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 +happyhorse-1.1-i2v에서는 공급자가 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 +에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 지정합니다. -각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 모든 -모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 비디오 -입력을 img_url이나 reference_video_urls가 아닌 여기에 두는지 여부는 -모델마다 다릅니다. 모델별로 지원되는 type 값: -- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변당 240-8000 픽셀, 가로세로 비율 1:8에서 - 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 +제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 +이미지나 비디오 입력을 img_url이나 reference_video_urls가 아닌 여기에서 받는지 +여부는 모델마다 다릅니다. 모델별 지원 type 값: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame과 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, + 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, - 한 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL; 인라인 + 한 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame (선택 사항, 최대 1), reference_image, reference_video. 최소 - 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 - reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 한 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 - 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL; 인라인 data: URL은 허용되지 않습니다. +- wan2.7-r2v: first_frame (선택 사항, 최대 1개), reference_image, reference_video. + reference_image 또는 reference_video 중 최소 하나가 필요하며, reference 이미지와 + reference 비디오는 합쳐서 최대 5개입니다. first_frame과 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 한 변 240-8000 픽셀, 가로세로 비율 + 1:8~8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. - wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 한 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL; 인라인 data: URL은 - 허용되지 않습니다)에 선택적 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, - 한 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL - 또는 data:\{MIME_type};base64,... URL)를 더합니다. + 한 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 + 허용되지 않음)와 선택적 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, + 한 변 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL). - wan3.0-video, wan3.0-video-prime: first_frame (최대 1), last_frame (최대 1), - reference_image (최대 10), reference_video (최대 5개 클립, 총 재생 시간 \<= 15s), - reference_audio (최대 5개 클립, 총 재생 시간 \<= 15s), file (최대 1, link와 함께 사용할 수 - 없음), link (최대 1, file과 함께 사용할 수 없음). reference_*/file/link 타입과 - first_frame/last_frame 타입은 동일한 요청 내에서 상호 배타적입니다. 배열 순서가 - 프롬프트에서 에셋의 참조 순서를 정의합니다 (이미지 1, 비디오 1, 오디오 1, ...). - first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, - 한 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 - HTTP/HTTPS URL; 인라인 data: URL은 허용되지 않습니다. + reference_image (최대 10), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1, link와 함께 + 사용할 수 없음), link (최대 1, file과 함께 사용할 수 없음). reference_*/file/link + 유형과 first_frame/last_frame 유형은 동일한 요청 내에서 상호 배타적입니다. + 배열 순서가 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 + 정의합니다. first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 한 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: + 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. - happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 - 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + 1:2.5~2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 - 이 연산의 입력 타입이 아닙니다. + 이 연산의 입력 유형이 아닙니다. - happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL; 인라인 data: URL은 허용되지 않습니다)에 - 선택적 0~5개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, - 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL)를 더합니다. + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5~2.5:1, + 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음)와 선택적 + 0~5개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, 가로세로 비율 + 1:2.5~2.5:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 media 입력이 - 문서화되어 있지 않으므로 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 media - 어휘를 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 프레임을 + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 문서화되어 있지 않으므로 이 필드를 설정하지 마십시오. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 + media 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되지 않았는데, 허용되는 타입과 그 상한이 모델마다 -다르기 때문입니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 그리고 -반대 방향으로, 위의 에셋별 "최대 20MB" 수치(이미지 입력의 상한이며, 인라인으로 -전송될 수 있는 유일한 입력입니다)는 파트너가 최종적으로 받게 되는 에셋에 대한 -파트너의 상한이며, 해당 바이트가 Comfy를 거치지 않으므로 에셋이 공개 URL일 때는 -기술된 그대로 적용됩니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 -거치며 전송 상한도 만납니다. Comfy Router POST 본문은 총 100 MiB로 제한되고 이를 -넘으면 413으로 응답하며, base64는 페이로드를 약 4/3로 부풀리므로, 대략 75 MB를 -넘는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 -크기에서는 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. 여러 에셋에 걸치면 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 공개 URL로 전송하세요. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 +minItems/maxItems가 선언되어 있지 않은데, 허용되는 type과 그 상한이 모델마다 +다르기 때문입니다. 스키마가 통과한다고 해서 공급자가 통과한다는 뜻은 아닙니다. +반대 방향으로도 마찬가지입니다. 위의 에셋별 "최대 20MB" 수치, 즉 인라인으로 +전송될 수 있는 유일한 입력인 이미지 입력에 대한 상한은 파트너가 최종적으로 +받게 되는 에셋에 대한 상한이며, 에셋이 공개 URL일 때는 그대로 적용됩니다. +해당 바이트는 Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... +URL은 실제로 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router의 +POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, base64는 +페이로드를 약 4/3로 부풀리므로 약 75 MB를 초과하는 단일 인라인 에셋은 여기의 +파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나만 있을 때는 파트너 규칙이 제약이 됩니다. 여러 에셋에 걸치면 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 공개 URL로 보내세요. @@ -295,40 +295,37 @@ minItems/maxItems가 선언되지 않았는데, 허용되는 타입과 그 상 - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명에서 각 모델별로 나열한 IMAGE 입력에 한해(wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 확인됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기에서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 전체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 (각 모델에 대해 위 `media` 설명이 나열한 정확히 IMAGE 입력의 경우에만: wan2.7-i2v의 first_frame 및 last_frame; wan2.7-r2v의 first_frame 및 reference_image; wan2.7-videoedit의 reference_image; wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image; happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame; happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image; happyhorse-1.0-video-edit의 reference_image) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스의 `oss://dashscope-instant` 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 네거티브 프롬프트 단어는 비디오 화면에 나타나지 않길 원하는 콘텐츠를 설명하는 데 사용됩니다 + 역 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 제한을 초과하는 내용은 잘립니다). -여러 개의 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 -참조 비디오 순서대로 피사체를 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내에서 -해당 순서에 맞는 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어. 중국어와 영어를 지원합니다. 자체 문서화된 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자를 받습니다. 공급자는 prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)보다 긴 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`를 응답합니다. +참조 비디오가 여러 개인 wan2.6-r2v의 경우 참조 비디오 순서대로 주제를 가리키려면 'character1', 'character2' 등을 사용하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드의 경우 media 배열 내 해당 순서대로 미디어 에셋을 가리키려면 'Image 1', 'Video 1', 'Audio 1' 등을 사용하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. + wan2.6-r2v 모델 전용 참조 비디오 URL. 1-3개의 비디오 URL 배열. 입력 제한: - 형식: mp4, mov - 수량: 비디오 1-3개 - 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB -- audio_url과 함께 사용할 수 없습니다 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례하여 더 짧습니다. -과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. +- audio_url과 함께 사용할 수 없음 +참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례해 더 짧음. +과금: 실제 사용된 참조 재생 시간 기준. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름. 선택 사항. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID. 이 컴포넌트에서는 제약되지 않음: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 열거형은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -336,41 +333,40 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video 및 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. + 비디오에 오디오를 추가할지 여부. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않았습니다. - wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 + wan2.7-videoedit 모델의 비디오 오디오 설정. +- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단 +- origin: 입력 비디오의 원본 오디오를 강제로 유지 가능한 값: `auto`, `origin` - 생성되는 비디오의 재생 시간(초)입니다: -- wan2.5 모델: 5초 또는 10초 -- wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) + 생성되는 비디오의 재생 시간(초): +- wan2.5 모델: 5 또는 10초 +- wan2.6-t2v, wan2.6-i2v: 5, 10 또는 15초 +- wan2.6-r2v: 5 또는 10초만 (15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이며, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30] 범위를 벗어나는 재생 시간에 대해 400을 반환합니다. +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수; 비디오 입력이 있으면 총 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없음; -1은 + 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화 +이 프록시는 [-1, 30] 밖의 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능적 재작성 사용 여부입니다. 기본값은 true입니다 + 프롬프트 지능적 재작성 활성화 여부. 기본값은 참 - 생성된 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. + 생성되는 비디오의 화면 비율. wan2.7 및 wan3.0 모델 전용. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)는 입력 미디어의 비율과 의도에 따라 적절한 -화면 비율을 자동으로 추천합니다. +wan3.0-video의 경우 adaptive(기본값)가 적절한입력 미디어의 비율과 의도에 따라 결정되는 화면 비율입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -378,45 +374,45 @@ wan3.0-video의 경우 adaptive(기본값)는 입력 미디어의 비율과 의 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 이 프록시는 해상도를 검사하기 전에 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P size로 보내든)에 400을 반환합니다. +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) +- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) +- happyhorse-1.0-*(t2v, i2v, r2v, video-edit): 720P, 1080P +- happyhorse-1.1-*(t2v, i2v, r2v): 480P, 720P, 1080P +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 검사 전에 resolution을 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 열거형에 없는 값에는 400을 반환하고, 위에서 480P를 지원하지 않는 것으로 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(resolution으로 보내든 480P size로 보내든)에 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다. 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. + 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오 (기본값) +- single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 가능한 값: `multi`, `single` - width*height 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V (480P 없음): + width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P를 지원하지 않는 것으로 나열된 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부입니다. 워터마크는 오른쪽 아래 모서리에 위치합니다. -`GET /v2/models/wan/wan2.7-videoedit/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 대상과 동일한 문서입니다. +`GET /v2/models/wan/wan2.7-videoedit/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -425,7 +421,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 지능형 재작성 이후의 실제 프롬프트 (비디오 작업용) + 지능적 재작성 이후의 실제 프롬프트 (비디오 작업용) @@ -453,15 +449,15 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 지능형 재작성 이후의 실제 프롬프트 (활성화된 경우) + 지능적 재작성 이후의 실제 프롬프트 (활성화된 경우) - 이미지 오류 코드 (일부 작업이 실패할 때 반환됨) + 이미지 오류 코드 (일부 작업이 실패하면 반환됨) - 이미지 오류 정보 (일부 작업이 실패할 때 반환됨) + 이미지 오류 정보 (일부 작업이 실패하면 반환됨) @@ -563,11 +559,11 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아닌 응답 본문의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 항목을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아닌 응답 본문의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index 3ae10b211c..d2b95a789c 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 레퍼런스" description: "Comfy API 계약에서 생성된 모든 Comfy Router 엔드포인트, 매개변수, 응답 본문 및 오류 버킷." sidebarTitle: "API 레퍼런스" -translationSourceHash: e2c5f523 +translationSourceHash: f49adc91 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 @@ -12,7 +12,7 @@ translationBlockHashes: "Pre-flight cost estimates": 7405db0d "Result assets": 3520a8bf "Per-model input and output schemas": 61c6bde8 - "Schemas": 663ae766 + "Schemas": 9738e3aa --- @@ -29,6 +29,7 @@ translationBlockHashes: + {/* 생성된 파일: 손으로 편집하지 마십시오. @@ -1102,36 +1103,36 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 ### RouterBilledWorkspace -거부된 호출이 청구했을 지갑으로, `RouterErrorResponse.billed_workspace`에 있습니다. "어느 지갑이 비어 있나?"에 답합니다. 이는 호출자의 UI에서 현재 선택된 워크스페이스가 아닐 수 있으며, 팀 멤버의 개인 자격 증명은 자금이 있는 팀이 열려 있는 동안에도 여기에 자신의 개인 지갑을 표시합니다. `denied_reason`과 함께일 때만 표시됩니다. +거부된 호출이 청구했을 지갑으로, `RouterErrorResponse.billed_workspace`에 표시됩니다. "어느 지갑이 비어 있는가?"라는 질문에 답하며, 호출자의 UI에서 현재 선택된 워크스페이스와 반드시 같지는 않습니다. 또한 팀 멤버가 개인 자격 증명을 사용하는 경우, 자금이 있는 팀이 열려 있더라도 여기에는 해당 멤버의 개인 지갑이 표시됩니다. `denied_reason`과 함께 표시될 때만 존재합니다. **필드** - 클라우드 워크스페이스 id입니다. 레거시 레일에서는 없습니다. + 클라우드 워크스페이스 id입니다. 레거시 레일에서는 존재하지 않습니다. - `personal` 또는 `team`. 열린 문자열입니다. 다른 값은 개인으로 취급하세요. + `personal` 또는 `team`. 열린 문자열이므로 다른 값은 개인으로 취급하세요. - 호출이 클라우드 워크스페이스가 아니라 호출자의 워크스페이스 이전 Metronome 고객에게 청구되는 경우 `legacy`입니다. 해당 고객에는 워크스페이스 id가 없습니다. 클라우드 워크스페이스에는 없습니다. + 호출이 클라우드 워크스페이스가 아니라 호출자의 워크스페이스 이전 Metronome 고객에게 청구되는 경우 `legacy`입니다. 해당 고객은 워크스페이스 id가 없습니다. 클라우드 워크스페이스에서는 존재하지 않습니다. ### RouterChargesOnPolicyRejection -이 모델에서 콘텐츠 정책 거부에 대해 과금되는지 여부입니다. 알 수 없음 값은 과금될 가능성이 있는 것으로 처리하세요. +이 모델에 대해 콘텐츠 정책 거부에 요금이 청구되는지 여부입니다. 알 수 없는 값은 청구될 가능성이 있는 것으로 간주하십시오. -Type: `string` +유형: `string` ### RouterCostEstimate -이 호출에 드는 비용을 미국 달러로 디스패치 전에 산정한 사전 예상 견적입니다. 이 견적은 Comfy의 표준 정가로 책정되며, 공급업체가 보고하는 비용으로 청구되는 모델의 경우 공급업체가 공개한 가격표를 기준으로 합니다. 이러한 공급업체 보고 방식에서 `source: exact`는 옵트인한 소수의 모델에 대해서만, 그리고 공개 가격표만으로 금액이 완전히 결정될 때(가격을 결정하는 모든 필드가 명시되었거나, 금액을 바꿀 수 없는 기본값으로 남아 있을 때)에만 반환됩니다. 그 밖의 모든 공급업체 보고 견적은 `estimated`이며, 가격표만으로 완전히 결정될 수 있는 일부 견적도 여기에 포함됩니다. 어느 경우든 실행이 완료된 후에는 공급업체가 보고한 금액이 청구되며, 견적된 금액이 그대로 청구되지는 않습니다. 이 견적은 계약 또는 고객별 요율을 반영하지 않습니다. 협상된 가격이 있는 워크스페이스에는 정가가 견적되고 계약 요율이 청구되며, 이때 `source: exact`는 정가 기준으로 정확하다는 뜻이지 해당 워크스페이스의 청구 금액이 정확하다는 뜻은 아닙니다. 이는 최종 청구 금액이 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 청구 기록에 있는 정산된 청구 금액입니다. 실행 후 보고되는 `X-Comfy-Credits-Used`는 반올림된 사후 수치이며 영수증이 아닙니다. `source`는 이 숫자를 얼마나 신뢰할 수 있는지 나타냅니다. `exact`에는 `amount`가 있고, `free`에는 `amount` "0"이 있으며(요금 카드가 이 요청의 가격을 0으로 책정함), `estimated`에는 `min_amount`와 `max_amount`가 있고 `amount`는 없으며, `unknown`에는 둘 다 없고 `reason`이 있습니다. `amount`가 없다고 해서 무료로 해석해서는 안 됩니다. 가격 고정이 아닙니다: `pricing_as_of`를 참조하세요. +이 호출에 드는 비용을 디스패치 전에 미리 추정한 값으로, 미국 달러 기준입니다. 가격은 Comfy의 표준 정가로 책정되며, 공급자가 보고한 비용으로 청구되는 모델의 경우에는 공급자가 공개한 가격표를 기준으로 책정됩니다. 공급자 보고 방식의 경우 `source: exact`는 소수만 선택한 모델 집합에 대해서만, 그리고 공개 가격표가 금액을 완전히 결정할 때만 반환됩니다(가격을 좌우하는 모든 필드가 명시되었거나, 금액을 바꿀 수 없는 기본값으로 남아 있는 경우). 그 밖의 모든 공급자 보고 견적은 가격표가 완전히 결정할 수 있는 일부를 포함해 `estimated`입니다. 어느 경우든 실행이 끝난 뒤에는 공급자가 보고한 금액으로 청구되며, 견적에 적힌 숫자가 그대로 청구되지는 않습니다. 계약 요율이나 고객별 요율은 반영하지 않습니다. 협상된 가격이 있는 워크스페이스는 정가로 견적되고 계약 요율로 청구되며, 이때 `source: exact`는 정가 기준으로 정확하다는 뜻이지 해당 워크스페이스의 청구액이 정확하다는 뜻이 아닙니다. 최종 청구액이 아닙니다. 워크스페이스의 사용량 및 결제 기록에 정산된 청구액이 실제로 지불하는 금액입니다. 실행 후에 보고되는 `X-Comfy-Credits-Used`는 반올림된 사후 수치일 뿐 영수증이 아닙니다. `source`는 이 숫자를 얼마나 신뢰할 수 있는지를 나타냅니다. `exact`는 `amount`를 포함하고, `free`는 `amount`가 "0"이며(요율표가 이 요청을 0으로 책정함), `estimated`는 `min_amount`와 `max_amount`를 포함하고 `amount`는 없으며, `unknown`은 어느 것도 없고 `reason`을 포함합니다. `amount`가 없다고 해서 무료로 해석해서는 안 됩니다. 가격 고정이 아닙니다: `pricing_as_of`를 참고하세요. **필드** - `exact` | `estimated` | `free` | `unknown`이며, 그 밖의 값은 모두 `unknown`으로 해석합니다. `exact`와 `estimated`는 모두 추정치를 나타내며, 어느 쪽도 최종 청구 금액이 아닙니다. `free`는 요율표가 이 요청을 0으로 책정했다는 뜻이므로 `amount`가 "0"입니다. `unknown`은 어떤 수치도 포함하지 않습니다. + `exact` | `estimated` | `free` | `unknown`이며, 그 밖의 값은 `unknown`으로 읽습니다. `exact`와 `estimated`는 모두 추정치를 나타내며, 어느 것도 최종 청구액이 아닙니다. `free`는 요율표가 이 요청을 0으로 책정했다는 뜻이므로 `amount`가 "0"입니다. `unknown`은 금액을 포함하지 않습니다. @@ -1139,25 +1140,25 @@ Type: `string` - 예상 비용을 달러로 나타낸 십진수 문자열입니다(예: "0.04"). 소수점 이하 최대 8자리이며 지수 표기를 사용하지 않습니다. 청구 가능한 1센트 미만 가격은 절대 "0"으로 표시되지 않으며, `free` 견적만 "0"으로 표시됩니다. `source`가 `exact` 또는 `free`일 때만 존재합니다. 최종 청구 금액이 아니며, 최종 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구 금액입니다. + 추정 비용을 달러 단위의 십진 문자열로 나타낸 값입니다. 예: "0.04". 소수점 이하 최대 8자리까지이며 지수 표기는 쓰지 않습니다. 청구 가능한 1센트 미만 가격은 절대 "0"으로 표시되지 않으며, 오직 `free` 견적만 "0"으로 표시됩니다. `source`가 `exact` 또는 `free`일 때만 존재합니다. 최종 청구액이 아닙니다. 최종 청구액은 워크스페이스의 사용량 및 결제 기록에 정산된 금액입니다. - 추정치의 하한을 달러로 나타낸 십진수 문자열입니다. 이는 추정치일 뿐 보장된 하한이 아닙니다. 예를 들어 공급자가 요청한 것보다 적게 반환하거나(이미지가 없는 경우 등), 추정치가 과거 호출에서 학습한 일반적인 가격이거나, 가격이 요청한 수량에 따라 꾸준히 오르지 않는 경우에는 더 적게 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. + 추정치의 하한을 달러 단위의 십진 문자열로 나타낸 값입니다. 이는 추정치일 뿐 보장된 하한이 아닙니다. 예를 들어 공급자가 요청보다 적게 반환하거나(이미지가 없는 경우 등), 과거 호출에서 학습한 통상 가격을 추정치로 쓰거나, 요청량에 따라 가격이 꾸준히 오르지 않는 경우에는 더 적게 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. - 추정치의 상한을 달러로 나타낸 십진수 문자열입니다. 이는 추정치일 뿐 보장된 상한이 아닙니다. 예를 들어 공급자가 요청한 것보다 많이 반환하거나(요청한 것보다 많은 이미지 등), 추정치가 과거 호출에서 학습한 값이거나, 가격이 요청한 수량에 따라 꾸준히 오르지 않는 경우에는 더 많이 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. + 추정치의 상한을 달러 단위의 십진 문자열로 나타낸 값입니다. 이는 추정치일 뿐 보장된 상한이 아닙니다. 예를 들어 공급자가 요청보다 많이 반환하거나(요청한 것보다 많은 이미지 등), 과거 호출에서 학습한 추정치를 쓰거나, 요청량에 따라 가격이 꾸준히 오르지 않는 경우에는 더 많이 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. - 동일한 수치를 산술 연산용으로 반올림하지 않은 미국 센트 단위로 나타낸 값입니다. `amount`와 함께 존재합니다. + 같은 금액을 미국 센트 단위로 반올림 없이 나타낸 값으로, 계산용입니다. `amount`와 함께 존재합니다. double - `min_amount`를 반올림하지 않은 미국 센트 단위로 나타낸 값입니다. `min_amount`와 함께 존재합니다. + `min_amount`를 미국 센트 단위로 반올림 없이 나타낸 값입니다. `min_amount`와 함께 존재합니다. double @@ -1169,74 +1170,73 @@ Type: `string` - `amount`를 플랫폼 환산율($1 = 211 크레딧)로 환산한 Comfy 크레딧 값이며 소수점 2자리로 반올림됩니다. `exact` 견적에 대해 `X-Comfy-Credits-Used`가 담을 것으로 예상되는 수치입니다. 이 헤더는 반올림된 사후 수치이며 영수증이 아닙니다. 워크스페이스의 사용량 및 결제 기록에 정산된 청구 금액이 최종입니다. + 플랫폼 환산($1 = 211 크레딧)을 사용해 `amount`를 Comfy 크레딧으로 나타낸 값으로, 소수점 이하 2자리로 반올림됩니다. `exact` 견적에서 `X-Comfy-Credits-Used`가 담을 것으로 예상되는 값입니다. 이 헤더는 반올림된 사후 수치일 뿐 영수증이 아니며, 최종 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구액입니다. double - 이 견적이 해당하는 공급자 구간입니다. 대기 중 제출의 경우 실행될 구간입니다. + 이 견적이 대상으로 하는 공급자 구간입니다. 대기 중 제출에서는 실행될 구간을 가리킵니다. - 정규 Comfy Router 모델 ID로 `{provider}/{model}` 형식입니다. 즉 `POST /v2/models/{provider}/{model}`에서 해당 모델을 가리키는 값과 정확히 같으므로, 호출자는 다른 곳에서 다시 도출할 필요 없이 이 값을 그 경로에 그대로 넣을 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 연결한 것이며, `maxLength`는 두 값의 길이 합에 구분자 길이를 더한 값입니다. + 정규화된 Comfy Router 모델 ID인 `{provider}/{model}`로, `POST /v2/models/{provider}/{model}`에서 해당 모델을 지정하는 값과 정확히 같습니다. 따라서 호출자는 다른 무엇으로부터 다시 도출할 필요 없이 이 값을 그 경로에 그대로 끼워 넣을 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 연결한 것이며, `maxLength`는 두 값의 길이 합에 그 구분자 하나를 더한 값입니다. 유형: [`RouterModelId`](#routermodelid) -- 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 - 이 견적을 산정한 요율표를 가져온 시점입니다. 이 추정치는 가격 고정이 아닙니다. 실행은 이 시점이 아니라 실행이 요율 산정되는 시점에 유효한 요율로 청구됩니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적(공급자가 보고하는 비용으로 청구되는 모델)의 경우에는 대신 해당 가격표를 읽은 날짜가 담깁니다. 청구 수량을 공급자의 공개 일정표에서 예측한 뒤 요율표로 가격을 매기는 견적은 `exact` 답변이든 `estimated` 답변이든 해당 일정표를 읽은 날짜와 요율표를 가져온 시점 중 이른 날짜를 담습니다(공급자가 보고하는 크레딧으로 청구되는 모델이 `estimated`인 경우입니다). 어떤 요율표도 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 가격을 매길 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시점입니다. + 이 견적을 책정한 요율표를 가져온 시점입니다. 추정치는 가격 고정이 아닙니다. 실행은 청구가 산정되는 시점에 유효한 요율로 청구되며, 이 시점의 요율이 아닙니다. 공급자가 공개한 가격표에서 가져온 `estimated` 견적(공급자가 보고한 비용으로 청구되는 모델)은 대신 그 가격표를 읽은 날짜를 담습니다. 청구 수량을 공개된 공급자 일정에서 예측한 뒤 요율표로 책정한 견적은, `exact` 답변이든 `estimated` 답변이든 해당 일정의 조회 날짜와 요율표 조회 시점 중 더 이른 쪽을 담습니다(공급자가 보고한 크레딧으로 청구되는 모델이 `estimated`인 경우입니다). 요율표를 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 책정할 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시점입니다. date-time - - `source`가 `unknown`일 때만 존재합니다. `not_quotable`은 Router가 이 호출의 가격을 실행 전에 매길 수 없다는 뜻이며(가격이 공급자가 돌려주는 내용에 따라 달라지거나, 요청 본문이 청구 수량을 한정하지 않는 경우), `unpriced_model`은 요율표가 이 요청의 가격을 매기지 않는다는 뜻이고, `byok`은 대기 중 제출에만 해당하며 실행이 사용자의 자체 공급자 키를 사용하므로 Comfy가 청구하는 금액이 없다는 뜻이며, `pricing_unavailable`은 대기 중 제출에만 해당하고 요청이 접수될 때 요율표를 읽을 수 없었다는 뜻입니다(이는 일시적인 상황이며 실행은 평소대로 청구됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. +`source`가 `unknown`일 때만 표시됩니다: `not_quotable`(Router는 이 호출이 실행되기 전에는 가격을 책정할 수 없습니다: 가격이 공급자가 보고하는 값에 따라 달라지거나, 요청 본문이 청구 수량을 한정하지 않는 경우입니다), `unpriced_model`(요율 카드에 이 요청의 가격이 책정되어 있지 않음), `byok`(대기 중 제출에만 해당: 실행에 자체 공급자 키를 사용하므로 Comfy는 이에 대해 아무것도 청구하지 않습니다), 또는 `pricing_unavailable`(대기 중 제출에만 해당: 요청이 접수되었을 때 요율 카드를 읽을 수 없었습니다. 이는 일시적인 상태이며, 실행에는 평소와 같이 요금이 부과됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. ### RouterErrorResponse -인증, 액세스, 모델 조회, 할당량, 공급자 전송 실패에 대한 오류 본문입니다. +인증, 액세스, 모델 조회, 할당량 및 공급자 전송 실패에 대한 오류 본문입니다. **필드** - 실패에 대한 사람이 읽을 수 있는 설명으로, 최종 사용자에게 노출해도 안전합니다. 기계적으로 파싱되지 않습니다. 대신 `error_type`을 기준으로 분기하십시오. 사용 중단된 모델의 `model_not_found`의 경우, 후속 모델이 기록되어 있고 호출자에게 표시되는 경우 `detail`은 ` was retired on ; use `로 표시되며, 그렇지 않은 경우에는 일반적인 제안 목록 대신 ` was retired on `로만 표시됩니다. 여기에 명시된 후속 모델은 항상 호출을 다시 지정할 수 있는 라이브 카탈로그 ID입니다. 서비스 종료 날짜가 아직 미래인 모델은 사용 중단된 것이 아닙니다. 해당 날짜까지 `GET /v2/models`에 계속 나열되며 계속 실행 가능합니다. `detail`의 나머지 부분과 마찬가지로 이 사용 중단 문구는 표시용이며 호환성 보장을 제공하지 않습니다. 기계적으로 파싱되지 않는다는 규칙에 문서화된 두 가지 예외가 있습니다. `POST /v2/models/{provider}/{model}`에서 `409`는 `invalid_input` 버킷을 공유하는 세 가지 무관한 조건에 대해 응답되며, 오직 `detail`만이 이들을 구분합니다. "this request's `image` selects the edit operation"으로 시작하는 `detail`은 multipart `model_provider` 거부이고, "this request resolved a BYOK credential"로 시작하는 `detail`은 BYOK `model_provider` 거부입니다. 둘 다 새 `Idempotency-Key`로도 해소되지 않습니다. 해당 경로에서 다른 모든 `invalid_input` `409`는 키 충돌입니다. 두 접두사는 안정적인 계약 용어이며 매칭할 수 있습니다. 그 밖의 어디에서도 `detail`을 기준으로 분기하는 것은 호환성 보장을 제공하지 않습니다. + 실패에 대한 사람이 읽을 수 있는 설명으로, 최종 사용자에게 노출해도 안전합니다. 기계적으로 파싱하지 않습니다. 대신 `error_type`을 기준으로 분기하세요. 은퇴한 모델에 대한 `model_not_found`의 경우, 후속 모델이 기록되어 있고 호출자에게 표시된다면 `detail`은 ` was retired on ; use `로 표시되고, 그렇지 않다면 일반적인 제안 목록 대신 ` was retired on `로만 표시됩니다. 여기에 명시되는 후속 모델은 항상 호출을 다시 지정할 수 있는 라이브 카탈로그 ID입니다. 서비스 종료 날짜가 아직 미래인 모델은 은퇴한 것이 아닙니다. 해당 날짜까지 `GET /v2/models`에 계속 나열되며 계속 실행할 수 있습니다. `detail`의 나머지 부분과 마찬가지로, 이 은퇴 관련 문구는 표시용이며 호환성 보장을 수반하지 않습니다. 기계적으로 파싱하지 않는다는 규칙에 대한 두 가지 문서화된 예외가 있습니다. `POST /v2/models/{provider}/{model}`에서 `409`는 `invalid_input` 버킷을 공유하는 세 가지 서로 무관한 조건에 대해 응답되며, 오직 `detail`만이 이들을 구분합니다. `detail`이 "this request's `image` selects the edit operation"으로 시작하면 멀티파트 `model_provider` 거부이고, `detail`이 `this request resolved a BYOK credential`로 시작하면 BYOK `model_provider` 거부입니다. 둘 다 새 `Idempotency-Key`로 해소되지 않습니다. 해당 라우트에서 그 밖의 `invalid_input` `409`는 키 충돌입니다. 두 접두사는 모두 안정적인 계약 용어이며 매칭해도 됩니다. 그 외 어느 곳에서도 `detail`에 대한 분기는 호환성 보장을 수반하지 않습니다. - Router 실패에 대한 포괄적인 기계 판독 가능 버킷으로, 호출자가 본문을 파싱하지 않고 분기할 수 있도록 `X-Comfy-Error-Type` 응답 헤더에 그대로 반영됩니다. 이 집합은 스무 개 값으로 닫혀 있습니다. 여섯 개의 요청 수준 버킷 `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits`, `model_not_found`에 더해 전송 수준의 `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full`, `result_expired`가 있습니다. "닫혀 있다"는 것은 오늘 문서화된 시점의 집합을 뜻할 뿐 영원히 유지되는 한계가 아닙니다. 이 집합은 확장될 것으로 예상되며, 그래서 이것이 의도적으로 `enum`이 아닌 일반 문자열입니다. 따라서 클라이언트는 위 목록에 대해 빠짐없이 분기하여 다음 추가에서 깨지는 대신, 인식할 수 없는 값을 `internal_error`로 취급해야 합니다. + Router 실패에 대한 거친, 기계 판독 가능한 버킷으로, 호출자가 본문을 파싱하지 않고 분기할 수 있도록 `X-Comfy-Error-Type` 응답 헤더에도 그대로 반영됩니다. 이 집합은 스무 개 값으로 닫혀 있습니다. 여섯 개의 요청 수준 버킷 `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits`, `model_not_found`와, 전송 수준의 `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full`, `result_expired`입니다. "닫혀 있다"는 것은 오늘 문서화된 집합을 설명하는 것이지 영원히 유지되는 한계가 아닙니다. 집합은 늘어날 것으로 예상되며, 그래서 이것이 의도적으로 `enum`이 아닌 일반 문자열입니다. 따라서 클라이언트는 알 수 없는 값을 `internal_error`로 처리해야 하며, 위 목록에 대해 빠짐없이 switch하여 다음에 추가되는 값에서 깨지는 방식이어서는 안 됩니다. 유형: [`RouterErrorType`](#routererrortype) - 모델 공급자가 요청을 거부한 이유에 대해 범위가 제한되고 정제된 설명으로, `error_type`이 `invalid_input`이고 `X-Comfy-Upstream-Status`가 공급자의 `4xx` 또는 `2xx`일 때만 존재합니다. 즉, 공급자가 요청을 잘못된 형식으로 거부하고 그 이유를 밝힌 경우입니다. 보통 그 상태는 `4xx`이며, 성공 봉투 안에서 거부된 생성을 보고하는 공급자의 경우 `2xx`입니다(BytePlus의 실패한 작업 폴링은 HTTP `200`에 사유가 본문에 담깁니다). 다른 모든 실패, 즉 공급자 `5xx`, 전송 실패, 콘텐츠 정책 거부, Router가 자기 자신에 대해 제기한 모든 거부에서는 존재하지 않습니다. `X-Comfy-Upstream-Detail` 헤더를 그대로 반영합니다. + 모델 공급자가 요청을 거부한 이유로, 범위가 제한되고 정제된 사유입니다. `error_type`이 `invalid_input`이고 `X-Comfy-Upstream-Status`가 공급자의 `4xx` 또는 `2xx`일 때만 존재합니다. 즉, 공급자가 요청을 잘못된 형식으로 거부하면서 그 이유를 밝힌 경우입니다. 보통 그 상태 코드는 `4xx`이며, 거부된 생성을 성공 응답 봉투 안에서 보고하는 공급자의 경우에는 `2xx`입니다(BytePlus의 실패한 작업 폴링은 HTTP `200`에 사유를 본문에 담습니다). 공급자 `5xx`, 전송 실패, 콘텐츠 정책 거부, Router가 자기 자신에 대해 발생시킨 모든 거부를 포함한 다른 모든 실패에서는 존재하지 않습니다. `X-Comfy-Upstream-Detail` 헤더를 그대로 반영합니다. `invalid_input`으로 종료된 실행의 대기 중 수집(`GET /v2/models/{provider}/{model}/requests/{request_id}`)은 첫 번째 수집에서 이 필드에 동일한 사유를 담고, 그 시점에 요청에서 이를 삭제합니다. 나중의 수집은 보통 이 필드 없이 동일한 `error_type`과 `detail`로 응답하므로, 첫 번째 수집에서 읽어야 합니다. 그 읽기 요청은 두 헤더를 모두 보내지 않습니다. - 콘텐츠 정책 거부가 어떤 입력 또는 출력에 관한 것인지를 Router 수준의 닫힌 어휘로 나타냅니다. `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`입니다. 공급자가 모달리티를 명시하지 않은 경우, 값이 `input` / `output`만으로 해당 측을 지칭합니다. `error_type`이 `content_policy_violation`이고 공급자가 거부된 대상을 기계 판독 가능한 코드로 명시한 경우에만 존재하며, 그 외에는 존재하지 않습니다. 공급자 텍스트는 절대 아닙니다. 현재 BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI, Wan의 거부와 MiniMax Router의 Nano Banana 레그의 Gemini 거부에 대해 명시됩니다. 거부가 어느 측에 관한 것인지 밝히지 않는 공급자의 경우 이 값이 존재하지 않습니다. `X-Comfy-Refusal-Subject` 헤더를 그대로 반영합니다. + 콘텐츠 정책 거부가 어떤 입력 또는 출력에 관한 것이었는지를 Router 수준의 닫힌 어휘로 나타냅니다: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. 공급자가 모달리티를 명시하지 않은 경우에는 `input` / `output` 값만으로 어느 쪽인지 나타냅니다. `error_type`이 `content_policy_violation`이고 공급자가 거부된 대상를 기계 판독 가능한 코드로 명시한 경우에만 존재하며, 그 외에는 존재하지 않습니다. 공급자 텍스트는 결코 아닙니다. 현재 BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI, Wan의 거부와, MiniMax Router의 Nano Banana 레그에 대한 Gemini 거부에 대해 명명되며, 거부 사유가 어느 쪽에 관한 것인지 밝히지 않는 공급자는 이 필드가 비어 있습니다. `X-Comfy-Refusal-Subject` 헤더를 그대로 반영합니다. - 파트너 노드 지출 거부에 대한 빌링의 정책 분기로, 청구 대상 지갑이 비어 있으면 `no_funds`, 자금 조회 결과 없이 호출이 거부되면 `unspecified`입니다. `error_type`이 `insufficient_credits`이고 배포가 지갑 정보를 보고하는 경우에만 존재하며, 그 외에는 존재하지 않습니다. 표시 텍스트가 아닌 기계 판독 가능한 코드입니다. `detail`을 표시하고, 이 값을 기준으로 분기하십시오. + 파트너 노드 지출 거부에 대한 빌링의 정책 분기입니다. 청구 대상 지갑이 비어 있으면 `no_funds`, 잔액 조회에서 그렇게 밝히지 않은 채 호출이 거부되면 `unspecified`입니다. `error_type`이 `insufficient_credits`이고 배포 환경이 지갑 정보를 보고하는 경우에만 존재하며, 그 외에는 존재하지 않습니다. 표시용 텍스트가 아닌 기계 판독 가능한 코드이므로, `detail`을 보여주고 분기는 이 값으로 하세요. - 거부된 호출이 청구했을 지갑으로, `RouterErrorResponse.billed_workspace`에 있습니다. "어느 지갑이 비어 있는가?"에 답합니다. 이는 호출자의 UI에서 현재 선택된 워크스페이스와 반드시 같지는 않으며, 팀 멤버의 개인 자격 증명은 자금이 있는 팀이 열려 있는 동안에도 여기에 개인 지갑을 명시합니다. `denied_reason`과 함께일 때만 존재합니다. + 거부된 호출이 청구했을 지갑이며, `RouterErrorResponse.billed_workspace`에 해당합니다. "어느 지갑이 비어 있는가?"에 답합니다. 호출자의 UI에서 현재 선택된 워크스페이스와 반드시 같은 것은 아니며, 팀 멤버의 개인 자격 증명은 자금이 있는 팀이 열려 있는 동안에도 여기에서 해당 개인의 개인 지갑을 가리킵니다. `denied_reason`과 함께일 때만 존재합니다. 유형: [`RouterBilledWorkspace`](#routerbilledworkspace) - 거부된 요청이 어떻게 인증했는지 나타냅니다: `personal_api_key`, `team_api_key`, `personal_session`, `team_session`. "다른 지갑으로 청구하려면 어떤 자격 증명으로 전환해야 하는가?"에 답합니다. 권한이 아니며 아무것도 부여하지 않습니다. `denied_reason`과 함께일 때만 존재합니다. + 거부된 요청이 어떤 방식으로 인증했는지를 나타냅니다: `personal_api_key`, `team_api_key`, `personal_session` 또는 `team_session`. "다른 지갑에 청구하려면 어떤 자격 증명으로 전환해야 하는가?"에 답합니다. 권한이 아니며 아무것도 부여하지 않습니다. `denied_reason`과 함께일 때만 존재합니다. ### RouterErrorType 기계가 읽을 수 있는 Router 오류 카테고리이며, `X-Comfy-Error-Type` 헤더로도 전송됩니다. -유형: `string` +타입: `string` ### RouterModelBilling @@ -1245,18 +1245,18 @@ Type: `string` **필드** - 이 모델이 콘텐츠 정책을 이유로 거부한 호출이 그럼에도 불구하고 호출자에게 청구되는지 여부입니다. 공급자마다 다르며, 그 차이는 호출 시점에 보이지 않습니다. 같은 호출에 대해 오류와 청구를 함께 보는 사용자는 그 사실을 미리 알 방법이 없었습니다. 따라서 공급자별 속설에 맡기지 않고 호출 전에 모델별로 명시합니다. 값이 `yes`이면 동기 경로의 `content_policy_violation` 오류에 `X-Comfy-Credits-Used`가 포함될 수 있습니다. 공급자가 모델이 생성한 출력을 거부했고 Comfy가 해당 거부된 생성에 대한 사용량을 기록한 경우 포함되며, 그 수량을 담습니다. 입력 측 거부, 동일 키 재실행(`Idempotent-Replayed: true`), 그리고 헤더의 소수점 두 자리로 표시하기에 너무 작은 청구에는 포함되지 않습니다. 헤더가 없는 거부는 보고되지 않으며, 그것이 무료였다는 증거도 아닙니다. + 이 모델이 콘텐츠 정책을 이유로 거부한 호출이 그럼에도 호출자에게 청구되는지 여부입니다. 공급자마다 다르고, 그 차이는 호출 시점에 드러나지 않으며, 같은 호출에 대해 오류와 청구를 함께 보는 사용자는 알 방법이 없었습니다. 그래서 공급자별 통념에 맡기지 않고 호출 전에 모델별로 명시합니다. 값이 `yes`이면 동기 경로의 `content_policy_violation` 오류에 `X-Comfy-Credits-Used`가 포함될 수 있습니다. 공급자가 모델의 생성된 출력을 거부했고 Comfy가 그 거부된 생성에 대한 사용량을 기록한 경우 포함되며, 해당 수량을 담습니다. 입력 측 거부, 동일 키 재생(`Idempotent-Replayed: true`), 헤더의 소수점 두 자리로 표시하기에 너무 작은 청구에는 포함되지 않습니다. 헤더가 없는 거부는 보고되지 않은 것이지, 무료였다는 증거는 아닙니다. 유형: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -Comfy Router 모델 하나에 대한 모델별 상세 정보입니다. 카탈로그 목록이 해당 모델에 대해 보고하는 모든 항목에 더해, 단일 모델 경로에서만 제공되는 모델별 필드를 포함합니다. +하나의 Comfy Router 모델에 대한 모델별 상세 정보입니다. 카탈로그 목록이 해당 모델에 대해 보고하는 모든 항목과 단일 모델 라우트에서만 제공하는 모델별 필드를 포함합니다. -[`RouterModelListEntry`](#routermodellistentry), [`RouterModelDetailFields`](#routermodeldetailfields)를 구성합니다. +다음으로 구성됩니다: [`RouterModelListEntry`](#routermodellistentry), [`RouterModelDetailFields`](#routermodeldetailfields). -Type: `object` +타입: `object` ### RouterModelDetailFields @@ -1265,7 +1265,7 @@ Type: `object` **필드** - 입력 및 출력 스키마를 포함한 이 모델의 OpenAPI 문서 URL입니다. + 이 모델의 OpenAPI 문서 URL로, 입력 및 출력 스키마를 포함합니다. HTTPS URL, 예: `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, 최대 2048자 @@ -1274,19 +1274,19 @@ Type: `object` `POST /v2/models/{provider}/{model}`에서 사용되는 모델 ID입니다. -유형: `string`. 모델 ID(예: `anthropic/claude-opus-4-6`), 최대 193자 +Type: `string` -- 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 ### RouterModelInput -모델 입력 객체입니다. 필드와 검증 정보는 선택된 모델의 OpenAPI 문서를 참조하세요. +모델 입력 객체입니다. 필드와 검증에 대해서는 선택한 모델의 OpenAPI 문서를 참조하세요. -타입: `object` +유형: `object` ### RouterModelInputSchemaDocument 하나의 모델 입력과 출력을 위한 독립형 OpenAPI 문서입니다. -유형: `object` +Type: `object` ### RouterModelListEntry @@ -1295,31 +1295,31 @@ Type: `object` **필드** - 정식 Comfy Router 모델 ID로, `{provider}/{model}` 형식입니다. `POST /v2/models/{provider}/{model}`에서 해당 모델을 지정하는 값과 정확히 동일하므로, 호출자는 다른 곳에서 다시 유도할 필요 없이 이 값을 그 경로에 그대로 삽입할 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 결합한 것이며, `maxLength`는 두 값의 길이 합에 해당 구분자를 더한 값입니다. + 정식 Comfy Router 모델 ID로, 형식은 `{provider}/{model}`입니다. 이는 `POST /v2/models/{provider}/{model}`에서 해당 모델을 지정하는 값과 정확히 일치하므로, 호출자는 다른 곳에서 값을 다시 도출할 필요 없이 이 ID를 그 경로에 그대로 넣을 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 이어 붙인 것이고, `maxLength`는 두 세그먼트 길이의 합에 구분자 하나를 더한 값입니다. - 유형: [`RouterModelId`](#routermodelid). 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 + 유형: [`RouterModelId`](#routermodelid) - 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 - 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `provider` 세그먼트로, 모델을 지정하는 대상인 파트너를 가리킵니다. 호출 경로의 `provider` 경로 파라미터와 카탈로그 항목의 `provider` 필드가 모두 이 하나의 스키마를 참조하며, 덕분에 목록에 표시되는 ID와 허용되는 ID가 서로 어긋나지 않습니다. + 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `provider` 세그먼트로, 어떤 파트너의 모델을 지정하는지를 나타냅니다. 호출 경로의 `provider` 경로 매개변수와 카탈로그 항목의 `provider` 필드는 모두 이 하나의 스키마를 참조하며, 덕분에 목록에 나오는 ID와 허용되는 ID가 서로 어긋나지 않습니다. - 유형: [`RouterProviderSegment`](#routerprovidersegment). 영숫자 슬러그, 예: `anthropic`, 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment) - 영숫자 슬러그, 예: `anthropic`, 최대 64자 - 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `model` 세그먼트로, 해당 공급자 안에서 실행할 모델을 가리킵니다. `RouterProviderSegment`와 동일한 불일치 방지 이유로, 호출 경로의 `model` 경로 파라미터와 카탈로그 항목의 `model` 필드가 이 스키마를 함께 사용합니다. + 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `model` 세그먼트로, 해당 공급자 안에서 실행할 모델을 나타냅니다. 호출 경로의 `model` 경로 매개변수와 카탈로그 항목의 `model` 필드가 함께 사용하며, `RouterProviderSegment`와 같은 이유로 ID가 어긋나지 않도록 합니다. - 유형: [`RouterModelSegment`](#routermodelsegment). 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment) - 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 - 호출 전에 호출자가 알아야 하는 모델별 과금 정보이며, 가격이 아닙니다. 사용량과 비용 수치는 여기에 절대 나타나지 않습니다. + 호출하기 전에 호출자가 알아야 하는 모델별 과금 정보이며, 가격이 아닙니다. 사용량과 비용 수치는 여기에 절대 나타나지 않습니다. 유형: [`RouterModelBilling`](#routermodelbilling) - 이 모델의 `GET /v2/models/{provider}/{model}/openapi.json` 문서에 대한 현재의 strong `ETag`입니다. 스키마가 변경되지 않은 동안에는 해당 읽기 요청에 이 값을 `If-None-Match`로 보내 `304`를 받을 수 있고, 지난번에 확인한 값과 비교하면 모든 문서를 가져오지 않고도 어떤 모델의 스키마가 변경되었는지 알 수 있습니다. 이 호출자에 대해 그 시점에 해당 읽기 요청이 `200`을 반환하지 않는 경우에는 값이 존재하지 않습니다. 스키마 서비스를 사용할 수 없거나, 모델 문서를 렌더링할 수 없거나, 응답이 만들어지는 도중에 이 호출자에게 해당 모델이 사용 불가 상태가 된 경우입니다. 태그가 없다고 해서 스키마가 변경된 것은 아니므로, 현재 태그를 확인하려면 모델 문서를 다시 읽어야 합니다. + 이 모델의 `GET /v2/models/{provider}/{model}/openapi.json` 문서에 대한 현재의 strong `ETag`입니다. 스키마가 변경되지 않은 동안에는 이 값을 해당 읽기 요청의 `If-None-Match`로 보내 `304`를 받을 수 있고, 또는 이전에 확인한 값과 비교하여 모든 문서를 가져오지 않고도 어떤 모델의 스키마가 변경되었는지 알 수 있습니다. 이 시점에 이 호출자에 대해 해당 읽기가 `200`을 응답하지 않는 경우에는 값이 없습니다. 즉 스키마 서비스를 사용할 수 없거나, 모델의 문서를 렌더링할 수 없거나, 응답을 생성하는 동안 모델이 이 호출자에게 사용 불가 상태가 된 경우입니다. 태그가 없다고 해서 스키마가 변경된 것은 아니므로, 현재 태그를 알려면 모델의 문서를 다시 읽으십시오. ### RouterModelListResponse @@ -1329,96 +1329,96 @@ Router 모델 카탈로그의 한 페이지입니다. **필드** - 이 페이지에 포함된 모델이며, 최대 `limit`개까지입니다. + 이 페이지에 있는 모델들이며, 최대 `limit`개입니다. - Type: array of [`RouterModelListEntry`](#routermodellistentry) + 타입: [`RouterModelListEntry`](#routermodellistentry)의 배열 - 이 페이지 이후에 또 다른 페이지가 존재하는지 여부입니다. 이 값이 참인 동안 계속 진행하세요. `data`가 짧거나 비어 있다고 해서 카탈로그의 끝이라고 추론해서는 안 됩니다. + 이 페이지 이후에 또 다른 페이지가 존재하는지 여부입니다. 이 값이 참인 동안 계속 순회하세요. `data`가 짧거나 비어 있다고 해서 카탈로그의 끝이라고 추론해서는 안 됩니다. - Router 목록을 가리키는 불투명 커서입니다. 서버가 생성하며 오직 그대로 되돌려 보내는 용도로만 사용됩니다. 즉, 오프셋도 아니고 모델 ID도 아니며, 정렬된 값도 아니고, 카탈로그가 재구축되면 안정적이지도 않습니다. 따라서 커서를 파싱하거나, 값을 증가시키거나, 커서가 나온 순회 범위를 벗어나 저장하는 것은 모두 계약 범위를 벗어납니다. 오프셋 대신 커서를 쓰는 이유는 카탈로그가 계속 변하는 목록이기 때문입니다. 오프셋 순회는 순회 도중 항목이 추가되거나 삭제되면 조용히 항목을 건너뛰거나 반복하며, 호출자는 그런 일이 발생했는지 알 수 없습니다. + Router 목록을 가리키는 불투명한 커서입니다. 서버가 생성하며 오직 그대로 되돌려 보내는 용도로만 쓰입니다. 오프셋도, 모델 ID도 아니고, 정렬된 순서를 가지지도 않으며, 카탈로그가 재구축되면 안정적이지도 않습니다. 따라서 커서를 파싱하거나, 값을 증가시키거나, 커서가 나온 순회를 벗어나 저장하는 것은 모두 계약 범위를 벗어납니다. 오프셋 대신 커서를 쓰는 이유는 카탈로그가 계속 변하는 목록이기 때문입니다. 오프셋 순회는 순회 도중 항목이 추가되거나 삭제되면 조용히 항목을 건너뛰거나 반복하며, 호출자는 그런 일이 일어났는지 알 수 없습니다. - Type: [`RouterPageCursor`](#routerpagecursor). `next_cursor`로 반환되는 불투명 커서, 1–512자 + 타입: [`RouterPageCursor`](#routerpagecursor) -- `next_cursor`로 반환되는 불투명 커서, 1–512자 - 실제로 제공된 페이지 크기입니다. 요청한 `limit`이 최댓값을 넘으면 거부되지 않고 최댓값으로 낮춰지므로, 이 값은 요청한 값보다 작을 수 있습니다. 보낸 값이 아니라 이 숫자로 페이지를 넘겨야 합니다. 그렇지 않으면 받지도 못한 행이 있다고 착각하게 됩니다. + 실제로 제공된 페이지 크기입니다. 최댓값을 넘는 `limit`을 요청하면 거부되지 않고 최댓값으로 제한되므로, 이 값은 요청한 값보다 작을 수 있습니다. 페이지네이션은 보낸 값이 아니라 이 숫자로 하세요. 그렇지 않으면 받지도 못한 행이 있다고 가정하게 됩니다. 1–100 ### RouterModelOutput -모델 결과 객체입니다. 정확한 형태는 선택된 모델의 출력 스키마를 참조하세요. +모델 결과 객체입니다. 정확한 형태는 선택된 모델의 출력 스키마를 참고하세요. 유형: `object` ### RouterModelSegment -`{provider}/{model}` 모델 ID에서 모델에 해당하는 부분입니다. +`{provider}/{model}` 모델 ID의 모델 부분입니다. -타입: `string` -- 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 +유형: `string`. 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 ### RouterPageCursor -불투명한 카탈로그 커서입니다. `cursor`로 변경 없이 그대로 전달하세요. +불투명한 카탈로그 커서입니다. `cursor`로 변경 없이 그대로 다시 전달하세요. -유형: `string` -- `next_cursor`로 반환되는 불투명 커서이며, 1–512자입니다. +유형: `string` -- `next_cursor`로 반환되는 불투명 커서, 1–512자 ### RouterProviderSegment -`{provider}/{model}` 모델 ID에서 공급자에 해당하는 부분입니다. +`{provider}/{model}` 모델 ID에서 공급자 부분입니다. -Type: `string` -- 영숫자 슬러그(예: `anthropic`), 최대 64자 +타입: `string`. 영숫자 슬러그(예: `anthropic`), 최대 64자 ### RouterQueueCancelResponse -이 라우트가 처리한 요청을 설명하는 두 상태, 즉 `202`와 `409`에 대한 취소 요청의 응답입니다. 성공 봉투와 오류 봉투를 따로 두지 않고 두 상태에 하나의 본문 형태를 사용하는 이유는, 둘 다 같은 내용, 즉 취소가 찾아낸 결과를 말하고 있기 때문입니다. 상태 코드마다 다른 타입을 파싱해야 하는 클라이언트는 이런 분리에서 얻는 것이 없습니다. +이 라우트가 처리한 요청을 설명하는 두 상태 코드, 즉 `202`와 `409`에 대한 취소 요청의 응답입니다. 성공 envelope와 오류 envelope를 따로 두는 대신 두 상태 모두에 하나의 본문 형태를 사용합니다. 두 상태 모두 "취소가 발견한 것"이라는 동일한 진술이며, 상태 코드마다 다른 타입을 파싱해야 하는 클라이언트는 이러한 분리에서 얻는 것이 없기 때문입니다. -**Fields** +**필드** - 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하며 결과를 수집할 때 사용하는 핸들입니다. + 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링, 취소, 결과 수집에 사용하는 핸들입니다. - Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Up to 36 characters + 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 - 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 대해, 취소 요청이 찾아낸 내용입니다. 두 결과 모두 HTTP 상태로 그대로 반영되므로 클라이언트는 어느 쪽으로 분기해도 됩니다. + 취소 요청이 발견한 것으로, 이 라우트가 실제로 처리한 요청을 설명하는 두 결과에 해당합니다. 둘 다 HTTP 상태 코드에 그대로 반영되므로 클라이언트는 어느 쪽으로든 분기할 수 있습니다. - Type: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) + 타입: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -취소 요청이 확인한 내용으로, 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 해당합니다. 두 결과 모두 HTTP 상태에 반영되므로 클라이언트는 둘 중 어느 것을 기준으로도 분기할 수 있습니다. +취소 요청이 확인한 내용으로, 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 대한 것입니다. 두 결과 모두 HTTP 상태로 반영되므로 클라이언트는 둘 중 어느 것으로든 분기할 수 있습니다. -타입: `string` +유형: `string` ### RouterQueuePosition -응답이 만들어진 시점에 실행 대기열에서 이 요청보다 앞에 있는 요청이 몇 개인지 나타냅니다. 0이면 이 요청이 맨 앞에 있다는 뜻입니다. +응답이 만들어진 즉시, 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있음을 의미합니다. 타입: `integer` -- 최소 0 ### RouterQueueRequestId -대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하거나 취소하거나 결과를 수집할 때 사용하는 핸들입니다. +대기 중인 Router 요청 하나의 식별자입니다. 호출자가 결과를 폴링하고, 취소하고, 수집할 때 사용하는 핸들입니다. -유형: `string`, `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 +Type: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 ### RouterQueueStatus -대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이 것은 닫힌 `enum`입니다. 두 스키마가 의도적으로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 확장될 것으로 예상됩니다. 따라서 인식되지 않은 버킷을 엄격하게 거부하는 생성된 클라이언트는 무언가 이미 잘못되었을 때 가장 심하게 실패할 것입니다. 이 것은 라이프사이클이며, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었는지 여부에 관계없이 그것에 대해 작성된 모든 폴링 루프에 대한 호환성을 깨는 변경입니다. 따라서 enum으로 선언되고, 제약 조건은 클라이언트가 볼 수 있는 곳에 명시됩니다. +대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`와 달리 이것은 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`는 실패를 분류하며 그 집합은 커질 것으로 예상되므로, 인식되지 않은 버킷을 강하게 거부하는 생성된 클라이언트는 문제가 이미 발생한 바로 그때 가장 심하게 실패할 것입니다. 이것은 생명주기이며, 나중에 네 번째 상태가 추가된 생명주기는 enum으로 선언되었든 아니든 이를 대상으로 작성된 모든 폴링 루프에 브레이킹 체인지입니다. 따라서 enum으로 선언하고, 제약 조건은 클라이언트가 볼 수 있는 곳에 명시합니다. 타입: `string` ### RouterQueueStatusFields -`RouterQueueStatusResponse`에서 URL 블록을 제외한 나머지 절반입니다. 대기 중인 요청 하나의 식별자, 현재 상태, 그리고 그 상태가 터미널이면서 실행이 성공하지 못했을 때 그 이유를 나타내는 포괄적인 분류입니다. +`RouterQueueStatusResponse`에서 URL 블록을 제외한 나머지 절반입니다. 대기 중인 요청 하나의 식별자, 현재 상태, 그리고 그 상태가 터미널이고 실행이 성공하지 못했을 때 그 이유를 나타내는 개략적 분류입니다. **필드** @@ -1429,45 +1429,44 @@ Type: `string` -- 영숫자 슬러그(예: `anthropic`), 최대 64자 - 대기 중인 Router 요청의 상태입니다. 값은 정확히 세 가지이며, `RouterErrorType`과 달리 이 스키마는 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식하지 못한 분류를 강하게 거부하는 생성된 클라이언트는 이미 무언가 잘못된 상황에서 가장 크게 실패하게 됩니다. 이 스키마는 생명주기이고, 나중에 네 번째 상태가 추가된 생명주기는 enum으로 선언되었든 아니든 그에 맞춰 작성된 모든 폴링 루프에 호환성을 깨뜨리는 변경이 됩니다. 그래서 enum으로 선언하고, 그 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. + 대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이것은 닫힌 `enum`입니다. 두 스키마는 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 커질 것으로 예상되므로, 인식되지 않은 분류를 단호히 거부하는 생성된 클라이언트는 이미 뭔가 잘못된 바로 그 시점에 가장 크게 실패하게 됩니다. 이 값은 라이프사이클이고, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되든 아니든 그것을 기준으로 작성된 모든 폴링 루프에 호환성을 깨는 변경입니다. 그래서 enum으로 선언하고, 그 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. Type: [`RouterQueueStatus`](#routerqueuestatus) - 응답이 구성된 순간에 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있다는 뜻입니다. + 응답이 구성된 그 순간을 기준으로, 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다. - Type: [`RouterQueuePosition`](#routerqueueposition) -- 최소 0 + Type: [`RouterQueuePosition`](#routerqueueposition) -- 0 이상 - 성공하지 못한 `COMPLETED` 요청에만 존재하며, 그 실패를 반환할 때 결과 조회가 `X-Comfy-Error-Type`에 붙이는 것과 동일한 포괄적 분류를 담습니다. 이것이 성공한 터미널 요청과 실패하거나 취소된 요청을 구분하는 수단이며, 두 경우 모두를 위한 별도의 터미널 상태는 없습니다. 그리고 성공 시에는 null이 아니라 아예 존재하지 않으므로, 존재 여부로 분기해야 합니다. + 성공하지 못한 `COMPLETED` 요청에만 존재하며, 결과 조회가 해당 실패를 반환할 때 `X-Comfy-Error-Type`에 붙이는 것과 동일한 개략적 분류를 담고 있습니다. 성공한 터미널 요청과 실패하거나 취소된 요청을 구분하는 값입니다. 두 경우 모두 별도의 터미널 상태가 없습니다. 또한 성공 시에는 null이 아니라 아예 존재하지 않으므로, 존재 여부로 분기해야 합니다. Type: [`RouterErrorType`](#routererrortype) - ### RouterQueueStatusResponse -대기 중인 요청 하나의 현재 상태로, 제출 시 반환된 것과 동일한 세 개의 URL로 구성됩니다. +대기 중인 요청 하나의 현재 상태로, 제출 시 반환된 것과 동일한 세 개의 URL과 함께 구성됩니다. -[`RouterQueueUrls`](#routerqueueurls)와 [`RouterQueueStatusFields`](#routerqueuestatusfields)로 구성됩니다. +[`RouterQueueUrls`](#routerqueueurls), [`RouterQueueStatusFields`](#routerqueuestatusfields)를 구성합니다. -Type: `object` +타입: `object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse`에서 URL 블록을 제외한 나머지 절반입니다. 새 요청의 식별자와 요청이 접수된 순간의 상태를 담습니다. +`RouterQueueSubmitResponse`에서 URL 블록을 제외한 나머지 절반입니다. 새 요청의 식별자와, 그 요청이 접수된 순간의 상태를 담습니다. **필드** - 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 이 핸들로 상태를 조회하고, 취소하고, 결과를 수집합니다. + 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고, 취소하고, 결과를 수집할 때 사용하는 핸들입니다. 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 - 대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이 스키마는 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식할 수 없는 값을 강하게 거부하는 생성된 클라이언트는 무언가가 이미 잘못된 바로 그 시점에 가장 심하게 실패하게 됩니다. 반면 이 값은 생명주기이며, 나중에 네 번째 상태가 추가된 생명주기는 enum으로 선언되었든 아니든 이를 대상으로 작성된 모든 폴링 루프에 breaking change가 됩니다. 그래서 enum으로 선언하고, 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. + 대기 중인 Router 요청의 상태입니다. 값은 정확히 세 가지이며, `RouterErrorType`과 달리 이 스키마는 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 앞으로 늘어날 것으로 예상되므로, 인식하지 못한 버킷을 강하게 거부하는 생성 클라이언트는 무언가가 이미 잘못된 바로 그 시점에 가장 크게 실패하게 됩니다. 반면 이 값은 생애 주기이며, 나중에 네 번째 상태를 추가하는 생애 주기는 enum으로 선언되었든 아니든 그에 맞춰 작성된 모든 폴링 루프에 호환성을 깨뜨리는 변경이 됩니다. 그래서 enum으로 선언하고, 그 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. 타입: [`RouterQueueStatus`](#routerqueuestatus) @@ -1479,33 +1478,33 @@ Type: `object` - 이 요청에 대한 사전 비용 추정치로, 호출자에 대해 비용 추정이 활성화된 경우 새로 접수될 때 포함됩니다. 이 요청이 고정된 공급자 구간을 제시합니다(실행 대기열에는 폴백 루프가 없으므로 `fallback_provider`는 실행되는 구간을 바꾸지 않습니다). 수치를 제시할 수 없을 때도 `source: unknown`과 함께 그대로 포함되며, 제출이 추정치 때문에 실패하는 일은 없습니다. 멱등 재생(`Idempotent-Replayed: true`)에서는 생략되는데, 원본 견적이 저장되지 않기 때문입니다. 이는 추정치일 뿐 최종 청구액도, 가격 고정도 아닙니다. 실행은 평가 시점에 적용되는 요율로 청구되며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다. + 이 요청에 대한 사전 비용 추정치로, 호출자에게 비용 추정이 활성화되어 있을 때 새로 접수된 요청에 포함됩니다. 이 요청이 고정된 공급자 구간을 기준으로 산정됩니다. 실행 대기열에는 대체(fallback) 루프가 없으므로 `fallback_provider`가 실제로 실행되는 구간을 바꾸지 않습니다. 수치를 제시할 수 없을 때도 `source: unknown`과 함께 그대로 포함됩니다. 제출은 추정치 때문에 실패하지 않습니다. 멱등 재생(`Idempotent-Replayed: true`)에서는 원본 견적이 저장되지 않으므로 생략됩니다. 이는 추정치이며 최종 청구액도, 가격 고정도 아닙니다. 실행은 요금이 산정되는 시점에 유효한 요율로 청구되며, 워크스페이스의 사용량 및 결제 기록에 정산된 청구액이 최종입니다. 타입: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -실행이 실행 대기열에 수락될 때 반환되는 핸들로, 요청의 ID와 상태에 수명 주기의 나머지 부분을 처리하는 세 개의 URL을 결합한 것입니다. +실행이 실행 대기열에 수락될 때 반환되는 핸들입니다. 요청의 식별 정보와 상태에, 수명 주기의 나머지 부분을 처리하는 세 개의 URL을 결합한 것입니다. -다음을 구성합니다: [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields). +[`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields)로 구성됩니다. -Type: `object` +타입: `object` ### RouterQueueUrls -대기 중인 요청의 나머지 수명 주기를 처리하는 세 개의 URL로, 라이브 핸들을 포함하는 모든 응답에서 반환되므로 클라이언트가 실행 대기열 URL을 직접 구성할 필요가 없습니다. +대기 중인 요청 하나의 남은 수명 동안 사용할 세 개의 URL입니다. 클라이언트가 실행 대기열 URL을 직접 구성하지 않도록, 활성 핸들을 포함하는 모든 응답에서 반환됩니다. **필드** - 이 요청의 상태 조회에 대한 절대 URL입니다. + 이 요청의 상태 조회를 위한 절대 URL입니다. URI - 이 요청의 결과를 수집하는 절대 URL입니다. + 이 요청의 결과를 가져오는 절대 URL입니다. URI @@ -1518,9 +1517,9 @@ Type: `object` ### RouterValidationErrorContext -공급자가 제공한, 실패한 검증 규칙에 대한 세부 정보입니다. +실패한 검증 규칙에 대해 공급자가 제공한 세부 정보입니다. -Type: `object` +유형: `object` ### RouterValidationErrorDetail @@ -1529,7 +1528,7 @@ Type: `object` **필드** - 문제가 된 필드의 경로이며, 가장 바깥쪽 세그먼트가 먼저 옵니다. 예를 들어 `["body", "image_url"]`, 또는 정수가 배열을 인덱싱하는 `["body", "images", 0]`과 같습니다. + 문제가 발생한 필드까지의 경로이며, 가장 바깥 세그먼트가 먼저 옵니다. 예를 들어 `["body", "image_url"]` 또는 정수가 배열의 인덱스를 가리키는 `["body", "images", 0]`과 같습니다. @@ -1537,33 +1536,33 @@ Type: `object` - 이 실패에 대한 구체적이고 기계 판독 가능한 사유로, 공급자로부터 변경 없이 그대로 전달됩니다. 타입이 지정된 SDK 예외 계층이 분기하는 값이 바로 이것이며, 응답 헤더의 `error_type`은 그저 포괄적인 분류일 뿐입니다. + 이 실패의 구체적이고 기계가 읽을 수 있는 사유이며, 공급자로부터 변경 없이 그대로 전달됩니다. 타입이 지정된 SDK 예외 계층이 분기하는 값이 바로 이것이며, 응답 헤더의 `error_type`은 그저 이를 묶은 상위 범주일 뿐입니다. - 하나의 `RouterValidationErrorDetail`에 대해 위반된 경계값으로, 공급자로부터 그대로 전달됩니다. 예를 들어 `greater_than`과 함께 오는 `{"limit_value": 8}`, `image_too_small`과 함께 오는 `{"min_width": 512}`, `file_too_large`와 함께 오는 `{"max_size_bytes": 10485760}`과 같습니다. 키 집합은 공급자와 오류 타입에 따라 다르므로 이 객체는 의도적으로 열린 객체입니다. 고정된 필드 목록으로 좁히거나 `msg` 문자열에 합쳐 버리면, 이식된 통합이 컴파일은 되지만 경계값을 읽던 분기를 조용히 잃게 되는 바로 그 원인이 됩니다. 오류 타입에 경계값이 없으면 생략됩니다. + 하나의 `RouterValidationErrorDetail`에서 위반된 경계 값으로, 공급자로부터 그대로 전달됩니다. 예를 들어 `greater_than`과 함께 오는 `{"limit_value": 8}`, `image_too_small`과 함께 오는 `{"min_width": 512}`, `file_too_large`와 함께 오는 `{"max_size_bytes": 10485760}`과 같습니다. 키 집합은 공급자와 오류 타입에 따라 달라지므로, 이 객체는 의도적으로 열린 객체입니다. 고정된 필드 목록으로 좁히거나 `msg` 문자열에 합쳐 버리면, 이식된 통합이 컴파일은 되지만 해당 경계를 읽던 분기를 조용히 잃게 되는 바로 그 원인이 됩니다. 오류 타입에 경계 값이 없는 경우에는 존재하지 않습니다. 타입: [`RouterValidationErrorContext`](#routervalidationerrorcontext) - 문제가 된 입력 값으로, 호출자가 `loc`에서 다시 도출하지 않고도 무엇이 거부되었는지 확인할 수 있도록 그대로 되돌려 전달됩니다. 문자열, 숫자, 논리값, 배열, 객체, null 등 모든 JSON 타입을 담을 수 있으므로, 이 스키마는 객체로 좁히지 않고 의도적으로 타입을 지정하지 않았습니다. 공급자가 입력을 그대로 되돌려주지 않으면 생략됩니다. + 문제가 된 입력 값으로, 호출자가 `loc`에서 다시 추론하지 않고도 무엇이 거부되었는지 볼 수 있도록 그대로 되돌려 전달됩니다. 문자열, 숫자, 논리값, 배열, 객체 또는 null 등 모든 JSON 타입이 될 수 있으므로, 이 스키마는 객체로 좁히지 않고 의도적으로 타입을 지정하지 않은 상태로 둡니다. 공급자가 입력을 되돌려 전달하지 않는 경우에는 존재하지 않습니다. 타입: [`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -거부된 입력 값입니다. 공급자가 이 값을 포함하는 경우에 제공됩니다. +공급자가 포함한 경우, 거부된 입력 값입니다. ### RouterValidationErrorResponse -`422` 검증 오류 본문입니다. 카테고리는 `X-Comfy-Error-Type`에서 확인하세요. +`422` 검증 오류 본문입니다. 카테고리는 `X-Comfy-Error-Type`을 확인하세요. **필드** - 요청에서 발견된 모든 검증 실패 항목으로, 문제가 있는 필드마다 하나의 항목이 대응됩니다. + 요청에서 발견된 모든 검증 실패이며, 문제가 있는 필드마다 항목이 하나씩 있습니다. - 유형: [`RouterValidationErrorDetail`](#routervalidationerrordetail)의 배열 + 타입: [`RouterValidationErrorDetail`](#routervalidationerrordetail)의 배열 diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index f13eb304ba..e8baf76a28 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 模型" sidebarTitle: "所有模型" description: "Comfy Router 提供的全部模型,按提供方分组,并列出每个模型的输入和输出模态。" -translationSourceHash: c9297323 +translationSourceHash: 947ab0cb translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 @@ -20,7 +20,7 @@ translationBlockHashes: "HeyGen": 76fe1a0d "Higgsfield": 0ce2b918 "Ideogram": c22a0e5e - "Kling": 2b95e99f + "Kling": aec38bcd "Krea": 16b83e5e "LTX": 32595bf9 "Luma": 8cd2a7ce @@ -47,6 +47,7 @@ translationBlockHashes: + {/* 已生成文件。由 `pnpm code-pages:gen` 从 Router 目录生成。 */} 以下每个模型都由同一条路由提供服务:`POST /v2/models/{provider}/{model}`,并使用该模型自身的 JSON 请求体。每个页面都会展示在 Python、TypeScript 和 cURL 中可用的请求示例。关于模型发现、schema、错误、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api)。 @@ -548,15 +549,15 @@ translationBlockHashes: | 模型 | ID | 输入 | 输出 | | --- | --- | --- | --- | | [Kling 3.0 Turbo](/zh/development/comfy-router/models/kling/kling-3-0-turbo/code) | `kling/kling-3.0-turbo` | 文本 | 视频 | -| [Kling 4.0](/zh/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | 文本 | 视频 | -| [Kling Image O1](/zh/development/comfy-router/models/kling/kling-image-o1/code) | `kling/kling-image-o1` | 文本, 图像 | 图像 | -| [Kling V2.5 Turbo](/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code) | `kling/kling-v2-5-turbo` | 文本 | 视频 | -| [Kling V2.6](/zh/development/comfy-router/models/kling/kling-v2-6/code) | `kling/kling-v2-6` | 文本 | 视频 | -| [Kling V3 Omni](/zh/development/comfy-router/models/kling/kling-v3-omni/code) | `kling/kling-v3-omni` | 文本, 图像, 视频 | 视频 | -| [Kling V3](/zh/development/comfy-router/models/kling/kling-v3/code) | `kling/kling-v3` | 文本 | 视频 | -| [Kling Video O1](/zh/development/comfy-router/models/kling/kling-video-o1/code) | `kling/kling-video-o1` | 文本, 图像, 视频 | 视频 | -| [Videos Avatar Image 2video](/zh/development/comfy-router/models/kling/videos-avatar-image2video/code) | `kling/videos-avatar-image2video` | 图像, 音频 | 视频 | -| [Videos Lip Sync](/zh/development/comfy-router/models/kling/videos-lip-sync/code) | `kling/videos-lip-sync` | 视频, 音频 | 视频 | +| [Kling 4.0](/zh/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | 文本、图像、视频 | 视频 | +| [Kling Image O1](/zh/development/comfy-router/models/kling/kling-image-o1/code) | `kling/kling-image-o1` | 文本、图像 | 图像 | +| [Kling V2.5 Turbo](/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code) | `kling/kling-v2-5-turbo` | 图像、文本 | 视频 | +| [Kling V2.6](/zh/development/comfy-router/models/kling/kling-v2-6/code) | `kling/kling-v2-6` | 图像、文本 | 视频 | +| [Kling V3 Omni](/zh/development/comfy-router/models/kling/kling-v3-omni/code) | `kling/kling-v3-omni` | 文本、图像、视频 | 视频 | +| [Kling V3](/zh/development/comfy-router/models/kling/kling-v3/code) | `kling/kling-v3` | 图像、文本 | 视频 | +| [Kling Video O1](/zh/development/comfy-router/models/kling/kling-video-o1/code) | `kling/kling-video-o1` | 文本、图像、视频 | 视频 | +| [Videos Avatar Image 2video](/zh/development/comfy-router/models/kling/videos-avatar-image2video/code) | `kling/videos-avatar-image2video` | 图像、音频 | 视频 | +| [Videos Lip Sync](/zh/development/comfy-router/models/kling/videos-lip-sync/code) | `kling/videos-lip-sync` | 视频、音频 | 视频 | ## Krea diff --git a/zh/development/comfy-router/models/kling/kling-4-0/code.mdx b/zh/development/comfy-router/models/kling/kling-4-0/code.mdx index 792ebe5e20..874f4f5ffd 100644 --- a/zh/development/comfy-router/models/kling/kling-4-0/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-4-0/code.mdx @@ -2,21 +2,22 @@ title: "通过 Comfy Router 使用 Kling 4.0" description: "通过 Comfy Router 调用 kling/kling-4.0:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling 4.0" -translationSourceHash: ed37a731 +translationSourceHash: df75d2dd translationFrom: development/comfy-router/models/kling/kling-4-0/code.mdx translationBlockHashes: - "_intro": a4fab55c + "_intro": 1eb48be4 "Quick start": 44d4a538 "Schema": 659ba1ad "Examples": c9f5b052 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-4.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; `kling/kling-4.0` 的 API 参考,由 Comfy Router 从 Kling 提供。 -**输入:** 文本 · **输出:** 视频 +**输入:** 文本、图像、视频 · **输出:** 视频 ## 快速开始 diff --git a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index 8ecd5d5829..400dddca68 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,23 +2,22 @@ title: "将 Kling V2.5 Turbo 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 kling/kling-v2-5-turbo:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1671e7b6 +translationSourceHash: 06b3d8e9 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: - "_intro": 2495a4d3 + "_intro": 785eeca2 "Quick start": dc63b3ac - "Schema": 3bcb036e + "Schema": e36b5646 "Examples": 8623c725 --- - {/* GENERATED FILE. Generated from router-schemas/kling/kling-v2-5-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; `kling/kling-v2-5-turbo` 的 API 参考,由 Comfy Router 提供,模型来自 Kling。 -**输入:** 文本 · **输出:** 视频 +**输入:** 图像、文本 · **输出:** 视频 ## 快速开始 @@ -166,7 +165,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 回调通知地址。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 回调通知地址。该字段会被忽略:comfy-api 在转发前会丢弃此字段;由 Comfy Router 代你轮询。 格式:`uri` @@ -192,7 +191,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 控制相机的翻滚量(z 轴)。负值表示逆时针,正值表示顺时针。 + 控制相机的翻滚幅度(z 轴)。负值表示逆时针,正值表示顺时针。 范围:`-10` 到 `10` @@ -222,7 +221,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 视频生成的灵活性。该值越高,模型的灵活度越低,与用户提示词的相关性越强。 + 视频生成的灵活度。值越高,模型的灵活度越低,与用户提示词的相关性越强。 范围:`0` 到 `1` @@ -230,23 +229,23 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 视频时长(秒) + 视频时长,单位为秒 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - 自定义任务 ID。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 自定义任务 ID。该字段会被忽略:comfy-api 在转发前会丢弃此字段;由 Comfy Router 代你轮询。 - 视频生成模式。std:标准模式,更具性价比。pro:专业模式,可生成时长更长、质量更高的视频。 + 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长、质量更高的视频。 可选值:`std`、`pro` - 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径选择。如提供名称,则必须与该路径一致。 + 模型名。使用 Comfy Router 时请省略该字段或发送 null;模型由请求路径选择。若提供名称,则必须与请求路径一致。 @@ -254,15 +253,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 该分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 - 分镜序号 + 镜头序号 - 该分镜的提示词。最大长度 512 个字符。 + 该分镜的提示词。最大长度为 512 个字符。 @@ -270,11 +269,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 负面文本提示词。推荐直接在正面提示词中通过否定语句来补充负面提示信息。 + 负面文本提示词。推荐直接在正面提示词中用否定语句补充负面提示信息。 - 正面文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序对应的声音。单个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。 + 正面文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序相匹配的音色。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。 @@ -284,17 +283,17 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持该参数。 + 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持此参数。 可选值:`on`、`off` - 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用。需要将 `sound` 设为 "on",且仅 V2.6 及之后版本的模型支持;在更早的模型上,或 `sound` 保持默认值 "off" 时,音色不会生效。 + 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用。需要将 `sound` 设为 "on",仅 V2.6 及后续版本的模型支持;在更早的模型上,或 `sound` 保持默认值 "off" 时,音色不会被应用。 - 通过音色定制 API 返回的音色 ID,或系统预置音色 ID。 + 通过音色自定义 API 返回的音色 ID,或系统预置的音色 ID。 @@ -305,7 +304,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID true 表示生成水印,false 表示不生成。 -本页面内容根据 Router 在 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。 + + 参考图像:URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,宽高比在 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 + + + + 参考图像:结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或 camera_control 同时使用。 + + +由 Router 在 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` 提供的 schema 生成,这份文档与它在请求到达提供商之前用于校验调用的是同一份文档。 ### 输出 @@ -322,7 +329,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 任务的扣减单位 + 任务的扣减单位数 @@ -360,7 +367,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 带水印的已生成视频 URL,防盗链格式 + 带水印的已生成视频的 URL,防盗链格式 格式:`uri` diff --git a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx index 7a6ba616cc..770b91060d 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,23 +2,22 @@ title: "通过 Comfy Router 使用 Kling V2.6" description: "通过 Comfy Router 调用 kling/kling-v2-6:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V2.6" -translationSourceHash: c445a7bd +translationSourceHash: 94eb0863 translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: - "_intro": 04868509 + "_intro": c2065202 "Quick start": 48a3d970 - "Schema": a61a551f + "Schema": cd52808d "Examples": 8623c725 --- - {/* GENERATED FILE. Generated from router-schemas/kling/kling-v2-6.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; `kling/kling-v2-6` 的 API 参考文档,由 Comfy Router 提供,来源于 Kling。 -**输入:** 文本 · **输出:** 视频 +**输入:** 图像、文本 · **输出:** 视频 ## 快速开始 @@ -160,13 +159,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ ### 输入 - 视频宽高比例 + 视频比例 - 可能的值:`16:9`、`9:16`、`1:1` + 可选值:`16:9`、`9:16`、`1:1` - 回调通知地址。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 回调通知地址。会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代为轮询。 格式:`uri` @@ -186,19 +185,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 控制相机在垂直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。 + 控制相机在竖直平面(x 轴)内的旋转。负值表示向下旋转,正值表示向上旋转。 范围:`-10` 到 `10` - 控制相机的滚动幅度(z 轴)。负值表示逆时针,正值表示顺时针。 + 控制相机的滚转量(z 轴)。负值表示逆时针,正值表示顺时针。 范围:`-10` 到 `10` - 控制相机在水平平面内的旋转(y 轴)。负值表示向左旋转,正值表示向右旋转。 + 控制相机在水平平面(y 轴)内的旋转。负值表示向左旋转,正值表示向右旋转。 范围:`-10` 到 `10` @@ -218,11 +217,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ 预定义的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。 - 可能的值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` + 可选值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` - 视频生成的灵活度。该值越高,模型的灵活度越低,与用户提示词的相关性越强。 + 视频生成中的灵活度。值越高,模型的灵活度越低,与用户提示词的相关性越强。 范围:`0` 到 `1` @@ -232,21 +231,21 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ 视频时长,单位为秒 - 可能的值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - 自定义任务 ID。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 自定义任务 ID。会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代为轮询。 - 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成的视频时长更长,输出质量更高。 + 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长、输出质量更高的视频。 - 可能的值:`std`、`pro` + 可选值:`std`、`pro` - 模型名。使用 Comfy Router 时请省略该参数或传入 null;模型由请求路径决定。若提供了名称,则必须与该路径一致。 + 模型名。使用 Comfy Router 时可省略此项或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。 @@ -254,7 +253,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 此分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 @@ -262,7 +261,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 该分镜的提示词。最大长度为 512 个字符。 + 此分镜的提示词。最大长度为 512 个字符。 @@ -270,7 +269,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 负面文本提示词。建议直接在正向提示词中通过否定句补充负面提示信息。 + 负面文本提示词。推荐直接在正向提示词中使用否定句来补充负面提示词信息。 @@ -278,39 +277,47 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 分镜方式。当 multi_shot 参数设为 true 时必填。 + 分镜方式。当 multi_shot 参数设置为 true 时必填。 - 可能的值:`customize`、`intelligence` + 可选值:`customize`、`intelligence` - 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持该参数。 + 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持此参数。 - 可能的值:`on`、`off` + 可选值:`on`、`off` - 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用。需要将 `sound` 设为 "on",且仅 V2.6 及之后版本的模型支持;在更早的模型上,或 `sound` 保持默认值 "off" 时,音色不会生效。 + 生成视频时引用的声音列表。最多支持 2 个声音;在 `prompt` 中按列表顺序使用 \<\<\>> 和 \<\<\>> 引用它们。要求将 `sound` 设置为 "on",仅 V2.6 及后续版本的模型支持此设置;在较早的模型上,或将 `sound` 保留为默认值 "off" 时,不会应用声音。 - 通过音色定制 API 返回的音色 ID,或系统预置音色 ID。 + 通过声音自定义 API 返回的声音 ID,或系统预设声音 ID。 - 是否同时生成带水印的结果。当前不支持自定义水印。 + 是否同时生成带水印的结果。目前不支持自定义水印。 - true 表示生成水印,false 表示不生成。 + 是表示生成水印,否表示不生成。 + + + + 参考图像 - URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,宽高比在 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 + + + + 参考图像 - 结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或 相机控制 同时使用。 -根据 Router 在 `GET /v2/models/kling/kling-v2-6/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前 Router 用于校验调用的文档相同。 +该内容由 Router 在 `GET /v2/models/kling/kling-v2-6/openapi.json` 提供的 schema 生成,与它在请求到达提供商之前校验调用所用的文档相同。 ### 输出 - 错误代码 + 错误码 @@ -346,11 +353,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 视频总时长(秒) + 视频总时长,单位为秒 - 已生成的视频 ID + 已生成视频 ID diff --git a/zh/development/comfy-router/models/kling/kling-v3/code.mdx b/zh/development/comfy-router/models/kling/kling-v3/code.mdx index e9d5b9ddf6..2499b715cd 100644 --- a/zh/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,25 +2,23 @@ title: "通过 Comfy Router 使用 Kling V3" description: "通过 Comfy Router 调用 kling/kling-v3:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V3" -translationSourceHash: e22b6413 +translationSourceHash: f5127eab translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: - "_intro": 74a12e0f + "_intro": 6b9cddba "Quick start": 09c0a41a "Serving providers": b4093d36 - "Schema": 8e8b04e6 + "Schema": 2fce4523 "Examples": 8623c725 --- - - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/kling-v3.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; `kling/kling-v3` 的 API 参考文档,由 Comfy Router 从 Kling 提供。 -**输入:** 文本 · **输出:** 视频 +**输入:** 图像、文本 · **输出:** 视频 ## 快速开始 @@ -175,13 +173,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ ### 输入 - 视频宽高比 + 视频比例 - 可选值:`16:9`、`9:16`、`1:1` + 可能的值:`16:9`、`9:16`、`1:1` - 回调通知地址。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 回调通知地址。已忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 格式:`uri` @@ -201,19 +199,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。 + 控制相机在竖直平面(x 轴)内的旋转。负值表示向下旋转,正值表示向上旋转。 范围:`-10` 到 `10` - 控制相机的横滚量(z 轴)。负值表示逆时针,正值表示顺时针。 + 控制相机的滚转数量(z 轴)。负值表示逆时针,正值表示顺时针。 范围:`-10` 到 `10` - 控制相机在水平平面内的旋转(y 轴)。负值表示向左旋转,正值表示向右旋转。 + 控制相机在水平平面(y 轴)内的旋转。负值表示向左旋转,正值表示向右旋转。 范围:`-10` 到 `10` @@ -231,9 +229,9 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 预设的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。 + 预定义的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上仰拍。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。 - 可选值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` + 可能的值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` @@ -245,23 +243,23 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 视频时长,单位为秒 + 视频时长(秒) - 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 可能的值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - 自定义任务 ID。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 自定义任务 ID。已忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 - 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长、质量更高的视频。 + 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成的视频时长更长,但输出质量更高。 - 可选值:`std`、`pro` + 可能的值:`std`、`pro` - 模型名。使用 Comfy Router 时可省略或传 null,模型由请求路径决定。如果提供名称,必须与该路径一致。 + 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。 @@ -269,47 +267,47 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 该分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 - 镜头序号 + 分镜序号 - 该分镜的提示词。最大长度 512 个字符。 + 该分镜的提示词。最大长度为 512 个字符。 - 是否生成多镜头视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。 + 是否生成多分镜视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。 - 负面文本提示词。建议直接在正向提示词中通过否定句来补充负面提示信息。 + 负面文本提示词。推荐直接在正面提示词中通过否定句补充负面提示词信息。 - 正向文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序相匹配的声音。一个任务最多可引用 2 种音色。指定音色时,sound 参数的值必须为 on。 + 正面文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。 - 分镜方式。当 multi_shot 参数设置为 true 时必填。 + 分镜方法。当 multi_shot 参数设置为 true 时必填。 - 可选值:`customize`、`intelligence` + 可能的值:`customize`、`intelligence` - 生成视频时是否同时生成声音。仅 V2.6 及之后版本的模型支持该参数。 + 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持此参数。 - 可选值:`on`、`off` + 可能的值:`on`、`off` - 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用。需要将 `sound` 设为 "on",且仅 V2.6 及之后版本的模型支持;在更早的模型上,或 `sound` 保持默认值 "off" 时,音色不会生效。 + 生成视频时引用的声音列表。最多支持 2 个声音;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用它们。需要将 `sound` 设置为 "on",仅 V2.6 及后续版本的模型支持此参数;在更早的模型上,或将 `sound` 保留为默认值 "off" 时,声音不会生效。 - 通过音色定制 API 返回的音色 ID,或系统预置音色 ID。 + 通过声音自定义 API 返回的声音 ID,或系统预设声音 ID。 @@ -317,15 +315,23 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - true 表示生成水印,false 表示不生成。 + true 表示生成水印,false 表示不生成水印。 + + + + 参考图像:URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,比例介于 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 + + + + 参考图像:结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或 camera_control 同时使用。 -由 Router 在 `GET /v2/models/kling/kling-v3/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +本文档根据 Router 在 `GET /v2/models/kling/kling-v3/openapi.json` 提供的 schema 生成,该 schema 正是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 错误码 + 错误代码 @@ -333,7 +339,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 任务创建时间,Unix 时间戳(毫秒) + 任务创建时间,Unix 时间戳,单位为毫秒 @@ -361,7 +367,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 视频总时长(秒) + 视频总时长,单位为秒 @@ -375,7 +381,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 带水印的已生成视频 URL,防盗链格式 + 已生成视频的带水印 URL,防盗链格式 格式:`uri` @@ -391,7 +397,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 任务更新时间,Unix 时间戳(毫秒) + 任务更新时间,Unix 时间戳,单位为毫秒 diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index 071ac130ad..0070ff01a0 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -2,18 +2,19 @@ title: "通过 Comfy Router 使用 HappyHorse 1.0 I2V" description: "通过 Comfy Router 以 HTTP 调用 wan/happyhorse-1.0-i2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果形状" sidebarTitle: "HappyHorse 1.0 I2V" -translationSourceHash: fd06ba6e +translationSourceHash: da380385 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx translationBlockHashes: "_intro": 7d98975f "Quick start": c7e0bda8 - "Schema": 8445191f + "Schema": 229263d1 "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -214,110 +215,53 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-i2v/requests/$REQUEST_ID - 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 -wan2.6-i2v 模型必填。happyhorse-1.x i2v 系列拼写方式不在此处接收首帧: -它们将首帧作为类型为 first_frame 的媒体元素传入(见下方 media),而在 -wan2.6-i2v 上能成功通过的 img_url 请求体,在 happyhorse-1.0-i2v 和 -happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 系列拼写方式同样在 -media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 -分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 拼写不在此处接收首帧:它们将首帧作为类型为 first_frame 的 media 元素接收(见下方 media),而在 wan2.6-i2v 上能成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 的拼写同样在 media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大值 10MB。 - 媒体资产列表。为视频生成指定参考素材(图像、音频、视频)。 -每个元素包含一个 type 字段和一个 url 字段。本组件提供的所有模型都共享该字段, -而某个模型接受哪些 type 值,以及它是否把图像或视频输入放在这里而不是放在 -img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type 值如下: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 - 到 8:1 之间,最大 20MB,公开网址或 data:\{MIME_type};base64,... 网址。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS 网址;不接受内联 - data: 网址。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要提供一个 reference_image 或 reference_video,且参考图像加 - 参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 - 20MB,公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开的 - HTTP/HTTPS 网址;不接受内联 data: 网址。 -- wan2.7-videoedit:video(正好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: - 网址)加上可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开网址 - 或 data:\{MIME_type};base64,... 网址)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link - 共用)、link(最多 1 个,不能与 file 共用)。reference_*/file/link 类型 - 与 first_frame/last_frame 类型在同一请求中互斥。数组 - 顺序决定提示中资产的参考顺序(Image 1、Video 1、 - Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公开网址或 - data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link: - 公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,正好 1 个。这些拼写方式 - 在此处接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开网址或 - data:\{MIME_type};base64,... 网址。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 - 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,公开网址或 data:\{MIME_type};base64,... 网址。reference_video - 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(正好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,长边最大 4096 像素,短边至少 360 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: - 网址)加上可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公开网址 - 或 data:\{MIME_type};base64,... 网址)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其对应的合作伙伴参考文档未记录任何 media 输入,因此请将此字段 - 保持未设置。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些拼写方式列举任何 - media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收 - 首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上文中各模型的数量是合作伙伴的约束,而不是本 schema 的约束:media 上未 -声明 minItems/maxItems,因为各模型允许的类型及其上限各不相同。schema -校验通过并不意味着提供商会接受;反过来说,上文中每项资产的“最大 20MB”数值, -即图像输入(唯一可以内联发送的输入)的上限,是合作伙伴对其最终接收 -资产的上限,当资产是公开网址时,这些数值按字面适用, -因为这些字节从不经过 Comfy 传输。内联的 data:\{MIME_type};base64,... -网址确实会经过 Comfy 传输,因此也要受传输层上限约束:一个 Comfy Router -的 POST 请求体总量上限为 100 MiB,超过则返回 413,而 base64 会使载荷膨胀约 -4/3,因此单个内联资产超过约 75 MB 时,在触及此处任何合作伙伴规则之前就会 -被拒绝。在该大小下,单个资产在合作伙伴自身的20MB 的上限让内联数据可以轻松通过,因此对于单个资产来说,真正起约束作用的是合作伙伴规则;而这一传输上限会同时约束多个资产,因为 100 MiB 的 Router 上限限制的是整个请求,而不是其中每个元素。凡是接近这些上限的内容,都应改用公共 URL 发送。 + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。该字段由此组件提供的所有模型共用,而某个模型接受哪些 type 值,以及它到底是在此处还是在 img_url 或 reference_video_urls 中携带图像或视频输入,都因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):必须是公开的 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,且参考图像加参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开的 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 同时使用)、link(最多 1 个,不能与 file 同时使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求内互斥。数组顺序定义了提示词中资产的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公开的 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写在此处接收首帧,而不是在 img_url 中接收。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是该操作支持的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其对应的参考文档未记载 media 输入,因此请勿设置此字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些拼写列举任何 media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 +上述各模型的数量是合作伙伴的约束,而非本 schema 的约束:media 上没有声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 层面的通过并不意味着提供商会接受;反过来说,上文每个资产“最大 20MB”的数字(图像输入的上限,而图像是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产所设的上限,当资产是公开 URL 时按字面适用,因为这些字节从不经过 Comfy 传输。内联的 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,因此还会遇到一道传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个内联资产超过约 75 MB 就会在触达此处任何合作伙伴规则之前被拒绝。在这样的尺寸下,单个资产按合作伙伴自身的20MB 上限足以轻松容纳内联内容,因此对于单个资产,起约束作用的是合作伙伴规则:传输上限会在涉及多个资产时起约束作用,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。接近这些上限的任何内容都请以公共 URL 发送。 媒体资产类型 - 可选值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者(仅针对上面的 `media` 描述为各模型列出的那些 IMAGE 输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image)一个内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不对外暴露任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。本字段不校验 URL 协议,因此这类值会原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的大小和像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:公共 HTTP/HTTPS URL,或者,对于上文 `media` 描述中针对各模型列出的那些 IMAGE 输入(wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image),则可以是内联 `data:{MIME_type};base64,...` URL。这些模型中的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能在上传它的阿里云账号下解析;Comfy 使用自己的密钥发起模型调用,并且不提供上传路由,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL 方案,因此此类值会按原样转发给合作伙伴,而不是在这里被拒绝。有关各模型的大小和像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中看到的内容 + 反向提示词用于描述您不想在视频画面中看到的内容。超过 500 个字符后,wan 模型会将其截断,而不是拒绝它。它会计入与 prompt 相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 在路边唱歌,Character2 在旁边跳舞" -对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等来指代 media 数组中对应顺序的媒体资产。 + 文本提示词。支持中文和英文。超过其自身文档所述长度后,wan2.x 模型会截断提示词,而不是拒绝它:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。提供商会拒绝 prompt 和 negative_prompt 合计超过约 60,850 字节 UTF-8 文本(约 20,000 个中文字符)的请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于包含多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等按参考视频的顺序指代主体。示例:“Character1 sings on the roadside, Character2 dances beside it” +对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等按 media 数组中的对应顺序指代媒体资产。 - 仅适用于 wan2.6-r2v 模型的参考视频 URL。包含 1-3 个视频 URL 的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1 至 3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov -- 数量:1-3 个视频 -- 单个视频时长:2-30 秒 +- 数量:1 至 3 个视频 +- 单个视频长度:2 至 30 秒 - 单个文件大小:最大 30MB -- 不能与 audio_url 同时使用 -参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例更短。 -计费:按实际使用的参考时长计算。 +- 不能与 audio_url 一起使用 +参考时长:单个视频最大 5s,两个视频各最大 2.5s,三个视频则按比例缩短。 +计费:基于实际使用的参考时长。 @@ -325,7 +269,7 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - 要调用的模型 ID。本组件不对其加以约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它,因此 Router 调用方会省略该字段。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供它,可接受的拼写枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供它,可接受的拼写枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -333,26 +277,27 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记载此类切换。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未记录其他 wan 模型具有此类切换。 wan2.7-videoedit 模型的视频音频设置。 -- auto(默认):模型根据提示词内容智能判断 -- origin:强制保留输入视频的原始音频 +- auto(默认):模型根据 prompt 内容智能判断 +- origin:强制保留输入视频中的原始音频 - 可选值:`auto`、`origin` + 可能的值:`auto`、`origin` - 已生成视频的时长,单位为秒: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 之间的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 之间的整数 -- wan3.0-video:无视频输入时为 [2, 30] 之间的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 会启用智能时长模式,由模型选择合适的时长 -本代理对超出 [-1, 30] 的时长返回 400。 +- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) +- wan2.7-i2v、wan2.7-t2v:[2, 15] 内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 内的整数;有视频输入时,输入视频时长 + 输出视频时长 + 总计不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +此代理对超出 [-1, 30] 的时长返回 400。 范围:`-1` 到 `30` @@ -362,30 +307,30 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - 已生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,如果未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,若未提供,则会根据分辨率档位取默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的宽高比根据输入媒体的比例和意图确定。 - 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 可能的值:`adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 分辨率档位。支持的值因模型而异: -- wan2.5-i2v-preview:480P、720P、1080P -- wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) -- wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P -- happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P -该代理会拒绝既未提供分辨率也未提供尺寸的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将分辨率转为大写,并转发大写后的值;对超出该枚举范围的值返回 400;对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,针对 480P 也会返回 400(无论是以分辨率还是以 480P 尺寸的形式发送)。 - - Possible values: `480P`, `720P`, `1080P` + 分辨率级别。支持的值因模型而异: +- wan2.5-i2v-preview: 480P、720P、1080P +- wan2.6 模型(t2v、i2v、r2v): 仅 720P、1080P(不支持 480P) +- wan2.7 模型(i2v、t2v、r2v、videoedit): 720P、1080P(默认 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P +此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查前将 resolution 转为大写并转发大写后的值,对不在此枚举中的值返回 400,并且对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,对 480P(无论以 resolution 还是 480P 的 size 形式发送)返回 400。 + + 可能的值:`480P`, `720P`, `1080P` 随机数种子,用于控制模型生成内容的随机性 - Range: `0` to `2147483647` + 范围:`0` 到 `2147483647` @@ -394,23 +339,23 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - single: 单镜头视频(默认) - multi: 多镜头视频 - Possible values: `multi`, `single` + 可能的值:`multi`, `single` 视频分辨率,格式为 width*height。支持的分辨率因模型而异: 对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(不支持 480P): - 720P:1280*720、720*1280、960*960、1088*832、832*1088 - 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时传入尺寸和分辨率时,由尺寸决定计费档位,而分辨率仍必须是该代理为该模型接受的值。对于分辨率描述中列为不支持 480P 的每个模型,传入 480P 尺寸都会返回 400。 +对于 wan2.6 T2V/R2V(无 480P): + 720P: 1280*720、720*1280、960*960、1088*832、832*1088 + 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +当同时发送 size 和 resolution 时,size 决定计费档位,而 resolution 仍必须是此代理为该模型接受的值。对于 resolution 描述中列为不支持 480P 的每个模型,480P 的 size 都会返回 400。 是否添加水印 logo,水印位于右下角 -本文档根据 Router 在 `GET /v2/models/wan/happyhorse-1.0-i2v/openapi.json` 提供的 schema 生成,Router 在请求到达提供商之前会用这份文档校验调用。 +根据 Router 在 `GET /v2/models/wan/happyhorse-1.0-i2v/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一文档。 ### 输出 @@ -419,7 +364,7 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - 智能改写后的实际提示词(适用于视频任务) + 智能改写后的实际提示词(视频任务) @@ -439,15 +384,15 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - 原始输入提示词(适用于视频任务) + 原始输入提示词(视频任务) - 图像生成任务的结果列表 + 图像生成任务的任务结果列表 - 智能改写后的实际提示词(如已启用) + 智能改写后的实际提示词(若启用) @@ -479,15 +424,15 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - 图像生成任务的结果统计 + 图像生成任务的任务结果统计 - 失败任务数量 + 失败任务数 - 成功任务数量 + 成功任务数 @@ -501,7 +446,7 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 + 已完成的视频生成任务的视频 URL。链接有效期 24 小时 @@ -557,11 +502,11 @@ img_url 或 reference_video_urls 中,因模型而异。各模型支持的 type - 失败请求的错误码,报告在响应的 ROOT 层级而非 `output` 下(请求成功时不返回)。 + 失败请求的错误码,报告在信封的根层级而非 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,报告在响应的 ROOT 层级而非 `output` 下(请求成功时不返回)。在回退读取 `output.message` 之前请先查看此项。 + 失败请求的详细信息,报告在信封的根层级而非 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前先读取此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index 44440322aa..d09f10db3d 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -2,18 +2,19 @@ title: "使用 HappyHorse 1.0 R2V 搭配 Comfy Router" description: "通过 Comfy Router 以 HTTP 调用 wan/happyhorse-1.0-r2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段与结果形状" sidebarTitle: "HappyHorse 1.0 R2V" -translationSourceHash: d2eee702 +translationSourceHash: 93ba1a2d translationFrom: development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx translationBlockHashes: "_intro": 39853fc0 "Quick start": eafea158 - "Schema": 5a777640 + "Schema": 3deb0e2f "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -214,80 +215,24 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v/requests/$REQUEST_ID - 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 -wan2.6-i2v 模型必填。happyhorse-1.x i2v 的写法不在此处接收首帧: -它们将其作为类型为 first_frame 的媒体元素接收(见下方 media),而在 -wan2.6-i2v 上能成功的 img_url 请求体,会被提供商在 -happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 的写法同样在 -media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 -分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 写法不在此处接收首帧:它们将首帧作为类型为 first_frame 的媒体元素传入(见下方 media);在 wan2.6-i2v 上能成功的 img_url 请求体会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 的写法也在 media 中传入参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。 -每个元素包含 type 和 url 字段。此字段由此组件提供的每个 -模型共享,而某个模型接受哪些 type 值(以及它是否在此处而非 -img_url 或 reference_video_urls 中携带其图像或视频输入)因模型而异。各模型 -支持的 type 值: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 - 到 8:1 之间,最大 20MB,公共网址或 data:\{MIME_type};base64,... 网址。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公共 HTTP/HTTPS 网址;内联 - data: 网址不被接受。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要一个 reference_image 或 reference_video,并且参考图像加 - 参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (不含透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 - 20MB,公共网址或 data:\{MIME_type};base64,... 网址。reference_video:公共 - HTTP/HTTPS 网址;内联 data: 网址不被接受。 -- wan2.7-videoedit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公共 HTTP/HTTPS 网址;内联 data: 网址 - 不被接受),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共网址 - 或 data:\{MIME_type};base64,... 网址)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能 - 与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型 - 与 first_frame/last_frame 类型在同一请求中互斥。数组 - 顺序定义提示词中资产的参考顺序(Image 1、Video 1、 - Audio 1、...)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比最多 8:1,最大 20MB,公共网址或 - data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link:公共 - HTTP/HTTPS 网址;内联 data: 网址不被接受。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法 - 在此处而非 img_url 中接收其首帧。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公共网址或 - data:\{MIME_type};base64,... 网址。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 - 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,公共网址或 data:\{MIME_type};base64,... 网址。reference_video - 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,3-60 - 秒,较长边最多 4096 像素,较短边至少 360 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS 网址;内联 data: - 网址不被接受),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共网址 - 或 data:\{MIME_type};base64,... 网址)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。它们的合作伙伴参考文档未记录任何 media 输入,因此请保持 - 此字段未设置。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些写法列举任何 media - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧; - wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上述按模型列出的数量是合作伙伴的约束,而不是此 schema 的约束:media 上 -未声明任何 minItems/maxItems,因为可接受的类型及其上限 -因模型而异。Schema 接受并不意味着提供商接受;反过来说, -上述每项资产“最大 20MB”的数值(图像输入的上限,也是唯一 -可以内联发送的输入)是合作伙伴对其最终获得的资产所设的上限, -当资产是公共网址时它们按原文适用,因为这些字节从不经过 Comfy 传输。 -内联的 data:\{MIME_type};base64,... 网址确实会经过 Comfy 传输,并且同样会遇到传输上限: -Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, -而 base64 会使负载膨胀约 4/3,因此单个内联资产超过约 75 MB 时, -会在触及此处任何合作伙伴规则之前就被拒绝。在该大小下,单个资产按合作伙伴自身的20MB 的上限可以轻松容纳内联数据,因此对于单个资产而言,真正起约束作用的是合作伙伴规则;而涉及多个资产时则受传输上限约束,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。接近这些上限的任何内容都应以公共 URL 的形式发送。 + 媒体资产列表。指定用于视频生成的参考资料(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由该组件提供的所有模型共享,而给定模型接受哪些 type 值(以及它是否完全在此处携带图像或视频输入,而不是在 img_url 或 reference_video_urls 中携带)因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共网址或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公共 HTTP/HTTPS 网址;不接受内联 data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,且参考图像与参考视频合计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共网址或 data:\{MIME_type};base64,... URL。reference_video:公共 HTTP/HTTPS 网址;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公共 HTTP/HTTPS 网址;不接受内联 data: URL)加上可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共网址或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 段,总时长 \<= 15 秒)、reference_audio(最多 5 段,总时长 \<= 15 秒)、file(最多 1 个,不能与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定提示词中资产的参考顺序(图像 1、视频 1、音频 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公共网址或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公共 HTTP/HTTPS 网址;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法在此处接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公共网址或 data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,数量为 1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,公共网址或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS 网址;不接受内联 data: URL)加上可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共网址或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记录任何媒体输入,因此请不要设置此字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:该组件未为这些写法枚举媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧;wan2.6-r2v 在 reference_video_urls 中接收参考片段。 +上文中按模型给出的数量是合作伙伴的限制,而不是此 schema 的限制:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不代表提供商会接受;反过来,上文中按资产给出的“最大 20MB”数值(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终获得的资产所设的上限;当资产是公共网址时,这些数值按原样适用,因为这些字节从不经过 Comfy。内联 data: URL 确实会经过 Comfy,并且也会遇到传输上限:Comfy Router POST 请求体总计限制为 100 MiB,超过后返回 413;base64 会使负载膨胀约 4/3,因此单个内联资产超过约 75 MB 时,会在触及这里的任何合作伙伴规则之前被拒绝。在这一大小下,单个资产按合作伙伴自身的…… +20MB 的上限可以轻松容纳内联内容,因此对单个资产而言,真正起约束作用的是合作伙伴规则;而对多个资产来说,起约束作用的是传输上限,因为 100 MiB 的 Router 上限限制的是整个请求,并非每个元素。任何接近这些上限的内容,请以公开 URL 形式发送。 媒体资产类型 @@ -295,39 +240,36 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 媒体文件的 URL:可以是公共 HTTP/HTTPS URL,或者(仅限上文 `media` 描述中为各模型列出的那些 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)可以是内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它们的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,且不对外暴露任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。此字段不会校验 URL scheme,因此这类值会被原样转发给合作伙伴,而不会在这里被拒绝。各模型的尺寸与像素限制,以及从整体上约束内联载荷的 100 MiB Router 请求体上限,请参阅 `media` 描述。 + 媒体文件的 URL:一个公开的 HTTP/HTTPS URL,或者,仅针对上文中 `media` 描述为各模型列出的 IMAGE 类输入(wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image),可以使用内联的 `data:{MIME_type};base64,...` URL。这些模型上任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自带上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅在发起上传的同一阿里云账号下才能解析;Comfy 使用自己的密钥发起模型调用,并且不提供上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此这类值会原样转发给合作伙伴,而不会在这里被拒绝。各模型的大小与像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中出现的内容 + 反向提示词用于描述你不希望在视频画面中出现的内容。超过 500 个字符时,wan 模型会将其截断,而不是拒绝该请求。它与 prompt 计入同一输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多可达 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。 -示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等按 media 数组中对应的顺序来指代媒体资产。 + 文本提示词。支持中文和英文。超过各自文档记载的长度时,wan2.x 模型会截断提示词,而不是拒绝该请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。当 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符)时,提供商会拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。对于带多个参考视频的 wan2.6-r2v,按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:“Character1 sings on the roadside, Character2 dances beside it” + 对于 wan3.0-video 的参考模式,按 media 数组中的对应顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 - 仅适用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + wan2.6-r2v 模型的参考视频 URL。1-3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 - 单个视频时长:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 同时使用 -参考时长:单个视频最长 5 秒,两个视频每个最长 2.5 秒,三个视频则按比例更短。 +参考时长:单个视频最长 5s,两个视频各最长 2.5s,三个视频按比例更短。 计费:按实际使用的参考时长计算。 - 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 - 要调用的模型 ID。在本组件上不作约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填入该值,因此 Router 调用方可以省略它。直接以 v1 调用 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 时必须提供该值,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接以 v1 调用 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 时必须提供它,可接受拼写的枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -335,84 +277,84 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记录此类开关。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记录此类切换。 wan2.7-videoedit 模型的视频音频设置。 -- auto(默认):模型根据提示词内容智能判断 -- origin:强制保留输入视频中的原始音频 +- auto(默认):模型根据 prompt 内容智能判断 +- origin:强制保留输入视频的原始音频 可能的值:`auto`、`origin` - 所生成视频的时长,单位为秒: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频时长 + 输出视频时长的总和不得超过 30 秒;-1 启用智能时长模式,模型会自行选择合适的时长 -此代理对超出 [-1, 30] 范围的时长返回 400。 +- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) +- wan2.7-i2v、wan2.7-t2v:[2, 15] 区间内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 区间内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 区间内的整数;有视频输入时,输入视频总时长与输出视频总时长之和不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +此代理对超出 [-1, 30] 的时长返回 400。 - 范围:`-1` 到 `30` + 取值范围:`-1` 至 `30` - 是否启用提示词智能改写。默认值为 true + 是否启用提示词智能改写。默认为 true - 所生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,如果未提供该值,则根据分辨率档位设置默认值。 -对于 wan3.0-video,adaptive(默认)会根据输入媒体的比例和意图自动推荐合适的宽高比。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,若未提供,则根据分辨率档位给出默认值。 +对于 wan3.0-video,adaptive(默认)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` - 分辨率档位。支持的值因模型而异: -- wan2.5-i2v-preview:480P、720P、1080P -- wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) -- wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上游默认 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P, 1080P -- happyhorse-1.1-*(t2v、i2v、r2v): 480P, 720P, 1080P - -该代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将 resolution 转换为大写,并转发大写后的值;对于不在此枚举范围内的值返回 400;对于上方列出、说明不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,无论是以 resolution 还是以 480P 的 size 形式发送,均返回 400。 - - 可选值:`480P`、`720P`、`1080P` + 分辨率档位。支持的取值因模型而异: +- wan2.5-i2v-preview: 480P、720P、1080P +- wan2.6 模型(t2v、i2v、r2v): 仅 720P、1080P(不支持 480P) +- wan2.7 模型(i2v、t2v、r2v、videoedit): 720P、1080P(默认 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定了计费费率。它在检查之前会先将 resolution 转为大写,并转发转为大写后的值;对于超出此枚举范围的取值返回 400;对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,对 480P(无论以 resolution 还是以 480P 尺寸的形式发送)返回 400。 + + 可能的值:`480P`、`720P`、`1080P` - 随机数种子,用于控制模型所生成内容的随机性 + 随机数种子,用于控制模型生成内容的随机性 范围:`0` 到 `2147483647` - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 -- single: 单镜头视频(默认) -- multi: 多镜头视频 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 +- single:单镜头视频(默认) +- multi:多镜头视频 - 可选值:`multi`、`single` + 可能的值:`multi`、`single` 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: 对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(不支持 480P): +对于 wan2.6 T2V/R2V(无 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是该代理为此模型接受的值。在 resolution 描述中列为不支持 480P 的每个模型上,480P 的 size 都会返回 400。 +当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是本代理针对该模型接受的取值。对于分辨率描述中列为不支持 480P 的每个模型,480P 尺寸都会返回 400。 - 是否添加水印标志,水印位于右下角 + 是否添加水印标识,水印位于右下角 -根据 Router 在 `GET /v2/models/wan/happyhorse-1.0-r2v/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档是同一份。 +由 Router 在 `GET /v2/models/wan/happyhorse-1.0-r2v/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -425,11 +367,11 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 带音频生成的 I2V 任务的音频 URL + 带音频生成的 I2V 任务所用的音频网址 - 失败请求的错误代码(请求成功时不返回) + 失败请求的错误码(请求成功时不返回) @@ -445,7 +387,7 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 图像生成任务的结果列表 + 图像生成任务的任务结果列表 @@ -453,7 +395,7 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 图像错误代码(部分任务失败时返回) + 图像错误码(部分任务失败时返回) @@ -465,7 +407,7 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 已生成图像的图片网址 + 已生成图像的网址 @@ -481,7 +423,7 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 图像生成任务的结果统计 + 图像生成任务的任务结果统计 @@ -499,11 +441,11 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, 任务状态 - 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频 URL。链接有效期 24 小时 + 已完成的视频生成任务的视频网址。链接有效期为 24 小时 @@ -515,15 +457,15 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 视频分辨率等级(I2V 和 wan3.0-video 任务) + 视频分辨率级别(I2V 和 wan3.0-video 任务) - 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) + 生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) - 已生成视频的帧率(wan3.0-video 任务) + 生成视频的帧率(wan3.0-video 任务) @@ -551,7 +493,7 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 已生成视频的时长,单位为秒(T2V 任务) + 生成视频的时长,单位为秒(T2V 任务) @@ -559,11 +501,11 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, - 失败请求的错误代码,报告在响应信封的根层级,而不是 `output` 下(请求成功时不返回)。 + 失败请求的错误码,在响应封装的根级报告,而不是在 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,报告在响应信封的根层级,而不是 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此项。 + 失败请求的详细信息,在响应封装的根级报告,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此信息。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index 6bfe411688..ab744664bd 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -2,18 +2,19 @@ title: "将 HappyHorse 1.1 I2V 与 Comfy Router 配合使用" description: "通过 Comfy Router 以 HTTP 方式调用 wan/happyhorse-1.1-i2v 的 Python、TypeScript 与 cURL 代码片段,以及请求字段和结果形状" sidebarTitle: "HappyHorse 1.1 I2V" -translationSourceHash: ee562b54 +translationSourceHash: 8d29660e translationFrom: development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx translationBlockHashes: "_intro": 2419a89f "Quick start": c705001d - "Schema": 54511f6f + "Schema": bb6bb958 "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -210,81 +211,28 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v/requests/$REQUEST_ID - 音频文件下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 - 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 -wan2.6-i2v 模型必填。happyhorse-1.x i2v 写法不在此处接收首帧: -它们将首帧作为类型为 first_frame 的 media 元素传入(见下文 media),并且在 -wan2.6-i2v 上能成功的 img_url 请求体,会被提供商在 -happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;而 wan2.7/wan3.0 写法同样在 -media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 -分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图片网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x i2v 写法不在此处接收首帧:它们把首帧作为类型为 first_frame 的 media 元素传入(见下方 media);而且,在 wan2.6-i2v 上能够成功的 img_url 请求体,会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 写法同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 -type 和 url 字段。此字段由该组件提供的所有模型共用,而某个模型接受哪些 -type 值,以及它是否在此处而不是在 img_url 或 reference_video_urls 中传入其图像或 -视频输入,因模型而异。各模型支持的 type 值如下: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 - 8:1 之间,最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS 网址;不接受内联 - data: 网址。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要一个 reference_image 或 reference_video,且参考图像加 - 参考视频合计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 - 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开的 - HTTP/HTTPS 网址;不接受内联 data: 网址。 -- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: - 网址),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可使用公开网址 - 或 data:\{MIME_type};base64,... 网址)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 - link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型 - 与 first_frame/last_frame 类型在同一请求中互斥。数组顺序定义了提示词中资产的 - 引用顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image: - JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB, - 可使用公开网址或 data:\{MIME_type};base64,... 网址。reference_video、reference_audio、 - file 和 link:公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法 - 在此处传入首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可使用公开网址或 - data:\{MIME_type};base64,... 网址。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 - 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址。reference_video - 不是该操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,较长边最大 4096 像素,较短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 - 之间,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址), - 外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可使用公开网址 - 或 data:\{MIME_type};base64,... 网址)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其合作伙伴参考文档未记录任何 media 输入,因此请 - 保持此字段未设置。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些写法列举任何 - media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入其 - 首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 -上文各模型的计数是合作伙伴的约束,而不是本 schema 的约束:media 上未声明任何 -minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不意味着 -提供商接受;反过来说,上文每项资产“最大 20MB”的数值(这是对图像 -输入的上限,也是唯一可以内联发送的输入)是合作伙伴对其最终接收到的资产 -设定的上限,当资产是公开网址时,这些数值按字面适用,因为这些字节从不 -经过 Comfy 传输。内联的 data:\{MIME_type};base64,... 网址确实会经过 Comfy 并同样 -受到传输上限的约束:一个 Comfy Router POST 请求体总计上限为 100 MiB,超过则 -返回 413,而 base64 会使载荷膨胀约 4/3,因此单个超过约 75 MB 的内联资产 -会在触达这里任何合作伙伴规则之前就被拒绝。在这种大小下,单个资产按合作伙伴自身的20MB 的上限内联传输完全没有问题,因此对单个资产而言真正起约束作用的是合作伙伴规则;而对多个资产而言起约束作用的则是传输层上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中每个元素。接近这些上限的任何内容都请以公共 URL 的形式发送。 + 媒体资产列表。用于指定视频生成所需的参考素材(图像、音频、视频)。每个元素包含 type 字段和 url 字段。该字段由此组件所服务的每个模型共用,而某个模型接受哪些 type 值,以及它究竟是在这里携带图像或视频输入、还是在 img_url 或 reference_video_urls 中携带,都因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要 1 个 reference_image 或 reference_video,且参考图像加参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- wan2.7-videoedit:video(必须为 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 同时使用)、link(最多 1 个,不能与 file 同时使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定资产在提示词中的引用顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link:公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,且必须为 1 个。这些写法在此处传入首帧,而不是在 img_url 中传入。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,数量为 1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video 不是此操作的输入类型。 +- happyhorse-1.0-video-edit:video(必须为 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。它们的合作伙伴参考文档未记载任何 media 输入,因此请勿设置该字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件没有为这些写法枚举任何 media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 +上述各模型的数量是合作伙伴的约束,而不是本 Schema 的约束:media 上没有声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受;反过来说,上文每个资产“最大 20MB”的数值(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终拿到的资产所设的上限,当资产是公开网址时,这些限制按原文生效,因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... 网址确实会经过 Comfy,并且还要受到传输层上限的约束:Comfy Router 的 POST 请求体总量上限为 100 MiB,超过即返回 413,而 base64 会使负载膨胀约 4/3,因此单个内联资产若超过约 75 MB,会在触达此处任何合作伙伴规则之前就被拒绝。在这种大小下,单个资产按合作伙伴自己的 +20MB 上限对于内联载荷而言绰绰有余,因此对于单个资产,真正起作用的是合作伙伴的规则;而当资产有多个时,起作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。接近这些上限的任何内容,都请以公共 URL 发送。 媒体资产类型 @@ -292,39 +240,37 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 媒体文件的 URL:可以是公共 HTTP/HTTPS URL;或者,对于上方 `media` 描述为各模型逐一列出的图像输入(仅限于这些输入):wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image;也可以是内联的 `data:{MIME_type};base64,...` URL。这些模型上没有任何视频、音频、文件或链接输入接受内联 data: URL。来自合作伙伴自身上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的阿里云账号解析生效;Comfy 使用自己的密钥发起模型调用,且不提供任何上传路由,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此这类值会被原样转发给合作伙伴,而不会在此处被拒绝。各模型的大小与像素限制,以及从整体上约束内联负载的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:可以是公共 HTTP/HTTPS URL,或者,内联的 `data:{MIME_type};base64,...` URL。后者仅适用于上文的 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)资产中心的 asset_id,仅能对上传它的阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不提供任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。该字段不校验 URL 的协议方案,因此这类值会原样转发给合作伙伴,而不会在这里被拒绝。关于各模型的大小与像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中出现的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符后,Wan 模型会将其截断,而不是直接拒绝。它与 prompt 计入相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,请按照参考视频的顺序使用 'character1'、'character2' 等来指代主体。 -示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,按照 media 数组中对应的顺序来指代媒体资产。 + 文本提示词。支持中文和英文。超过其自身文档记载的长度后,wan2.x 模型会截断提示词,而不是直接拒绝:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。若 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符),提供商将拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等按参考视频的顺序指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等按媒体数组中的对应顺序指代媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。1-3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 - 单个视频时长:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 同时使用 -参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例更短。 -计费:按实际使用的参考时长计费。 +参考时长:单个视频最长 5s,两个视频各最长 2.5s,三个视频则按比例更短。 +计费:按实际使用的参考时长计算。 - 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。此组件不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充该值,因此 Router 调用方会省略它。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供,可接受拼写的枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填入该值,因此 Router 调用方会省略它。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时必须提供它,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 @@ -332,12 +278,12 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未记载其他 wan 模型有此切换。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型提供此类开关的文档说明。 wan2.7-videoedit 模型的视频音频设置。 -- auto(默认):模型根据提示词内容智能判断 +- auto(默认):模型根据 prompt 内容智能判断 - origin:强制保留输入视频的原始音频 可能的值:`auto`、`origin` @@ -347,11 +293,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) +- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) - wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 - wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频总时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -此代理对超出 [-1, 30] 的时长返回 400。 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频时长 + 输出视频时长合计不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +此代理对超出 [-1, 30] 的 duration 返回 400。 范围:`-1` 到 `30` @@ -361,11 +307,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 生成视频的画面比例。仅适用于 wan2.7 和 wan3.0 模型。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的画面比例。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的宽高比,根据输入媒体的比例和意图确定。 - 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -373,15 +319,12 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - wan2.5-i2v-preview:480P、720P、1080P - wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上游默认 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -此代理会拒绝既未提供分辨率也未提供尺寸的视频生成请求,因为分辨率档位决定计费费率。 -它会在检查之前将分辨率转换为大写并转发转换后的值,对于不在此枚举范围内的值返回 400, -对于上方列出为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,返回 400 -(无论是以分辨率还是以 480P 尺寸发送)。 - - 可选值:`480P`, `720P`, `1080P` +- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它在检查之前会先把 resolution 转换为大写并转发该大写值,对于超出此枚举的值返回 400,对于上文列出的不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,返回 400 表示不接受 480P(无论是以 resolution 还是以 480P 的 size 形式发送)。 + + 可选值:`480P`、`720P`、`1080P` @@ -393,27 +336,26 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 智能多镜头控制。仅在启用 prompt_extend 时生效。 适用于 wan2.6 和 wan2.7-r2v 模型。 -- single: 单镜头视频(默认) -- multi: 多镜头视频 +- single:单镜头视频(默认) +- multi:多镜头视频 - 可选值:`multi`, `single` + 可选值:`multi`、`single` - 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: -对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(不支持 480P): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -当同时发送尺寸和分辨率时,尺寸决定计费档位,而分辨率仍必须是此代理为该模型接受的值。 -对于分辨率说明中列出为不支持 480P 的每个模型,480P 尺寸都会返回 400。 + 视频分辨率,格式为 width*height。支持的分辨率因模型而异: +wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +wan2.6 T2V/R2V(不支持 480P): + 720P:1280*720、720*1280、960*960、1088*832、832*1088 + 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +当同时发送 size 和 resolution 时,size 决定计费档位,而 resolution 仍必须是本代理对该模型接受的值。对于分辨率说明中列为不支持 480P 的每个模型,480P 的 size 都会返回 400。 - 是否添加水印标志,水印位于右下角 + 是否添加水印 logo,水印位于右下角 -根据 Router 在 `GET /v2/models/wan/happyhorse-1.1-i2v/openapi.json` 提供的 schema 生成,请求在到达提供商之前,也会依据同一文档进行校验。 +本页内容生成自 Router 在 `GET /v2/models/wan/happyhorse-1.1-i2v/openapi.json` 提供的 schema,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -422,15 +364,15 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 智能改写后的实际提示词(适用于视频任务) + 智能改写后的实际提示词(视频任务) - 带音频生成的 I2V 任务的音频网址 + 带音频生成的 I2V 任务的音频 URL - 失败请求的错误代码(请求成功时不会返回) + 失败请求的错误码(请求成功时不返回) @@ -438,23 +380,23 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 失败请求的详细信息(请求成功时不会返回) + 失败请求的详细信息(请求成功时不返回) - 原始输入提示词(适用于视频任务) + 原始输入提示词(视频任务) - 图像生成任务的结果列表 + 图像生成任务的任务结果列表 - 智能改写后的实际提示词(如已启用) + 智能改写后的实际提示词(若已启用) - 图像错误代码(部分任务失败时返回) + 图像错误码(部分任务失败时返回) @@ -466,7 +408,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 已生成图像的网址 + 已生成图像的 URL 地址 @@ -482,15 +424,15 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 图像生成任务的结果统计 + 图像生成任务的任务结果统计 - 失败的任务数量 + 失败任务数 - 成功的任务数量 + 成功任务数 @@ -500,11 +442,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 任务状态 - 可选值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频网址。链接有效期为 24 小时 + 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 @@ -516,7 +458,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 视频分辨率等级(I2V 和 wan3.0-video 任务) + 视频分辨率级别(I2V 和 wan3.0-video 任务) @@ -560,11 +502,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 失败请求的错误代码,在响应信封的根层级而非 `output` 下报告(请求成功时不会返回)。 + 失败请求的错误码,报告在响应信封的根层级,而不是在 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,在响应信封的根层级而非 `output` 下报告(请求成功时不会返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,报告在响应信封的根层级,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx index 0990044475..9203fb343f 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx @@ -2,17 +2,18 @@ title: "通过 Comfy Router 使用 HappyHorse 1.1 R2V" description: "通过 Comfy Router 以 HTTP 调用 wan/happyhorse-1.1-r2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果形状" sidebarTitle: "HappyHorse 1.1 R2V" -translationSourceHash: afb02787 +translationSourceHash: 53cf60f2 translationFrom: development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx translationBlockHashes: "_intro": 320590bd "Quick start": 8eb3cc23 - "Schema": b9d2c334 + "Schema": 57b62b59 "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -209,122 +210,64 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-r2v/requests/$REQUEST_ID - 音频文件的下载链接。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 - 首帧图像的 URL 或 Base64 编码数据。对于 wan2.5-i2v-preview 和 -wan2.6-i2v 模型为必填。happyhorse-1.x 的 i2v 拼写不在这里取首帧, -它们将首帧作为类型为 first_frame 的媒体元素传入(见下文 media),并且在 -wan2.6-i2v 上能成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 -happyhorse-1.1-i2v 上会被提供商拒绝;而 wan2.7/wan3.0 的拼写同样在 -media 中传入它们的参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 -分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 写法不在此处接收首帧:它们将首帧作为类型为 first_frame 的媒体元素(见下方 media),而在 wan2.6-i2v 上能成功的 img_url 请求体会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 的写法也同样在 media 中接收参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。 -每个元素包含一个 type 字段和一个 url 字段。该字段由此组件所服务的每个 -模型共用,而某个给定模型接受哪些 type 值,以及它究竟是在这里承载其图像或视频 -输入而不是放在 img_url 或 reference_video_urls 中,都因模型而异。各模型支持的 -type 值如下: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 - 与 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公开 HTTP/HTTPS URL;不接受内联 - data: URL。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要一个 reference_image 或 reference_video,且参考图像加上 - 参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (无 alpha 通道),每边 240-8000 像素,宽高比在 1:8 与 8:1 之间,最大 - 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开 - HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-videoedit:video(正好 1 个,即正在编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL) - 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 与 8:1 之间,最大 20MB,公开 URL - 或 data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 段,总时长 \<= 15s)、 - reference_audio(最多 5 段,总时长 \<= 15s)、file(最多 1 个,不能 - 与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link - 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序 - 决定提示中资产的参考顺序(Image 1、Video 1、Audio 1 等)。first_frame、 - last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比至多 8:1,最大 20MB,公开 URL 或 - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公开 - HTTP/HTTPS URL;不接受内联 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,且正好 1 个。这些拼写 - 在这里取首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 - 在 1:2.5 与 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开 URL 或 - data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 - 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video - 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(正好 1 个,即正在编辑的片段:MP4/MOV,3-60 - 秒,长边最多 4096 像素,短边至少 360 像素,宽高 - 比在 1:2.5 与 2.5:1 之间,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: - URL)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 与 2.5:1 之间,最大 20MB,公开 URL - 或 data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其对应的合作伙伴参考文档未记录任何媒体输入,因此请 - 不要设置此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些拼写枚举任何媒体 - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中取 - 首帧;wan2.6-r2v 在 reference_video_urls 中取参考片段。 -上文按模型列出的数量是合作伙伴的限制,而不是本 schema 的限制:media 上 -未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受 -并不意味着提供商接受;反过来说,上文每项资产“最大 20MB”的数字 -(图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终 -得到的资产所设的上限,当资产是公开 URL 时,这些数字按字面适用, -因为这些字节从不经过 Comfy 传输。内联的 data:\{MIME_type};base64,... -URL 确实要经过 Comfy 传输,并且也会遇到传输上限:Comfy Router -POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载荷膨胀 -约 4/3,因此单个内联资产一旦超过大约 75 MB,就会在触及这里的任何 -合作伙伴规则之前被拒绝。在该大小下,单个资产按合作伙伴自身的20MB 的上限足以轻松容纳内联数据,因此对于单个资产而言,真正起约束作用的是合作伙伴侧的规则;而涉及多个资产时,约束则来自传输上限,因为 Router 的 100 MiB 上限限制的是整个请求,而不是其中的每个元素。任何接近这些上限的内容,请以公共 URL 发送。 + 媒体资产列表。指定用于视频生成的参考材料(图像、音频、视频)。每个元素包含 type 和 url 字段。该字段由此组件服务的每个模型共享,而特定模型接受哪些 type 值,以及它是否在此处而不是在 img_url 或 reference_video_urls 中携带图像或视频输入,会因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-r2v: first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,且参考图像加参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video:公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit: video(恰好 1 个,即正在编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video, wan3.0-video-prime: first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。在同一请求中,reference_*/file/link 类型与 first_frame/last_frame 类型互斥。数组顺序定义提示词中资产的参考顺序(图像 1、视频 1、音频 1、...)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: 仅 first_frame,恰好 1 个。这些写法在此处接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: 仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 +- happyhorse-1.0-video-edit: video(恰好 1 个,即正在编辑的片段:MP4/MOV,3-60 秒,较长边最大 4096 像素,较短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: 文生视频操作。它们的合作伙伴参考文档未记录媒体输入,因此请勿设置此字段。 +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 此组件没有为这些写法枚举任何媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 +上述按模型的数量限制是合作伙伴的约束,而不是此 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。通过 Schema 校验并不代表提供商会接受;反过来说,上文每个资产“最多 20MB”的数字(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终接收到的资产的上限,并且当资产是公共 URL 时这些数字按字面适用,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,并且也会遇到传输上限:Comfy Router POST 请求体的总上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个超过约 75 MB 的内联资产会在触达此处的任何合作伙伴规则之前被拒绝。达到该大小时,单个资产按合作伙伴自身的 +20MB 上限足以轻松容纳内联内容,因此对单个资产而言,真正起约束作用的是合作伙伴规则;涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。凡是接近这些上限的内容,请以公共 URL 形式发送。 媒体资产类型 - 可选值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可能的值:`first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` - 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者(仅限上文中 `media` 描述为各模型列出的 IMAGE 输入,即 wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)一个内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自家上传服务的 oss://dashscope-instant 临时 URL,或 wan2.7-videoedit 上的 Asset Center asset_id,仅在创建它的那个阿里云账号下才能解析;Comfy 使用自己的密钥发起模型调用,并且不提供任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。本字段不校验 URL 协议,因此这类值会原样转发给合作伙伴,而不会在这里被拒绝。关于各模型的尺寸与像素限制,以及从总体上约束内联负载的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:公共 HTTP/HTTPS URL,或(仅适用于上文 `media` 描述中为各模型列出的图像输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 与 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 与 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 与 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)内联 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)资产中心的 asset_id,仅在执行上传的阿里云账号下才能解析;Comfy 使用自己的密钥发起模型调用,并不提供上传路由,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL 协议,因此此类值会按原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的大小和像素限制,以及按总量约束内联载荷的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中出现的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符时,Wan 模型会截断它,而不是拒绝它。它与 prompt 计入相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于含多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等按参考视频的顺序指代其中的主体。示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等按 media 数组中的对应顺序指代媒体资产。 + 文本提示词。支持中文和英文。超过各自文档规定的长度时,wan2.x 模型会截断提示词,而不是拒绝它:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 与 wan3.0-video-prime 最多接受 20,000 个字符。如果 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符),提供商将拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。对于带有多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:“Character1 在路边唱歌,Character2 在旁边跳舞”。对于 wan3.0-video 的参考模式,请按 media 数组中的对应顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。包含 1-3 个视频 URL 的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 -- 单个视频时长:2-30 秒 +- 单个视频长度:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最多 5 秒,两个视频各最多 2.5 秒,三个视频按比例更短。 -计费:按实际使用的参考时长计费。 +参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例相应缩短。 +计费:根据实际使用的参考时长计算。 - 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。本组件上不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充该值,因此 Router 调用方可以省略它。直接以 v1 调用 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 时则必须提供它,可接受的拼写枚举定义在该操作自己的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时,必须提供它,可接受写法的枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 @@ -332,7 +275,7 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商没有为其他 wan 模型记录此类切换。 + 是否向视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商文档中没有为其他 Wan 模型列出此类开关。 @@ -340,44 +283,43 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - auto(默认):模型根据提示词内容智能判断 - origin:强制保留输入视频的原始音频 - 可选值:`auto`、`origin` + 可能的值:`auto`, `origin` - 生成视频的时长,单位为秒: + 生成的视频时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 - wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:位于 [2, 15] 的整数 -- wan2.7-r2v、wan2.7-videoedit:位于 [2, 10] 的整数 -- wan3.0-video:无视频输入时为位于 [2, 30] 的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型自行选择合适的时长 -本代理对 [-1, 30] 之外的时长返回 400。 +- wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频时长与输出视频时长之和不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +对于超出 [-1, 30] 的时长,此代理会返回 400。 范围:`-1` 到 `30` - 是否启用提示词智能改写。默认为 true + 是否启用提示词智能重写。默认值为 true。 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,未提供时会根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 +对于 wan2.7 模型,如果未提供,则根据分辨率档位确定默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定比例。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` - 分辨率档位。支持的值因模型而异: + 分辨率档位。支持的取值因模型而异: - wan2.5-i2v-preview:480P、720P、1080P - wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P - -本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将 resolution 转为大写并转发大写后的值;对于超出该枚举范围的值返回 400;对于上方列出的、标注为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,只要传入 480P(无论以 resolution 还是 480P 的 size 形式传入)就返回 400。 +本代理会拒绝既不提供 resolution 也不提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在校验之前先将 resolution 转为大写并转发大写后的值,对于该枚举之外的取值返回 400,并且对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,遇到 480P 时(无论是以 resolution 还是以 480P 的 size 形式发送)也会返回 400。 可选值:`480P`、`720P`、`1080P` @@ -385,11 +327,12 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 随机数种子,用于控制模型生成内容的随机性 - 范围:`0` 到 `2147483647` + 范围:`0` 至 `2147483647` - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 - single:单镜头视频(默认) - multi:多镜头视频 @@ -397,19 +340,19 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 视频分辨率,格式为宽度*高度。支持的分辨率因模型而异: -对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(无 480P): - 720P:1280*720、720*1280、960*960、1088*832、832*1088 - 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是本代理为该模型接受的值。对于分辨率说明中列出为不支持 480P 的每个模型,480P 的 size 都会返回 400。 + 视频分辨率,格式为 width*height。支持的分辨率因模型而异: +wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +wan2.6 T2V/R2V(无 480P): + 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 + 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 +当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是本代理对该模型接受的取值。在 resolution 描述中列为不支持 480P 的每个模型上,发送 480P 的 size 都会返回 400。 是否添加水印 logo,水印位于右下角 -由 Router 在 `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +本文档由 Router 在 `GET /v2/models/wan/happyhorse-1.1-r2v/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用时所依据的同一份文档。 ### 输出 @@ -418,15 +361,15 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 智能改写后的实际提示词(用于视频任务) + 智能重写后的实际提示词(用于视频任务) - 带音频生成的 I2V 任务的音频 URL + 启用音频生成的 I2V 任务的音频 URL - 失败请求的错误码(请求成功时不返回) + 请求失败时的错误代码(请求成功时不返回) @@ -434,7 +377,7 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 失败请求的详细信息(请求成功时不返回) + 请求失败的详细信息(请求成功时不返回) @@ -442,15 +385,15 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 图像生成任务的结果列表 + 图像生成任务的任务结果列表 - 智能改写后的实际提示词(若已启用) + 智能重写后的实际提示词(若已启用) - 图像错误码(部分任务失败时返回) + 图像错误代码(部分任务失败时返回) @@ -462,7 +405,7 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 已生成图像的网址 + 已生成图像的 URL 地址 @@ -478,7 +421,7 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 图像生成任务的结果统计 + 图像生成任务的任务结果统计 @@ -500,7 +443,7 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 + 已完成的视频生成任务的视频 URL。链接有效期 24 小时 @@ -512,7 +455,7 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 视频分辨率级别(I2V 和 wan3.0-video 任务) + 视频分辨率等级(I2V 和 wan3.0-video 任务) @@ -528,7 +471,7 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒,无视频输入时为 0.0(wan3.0-video 任务) @@ -536,7 +479,7 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 已生成视频的比例,例如 16:9(wan3.0-video 任务) + 已生成视频的宽高比,例如 16:9(wan3.0-video 任务) @@ -556,11 +499,11 @@ POST 正文总计上限为 100 MiB,超过则返回 413,而 base64 会使载 - 失败请求的错误码,报告在信封的根层级而不是 `output` 下(请求成功时不返回)。 + 请求失败时的错误代码,报告在响应封装的根层级,而不是 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,报告在信封的根层级而不是 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先查看此项。 + 请求失败的详细信息,报告在响应封装的根层级,而不是 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先读取此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx b/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx index 3a4ee81761..18954c07ac 100644 --- a/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用 Wan 2.5 I2I Preview" description: "通过 Comfy Router 调用 wan/wan2.5-i2i-preview:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Wan 2.5 I2I Preview" -translationSourceHash: c19a12c9 +translationSourceHash: 11080daf translationFrom: development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx translationBlockHashes: "_intro": d8f59ebb "Quick start": a98c2f62 - "Schema": 8bff936f + "Schema": c4c53620 "Examples": 3d10fc60 --- + {/* GENERATED FILE. Generated from router-schemas/wan/wan2.5-i2i-preview.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -180,19 +181,19 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 用于图生图生成的图像 URL 数组 + 由 1 到 3 个图像 URL 组成的数组,用于图生图生成 - 反向提示词,用于描述你不希望在图像中出现的内容 + 反向提示词,用于描述你不希望在图像中看到的内容。它和提示词计入相同的输入预算。 - 正向提示词,用于描述期望的图像元素和视觉特征。支持中英文,长度不超过 2000 个字符 + 正向提示词,用于描述期望的图像元素和视觉特征。支持中文和英文。超过模型读取长度的提示词会被截断,而不是被拒绝。当 prompt 和 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符)时,提供商会拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 - 用于图生图生成时要调用的模型 ID。本组件不对其进行约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它。直接以 v1 方式调用 `POST /proxy/wan/api/v1/services/aigc/image2image/image-synthesis` 时必须提供它,可接受写法的枚举定义在该操作自身的组件 `WanImage2ImageGenerationRequest` 上。 + 用于图生图生成时要调用的模型 ID。此组件不对其进行约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它。直接向 `POST /proxy/wan/api/v1/services/aigc/image2image/image-synthesis` 发起 v1 调用时,必须提供它;可接受拼写的枚举位于该操作自身的组件 `WanImage2ImageGenerationRequest` 中。 @@ -200,7 +201,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 生成图像的数量。范围 1-4,默认为 4 + 生成的图像数量。范围为 1 到 4,默认值为 4 范围:`1` 到 `4` @@ -212,14 +213,15 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 输出图像分辨率,格式为 宽度*高度。默认为 1280*1280。API 接受的像素面积介于 589824(768*768)与 1638400(1280*1280)之间,宽高比介于 1:4 与 4:1 之间 + 输出图像分辨率,格式为宽度*高度。默认值为 1280*1280。API 接受的像素面积介于 589824(768*768)和 1638400(1280*1280)之间,宽高比介于 1:4 和 4:1 之间 - 是否在右下角添加水印标志 + 是否在右下角添加水印标识 -本页内容由 Router 在 `GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` 提供的 schema 生成,在请求到达提供商之前,Router 也依据同一份文档对调用进行校验。 +本页内容根据 Router 在 `GET /v2/models/wan/wan2.5-i2i-preview/openapi.json` 提供的 schema 生成;在请求到达提供商之前,Router 也使用同一份文档校验调用。 + ### 输出 @@ -231,7 +233,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 带有音频生成的 I2V 任务的音频 URL + 带音频生成的 I2V 任务的音频网址 @@ -255,7 +257,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 智能改写后的实际提示词(若已启用) + 智能改写后的实际提示词(如已启用) @@ -271,7 +273,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 已生成图像的 URL 地址 + 已生成图像的图片网址 @@ -291,11 +293,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 失败的任务数量 + 失败任务数 - 成功的任务数量 + 成功任务数 @@ -309,7 +311,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 已完成的视频生成任务的视频 URL。链接有效期 24 小时 + 已完成的视频生成任务的视频网址。链接有效期为 24 小时 @@ -325,7 +327,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 已生成视频的时长(秒)(I2V 和 wan3.0-video 任务) + 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) @@ -337,11 +339,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 输入视频的时长(秒),无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒,无视频输入时为 0.0(wan3.0-video 任务) - 输出视频的时长(秒)(wan3.0-video 任务) + 输出视频的时长,单位为秒(wan3.0-video 任务) @@ -357,7 +359,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 已生成视频的时长(秒)(T2V 任务) + 已生成视频的时长,单位为秒(T2V 任务) @@ -365,11 +367,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 失败请求的错误码,报告在响应信封的根层级而非 `output` 下(请求成功时不返回)。 + 失败请求的错误码,在响应信封的根层级上报,而不是在 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,报告在响应信封的根层级而非 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此字段。 + 失败请求的详细信息,在响应信封的根层级上报,而不是在 `output` 下(请求成功时不返回)。请先阅读此项,再回退到 `output.message`。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index 98ee7ed519..841b6e93a4 100644 --- a/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 Wan 2.5 I2V Preview" description: "通过 Comfy Router 以 HTTP 调用 wan/wan2.5-i2v-preview 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果结构" sidebarTitle: "Wan 2.5 I2V Preview" -translationSourceHash: 76630e35 +translationSourceHash: cf342bd4 translationFrom: development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx translationBlockHashes: "_intro": 630a0d10 "Quick start": 8713537b - "Schema": 8ddb2e5e + "Schema": 483bc30d "Examples": 2b581e5f --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -186,7 +187,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2v-preview/requests/$REQUEST_ID ### 输入 - 输入基本信息,例如提示词等。 + 填写基本信息,如提示词等。 @@ -194,76 +195,72 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2v-preview/requests/$REQUEST_ID - 首帧图像 URL 或 Base64 编码数据。对于 wan2.5-i2v-preview 和 -wan2.6-i2v 模型为必填。happyhorse-1.x 的 i2v 拼写不在此处接收其首帧: -它们将其作为类型为 first_frame 的媒体元素接收(见下文 media),而在 -wan2.6-i2v 上能够成功的 img_url 请求体, -在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;而 -wan2.7/wan3.0 的拼写同样在 media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 -分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x + 的 i2v 写法不在此处接收首帧,它们把首帧作为 type 为 first_frame 的 media 元素传入(见下方的 + media),而且在 wan2.6-i2v 上能够成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 + happyhorse-1.1-i2v 上会被提供商拒绝。wan2.7/wan3.0 的写法同样在 media 中传入其参考资产。 + 图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含一个 type 字段和一个 url 字段。此字段由此组件提供的所有模型共享,而某个给定模型接受哪些 type 值(以及它究竟是将其图像或视频输入放在此处,还是放在 img_url 或 reference_video_urls 中)因模型而异。各模型支持的 type 值如下: + 媒体资产列表。用于指定视频生成的参考素材(图像、音频、视频)。每个元素包含一个 type 和一个 + url 字段。该字段由此组件提供的所有模型共享,而某个模型接受哪些 type 值,以及它是否在此处而不是在 + img_url 或 reference_video_urls 中传入图像或视频输入,会因模型而异。各模型支持的 type 值: - wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 - 到 8:1 之间,最多 20MB,可以是公开 URL 或 - data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3,2-30 秒,最多 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最多 100MB):公开 HTTP/HTTPS URL;不接受内联 + last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 + 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 + 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要提供一个 reference_image 或 reference_video,且参考图像与 - 参考视频合计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 - 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要 + 一个 reference_image 或 reference_video,且 reference_image 与 reference_video + 合计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP + (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 + 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开的 HTTP/HTTPS URL;不接受内联 data: URL。 - wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最多 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL) - 加上可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 20MB,可以是公开 URL + 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: URL) + 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL)。 - wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能 - 与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link - 类型与 first_frame/last_frame 类型在同一请求中互斥。 - 数组顺序定义了资产在提示词中的引用顺序(Image 1、Video 1、 - Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比最多 8:1,最多 20MB,可以是公开 URL 或 - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link: - 公开 HTTP/HTTPS URL;不接受内联 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写 - 在此处接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最多 20MB,可以是公开 URL 或 + reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 + link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型 + 与 first_frame/last_frame 类型在同一请求内互斥。数组顺序决定 + 提示词中资产的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 + reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1, + 最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video、 + reference_audio、file 和 link:公开的 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法 + 在这里传入首帧,而不是在 img_url 中传入。至少 300x300 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。 - happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最多 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video + 最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 - happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,长边最多 4096 像素,短边至少 360 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,最多 100MB,公开 HTTP/HTTPS URL;不接受内联 - data: URL)加上可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最多 20MB,可以是公开 URL + 秒,长边最大 4096 像素,短边至少 360 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: + URL)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 + 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其合作伙伴参考文档未记录任何媒体输入,因此请勿设置 - 此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些拼写列举任何媒体 - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧; - wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上文中按模型给出的数量是合作伙伴的约束,而不是此 schema 的约束:media 上未声明任何 -minItems/maxItems,因为各模型允许的类型及其上限各不相同。schema 接受并不意味着提供商接受: -反过来说,上文中每个资产“最多 20MB”的数值(这是对图像输入的上限,而图像是唯一可以内联发送的输入) -是合作伙伴对其最终收到的资产所设的上限,当资产是公开 URL 时它们按字面适用, -因为这些字节从不流经 Comfy。内联的 data:\{MIME_type};base64,... -URL 确实会流经 Comfy,并且同样会遇到传输上限:Comfy Router -的 POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使负载膨胀约 4/3, -因此单个内联资产超过约 75 MB 就会在此处任何合作伙伴规则被触及之前被拒绝。 -在这种大小下,单个资产已达到合作伙伴自身的20MB 上限以内可以轻松内联,因此对于单个资产而言,真正起作用的是合作伙伴规则; -传输上限则在涉及多个资产时起作用,因为 100 MiB 的 Router 上限约束的是整个请求, -而不是每个元素。任何接近这些上限的内容都应作为公共 URL 发送。 + 文生视频操作。对应的参考文档未记录任何媒体输入,因此请不要设置 + 该字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些写法列举任何 media + 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入 + 首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 +上文中各模型的数量限制属于合作伙伴的约束,而不是本 schema 的约束:media 上未声明 +minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 校验通过并不意味着提供商 +会接受;反过来说,上文每个资产“最大 20MB”的数字(图像输入的上限,也是唯一可能内联发送的 +输入),是合作伙伴对其最终获得的资产设定的上限,当资产是公开 URL 时按字面适用, +因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... +URL 确实会经过 Comfy,因此还会遇到传输上限:Comfy Router 的 +POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 +负载膨胀约 4/3,因此单个内联资产超过约 75 MB 时,就会在触达这里的任何 +合作伙伴规则之前被拒绝。在这种大小下,单个资产达到合作伙伴自身20MB 的上限对 inline 内容而言绰绰有余,因此单个资产受合作伙伴规则的约束,而多个资产则受传输上限的约束,因为 Router 的 100 MiB 上限约束的是整个请求,而不是每个元素。接近这些上限的任何内容请以公共 URL 发送。 @@ -273,20 +270,16 @@ URL 确实会流经 Comfy,并且同样会遇到传输上限:Comfy Router - 媒体文件的 URL:可以是公共 HTTP/HTTPS URL,或者(仅限上方 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)也可以是内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)资产中心的 asset_id,只能针对上传它的阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不提供任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。该字段不校验 URL scheme,因此这类值会原样转发给合作伙伴,而不是在这里被拒绝。各模型的尺寸与像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:一个公共 HTTP/HTTPS URL;或者,仅限上文 `media` 描述中为各模型列出的那些 IMAGE 输入(wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image),一个内联的 `data:{MIME_type};base64,...` URL。这些模型中没有任何视频、音频、文件或链接输入接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只会对上传它的阿里云账号生效;Comfy 使用自己的密钥发起模型调用,不提供上传路由,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL 协议,因此这类值会原样转发给合作伙伴,而不会在这里被拒绝。各模型的大小与像素限制,以及约束内联载荷总量的 Router 请求体 100 MiB 上限,请参见 `media` 描述。 - 反向提示词用于描述你不想在视频画面中看到的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符时,Wan 模型会将其截断,而不是拒绝它。它与 prompt 计入同一输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等按参考视频的顺序 -指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等按 media 数组中的 -对应顺序指代媒体资产。 + 文本提示词。支持中文和英文。超过各自文档规定的长度时,wan2.x 模型会截断提示词,而不是拒绝它:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。若 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符),提供商会拒绝该请求,返回 InvalidParameter `Range of input length should be [1, 61440]`。对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 的参考模式,请按 media 数组中相应的顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 @@ -294,19 +287,19 @@ URL 确实会流经 Comfy,并且同样会遇到传输上限:Comfy Router 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 -- 单个视频时长:2-30 秒 +- 单个视频长度:2-30 秒 - 单个文件大小:最大 30MB -- 不能与 audio_url 同时使用 -参考时长:单个视频最大 5s,两个视频各自最大 2.5s,三个视频按比例更短。 +- 不能与 audio_url 一起使用 +参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例更短。 计费:按实际使用的参考时长计算。 - 视频特效模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。该组件不对其进行约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它,因此 Router 调用方会省略该字段。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时必须提供它,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件不作约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受拼写的枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -314,7 +307,7 @@ URL 确实会流经 Comfy,并且同样会遇到传输上限:Comfy Router - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记录此类切换。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 Wan 模型记录此类切换。 @@ -326,17 +319,16 @@ URL 确实会流经 Comfy,并且同样会遇到传输上限:Comfy Router - 所生成视频的时长,单位为秒: + 生成视频的时长,以秒为单位: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) +- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) - wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 - wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频时长 - 与输出视频时长之和不得超过 30 秒;-1 会启用智能时长模式,由模型选择合适的时长 -对于超出 [-1, 30] 的时长,该代理会返回 400。 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频时长与输出视频时长之和不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +该代理对超出 [-1, 30] 范围的 duration 返回 400。 - 范围:`-1` 到 `30` + 范围:`-1` 至 `30` @@ -344,12 +336,11 @@ URL 确实会流经 Comfy,并且同样会遇到传输上限:Comfy Router - 所生成视频的画面比例。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的 -画面比例。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,若未提供则根据分辨率档位取默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 - 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 可选值:`adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -360,9 +351,9 @@ URL 确实会流经 Comfy,并且同样会遇到传输上限:Comfy Router - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P -此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定了计费费率。它会在检查之前将 resolution 转为大写并转发大写后的值,对于不属于此枚举的值返回 400,并且对于上文列出为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,如果传入 480P(无论以 resolution 还是以 480P 的 size 传入),都会返回 400。 +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将 resolution 转换为大写并转发大写后的值,对于此枚举之外的值返回 400,并且对于上述被列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,对 480P(无论是以 resolution 还是以 480P 的 size 发送)返回 400。 - 可能的值:`480P`、`720P`、`1080P` + 可选值:`480P`, `720P`, `1080P` @@ -372,27 +363,28 @@ URL 确实会流经 Comfy,并且同样会遇到传输上限:Comfy Router - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 -- single: 单镜头视频(默认) -- multi: 多镜头视频 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 +- single:单镜头视频(默认) +- multi:多镜头视频 - 可能的值:`multi`、`single` + 可选值:`multi`, `single` 视频分辨率,格式为 width*height。支持的分辨率因模型而异: -wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -wan2.6 T2V/R2V(不支持 480P): - 720P:1280*720、720*1280、960*960、1088*832、832*1088 - 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时传入 size 和 resolution 时,由 size 决定计费的档位,而 resolution 仍必须是此代理为该模型接受的值。对于 resolution 描述中列出为不支持 480P 的每个模型,传入 480P 的 size 都会返回 400。 +对于 wan2.5 T2V:480P(480*832, 832*480, 624*624)、720P、1080P 尺寸 +对于 wan2.6 T2V/R2V(不支持 480P): + 720P:1280*720, 720*1280, 960*960, 1088*832, 832*1088 + 1080P:1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 +当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是本代理对该模型所接受的值。对于分辨率描述中列为不支持 480P 的每个模型,480P 的 size 都会返回 400。 - 是否添加水印标识,水印位于右下角 + 是否添加水印标志,水印位于右下角 -本文档由 Router 在 `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/wan/wan2.5-i2v-preview/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前校验调用时所依据的同一份文档。 ### 输出 @@ -401,11 +393,11 @@ wan2.6 T2V/R2V(不支持 480P): - 智能改写后的实际提示词(适用于视频任务) + 智能改写后的实际提示词(视频任务) - 带音频生成的 I2V 任务的音频 URL + 带音频生成的 I2V 任务的音频网址 @@ -417,11 +409,11 @@ wan2.6 T2V/R2V(不支持 480P): - 关于失败请求的详细信息(请求成功时不返回) + 失败请求的详细信息(请求成功时不返回) - 原始输入提示词(适用于视频任务) + 原始输入提示词(视频任务) @@ -445,7 +437,7 @@ wan2.6 T2V/R2V(不支持 480P): - 已生成图像的 URL 地址 + 已生成图像的网址 @@ -461,15 +453,15 @@ wan2.6 T2V/R2V(不支持 480P): - 图像生成任务的结果统计 + 图像生成任务的统计结果 - 失败任务数量 + 失败任务数 - 成功任务数量 + 成功任务数 @@ -483,11 +475,11 @@ wan2.6 T2V/R2V(不支持 480P): - 已完成视频生成任务的视频 URL。链接有效期为 24 小时 + 已完成的视频生成任务的视频网址。链接有效期 24 小时 - 唯一的请求标识符 + 唯一请求标识符 @@ -495,11 +487,11 @@ wan2.6 T2V/R2V(不支持 480P): - 视频分辨率档位(I2V 与 wan3.0-video 任务) + 视频分辨率等级(I2V 和 wan3.0-video 任务) - 已生成视频的时长,单位为秒(I2V 与 wan3.0-video 任务) + 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) @@ -507,7 +499,7 @@ wan2.6 T2V/R2V(不支持 480P): - 已生成图像的数量(T2I 与 I2I 任务) + 已生成图像的数量(T2I 和 I2I 任务) @@ -523,7 +515,7 @@ wan2.6 T2V/R2V(不支持 480P): - 图像分辨率(T2I 与 I2I 任务) + 图像分辨率(T2I 和 I2I 任务) @@ -539,11 +531,11 @@ wan2.6 T2V/R2V(不支持 480P): - 失败请求的错误码,返回在信封(envelope)的根层级,而非 `output` 之下(若请求成功则不返回)。 + 失败请求的错误码,在响应外层结构的根层级报告,而不是在 `output` 下报告(请求成功时不返回)。 - 关于失败请求的详细信息,返回在信封(envelope)的根层级,而非 `output` 之下(若请求成功则不返回)。在回退到 `output.message` 之前请先读取此项。 + 失败请求的详细信息,在响应外层结构的根层级报告,而不是在 `output` 下报告(请求成功时不返回)。在回退到 `output.message` 之前,请先读取此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-6-t2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-6-t2v/code.mdx index 7e4ee18ba5..f54c550cfd 100644 --- a/zh/development/comfy-router/models/wan/wan2-6-t2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-6-t2v/code.mdx @@ -2,18 +2,19 @@ title: "通过 Comfy Router 使用 Wan 2.6 T2V" description: "通过 Comfy Router 以 HTTP 方式调用 wan/wan2.6-t2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果形状" sidebarTitle: "Wan 2.6 T2V" -translationSourceHash: af081f28 +translationSourceHash: 00873331 translationFrom: development/comfy-router/models/wan/wan2-6-t2v/code.mdx translationBlockHashes: "_intro": 93b4f6f5 "Quick start": b919757c - "Schema": dd8ddc51 + "Schema": 35961ffb "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -186,123 +187,121 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-t2v/requests/$REQUEST_ID \ - 音频文件下载链接。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 - 首帧图片网址或 Base64 编码数据。wan2.5-i2v-preview 和 -wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 拼写方式并不在此处接收首帧: -它们将其作为类型为 first_frame 的媒体元素接收(见下文 media);而在 -wan2.6-i2v 上能成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 -happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 的拼写方式同样在 -media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 + 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 +wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 拼写并不在此处接收首帧 +-- 它们将其作为 type 为 first_frame 的媒体元素接收(见下文 media),而在 +wan2.6-i2v 上能够成功的 img_url 请求体,会被提供商在 +happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;同时 wan2.7/wan3.0 的拼写也 +通过 media 接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 分辨率:360-2000 像素。文件大小:最大 10MB。 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 -type 和 url 字段。此字段由此组件提供的所有模型共享,而某个给定模型接受哪些 -type 值,以及它究竟是将图像或视频输入承载在此处而不是在 img_url 或 -reference_video_urls 中,会因模型而异。各模型支持的 type 值如下: - +type 和 url 字段。此字段由此组件提供的每一个模型共用,而某个模型接受哪些 +type 值 -- 以及它是否在此处而非 img_url 或 +reference_video_urls 中携带其图像或视频输入 -- 因模型而异。各模型支持的 type 值: - wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比介于 1:8 - 与 8:1 之间,最大 20MB,一个公共 URL 或一个 data:\{MIME_type};base64,... URL。 + last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 + 到 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。 driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):一个公共 HTTP/HTTPS URL;不接受内联 - data: URL。 + 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS URL; + 不接受内联 data: URL。 - wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要一个 reference_image 或 reference_video,且参考图像加参考视频总共最多 - 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (无透明度通道),每边 240-8000 像素,宽高比介于 1:8 与 8:1 之间,最大 - 20MB,一个公共 URL 或一个 data:\{MIME_type};base64,... URL。reference_video: - 一个公共 HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-videoedit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,一个公共 HTTP/HTTPS URL;不接受内联 data: - URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比介于 1:8 与 8:1 之间,最大 20MB,一个公共 URL - 或一个 data:\{MIME_type};base64,... URL)。 + 需要一个 reference_image 或 reference_video,且参考图像加上 + 参考视频合计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP + (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 + 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开的 + HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, + 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: URL) + 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开 URL + 或 data:\{MIME_type};base64,... URL)。 - wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 - link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link - 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序定义了提示词中 - 资产的参考顺序(图像 1、视频 1、音频 1、……)。first_frame、last_frame 和 - reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比至多 - 8:1,最大 20MB,一个公共 URL 或一个 data:\{MIME_type};base64,... URL。 - reference_video、reference_audio、file 和 link:一个公共 HTTP/HTTPS URL; - 不接受内联 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写方式 - 在此处而非 img_url 接收其首帧。至少 300x300 像素,宽高比介于 - 1:2.5 与 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,一个公共 URL 或一个 + link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型 + 与 first_frame/last_frame 类型在同一请求内互斥。 + 数组顺序定义了提示词中资产的参考顺序(Image 1、Video 1、 + Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可以是公开 URL 或 + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link: + 公开的 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写 + 在此处接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该 - 模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 - 20MB,一个公共 URL 或一个 data:\{MIME_type};base64,... URL。reference_video - 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,3-60 - 秒,长边最大 4096 像素,短边至少 360 像素,宽高比介于 1:2.5 与 2.5:1 之间, - 最大 100MB,一个公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 - 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素, - 宽高比介于 1:2.5 与 2.5:1 之间,最大 20MB,一个公共 URL 或一个 - data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 + 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, + 最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video + 不是此操作接受的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 + 秒,最长边最大 4096 像素,最短边至少 360 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: + URL)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 + 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可以是公开 URL + 或 data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其合作伙伴参考文档未记录媒体输入,因此请勿设置此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些拼写方式枚举任何 - 媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧; - wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 - -上文中各模型的计数是合作伙伴的约束,而非本 schema 的约束:media 上未声明 -minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不代表 -提供商接受。反过来,上文每项资产“最大 20MB”的数值(即图像输入的上限,而图像 -输入是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产所设的上限;当资产 -是一个公共 URL 时,它们按原文适用,因为这些字节从不经过 Comfy。内联的 -data:\{MIME_type};base64,... URL 确实会经过 Comfy,并且也会遇到传输上限:一个 -Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413,而 base64 会 -将载荷放大约 4/3,因此单个内联资产一旦超过约 75 MB,就会在触达这里任何合作伙伴 -规则之前被拒绝。在这种大小下,单个资产即便处于合作伙伴自身的20MB 的上限可以轻松地内联容纳,因此对单个资产而言,起约束作用的是合作伙伴规则;而当涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。凡是接近这些上限的内容,请以公共 URL 的形式发送。 + 文生视频操作。其合作伙伴参考文档未记录任何媒体输入,因此请不设置 + 此字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些拼写枚举任何媒体 + 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 通过 img_url 接收 + 首帧;wan2.6-r2v 通过 reference_video_urls 接收其参考片段。 +上述按模型的计数是合作伙伴的约束,而非此 schema 的约束:media 上未声明 +minItems/maxItems,因为可接受的类型及其上限 +因模型而异。schema 接受并不代表提供商接受 -- 反过来,上文每项资产 +"最大 20MB"的数值 -- 即图像输入的上限,也是唯一可以内联发送的 +输入 -- 是合作伙伴对其最终收到的资产设定的上限;当资产是公开 URL 时, +这些数值按字面生效,因为这些字节从不经过 Comfy 传输。内联的 data:\{MIME_type};base64,... +URL 确实会经过 Comfy 传输,并且同样会遇到传输层上限:Comfy Router +的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 +负载膨胀约 4/3,因此单个超过约 75 MB 的内联资产会在触及此处任何 +合作伙伴规则之前就被拒绝。在这样的体积下,单个资产按合作伙伴自身的20MB 上限可以轻松容纳内联内容,因此对单个资产来说起作用的是合作伙伴规则,而对多个资产来说起作用的是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中每个元素。接近这些上限的内容请改用公共 URL 发送。 媒体资产类型 - 可选值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - 媒体文件的 URL:可以是公共 HTTP/HTTPS URL,或者(仅限上文 `media` 描述中针对各模型列出的 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)使用内联 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账户解析;Comfy 使用自己的密钥发起模型调用,且不提供任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。本字段不校验 URL scheme,因此这类值会被原样转发给合作伙伴,而不会在此处被拒绝。关于各模型的大小和像素限制,以及会从整体上约束内联载荷的 100 MiB Router 请求体上限,请参阅 `media` 描述。 + 媒体文件的 URL:公共 HTTP/HTTPS URL,或者(仅限上文 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image)内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能对上传它的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不开放任何上传路由,因此调用方自有的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此这类值会原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的尺寸和像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中看到的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符时,wan 模型会截断它,而不是拒绝它。它与 prompt 计入相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多可达 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。 -示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等来按 media 数组中对应的顺序指代媒体资产。 + 文本提示词。支持中文和英文。超过各自文档记载的长度时,wan2.x 模型会截断提示词而不是拒绝它:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。如果 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符),提供商将拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 参考模式,请按 media 数组中的相应顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 - 参考视频 URL,仅适用于 wan2.6-r2v 模型。由 1-3 个视频 URL 组成的数组。 + 仅适用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 -- 单个视频时长:2-30 秒 -- 单个文件大小:最大 30MB +- 单个视频长度:2-30 秒 +- 单文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最大 5 秒,两个视频各最大 2.5 秒,三个视频按比例更短。 +参考时长:单个视频最大 5s,两个视频各最大 2.5s,三个视频按比例更短。 计费:基于实际使用的参考时长。 - 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 - 要调用的模型 ID。在本组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方可以省略它。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供它,可接受拼写的枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用必须提供它,可接受拼写的枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -310,39 +309,38 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未记录其他 wan 模型有此类切换。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记录此类开关。 wan2.7-videoedit 模型的视频音频设置。 -- auto(默认):模型根据提示词内容智能判断 +- auto(默认):模型根据 prompt 内容智能判断 - origin:强制保留输入视频的原始音频 - 可选值:`auto`、`origin` + 可能的值:`auto`、`origin` - 已生成视频的时长,单位为秒: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -本代理对超出 [-1, 30] 的时长返回 400。 +- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) +- wan2.7-i2v、wan2.7-t2v:[2, 15] 区间内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 区间内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 区间内的整数;有视频输入时,输入视频总时长与输出视频时长之和不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +该代理对 [-1, 30] 之外的 duration 返回 400。 - 范围:`-1` 到 `30` + 范围:`-1` 至 `30` - 是否启用提示词智能改写。默认为 true + 是否启用提示词智能重写。默认为 true - 已生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,未提供时将根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图 -自动推荐合适的宽高比。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图决定宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -350,15 +348,14 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, 分辨率档位。支持的值因模型而异: - wan2.5-i2v-preview:480P、720P、1080P -- wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) +- wan2.6 模型(t2v、i2v、r2v):仅支持 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它在检查之前会将 resolution 转为大写并转发大写后的值;对于不在此枚举范围内的值返回 400;对于上文列出不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,返回 400(无论是以 resolution 还是以 480P 的 size 形式发送)。 -该代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为 resolution 档位决定计费费率。它会在检查之前将 resolution 转换为大写并转发大写后的值,对于不在此枚举范围内的值返回 400,并且对于上述列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,对 480P 返回 400(无论是以 resolution 还是以 480P 的 size 发送)。 - - Possible values: `480P`, `720P`, `1080P` + 可选值:`480P`、`720P`、`1080P` @@ -368,27 +365,28 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 - single:单镜头视频(默认) - multi:多镜头视频 - Possible values: `multi`, `single` + 可选值:`multi`、`single` 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: 对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(无 480P): +对于 wan2.6 T2V/R2V(不支持 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是该代理针对该模型接受的值。对于 resolution 说明中列为无 480P 的每个模型,480P 尺寸都会返回 400。 +当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是此代理对该模型接受的取值。对于分辨率说明中列为不支持 480P 的每个模型,480P 的 size 都会返回 400。 - 是否添加水印 logo,水印位于右下角 + 是否添加水印标识,水印位于右下角 -由 Router 在 `GET /v2/models/wan/wan2.6-t2v/openapi.json` 提供的 schema 生成,这份文档也是它在请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/wan/wan2.6-t2v/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 ### 输出 @@ -397,11 +395,11 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 智能改写后的实际提示词(用于视频任务) + 智能改写后的实际提示词(适用于视频任务) - 带音频生成的 I2V 任务的音频 URL + 启用音频生成的 I2V 任务的音频网址 @@ -417,7 +415,7 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 原始输入提示词(用于视频任务) + 原始输入提示词(适用于视频任务) @@ -425,7 +423,7 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 智能改写后的实际提示词(若启用) + 智能改写后的实际提示词(如已启用) @@ -441,7 +439,7 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 已生成图像的 URL 地址 + 已生成图像的网址 @@ -479,7 +477,7 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 已完成的视频生成任务的视频 URL。链接有效期 24 小时 + 已完成的视频生成任务的视频网址。链接有效期为 24 小时 @@ -491,7 +489,7 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 视频分辨率等级(I2V 和 wan3.0-video 任务) + 视频分辨率级别(I2V 和 wan3.0-video 任务) @@ -515,7 +513,7 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 已生成视频的画幅比例,例如 16:9(wan3.0-video 任务) + 已生成视频的宽高比,例如 16:9(wan3.0-video 任务) @@ -535,11 +533,11 @@ Comfy Router 的 POST 请求体总量上限为 100 MiB,超出则返回 413, - 失败请求的错误码,报告在响应封装的根层级而不是 `output` 之下(请求成功时不返回)。 + 失败请求的错误码,位于外层响应的根层级,而不是 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,报告在响应封装的根层级而不是 `output` 之下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,位于外层响应的根层级,而不是 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此内容。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-7-t2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-7-t2v/code.mdx index ac31a9eed5..2cedb2a259 100644 --- a/zh/development/comfy-router/models/wan/wan2-7-t2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-7-t2v/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 Wan 2.7 T2V" description: "通过 Comfy Router 以 HTTP 方式调用 wan/wan2.7-t2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果结构" sidebarTitle: "Wan 2.7 T2V" -translationSourceHash: ff10f4b6 +translationSourceHash: 700c3a5c translationFrom: development/comfy-router/models/wan/wan2-7-t2v/code.mdx translationBlockHashes: "_intro": 89db521b "Quick start": d9034773 - "Schema": 6e6cd92f + "Schema": ffbd0afd "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -186,124 +187,119 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-t2v/requests/$REQUEST_ID \ - 音频文件下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载链接。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 - 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 -wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 写法不在这里接收首帧, -而是将其作为类型为 first_frame 的媒体元素接收(见下方 media),而在 -wan2.6-i2v 上能够成功的 img_url 请求体,会被提供商在 -happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 的写法同样 -通过 media 传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 + 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必须提供此字段。happyhorse-1.x +的 i2v 写法**不**在此处接收首帧:它们将首帧作为类型为 first_frame 的媒体元素接收(见下方 +media),而在 wan2.6-i2v 上能够成功的 img_url 请求体,在 +happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 的写法同样在 media 中 +提供其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考材料(图像、音频、视频)。 -每个元素包含 type 和 url 字段。该字段由本组件所服务的所有模型共用,而 -某个模型接受哪些 type 值,以及它究竟是把图像或视频输入放在这里、而不是放在 -img_url 或 reference_video_urls 中,都因模型而异。各模型支持的 type -值如下: + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由该组件提供的所有模型共用,而某个给定模型接受哪些 type +值,以及它究竟是在此处还是在 img_url 或 reference_video_urls 中携带其图像或视频输入,会因模型 +而异。各模型支持的 type 值如下: - wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 - 到 8:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 + last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比介于 1:8 + 与 8:1 之间,最大 20MB,可为公开网址或 data:\{MIME_type};base64,... 网址。 driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS URL;不接受内联 - data: URL。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要一个 reference_image 或 reference_video,并且参考图像加 - 参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 - 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开的 - HTTP/HTTPS URL;不接受内联 data: URL。 + 秒,每边 240-4096 像素,最大 100MB):公开 HTTP/HTTPS 网址;不接受内联 + data: 网址。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要 + 一个 reference_image 或 reference_video,且参考图像加上 + 参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP + (无透明度通道),每边 240-8000 像素,宽高比介于 1:8 与 8:1 之间,最大 + 20MB,可为公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开 + HTTP/HTTPS 网址;不接受内联 data: 网址。 - wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: URL), + 每边 240-4096 像素,最大 100MB,公开 HTTP/HTTPS 网址;不接受内联 data: 网址) 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开网址 + 每边 240-8000 像素,宽高比介于 1:8 与 8:1 之间,最大 20MB,可为公开网址 或 data:\{MIME_type};base64,... 网址)。 - wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15 秒)、 - reference_audio(最多 5 个片段,总时长 \<= 15 秒)、file(最多 1 个,不能 - 与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link - 类型与 first_frame/last_frame 类型在同一请求中互斥。数组 - 顺序决定提示词中资产的参考顺序(图像 1、视频 1、音频 1……)。 - first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可以是公开网址或 - data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link:公开的 - HTTP/HTTPS URL;不接受内联 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,且恰好 1 个。这些写法 - 在这里接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开网址或 + reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 + reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 + link 同时使用)、link(最多 1 个,不能与 file 同时使用)。reference_*/file/link 类型 + 与 first_frame/last_frame 类型在同一请求中互斥。数组 + 顺序决定提示词中资产的引用顺序(图像 1、视频 1、音频 1……)。first_frame、last_frame 和 + reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最多 8:1, + 最大 20MB,可为公开网址或 data:\{MIME_type};base64,... 网址。reference_video、 + reference_audio、file 和 link:公开 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法 + **在此处**接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 + 介于 1:2.5 与 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可为公开网址或 data:\{MIME_type};base64,... 网址。 - happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video + 最大 20MB,可为公开网址或 data:\{MIME_type};base64,... 网址。reference_video 不是此操作的输入类型。 - happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,较长边最大 4096 像素,较短边至少 360 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: - URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可以是公开网址 + 秒,较长边最多 4096 像素,较短边至少 360 像素,宽高比 + 介于 1:2.5 与 2.5:1 之间,最大 100MB,公开 HTTP/HTTPS 网址;不接受内联 data: + 网址)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 + 300x300 像素,宽高比介于 1:2.5 与 2.5:1 之间,最大 20MB,可为公开网址 或 data:\{MIME_type};base64,... 网址)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其合作伙伴参考文档未记录任何 media 输入,因此请 + 文生视频操作。它们的合作伙伴参考文档未记载任何媒体输入,因此请 不要设置此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件没有为这些写法枚举任何 media - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首 - 帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上表中各模型的数量限制是合作伙伴的约束,而不是本 schema 的约束:media 上 -未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema -接受并不意味着提供商接受;反过来说,上文每个资产“最大 20MB”的数值(图像 -输入的上限,也是唯一可以内联发送的输入)是合作伙伴对其最终获得的 -资产所设的上限,当资产是公开网址时,这些数值按原样适用, +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些写法枚举任何 media + 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中提供其首 + 帧;wan2.6-r2v 在 reference_video_urls 中提供其参考片段。 +上文按模型列出的数量是合作伙伴的限制,而非本 Schema 的限制:media 上没有声明 +minItems/maxItems,因为可接受的类型及其上限 +因模型而异。Schema 接受并不代表提供商接受;反过来, +上文每项资产“最大 20MB”的数字(图像 +输入的上限,也是唯一可以内联发送的输入)是合作伙伴对其最终 +收到的资产的限制,当资产为公开网址时,这些限制按字面生效, 因为这些字节从不经过 Comfy 传输。内联的 data:\{MIME_type};base64,... -URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制:Comfy Router -的 POST 请求体总计限制为 100 MiB,超过则返回 413,而 base64 会使 -负载膨胀约 4/3,因此单个超过大约 75 MB 的内联资产会在触及此处任何 -合作伙伴规则之前就被拒绝。在这个大小下,单个资产即便达到合作伙伴自身的20MB 的上限可以轻松容纳内联内容,因此对单个资产而言真正起约束作用的是合作伙伴的规则;而运输上限则在涉及多个资产时生效,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。任何接近这些上限的内容都应通过公共 URL 发送。 +网址确实会经过 Comfy 传输,也会遇到传输限制:Comfy Router 的 +POST 请求体总大小上限为 100 MiB,超过则返回 413,而 base64 会使 +负载增大约 4/3,因此单个超过约 75 MB 的内联资产会在触及此处任何合作伙伴规则 +之前就被拒绝。在这种大小下,单个资产处于合作伙伴自身的20MB 的上限足以轻松容纳内联数据,因此对于单个资产,真正起约束作用的是合作伙伴的规则;而当涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。任何接近这些上限的内容,都请以公共 URL 的形式发送。 媒体资产类型 - 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可选值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - 媒体文件的 URL:一个公共 HTTP/HTTPS URL;或者,仅对于上文 `media` 描述中为各模型列出的 IMAGE 输入(wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image),可以是内联的 `data:{MIME_type};base64,...` URL。在这些模型上,任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能在上传它的那个阿里云账号下解析;Comfy 使用自己的密钥发起模型调用,且不对外暴露上传路径,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。该字段不会校验 URL 协议,因此这类值会原样转发给合作伙伴,而不会在此处被拒绝。各模型的大小与像素限制,以及以总量方式约束内联载荷的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:可以是公共 HTTP/HTTPS URL;或者,仅针对上文 `media` 描述中为各模型列出的 IMAGE 输入,才可以是内联的 `data:{MIME_type};base64,...` URL。这些 IMAGE 输入为:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image。在上述任何模型上,video、audio、file 或 link 输入都不接受内联的 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只会对上传它的那个阿里云账号生效;Comfy 使用自己的密钥发起模型调用,并且不提供任何上传途径,因此调用方自有的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL 的协议,因此这类值会被原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的尺寸与像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中看到的内容 + 反向提示词用于描述你不想在视频画面中看到的内容。超过 500 个字符时,wan 模型会截断它,而不是拒绝该请求。它与 prompt 计入同一个输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多可到 20,000 个字符;超出限制的内容会被截断)。 -对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。 -示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等来指代 media 数组中对应顺序的媒体资产。 + 文本提示词。支持中文和英文。超过各自文档所记载的长度时,wan2.x 模型会截断提示词,而不是拒绝请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。若 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个汉字),提供商会拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,按媒体数组中的对应顺序来指代媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。1-3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 - 单个视频时长:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 同时使用 -参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频则按比例更短。 -计费:按实际使用的参考时长计算。 +参考时长:单个视频最长 5s,两个视频各最长 2.5s,三个视频按比例更短。 +计费:按实际使用的参考时长计费。 - 视频特效模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。该组件上不做约束:Comfy Router 从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方可以省略它。直接以 v1 调用 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 时则必须提供它,可接受拼写的枚举定义在该操作自己的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径片段中填充它,因此 Router 调用方会省略该字段。直接以 v1 调用 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 时则必须提供它,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 @@ -311,51 +307,52 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商没有为其他 wan 模型记录此类开关。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记载此类开关。 wan2.7-videoedit 模型的视频音频设置。 - auto(默认):模型根据提示词内容智能判断 -- origin:强制保留输入视频中的原始音频 +- origin:强制保留输入视频的原始音频 - 可能的值:`auto`、`origin` + 可选值:`auto`、`origin` - 生成视频的时长,以秒为单位: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) +- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) - wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 - wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -本代理在时长超出 [-1, 30] 时返回 400。 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,总输入视频时长 + 与输出视频时长之和不得超过 30 秒;-1 会启用智能时长模式,由模型自行选择合适的时长 +当 duration 超出 [-1, 30] 时,此代理会返回 400。 范围:`-1` 到 `30` - 是否启用提示词智能改写。默认为 true + 是否启用提示词智能改写。默认值为 true 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 +对于 wan2.7 模型,如果未提供,则根据分辨率档位取默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 - 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` - 分辨率档位。支持的值因模型而异: + 分辨率档位。支持的取值因模型而异: - wan2.5-i2v-preview:480P、720P、1080P -- wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) -- wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上游默认 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -此代理会拒绝既不提供分辨率也不提供尺寸的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将分辨率转为大写,并转发大写后的值;对于超出此枚举范围的值返回 400;并且对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,对 480P 返回 400(无论是以分辨率还是以 480P 尺寸发送)。 +- wan2.6 系列模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) +- wan2.7 系列模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) +- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在校验之前先把 resolution 转为大写并转发该大写值,对于不在该枚举范围内的取值返回 400,并且对上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型返回 400(无论是以 resolution 还是以 480P 的 size 发送)。 可选值:`480P`、`720P`、`1080P` @@ -367,28 +364,27 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 智能多镜头控制。仅在启用 prompt_extend 时生效。 -适用于 wan2.6 和 wan2.7-r2v 模型。 -- single: 单镜头视频(默认) -- multi: 多镜头视频 + 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 +- single:单镜头视频(默认) +- multi:多镜头视频 可选值:`multi`、`single` 视频分辨率,格式为 width*height。支持的分辨率因模型而异: -对于 wan2.5 T2V: 480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(无 480P): - 720P: 1280*720、720*1280、960*960、1088*832、832*1088 - 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时发送尺寸和分辨率时,尺寸决定计费档位,而分辨率仍然必须是此代理为该模型接受的值。对于分辨率描述中列为不支持 480P 的每个模型,480P 尺寸都会返回 400。 +对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +对于 wan2.6 T2V/R2V(不支持 480P): + 720P:1280*720、720*1280、960*960、1088*832、832*1088 + 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是本代理为该模型所接受的取值。对于分辨率描述中列为不支持 480P 的每个模型,480P 的 size 都会返回 400。 - 是否添加水印标志,水印位于右下角 + 是否添加水印 logo,水印位于右下角 -本页依据 Router 在 `GET /v2/models/wan/wan2.7-t2v/openapi.json` 提供的 schema 生成,该 schema 与请求到达提供商之前 Router 用来校验调用的文档为同一份。 +由 Router 在 `GET /v2/models/wan/wan2.7-t2v/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -401,7 +397,7 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 带音频生成的 I2V 任务的音频网址 + 带音频生成的 I2V 任务的音频 URL @@ -421,11 +417,11 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 图像生成任务的任务结果列表 + 图像生成任务的结果列表 - 智能改写后的实际提示词(若已启用) + 智能改写后的实际提示词(如果启用) @@ -441,7 +437,7 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 已生成图像的网址 + 生成的图像网址 @@ -475,11 +471,11 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: 任务状态 - 可能的值:`PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频网址。链接有效期为 24 小时 + 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 @@ -491,19 +487,19 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 视频分辨率档位(I2V 和 wan3.0-video 任务) + 视频分辨率级别(I2V 和 wan3.0-video 任务) - 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) + 生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) - 已生成视频的帧率(wan3.0-video 任务) + 生成视频的帧率(wan3.0-video 任务) - 已生成图像的数量(T2I 和 I2I 任务) + 生成的图像数量(T2I 和 I2I 任务) @@ -515,7 +511,7 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 已生成视频的比例,例如 16:9(wan3.0-video 任务) + 生成视频的宽高比,例如 16:9(wan3.0-video 任务) @@ -523,11 +519,11 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 已生成视频的数量(T2V 任务) + 生成的视频数量(T2V 任务) - 已生成视频的时长,单位为秒(T2V 任务) + 生成视频的时长,单位为秒(T2V 任务) @@ -535,11 +531,11 @@ URL 则确实会经过 Comfy 传输,并且还要受到传输上限的限制: - 失败请求的错误码,在响应最外层(ROOT)报告,而不是在 `output` 下(请求成功时不返回)。 + 失败请求的错误码,在响应信封的根级别报告,而不是在 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,在响应最外层(ROOT)报告,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,在响应信封的根级别报告,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此信息。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx b/zh/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx index 4983301b91..e027d38541 100644 --- a/zh/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx @@ -2,17 +2,18 @@ title: "搭配 Comfy Router 使用 Wan 2.7 Video Edit" description: "用于通过 Comfy Router 以 HTTP 方式调用 wan/wan2.7-videoedit 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果结构" sidebarTitle: "Wan 2.7 Video Edit" -translationSourceHash: 11c6064b +translationSourceHash: b970d117 translationFrom: development/comfy-router/models/wan/wan2-7-videoedit/code.mdx translationBlockHashes: "_intro": 164c9f6a "Quick start": ec8ca64c - "Schema": b7895256 + "Schema": cff0bda0 "Examples": 622d1416 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -213,117 +214,61 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-videoedit/requests/$REQUEST_ID \ - 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。 -happyhorse-1.x 的 i2v 拼写不在此处接收其首帧,而是将其作为类型为 first_frame 的媒体元素接收(见下方的 media);并且在 wan2.6-i2v 上能够成功的 img_url 请求体,会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;而 wan2.7/wan3.0 的拼写同样在 media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 -分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型为必填。happyhorse-1.x 的 i2v 拼写并不在此处接收首帧:它们将首帧作为类型为 first_frame 的媒体元素传入(见下方 media);此外,在 wan2.6-i2v 上能成功的 img_url 请求体,会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 的拼写也改为在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 -type 和 url 字段。此字段由本组件提供服务的每一个模型共享,而某个模型接受哪些 -type 值(以及它是否在此处携带其图像或视频输入,而不是在 img_url 或 -reference_video_urls 中)因模型而异。各模型支持的 type 值如下: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间, - 最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公开 HTTP/HTTPS URL;不接受内联 - data: URL。 -- wan2.7-r2v: first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要一个 reference_image 或 reference_video,且参考图像加上 - 参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (不含 alpha 通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 - 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开 - HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-videoedit: video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL) - 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL - 或 data:\{MIME_type};base64,... URL)。 -- wan3.0-video, wan3.0-video-prime: first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 - link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型 - 与 first_frame/last_frame 类型在同一请求中互斥。 - 数组顺序定义了提示词中资产的参考顺序(Image 1、Video 1、 - Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可以是公开 URL 或 - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公开 - HTTP/HTTPS URL;不接受内联 data: URL。 -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: 仅 first_frame,恰好 1 个。这些拼写 - 在此处接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 - data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: 仅 reference_image,1 到 9 个。这是 - 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video - 不是此操作的输入类型。 -- happyhorse-1.0-video-edit: video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,长边最大 4096 像素,短边至少 360 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: - URL)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可以是公开 URL - 或 data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 文生视频操作。其对应的合作伙伴参考文档未记录任何 media 输入,因此请 - 不要设置此字段。 -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 本组件未为这些拼写枚举任何 media - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首 - 帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上述按模型的计数是合作伙伴的约束,而不是本 schema 的约束:media 上没有 -声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受 -并不意味着提供商接受;反过来说,上文按资产给出的“至多 20MB”数值(图像 -输入的上限,也是唯一可以内联发送的输入)是合作伙伴对其最终收到的 -资产设定的上限;当资产是公开 URL 时,这些限制按字面适用, -因为那些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... -URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router -的 POST 请求体总计上限为 100 MiB,超出会返回 413;而 base64 会使 -负载膨胀约 4/3,因此单个内联资产超过约 75 MB 时,会在触及此处任何 -合作伙伴规则之前就被拒绝。在这种大小下,单个资产即使处于合作伙伴自身的20MB 的上限可以轻松容纳内联内容,因此对于单个资产而言,真正起约束作用的是合作伙伴规则; -而当涉及多个资产时,约束则来自传输上限,因为 100 MiB 的 Router 上限约束的是整个请求, -而不是每个元素。任何接近这些上限的内容,请都以公开 URL 的形式发送。 + 媒体资产列表。指定用于视频生成的参考材料(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由此组件提供的所有模型共用;特定模型接受哪些 type 值,以及它究竟在此处还是改为在 img_url 或 reference_video_urls 中携带其图像或视频输入,因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,并且参考图像加参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video:公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即待编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求内互斥。数组顺序决定提示词中资产的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写在此处接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即待编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记录 media 输入,因此请勿设置此字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些拼写枚举任何 media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 +上述各模型的数量是合作伙伴的限制,而不是此 schema 的限制:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不意味着提供商接受;反过来说,上文每个资产“最大 20MB”的数值(图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终获得的资产所设的上限,并且当资产为公共 URL 时按原文适用,因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... URL 确实会经过 Comfy,并且也会遇到传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过后会返回 413;base64 会使载荷增大约 4/3,因此单个内联资产若超过约 75 MB,会在触及此处任何合作伙伴规则之前被拒绝。在这种大小下,单个资产在合作伙伴自身的20MB 的上限可以轻松容纳内联数据,因此对于单个资产而言,起作用的是合作伙伴的限制;而传输上限则在存在多个资产时生效,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,都应通过公开 URL 发送。 媒体资产类型 - 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可选值:`first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` - 媒体文件的 URL:公开的 HTTP/HTTPS URL;或者,仅针对上文 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image,也可以使用内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不对外暴露任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。该字段不校验 URL 协议,因此这类值会按原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的大小和像素限制,以及从整体上约束内联载荷的 100 MiB Router 请求体上限,请参阅 `media` 描述。 + 媒体文件的 URL:一个公开的 HTTP/HTTPS URL;或者,对于上文中 `media` 描述为各个模型明确列出的那些图像输入,可以是内联的 `data:{MIME_type};base64,...` URL,具体包括:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image。这些模型上的任何 video、audio、file 或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能针对上传它的阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不对外暴露上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。该字段不校验 URL 协议,因此这样的值会被原样转发给合作伙伴,而不会在此处被拒绝。有关各模型的大小和像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中看到的内容 + 反向提示词用于描述你不希望在视频画面中出现的内容。超过 500 个字符时,Wan 模型会截断它,而不是拒绝该请求。它与 prompt 计入同一个输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等按参考视频的顺序指代主体。 -示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等按媒体数组中对应的顺序指代媒体资产。 + 文本提示词。支持中文和英文。超过各自文档规定的长度时,wan2.x 模型会截断提示词,而不是拒绝该请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。当 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符)时,提供商将拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。对于带多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等,按参考视频的顺序指代各个主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,按 media 数组中对应的顺序指代媒体资产。 仅用于 wan2.6-r2v 模型的参考视频 URL。包含 1-3 个视频 URL 的数组。 输入限制: -- 格式:mp4、mov +- 格式:mp4, mov - 数量:1-3 个视频 - 单个视频时长:2-30 秒 -- 单个文件大小:最大 30MB +- 单文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例更短。 -计费:按实际使用的参考时长计费。 +参考时长:单个视频最长 5s,两个视频各最长 2.5s,三个视频则按比例更短。 +计费:按实际使用的参考时长计算。 - 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 - 要调用的模型 ID。在本组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受拼写的枚举定义在该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不作约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 @@ -331,40 +276,38 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未记录其他 wan 模型有此类切换。 + 是否为视频添加音频。仅受 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记录此类切换。 wan2.7-videoedit 模型的视频音频设置。 -- auto(默认):模型根据提示词内容智能判断 +- auto(默认):模型根据 prompt 内容智能判断 - origin:强制保留输入视频的原始音频 - 可能的值:`auto`、`origin` + 可选值:`auto`, `origin` - 已生成视频的时长,单位为秒: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 - wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) - wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 - wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长 - 不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -此代理对超出 [-1, 30] 的时长返回 400。 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频时长与输出视频时长之和不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +该代理对超出 [-1, 30] 范围的时长返回 400。 - 范围:`-1` 到 `30` + 范围:`-1` 至 `30` - 是否启用提示词智能改写。默认为 true + 是否启用提示词智能改写。默认值为 true - 已生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,如果未提供,则根据分辨率档位确定默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图 -自动推荐合适的宽高比。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的与输入媒体的比例和意图相匹配的宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -377,39 +320,46 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P -该代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在校验前将 resolution 转为大写并转发大写后的值,对于不属于此枚举的值返回 400;对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,传入 480P 时也返回 400(无论以 resolution 还是 480P 的 size 形式传入)。 +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求, +因为分辨率档位决定计费费率。它在检查前会先将 +resolution 转为大写并转发大写后的值;对于不在该枚举范围内的值返回 400, +对于上述被列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型, +返回 400(无论以 resolution 还是 480P 的 size 形式发送)。 - 可选值:`480P`、`720P`、`1080P` + 可能的值:`480P`、`720P`、`1080P` 随机数种子,用于控制模型生成内容的随机性 - 取值范围:`0` 到 `2147483647` + 范围:`0` 至 `2147483647` - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 - single:单镜头视频(默认) - multi:多镜头视频 - 可选值:`multi`、`single` + 可能的值:`multi`、`single` - 视频分辨率,格式为 width*height。支持的分辨率因模型而异: + 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: 对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(无 480P): +对于 wan2.6 T2V/R2V(不支持 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时传入 size 和 resolution 时,size 决定计费档位,而 resolution 仍必须是该代理为该模型接受的值。若 size 为 480P,则在分辨率说明中列为不支持 480P 的每个模型上都会返回 400。 +当同时发送 size 和 resolution 时,size 决定计费档位, +并且 resolution 仍必须是本代理为该模型接受的值。对于分辨率描述中 +列为不支持 480P 的每个模型,480P 的 size 都会返回 400。 - 是否添加水印 logo,水印位于右下角 + 是否添加水印标志,水印位于右下角 -本文档根据 Router 在 `GET /v2/models/wan/wan2.7-videoedit/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/wan/wan2.7-videoedit/openapi.json` 提供的 Schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 @@ -418,7 +368,7 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 智能改写后的实际提示词(视频任务) + 智能改写后的实际提示词(用于视频任务) @@ -426,7 +376,7 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 请求失败时的错误码(请求成功时不返回) + 失败请求的错误代码(请求成功时不返回) @@ -434,15 +384,15 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 请求失败的详细信息(请求成功时不返回) + 失败请求的详细信息(请求成功时不返回) - 原始输入提示词(视频任务) + 原始输入提示词(用于视频任务) - 图像生成任务的结果列表 + 图像生成任务的任务结果列表 @@ -450,7 +400,7 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 图像错误码(部分任务失败时返回) + 图像错误代码(部分任务失败时返回) @@ -462,7 +412,7 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 已生成图像的网址 + 已生成图像的图片网址 @@ -478,15 +428,15 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 图像生成任务的结果统计 + 图像生成任务的任务结果统计 - 失败任务数量 + 失败任务数 - 成功任务数量 + 成功任务数 @@ -496,11 +446,11 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router 任务状态 - 可能的值:`PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频 URL。链接有效期 24 小时 + 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 @@ -524,11 +474,11 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 已生成图像数量(T2I 和 I2I 任务) + 已生成图像的数量(T2I 和 I2I 任务) - 输入视频的时长,单位为秒,没有视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) @@ -544,7 +494,7 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 已生成视频数量(T2V 任务) + 已生成视频的数量(T2V 任务) @@ -556,11 +506,11 @@ URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router - 请求失败时的错误码,在信封的根层级返回,而不是在 `output` 下(请求成功时不返回)。 + 失败请求的错误代码,报告在响应信封的根层级,而不是在 `output` 下(请求成功时不返回)。 - 请求失败的详细信息,在信封的根层级返回,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,报告在响应信封的根层级,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此项。 ## 示例 diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index a7baf0250b..54b8b9ebe7 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 参考" description: "每个 Comfy Router 端点、参数、响应体和错误分类,均由 Comfy API 契约生成。" sidebarTitle: "API 参考" -translationSourceHash: e2c5f523 +translationSourceHash: f49adc91 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 @@ -12,7 +12,7 @@ translationBlockHashes: "Pre-flight cost estimates": 7405db0d "Result assets": 3520a8bf "Per-model input and output schemas": 61c6bde8 - "Schemas": 663ae766 + "Schemas": 9738e3aa --- @@ -28,6 +28,7 @@ translationBlockHashes: + {/* 生成的文件:请勿手动编辑。 @@ -1100,7 +1101,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ ### RouterBilledWorkspace -被拒绝的调用原本会扣费的钱包,位于 `RouterErrorResponse.billed_workspace` 上。它回答的是“哪个钱包是空的?”这个问题,并不一定就是调用方 UI 当前已选择的工作区;而且,即使当前打开的是一个有充足余额的团队,团队成员使用个人凭据时,这里命名的仍是其个人钱包。仅在同时存在 `denied_reason` 时才会出现。 +被拒绝的调用原本会扣费的钱包,位于 `RouterErrorResponse.billed_workspace`。它回答的是“哪个钱包是空的?”这一问题:它不一定是调用方 UI 当前已选择的工作区,而且团队成员使用个人凭证时,即使已打开一个有余额的团队,这里列出的仍是其个人钱包。仅在同时存在 `denied_reason` 时出现。 **字段** @@ -1109,27 +1110,27 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ - `personal` 或 `team`。这是一个开放字符串:其他任何值都应按个人处理。 + `personal` 或 `team`。这是一个开放字符串:遇到任何其他值都按个人处理。 - 当调用计费到调用方在工作区出现之前的 Metronome 客户,而不是计费到某个云端工作区时,为 `legacy`;该客户没有工作区 id。对于云端工作区则不存在。 + 当调用计费到调用方在工作区出现之前的 Metronome 客户、而非云端工作区时,为 `legacy`;该客户没有工作区 id。对于云端工作区,此字段不存在。 ### RouterChargesOnPolicyRejection -该模型的内容策略拒绝是否计费。将未知值视为可能计费。 +此模型的内容策略拒绝是否计费。未知值按可能计费处理。 类型:`string` ### RouterCostEstimate -这是对本次调用将要产生费用的预先估算,单位为美元。它在分发之前定价:按 Comfy 的标准列表价格,或者对于按供应商报告的费用计费的模型,则依据供应商公布的价格表。对于这种由供应商报告的情况,`source: exact` 仅针对一小部分选择加入的模型返回,且仅当公布的价格表完全确定该数字时才返回(每个影响价格的字段都已明确给出,或保留在无法改变该数字的默认值上);其他所有由供应商报告的报价都是 `estimated`,包括其中一些价格表本可完全确定的情况。无论哪种情况,运行结束后仍按供应商报告的金额计费,绝不会原样按报价金额收费。它不反映合同价格或客户特定费率:已协商定价的工作区会按列表价格报价,并按合同费率收费,此时 `source: exact` 表示在列表价格上是精确的,而不是该工作区的实际收费。它不是最终收费:你工作区用量和账单记录中的结算收费才是你实际支付的费用。运行后报告的 `X-Comfy-Credits-Used` 是四舍五入的事后数字,不是收据。`source` 表示该数字的可信度:`exact` 携带 `amount`;`free` 携带 `amount` "0"(费率卡将本次请求定价为零);`estimated` 携带 `min_amount` 和 `max_amount`,不带 `amount`;`unknown` 两者都不带,并带一个 `reason`。切勿将缺失的 `amount` 理解为免费。它不是价格锁定:请参阅 `pricing_as_of`。 +调用前的预检估算,用于说明本次调用的费用(以美元计):在调度前按 Comfy 标准标价计价;对于按提供商报告的费用计费的模型,则取自提供商公布的价目表。对于这种由提供商报告费用的情形,仅在少量已选择加入的模型上返回 `source: exact`,并且仅当公布的价目表完全确定该金额时(每个影响价格的字段都已明确给出,或保留在不会改变该金额的默认值);其余所有由提供商报告的报价都是 `estimated`,其中也包括一些价目表本可完全确定的报价。无论哪种情况,运行完成后仍按提供商报告的费用计费,绝不会原样按报价金额收费。它不反映合同费率或客户特定费率:有协商定价的工作区会按标价报价,但按其合同费率收费,此时 `source: exact` 表示按标价精确,而非该工作区的实际收费。它不是最终费用:你支付的是工作区用量和账单记录中的结算费用。运行后报告的 `X-Comfy-Credits-Used` 是四舍五入的事后数字,不是收据。`source` 表示该数字的可信程度:`exact` 携带 `amount`;`free` 携带 `amount` "0"(费率卡将此请求计价为零);`estimated` 携带 `min_amount` 和 `max_amount`,不携带 `amount`;`unknown` 两者都不携带,并携带 `reason`。切勿将缺失的 `amount` 理解为免费。它不是价格锁定:见 `pricing_as_of`。 **字段** - `exact` | `estimated` | `free` | `unknown`;其他任何值都按 `unknown` 读取。`exact` 和 `estimated` 标记的都是估算值;两者都不是最终扣费。`free` 表示费率卡将本次请求定价为零,因此 `amount` 为 "0"。`unknown` 不带任何数字。 + `exact` | `estimated` | `free` | `unknown`;其他任何值都按 `unknown` 处理。`exact` 和 `estimated` 都表示估算;两者都不是最终费用。`free` 表示费率卡将此请求计价为零,因此 `amount` 为 "0"。`unknown` 不携带任何金额。 @@ -1137,152 +1138,151 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ - 估算费用,以美元计的十进制字符串,例如 "0.04",最多 8 位小数且不含指数。可计费的不足一美分的价格绝不会渲染为 "0";只有 `free` 的报价才读作 "0"。仅当 `source` 为 `exact` 或 `free` 时出现。它不是最终扣费:工作区用量与账单记录中的结算金额才是。 + 预估费用,以美元表示,为十进制字符串,例如 "0.04",最多 8 位小数且不使用指数。可计费的低于 1 美分的价格绝不会显示为 "0";只有 `free` 报价显示 "0"。仅在 `source` 为 `exact` 或 `free` 时出现。它不是最终费用:最终费用是工作区用量和账单记录中的结算费用。 - 估算值的下限,以美元计的十进制字符串。它是估算值,不是保证的下限:调用可能被计费更少,例如当提供商返回的内容少于请求所需(比如没有返回任何图像)、当估算值是根据过往调用学到的典型价格,或当价格不随请求的数量稳定上升时。仅当 `source` 为 `estimated` 时出现。 + 预估金额的下限,以美元表示,为十进制字符串。它只是估算,不是保证下限:调用实际收费可能更低,例如提供商返回的数量少于请求(例如没有返回图像)、估算值是根据过往调用学习到的典型价格,或价格未随请求数量稳定上升。仅在 `source` 为 `estimated` 时出现。 - 估算值的上限,以美元计的十进制字符串。它是估算值,不是保证的上限:调用可能被计费更多,例如当提供商返回的内容多于请求所需(比如返回的图像多于请求数量)、当估算值是根据过往调用学到的,或当价格不随请求的数量稳定上升时。仅当 `source` 为 `estimated` 时出现。 + 预估金额的上限,以美元表示,为十进制字符串。它只是估算,不是保证上限:调用实际收费可能更高,例如提供商返回的数量多于请求(例如返回的图像数量超过请求数量)、估算值是根据过往调用学习得到的,或价格未随请求数量稳定上升。仅在 `source` 为 `estimated` 时出现。 - 同一数字以美分表示,不取整,用于算术运算。与 `amount` 一同出现。 + 同一金额以美分表示,不四舍五入,供计算使用。与 `amount` 一同出现。 double - `min_amount` 以美分表示,不取整。与 `min_amount` 一同出现。 + `min_amount` 对应的美分金额,不四舍五入。与 `min_amount` 一同出现。 double - `max_amount` 以美分表示。与 `max_amount` 一同出现。 + `max_amount` 对应的美分金额。与 `max_amount` 一同出现。 double - `amount` 按平台换算($1 = 211 积分)折算为 Comfy 积分,四舍五入到 2 位小数,即 `exact` 报价下 `X-Comfy-Credits-Used` 预期携带的数字。该响应头是四舍五入的事后数字,不是收据;工作区用量与账单记录中的结算金额才是最终结果。 + `amount` 按平台换算比例($1 = 211 积分)折算成的 Comfy 积分,四舍五入到 2 位小数,也就是在 `exact` 报价下 `X-Comfy-Credits-Used` 预期携带的数值。该响应头是四舍五入的事后数字,不是收据;工作区用量和账单记录中的结算费用才是最终费用。 double - 本报价对应的提供商分支。在排队提交中,它就是要运行的那个分支。 + 此报价对应的提供商线路。对于已排队的提交,它就是将要运行的线路。 - 规范的 Comfy Router 模型 ID,格式为 `{provider}/{model}`,正是用于在 `POST /v2/models/{provider}/{model}` 上寻址该模型的那个值,因此调用方可以直接把它插入该路径,而无需从任何其他内容重新推导。它的 `pattern` 由 `RouterProviderSegment` 和 `RouterModelSegment` 以单个 `/` 连接而成,`maxLength` 为两者长度之和再加上这个分隔符。 + 规范的 Comfy Router 模型 ID,`{provider}/{model}`,正是用于在 `POST /v2/models/{provider}/{model}` 上定位该模型的值,因此调用方可以将其插入该路径,而无需从其他任何内容重新推导。其 `pattern` 为 `RouterProviderSegment` 和 `RouterModelSegment` 以单个 `/` 连接,`maxLength` 为二者长度之和再加上该分隔符。 - 类型:[`RouterModelId`](#routermodelid):模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 + 类型:[`RouterModelId`](#routermodelid),模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 - 本报价所依据的费率卡的获取时间。估算值不是价格锁定:运行按计费时生效的费率收费,而不是按这一时刻的费率。从供应商公布的价格表取得的 `estimated` 报价(按供应商报告的费用计费的模型)改为携带读取该价格表的日期;而计费数量由供应商公布的调度表预测、再按费率卡定价的报价,无论给出的是 `exact` 还是 `estimated` 答案,都携带该调度表的读取日期与费率卡获取时间中较早的一个(按供应商报告的积分计费的模型属于 `estimated` 情形)。只要没有读取任何费率卡(`reason: pricing_unavailable`、`byok`,或无法从任何卡定价的 `not_quotable` 调用),它就是回答该报价的时间。 + 此报价所依据的费率卡的获取时间。该估算不是价格锁定:运行会按计费时生效的费率收费,而不是按此时间点的费率。从提供商公布的价目表取得的 `estimated` 报价(即按提供商报告的费用计费的模型)则携带读取该价目表的日期。如果报价的计费数量是根据提供商公布的费率表预测得出,然后再按费率卡计价,则该报价携带该费率表读取日期与费率卡获取时间中较早的一个;`exact` 和 `estimated` 结果都是如此(按提供商报告的积分计费的模型属于 `estimated` 情况)。如果没有读取任何费率卡(`reason: pricing_unavailable`、`byok`,或无法根据任何费率卡计价的 `not_quotable` 调用),则此时间为报价答复的时间。 date-time - - 仅当 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在运行前为本次调用定价:其价格取决于提供商回报的内容,或者请求体没有界定出计费数量)、`unpriced_model`(费率卡未对本次请求定价)、`byok`(仅排队提交:运行使用你自己的提供商密钥,因此 Comfy 不为其计费),或 `pricing_unavailable`(仅排队提交:请求被准入时无法读取费率卡;这是暂时性的,运行仍照常计费)。其他任何值都按 `not_quotable` 读取。 +仅在 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在运行之前为本次调用定价,因为其价格取决于提供商回传的内容,或者请求体未限定计费数量)、`unpriced_model`(费率卡片未对本次请求定价)、`byok`(仅限已执行提交:该运行使用你自己的提供商密钥,因此 Comfy 不为其计费)、或 `pricing_unavailable`(仅限已执行提交:在请求被接纳时无法读取费率卡片;这是暂时性的,该运行仍照常计费)。其他任何值均按 `not_quotable` 理解。 ### RouterErrorResponse -用于身份验证、访问、模型查找、配额以及提供商传输失败的错误响应体。 +用于认证、访问、模型查找、配额以及提供商传输失败的错误响应体。 **字段** - 人类可读的失败描述,可以安全地展示给最终用户。不要对其做机器解析,而应改为根据 `error_type` 分支。对于已停用模型上的 `model_not_found`,当记录了后继模型且对调用方可见时,`detail` 会显示 ` was retired on ; use `;否则只显示 ` was retired on `,而不是通常的建议列表。此处指定的后继模型始终是一个有效目录 ID,调用可以重新指向它。停用日期尚在未来的模型不算已停用:在到达该日期之前,它仍会出现在 `GET /v2/models` 中并可继续运行。与 `detail` 的其余内容一样,这段停用措辞仅用于展示,不附带任何兼容性保证。不对其做机器解析这一规则有两个有文档记录的例外:在 `POST /v2/models/{provider}/{model}` 上,`409` 会因三种互不相关但同属 `invalid_input` 分类的情况而返回,且只有 `detail` 能区分它们。以“this request's `image` selects the edit operation”开头的 `detail` 是 multipart `model_provider` 拒绝,以 `this request resolved a BYOK credential` 开头的 `detail` 是 BYOK `model_provider` 拒绝;两者都无法通过新的 `Idempotency-Key` 消除。该路由上任何其他 `invalid_input` 的 `409` 都是密钥冲突。这两个前缀都是稳定的合约术语,可以进行匹配。在其他任何地方,基于 `detail` 分支都不提供兼容性保证。 + 人类可读的失败描述,可安全地展示给最终用户。它不用于机器解析:请改为根据 `error_type` 分支。对于已退役模型上的 `model_not_found`,当记录的后继模型存在且对调用方可见时,`detail` 显示为 ` was retired on ; use `;若不可见,则只显示 ` was retired on `,而不是通常的建议列表。此处给出的后继模型始终是目录中的有效 ID,调用可以重新指向它。停用日期仍在未来的模型不算已退役:它仍会由 `GET /v2/models` 列出,并在此日期之前保持可运行。与 `detail` 的其余部分一样,这段退役措辞仅用于展示,不附带任何兼容性保证。“不用于机器解析”这条规则有两个已记录的例外:在 `POST /v2/models/{provider}/{model}` 上,`409` 会因三种互不相关但同属 `invalid_input` 分类的情况而返回,只有 `detail` 能区分它们。以 "this request's `image` selects the edit operation" 开头的 `detail` 是 multipart 的 `model_provider` 拒绝,以 `this request resolved a BYOK credential` 开头的 `detail` 是 BYOK 的 `model_provider` 拒绝;两者都不会因为新的 `Idempotency-Key` 而消除。该路由上其他任何 `invalid_input` 的 `409` 都是键冲突。这两个前缀都是稳定的契约条款,可以被匹配。除此之外,任何地方根据 `detail` 分支都不带兼容性保证。 - Router 故障的粗粒度、机器可读分类,会同步到 `X-Comfy-Error-Type` 响应头,以便调用方无需解析响应体即可分支。该集合封闭为二十个值:六个请求级分类 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`,以及传输级的 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full` 和 `result_expired`。“封闭”描述的是当前文档所记录的状态,而不是一个永远成立的限制:该集合预计会增长,因此这里特意使用普通字符串而非 `enum`,客户端必须将无法识别的值视为 `internal_error`,而不是对上述列表做穷举式 switch 并在下一次新增时出错。 + Router 失败的粗粒度、机器可读分类,会同步到 `X-Comfy-Error-Type` 响应头,使调用方无需解析响应体即可分支。该集合封闭于二十个值:六个请求级分类 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`,以及传输级分类 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full` 和 `result_expired`。“封闭”描述的是当前文档中的集合,而不是永远成立的界限:该集合预计会增长,这正是它被刻意定义为普通字符串而非 `enum` 的原因,因此客户端必须将无法识别的值当作 `internal_error` 处理,而不是对上面的列表做穷举 switch,从而在下一次新增值时出错。 类型:[`RouterErrorType`](#routererrortype) - 模型提供商给出的、有长度限制且经过脱敏的拒绝请求原因,仅在 `error_type` 为 `invalid_input` 且 `X-Comfy-Upstream-Status` 为提供商的 `4xx` 或 `2xx` 时出现,即提供商以请求格式错误为由拒绝请求并说明了原因。通常该状态是 `4xx`;对于在成功信封内报告生成被拒绝的提供商,则为 `2xx`(BytePlus 的失败任务轮询是 HTTP `200`,原因位于响应体中)。在其他所有失败情形中均不出现,包括提供商 `5xx`、传输失败、内容策略拒绝以及 Router 自身提出的任何拒绝。它与 `X-Comfy-Upstream-Detail` 头对应。 + 模型提供商拒绝该请求时给出的、经过净化的长度受限原因,仅在 `error_type` 为 `invalid_input` 且 `X-Comfy-Upstream-Status` 为提供商的 `4xx` 或 `2xx` 时出现,即提供商认为请求格式有误而拒绝了请求并说明了原因。通常该状态是 `4xx`;对于在成功信封内报告生成被拒绝的提供商,它是 `2xx`(BytePlus 的失败任务轮询是 HTTP `200`,原因在响应体中)。在其他所有失败中都不存在,包括提供商 `5xx`、传输失败、内容策略拒绝以及 Router 针对自身提出的任何拒绝。它会同步到 `X-Comfy-Upstream-Detail` 响应头。以 `invalid_input` 结束的运行,其已执行收集(`GET /v2/models/{provider}/{model}/requests/{request_id}`)在第一次收集时会在该字段中带上同样的原因,随后便把它从请求中删除:之后的收集通常返回相同的 `error_type` 和 `detail` 但不包含该字段,因此请从第一次收集中读取。该次收集不会发送这两个响应头。 - 内容策略拒绝所针对的输入或输出,采用 Router 层面的封闭词汇表:`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio`。当提供商未指明模态时,仅用 `input` / `output` 值来表示是哪一侧。仅当 `error_type` 为 `content_policy_violation` 且提供商使用机器可读代码指明了被拒绝的对象时出现;否则不出现。绝不是提供商文本。目前会为 BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI 和 Wan 的拒绝给出该字段,也会为 MiniMax Router 的 Nano Banana 链路中的 Gemini 拒绝给出该字段;如果提供商的拒绝未说明涉及哪一侧,则该字段不出现。它与 `X-Comfy-Refusal-Subject` 头对应。 + 内容策略拒绝所针对的输入或输出,采用 Router 级的封闭词表:`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio`。当提供商未指明模态时,裸的 `input` / `output` 值用于指明是哪一侧。仅在 `error_type` 为 `content_policy_violation` 且提供商以机器可读代码指明了被拒绝对象时出现;否则不存在。绝不是提供商的文本。目前对 BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI 和 Wan 的拒绝会给出该字段,MiniMax Router 的 Nano Banana 分支中的 Gemini 拒绝也会给出;若提供商的拒绝未说明涉及哪一侧,则该字段不存在。它会同步到 `X-Comfy-Refusal-Subject` 响应头。 - 计费系统针对合作伙伴节点支出拒绝的策略分支:当被计费钱包为空时为 `no_funds`,当调用被拒绝但没有资金读取结果说明原因时为 `unspecified`。仅当 `error_type` 为 `insufficient_credits` 且部署上报钱包相关信息时出现;否则不出现。它是机器可读代码,而非展示文本:请展示 `detail`,并基于此字段分支。 + 计费系统对合作伙伴节点扣费拒绝的策略分支:当被计费钱包为空时为 `no_funds`,当调用被拒绝但没有资金读取结果说明原因时为 `unspecified`。仅在 `error_type` 为 `insufficient_credits` 且部署会上报钱包信息时出现;否则不存在。它是机器可读代码,而非展示文本:展示 `detail`,根据该字段分支。 - 被拒绝调用原本会扣款的钱包,位于 `RouterErrorResponse.billed_workspace`。它回答“哪个钱包为空?”这个问题:它不一定是调用方 UI 当前选择的工作区,而且即使当前打开的是资金充足的团队,团队成员的个人凭证在这里也会指向其个人钱包。仅与 `denied_reason` 一同出现。 + 被拒绝的调用原本会扣费的钱包,位于 `RouterErrorResponse.billed_workspace`。它回答“哪个钱包是空的?”:它不一定是调用方 UI 当前选择的工作区,而且团队成员使用个人凭据时,这里给出的是其个人钱包,即使当前打开的是一个余额充足的团队。仅在 `denied_reason` 同时存在时出现。 类型:[`RouterBilledWorkspace`](#routerbilledworkspace) - 被拒绝请求的身份验证方式:`personal_api_key`、`team_api_key`、`personal_session` 或 `team_session`。它回答“我应该切换到哪个凭证,才能向另一个钱包计费?”这个问题。它不是权限,也不授予任何权限。仅与 `denied_reason` 一同出现。 + 被拒绝的请求是如何认证的:`personal_api_key`、`team_api_key`、`personal_session` 或 `team_session`。它回答“我该切换到哪个凭据来向另一个钱包计费?”。它不是权限,也不授予任何权限。仅在 `denied_reason` 同时存在时出现。 ### RouterErrorType -机器可读的 Router 错误类别,同时也会在 `X-Comfy-Error-Type` 响应头中发送。 +机器可读的 Router 错误类别,也会通过 `X-Comfy-Error-Type` 请求头一起发送。 类型:`string` ### RouterModelBilling -调用模型前需要检查的计费行为。它不包含价格或用量信息。 +调用模型之前需要检查的计费行为。不包含价格或用量信息。 **字段** - 该模型因内容政策原因拒绝的调用,是否仍向调用方计费。不同提供商的处理方式不同,而这种差异在调用时是不可见的,用户如果同一次调用既看到错误又看到扣费,根本无从预先得知。因此这里按模型逐个说明,而不是留待各提供商自行口口相传。当值为 `yes` 时,同步路由上的 `content_policy_violation` 错误可能会携带 `X-Comfy-Credits-Used`:当提供商拒绝了模型生成的输出,且 Comfy 为该次被拒绝的生成记录了用量时,就会携带该响应头,并给出相应的数量。输入端拒绝、同键重放(`Idempotent-Replayed: true`)以及金额过小、无法在响应头的两位小数中显示的扣费都不会携带它;没有该响应头的拒绝不会被报告,但这并不能证明它是免费的。 + 当模型因内容政策原因拒绝某次调用时,该调用是否仍向调用方计费。各提供商的做法并不相同,而这种差异在调用时是不可见的:用户在同一次调用中同时看到错误和扣费,也无从预先得知,因此这一行为在调用之前按模型明确说明,而不是留给各提供商口口相传。当该值为 `yes` 时,同步路由上的 `content_policy_violation` 错误可能带有 `X-Comfy-Credits-Used`:当提供商拒绝了模型已生成的输出,且 Comfy 记录了该次被拒绝生成的用量时,就会带有该响应头,其值为对应的数量。输入侧的拒绝、同一密钥的重放(`Idempotent-Replayed: true`),以及小到无法在该响应头的两位小数中体现的扣费,都不会带有它;不带该响应头的拒绝只是未报告,并不代表它是免费的。 类型:[`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -单个 Comfy Router 模型的逐模型详情:既包含目录列表为该模型报告的全部内容,也包含只有单模型路由才会携带的逐模型字段。 +针对一个 Comfy Router 模型的逐模型详细信息:包含目录列表为其报告的全部内容,以及只有单模型路由才会携带的逐模型字段。 -组合了 [`RouterModelListEntry`](#routermodellistentry) 与 [`RouterModelDetailFields`](#routermodeldetailfields)。 +组合了 [`RouterModelListEntry`](#routermodellistentry) 和 [`RouterModelDetailFields`](#routermodeldetailfields)。 类型:`object` ### RouterModelDetailFields -模型详情端点返回的可选字段。 +由模型详情端点返回的可选字段。 **字段** - 此模型的 OpenAPI 文档 URL,包括其输入和输出 schema。 + 此模型的 OpenAPI 文档 URL,包含其输入和输出 schema。 HTTPS URL,例如 `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`,最多 2048 个字符 ### RouterModelId -在 `POST /v2/models/{provider}/{model}` 中使用的模型 ID。 +用于 `POST /v2/models/{provider}/{model}` 的模型 ID。 -类型:`string`,模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符。 +类型:`string`,模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 ### RouterModelInput -模型输入对象。请阅读已选择模型的 OpenAPI 文档以了解字段和验证。 +模型输入对象。阅读已选择模型的 OpenAPI 文档,了解字段和验证。 -类型: `object` +类型:`object` ### RouterModelInputSchemaDocument -描述单个模型输入与输出的独立 OpenAPI 文档。 +一份独立的 OpenAPI 文档,描述单个模型的输入和输出。 类型:`object` @@ -1293,21 +1293,21 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ **字段** - 规范的 Comfy Router 模型 ID,格式为 `{provider}/{model}`,其值正是在 `POST /v2/models/{provider}/{model}` 上寻址该模型时所使用的值,因此调用方可以把它直接插入该路径,而无需从其他信息重新推导。它的 `pattern` 由 `RouterProviderSegment` 与 `RouterModelSegment` 以单个 `/` 连接而成,`maxLength` 为两者长度之和再加上该分隔符。 + 规范的 Comfy Router 模型 ID,`{provider}/{model}`,正是用于在 `POST /v2/models/{provider}/{model}` 上定位该模型的值,因此调用方可以直接把它插入该路径,而无需再从任何来源重新推导。它的 `pattern` 是由单个 `/` 连接的 `RouterProviderSegment` 与 `RouterModelSegment`,`maxLength` 则是两者长度之和再加上该分隔符。 - 类型:[`RouterModelId`](#routermodelid),模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 + 类型:[`RouterModelId`](#routermodelid),即模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写 `provider` 段,即被寻址模型所属的合作伙伴。调用路由的 `provider` 路径参数与目录条目的 `provider` 字段都引用这同一个 schema,这正是所列出的 ID 与所接受的 ID 不会彼此偏离的原因。 + 规范 `{provider}/{model}` 模型 ID 中小写的 `provider` 段,即所定位模型所属的合作伙伴。调用路由的 `provider` 路径参数与目录条目的 `provider` 字段都引用这同一个 schema,正是这一点让列出的 ID 与接受的 ID 不会逐渐偏离。 - 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字短标识,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment),即字母数字 slug,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写 `model` 段,即在该提供商下要运行的模型。调用路由的 `model` 路径参数与目录条目的 `model` 字段共用它,原因与 `RouterProviderSegment` 相同,同样是为了避免偏离。 + 规范 `{provider}/{model}` 模型 ID 中小写的 `model` 段,即在该提供商下要运行的模型。调用路由的 `model` 路径参数与目录条目的 `model` 字段共用它,原因与 `RouterProviderSegment` 相同,同样是为了避免偏差。 - 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),即字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 @@ -1317,7 +1317,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ - 该模型 `GET /v2/models/{provider}/{model}/openapi.json` 文档当前的强 `ETag`。在该读取请求中把它作为 `If-None-Match` 发送,若 schema 未变即可得到 `304`;也可以把它与上一次看到的值比较,从而无需抓取每个文档就能得知哪些模型的 schema 发生了变化。当此刻该读取对该调用方不会返回 `200` 时,该字段缺省:schema 服务不可用、该模型的文档无法渲染,或该模型在响应构建期间对此调用方变为不可用。标签缺省并不代表 schema 发生了变化;重新读取该模型的文档即可获知其当前标签。 + 该模型 `GET /v2/models/{provider}/{model}/openapi.json` 文档当前的强 `ETag`。在该读取请求中把它作为 `If-None-Match` 发送,可在 schema 未变化时得到 `304`;也可以把它与上次见到的值比较,从而无需获取每份文档就能得知哪些模型的 schema 发生了变化。只要该读取在此刻对这位调用方不会返回 `200`,该字段就缺失:schema 服务不可用、该模型的文档无法渲染,或者在响应构建期间该模型对这位调用方变为不可用。标签缺失并不代表 schema 发生了变化;请重新读取该模型的文档以获知其当前标签。 ### RouterModelListResponse @@ -1327,30 +1327,30 @@ Router 模型目录中的一页。 **字段** - 本页包含的模型,最多 `limit` 个。 + 本页中的模型,最多 `limit` 个。 类型:由 [`RouterModelListEntry`](#routermodellistentry) 组成的数组 - 本页之后是否还有下一页。只要该值仍为 true 就继续遍历;不要因为 `data` 很短或为空就推断目录已经结束。 + 本页之后是否还存在另一页。只要该值为 true,就继续遍历;不要因为 `data` 较短或为空就推断目录已经结束。 - 指向 Router 列表的不透明游标。它由服务器生成,只用于原样回传:它不是偏移量,不是模型 ID,没有顺序,也不会在目录重建后保持稳定,因此解析它、对它做自增,或在产生它的那次遍历之外持久化它,都属于约定之外的做法。之所以使用游标而不是偏移量,是因为目录是一个不断变化的列表。当遍历过程中有条目被添加或删除时,偏移量遍历会静默地跳过或重复条目,而调用方无法察觉这一点。 + 指向 Router 列表的不透明游标。它由服务器生成,并且只会原样往返传递:它既不是偏移量,也不是模型 ID,既不保证有序,也不会在目录重建后保持稳定。因此,解析游标、递增游标,或在产生该游标的那次遍历之外持久化游标,都不在约定范围内。这里使用游标而不是偏移量,是因为目录是一个不断变化的列表:如果在遍历中途添加或删除条目,偏移量遍历会静默跳过或重复条目,而调用方无法察觉是否发生了这种情况。 - 类型:[`RouterPageCursor`](#routerpagecursor)。以 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 + 类型:[`RouterPageCursor`](#routerpagecursor)。作为 `next_cursor` 返回的不透明游标,1–512 个字符 - 实际提供的分页大小。若请求的 `limit` 超过上限,会被限制为上限值而不是被拒绝,因此该值可能小于所请求的值。请用这个数字而不是你发送的数字来分页,否则你会以为收到了实际上并未返回的行。 + 实际提供的页大小。请求的 `limit` 超过最大值时会被限制到最大值,而不是被拒绝,因此该值可能小于所请求的值:请使用这个数字进行分页,而不是使用你发送的数字,否则你会误以为自己收到了实际未收到的条目。 1–100 ### RouterModelOutput -模型结果对象。要了解其确切形状,请阅读所选模型的输出 Schema。 +模型结果对象。请阅读所选模型的输出 Schema 以了解其确切形状。 类型:`object` @@ -1358,158 +1358,158 @@ Router 模型目录中的一页。 `{provider}/{model}` 模型 ID 中的模型部分。 -类型:`string`。字母数字组成的 slug,例如 `claude-opus-4-6`,最多 128 个字符 +类型:`string`,字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 ### RouterPageCursor -不透明的目录游标。将其原样作为 `cursor` 传回。 +一个不透明的目录游标。请将其原样传回,作为 `cursor`。 -类型:`string` -- 作为 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 +类型:`string`。作为 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 ### RouterProviderSegment `{provider}/{model}` 模型 ID 中的提供商部分。 -类型:`string` -- 字母数字 slug,例如 `anthropic`,最多 64 个字符 +类型:`string`,由字母和数字组成的 slug,例如 `anthropic`,最多 64 个字符 ### RouterQueueCancelResponse -此响应用于回答针对此路由已处理请求的两种状态(`202` 和 `409`)所发起的取消请求。两种状态共用同一种响应体形状,而不是分别使用成功信封和错误信封,因为两者表达的是同一件事:取消操作发现了什么。让客户端必须按不同状态码解析不同类型,并不能从这种拆分中获得任何好处。 +对于描述此路由已处理的请求的两种状态,即 `202` 和 `409`,这是对取消请求的响应。两种状态共用同一种响应体形状,而不是一个成功信封加一个错误信封,因为两者表达的是同一件事:取消操作发现了什么。客户端如果必须按不同状态码解析不同类型,这种拆分不会带来任何好处。 **字段** - 一个已排队 Router 请求的标识符:调用方通过该句柄轮询、取消并获取结果。 + 一个已排队 Router 请求的标识符,即调用方用于轮询、取消和收集结果的句柄。 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 - 取消请求所发现的结果,适用于描述此路由实际处理过的请求的两种结果。两者都会反映在 HTTP 状态中,因此客户端可依据任一者进行分支。 + 取消请求发现的结果,对应描述此路由实际已处理请求的两种结果。两者都由 HTTP 状态码镜像反映,因此客户端可以任选其一进行分支判断。 类型:[`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -取消请求所发现的内容,用于描述此路由实际已处理的请求的两种结果。两者都会在 HTTP 状态中体现,因此客户端可以任选其一作为分支依据。 +表示取消请求所发现的结果,对应两种描述此路由实际处理的请求的结果。两者都会通过 HTTP 状态码反映,因此客户端可以任选其一进行分支判断。 -类型:`string` +类型:`字符串` ### RouterQueuePosition -在响应生成的那一刻,队列中有多少请求排在此请求之前。零表示此请求位于队首。 +响应生成的那一刻,该请求在队列中前面还有多少个请求。零表示该请求位于队首。 -类型:`integer`,至少为 0 +类型:`integer` -- 至少为 0 ### RouterQueueRequestId -一个已排队 Router 请求的标识符,即调用方用于轮询、取消并收集结果的句柄。 +一条排队中的 Router 请求的标识符,即调用方用于轮询、取消并取回结果的句柄。 类型:`string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 ### RouterQueueStatus -排队中的 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这一个是有封闭取值集合的 `enum`,因为这两个 schema 被有意设计成朝相反方向封闭。`RouterErrorType` 对失败进行分类,其集合预期会增长,因此一个硬性拒绝无法识别分类的已生成客户端,恰恰会在已经出错的时候失败得最严重。这一个描述的是生命周期,而生命周期若在以后新增第四种状态,无论是否声明为 enum,都会成为针对它编写的每个轮询循环的破坏性变更。因此它被声明为 enum,并把这一约束写在客户端可以看到的地方。 +队列中 Router 请求的状态。它恰好有三个值,而且与 `RouterErrorType` 不同,这是一个封闭的 `enum`,因为这两个 schema 有意朝相反方向封闭。`RouterErrorType` 用于对失败进行分类,其集合预计会增长,因此如果生成的客户端硬性拒绝无法识别的分类桶,它恰恰会在已经出现问题的时候失败得最严重。这个 schema 描述的是生命周期;如果之后为生命周期增加第四种状态,那么无论是否将其声明为 enum,都会对针对它编写的每个轮询循环造成破坏性变更,因此它被声明为 enum,并且该约束会在客户端可以看到的位置说明。 类型:`string` ### RouterQueueStatusFields -`RouterQueueStatusResponse` 中不属于 URL 块的那另一半:一个已入队请求的身份标识、它当前的状态,以及(当该状态为终端且本次运行未成功时)说明原因的粗粒度分类。 +`RouterQueueStatusResponse` 中除 URL 块之外的另一半:一个已排队请求的身份、它当前的状态,以及在该状态为终端且运行未成功时,说明原因所在的粗粒度分类桶。 **字段** - 一个已入队 Router 请求的标识符:调用方通过它来轮询、取消并获取结果。 + 一个已排队的 Router 请求的标识符,即调用方用于轮询、取消并收集结果的句柄。 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 - 一个已入队 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这个类型是封闭的 `enum`,因为这两个 schema 是被有意设计成朝相反方向封闭的。`RouterErrorType` 用于对失败进行分类,其取值集合预期会增长,因此一个会硬性拒绝无法识别分类的已生成客户端,恰恰会在已经出问题时失败得最严重。而这个是生命周期,日后若为其添加第四种状态,无论是否声明为 enum,都会构成对基于它编写的每一个轮询循环的破坏性变更。因此它被声明为 enum,并把这一约束写在客户端能看到的地方。 + 已排队的 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这一项是封闭的 `enum`,因为这两个 schema 被有意设计成朝相反的方向封闭。`RouterErrorType` 用于对失败进行分类,其集合预期会增长,因此,如果生成的客户端硬性拒绝无法识别的分类桶,那么它恰恰会在已经出错的时候失败得最严重。而这一项是生命周期,日后新增第四种状态对每一个针对它编写的轮询循环都是破坏性变更,无论它是否被声明为 enum。因此它被声明为 enum,并在客户端能看到的地方明确说明这一约束。 类型:[`RouterQueueStatus`](#routerqueuestatus) - 在响应组装完成的那一刻,队列中有多少个请求排在该请求之前。零表示该请求位于队首。 + 在响应组装的那一刻,队列中有多少个请求排在这一请求之前。零表示该请求位于队首。 - 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少为 0 + 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少 0 - 仅出现在未成功的 `COMPLETED` 请求上,携带的粗粒度分类与读取结果在返回该失败时写入 `X-Comfy-Error-Type` 的分类相同。它正是用来把成功的终端请求与失败或已取消的终端请求区分开来的:这两种情况都没有单独的终端状态。成功时该字段是缺失的而非 null,因此应依据它是否存在来分支。 + 仅出现在未成功的 `COMPLETED` 请求上,携带与结果读取在该失败返回时置于 `X-Comfy-Error-Type` 上的相同粗粒度分类桶。它用于区分成功的终端请求与失败或被取消的终端请求(这两者都没有单独的终端状态),并且在成功时是缺失而非 null,因此请根据其是否存在进行分支判断。 类型:[`RouterErrorType`](#routererrortype) ### RouterQueueStatusResponse -一个已排队请求的当前状态,与提交时返回的同样三个 URL 组合在一起。 +单个排队中请求的当前状态,与提交时返回的那三个 URL 组合在一起。 -组合了 [`RouterQueueUrls`](#routerqueueurls) 和 [`RouterQueueStatusFields`](#routerqueuestatusfields)。 +组合了 [`RouterQueueUrls`](#routerqueueurls) 与 [`RouterQueueStatusFields`](#routerqueuestatusfields)。 类型:`object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse` 中除了 URL 区块之外的另一半:新请求的身份标识,以及它在被接纳那一刻的状态。 +`RouterQueueSubmitResponse` 中不属于 URL 块的那一半内容:新请求的身份标识,以及它在被接纳那一刻的状态。 **字段** - 一个已排队的 Router 请求的标识符,也是调用方用来轮询、取消和获取结果的句柄。 + 一个已排队 Router 请求的标识符,即调用方用于轮询、取消并获取结果的句柄。 - Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最多 36 个字符 + 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最多 36 个字符 - 已排队的 Router 请求的状态。它恰好有三个取值,并且与 `RouterErrorType` 不同,这一个采用封闭的 `enum`,因为这两个 schema 是刻意朝相反方向封闭的。`RouterErrorType` 用于对失败进行分类,其取值集合预期会增长,所以,如果一个生成的客户端硬性拒绝无法识别的类别,那么它恰恰会在已经有东西出错时失败得最严重。而这一个描述的是一段生命周期,日后若为它增加第四个状态,对每一个基于它编写的轮询循环来说都是破坏性变更,无论它是否被声明为 enum 都是如此。因此它被声明为 enum,并且把这一约束写在客户端能看到的地方。 + 一个已排队 Router 请求的状态。它恰好有三个值,与 `RouterErrorType` 不同,这个 schema 是一个封闭的 `enum`,因为这两个 schema 故意朝着相反的方向封闭。`RouterErrorType` 用于对失败进行分类,它的取值集合预期会增长,因此一个硬性拒绝未识别分类的已生成客户端,恰恰会在已经出了问题的时候失败得最严重。而此项是一个生命周期,日后新增第四种状态的生命周期,对每一个针对它编写的轮询循环来说都是破坏性变更,无论它是否被声明为 enum,因此它被声明为 enum,并把该约束写在客户端能看到的地方。 - Type: [`RouterQueueStatus`](#routerqueuestatus) + 类型:[`RouterQueueStatus`](#routerqueuestatus) - 在响应生成的那一刻,队列中有多少个请求排在这一个之前。零表示此请求位于队首。 + 在响应合成的那一刻,队列中有多少个请求排在它前面。零表示该请求位于队首。 - Type: [`RouterQueuePosition`](#routerqueueposition) -- 至少为 0 + 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少 0 - 此请求的预检成本估算。当调用方启用了成本估算时,新请求被接纳时会带上该字段。它报出的是此请求所固定到的提供商分支(队列没有回退循环,因此 `fallback_provider` 永远不会改变实际运行的分支)。当无法给出数值时,该字段依然存在,其值为 `source: unknown`;提交绝不会因为估算而失败。在幂等重放(`Idempotent-Replayed: true`)时省略,因为原始报价不会被存储。它是估算值,不是最终收费,也不是价格锁定:运行会按计费时生效的费率计费,而你工作区用量与账单记录中的结算金额才是最终结果。 + 该请求的预检成本估算,在调用方启用了成本估算时,于全新接纳的请求上提供。它报出的是该请求被固定到的提供商侧分段(队列没有回退循环,因此 `fallback_provider` 永远不会改变实际执行的分段)。当无法给出数字时,它仍然存在,并带有 `source: unknown`;提交绝不会因为该估算而失败。在幂等重放(`Idempotent-Replayed: true`)时会省略,因为原始报价未被存储。它只是估算,不是最终费用,也不是价格锁定:运行会按计价时生效的费率计费,而你工作区的用量与账单记录中结算后的费用才是最终的。 - Type: [`RouterCostEstimate`](#routercostestimate) + 类型:[`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -当一次运行被接纳进入队列时返回的句柄:包含该请求的身份与状态,并与另外三个用于访问其生命周期其余部分的 URL 组合在一起。 +运行被接纳进入队列时返回的句柄:包含请求的身份与状态,并组合了三个用于访问其剩余生命周期的 URL。 -组合了 [`RouterQueueUrls`](#routerqueueurls) 与 [`RouterQueueSubmitFields`](#routerqueuesubmitfields)。 +组合了 [`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueSubmitFields`](#routerqueuesubmitfields)。 类型:`object` ### RouterQueueUrls -这三个 URL 用于访问某个排队请求剩余生命周期中的其他资源,凡是携带有效句柄的响应都会返回它们,这样客户端就无需自行拼接队列 URL。 +这三个 URL 覆盖某个排队请求剩余生命周期中的各项操作,凡是携带有效句柄的响应都会返回它们,客户端因此无需自行拼接队列 URL。 **字段** - 读取此请求状态的绝对 URL。 + 读取该请求状态的绝对 URL。 URI - 获取此请求结果的绝对 URL。 + 收集该请求结果的绝对 URL。 URI - 请求取消操作所使用的绝对 URL。 + 发起取消请求的绝对 URL。 URI @@ -1522,37 +1522,37 @@ Router 模型目录中的一页。 ### RouterValidationErrorDetail -单个字段级验证失败。 +单个字段级别的验证失败。 **字段** - 出错字段的路径,最外层片段在前。例如 `["body", "image_url"]`,或 `["body", "images", 0]`,其中整数用于索引数组。 + 出错字段的路径,最外层片段在前。例如 `["body", "image_url"]`,或 `["body", "images", 0]`,其中整数表示数组中的索引。 - 对本次单个失败的可读描述。 + 对这一次失败的人类可读描述。 - 本次失败的具体、机器可读的原因,由提供商原样透传。类型化 SDK 异常层级正是依据该值进行分支判断;响应头中的 `error_type` 只是它的粗略分类。 + 这一次失败的具体、机器可读的原因,由提供商原样传递。类型化 SDK 的异常层次结构正是依据该值进行分支判断;响应头中的 `error_type` 只是它的粗略分类。 - 针对单个 `RouterValidationErrorDetail` 的受限值,由提供商逐字传递。例如与 `greater_than` 一同出现的 `{"limit_value": 8}`,与 `image_too_small` 一同出现的 `{"min_width": 512}`,或与 `file_too_large` 一同出现的 `{"max_size_bytes": 10485760}`。键集合取决于具体的提供商和错误类型,因此这里刻意设计为开放对象:把它收窄为固定字段列表,或将其并入 `msg` 字符串,恰恰是移植集成在编译通过后悄然丢失读取该限制值分支的典型原因。当错误类型不携带限制值时,该字段不存在。 + 单个 `RouterValidationErrorDetail` 所违反的边界值,由提供商逐字传递。例如 `{"limit_value": 8}` 配合 `greater_than`,`{"min_width": 512}` 配合 `image_too_small`,或 `{"max_size_bytes": 10485760}` 配合 `file_too_large`。键集合取决于具体的提供商和错误类型,因此这里刻意为开放式对象:把它收窄为固定字段列表,或将其折叠进 `msg` 字符串,正是移植集成后能够编译通过、却悄悄丢失读取该边界的分支的原因。当错误类型不携带边界值时,该字段不存在。 类型:[`RouterValidationErrorContext`](#routervalidationerrorcontext) - 出错的输入值,逐字回显,使调用方无需从 `loc` 重新推导即可看到被拒绝的内容。可为任意 JSON 类型,包括字符串、数字、布尔、数组、对象或 null,因此该 schema 刻意不限定类型,而非收窄为对象。当提供商不回显输入时,该字段不存在。 + 出错的输入值,原样回显,以便调用方无需从 `loc` 重新推导就能看到被拒绝的内容。任意 JSON 类型均可:字符串、数字、布尔、数组、对象或 null,因此此 schema 刻意不做类型限定,而不是收窄为对象。当提供商不回显输入时,该字段不存在。 类型:[`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -被拒绝的输入值,前提是提供商提供了该值。 +被拒绝的输入值(当提供商包含该值时)。 ### RouterValidationErrorResponse @@ -1561,7 +1561,7 @@ Router 模型目录中的一页。 **字段** - 请求中发现的每一个验证失败,每个违规字段对应一个条目。 + 请求中发现的每个验证失败,每个违规字段对应一个条目。 - 类型:数组,元素为 [`RouterValidationErrorDetail`](#routervalidationerrordetail) + 类型:由 [`RouterValidationErrorDetail`](#routervalidationerrordetail) 组成的数组 From ee6d48d7c9cbc304882617a4bc86e184869a14b1 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 11:39:50 +0800 Subject: [PATCH 02/36] i18n: sync zh/ja/ko router pages with upstream/main (2026-11-10) --- ja/development/comfy-router/limitations.mdx | 6 +- .../models/openai/gpt-image-2/code.mdx | 6 +- .../models/wan/happyhorse-1-0-t2v/code.mdx | 264 ++++++++--------- .../wan/happyhorse-1-0-video-edit/code.mdx | 212 +++++++++----- .../models/wan/happyhorse-1-1-t2v/code.mdx | 275 +++++++++--------- .../models/wan/wan2-5-t2i-preview/code.mdx | 52 ++-- .../models/wan/wan2-5-t2v-preview/code.mdx | 239 ++++++++------- .../models/wan/wan2-6-i2v/code.mdx | 1 + .../models/wan/wan2-6-r2v/code.mdx | 1 + .../models/wan/wan2-7-i2v/code.mdx | 228 ++++++--------- .../models/wan/wan2-7-r2v/code.mdx | 222 +++++--------- .../models/wan/wan3-0-video-prime/code.mdx | 245 ++++++++-------- .../models/wan/wan3-0-video/code.mdx | 243 ++++++++++------ ja/development/comfy-router/providers.mdx | 4 +- ko/development/comfy-router/limitations.mdx | 6 +- .../models/openai/gpt-image-2/code.mdx | 6 +- .../models/wan/happyhorse-1-0-t2v/code.mdx | 207 +++++-------- .../wan/happyhorse-1-0-video-edit/code.mdx | 204 +++++++------ .../models/wan/happyhorse-1-1-t2v/code.mdx | 215 +++++++------- .../models/wan/wan2-5-t2i-preview/code.mdx | 30 +- .../models/wan/wan2-5-t2v-preview/code.mdx | 221 +++++++------- .../models/wan/wan2-6-i2v/code.mdx | 233 +++++++-------- .../models/wan/wan2-6-r2v/code.mdx | 224 +++++++------- .../models/wan/wan2-7-i2v/code.mdx | 217 +++++++------- .../models/wan/wan2-7-r2v/code.mdx | 222 +++++++------- .../models/wan/wan3-0-video-prime/code.mdx | 221 +++++++------- .../models/wan/wan3-0-video/code.mdx | 230 +++++++-------- ko/development/comfy-router/providers.mdx | 4 +- zh/development/comfy-router/limitations.mdx | 6 +- .../models/openai/gpt-image-2/code.mdx | 8 +- .../models/wan/happyhorse-1-0-t2v/code.mdx | 122 ++++---- .../wan/happyhorse-1-0-video-edit/code.mdx | 226 +++++++------- .../models/wan/happyhorse-1-1-t2v/code.mdx | 231 ++++++++------- .../models/wan/wan2-5-t2i-preview/code.mdx | 50 ++-- .../models/wan/wan2-5-t2v-preview/code.mdx | 158 ++++------ .../models/wan/wan2-6-i2v/code.mdx | 139 ++++----- .../models/wan/wan2-6-r2v/code.mdx | 1 + .../models/wan/wan2-7-i2v/code.mdx | 190 +++++------- .../models/wan/wan2-7-r2v/code.mdx | 1 + .../models/wan/wan3-0-video-prime/code.mdx | 227 +++++++-------- .../models/wan/wan3-0-video/code.mdx | 179 +++++++----- zh/development/comfy-router/providers.mdx | 2 +- 42 files changed, 2808 insertions(+), 2970 deletions(-) diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index ad52fbfa07..2b1dd7f980 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の機能と制限" sidebarTitle: "機能と制限" description: "Comfy Router とパートナープロキシのどちらを選ぶか、長時間実行される呼び出しへの備え、リカバリ・レート制限・アセット保存について説明します。" -translationSourceHash: 691c2e79 +translationSourceHash: fbb54868 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": 2b25596f + "Models without a pre-flight estimate": cca3ca82 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -29,6 +29,7 @@ translationBlockHashes: + Router はパートナーモデルを、1回の同期 HTTP 呼び出し、または送信して後で結果を取得するキュー中のリクエストを通じて実行します。アプリケーションが完了した結果を待つことができ、あるいは後で結果を取得でき、さらにモデル自身の入力フィールドと出力フィールドを処理できる場合に使用します。 ## Router がサポートするもの @@ -122,6 +123,7 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` +- **minimax**: `minimax/minimax-gpt-image-2` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx index e7ed38190f..7eaadd24dd 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で GPT Image 2 を使用する" description: "Comfy Router 経由で openai/gpt-image-2 を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2" -translationSourceHash: b9cb8af5 +translationSourceHash: 2fe15764 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 - "Serving providers": 56df172f + "Serving providers": f3930e40 "Schema": 4e6e5e53 "Examples": c73859ec --- @@ -17,6 +17,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -162,6 +163,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2/requests/$REQUEST_ID \ - **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2` - **fal**(`fal/fal-gpt-image-2` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=fal` +- **MiniMax**(`minimax/minimax-gpt-image-2` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=minimax` - **Pika**(`pika/pika-gpt-image-2` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=pika` - **Runware**(`runware/runware-gpt-image-2` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=runware` - **WaveSpeed**(`wavespeed/wavespeed-gpt-image-2` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=wavespeed` diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index 5912c25476..ed4f7e2f14 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で HappyHorse 1.0 T2V を使用する" description: "Comfy Router 経由で HTTP を使って wan/happyhorse-1.0-t2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "HappyHorse 1.0 T2V" -translationSourceHash: f4e2958a +translationSourceHash: a87b2e81 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx translationBlockHashes: "_intro": b98773c2 "Quick start": b4282abb - "Schema": 83267e64 + "Schema": e48d60d6 "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -182,127 +183,124 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID ### 入力 - プロンプトワードなどの基本情報を入力します。 + プロンプトなどの基本情報を入力します。 - オーディオファイルのダウンロード URL。対応形式: mp3 と wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls とは併用できません。 - 最初のフレーム画像の URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記は、ここで最初のフレームを -受け取りません。最初のフレームは type が first_frame の media 要素として受け取ります(後述の -media を参照)。また、wan2.6-i2v では成功する img_url ボディも、 -happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーに拒否されます。そして -wan2.7/wan3.0 の表記も参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレーム画像の URL または Base64 エンコードされたデータ。wan2.5-i2v-preview モデルと +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系のスペルは、先頭フレームをここで受け取ることは +ありません。先頭フレームは type が first_frame のメディア要素として渡します(後述の media を参照)。 +また、wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v と happyhorse-1.1-i2v では +プロバイダーに拒否されます。さらに wan2.7/wan3.0 系のスペルも参照アセットを media で渡します。 +画像形式: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360〜2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を指定します。 -各要素には type フィールドと url フィールドが含まれます。このフィールドはこのコンポーネントから -提供されるすべてのモデルで共有されており、どの type 値を特定のモデルが受け入れるか、 -また img_url や reference_video_urls ではなくここで画像やビデオの入力を受け取るかどうかは、 -モデルによって異なります。モデルごとの対応 type 値: + メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントが提供するすべての +モデルで共通ですが、どの type 値を受け付けるか、また画像やビデオの入力を img_url や +reference_video_urls ではなくここで渡すかどうかは、モデルによって異なります。モデルごとの +対応する type 値は次のとおりです: - wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺あたり 240-8000 ピクセル、アスペクト比 1:8 - から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 - 秒、1辺あたり 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの + last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、 + 最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2〜30 秒、最大 15MB)と first_clip(MP4/MOV、2〜10 秒、 + 1辺 240〜4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL のみで、インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1 つ)、reference_image、reference_video。少なくとも - 1 つの reference_image または reference_video が必須で、reference_image と - reference_video を合わせて最大 5 つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、1辺あたり 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 +- wan2.7-r2v: first_frame(任意、最大 1 個)、reference_image、reference_video。少なくとも + 1 つの reference_image または reference_video が必要で、reference_image と + reference_video の合計は最大 5 個です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 - HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、2-10 秒、 - 1辺あたり 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL - は受け付けられません)に加えて、任意で 0 から 4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL + HTTP/HTTPS URL のみで、インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(ちょうど 1 個、編集対象のクリップ: MP4/MOV、2〜10 秒、 + 1辺 240〜4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL のみで、インラインの data: URL + は受け付けられません)に加えて、任意で 0〜4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 - reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、 - reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link とは併用 - 不可)、link(最大 1、file とは併用不可)。reference_*/file/link タイプ - と first_frame/last_frame タイプは、同じリクエスト内では相互に排他的です。 - 配列の順序が、プロンプト内のアセットの参照順序を定義します(画像 1、ビデオ 1、 - オーディオ 1、...)。first_frame、last_frame および reference_image: JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり 240-8000 ピクセル、アスペクト比は最大 8:1、最大 20MB、公開 URL または - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file および link: - 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの表記 - は最初のフレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、アスペクト比 - 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または +- wan3.0-video、wan3.0-video-prime: first_frame(最大 1 個)、last_frame(最大 1 個)、 + reference_image(最大 10 個)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、 + reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1 個、link とは + 併用不可)、link(最大 1 個、file とは併用不可)。reference_*/file/link の各 type + と first_frame/last_frame の各 type は同一リクエスト内で同時に使用できません。 + 配列の順序がプロンプト内でのアセットの参照順(Image 1、Video 1、 + Audio 1、...)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1辺 240〜8000 ピクセル、アスペクト比 最大 8:1、最大 20MB、公開 URL または + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 + HTTP/HTTPS URL のみで、インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 個。これらのスペルは + 先頭フレームを img_url ではなくここで受け取ります。少なくとも 300x300 ピクセル、アスペクト比 + 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 つ。これが - このモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 - 最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video は - この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、3-60 - 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト - 比 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: - URL は受け付けられません)に加えて、任意で 0 から 5 つの reference_image(JPEG/JPG/PNG/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 20MB、公開 URL +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9 個。これがこのモデル + 唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 + 最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。この操作では reference_video は + 入力 type ではありません。 +- happyhorse-1.0-video-edit: video(ちょうど 1 個、編集対象のクリップ: MP4/MOV、3〜60 + 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 + 1:2.5〜2.5:1、最大 100MB、公開 HTTP/HTTPS URL のみで、インラインの data: + URL は受け付けられません)に加えて、任意で 0〜5 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 少なくとも 300x300 ピクセル、アスペクト比 1:2.5〜2.5:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。これらのパートナーリファレンスにはメディア入力の記載がないため、 - このフィールドは未設定のままにします。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対して - メディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初の + テキストから動画への操作です。これらのパートナーのリファレンスにはメディア入力の記載がないため、この + フィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらのスペルに対して + メディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭 フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの個数は、このスキーマの制約ではなくパートナーの制約です。media には -minItems/maxItems が宣言されていません。許容されるタイプとその上限はモデルごとに異なるためです。 -スキーマが受け入れることは、プロバイダーが受け入れることを意味しません。逆の方向も同様で、 -上記のアセット単位の「最大 20MB」という数値(画像入力に対する上限であり、インラインで送信できる -唯一の入力です)は、最終的にパートナーが受け取るアセットに対するパートナーの上限であり、 -アセットが公開 URL である場合には記載どおりに適用されます。そのバイト列は Comfy を経由しないためです。 -インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送の上限にも直面します。 -Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。また -base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、 -ここに示したパートナーのルールのいずれかに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限ならインラインで問題なく収まるため、アセットが 1 つの場合はパートナーのルールのほうが制約となります。複数のアセットにまたがる場合は転送の上限のほうが制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近い値はパブリック URL として送信してください。 +上記のモデルごとの個数はこのスキーマの制約ではなくパートナーの制約です。受け付け可能な type と +その上限はモデルごとに異なるため、media には minItems/maxItems が宣言されていません。 +スキーマが受け付けることはプロバイダーが受け付けることを意味しません。逆方向についても、上記の +アセットごとの「最大 20MB」という数値は、画像入力(唯一インラインで送信できる入力)に対する +上限であり、パートナーが最終的に受け取るアセットに対する上限です。アセットが公開 URL の場合、 +そのバイト列が Comfy を経由することはないため、これらの数値は記載どおりに適用されます。 +インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも +直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。 +また base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインライン +アセットは、ここに挙げたパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットがパートナー自身の20MB の上限ならインラインで余裕をもって収まります。そのため、1 つのアセットではパートナーのルールが制約となります。複数のアセットにまたがる場合は転送の上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 - メディアアセットの種類 + メディアアセットのタイプ 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明でモデルごとに挙げているまさに IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を使用できます。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、各モデルについて上記の `media` の説明に記載されている IMAGE 入力に限り、インラインの `data:{MIME_type};base64,...` URL。対象となる IMAGE 入力は、wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、および happyhorse-1.0-video-edit の reference_image です。これらのモデルのいずれでも、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスからの oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデル呼び出しを行い、アップロード経路を公開しないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエスト本文の上限については、`media` の説明を参照してください。 - 逆プロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します + ネガティブプロンプト(reverse prompt words)は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これはプロンプトと同じ入力予算にカウントされます。 - テキストプロンプトの語句。中国語と英語をサポートし、長さは 800 文字以内です -(wan3.0-video では最大 20,000 文字。上限を超えた内容は切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に従って被写体を指すために 'character1'、'character2' などを使用します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを指すために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 + テキストプロンプトの語句。中国語と英語をサポートします。文書化された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます: wan2.5 と wan2.6 は 1,500 文字、wan2.7 は 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。プロバイダーは、prompt と negative_prompt を合わせた長さが UTF-8 テキストで約 60,850 バイト(約 20,000 文字の中国語)を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。複数の参照ビデオを使用する wan2.6-r2v では、参照ビデオの順序で被写体を指すために 'character1'、'character2' などを使用します。例: 「Character1 が道端で歌い、Character2 がそのそばで踊る」。wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを指すために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列。 -入力の制限: -- フォーマット: mp4、mov -- 本数: 1〜3 本 -- 1 本あたりのビデオの長さ: 2〜30 秒 -- 1 ファイルあたりのファイルサイズ: 最大 30MB + wan2.6-r2v モデル専用の参照ビデオ URL。1-3 本のビデオ URL の配列です。 +入力制限: +- 形式: mp4, mov +- 数量: 1-3 本のビデオ +- 単一ビデオの長さ: 2-30 秒 +- 単一ファイルサイズ: 最大 30MB - audio_url と併用できません -参照の再生時間: ビデオ 1 本なら最大 5 秒、2 本ならそれぞれ最大 2.5 秒、3 本ならそれに応じて短くなります。 -課金: 実際に使用した参照の再生時間に基づきます。 +参照再生時間: 単一ビデオは最大 5s、2 本の場合はそれぞれ最大 2.5s、3 本の場合は比例して短くなります。 +課金: 使用した実際の参照再生時間に基づきます。 - ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用すると、prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け入れられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -310,12 +308,12 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。他の wan モデルについて、プロバイダーはそのような切り替えを記載していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。他の wan モデルについては、プロバイダーはそのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します +- auto(デフォルト): モデルが prompt の内容に基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: `auto`、`origin` @@ -323,26 +321,25 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で 生成されるビデオの再生時間(秒): -- wan2.5 モデル: 5 または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 -- wan2.6-r2v: 5 または 10 秒のみ(15 秒は非サポート) +- wan2.5 モデル: 5 秒または 10 秒 +- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15s はサポートされません) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 はスマート再生時間モードを有効にし、モデルが適切な再生時間を選択します +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはいけません。-1 はスマート再生時間モードを有効にし、モデルが適切な再生時間を選択します このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 - 範囲: `-1`〜`30` + 範囲: `-1` から `30` - プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です + プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です。 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 +wan2.7 モデルの場合、指定しないと解像度ティアに基づいてデフォルト設定されます。 +wan3.0-video の場合、adaptive(デフォルト)は適切な入力メディアの比率と意図に基づくアスペクト比。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -350,46 +347,51 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P は非サポート) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルトは 1080P) -- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(アップストリームのデフォルトは 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P -- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P - -このプロキシは、解像度と size のどちらも指定していないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決めるためです。このプロキシは解像度をチェックする前に大文字に変換し、大文字に変換した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P がないと記載されている wan2.6、wan2.7、happyhorse-1.0 の各モデルでは、480P(解像度として送信された場合でも、480P の size として送信された場合でも)に対して 400 を返します。 +- wan2.6 モデル (t2v、i2v、r2v): 720P、1080P のみ (480P は非サポート) +- wan2.7 モデル (i2v、t2v、r2v、videoedit): 720P、1080P (デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P (上流のデフォルトは 1080P) +- happyhorse-1.0-* (t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-* (t2v、i2v、r2v): 480P、720P、1080P +このプロキシは、resolution も size も指定しないビデオ生成リクエストを拒否します。 +これは解像度ティアが課金レートを選択するためです。チェック前に resolution を +大文字化し、大文字化した値を転送します。この列挙に含まれない値には 400 を返し、 +上記で 480P 非対応と記載された wan2.6、wan2.7、happyhorse-1.0 モデルに対して +480P (resolution として送信された場合も、480P の size として送信された場合も) には 400 を返します。 指定可能な値: `480P`、`720P`、`1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 範囲: `0` から `2147483647` インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデル用。 -- single: 単一ショットのビデオ(デフォルト) -- multi: マルチショットのビデオ +wan2.6 および wan2.7-r2v モデル用です。 +- single: シングルショットビデオ (デフォルト) +- multi: マルチショットビデオ 指定可能な値: `multi`、`single` - 幅*高さ形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ -wan2.6 T2V/R2V の場合(480P なし): + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P (480*832、832*480、624*624)、720P、1080P の各サイズ +wan2.6 T2V/R2V の場合 (480P なし): 720P: 1280*720、720*1280、960*960、1088*832、832*1088 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -size と resolution の両方を送信した場合、課金される階層を選ぶのは size であり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、解像度の説明で 480P がないと記載されているすべてのモデルで 400 を返します。 +size と resolution の両方を送信した場合、課金ティアは size で選択され、 +resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、 +解像度の説明で 480P 非対応と記載されているすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 +スキーマから生成されたもので、Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供するドキュメントと同じであり、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントです。 ### 出力 @@ -402,7 +404,7 @@ Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供する - オーディオ生成を伴う I2V タスク用のオーディオ URL + 音声生成を伴うI2Vタスク用のオーディオURL @@ -414,7 +416,7 @@ Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供する - 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) @@ -442,7 +444,7 @@ Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供する - 生成済み画像の URL アドレス + 生成された画像のURLアドレス @@ -454,11 +456,11 @@ Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供する - タスク ID + タスクID - 画像生成タスクのタスク結果の統計 + 画像生成タスクのタスク結果統計 @@ -474,13 +476,13 @@ Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供する - タスクのステータス + タスクステータス - 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 取り得る値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 完了したビデオ生成タスクのビデオ URL。リンクの有効期間は 24 時間です + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です @@ -488,51 +490,51 @@ Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供する - 出力情報の統計。成功した結果のみが集計されます + 出力情報の統計。成功した結果のみがカウントされます - ビデオ解像度レベル(I2V および wan3.0-video タスク) + ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) - 生成されたビデオの再生時間(秒)(I2V および wan3.0-video タスク) + 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-video タスク) + 生成されたビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2I および I2I タスク) + 生成された画像の数(T2IおよびI2Iタスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間(秒)(wan3.0-video タスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) - 生成されたビデオのアスペクト比。例: 16:9(wan3.0-video タスク) + 生成されたビデオのアスペクト比。例: 16:9(wan3.0-videoタスク) - 画像解像度(T2I および I2I タスク) + 画像解像度(T2IおよびI2Iタスク) - 生成されたビデオの数(T2V タスク) + 生成されたビデオの数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2V タスク) + 生成されたビデオの再生時間(秒)(T2Vタスク) - ビデオ解像度の比率(T2V タスク) + ビデオ解像度の比率(T2Vタスク) @@ -540,7 +542,7 @@ Router が `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` で提供する - 失敗したリクエストに関する詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index 285d696e9c..2b6dae3c91 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で HappyHorse 1.0 Video Edit を使う" description: "Comfy Router 経由で wan/happyhorse-1.0-video-edit を HTTP で呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "HappyHorse 1.0 Video Edit" -translationSourceHash: 138e4d49 +translationSourceHash: b9922c80 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx translationBlockHashes: "_intro": 3a4cf59c "Quick start": 140976d2 - "Schema": bd0494a3 + "Schema": a762284e "Examples": a41df668 --- + {/* 生成済みファイル。このディレクトリの code.yaml を編集し、`pnpm code-pages:gen` を実行してください。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -201,33 +202,86 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-video-edit/requests/$REQ ### 入力 - プロンプトワードなどの基本情報を入力します。 + プロンプトなどの基本情報を入力します。 - オーディオファイルのダウンロードURL。対応フォーマット:mp3 と wav。reference_video_urls と併用できません。 + 音声ファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls とは併用できません。 - 先頭フレームの画像URLまたはBase64エンコードデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x i2v 系の表記はここで先頭フレームを受け取りません。それらは first_frame タイプの media 要素として受け取ります(後述の media を参照)。また wan2.6-i2v で成功する img_url ボディは、happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 系の表記も参照アセットを media で受け取ります。画像フォーマット:JPEG、JPG、PNG、BMP、WEBP。解像度:360-2000ピクセル。ファイルサイズ:最大10MB。 + 最初のフレーム画像のURL、またはBase64エンコードされたデータ。wan2.5-i2v-preview および +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の表記では、最初のフレームをここで受け取りません。 +最初のフレームは type が first_frame のメディア要素として受け取ります(後述の media を参照)。また、 +wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーに +拒否されます。wan2.7/wan3.0 系の表記も参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360〜2000ピクセル。ファイルサイズ: 最大10MB。 - media アセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントから提供されるすべてのモデルで共通ですが、あるモデルがどの type 値を受け入れるか、そして画像やビデオの入力を img_url や reference_video_urls ではなくそもそもここで渡すかどうかは、モデルごとに異なります。モデルごとの対応 type 値: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame:JPEG/JPG/PNG/BMP/WEBP、1辺あたり240-8000ピクセル、アスペクト比1:8~8:1、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2-30秒、最大15MB)と first_clip(MP4/MOV、2-10秒、1辺あたり240-4096ピクセル、最大100MB):パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。少なくとも1つの reference_image または reference_video が必要で、reference 画像と reference ビデオの合計は最大5つです。first_frame と reference_image:JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、1辺あたり240-8000ピクセル、アスペクト比1:8~8:1、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。reference_video:パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(正確に1つ、編集対象のクリップ:MP4/MOV、2-10秒、1辺あたり240-4096ピクセル、最大100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で0~4つの reference_image(JPEG/JPG/PNG/BMP/WEBP、1辺あたり240-8000ピクセル、アスペクト比1:8~8:1、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15秒)、reference_audio(最大5クリップ、合計再生時間 \<= 15秒)、file(最大1、link と併用不可)、link(最大1、file と併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは、同じリクエスト内で相互に排他的です。配列の順序が、プロンプト内のアセットの参照順序(Image 1、Video 1、Audio 1、...)を定義します。first_frame、last_frame、reference_image:JPEG/JPG/PNG/BMP/WEBP、1辺あたり240-8000ピクセル、アスペクト比最大8:1、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link:パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、正確に1つ。これらの表記は先頭フレームをここで受け取り、img_url では受け取りません。少なくとも300x300ピクセル、アスペクト比1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9つ。これはこのモデル唯一の参照入力です。最短辺が少なくとも400ピクセル、JPEG/JPG/PNG/WEBP、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(正確に1つ、編集対象のクリップ:MP4/MOV、3-60秒、長辺が最大4096ピクセル、短辺が少なくとも360ピクセル、アスペクト比1:2.5~2.5:1、最大100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で0~5つの reference_image(JPEG/JPG/PNG/BMP/WEBP、少なくとも300x300ピクセル、アスペクト比1:2.5~2.5:1、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作です。これらのパートナーの参照資料には media 入力の記載がないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントは、これらの表記に対する media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの個数はこのスキーマの制約ではなくパートナーの制約です。media には minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに異なるためです。スキーマが受け入れることはプロバイダーが受け入れることを意味しません。逆に、上記のアセットごとの「最大20MB」という数値、つまり画像入力(インラインで送信できる唯一の入力)の上限は、最終的にパートナーが扱うアセットに対するパートナーの上限であり、アセットがパブリックURLである場合は記載どおりに適用されます。これらのバイトが Comfy を経由することはないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由し、トランスポートの上限にも直面します。Comfy Router の POST ボディは合計で最大100 MiB に制限され、それを超えると 413 が返されます。また base64 はペイロードを約4/3に膨らませるため、およそ75 MB を超える単一のインラインアセットは、ここに記載されたパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の -20MB の上限ならインラインに余裕で収まるため、単一のアセットについてはパートナーのルールが制約となります。 -複数のアセットにまたがる場合は、転送の上限が制約となります。100 MiB の Router 上限は -各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは -公開 URL として送信してください。 + メディアアセットのリスト。動画生成用の参照素材(画像、音声、ビデオ)を指定します。 +各要素は type フィールドと url フィールドを持ちます。このフィールドはこのコンポーネントが提供する +すべてのモデルで共有されますが、どのモデルがどの type 値を受け付けるか、また画像やビデオの入力を +img_url や reference_video_urls ではなくここで受け取るかどうかはモデルによって異なります。 +モデルごとの対応する type 値は次のとおりです: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と + last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺240〜8000ピクセル、アスペクト比1:8〜8:1、 + 最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2〜30秒、最大15MB)と first_clip(MP4/MOV、2〜10 + 秒、1辺240〜4096ピクセル、最大100MB): 公開HTTP/HTTPS URL。インラインの + data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。少なくとも + 1つの reference_image または reference_video が必要で、reference 画像と + reference ビデオの合計は最大5つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺240〜8000ピクセル、アスペクト比1:8〜8:1、最大 + 20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video: 公開 + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、2〜10秒、 + 1辺240〜4096ピクセル、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で0〜4個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺240〜8000ピクセル、アスペクト比1:8〜8:1、最大20MB、公開URL + または data:\{MIME_type};base64,... URL)。 +- wan3.0-video, wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 + reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15s)、 + reference_audio(最大5クリップ、合計再生時間 \<= 15s)、file(最大1、link とは併用不可)、 + link(最大1、file とは併用不可)。reference_*/file/link の各 type と + first_frame/last_frame の各 type は同じリクエスト内では同時に使用できません。 + 配列の順序が、プロンプト内のアセットの参照順(Image 1、Video 1、 + Audio 1、...)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1辺240〜8000ピクセル、アスペクト比最大8:1、最大20MB、公開URLまたは + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: + 公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記では + 最初のフレームを img_url ではなくここで受け取ります。少なくとも300x300ピクセル、アスペクト比 + 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、公開URLまたは + data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image のみ、1〜9個。これが + このモデル唯一の参照入力です。短辺が少なくとも400ピクセル、JPEG/JPG/PNG/WEBP、 + 最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video は + この操作の入力タイプではありません。 +- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、3〜60 + 秒、長辺が最大4096ピクセル、短辺が少なくとも360ピクセル、アスペクト + 比1:2.5〜2.5:1、最大100MB、公開HTTP/HTTPS URL。インラインの data: + URL は受け付けられません)に加えて、任意で0〜5個の reference_image(JPEG/JPG/PNG/WEBP、 + 少なくとも300x300ピクセル、アスペクト比1:2.5〜2.5:1、最大20MB、公開URL + または data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: + テキストから動画への操作です。対応するパートナーのリファレンスにはメディア入力の記載がないため、 + このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: このコンポーネントはこれらの表記に対する + メディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初の + フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。media には +minItems/maxItems が宣言されていません。許容される type とその上限は +モデルごとに異なるためです。スキーマが受け付けることはプロバイダーが受け付けることを意味しません。 +また逆に、上記のアセットごとの「最大20MB」という数値、つまり画像 +入力(インラインで送信できる唯一の入力)の上限は、最終的にパートナーが受け取る +アセットに対するパートナーの上限であり、アセットが公開URLの場合はそのまま適用されます。 +そのバイト列がComfyを経由することはないためです。インラインの data:\{MIME_type};base64,... +URL はComfyを経由し、転送の上限にも当たります: Comfy Router の +POST ボディは合計100 MiB に制限され、超えると 413 が返されます。また base64 は +ペイロードを約4/3に膨らませるため、およそ75MBを超える単一のインラインアセットは、 +ここに示すパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限はインラインでも余裕を持って収まるため、単一のアセットではパートナーのルールの方が制約となります。転送の上限は複数のアセットにまたがる場合に効いてきます。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、すべてパブリック URL として送信してください。 @@ -237,53 +291,50 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-video-edit/requests/$REQ - メディアファイルの URL。公開 HTTP/HTTPS URL、または、上記の `media` の説明で各モデルに対して列挙しているまさに画像入力に限り、インラインの `data:{MIME_type};base64,...` URL を指定できます。すなわち、wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame と reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、そして happyhorse-1.0-video-edit の reference_image です。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明がモデルごとに列挙している IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL も使用できます。これらのモデルの video、audio、file、link のいずれの入力も、インラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、アップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出すためアップロード経路を公開しておらず、呼び出し元自身の oss:// URL や asset_id はサポート対象の入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを合計で制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - 逆プロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します + 逆プロンプトの語句は、ビデオ画面に映したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り詰めます。prompt と同じ入力予算に計上されます。 - テキストプロンプト。中国語と英語をサポートし、長さは 800 文字以内 -(wan3.0-video では最大 20,000 文字。上限を超えたコンテンツは切り捨てられます)。 -複数の参照ビデオを使用する wan2.6-r2v では、'character1'、'character2' などを使って、 -参照ビデオの順序で被写体を参照します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' などを使って、 -media 配列内の対応する順序でメディアアセットを参照します。 + テキストプロンプトです。中国語と英語をサポートします。文書化された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り詰めます。wan2.5 と wan2.6 は 1,500 文字、wan2.7 は 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字まで受け付けます。プロンプトと negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 の中国語文字)を超えるリクエストはプロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +参照ビデオを複数使う wan2.6-r2v では、参照ビデオの順序に従って被写体を 'character1'、'character2' などで参照します。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の reference モードでは、media 配列内の対応する順序でメディアアセットを 'Image 1'、'Video 1'、'Audio 1' などで参照します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列です。 入力の制限: - 形式: mp4、mov -- 数量: 1〜3 本のビデオ -- 単一ビデオの長さ: 2〜30 秒 -- 単一ファイルサイズ: 最大 30MB +- 本数: 1〜3 本 +- 1 本あたりの長さ: 2〜30 秒 +- 1 ファイルあたりのサイズ: 最大 30MB - audio_url と併用できません -参照再生時間: ビデオ 1 本なら最大 5 秒、2 本なら各最大 2.5 秒、3 本ならそれに比例して短くなります。 -課金: 実際に使用した参照再生時間に基づきます。 +参照の再生時間: 1 本の場合は最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合は比例して短くなります。 +課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用すると、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意です。現在サポートしているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の列挙は、そのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への v1 の直接呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はその操作自身のコンポーネント `WanVideoGenerationRequest` にあります。 - ビデオ処理パラメータ + ビデオ処理のパラメータ - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルについては、プロバイダーはそのような切り替えを文書化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてこのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します +- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: `auto`、`origin` @@ -293,13 +344,15 @@ media 配列内の対応する順序でメディアアセットを参照しま 生成されるビデオの再生時間(秒): - wan2.5 モデル: 5 秒または 10 秒 - wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 -- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒はサポートされません) +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非対応) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は、入力ビデオの再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、モデルが適切な再生時間を選ぶスマート再生時間モードが有効になります +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は、 + 入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると + スマート再生時間モードが有効になり、モデルが適切な再生時間を選択します このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 - 範囲: `-1` ~ `30` + 範囲: `-1` から `30` @@ -307,10 +360,9 @@ media 配列内の対応する順序でメディアアセットを参照しま - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が、入力メディアの比率と意図に基づいて適切な -アスペクト比を自動的に推奨します。 + 生成されるビデオのアスペクト比。wan2.7 と wan3.0 のモデル専用です。 +wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 +wan3.0-video では、adaptive(デフォルト)が適切な値を自動的に推奨します入力メディアの比率と意図に基づくアスペクト比。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -318,25 +370,25 @@ wan3.0-video では、adaptive(デフォルト)が、入力メディアの 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) +- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P 非対応) - wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video, wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、解像度と size のどちらも指定していないビデオ生成リクエストを拒否します。解像度の階層が課金レートを選択するためです。チェックの前に resolution を大文字化し、大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P 非対応として挙げられている wan2.6、wan2.7、happyhorse-1.0 のモデルでは 480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。解像度ティアが課金レートを決めるためです。チェックの前に resolution を大文字化し、大文字化した値をそのまま転送します。この enum に含まれない値には 400 を返し、上記で 480P 非対応と記載した wan2.6、wan2.7、happyhorse-1.0 モデルでは、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 指定可能な値: `480P`、`720P`、`1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 範囲: `0` から `2147483647` インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデル用。 +wan2.6 および wan2.7-r2v モデル向けです。 - single: シングルショットのビデオ(デフォルト) - multi: マルチショットのビデオ @@ -344,19 +396,19 @@ wan2.6 および wan2.7-r2v モデル用。 - width*height 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ -wan2.6 T2V/R2V の場合(480P なし): + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ +wan2.6 T2V/R2V の場合(480P 非対応): 720P: 1280*720、720*1280、960*960、1088*832、832*1088 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -size と resolution の両方を送信した場合、課金階層を選択するのは size であり、resolution は引き続きこのプロキシがそのモデルで受け付ける値である必要があります。480P の size は、resolution の説明で 480P 非対応として挙げられているすべてのモデルで 400 を返します。 +size と resolution の両方を送信した場合、課金ティアを決めるのは size であり、resolution は引き続きこのプロキシがそのモデルで受け付ける値である必要があります。解像度の説明で 480P 非対応と記載されているすべてのモデルでは、480P の size を送信すると 400 が返ります。 - ウォーターマークのロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -`GET /v2/models/wan/happyhorse-1.0-video-edit/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 +スキーマから生成されています。このスキーマは Router が `GET /v2/models/wan/happyhorse-1.0-video-edit/openapi.json` で提供するもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 @@ -369,7 +421,7 @@ size と resolution の両方を送信した場合、課金階層を選択する - 音声生成を伴う I2V タスク用のオーディオURL + 音声生成を伴うI2VタスクのオーディオURL @@ -377,7 +429,7 @@ size と resolution の両方を送信した場合、課金階層を選択する - タスク完了時間 + タスクの完了時間 @@ -385,7 +437,7 @@ size と resolution の両方を送信した場合、課金階層を選択する - 元の入力プロンプト(ビデオタスク用) + オリジナルの入力プロンプト(ビデオタスク用) @@ -405,19 +457,19 @@ size と resolution の両方を送信した場合、課金階層を選択する - 元の入力プロンプト + オリジナルの入力プロンプト - 生成された画像のURLアドレス + 生成済み画像のURLアドレス - タスク実行時間 + タスクの実行時間 - タスク送信時間 + タスクの送信時間 @@ -437,13 +489,13 @@ size と resolution の両方を送信した場合、課金階層を選択する - タスクの総数 + タスクの合計数 - タスクステータス + タスクのステータス - 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` @@ -459,55 +511,55 @@ size と resolution の両方を送信した場合、課金階層を選択する - ビデオ解像度レベル(I2V および wan3.0-video タスク) + ビデオの解像度レベル(I2Vおよびwan3.0-videoタスク) - 生成されたビデオの再生時間(秒)(I2V および wan3.0-video タスク) + 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-video タスク) + 生成されたビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2I および I2I タスク) + 生成された画像の数(T2IおよびI2Iタスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間(秒)(wan3.0-video タスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) - 生成されたビデオのアスペクト比、例: 16:9(wan3.0-video タスク) + 生成されたビデオのアスペクト比。例: 16:9(wan3.0-videoタスク) - 画像解像度(T2I および I2I タスク) + 画像の解像度(T2IおよびI2Iタスク) - 生成されたビデオの数(T2V タスク) + 生成されたビデオの数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2V タスク) + 生成されたビデオの再生時間(秒)(T2Vタスク) - ビデオ解像度の比率(T2V タスク) + ビデオの解像度比率(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output`の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 + 失敗したリクエストの詳細情報。`output`の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message`にフォールバックする前にこちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index 8eb1e8ad51..f44eb5b3e0 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で HappyHorse 1.1 T2V を使う" description: "Comfy Router を通じて HTTP 経由で wan/happyhorse-1.1-t2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "HappyHorse 1.1 T2V" -translationSourceHash: e16717b0 +translationSourceHash: e1f68a5b translationFrom: development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx translationBlockHashes: "_intro": f001b07c "Quick start": 125cfd7d - "Schema": 88f94657 + "Schema": 0aa39fbc "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -186,83 +187,82 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-t2v/requests/$REQUEST_ID - オーディオファイルのダウンロードURL。対応フォーマット: mp3 と wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロード URL。対応フォーマット: mp3 と wav。reference_video_urls とは併用できません。 - 先頭フレーム画像のURL、またはBase64エンコードされたデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記は、先頭フレームをここでは -受け取りません。先頭フレームは first_frame タイプのメディア要素として受け取ります -(後述の media を参照)。また、wan2.6-i2v では成功する img_url ボディも、プロバイダーは -happyhorse-1.0-i2v および happyhorse-1.1-i2v では拒否します。さらに wan2.7/wan3.0 の -表記も参照アセットを media で受け取ります。画像フォーマット: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360-2000ピクセル。ファイルサイズ: 最大10MB。 + 最初のフレーム画像の URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview モデルと +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記は、最初のフレームをここでは受け取りません。 +最初のフレームは type が first_frame のメディア要素として受け取ります(下記の media を参照)。 +また、wan2.6-i2v で成功する img_url ボディは、happyhorse-1.0-i2v と happyhorse-1.1-i2v では +プロバイダーに拒否されます。さらに wan2.7/wan3.0 の表記も参照アセットを同様に media で受け取ります。 +画像フォーマット: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を -指定します。各要素には type フィールドと url フィールドが含まれます。このフィールドは、この -コンポーネントから提供されるすべてのモデルで共有されますが、あるモデルが受け付ける -type 値、およびそのモデルが画像やビデオの入力を img_url や -reference_video_urls ではなくここで受け取るかどうかは、モデルによって異なります。モデルごとの -サポートされる type 値: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame および - last_frame: JPEG/JPG/PNG/BMP/WEBP、各辺 240-8000 ピクセル、アスペクト比 1:8 - から 8:1、最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2-30 秒、最大 15MB)および first_clip(MP4/MOV、2-10 - 秒、各辺 240-4096 ピクセル、最大 100MB): パブリック HTTP/HTTPS URL; インラインの + メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントが提供するすべての +モデルで共有されており、あるモデルがどの type 値を受け付けるか、また画像やビデオの入力を +img_url や reference_video_urls ではなくここで持つかどうかは、モデルによって異なります。 +モデルごとの対応 type 値: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と + last_frame: JPEG/JPG/PNG/BMP/WEBP、1 辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、 + 最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 秒、 + 1 辺 240-4096 ピクセル、最大 100MB): パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(オプション、最大 1)、reference_image、reference_video。少なくとも - reference_image または reference_video を 1 つ指定する必要があり、reference_image と - reference_video の合計は最大 5 です。first_frame および reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、各辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1、最大 - 20MB、パブリック URL または data:\{MIME_type};base64,... URL。reference_video: パブリック - HTTP/HTTPS URL; インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(正確に 1 つ、編集対象のクリップ: MP4/MOV、2-10 秒、 - 各辺 240-4096 ピクセル、最大 100MB、パブリック HTTP/HTTPS URL; インラインの data: URL - は受け付けられません)に加えて、オプションで 0 から 4 の reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 各辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1、最大 20MB、パブリック URL +- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。少なくとも + 1 つの reference_image または reference_video が必要で、reference 画像と + reference ビデオの合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1 辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 + 20MB、パブリック URL または data:\{MIME_type};base64,... URL。reference_video: パブリックな + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(正確に 1 つ。編集対象のクリップ: MP4/MOV、2-10 秒、 + 1 辺 240-4096 ピクセル、最大 100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で 0 から 4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1 辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL)。 - wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 - reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、 - reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link とは - 併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link タイプ - と first_frame/last_frame タイプは、同じリクエスト内では同時に使用できません。 - 配列の順序が、プロンプト内のアセットの参照順序を定義します(Image 1、Video 1、 - Audio 1、...)。first_frame、last_frame および reference_image: JPEG/JPG/PNG/BMP/WEBP、 - 各辺 240-8000 ピクセル、アスペクト比最大 8:1、最大 20MB、パブリック URL または - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file および link: パブリック - HTTP/HTTPS URL; インラインの data: URL は受け付けられません。 + reference_image(最大 10)、reference_video(最大 5 クリップ、再生時間の合計 \<= 15 秒)、 + reference_audio(最大 5 クリップ、再生時間の合計 \<= 15 秒)、file(最大 1、link とは併用不可)、 + link(最大 1、file とは併用不可)。reference_*/file/link の type と + first_frame/last_frame の type は、同じリクエスト内では同時に使用できません。 + 配列の順序が、プロンプト内でのアセットの参照順(Image 1、Video 1、Audio 1、...)を定義します。 + first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、1 辺 240-8000 ピクセル、 + アスペクト比 最大 8:1、最大 20MB、パブリック URL または + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: パブリックな + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 - happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、正確に 1 つ。これらの表記は - 先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、アスペクト比 - 1:2.5 から 2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、パブリック URL または + 最初のフレームをここで受け取り、img_url では受け取りません。最低 300x300 ピクセル、アスペクト比 + 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 つ。これは - モデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 つ。これが + このモデル唯一の参照入力です。最短辺が最低 400 ピクセル、JPEG/JPG/PNG/WEBP、 最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。reference_video は - この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(正確に 1 つ、編集対象のクリップ: MP4/MOV、3-60 - 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト - 比 1:2.5 から 2.5:1、最大 100MB、パブリック HTTP/HTTPS URL; インラインの data: - URL は受け付けられません)に加えて、オプションで 0 から 5 の reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1、最大 20MB、パブリック URL - または data:\{MIME_type};base64,... URL)。 + この操作の入力 type ではありません。 +- happyhorse-1.0-video-edit: video(正確に 1 つ。編集対象のクリップ: MP4/MOV、3-60 秒、 + 長辺が最大 4096 ピクセル、短辺が最低 360 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、 + 最大 100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に + 加えて、任意で 0 から 5 つの reference_image(JPEG/JPG/PNG/WEBP、最低 300x300 ピクセル、 + アスペクト比 1:2.5 から 2.5:1 の間、最大 20MB、パブリック URL または + data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。これらのパートナーリファレンスにはメディア入力の記載がないため、 + テキストから動画への操作。これらのパートナー向けリファレンスにはメディア入力が記載されていないため、 このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対して - メディアの語彙を列挙していません。wan2.5-i2v-preview および wan2.6-i2v は先頭 - フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの数はパートナーの制約であり、このスキーマの制約ではありません。media には -minItems/maxItems が宣言されていません。これは、許容されるタイプとその上限がモデルごとに -異なるためです。スキーマ上の受け入れは、プロバイダーによる受け入れを意味しません。また、 -その逆に、上記のアセットごとの「最大 20MB」という数値(画像入力の上限であり、インラインで -送信できる唯一の入力)は、パートナーが最終的に受け取るアセットに対する上限であり、アセットが -パブリック URL の場合は記載どおりに適用されます。そのバイト列は Comfy を経由しないためです。 -インラインの data:\{MIME_type};base64,... URL は Comfy を経由し、転送上限にも直面します。 -Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返され、 -base64 はペイロードを約 4/3 に膨らませます。したがって、およそ 75 MB を超える単一のインライン -アセットは、ここに示すパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限であればインラインで問題なく収まるため、アセット 1 つ分についてはパートナーのルールが制約となります。複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB という Router の上限は、各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、パブリック URL として送信してください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記向けのメディア + ボキャブラリを列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初のフレームを + img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。media には +minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに異なるためです。 +スキーマが受け付けることはプロバイダーが受け付けることを意味しません。また逆方向について言えば、 +上記のアセットごとの「最大 20MB」という数値(画像入力の上限であり、インラインで送信できる唯一の入力) +は、最終的にパートナーが受け取るアセットに対するパートナーの上限であり、アセットがパブリック URL の +場合は記載どおりに適用されます。そのバイト列は Comfy を経由しないためです。インラインの +data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。 +Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 で応答されます。 +また base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、 +ここに記載されたパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限はインラインで余裕をもって収まります。そのため、1 つのアセットについてはパートナーのルールが制約となります。一方、トランスポートの上限は複数のアセットにまたがって制約します。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 @@ -272,134 +272,123 @@ base64 はペイロードを約 4/3 に膨らませます。したがって、 - メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明が各モデルについて列挙している画像入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を指定できます。これらのモデルのいずれにおいても、video、audio、file、link の入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明でモデルごとに列挙されている IMAGE 入力に限り、インラインの `data:{MIME_type};base64,...` URL。対象となる IMAGE 入力は、wan2.7-i2v では first_frame と last_frame、wan2.7-r2v では first_frame と reference_image、wan2.7-videoedit では reference_image、wan3.0-video と wan3.0-video-prime では first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v では first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v では reference_image、happyhorse-1.0-video-edit では reference_image です。これらのモデルのいずれについても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または (wan2.7-videoedit では) Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーに転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディの上限については、`media` の説明を参照してください。 - ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します + 逆プロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否するのではなく切り詰めます。これは prompt と同じ入力予算にカウントされます。 - テキストプロンプト。中国語と英語をサポートし、長さは 800 文字以内 -(wan3.0-video では最大 20,000 文字。制限を超えた内容は切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に従って被写体を参照するために -'character1'、'character2' などを使用します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを参照するために -'Image 1'、'Video 1'、'Audio 1' などを使用します。 + テキストプロンプト。中国語と英語をサポートします。文書化された長さを超えると、wan2.x モデルはプロンプトを拒否するのではなく切り詰めます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。プロバイダーは、prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト (約 20,000 文字の中国語) を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 + 複数の参照ビデオを使う wan2.6-r2v では、'character1'、'character2' などを使って、参照ビデオの順に被写体を指定します。例: "Character1 sings on the roadside, Character2 dances beside it" + wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' などを使って、media 配列内の対応する順序でメディアアセットを指定します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列。 + wan2.6-r2v モデル専用の参照ビデオ URL です。1~3 本のビデオ URL の配列。 入力の制限: -- フォーマット: mp4, mov -- 数量: 1〜3 本のビデオ -- 単一ビデオの長さ: 2〜30 秒 +- 形式: mp4, mov +- 本数: 1~3 本のビデオ +- 1 本のビデオの長さ: 2~30 秒 - 単一ファイルサイズ: 最大 30MB - audio_url と併用できません -参照の再生時間: 単一ビデオは最大 5 秒、2 本のビデオはそれぞれ最大 2.5 秒、3 本のビデオは比例して短くなります。 -課金: 実際に使用した参照再生時間に基づきます。 +参照の再生時間: ビデオ 1 本なら最大 5 秒、2 本ならそれぞれ最大 2.5 秒、3 本なら比例して短くなります。 +課金: 実際に使用された参照の再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はその操作自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 - ビデオ処理パラメータ + ビデオ処理のパラメータ - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。プロバイダーは他の wan モデルにはそのような切り替えを記載していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルについては、プロバイダーはこのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します +- auto (デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します 指定可能な値: `auto`, `origin` - 生成されるビデオの再生時間(秒): + 生成されるビデオの再生時間 (秒): - wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 -- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) +- wan2.6-t2v、wan2.6-i2v: 5、10、15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ (15 秒はサポートされません) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は、 - 入力ビデオの再生時間 + 出力ビデオの再生時間が 30 秒を超えてはなりません。-1 を指定すると - スマート再生時間モードが有効になり、モデルが適切な再生時間を選択します +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、モデルが適切な再生時間を選択するスマート再生時間モードが有効になります このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 範囲: `-1` から `30` - プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true + プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデルのみ。 + 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切な -アスペクト比を自動的に推奨します。 - - 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` +wan3.0-video では、adaptive (デフォルト) が適切なものを自動的に推奨します +入力メディアの比率と意図に基づくアスペクト比。 + + 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P は非サポート) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上流のデフォルトは 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -このプロキシは、resolution も size も指定していないビデオ生成リクエストを拒否します。 -これは、解像度ティアが課金レートを選択するためです。チェックの前に resolution を大文字に変換し、 -大文字に変換した値を転送します。この enum に含まれない値には 400 を返し、 -480P については(resolution として送信された場合も、480P の size として送信された場合も) -上記で 480P がないと記載されている wan2.6、wan2.7、happyhorse-1.0 モデルに対して 400 を返します。 - - Possible values: `480P`, `720P`, `1080P` +- wan2.6 モデル (t2v、i2v、r2v): 720P、1080P のみ (480P のサポートなし) +- wan2.7 モデル (i2v、t2v、r2v、videoedit): 720P、1080P (デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P (上流のデフォルト 1080P) +- happyhorse-1.0-* (t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-* (t2v、i2v、r2v): 480P、720P、1080P +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。課金レートを選択するのは解像度ティアだからです。resolution をチェックする前に大文字に変換し、大文字に変換した値をそのまま転送します。この enum に含まれない値に対しては 400 を返し、上記で 480P がないとされている wan2.6、wan2.7、happyhorse-1.0 の各モデルでは、480P に対して 400 を返します (resolution として送信された場合も、480P の size として送信された場合も同様です)。 + + 指定可能な値: `480P`、`720P`、`1080P` 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 - Range: `0` から `2147483647` + 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデル用です。 -- single: シングルショットビデオ(デフォルト) -- multi: マルチショットビデオ + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ動作します。 +wan2.6 および wan2.7-r2v モデル向け。 +- single: 単一ショットのビデオ (デフォルト) +- multi: マルチショットのビデオ - Possible values: `multi`, `single` + 指定可能な値: `multi`、`single` - 幅*高さ 形式のビデオ解像度。対応する解像度はモデルによって異なります。 -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ -wan2.6 T2V/R2V の場合(480P なし): + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P (480*832、832*480、624*624)、720P、1080P の各サイズ +wan2.6 T2V/R2V の場合 (480P なし): 720P: 1280*720、720*1280、960*960、1088*832、832*1088 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -size と resolution の両方を送信した場合、課金ティアを選択するのは size であり、 -resolution は引き続き、そのモデルに対してこのプロキシが受け付ける値である必要があります。 -480P の size は、resolution の説明で 480P がないと記載されているすべてのモデルで 400 を返します。 +size と resolution の両方が送信された場合、課金ティアを選択するのは size であり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、解像度の説明で 480P がないとされているすべてのモデルで 400 を返します。 - 透かしロゴを追加するかどうか。透かしは右下隅に配置されます。 + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 +Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 ### 出力 @@ -412,7 +401,7 @@ Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供する - 音声生成を伴う I2V タスクのオーディオURL + オーディオ生成を伴うI2Vタスク用のオーディオURL @@ -420,7 +409,7 @@ Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供する - タスクの完了時間 + タスク完了時間 @@ -440,11 +429,11 @@ Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供する - 画像のエラーコード(一部のタスクが失敗した場合に返されます) + 画像エラーコード(一部のタスクが失敗したときに返されます) - 画像のエラー情報(一部のタスクが失敗した場合に返されます) + 画像エラー情報(一部のタスクが失敗したときに返されます) @@ -456,11 +445,11 @@ Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供する - タスクの実行時間 + タスク実行時間 - タスクの送信時間 + タスク送信時間 @@ -468,7 +457,7 @@ Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供する - 画像生成タスクのタスク結果の統計 + 画像生成タスクのタスク結果統計 @@ -484,13 +473,13 @@ Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供する - タスクのステータス + タスクステータス - 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 + 完了したビデオ生成タスク用のビデオURL。リンクの有効期間は24時間 @@ -502,47 +491,47 @@ Router が `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` で提供する - ビデオ解像度レベル(I2V および wan3.0-video タスク) + ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) - 生成されたビデオの再生時間(秒)(I2V および wan3.0-video タスク) + 生成済みビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-video タスク) + 生成済みビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2I および I2I タスク) + 生成済み画像の数(T2IおよびI2Iタスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間(秒)(wan3.0-video タスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) - 生成されたビデオのアスペクト比。例: 16:9(wan3.0-video タスク) + 生成済みビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) - 画像の解像度(T2I および I2I タスク) + 画像解像度(T2IおよびI2Iタスク) - 生成されたビデオの数(T2V タスク) + 生成済みビデオの数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2V タスク) + 生成済みビデオの再生時間(秒)(T2Vタスク) - ビデオの解像度比率(T2V タスク) + ビデオ解像度比率(T2Vタスク) diff --git a/ja/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx b/ja/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx index 381a4e4dfc..074c58128b 100644 --- a/ja/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Wan 2.5 T2I Preview を使用する" description: "Comfy Router 経由で wan/wan2.5-t2i-preview を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Wan 2.5 T2I Preview" -translationSourceHash: 9d519a07 +translationSourceHash: 1b62e07d translationFrom: development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx translationBlockHashes: "_intro": 975ad7fc "Quick start": 9cc4b789 - "Schema": 579649db + "Schema": 77ffea28 "Examples": e420aca1 --- + {/* GENERATED FILE. Generated from router-schemas/wan/wan2.5-t2i-preview.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -172,19 +173,19 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID ### 入力 - プロンプトワードなどの基本情報を入力します。 + プロンプトなどの基本的な情報を入力します。 - 画像に表示したくないコンテンツを記述するネガティブプロンプト + 画像に表示したくない内容を記述するためのネガティブプロンプトです。500文字を超えると、モデルは拒否せずに切り捨てます。prompt と同じ入力予算を消費します。 - 期待する画像要素や視覚的特徴を記述するポジティブプロンプト。中国語と英語をサポートし、長さは 800 文字以内 + 期待する画像の要素や視覚的特徴を記述するためのポジティブプロンプトです。中国語と英語に対応しています。2,000文字を超えると、モデルは拒否せずにプロンプトを切り捨てます。prompt と negative_prompt を合わせて約60,850バイトのUTF-8テキスト(約20,000文字の中国語)を超えるリクエストはプロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 - テキストから画像への生成のために呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定します。`POST /proxy/wan/api/v1/services/aigc/text2image/image-synthesis` への v1 の直接呼び出しでは必ず指定する必要があり、受け入れられる表記の enum はその操作自身のコンポーネント `WanImageGenerationRequest` にあります。 + テキストから画像への生成に使用するモデルのIDです。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` のパスセグメント `{model}` から設定します。v1 の `POST /proxy/wan/api/v1/services/aigc/text2image/image-synthesis` を直接呼び出す場合は必ず指定する必要があり、受け付けられる表記の列挙はそのオペレーション自身のコンポーネント `WanImageGenerationRequest` にあります。 @@ -192,13 +193,13 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 生成する画像の数。範囲は 1~4、デフォルトは 4 + 生成する画像の数。範囲は 1-4、デフォルトは 4 範囲: `1` から `4` - プロンプトのインテリジェント書き換えを有効にします。デフォルトは true + プロンプトのインテリジェントな書き換えを有効にします。デフォルトは true @@ -208,14 +209,15 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 出力画像の解像度。形式は 幅*高さ です。デフォルトは 1280*1280。API は 1638400 (1280*1280) から 2073600 (1440*1440) までのピクセル面積を、1:4 から 4:1 の間のアスペクト比で受け入れます。そのため 768*2700 も有効です。 + 出力画像の解像度。幅*高さの形式で指定します。デフォルトは 1280*1280 です。API は 1638400(1280*1280)から 2073600(1440*1440)までのピクセル面積を、1:4 から 4:1 までのアスペクト比で受け付けるため、768*2700 も有効です 右下隅にウォーターマークロゴを追加するかどうか -Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +`GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で Router が提供するスキーマから生成されています。これはリクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 + ### 出力 @@ -227,7 +229,7 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - オーディオ生成を伴うI2Vタスク用のオーディオURL + 音声生成を伴うI2Vタスク用のオーディオURL @@ -235,7 +237,7 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - タスクの完了時間 + タスク完了時間 @@ -243,7 +245,7 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - 元の入力プロンプト(ビデオタスク用) + オリジナルの入力プロンプト(ビデオタスク用) @@ -255,15 +257,15 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - 画像のエラーコード(一部のタスクが失敗した場合に返されます) + 画像エラーコード(一部のタスクが失敗した場合に返されます) - 画像のエラー情報(一部のタスクが失敗した場合に返されます) + 画像エラー情報(一部のタスクが失敗した場合に返されます) - 元の入力プロンプト + オリジナルの入力プロンプト @@ -299,13 +301,13 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - タスクのステータス + タスクステータス - 取り得る値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 取り得る値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です @@ -321,7 +323,7 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - 生成されたビデオの再生時間(秒単位)(I2Vおよびwan3.0-videoタスク) + 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) @@ -333,11 +335,11 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - 入力ビデオの再生時間(秒単位)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間(秒単位)(wan3.0-videoタスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) @@ -353,11 +355,11 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - 生成されたビデオの再生時間(秒単位)(T2Vタスク) + 生成されたビデオの再生時間(秒)(T2Vタスク) - ビデオ解像度の比率(T2Vタスク) + ビデオの解像度比率(T2Vタスク) @@ -365,7 +367,7 @@ Router が `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` で提供する - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx b/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx index b013b80ba9..444e6a614d 100644 --- a/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Wan 2.5 T2V Preview を使う" description: "Comfy Router 経由で HTTP から wan/wan2.5-t2v-preview を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 2.5 T2V Preview" -translationSourceHash: 51e7ac3c +translationSourceHash: e7df4aa3 translationFrom: development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx translationBlockHashes: "_intro": 111ed2f7 "Quick start": d4fb170b - "Schema": 73f1810d + "Schema": 62b9e06a "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -182,133 +183,128 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests/$REQUEST_ID ### 入力 - プロンプト語句などの基本情報を入力します。 + プロンプトなどの基本情報を入力します。 - オーディオファイルのダウンロードURL。サポートされる形式: mp3 および wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls と併用できません。 - 最初のフレームの画像URLまたはBase64エンコードデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x i2v の表記はここで最初のフレームを -受け取りません。first_frame タイプのメディア要素として受け取ります(後述の media を -参照)。また、wan2.6-i2v で成功する img_url ボディは、happyhorse-1.0-i2v および -happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 の表記も + 先頭フレームの画像URLまたはBase64エンコードされたデータ。wan2.5-i2v-preview および +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系のスペルでは、先頭フレームをここでは受け取りません。 +先頭フレームは type が first_frame の media 要素として受け取ります(後述の media を参照)。 +また、wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v と +happyhorse-1.1-i2v ではプロバイダーに拒否されます。さらに wan2.7/wan3.0 系のスペルも 参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 +解像度: 360〜2000ピクセル。ファイルサイズ: 最大10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を -指定します。各要素は type フィールドと url フィールドを持ちます。このフィールドは -このコンポーネントから提供されるすべてのモデルで共有されており、あるモデルがどの -type 値を受け付けるか、また img_url や reference_video_urls ではなくここで画像や -ビデオの入力を受け取るかどうかは、モデルによって異なります。モデルごとの -サポートされる type 値: + メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントから提供される +すべてのモデルで共通であり、どの type 値を受け付けるか、またそもそも画像やビデオの入力を +img_url や reference_video_urls ではなくここで受け取るかどうかは、モデルごとに異なります。 +モデルごとの対応 type 値: - wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺あたり 240-8000 ピクセル、アスペクト比は 1:8 - から 8:1 の間、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2〜30秒、最大 15MB)および first_clip(MP4/MOV、2〜10 - 秒、1辺あたり 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの + last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺240〜8000ピクセル、アスペクト比1:8〜8:1、 + 最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2〜30秒、最大15MB)と first_clip(MP4/MOV、2〜10秒、 + 1辺240〜4096ピクセル、最大100MB): 公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。少なくとも - 1つの reference_image または reference_video が必要で、reference 画像と - reference ビデオの合計は最大5つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、1辺あたり 240-8000 ピクセル、アスペクト比は 1:8 から 8:1 の間、最大 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。 + reference_image または reference_video が少なくとも1つ必要で、reference_image と + reference_video の合計は最大5つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺240〜8000ピクセル、アスペクト比1:8〜8:1、最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(厳密に1つ、編集対象のクリップ: MP4/MOV、2〜10秒、 - 1辺あたり 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL +- wan2.7-videoedit: video(ちょうど1つ。編集対象のクリップ: MP4/MOV、2〜10秒、 + 1辺240〜4096ピクセル、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で0〜4つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり 240-8000 ピクセル、アスペクト比は 1:8 から 8:1 の間、最大 20MB、公開URL + 1辺240〜8000ピクセル、アスペクト比1:8〜8:1、最大20MB、公開URL または data:\{MIME_type};base64,... URL)。 - wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15s)、 - reference_audio(最大5クリップ、合計再生時間 \<= 15s)、file(最大1、link とは併用 - 不可)、link(最大1、file とは併用不可)。reference_*/file/link タイプと - first_frame/last_frame タイプは、同じリクエスト内では相互に排他的です。 - 配列の順序がプロンプト内のアセットの参照順序を定義します(Image 1、Video 1、 - Audio 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり 240-8000 ピクセル、アスペクト比は最大 8:1、最大 20MB、公開URLまたは - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 - HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、厳密に1つ。これらの表記 - は最初のフレームを img_url ではなくここで受け取ります。少なくとも 300x300 ピクセル、 - アスペクト比は 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開URLまたは + reference_audio(最大5クリップ、合計再生時間 \<= 15s)、file(最大1、link と併用不可)、 + link(最大1、file と併用不可)。reference_*/file/link タイプと first_frame/last_frame + タイプは同一リクエスト内で同時に使用できません。配列の順序が、プロンプト内での + アセットの参照順(Image 1、Video 1、Audio 1、...)を定義します。first_frame、last_frame、 + reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺240〜8000ピクセル、アスペクト比最大8:1、 + 最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video、 + reference_audio、file、link: 公開HTTP/HTTPS URL。インラインの data: URL は + 受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらのスペルは + 先頭フレームを img_url ではなくここで受け取ります。少なくとも300x300ピクセル、アスペクト比 + 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9つ。これは - このモデル唯一の参照入力です。短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 - 最大 20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video は +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9つ。これが + このモデル唯一の参照入力です。最短辺が少なくとも400ピクセル、JPEG/JPG/PNG/WEBP、 + 最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video は この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(厳密に1つ、編集対象のクリップ: MP4/MOV、3〜60 - 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト - 比は 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: +- happyhorse-1.0-video-edit: video(ちょうど1つ。編集対象のクリップ: MP4/MOV、3〜60 + 秒、長辺が最大4096ピクセル、短辺が少なくとも360ピクセル、アスペクト比 + 1:2.5〜2.5:1、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で0〜5つの reference_image(JPEG/JPG/PNG/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比は 1:2.5 から 2.5:1 の間、最大 20MB、公開URL + 少なくとも300x300ピクセル、アスペクト比1:2.5〜2.5:1、最大20MB、公開URL または data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。これらのパートナー参照ドキュメントには media 入力の記載が - ないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に - ついて media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初の - フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で - 受け取ります。 -上記のモデルごとの数はこのスキーマの制約ではなく、パートナーの制約です。media には -minItems/maxItems が宣言されていません。許容されるタイプとその上限はモデルごとに -異なるためです。スキーマが受け付けることはプロバイダーが受け付けることを意味しません。 -また逆に、上記のアセットごとの「最大 20MB」という数値は、画像入力に対する上限であり、 -インラインで送信できる唯一の入力に対する上限であり、パートナーが最終的に保持する -アセットに対するパートナーの上限です。そしてアセットが公開URLである場合は、これらの -数値は書かれているとおりに適用されます。そのバイト列は Comfy を経由しないためです。 -インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送の上限にも -直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。 -また base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一の -インラインアセットは、ここにあるパートナーのルールに到達する前に拒否されます。 -そのサイズでは、単一のアセットはパートナー自身の20MB の上限はインラインで余裕をもって収まるため、アセット 1 つの場合はパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となり、100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 + テキストから動画への操作です。これらのパートナー参照ドキュメントにはメディア入力が + 記載されていないため、このフィールドは未設定のままにします。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらのスペル向けの + メディア語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを + img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの個数はこのスキーマの制約ではなくパートナーの制約です。media には +minItems/maxItems が宣言されていません。これは受け付け可能なタイプとその上限が +モデルごとに異なるためです。スキーマが受け付けることは、プロバイダーが受け付けることを +意味しません。逆方向についても同様で、上記のアセットごとの「最大20MB」という数値は、 +画像入力に対する上限であり、インラインで送信できる唯一の入力に対する上限です。 +これはパートナーが最終的に受け取るアセットに対する上限であり、アセットが公開URLの +場合は記載どおりに適用されます。そのバイト列は Comfy を経由しないためです。インラインの +data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の上限にも直面します。 +Comfy Router の POST ボディは合計100 MiBに制限され、それを超えると 413 が返されます。 +また base64 はペイロードを約4/3に膨らませるため、およそ75 MBを超える単一の +インラインアセットは、ここに示すパートナーのルールに到達する前に拒否されます。 +そのサイズでは、パートナー自身の +20MB の上限はインラインでも余裕を持って収まるため、アセットが 1 つの場合はパートナーのルールが制約となります。複数のアセットにまたがる場合は転送上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 - メディアアセットの種類 + メディアアセットのタイプ - 使用可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明が各モデルについて列挙している IMAGE 入力、すなわち wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image に限り、インラインの `data:{MIME_type};base64,...` URL を指定できます。これらのモデルのいずれにおいても、video、audio、file、link の入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーに転送されます。モデルごとのサイズとピクセル上限、およびインラインのペイロードを合計で制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明で各モデルについて列挙されている IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を指定できます。これらのモデルのビデオ、オーディオ、ファイル、リンクのいずれの入力も、インラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを合計で制限する 100 MiB の Router リクエストボディの上限については、`media` の説明を参照してください。 - ネガティブプロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します + ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り詰めます。prompt と同じ入力予算にカウントされます。 - テキストプロンプト。中国語と英語をサポートし、長さは 800 文字以内です -(wan3.0-video では最大 20,000 文字。制限を超えた内容は切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、'character1'、'character2' などを使用して、 -参照ビデオの順序どおりに被写体を参照します。例: "Character1 が道端で歌い、そのそばで Character2 が踊る" -wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' などを使用して、 -media 配列内の対応する順序でメディアアセットを参照します。 + テキストプロンプト。中国語と英語をサポートします。独自に定められた長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り詰めます。wan2.5 と wan2.6 は 1,500 文字、wan2.7 は 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。プロバイダーは、prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 文字の中国語)を超えるリクエストを拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。wan2.6-r2v で複数の参照ビデオを使う場合は、参照ビデオの順序に従って 'character1'、'character2' などで被写体を参照してください。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを参照するために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列です。 入力の制限: -- フォーマット: mp4, mov -- 本数: 1〜3 本のビデオ +- 形式: mp4、mov +- 数量: 1〜3 本のビデオ - 単一ビデオの長さ: 2〜30 秒 - 単一ファイルサイズ: 最大 30MB -- audio_url とは併用できません -参照の再生時間: ビデオ 1 本で最大 5 秒、2 本でそれぞれ最大 2.5 秒、3 本ではそれに比例して短くなります。 -課金: 実際に使用した参照の再生時間に基づきます。 +- audio_url と併用できません +参照再生時間: ビデオ 1 本の場合は最大 5 秒、2 本の場合は各最大 2.5 秒、3 本の場合はそれぞれ比例して短くなります。 +課金: 実際に使用された参照再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router はこれを `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の列挙はそのオペレーション自身のコンポーネントである `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -316,27 +312,26 @@ media 配列内の対応する順序でメディアアセットを参照しま - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされています。他の wan モデルについては、プロバイダーはそのような切り替えを記載していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてそのような切り替えをドキュメント化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 - auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します -- origin: 入力ビデオのオリジナルオーディオを強制的に保持します +- origin: 入力ビデオのオリジナルのオーディオを強制的に保持します - 使用可能な値: `auto`, `origin` + 指定可能な値: `auto`、`origin` 生成されるビデオの再生時間(秒): -- wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 -- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒はサポートされません) +- wan2.5 モデル: 5 または 10 秒 +- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 +- wan2.6-r2v: 5 または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、 - モデルが適切な再生時間を選ぶスマート再生時間モードが有効になります -このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 はスマート再生時間モードを有効にし、モデルが適切な再生時間を選択します +このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 範囲: `-1` から `30` @@ -346,23 +341,20 @@ media 配列内の対応する順序でメディアアセットを参照しま - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 + 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデルのみ。wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 - 使用可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルトは 1080P) +- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P 非対応) +- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) - wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、解像度とサイズのどちらも指定しないビデオ生成リクエストを拒否します。解像度のティアが課金レートを決定するためです。このプロキシは、解像度をチェックする前に大文字に変換し、その大文字に変換した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P がないと記載されている wan2.6、wan2.7、happyhorse-1.0 モデルでは、480P(解像度として送信された場合でも、480P のサイズとして送信された場合でも)に対して 400 を返します。 +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。これは解像度ティアが課金レートを選択するためです。チェック前に resolution を大文字化し、その大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P 非対応として示した wan2.6、wan2.7、happyhorse-1.0 モデルでは、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 指定可能な値: `480P`、`720P`、`1080P` @@ -374,27 +366,28 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。wan2.6 および wan2.7-r2v モデル用です。 -- single: シングルショットビデオ(デフォルト) -- multi: マルチショットビデオ + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 +wan2.6 および wan2.7-r2v モデル向け。 +- single: 単一ショットのビデオ(デフォルト) +- multi: マルチショットのビデオ 指定可能な値: `multi`、`single` - 幅*高さ形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ + 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ wan2.6 T2V/R2V の場合(480P なし): 720P: 1280*720、720*1280、960*960、1088*832、832*1088 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -サイズと解像度の両方が送信された場合、課金ティアを選択するのはサイズであり、解像度は引き続きこのプロキシがそのモデルに対して受け入れる値でなければなりません。480P のサイズは、解像度の説明で 480P がないと記載されているすべてのモデルで 400 を返します。 +size と resolution の両方が送信された場合、size が課金ティアを選択し、resolution はそのモデルに対してこのプロキシが受け入れる値である必要があります。480P の size は、解像度の説明で 480P 非対応として示されているすべてのモデルで 400 を返します。 ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます -Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 +`GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 @@ -407,7 +400,7 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - オーディオ生成を伴う I2V タスク用のオーディオ URL + 音声生成を伴う I2V タスク用のオーディオURL @@ -415,11 +408,11 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - タスクの完了時間 + タスク完了時間 - 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) @@ -447,7 +440,7 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - 生成された画像の URL アドレス + 生成済み画像のURLアドレス @@ -459,7 +452,7 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - タスク ID + タスクID @@ -475,17 +468,17 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - タスクの総数 + タスクの合計数 - タスクステータス + タスクのステータス - 取り得る値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 完了したビデオ生成タスクのビデオ URL。リンクの有効期間は 24 時間 + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です @@ -497,11 +490,11 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - ビデオ解像度レベル(I2V および wan3.0-video タスク) + ビデオの解像度レベル(I2V タスクおよび wan3.0-video タスク) - 生成されたビデオの再生時間(秒単位)(I2V および wan3.0-video タスク) + 生成されたビデオの再生時間(秒)(I2V タスクおよび wan3.0-video タスク) @@ -509,15 +502,15 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - 生成された画像の数(T2I および I2I タスク) + 生成された画像の数(T2I タスクおよび I2I タスク) - 入力ビデオの再生時間(秒単位)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-video タスク) - 出力ビデオの再生時間(秒単位)(wan3.0-video タスク) + 出力ビデオの再生時間(秒)(wan3.0-video タスク) @@ -525,7 +518,7 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - 画像解像度(T2I および I2I タスク) + 画像の解像度(T2I タスクおよび I2I タスク) @@ -533,19 +526,19 @@ Router が `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` で提供する - 生成されたビデオの再生時間(秒単位)(T2V タスク) + 生成されたビデオの再生時間(秒)(T2V タスク) - ビデオ解像度の比率(T2V タスク) + ビデオの解像度比率(T2V タスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 + 失敗したリクエストに関する詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index 2d6c1dcf6c..3ccf4f9b66 100644 --- a/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -14,6 +14,7 @@ translationBlockHashes: + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; diff --git a/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index 3eb347fac8..04268f12c4 100644 --- a/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -14,6 +14,7 @@ translationBlockHashes: + {/* 生成済みファイル。このディレクトリの code.yaml を編集し、`pnpm code-pages:gen` を実行してください。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; diff --git a/ja/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 506a250e92..f60b9560f0 100644 --- a/ja/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Wan 2.7 I2V を使う" description: "Comfy Router 経由で HTTP を使って wan/wan2.7-i2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 2.7 I2V" -translationSourceHash: 6c8ca8c8 +translationSourceHash: 5c0685e4 translationFrom: development/comfy-router/models/wan/wan2-7-i2v/code.mdx translationBlockHashes: "_intro": d49c4d30 "Quick start": 167fa44a - "Schema": ac50dc1f + "Schema": 5e5f0bca "Examples": 5ffd46d7 --- + {/* 生成済みファイル。このディレクトリの code.yaml を編集して `pnpm code-pages:gen` を実行してください。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -205,131 +206,67 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests/$REQUEST_ID \ ### 入力 - プロンプトなど、基本情報を入力します。 + プロンプトなどの基本情報を入力します。 - オーディオファイルのダウンロード URL。対応形式: mp3 と wav。reference_video_urls とは併用できません。 + 音声ファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls とは併用できません。 - 先頭フレーム画像の URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記は、先頭フレームをここでは -受け取りません。type が first_frame のメディア要素として受け取ります(後述の media を -参照)。また、wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v および -happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 の表記も参照アセットを -media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレームの画像URLまたはBase64エンコードデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記は、先頭フレームをここでは受け取りません。type が first_frame のメディア要素として受け取ります(後述の media を参照)。また、wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v および happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 の表記も、参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360~2000ピクセル。ファイルサイズ: 最大10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を -指定します。各要素は type と url フィールドを含みます。このフィールドはこの -コンポーネントから提供されるすべてのモデルで共通であり、どのモデルがどの type 値を -受け付けるか、また画像やビデオの入力を img_url や reference_video_urls ではなく -ここで受け取るかどうかは、モデルによって異なります。モデルごとの対応 type 値: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1 辺あたり 240-8000 ピクセル、アスペクト比 1:8 - から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 - 秒、1 辺あたり 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの - data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1 件)、reference_image、reference_video。少なくとも - 1 つの reference_image または reference_video が必要で、reference_image と - reference_video の合計は最大 5 件です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、1 辺あたり 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 - 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 - HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(正確に 1 件、編集対象のクリップ: MP4/MOV、2-10 秒、 - 1 辺あたり 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL - は受け付けられません)に加えて、任意で 0 から 4 件の reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1 辺あたり 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL - または data:\{MIME_type};base64,... URL)。 -- wan3.0-video, wan3.0-video-prime: first_frame(最大 1 件)、last_frame(最大 1 件)、 - reference_image(最大 10 件)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、 - reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1 件、link とは併用 - 不可)、link(最大 1 件、file とは併用不可)。reference_*/file/link タイプ - と first_frame/last_frame タイプは、同一リクエスト内で排他的です。 - 配列の順序がプロンプト内のアセットの参照順序を定義します(Image 1、Video 1、 - Audio 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 - 1 辺あたり 240-8000 ピクセル、アスペクト比 最大 8:1、最大 20MB、公開 URL または - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 - HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame のみ、正確に 1 件。これらの表記は - 先頭フレームを img_url ではなくここで受け取ります。少なくとも 300x300 ピクセル、アスペクト比 - 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または - data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image のみ、1 から 9 件。これが - このモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 - 最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video は - この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(正確に 1 件、編集対象のクリップ: MP4/MOV、3-60 - 秒、長辺 最大 4096 ピクセル、短辺 少なくとも 360 ピクセル、アスペクト - 比 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: - URL は受け付けられません)に加えて、任意で 0 から 5 件の reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 20MB、公開 URL - または data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - テキストから動画への操作。対応するパートナーの参照ドキュメントにはメディア入力の記載が - ないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: このコンポーネントはこれらの表記向けの - メディア語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭 - フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で - 受け取ります。 -上記のモデルごとの件数はこのスキーマの制約ではなく、パートナーの制約です。media には -minItems/maxItems が宣言されていません。許容される type とその上限はモデルごとに -異なるためです。スキーマが受け入れてもプロバイダーが受け入れるとは限りません。逆方向も -同様で、上記のアセットごとの「最大 20MB」という数値(画像入力に対する上限であり、 -インラインで送信できる唯一の入力です)は、最終的に扱うアセットに対するパートナーの -上限であり、アセットが公開 URL の場合には記載どおりに適用されます。そのバイト列が -Comfy を通らないためです。インラインの data:\{MIME_type};base64,... -URL は Comfy を通るため、転送時の上限にも直面します。Comfy Router -の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返され、base64 は -ペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、 -ここに挙げたパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限はインラインであれば余裕を持って収まるため、アセット1件の場合はパートナーのルールが制約となります。一方、トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは公開 URL として送信してください。 + メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントから提供されるすべてのモデルで共有されますが、あるモデルがどの type 値を受け付けるか、また画像やビデオの入力を img_url や reference_video_urls ではなくここで受け取るかどうかは、モデルによって異なります。モデルごとの対応 type 値: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺あたり240~8000ピクセル、アスペクト比1:8~8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2~30秒、最大15MB)と first_clip(MP4/MOV、2~10秒、1辺あたり240~4096ピクセル、最大100MB): 公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。reference_image または reference_video が少なくとも1つ必要で、reference_image と reference_video の合計は最大5です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、1辺あたり240~8000ピクセル、アスペクト比1:8~8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video: 公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、2~10秒、1辺あたり240~4096ピクセル、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で0~4個の reference_image(JPEG/JPG/PNG/BMP/WEBP、1辺あたり240~8000ピクセル、アスペクト比1:8~8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15秒)、reference_audio(最大5クリップ、合計再生時間 \<= 15秒)、file(最大1、link とは併用不可)、link(最大1、file とは併用不可)。reference_*/file/link の各 type と first_frame/last_frame の各 type は、同じリクエスト内では同時に使用できません。配列の順序がプロンプト内でのアセットの参照順(Image 1、Video 1、Audio 1、…)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺あたり240~8000ピクセル、アスペクト比最大8:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記は先頭フレームを img_url ではなくここで受け取ります。最低300x300ピクセル、アスペクト比1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9個。これがこのモデルの唯一の参照入力です。最短辺が最低400ピクセル、JPEG/JPG/PNG/WEBP、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL。reference_video はこの操作の入力 type ではありません。 +- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、3~60秒、長辺が最大4096ピクセル、短辺が最低360ピクセル、アスペクト比1:2.5~2.5:1、最大100MB、公開HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で0~5個の reference_image(JPEG/JPG/PNG/WEBP、最低300x300ピクセル、アスペクト比1:2.5~2.5:1、最大20MB、公開URLまたは data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作。これらのパートナーの参照ドキュメントにはメディア入力が記載されていないため、このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記向けのメディア語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの件数はパートナーの制約であり、このスキーマの制約ではありません。許容される type とその上限はモデルごとに異なるため、media には minItems/maxItems が宣言されていません。スキーマが受け付けることは、プロバイダーが受け付けることを意味しません。また逆に、上記のアセットごとの「最大20MB」という数値(画像入力の上限であり、インラインで送信できる唯一の入力です)は、パートナーが最終的に受け取るアセットに対するパートナー側の上限であり、アセットが公開URLの場合はそのまま適用されます。そのバイト列はComfyを経由しないためです。インラインの data:\{MIME_type};base64,... URL はComfyを経由するため、転送時の上限にも直面します。Comfy RouterのPOSTボディは合計100 MiBに制限され、超えると413で応答されます。またbase64はペイロードを約4/3に膨らませるため、およそ75MBを超える単一のインラインアセットは、ここに示すパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限であればインラインでも余裕を持って収まるため、アセット 1 つ分についてはパートナーのルールが制約となります。複数のアセットにまたがる場合は転送上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 - メディアアセットの種類 + メディアアセットのタイプ - 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL: 公開 HTTP/HTTPS URL、または(上記の `media` の説明で各モデルごとに挙げられている IMAGE 入力に限り)インラインの `data:{MIME_type};base64,...` URL です。各モデルで対象となる IMAGE 入力は次のとおりです。wan2.7-i2v では first_frame と last_frame、wan2.7-r2v では first_frame と reference_image、wan2.7-videoedit では reference_image、wan3.0-video と wan3.0-video-prime では first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v では first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v では reference_image、happyhorse-1.0-video-edit では reference_image です。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデル呼び出しを行うものであり、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されることなく、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明でモデルごとに列挙されている画像入力に限り、インラインの `data:{MIME_type};base64,...` URL です。対象となる画像入力は次のとおりです: wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame・last_frame・reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image。これらのモデルのビデオ、オーディオ、ファイル、リンクの入力はいずれもインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーに転送されます。モデルごとのサイズとピクセルの上限、およびインラインペイロードを合計で制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します + 逆プロンプトは、ビデオ画面に映したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り詰めます。これは prompt と同じ入力バジェットに算入されます。 - テキストプロンプト。中国語と英語をサポートし、長さは 800 文字以内です -(wan3.0-video では最大 20,000 文字。上限を超えたコンテンツは切り詰められます)。 -複数の参照ビデオを使用する wan2.6-r2v では、'character1'、'character2' などを使用して、 -参照ビデオの順序で被写体を参照します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' などを使用して、 -media 配列内の対応する順序でメディアアセットを参照します。 + テキストプロンプト。中国語と英語をサポートします。それぞれ文書化された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り詰めます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字まで受け付けます。prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 中国語文字)を超えるリクエストはプロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。複数の参照ビデオを使用する wan2.6-r2v では、参照ビデオの順序に従って被写体を 'character1'、'character2' などで参照します。例: "Character1 sings on the roadside, Character2 dances beside it" wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを 'Image 1'、'Video 1'、'Audio 1' などで参照します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 件のビデオ URL の配列。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列です。 入力の制限: -- 形式: mp4, mov -- 数量: 1~3 本のビデオ -- 単一ビデオの長さ: 2~30 秒 -- 単一ファイルサイズ: 最大 30MB -- audio_url と併用できません -参照再生時間: 単一ビデオは最大 5 秒、2 本のビデオはそれぞれ最大 2.5 秒、3 本のビデオはそれに比例して短くなります。 -課金: 実際に使用した参照再生時間に基づきます。 +- 形式: mp4、mov +- 数量: 1〜3 本のビデオ +- 1 本あたりのビデオの長さ: 2〜30 秒 +- 1 ファイルあたりのサイズ: 最大 30MB +- audio_url とは併用できません +参照の再生時間: ビデオ 1 本なら最大 5 秒、2 本なら各最大 2.5 秒、3 本なら比例して短くなります。 +課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用時は prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け入れられる表記の列挙はその操作自身のコンポーネントである `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -337,30 +274,30 @@ media 配列内の対応する順序でメディアアセットを参照しま - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルにはそのような切り替えを記載していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルについては、プロバイダーはそのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto (デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します -- origin: 入力ビデオのオリジナルのオーディオを強制的に保持します +- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します +- origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 指定可能な値: `auto`, `origin` + 可能な値: `auto`、`origin` 生成されるビデオの再生時間(秒): - wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v, wan2.6-i2v: 5 秒、10 秒、または 15 秒 -- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒はサポートされません) -- wan2.7-i2v, wan2.7-t2v: [2, 15] の整数 -- wan2.7-r2v, wan2.7-videoedit: [2, 10] の整数 +- wan2.6-t2v、wan2.6-i2v: 5、10、15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非対応) +- wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 +- wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 - wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、 - 入力ビデオの再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。 - -1 を指定すると、モデルが適切な再生時間を選択するスマート再生時間モードが有効になります -このプロキシは、[-1, 30] の範囲外の再生時間に対して 400 を返します。 + 入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、 + モデルが適切な再生時間を選択するスマート再生時間モードが有効になります +このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 - 範囲: `-1` ~ `30` + 範囲: `-1` から `30` @@ -369,35 +306,34 @@ media 配列内の対応する順序でメディアアセットを参照しま 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 +wan2.7 モデルでは、指定しない場合は解像度のティアに基づいてデフォルトが決まります。 +wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 - 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: -- wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 モデル (t2v, i2v, r2v): 720P, 1080P のみ(480P はサポートされません) -- wan2.7 モデル (i2v, t2v, r2v, videoedit): 720P, 1080P(デフォルトは 1080P) -- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(アップストリームのデフォルトは 1080P) +- wan2.5-i2v-preview: 480P、720P、1080P +- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P 非対応) +- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルト 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、resolution と size のどちらも指定していないビデオ生成リクエストを拒否します。resolution のティアが課金レートを決定するためです。検証の前に resolution を大文字に変換し、その大文字化した値を転送します。また、この enum に含まれない値には 400 を返し、上記で 480P に対応しないものとして挙げた wan2.6、wan2.7、happyhorse-1.0 モデルでは 480P(resolution として送信された場合でも、480P の size として送信された場合でも)に対して 400 を返します。 +このプロキシは、resolution と size のどちらも指定されていないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決めるためです。チェックの前に resolution を大文字化して、大文字化した値を転送します。この列挙に含まれない値には 400 を返し、上記で 480P 非対応として挙げた wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 指定可能な値: `480P`、`720P`、`1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 範囲: `0` から `2147483647` インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデル用。 +wan2.6 および wan2.7-r2v モデル向けです。 - single: 単一ショットのビデオ(デフォルト) - multi: マルチショットのビデオ @@ -406,18 +342,20 @@ wan2.6 および wan2.7-r2v モデル用。 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ +wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ wan2.6 T2V/R2V の場合(480P なし): 720P: 1280*720、720*1280、960*960、1088*832、832*1088 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -size と resolution の両方を送信した場合、課金されるティアを選択するのは size であり、resolution はモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、解像度の説明で 480P に対応しないと記載されているすべてのモデルで 400 を返します。 +size と resolution の両方が送信された場合、課金階層を選択するのは size であり、 +resolution は引き続きこのプロキシがモデルに対して受け付ける値である必要があります。480P の size +は、解像度の説明で 480P 非対応として挙げられているすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -Router が `GET /v2/models/wan/wan2.7-i2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しの検証に使用されるドキュメントと同じものです。 +ルーターが `GET /v2/models/wan/wan2.7-i2v/openapi.json` で提供するスキーマから生成されています。これはリクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 @@ -426,11 +364,11 @@ Router が `GET /v2/models/wan/wan2.7-i2v/openapi.json` で提供するスキー - インテリジェントな書き換え後の実際のプロンプト(ビデオタスク向け) + インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用) - 音声生成を伴うI2VタスクのオーディオURL + オーディオ生成を伴うI2Vタスク用のオーディオURL @@ -438,15 +376,15 @@ Router が `GET /v2/models/wan/wan2.7-i2v/openapi.json` で提供するスキー - タスクの完了時間 + タスク完了時間 - 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) - オリジナルの入力プロンプト(ビデオタスク向け) + 元の入力プロンプト(ビデオタスク用) @@ -466,19 +404,19 @@ Router が `GET /v2/models/wan/wan2.7-i2v/openapi.json` で提供するスキー - オリジナルの入力プロンプト + 元の入力プロンプト - 生成された画像のURLアドレス + 生成済み画像のURLアドレス - タスクの実行時間 + タスク実行時間 - タスクの送信時間 + タスク送信時間 @@ -502,13 +440,13 @@ Router が `GET /v2/models/wan/wan2.7-i2v/openapi.json` で提供するスキー - タスクのステータス + タスクステータス - 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です @@ -524,19 +462,19 @@ Router が `GET /v2/models/wan/wan2.7-i2v/openapi.json` で提供するスキー - 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) + 生成済みビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成されたビデオのフレームレート(wan3.0-videoタスク) + 生成済みビデオのフレームレート(wan3.0-videoタスク) - 生成された画像の数(T2IおよびI2Iタスク) + 生成済み画像の数(T2IおよびI2Iタスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は 0.0(wan3.0-videoタスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) @@ -544,31 +482,31 @@ Router が `GET /v2/models/wan/wan2.7-i2v/openapi.json` で提供するスキー - 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) + 生成済みビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) - 画像の解像度(T2IおよびI2Iタスク) + 画像解像度(T2IおよびI2Iタスク) - 生成されたビデオの数(T2Vタスク) + 生成済みビデオの数(T2Vタスク) - 生成されたビデオの再生時間(秒)(T2Vタスク) + 生成済みビデオの再生時間(秒)(T2Vタスク) - ビデオの解像度比率(T2Vタスク) + ビデオ解像度比率(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストに関する詳細情報。`output` の下ではなく、エンベロープの ROOT で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index 5eb0f9be3e..4eb806edcf 100644 --- a/ja/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Wan 2.7 R2V を使用する" description: "Comfy Router 経由で HTTP から wan/wan2.7-r2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 2.7 R2V" -translationSourceHash: f1b372da +translationSourceHash: fc3b1068 translationFrom: development/comfy-router/models/wan/wan2-7-r2v/code.mdx translationBlockHashes: "_intro": 5428b08c "Quick start": 204ef296 - "Schema": 18b98be3 + "Schema": 7d82934a "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -210,126 +211,66 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-r2v/requests/$REQUEST_ID \ - オーディオファイルのダウンロードURL。対応形式: mp3 と wav。reference_video_urls と併用できません。 + オーディオファイルのダウンロードURL。対応形式: mp3 および wav。reference_video_urls とは併用できません。 - 先頭フレーム画像のURL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記はここでは先頭フレームを受け取りません。 -先頭フレームは type が first_frame の media 要素として受け取ります(下記の media を参照)。 -また、wan2.6-i2v では成功する img_url ボディが、happyhorse-1.0-i2v および happyhorse-1.1-i2v -ではプロバイダーに拒否されます。wan2.7/wan3.0 の表記も参照アセットを media で受け取ります。 -画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360~2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレーム画像のURL、またはBase64エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系スペルはここで先頭フレームを受け取りません。先頭フレームは type が first_frame の media 要素として受け取ります(下記の media を参照)。また、wan2.6-i2v で成功する img_url のボディは、happyhorse-1.0-i2v および happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 系のスペルも参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットのリスト。ビデオ生成のための参照素材(画像、オーディオ、ビデオ)を -指定します。各要素は type フィールドと url フィールドを含みます。このフィールドはこの -コンポーネントから提供されるすべてのモデルで共有されていますが、どのモデルがどの type -値を受け付けるか、また画像やビデオの入力を img_url や reference_video_urls ではなく -ここで受け取るかどうかは、モデルによって異なります。モデルごとの対応 type 値: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1 辺 240~8000 ピクセル、アスペクト比 1:8~ - 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2~30 秒、最大 15MB)と first_clip(MP4/MOV、2~10 - 秒、1 辺 240~4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの - data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。 - reference_image または reference_video が少なくとも 1 つ必要で、reference_image - と reference_video の合計は最大 5 です。first_frame と reference_image: - JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、1 辺 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 - 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 - HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、2~10 秒、 - 1 辺 240~4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL - は受け付けられません)に加えて、任意で 0~4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1 辺 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開 URL - または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 - reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、 - reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link と - 併用不可)、link(最大 1、file と併用不可)。reference_*/file/link タイプ - と first_frame/last_frame タイプは、同じリクエスト内で同時に使用できません。 - 配列の順序が、プロンプト内のアセットの参照順(Image 1、Video 1、 - Audio 1、…)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 - 1 辺 240~8000 ピクセル、アスペクト比最大 8:1、最大 20MB、公開 URL または - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: - 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの表記 - は先頭フレームを「ここで」受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、アスペクト比 - 1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または - data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9 個。これが - このモデル唯一の参照入力です。短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 - 最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video は - この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、3~60 - 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト - 比 1:2.5~2.5:1、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: - URL は受け付けられません)に加えて、任意で 0~5 個の reference_image(JPEG/JPG/PNG/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比 1:2.5~2.5:1、最大 20MB、公開 URL - または data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。これらのパートナーのリファレンスには media 入力の記載がないため、このフィールドは - 未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対して - media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭 - フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。media には -minItems/maxItems が宣言されていません。受け付け可能な type とその上限が -モデルごとに異なるためです。スキーマが受け付けることは、プロバイダーが受け付けることを意味しません。また、 -逆に、上記のアセットごとの「最大 20MB」という数値は(画像 -入力に対する上限であり、インラインで送信できる唯一の入力です)、パートナーが最終的に受け取る -アセットに対する上限であり、アセットが公開 URL である場合はそのまま適用されます。 -そのバイト列は Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... -URL は Comfy を経由するため、転送上の上限にも直面します。Comfy Router -の POST ボディは合計 100 MiB に制限され、それを超えると 413 で応答されます。また base64 は -ペイロードを約 4/3 に膨らませるため、単一のインラインアセットがおよそ 75 MB を超えると、 -ここに挙げたパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットがパートナー自身の20MB の上限はインラインに余裕をもって収まるため、アセット 1 つの場合に制約となるのはパートナーのルールです。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは公開 URL として送信してください。 + メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントから提供されるすべてのモデルで共通であり、どの type 値を受け付けるか、また画像やビデオの入力を img_url や reference_video_urls ではなくここで受け取るかどうかはモデルごとに異なります。モデルごとの対応 type 値: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 秒、1辺 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。reference_image または reference_video が少なくとも 1 つ必要で、参照画像と参照ビデオの合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、1辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(ちょうど 1 つ。編集対象のクリップ: MP4/MOV、2-10 秒、1辺 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0 から 4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、1辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開URL または data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link とは併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは同じリクエスト内では排他的です。配列の順序がプロンプト内でのアセットの参照順(Image 1、Video 1、Audio 1、...)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺 240-8000 ピクセル、アスペクト比最大 8:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらのスペルは先頭フレームを img_url ではなくここで受け取ります。最小 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 個。これはモデル唯一の参照入力です。最短辺が 400 ピクセル以上、JPEG/JPG/PNG/WEBP、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 +- happyhorse-1.0-video-edit: video(ちょうど 1 つ。編集対象のクリップ: MP4/MOV、3-60 秒、長辺が最大 4096 ピクセル、短辺が最小 360 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0 から 5 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、最小 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 20MB、公開URL または data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作。対応するパートナーのリファレンスにはメディア入力が記載されていないため、このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらのスペルに対するメディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの個数はこのスキーマの制約ではなく、パートナーの制約です。media には minItems/maxItems が宣言されていません。許容されるタイプとその上限はモデルごとに異なるためです。スキーマが受け付けることはプロバイダーが受け付けることを意味しません。そして逆方向についても、上記のアセットごとの「最大 20MB」という数値(インラインで送信できる唯一の入力である画像入力に対する上限)は、パートナーが最終的に受け取るアセットに対する上限であり、アセットが公開URLの場合はそのまま適用されます。そのバイト列が Comfy を経由することはないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。さらに base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに示すパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の +20MB の上限にはインラインでも余裕で収まるため、アセット 1 件の場合はパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いサイズのものは、パブリック URL として送信してください。 メディアアセットの種類 - 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL。公開 HTTP/HTTPS URL、または、上記の `media` の説明がモデルごとに列挙しているまさにその IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を使用できます。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、アップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明でモデルごとに列挙されている IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を指定できます。これらのモデルのいずれにおいても、video、audio、file、link の入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード用のルートを公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します + Reverse prompt words は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これは prompt と同じ入力バジェットにカウントされます。 - テキストプロンプトの語句。中国語と英語をサポートし、長さは 800 文字を超えないこと -(wan3.0-video では最大 20,000 文字。制限を超えたコンテンツは切り詰められます)。 -複数の参照ビデオを使用する wan2.6-r2v では、'character1'、'character2' などを使用して、 -参照ビデオの順序に従って被写体を参照します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' などを使用して、 -media 配列内の対応する順序でメディアアセットを参照します。 + テキストプロンプト。中国語と英語をサポートします。文書化された独自の長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 中国語文字)を超えるリクエストは、プロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +複数の参照ビデオを伴う wan2.6-r2v では、参照ビデオの順序に対応して 'character1'、'character2' などで被写体を参照してください。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の参照モードでは、media 配列内の対応する順序のメディアアセットを参照するために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 本のビデオ URL の配列。 + wan2.6-r2v モデル専用の参照ビデオ URL。1~3 本のビデオ URL の配列です。 入力の制限: -- 形式: mp4、mov -- 数量: 1~3 本のビデオ +- 形式: mp4, mov +- 数量: 1~3 本 - 単一ビデオの長さ: 2~30 秒 - 単一ファイルサイズ: 最大 30MB - audio_url と併用できません -参照再生時間: 単一ビデオは最大 5 秒、2 本のビデオはそれぞれ最大 2.5 秒、3 本のビデオはそれに比例して短くなります。 -課金: 実際に使用した参照再生時間に基づきます。 +参照の再生時間: 単一ビデオは最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合はそれに比例して短くなります。 +課金: 実際に使用された参照の再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされているもの: squish、flying、carousel。使用すると prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しではこれを必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の列挙はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -337,30 +278,28 @@ media 配列内の対応する順序でメディアアセットを参照しま - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされており、プロバイダーは他の wan モデルにはそのような切り替えを記載していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。その他の wan モデルについては、プロバイダーはそのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto (default): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します +- auto(デフォルト): プロンプトの内容に基づいてモデルがインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 指定可能な値: `auto`, `origin` + 指定可能な値: `auto`、`origin` 生成されるビデオの再生時間(秒): -- wan2.5 モデル: 5 または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 -- wan2.6-r2v: 5 または 10 秒のみ(15 秒はサポートされません) +- wan2.5 モデル: 5 秒または 10 秒 +- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力 - ビデオの再生時間の合計 + 出力ビデオの再生時間が 30 秒を超えてはなりません。-1 は - モデルが適切な再生時間を選択するスマート再生時間モードを有効にします -このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、モデルが適切な再生時間を選択するスマート再生時間モードが有効になります +このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 - 範囲: `-1` ~ `30` + 範囲: `-1` から `30` @@ -368,10 +307,9 @@ media 配列内の対応する順序でメディアアセットを参照しま - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合、解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 + 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデルのみ。 +wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 +wan3.0-video では、adaptive(デフォルト)が適切な値を自動的に推奨しますaspect ratio based on the input media proportions and intent. 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -379,14 +317,14 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) +- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P 非対応) - wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video, wan3.0-video-prime: 480P、720P、1080P(upstream default 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(アップストリームのデフォルトは 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。解像度のティアが課金レートを決定するためです。resolution はチェックの前に大文字へ変換し、大文字に変換した値をそのまま転送します。この enum に含まれない値には 400 を返し、上記で 480P がないと記載されている wan2.6、wan2.7、happyhorse-1.0 のモデルに対しては、480P(resolution として送信された場合も、480P の size として送信された場合も)に 400 を返します。 +このプロキシは、resolution も size も指定しないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決めるためです。チェックの前に resolution を大文字化し、大文字化した値をそのまま転送します。この列挙型に含まれない値には 400 を返し、上記で 480P 非対応とされている wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 - 取り得る値: `480P`、`720P`、`1080P` + 指定可能な値: `480P`, `720P`, `1080P` @@ -396,28 +334,28 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデル用。 + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ動作します。 +wan2.6 および wan2.7-r2v モデル向け。 - single: 単一ショットのビデオ(デフォルト) - multi: マルチショットのビデオ - 取り得る値: `multi`、`single` + 指定可能な値: `multi`, `single` - 幅*高さ形式のビデオ解像度。サポートされる解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ + width*height 形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P(480*832, 832*480, 624*624)、720P、1080P の各サイズ wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720、720*1280、960*960、1088*832、832*1088 - 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -size と resolution の両方を送信した場合、課金されるティアを選択するのは size であり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、resolution の説明で 480P がないと記載されているすべてのモデルで 400 を返します。 + 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 + 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 +size と resolution の両方を送信した場合、課金階層を決めるのは size であり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、resolution の説明で 480P 非対応とされているすべてのモデルで 400 を返します。 - 透かしロゴを追加するかどうか。透かしは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます -Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 +`GET /v2/models/wan/wan2.7-r2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同じドキュメントです。 ### 出力 @@ -426,11 +364,11 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用) + インテリジェントリライト後の実際のプロンプト(ビデオタスク用) - オーディオ生成を伴うI2Vタスク用のオーディオURL + 音声生成を伴うI2Vタスク用のオーディオURL @@ -442,11 +380,11 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) - オリジナルの入力プロンプト(ビデオタスク用) + 元の入力プロンプト(ビデオタスク用) @@ -454,19 +392,19 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - インテリジェントな書き換え後の実際のプロンプト(有効な場合) + インテリジェントリライト後の実際のプロンプト(有効な場合) - 画像エラーコード(一部のタスクが失敗した場合に返されます) + 画像のエラーコード(一部のタスクが失敗した場合に返されます) - 画像エラー情報(一部のタスクが失敗した場合に返されます) + 画像のエラー情報(一部のタスクが失敗した場合に返されます) - オリジナルの入力プロンプト + 元の入力プロンプト @@ -474,11 +412,11 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - タスク実行時間 + タスクの実行時間 - タスク送信時間 + タスクの送信時間 @@ -486,7 +424,7 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - 画像生成タスクのタスク結果統計 + 画像生成タスクのタスク結果の統計 @@ -498,17 +436,17 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - タスクの総数 + タスクの合計数 タスクステータス - 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 取り得る値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 + 完了したビデオ生成タスク用のビデオURL。リンクの有効期間は24時間です @@ -520,19 +458,19 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) + ビデオ解像度のレベル(I2Vおよびwan3.0-videoタスク) - 生成済みビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) + 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成済みビデオのフレームレート(wan3.0-videoタスク) + 生成されたビデオのフレームレート(wan3.0-videoタスク) - 生成済み画像の数(T2IおよびI2Iタスク) + 生成された画像の数(T2IおよびI2Iタスク) @@ -544,23 +482,23 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - 生成済みビデオのアスペクト比。例: 16:9(wan3.0-videoタスク) + 生成されたビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) - 画像解像度(T2IおよびI2Iタスク) + 画像の解像度(T2IおよびI2Iタスク) - 生成済みビデオの数(T2Vタスク) + 生成されたビデオの数(T2Vタスク) - 生成済みビデオの再生時間(秒)(T2Vタスク) + 生成されたビデオの再生時間(秒)(T2Vタスク) - ビデオ解像度比率(T2Vタスク) + ビデオの解像度比率(T2Vタスク) @@ -568,7 +506,7 @@ Router が `GET /v2/models/wan/wan2.7-r2v/openapi.json` で提供するスキー - 失敗したリクエストに関する詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/ja/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index adb6703d04..662fc1727e 100644 --- a/ja/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/ja/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -2,18 +2,19 @@ title: "Wan 3.0 Video Prime を Comfy Router で使用する" description: "Comfy Router を通じて HTTP 経由で wan/wan3.0-video-prime を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 3.0 Video Prime" -translationSourceHash: 63c2c33a +translationSourceHash: 1fc83550 translationFrom: development/comfy-router/models/wan/wan3-0-video-prime/code.mdx translationBlockHashes: "_intro": 812fcd16 "Quick start": 1ae93564 - "Schema": 8f9dbbd5 + "Schema": d589709d "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -182,126 +183,125 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video-prime/requests/$REQUEST_ID ### 入力 - プロンプト文などの基本情報を入力します。 + プロンプトなどの基本情報を入力します。 - オーディオファイルのダウンロード URL。対応形式: mp3 と wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式:mp3、wav。reference_video_urls とは併用できません。 - 最初のフレームの画像 URL、または Base64 エンコードデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 記法はここでは最初のフレームを -受け取りません。first_frame タイプのメディア要素として受け取ります(後述の media を -参照)。また、wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v と -happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 の記法も参照アセットを -media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360~2000 ピクセル。ファイルサイズ: 最大 10MB。 + 最初のフレーム画像のURL、または Base64 エンコードされたデータ。wan2.5-i2v-preview と +wan2.6-i2v モデルでは必須です。happyhorse-1.x 系の i2v 表記は、最初のフレームをここでは受け取りません。 +最初のフレームは type が first_frame のメディア要素として受け取ります(後述の media を参照)。 +また、wan2.6-i2v で成功する img_url ボディは、happyhorse-1.0-i2v と happyhorse-1.1-i2v では +プロバイダーに拒否されます。そして wan2.7/wan3.0 系の表記も参照アセットを media で受け取ります。 +画像形式:JPEG、JPG、PNG、BMP、WEBP。解像度:360〜2000ピクセル。ファイルサイズ:最大10MB。 - メディアアセットのリスト。ビデオ生成のための参照素材(画像、オーディオ、ビデオ)を -指定します。各要素は type と url フィールドを含みます。このフィールドはこのコンポーネントで -提供されるすべてのモデルで共有されますが、どの type 値がどのモデルで受け入れられるか、 -また画像やビデオの入力を img_url や reference_video_urls ではなくここで持つかどうかは -モデルによって異なります。モデルごとの対応 type 値: + メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type フィールドと url フィールドを持ちます。このフィールドはこのコンポーネントから提供される +すべてのモデルで共通であり、あるモデルがどの type 値を受け付けるか、また画像やビデオの入力を +img_url や reference_video_urls ではなくここで受け取るかどうかは、モデルによって異なります。 +モデルごとの対応 type 値は次のとおりです: - wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1 辺あたり 240~8000 ピクセル、アスペクト比 1:8 - ~8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2~30 秒、最大 15MB)と first_clip(MP4/MOV、2~10 - 秒、1 辺あたり 240~4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの + last_frame:JPEG/JPG/PNG/BMP/WEBP、1辺240〜8000ピクセル、アスペクト比1:8〜8:1、 + 最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2〜30秒、最大15MB)と first_clip(MP4/MOV、2〜10秒、 + 1辺240〜4096ピクセル、最大100MB):パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。少なくとも - 1 つの reference_image または reference_video が必要で、reference_image と - reference_video の合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、1 辺あたり 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 - 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。少なくとも + 1つの reference_image または reference_video が必要で、reference_image と + reference_video の合計は最大5つです。first_frame と reference_image:JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺240〜8000ピクセル、アスペクト比1:8〜8:1、最大 + 20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。reference_video:パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、2~10 秒、 - 1 辺あたり 240~4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL - は受け付けられません)に加えて、任意で 0~4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1 辺あたり 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開 URL +- wan2.7-videoedit: video(ちょうど1つ。編集対象のクリップ:MP4/MOV、2〜10秒、 + 1辺240〜4096ピクセル、最大100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で0〜4つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺240〜8000ピクセル、アスペクト比1:8〜8:1、最大20MB、パブリックURL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 - reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、 - reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link と併用不可)、 - link(最大 1、file と併用不可)。reference_*/file/link タイプと first_frame/last_frame - タイプは同一リクエスト内で相互に排他的です。配列の順序がプロンプト内のアセットの参照順序を - 定義します(Image 1、Video 1、Audio 1、...)。first_frame、last_frame、reference_image: - JPEG/JPG/PNG/BMP/WEBP、1 辺あたり 240~8000 ピクセル、アスペクト比 最大 8:1、最大 20MB、 - 公開 URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、 - file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの記法は - 最初のフレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、 - アスペクト比 1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または +- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 + reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15秒)、 + reference_audio(最大5クリップ、合計再生時間 \<= 15秒)、file(最大1、link とは + 併用不可)、link(最大1、file とは併用不可)。reference_*/file/link の各 type + と first_frame/last_frame の各 type は、同じリクエスト内では排他的です。 + 配列の順序が、プロンプト内でのアセットの参照順(Image 1、Video 1、 + Audio 1、...)を定義します。first_frame、last_frame、reference_image:JPEG/JPG/PNG/BMP/WEBP、 + 1辺240〜8000ピクセル、アスペクト比最大8:1、最大20MB、パブリックURLまたは + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: + パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記は + 最初のフレームをここで受け取り、img_url では受け取りません。少なくとも300x300ピクセル、 + アスペクト比1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9 つ。これは - このモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 - 最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video は +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9つ。これが + このモデル唯一の参照入力です。最短辺が少なくとも400ピクセル、JPEG/JPG/PNG/WEBP、 + 最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。reference_video は この操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、3~60 - 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5~2.5:1、 - 最大 100MB、公開 HTTP/HTTPS URL。インラインの data: - URL は受け付けられません)に加えて、任意で 0~5 つの reference_image(JPEG/JPG/PNG/WEBP、 - 少なくとも 300x300 ピクセル、アスペクト比 1:2.5~2.5:1、最大 20MB、公開 URL +- happyhorse-1.0-video-edit: video(ちょうど1つ。編集対象のクリップ:MP4/MOV、3〜60 + 秒、長辺が最大4096ピクセル、短辺が少なくとも360ピクセル、アスペクト + 比1:2.5〜2.5:1、最大100MB、パブリックな HTTP/HTTPS URL。インラインの data: + URL は受け付けられません)に加えて、任意で0〜5つの reference_image(JPEG/JPG/PNG/WEBP、 + 少なくとも300x300ピクセル、アスペクト比1:2.5〜2.5:1、最大20MB、パブリックURL または data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作。これらのパートナー参照にはメディア入力の記載がないため、 - このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの記法に対する + テキストから動画への操作です。対応するパートナーのリファレンスにはメディア入力が + 記載されていないため、このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントは、これらの表記に対する メディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初のフレームを - img_url で受け取ります。wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 + img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。media には -minItems/maxItems が宣言されていません。許可されるタイプとその上限はモデルごとに異なるためです。 -スキーマが受け入れることはプロバイダーが受け入れることを意味しません。また逆に、上記のアセット -ごとの「最大 20MB」という数値(画像入力の上限であり、インラインで送信できる唯一の入力です)は、 -パートナーが最終的に受け取るアセットに対するパートナーの上限であり、アセットが公開 URL の場合は -そのまま適用されます。そのバイト列は Comfy を経由しないためです。インラインの -data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router -の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。base64 はペイロードを -約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここにあるパートナーの -ルールのいずれかに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の -20MB の上限ならインラインで余裕をもって収まります。したがって、アセット 1 件ではパートナーのルールが制約となり、複数件になると転送の上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 +minItems/maxItems が宣言されていません。許容される type とその上限はモデルごとに異なるためです。 +スキーマが受け付けることは、プロバイダーが受け付けることを意味しません。逆方向についても、 +上記のアセットごとの「最大20MB」という数値(画像入力の上限であり、インラインで送信できる +唯一の入力です)は、パートナーが最終的に受け取るアセットに対する上限であり、アセットが +パブリックURLの場合はそのまま適用されます。そのバイト列は Comfy を経由しないためです。 +インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の上限にも +達します。Comfy Router の POST ボディは合計で100 MiB に制限され、それを超えると 413 が返り、 +base64 はペイロードを約4/3に膨らませるため、およそ75 MB を超える単一のインラインアセットは、 +ここに挙げたパートナーのルールのいずれかに到達する前に拒否されます。そのサイズでは、パートナー自身の +20MB の上限はインラインでも余裕を持って収まるため、1つのアセットではパートナーのルールが制約となります。一方、複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべて公開 URL として送信してください。 - メディアアセットのタイプ + メディアアセットの種類 - 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、前述の `media` の説明が各モデルについて列挙しているまさに画像の入力(wan2.7-i2v では first_frame と last_frame、wan2.7-r2v では first_frame と reference_image、wan2.7-videoedit では reference_image、wan3.0-video と wan3.0-video-prime では first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v では first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v では reference_image、happyhorse-1.0-video-edit では reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を使用できます。これらのモデルのビデオ、オーディオ、ファイル、リンクの入力はいずれもインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: 公開 HTTP/HTTPS URL、または、上記の `media` の説明で各モデルについて列挙されている画像(IMAGE)入力に限り、インラインの `data:{MIME_type};base64,...` URL。対象となる画像入力は次のとおりです: wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image です。これらのモデルのビデオ、オーディオ、ファイル、リンクの入力はいずれもインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデル呼び出しを行うため、アップロード経路を公開していません。したがって、呼び出し元自身の oss:// URL や asset_id はサポート対象の入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインペイロードを合計で制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します。 + ネガティブプロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルはそれを拒否せずに切り捨てます。これは prompt と同じ入力予算に計上されます。 - テキストプロンプト。中国語と英語をサポートし、長さは 800 文字を超えないでください(wan3.0-video では最大 20,000 文字。制限を超えたコンテンツは切り詰められます)。 - 複数の参照ビデオを使用する wan2.6-r2v では、参照ビデオの順序に従って被写体を指すために 'character1'、'character2' などを使用します。例: "Character1 が道端で歌い、その横で Character2 が踊る" - wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを指すために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 + テキストプロンプトの語句。中国語と英語をサポートします。wan3.0-video と wan3.0-video-prime は最大 +20,000 文字です。media 配列内の対応する順序でメディアアセットを参照するには、'Image 1'、'Video 1'、'Audio 1' などを使用します。 - wan2.6-r2v モデル専用の参照ビデオ URL です。1~3 本のビデオ URL の配列です。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列です。 入力の制限: -- フォーマット: mp4、mov -- 本数: 1~3 本 -- 1 本あたりのビデオ長: 2~30 秒 -- 1 ファイルあたりのファイルサイズ: 最大 30MB +- 形式: mp4, mov +- 数量: 1〜3 本のビデオ +- 単一ビデオの長さ: 2〜30 秒 +- 単一ファイルサイズ: 最大 30MB - audio_url と併用できません -参照時間: ビデオ 1 本なら最大 5 秒、2 本ならそれぞれ最大 2.5 秒、3 本なら比例して短くなります。 -課金: 実際に使用された参照時間に基づきます。 +参照の再生時間: 単一ビデオは最大 5 秒、2 本の場合は各最大 2.5 秒、3 本の場合は比例して短くなります。 +課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 - 呼び出すモデルの ID です。このコンポーネントでは制約されません。Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はその操作自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません: Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。 @@ -309,7 +309,7 @@ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。プロバイダーは他の wan モデルについてそのような切り替えを文書化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルについて、プロバイダーはそのような切り替えを文書化していません。 @@ -317,18 +317,18 @@ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の - auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 指定可能な値: `auto`, `origin` + 指定可能な値: `auto`、`origin` 生成されるビデオの再生時間(秒): - wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 -- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒はサポートされません) +- wan2.6-t2v、wan2.6-i2v: 5、10、15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 は、モデルが適切な再生時間を選ぶスマート再生時間モードを有効にします -このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、モデルが適切な再生時間を選択するスマート再生時間モードが有効になります +このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 範囲: `-1` から `30` @@ -338,55 +338,60 @@ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 + 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデルのみ。 wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切な +アスペクト比を自動的に推奨します。 - 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: -- wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P はサポートされません) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルトは 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上流のデフォルトは 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P, 1080P -- happyhorse-1.1-*(t2v、i2v、r2v): 480P, 720P, 1080P -このプロキシは、resolution と size のどちらも指定しないビデオ生成リクエストを拒否します。解像度のティアが課金レートを決めるためです。チェックの前に resolution を大文字化し、大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P がないものとして挙げられている wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 - - 指定可能な値: `480P`, `720P`, `1080P` +- wan2.5-i2v-preview: 480P, 720P, 1080P +- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P は非サポート) +- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルトは 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P +このプロキシは resolution も size も指定されていないビデオ生成リクエストを拒否します。 +解像度ティアが課金レートを決定するためです。チェックの前に resolution を大文字化し、 +大文字化した値を転送します。400 を返しますこのenum外の値に対して返され、また 480P に対しては 400 を返します(`resolution` として送信された場合も、480P の `size` として送信された場合も同様です)。対象は、上記で 480P を持たないと記載されている wan2.6、wan2.7、happyhorse-1.0 モデルです。 + + 指定可能な値: `480P`、`720P`、`1080P` 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します - 範囲: `0` ~ `2147483647` + 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデル用。 -- single: 単一ショットのビデオ(デフォルト) -- multi: マルチショットのビデオ + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ動作します。 +wan2.6 および wan2.7-r2v モデル向け。 +- single: シングルショットビデオ(デフォルト) +- multi: マルチショットビデオ - 指定可能な値: `multi`, `single` + 指定可能な値: `multi`、`single` - 幅*高さ 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ + 幅*高さ形式のビデオ解像度。対応する解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size と resolution の両方を送信した場合、課金ティアを選択するのは size で、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、resolution の説明で 480P がないものとして挙げられているすべてのモデルで 400 を返します。 + 720P: 1280*720、720*1280、960*960、1088*832、832*1088 + 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +size と resolution の両方を送信した場合、課金ティアを選択するのは size であり、 +resolution はこのプロキシがそのモデルに対して受け付ける値である必要があります。480P のサイズは、 +解像度の説明で 480P を持たないと記載されているすべてのモデルで 400 を返します。 ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます -`GET /v2/models/wan/wan3.0-video-prime/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しの検証に使用されるドキュメントと同じものです。 +`GET /v2/models/wan/wan3.0-video-prime/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 @@ -411,7 +416,7 @@ size と resolution の両方を送信した場合、課金ティアを選択す - 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) @@ -439,7 +444,7 @@ size と resolution の両方を送信した場合、課金ティアを選択す - 生成された画像のURLアドレス + 生成済み画像のURLアドレス @@ -455,7 +460,7 @@ size と resolution の両方を送信した場合、課金ティアを選択す - 画像生成タスクのタスク結果統計 + 画像生成タスクのタスク結果の統計 @@ -467,13 +472,13 @@ size と resolution の両方を送信した場合、課金ティアを選択す - タスクの総数 + タスクの合計数 - タスクステータス + タスクのステータス - 取り得る値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` @@ -489,7 +494,7 @@ size と resolution の両方を送信した場合、課金ティアを選択す - ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) + ビデオの解像度レベル(I2Vおよびwan3.0-videoタスク) @@ -517,7 +522,7 @@ size と resolution の両方を送信した場合、課金ティアを選択す - 画像解像度(T2IおよびI2Iタスク) + 画像の解像度(T2IおよびI2Iタスク) @@ -529,15 +534,15 @@ size と resolution の両方を送信した場合、課金ティアを選択す - ビデオ解像度の比率(T2Vタスク) + ビデオの解像度比率(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、envelope の ROOT で報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストに関する詳細情報。`output` の下ではなく、envelope の ROOT で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan3-0-video/code.mdx b/ja/development/comfy-router/models/wan/wan3-0-video/code.mdx index d6af5429ad..addc0e3e41 100644 --- a/ja/development/comfy-router/models/wan/wan3-0-video/code.mdx +++ b/ja/development/comfy-router/models/wan/wan3-0-video/code.mdx @@ -2,19 +2,20 @@ title: "Comfy RouterでWan 3.0 Videoを使用する" description: "Comfy Router経由でHTTPでwan/wan3.0-videoを呼び出すためのPython、TypeScript、cURLスニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 3.0 Video" -translationSourceHash: 75a2a69d +translationSourceHash: b17ea6e7 translationFrom: development/comfy-router/models/wan/wan3-0-video/code.mdx translationBlockHashes: "_intro": 352f7edf "Quick start": a6cbe623 "Serving providers": 1e291df8 - "Schema": 133669ca + "Schema": 44f84073 "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -216,73 +217,125 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ ### 入力 - プロンプト文などの基本情報を入力します。 + プロンプト語などの基本情報を入力します。 - オーディオファイルのダウンロードURL。対応形式: mp3 および wav。reference_video_urls とは併用できません。 + 音声ファイルのダウンロード URL。対応形式: mp3、wav。reference_video_urls と併用できません。 - 先頭フレームの画像URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、先頭フレームをここでは受け取りません。先頭フレームは type が first_frame の media 要素として受け取ります(後述の media を参照)。また、wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーによって拒否されます。さらに wan2.7/wan3.0 の表記も、参照アセットは同様に media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360~2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレームの画像 URL または Base64 エンコードデータ。wan2.5-i2v-preview モデルと +wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記は先頭フレームをここでは受け取りません +-- 先頭フレームは type が first_frame のメディア要素として受け取ります(下記の media を参照)。 +また、wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v と +happyhorse-1.1-i2v ではプロバイダーに拒否されます。そして wan2.7/wan3.0 の表記も +参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。 +解像度: 360〜2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type と url フィールドを持ちます。このフィールドは、このコンポーネントから提供されるすべてのモデルで共通ですが、あるモデルがどの type の値を受け付けるか、またそのモデルが画像やビデオの入力を img_url や reference_video_urls ではなくここで受け取るかどうかは、モデルごとに異なります。モデルごとの対応する type の値: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2~30 秒、最大 15MB)と first_clip(MP4/MOV、2~10 秒、1辺 240~4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。reference_image または reference_video のうち少なくとも 1 つが必須で、reference_image と reference_video の合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、1辺 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(必ず 1 つ、編集対象のクリップ: MP4/MOV、2~10 秒、1辺 240~4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0~4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、1辺 240~8000 ピクセル、アスペクト比 1:8~8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link とは併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link のタイプと first_frame/last_frame のタイプは、同じリクエスト内では同時に使用できません。配列の順序が、プロンプト内でのアセットの参照順(Image 1、Video 1、Audio 1、...)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺 240~8000 ピクセル、アスペクト比は最大 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、必ず 1 つ。これらの表記では先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、アスペクト比 1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9 個。これがこのモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(必ず 1 つ、編集対象のクリップ: MP4/MOV、3~60 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5~2.5:1、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0~5 つの reference_image(JPEG/JPG/PNG/WEBP、少なくとも 300x300 ピクセル、アスペクト比 1:2.5~2.5:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作。パートナーのリファレンスにはメディア入力の記載がないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントは、これらの表記に対する media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 - -上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。media には minItems/maxItems が宣言されていません。許可されるタイプとその上限がモデルごとに異なるためです。スキーマが受け入れても、プロバイダーが受け入れるとは限りません。逆に、上記のアセットごとの「最大 20MB」という数値は、画像入力に対する上限であり、インラインで送信できる唯一の入力でもあります。これらはパートナーが最終的に受け取るアセットに対するパートナーの上限であり、アセットが公開 URL である場合はそのバイト列が Comfy を経由しないため、記載どおりに適用されます。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。また base64 はペイロードを約 4/3 に膨らませるため、約 75 MB を超える単一のインラインアセットは、ここに記載したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の20MB の上限はインラインで問題なく収まるため、1つのアセットについてはパートナーのルールが制約となります。複数のアセットにまたがる場合は転送の上限が制約となります。100 MiB の Router 上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 + メディアアセットのリスト。動画生成のための参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントから提供される +すべてのモデルで共有されますが、あるモデルが受け付ける type の値、および画像やビデオの入力を +img_url や reference_video_urls ではなくここで受け取るかどうかは、モデルによって異なります。 +モデルごとの対応 type 値: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と + last_frame: JPEG/JPG/PNG/BMP/WEBP、1 辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、 + 最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2〜30 秒、最大 15MB)と first_clip(MP4/MOV、2〜10 秒、 + 1 辺 240〜4096 ピクセル、最大 100MB): パブリックな HTTP/HTTPS URL。インラインの + data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。少なくとも + 1 つの reference_image または reference_video が必要で、reference_image と + reference_video は合計で最大 5 つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1 辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 + 20MB、パブリック URL または data:\{MIME_type};base64,... URL。reference_video: パブリックな + HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(正確に 1 つ、編集対象のクリップ: MP4/MOV、2〜10 秒、 + 1 辺 240〜4096 ピクセル、最大 100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL + は受け付けられません)に加えて、任意で 0〜4 つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1 辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、パブリック URL + または data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、 + reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、 + reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link と + 併用不可)、link(最大 1、file と併用不可)。reference_*/file/link タイプと + first_frame/last_frame タイプは、同一リクエスト内では同時に使用できません。 + 配列の順序がプロンプト内のアセットの参照順(Image 1、Video 1、Audio 1、...)を定義します。 + first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 + 1 辺 240〜8000 ピクセル、アスペクト比は最大 8:1、最大 20MB、パブリック URL + または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: + パブリックな HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、正確に 1 つ。これらの表記は + 先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、 + アスペクト比 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、パブリック URL または + data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9 個。これは + このモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、 + 最大 20MB、パブリック URL または data:\{MIME_type};base64,... URL。reference_video は + この操作の入力タイプではありません。 +- happyhorse-1.0-video-edit: video(正確に 1 つ、編集対象のクリップ: MP4/MOV、3〜60 + 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 + 1:2.5〜2.5:1、最大 100MB、パブリックな HTTP/HTTPS URL。インラインの data: + URL は受け付けられません)に加えて、任意で 0〜5 つの reference_image(JPEG/JPG/PNG/WEBP、 + 少なくとも 300x300 ピクセル、アスペクト比 1:2.5〜2.5:1、最大 20MB、パブリック URL + または data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: + テキストから動画への操作。これらのパートナー参照ドキュメントにはメディア入力が記載されていないため、 + このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対する + メディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを + img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの数はパートナーの制約であり、このスキーマの制約ではありません。media には +minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに異なるためです。 +スキーマが受け入れることはプロバイダーが受け入れることを意味しません。また逆に、上記のアセット +ごとの「最大 20MB」という数値は、画像入力(インラインで送信できる唯一の入力)の上限であり、 +最終的にパートナーが受け取るアセットに対するパートナーの上限で、アセットがパブリック URL の +場合はそのまま適用されます。そのバイト列は Comfy を経由しないためです。インラインの +data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも達します。Comfy Router の +POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。また base64 はペイロードを +約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに示す +パートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の20MB の上限はインラインに余裕で収まるため、1 つのアセットについてはパートナーのルールが制約となります。転送の上限は複数のアセットにまたがって制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、すべてパブリック URL として送信してください。 - メディアアセットのタイプ + メディアアセットの種類 - 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL: パブリックな HTTP/HTTPS URL、または(上記の `media` の説明でモデルごとに挙げている IMAGE 入力、つまり wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image に限り)インラインの `data:{MIME_type};base64,...` URL。これらのモデルのビデオ、オーディオ、ファイル、リンクのいずれの入力も、インラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する `oss://dashscope-instant` の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、先に示した `media` の説明でモデルごとに列挙されている IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame・last_frame・reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL を使用できます。これらのモデルのビデオ、オーディオ、ファイル、リンク入力はいずれも、インラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開しないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインペイロード全体を制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - 逆プロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します + リバースプロンプト(ネガティブプロンプト)は、ビデオ画面に映したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これは prompt と同じ入力バジェットにカウントされます。 - テキストプロンプトの語句。中国語と英語に対応し、長さは 800 文字以内です -(wan3.0-video では最大 20,000 文字。制限を超えたコンテンツは切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に対応する被写体を -'character1'、'character2' などで指定します。例: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを -'Image 1'、'Video 1'、'Audio 1' などで指定します。 + テキストプロンプト。中国語と英語に対応します。wan3.0-video と wan3.0-video-prime は最大 +20,000 文字です。メディア配列内のメディアアセットを対応する順序で参照するには、'Image 1'、'Video 1'、'Audio 1' などを使用します。 wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列。 入力の制限: -- 形式: mp4, mov -- 本数: ビデオ 1〜3 本 -- 1 本のビデオの長さ: 2〜30 秒 -- 単一ファイルサイズ: 最大 30MB +- 形式: mp4、mov +- 本数: 1〜3 本 +- 1 本あたりのビデオ長: 2〜30 秒 +- 1 ファイルあたりのファイルサイズ: 最大 30MB - audio_url と併用できません -参照の再生時間: ビデオ 1 本の場合は最大 5 秒、2 本の場合は各最大 2.5 秒、3 本の場合は比例して短くなります。 +参照の再生時間: ビデオ 1 本なら最大 5 秒、2 本なら各最大 2.5 秒、3 本ならそれぞれ比例して短くなります。 課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の列挙はその操作自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。 @@ -290,54 +343,56 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。他の wan モデルについて、プロバイダーはそのような切り替えをドキュメント化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルについては、プロバイダーはこのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します +- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 指定可能な値: `auto`, `origin` + 指定可能な値: `auto`、`origin` 生成されるビデオの再生時間(秒): -- wan2.5 モデル: 5 または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 -- wan2.6-r2v: 5 または 10 秒のみ(15 秒は非サポート) +- wan2.5 モデル: 5 秒または 10 秒 +- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力 - ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、 - モデルが適切な再生時間を選ぶスマート再生時間モードが有効になります +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は、 + 入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはいけません。-1 は + スマート再生時間モードを有効にし、モデルが適切な再生時間を選択します このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 - 範囲: `-1` 〜 `30` + 範囲: `-1` から `30` - プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です + プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度のティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 +wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切な +アスペクト比を自動的に推奨します。 - 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P - wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P は非サポート) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルトは 1080P) -- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P (上流のデフォルトは 1080P) -- happyhorse-1.0-* (t2v、i2v、r2v、video-edit): 720P、1080P -- happyhorse-1.1-* (t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、`resolution` と `size` のどちらも指定していないビデオ生成リクエストを拒否します。解像度ティアが課金レートを選択するためです。チェックの前に `resolution` を大文字化し、その大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P がないモデルとして挙げられている wan2.6、wan2.7、happyhorse-1.0 では 480P (`resolution` として送信された場合も、480P の `size` として送信された場合も) に対して 400 を返します。 +- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上流のデフォルト 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。 +解像度ティアが課金レートを選択するためです。チェックする前に解像度を大文字に変換し、 +大文字に変換した値を転送します。400 を返しますこの enum 外の値に対しては、上記で 480P 非対応として記載されている wan2.6、wan2.7、happyhorse-1.0 モデルにおいて、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 指定可能な値: `480P`、`720P`、`1080P` @@ -345,32 +400,34 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します - 範囲: `0` ~ `2147483647` + 範囲: `0` から `2147483647` インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 wan2.6 および wan2.7-r2v モデル用。 -- single: 単一ショットのビデオ (デフォルト) -- multi: マルチショットのビデオ +- single: シングルショットビデオ(デフォルト) +- multi: マルチショットビデオ 指定可能な値: `multi`、`single` - width*height 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P (480*832、832*480、624*624)、720P、1080P の各サイズ -wan2.6 T2V/R2V の場合 (480P なし): + 幅*高さ形式のビデオ解像度。対応する解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P のサイズ +wan2.6 T2V/R2V の場合(480P 非対応): 720P: 1280*720、720*1280、960*960、1088*832、832*1088 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -size と resolution の両方を送信した場合、課金ティアを選択するのは size であり、resolution は引き続きこのプロキシがそのモデルで受け付ける値である必要があります。480P の size は、解像度の説明で 480P がないと記載されているすべてのモデルで 400 を返します。 +size と resolution の両方を送信した場合、size が課金ティアを選択し、 +resolution はモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、 +resolution の説明で 480P 非対応と記載されているすべてのモデルで 400 を返します。 ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます -Router が `GET /v2/models/wan/wan3.0-video/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 +これは Router が `GET /v2/models/wan/wan3.0-video/openapi.json` で提供するスキーマから生成されたものであり、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 @@ -379,27 +436,27 @@ Router が `GET /v2/models/wan/wan3.0-video/openapi.json` で提供するスキ - インテリジェントな書き換え後の実際のプロンプト (ビデオタスク用) + インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用) - オーディオ生成を伴うI2Vタスク用のオーディオURL + 音声生成を伴うI2VタスクのオーディオURL - 失敗したリクエストのエラーコード (リクエストが成功した場合は返されません) + 失敗したリクエストのエラーコード(リクエストが成功した場合は返されません) - タスク完了時間 + タスクの完了時間 - 失敗したリクエストの詳細情報 (リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) - オリジナルの入力プロンプト (ビデオタスク用) + オリジナルの入力プロンプト(ビデオタスク用) @@ -407,15 +464,15 @@ Router が `GET /v2/models/wan/wan3.0-video/openapi.json` で提供するスキ - インテリジェントな書き換え後の実際のプロンプト (有効な場合) + インテリジェントな書き換え後の実際のプロンプト(有効な場合) - 画像のエラーコード (一部のタスクが失敗した場合に返されます) + 画像のエラーコード(一部のタスクが失敗した場合に返されます) - 画像のエラー情報 (一部のタスクが失敗した場合に返されます) + 画像のエラー情報(一部のタスクが失敗した場合に返されます) @@ -427,11 +484,11 @@ Router が `GET /v2/models/wan/wan3.0-video/openapi.json` で提供するスキ - タスク実行時間 + タスクの実行時間 - タスク送信時間 + タスクの送信時間 @@ -439,15 +496,15 @@ Router が `GET /v2/models/wan/wan3.0-video/openapi.json` で提供するスキ - 画像生成タスクのタスク結果統計 + 画像生成タスクのタスク結果の統計 - 失敗したタスク数 + 失敗したタスクの数 - 成功したタスク数 + 成功したタスクの数 @@ -455,13 +512,13 @@ Router が `GET /v2/models/wan/wan3.0-video/openapi.json` で提供するスキ - タスクステータス + タスクのステータス - 取り得る値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 取りうる値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 + 完了したビデオ生成タスクのビデオURL。リンクの有効期限は24時間です @@ -469,59 +526,59 @@ Router が `GET /v2/models/wan/wan3.0-video/openapi.json` で提供するスキ - 出力情報の統計。成功した結果のみがカウントされます + 出力情報の統計。成功した結果のみが集計されます - ビデオ解像度レベル (I2Vおよびwan3.0-videoタスク) + ビデオの解像度レベル(I2Vおよびwan3.0-videoタスク) - 生成済みビデオの再生時間 (秒) (I2Vおよびwan3.0-videoタスク) + 生成済みビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) - 生成済みビデオのフレームレート (wan3.0-videoタスク) + 生成済みビデオのフレームレート(wan3.0-videoタスク) - 生成済み画像の数 (T2IおよびI2Iタスク) + 生成された画像の数(T2IおよびI2Iタスク) - 入力ビデオの再生時間 (秒)。ビデオ入力がない場合は0.0 (wan3.0-videoタスク) + 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) - 出力ビデオの再生時間 (秒) (wan3.0-videoタスク) + 出力ビデオの再生時間(秒)(wan3.0-videoタスク) - 生成済みビデオのアスペクト比 (例: 16:9) (wan3.0-videoタスク) + 生成済みビデオのアスペクト比(例: 16:9)(wan3.0-videoタスク) - 画像解像度 (T2IおよびI2Iタスク) + 画像の解像度(T2IおよびI2Iタスク) - 生成済みビデオの数 (T2Vタスク) + 生成されたビデオの数(T2Vタスク) - 生成済みビデオの再生時間 (秒) (T2Vタスク) + 生成済みビデオの再生時間(秒)(T2Vタスク) - ビデオ解像度の比率 (T2Vタスク) + ビデオの解像度比率(T2Vタスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます (リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます (リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、まずこちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/providers.mdx b/ja/development/comfy-router/providers.mdx index 243f6a7aae..64359fced0 100644 --- a/ja/development/comfy-router/providers.mdx +++ b/ja/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の配信プロバイダー" sidebarTitle: "配信プロバイダー" description: "各 Comfy Router モデルを配信できるプロバイダーと、代替プロバイダーを選択する方法を確認できます。" -translationSourceHash: fb34b140 +translationSourceHash: 2e5f5f1e translationFrom: development/comfy-router/providers.mdx --- @@ -20,7 +20,7 @@ translationFrom: development/comfy-router/providers.mdx | [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | | [Gemini 2.5 Flash Image](/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | ✓ | - | - | - | - | | [Gemini Nano Banana 2.1](/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | ✓ | - | - | - | - | -| [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | - | ✓ | +| [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | | [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | | [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | | [Kling 3.0 Turbo](/ja/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index ae7d7149b5..7312b17db1 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 기능과 한계" sidebarTitle: "기능과 한계" description: "Comfy Router 또는 파트너 프록시 선택, 장시간 실행되는 호출 대비, 복구, 속도 제한 및 자산 저장에 대해 설명합니다." -translationSourceHash: 691c2e79 +translationSourceHash: fbb54868 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": 2b25596f + "Models without a pre-flight estimate": cca3ca82 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -29,6 +29,7 @@ translationBlockHashes: + Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나, 제출한 뒤 나중에 수집하는 대기 중 요청을 통해 실행합니다. 애플리케이션이 완료된 결과를 기다리거나 나중에 결과를 수집할 수 있고, 모델 자체의 입력 및 출력 필드를 처리할 수 있는 경우에 사용하십시오. ## Router가 지원하는 기능 @@ -122,6 +123,7 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` +- **minimax**: `minimax/minimax-gpt-image-2` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx index c5200ec4b1..bb98974458 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router에서 GPT Image 2 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "GPT Image 2" -translationSourceHash: b9cb8af5 +translationSourceHash: 2fe15764 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 - "Serving providers": 56df172f + "Serving providers": f3930e40 "Schema": 4e6e5e53 "Examples": c73859ec --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -161,6 +162,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2/requests/$REQUEST_ID \ - **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2` - **fal**, `fal/fal-gpt-image-2`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=fal` +- **MiniMax**, `minimax/minimax-gpt-image-2`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=minimax` - **Pika**, `pika/pika-gpt-image-2`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=pika` - **Runware**, `runware/runware-gpt-image-2`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=runware` - **WaveSpeed**, `wavespeed/wavespeed-gpt-image-2`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=wavespeed` diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index 1013fe4219..8d9d1dfd6b 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 HappyHorse 1.0 T2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/happyhorse-1.0-t2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "HappyHorse 1.0 T2V" -translationSourceHash: f4e2958a +translationSourceHash: a87b2e81 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx translationBlockHashes: "_intro": b98773c2 "Quick start": b4282abb - "Schema": 83267e64 + "Schema": e48d60d6 "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -186,85 +187,27 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID - 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 -받지 않습니다. 이들은 first_frame 유형의 media 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 -공급자가 거부합니다. 그리고 wan2.7/wan3.0 표기도 참조 에셋을 media로 받습니다. -이미지 형식: JPEG, JPG, PNG, BMP, WEBP. -해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. + 첫 프레임 이미지 URL 또는 Base64 인코딩된 데이터입니다. wan2.5-i2v-preview 및 wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 않습니다. first_frame 유형의 media 요소로 받으며(아래 media 참조), wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 공급자가 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아니라 여기에서 -받는지는 모델마다 다릅니다. 모델별 지원 type 값: -- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 측면당 240-8000 픽셀, 가로세로 비율 1:8에서 - 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, - 측면당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 - data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame (선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 - reference 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 측면당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 - 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 측면당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 - 허용되지 않음)와 선택 사항인 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, - 측면당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL - 또는 data:\{MIME_type};base64,... URL). -- wan3.0-video, wan3.0-video-prime: first_frame (최대 1개), last_frame (최대 1개), - reference_image (최대 10개), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1개, - link와 함께 사용할 수 없음), link (최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 동일한 요청 내에서 상호 배타적입니다. - 배열 순서가 프롬프트에서 에셋의 참조 순서를 정의합니다 (Image 1, Video 1, - Audio 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, - 측면당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: - 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 해당, 정확히 1개. 이 표기들은 - 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 - 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 해당, 1~9개. 이것이 - 해당 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 - 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 - 사이, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음)와 - 선택 사항인 0~5개의 reference_image (JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, - 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL). -- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산. 해당 파트너 참조 문서에는 media 입력이 문서화되어 - 있지 않으므로 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 - media 어휘를 나열하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 - img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. 허용되는 유형과 -그 상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 -않습니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 그리고 반대 -방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 -입력인 이미지 입력의 상한이며, 파트너가 최종적으로 받는 에셋에 대한 파트너의 -상한입니다. 이 수치는 에셋이 공개 URL일 때 명시된 그대로 적용되는데, 해당 -바이트가 Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... -URL은 Comfy를 거치며 전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 -제한되며 이를 초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 -부풀리므로, 대략 75 MB를 초과하는 단일 인라인 에셋은 여기의 파트너 규칙에 -도달하기 전에 거부됩니다. 그 크기에서는 파트너 자체의 20MB 상한에 해당하는 단일 에셋도 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 적용됩니다. -전송 상한은 여러 에셋에 걸쳐 적용됩니다. 100 MiB Router 상한은 각 요소가 아니라 -요청 전체를 제한하기 때문입니다. 이 상한에 가까운 값은 공개 URL로 전송하세요. + 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지 또는 비디오 입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지 여부는 모델마다 다릅니다. 모델별 지원 type 값: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. reference_image 또는 reference_video 중 최소 하나가 필수이며, reference 이미지와 reference 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video(정확히 1개, 편집할 클립: MP4/MOV, 2-10초, 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음)와 선택 사항인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)입니다. +- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15s), reference_audio(최대 5개 클립, 총 재생 시간 \<= 15s), file(최대 1개, link와 함께 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link 유형과 first_frame/last_frame 유형은 동일한 요청 내에서 상호 배타적입니다. 배열 순서는 프롬프트에서 에셋의 참조 순서를 정의합니다(Image 1, Video 1, Audio 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개입니다. 이 표기들은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개입니다. 이것이 해당 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. 이 연산에서 reference_video는 입력 유형이 아닙니다. +- happyhorse-1.0-video-edit: video(정확히 1개, 편집할 클립: MP4/MOV, 3-60초, 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음)와 선택 사항인 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)입니다. +- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 media 입력이 없으므로 이 필드는 설정하지 않은 상태로 두십시오. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 어떤 media 어휘도 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한이 모델마다 다르기 때문입니다. 스키마가 허용한다고 해서 공급자가 허용한다는 뜻은 아닙니다. 반대 방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 입력인 이미지 입력의 상한으로서, 파트너가 최종적으로 받는 에셋에 대한 파트너의 상한이며, 에셋이 공개 URL일 때는 그대로 적용됩니다. 해당 바이트는 Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3으로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. +여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 +요청 전체를 제한하기 때문입니다. 이러한 상한에 근접하는 값은 공개 URL로 보내세요. @@ -274,40 +217,43 @@ URL은 Comfy를 거치며 전송 상한도 적용됩니다. Comfy Router POST - 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 위의 `media` 설명이 각 모델에 대해 나열한 바로 그 이미지 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어떤 모델의 비디오, 오디오, 파일 또는 링크 입력도 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL이거나, 정확히 위의 `media` 설명이 각 모델별로 나열한 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 유효합니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그런 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역방향 프롬프트 단어는 비디오 화면에 나타나지 않기를 원하는 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 한도를 초과한 콘텐츠는 잘립니다). -참조 비디오가 여러 개인 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 -참조 비디오 순서대로 대상을 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 -media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어. 중국어와 영어를 지원합니다. 문서화된 자체 길이를 넘으면 wan2.x 모델은 +프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. +wan3.0-video와 wan3.0-video-prime은 최대 20,000자까지 받습니다. 공급자는 prompt와 +negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000자의 중국어)를 넘는 요청을 +거부하며, InvalidParameter `Range of input length should be [1, 61440]`를 응답합니다. +참조 비디오가 여러 개인 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용해 참조 비디오 +순서대로 피사체를 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 media 배열 내 +해당 순서의 미디어 에셋을 지칭하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. -입력 제한 사항: + wan2.6-r2v 모델 전용 참조 비디오 URL. 1~3개의 비디오 URL 배열입니다. +입력 제한: - 형식: mp4, mov -- 개수: 비디오 1~3개 +- 수량: 비디오 1~3개 - 단일 비디오 길이: 2~30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없음 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 이에 비례하여 더 짧습니다. -과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. +참조 재생 시간: 단일 비디오 최대 5초, 비디오 2개는 각각 최대 2.5초, 3개는 그에 비례해 더 짧습니다. +과금: 사용된 실제 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름. 선택 사항. 현재 지원: squish, flying, carousel. 사용하면 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`로 직접 v1 호출을 할 때는 반드시 제공해야 하며, 허용되는 표기의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -315,87 +261,86 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않습니다. + 비디오에 오디오를 추가할지 여부. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않았습니다. - wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠에 따라 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 + wan2.7-videoedit 모델의 비디오 오디오 설정. +- auto(기본값): 모델이 프롬프트 내용을 기반으로 지능적으로 판단 +- origin: 입력 비디오의 원본 오디오를 강제로 유지 가능한 값: `auto`, `origin` - 생성되는 비디오의 재생 시간(초)입니다: -- wan2.5 모델: 5 또는 10초 -- wan2.6-t2v, wan2.6-i2v: 5, 10 또는 15초 -- wan2.6-r2v: 5 또는 10초만 가능(15초 미지원) + 생성되는 비디오의 재생 시간(초): +- wan2.5 모델: 5초 또는 10초 +- wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 +- wan2.6-r2v: 5초 또는 10초만 지원(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 초과할 수 없으며, -1은 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30]을 벗어난 재생 시간에 대해 400을 반환합니다. +이 프록시는 [-1, 30] 범위를 벗어난 duration에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능적 재작성을 활성화할지 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성 사용 여부. 기본값은 true입니다. - 생성되는 비디오의 비율입니다. wan2.7 및 wan3.0 모델에만 해당합니다. + 생성되는 비디오의 화면 비율. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -비율을 자동으로 추천합니다. +wan3.0-video의 경우 adaptive(기본값)가 적절한입력 미디어의 비율과 의도에 따른 가로세로 비율입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 수준입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만(480P 미지원) +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) - wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 이 프록시는 확인하기 전에 resolution을 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum 밖의 값에 대해서는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(resolution으로 보내든 480P size로 보내든)에 대해 400을 반환합니다. +이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 이 프록시는 확인하기 전에 해상도를 대문자로 바꾸고 대문자로 바꾼 값을 전달하며, 이 열거형에 속하지 않는 값에는 400을 반환하고, 위에서 480P를 지원하지 않는 것으로 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P size로 보내든)에 대해 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. -wan2.6 및 wan2.7-r2v 모델용. -- single: 단일 샷 비디오 (기본값) + 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. +wan2.6 및 wan2.7-r2v 모델에 적용됩니다. +- single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 가능한 값: `multi`, `single` - 너비*높이 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V (480P 없음): + width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V의 경우: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 없음)의 경우: 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 -`GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +`GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용되는 것과 동일한 문서입니다. ### 출력 @@ -404,15 +349,15 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 지능형 재작성 후 실제 프롬프트 (비디오 작업용) + 지능형 재작성 이후의 실제 프롬프트 (비디오 작업용) - 오디오 생성이 포함된 I2V 작업용 오디오 URL + 오디오 생성이 포함된 I2V 작업의 오디오 URL - 실패한 요청에 대한 오류 코드 (요청이 성공하면 반환되지 않음) + 실패한 요청의 오류 코드 (요청이 성공하면 반환되지 않음) @@ -428,19 +373,19 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 이미지 생성 작업에 대한 작업 결과 목록 + 이미지 생성 작업의 작업 결과 목록 - 지능형 재작성 후 실제 프롬프트 (활성화된 경우) + 지능형 재작성 이후의 실제 프롬프트 (활성화된 경우) - 이미지 오류 코드 (일부 작업이 실패할 때 반환됨) + 이미지 오류 코드 (일부 작업이 실패하면 반환됨) - 이미지 오류 정보 (일부 작업이 실패할 때 반환됨) + 이미지 오류 정보 (일부 작업이 실패하면 반환됨) @@ -464,7 +409,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 이미지 생성 작업에 대한 작업 결과 통계 + 이미지 생성 작업의 작업 결과 통계 @@ -486,7 +431,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 완료된 비디오 생성 작업을 위한 비디오 URL. 링크 유효 기간 24시간 + 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간 24시간 @@ -494,7 +439,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 출력 정보 통계. 성공한 결과만 집계됨 + 출력 정보 통계. 성공한 결과만 집계됩니다 @@ -506,7 +451,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 생성된 비디오의 프레임 속도 (wan3.0-video 작업) + 생성된 비디오의 프레임 레이트 (wan3.0-video 작업) @@ -542,11 +487,11 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 실패한 요청에 대한 오류 코드로, `output` 아래가 아닌 응답의 최상위에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아닌 응답의 최상위에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 내용을 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index 7b8b10d406..b7031322c4 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 HappyHorse 1.0 Video Edit 사용하기" description: "Comfy Router를 통해 HTTP로 wan/happyhorse-1.0-video-edit을 호출하기 위한 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "HappyHorse 1.0 Video Edit" -translationSourceHash: 138e4d49 +translationSourceHash: b9922c80 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx translationBlockHashes: "_intro": 3a4cf59c "Quick start": 140976d2 - "Schema": bd0494a3 + "Schema": a762284e "Examples": a41df668 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -201,110 +202,110 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-video-edit/requests/$REQ ### 입력 - 프롬프트어 등 기본 정보를 입력합니다. + 프롬프트 단어 등 기본 정보를 입력합니다. - 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3, wav. `reference_video_urls`와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기법은 첫 프레임을 여기서 -받지 않습니다. 이들은 first_frame 타입의 media 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 공급자가 happyhorse-1.0-i2v와 -happyhorse-1.1-i2v에서 거부합니다. 그리고 wan2.7/wan3.0 표기법도 참조 에셋을 -media로 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 +않습니다. 이들은 first_frame 타입의 media 엘리먼트로 받으며(아래 media 참조), +wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 +공급자가 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 media로 받습니다. +이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공하는 모든 모델이 공유하며, 어떤 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url이나 reference_video_urls가 아닌 여기서 전달하는지 -여부는 모델마다 다릅니다. 모델별 지원 type 값: -- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 종횡비 1:8에서 8:1 + 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 엘리먼트는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 +제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 +비디오 입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지는 모델마다 +다릅니다. 모델별 지원 type 값: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame과 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, - 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL; 인라인 + 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1), reference_image, reference_video. 최소 - 하나의 reference_image 또는 reference_video가 필요하며, 참조 이미지와 - 참조 비디오를 합해 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 각 변 240-8000 픽셀, 종횡비 1:8에서 8:1 사이, 최대 +- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. + 최소 하나의 reference_image 또는 reference_video가 필수이며, reference image와 + reference video의 합계는 최대 5개입니다. first_frame과 reference_image: JPEG/JPG/PNG/BMP/WEBP + (알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL; 인라인 data: URL은 허용되지 않습니다. + HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. - wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL; 인라인 data: URL은 - 허용되지 않음)와 선택적인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 각 변 240-8000 픽셀, 종횡비 1:8에서 8:1 사이, 최대 20MB, 공개 URL + 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 + 허용되지 않음) 및 선택적 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). -- wan3.0-video, wan3.0-video-prime: first_frame(최대 1), last_frame(최대 1), - reference_image(최대 10), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1, link와 함께 - 사용할 수 없음), link(최대 1, file과 함께 사용할 수 없음). reference_*/file/link - 타입과 first_frame/last_frame 타입은 같은 요청 내에서 상호 배타적입니다. - 배열 순서가 프롬프트에서 에셋의 참조 순서를 정의합니다(Image 1, Video 1, - Audio 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, - 각 변 240-8000 픽셀, 종횡비 최대 8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 - HTTP/HTTPS URL; 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 해당, 정확히 1개. 이 표기법은 - 첫 프레임을 img_url이 아닌 여기서 받습니다. 최소 300x300 픽셀, 종횡비 +- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), + reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 + 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link + 타입과 first_frame/last_frame 타입은 같은 요청 안에서 상호 배타적입니다. + 배열 순서가 프롬프트 내 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 + 정의합니다. first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: + 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 + 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 해당, 1~9개. 이것이 +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 이 연산의 입력 타입이 아닙니다. - happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 종횡비 1:2.5에서 2.5:1 - 사이, 최대 100MB, 공개 HTTP/HTTPS URL; 인라인 data: URL은 허용되지 않음)와 - 선택적인 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, - 종횡비 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 + 사이, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음) + 및 선택적 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, + 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 - 문서화되어 있지 않으므로 이 필드를 설정하지 않은 채로 두십시오. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기법들에 대해 - 어떤 media 어휘도 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 - 프레임을 img_url로 받고, wan2.6-r2v는 참조 클립을 reference_video_urls로 받습니다. + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 문서화되어 있지 않으므로 이 필드는 설정하지 마십시오. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 + 미디어 어휘를 나열하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 + img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. 위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되지 않았는데, 허용되는 타입과 그 상한이 모델마다 다르기 -때문입니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 반대 -방향으로, 위의 에셋별 "최대 20MB" 수치(이미지 입력에 대한 상한이며, 인라인으로 -전송될 수 있는 유일한 입력입니다)는 파트너가 최종적으로 보유하는 에셋에 대한 -상한이며, 에셋이 공개 URL일 때는 서술된 그대로 적용됩니다. 그 바이트가 Comfy를 -거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치며 -전송 상한도 만납니다. Comfy Router POST 본문은 총 100 MiB로 제한되고 이를 초과하면 -413으로 응답하며, base64는 페이로드를 약 4/3로 부풀리므로, 대략 75 MB를 넘는 -단일 인라인 에셋은 여기 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서 -파트너 자체의 단일 에셋은20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나만 놓고 보면 파트너 규칙이 구속력을 가집니다. 반면 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 값은 공개 URL로 보내세요. +minItems/maxItems가 선언되어 있지 않은데, 허용되는 타입과 그 상한이 모델마다 +다르기 때문입니다. 스키마에서 허용된다고 해서 공급자가 허용한다는 뜻은 아닙니다. +그리고 반대 방향으로, 위의 에셋별 "최대 20MB" 수치는 이미지 입력(인라인으로 전송될 +수 있는 유일한 입력)에 대한 상한으로서 파트너가 최종적으로 받게 되는 에셋에 대한 +상한이며, 에셋이 공개 URL일 때는 그대로 적용됩니다. 해당 바이트는 Comfy를 거치지 +않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치며 전송 +상한도 적용됩니다. Comfy Router POST 본문은 전체 100 MiB로 제한되며 이를 초과하면 +413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 +인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 +자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. +여러 에셋에 걸치면 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 +요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 +공개 URL로 보내세요. 미디어 에셋 유형 - Possible values: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 가능한 값: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` - 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 위의 `media` 설명이 각 모델별로 나열하는 바로 그 IMAGE 입력, 즉 wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에서 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스가 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL 또는, 위의 `media` 설명이 각 모델에 대해 나열한 바로 그 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에 표시되기를 원하지 않는 콘텐츠를 설명하는 데 사용됩니다. 500자를 초과하면 wan 모델은 이를 거부하지 않고 잘라냅니다. 이는 prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 제한을 초과하는 콘텐츠는 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용해 -참조 비디오 순서대로 대상을 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 -media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 자체적으로 문서화된 길이를 초과하면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자까지 받습니다. 공급자는 prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)를 넘는 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. +참조 비디오가 여러 개인 wan2.6-r2v의 경우, 참조 비디오 순서대로 대상을 지칭할 때 'character1', 'character2' 등을 사용합니다. 예: "Character1이 길가에서 노래하고 Character2가 그 옆에서 춤춥니다" +wan3.0-video 참조 모드의 경우, media 배열 내의 해당 순서대로 미디어 에셋을 지칭할 때 'Image 1', 'Video 1', 'Audio 1' 등을 사용합니다. @@ -314,17 +315,17 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. - 개수: 비디오 1-3개 - 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB -- audio_url과 함께 사용할 수 없습니다 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례해 더 짧습니다. -과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. +- audio_url과 함께 사용할 수 없음 +참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례하여 더 짧습니다. +과금: 실제 사용된 참조 재생 시간 기준입니다. - 비디오 효과 템플릿 이름. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용하면 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용하면 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 enum은 해당 오퍼레이션 자체 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -332,15 +333,15 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video 및 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 +- auto (기본값): 모델이 prompt 콘텐츠에 따라 지능적으로 판단합니다 - origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 - Possible values: `auto`, `origin` + 가능한 값: `auto`, `origin` @@ -350,69 +351,66 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. - wan2.6-r2v: 5초 또는 10초만 (15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 초과할 수 없습니다. -1은 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 이 프록시는 [-1, 30]을 벗어난 재생 시간에 대해 400을 반환합니다. - Range: `-1` to `30` + 범위: `-1` ~ `30` - 프롬프트 지능형 재작성 사용 여부입니다. 기본값은 true입니다 + prompt 지능형 재작성 사용 여부입니다. 기본값은 true입니다 - 생성되는 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. -wan2.7 모델의 경우 제공하지 않으면 해상도 등급을 기준으로 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -비율을 자동으로 추천합니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)는 적절한입력 미디어의 비율과 의도에 기반한 가로세로 비율입니다. - Possible values: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 수준입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) +- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 지원 (480P 미지원) +- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요금을 선택하기 때문입니다. 검사하기 전에 resolution을 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(resolution으로 보내든 480P size로 보내든)에 대해 400을 반환합니다. +이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 선택하기 때문입니다. 이 프록시는 검사 전에 해상도를 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 열거형에 없는 값에 대해서는 400을 반환하고, 위에 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델 중 480P를 지원하지 않는 모델에서 480P(해상도로 보내든 480P size로 보내든)에 대해서도 400을 반환합니다. - Possible values: `480P`, `720P`, `1080P` + 가능한 값: `480P`, `720P`, `1080P` - 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드 + 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드입니다 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. + 지능형 다중 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오(기본값) -- multi: 멀티 샷 비디오 +- single: 단일 샷 비디오 (기본값) +- multi: 다중 샷 비디오 - Possible values: `multi`, `single` + 가능한 값: `multi`, `single` - 너비*높이 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V(480P 없음): + 너비*높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V의 경우 (480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내는 경우, size가 청구 등급을 선택하며 resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 -`GET /v2/models/wan/happyhorse-1.0-video-edit/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +`GET /v2/models/wan/happyhorse-1.0-video-edit/openapi.json`에서 Router가 제공하는 스키마에서 생성되었습니다. 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 문서와 동일합니다. ### 출력 @@ -515,7 +513,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 비디오 해상도 등급 (I2V 및 wan3.0-video 작업) + 비디오 해상도 레벨 (I2V 및 wan3.0-video 작업) @@ -559,11 +557,11 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 봉투의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 봉투의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index 31ea01271a..ffb0767cdf 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 HappyHorse 1.1 T2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/happyhorse-1.1-t2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "HappyHorse 1.1 T2V" -translationSourceHash: e16717b0 +translationSourceHash: e1f68a5b translationFrom: development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx translationBlockHashes: "_intro": f001b07c "Quick start": 125cfd7d - "Schema": 88f94657 + "Schema": 0aa39fbc "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -186,82 +187,85 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-t2v/requests/$REQUEST_ID - 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 -않습니다. 대신 first_frame 유형의 media 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 공급자가 happyhorse-1.0-i2v와 -happyhorse-1.1-i2v에서 거부합니다. wan2.7/wan3.0 표기도 참조 에셋을 -media로 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. -해상도: 360-2000픽셀. 파일 크기: 최대 10MB. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필요합니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 +받지 않습니다. 대신 first_frame 유형의 미디어 요소로 받습니다(아래 media 참고). +wan2.6-i2v에서 성공하는 img_url 본문은 공급자가 happyhorse-1.0-i2v 및 +happyhorse-1.1-i2v에서 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 +media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. +해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 + 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지 -여부는 모델마다 다릅니다. 모델별 지원 type 값: +이미지나 비디오 입력을 img_url이나 reference_video_urls가 아닌 여기에서 +전달하는지 여부는 모델마다 다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 측면당 240-8000픽셀, 가로 세로 비율 1:8에서 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 측면당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, - 측면당 240-4096픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 - data: URL은 허용되지 않습니다. + 측면당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며 인라인 data: URL은 + 허용되지 않습니다. - wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video가 최소 하나 필요하며, 참조 이미지와 - 참조 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 측면당 240-8000픽셀, 가로 세로 비율 1:8에서 8:1 사이, 최대 - 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 중인 클립: MP4/MOV, 2-10초, - 측면당 240-4096픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 - 허용되지 않음)와 선택적 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 측면당 240-8000픽셀, 가로 세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL + reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 + reference 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 측면당 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 측면당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 + 허용되지 않음)와 선택적 reference_image 0~4개(JPEG/JPG/PNG/BMP/WEBP, + 측면당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). - wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 동일한 요청 내에서 상호 배타적입니다. 배열 - 순서는 프롬프트에서 에셋의 참조 순서를 정의합니다(Image 1, Video 1, - Audio 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, - 측면당 240-8000픽셀, 가로 세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. + 배열 순서가 프롬프트 내 에셋의 참조 순서를 정의합니다(이미지 1, 비디오 1, + 오디오 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 측면당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: - 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 - 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300픽셀, 가로 세로 비율 + 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기는 + 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 - 모델의 유일한 참조 입력입니다. 최단 변 최소 400픽셀, JPEG/JPG/PNG/WEBP, +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 + 모델의 유일한 참조 입력입니다. 최단 측면 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 중인 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096픽셀, 짧은 변 최소 360픽셀, 가로 세로 비율 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택적 - 0~5개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 최소 300x300픽셀, 가로 세로 비율 +- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 측면 최대 4096 픽셀, 짧은 측면 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 + 사이, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 + 선택적 reference_image 0~5개(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 media 입력이 없으므로 - 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 media - 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 없으므로 이 필드를 설정하지 마십시오. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 + 미디어 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되지 않았는데, 허용되는 유형과 그 상한이 모델마다 다르기 -때문입니다. 스키마가 받아들인다고 해서 공급자가 받아들인다는 뜻은 아닙니다. 그리고 -반대 방향으로, 위의 에셋별 "최대 20MB" 수치, 즉 인라인으로 전송될 수 있는 유일한 -입력인 이미지 입력의 상한은 파트너가 최종적으로 갖게 되는 에셋에 대한 상한이며, -에셋이 공개 URL일 때는 그대로 적용됩니다. 그 바이트는 Comfy를 거치지 않기 -때문입니다. 인라인 data:\{MIME_type};base64,... URL은 실제로 Comfy를 거치며 전송 -상한도 만납니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 -응답되고, base64는 페이로드를 약 4/3로 부풀리므로, 대략 75 MB를 넘는 단일 인라인 -에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의 -단일 에셋20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. 여러 개를 보낼 때는 전송 한도가 제약이 되는데, 100 MiB Router 상한이 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 한도에 근접하는 것은 공개 URL로 전송하세요. +위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. 허용되는 유형과 +그 상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 +않습니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 반대 +방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 +입력인 이미지 입력의 상한이며, 파트너가 최종적으로 받는 에셋에 대한 파트너의 +상한입니다. 해당 바이트가 Comfy를 거치지 않으므로 에셋이 공개 URL일 때는 그대로 +적용됩니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 +상한도 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 넘으면 +413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 약 75MB를 넘는 단일 +인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 단일 +에셋은 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. +여러 에셋에 걸치면 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 +요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 +공개 URL로 보내세요. @@ -271,38 +275,43 @@ minItems/maxItems가 선언되지 않았는데, 허용되는 유형과 그 상 - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명에서 각 모델별로 나열한 IMAGE 입력에 한해(wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image) `data:{MIME_type};base64,...` 형식의 인라인 URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 link 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 유효합니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총량으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참조하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명에서 각 모델별로 나열한 정확히 그 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해서만 인라인 `data:{MIME_type};base64,...` URL을 사용할 수 있습니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 허용하지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 전체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 네거티브 프롬프트 단어는 비디오 화면에 나타나지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에 보이지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자, 한도를 초과하는 콘텐츠는 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우, 참조 비디오 순서에 따라 'character1', 'character2' 등으로 대상을 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우, media 배열 내 해당 순서에 따라 'Image 1', 'Video 1', 'Audio 1' 등으로 미디어 에셋을 지칭하세요. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 문서화된 길이를 넘으면 wan2.x 모델은 +프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. +wan3.0-video와 wan3.0-video-prime은 최대 20,000자까지 받습니다. prompt와 negative_prompt를 합쳐 +약 60,850바이트의 UTF-8 텍스트(대략 중국어 20,000자)를 넘으면 공급자가 요청을 거부하며 +InvalidParameter `Range of input length should be [1, 61440]`를 응답합니다. +여러 개의 참조 비디오를 사용하는 wan2.6-r2v에서는 참조 비디오 순서대로 피사체를 +'character1', 'character2' 등으로 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드에서는 media 배열 내 해당 순서의 미디어 에셋을 +'Image 1', 'Video 1', 'Audio 1' 등으로 지칭하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개 비디오 URL의 배열입니다. + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. 입력 제한: - 형식: mp4, mov -- 개수: 비디오 1-3개 -- 단일 비디오 길이: 2-30초 +- 개수: 1~3개 비디오 +- 단일 비디오 길이: 2~30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없음 -참조 재생 시간: 비디오 한 개는 최대 5초, 두 개는 각각 최대 2.5초, 세 개는 그에 비례하여 더 짧습니다. +참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례하여 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이 값을 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로 Router 호출자는 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -310,67 +319,71 @@ wan3.0-video 참조 모드의 경우, media 배열 내 해당 순서에 따라 ' - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video 및 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않았습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단 -- origin: 입력 비디오의 원본 오디오를 강제로 유지 +- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 +- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 가능한 값: `auto`, `origin` - 생성된 비디오의 재생 시간(초): + 생성되는 비디오의 재생 시간(초)입니다. - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30] 범위를 벗어나는 재생 시간에 대해 400을 반환합니다. +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 하며, -1은 + 모델이 적합한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. - 범위: `-1` ~ `30` + 범위: `-1`부터 `30`까지 - 프롬프트 지능적 재작성을 활성화할지 여부입니다. 기본값은 true + 프롬프트 지능형 재작성 활성화 여부입니다. 기본값은 true입니다. - 생성된 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -화면 비율을 자동으로 추천합니다. +wan3.0-video의 경우 adaptive(기본값)가 적합한입력 미디어의 비율과 의도에 따른 가로세로 비율입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급. 지원되는 값은 모델에 따라 다릅니다: + 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) +- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 지원 (480P 미지원) - wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 선택하기 때문입니다. 검사 전에 해상도를 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에 대해서는 400을 반환하고, 위에 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 보내든 480P size로 보내든)에 대해서는 400을 반환합니다. +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. +해상도 등급이 청구 요율을 결정하기 때문입니다. resolution은 검사 전에 +대문자로 변환되며 변환된 값을 그대로 전달하고, 이 열거형에 없는 값에는 400을 +반환하며, 위에서 480P를 지원하지 않는 것으로 나열된 wan2.6, wan2.7, +happyhorse-1.0 모델에서는 (resolution으로 보내든 480P size로 보내든) 480P에 +대해 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 모델 생성 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. -wan2.6 및 wan2.7-r2v 모델용. + 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. +wan2.6 및 wan2.7-r2v 모델용입니다. - single: 단일 샷 비디오 (기본값) - multi: 멀티 샷 비디오 @@ -378,21 +391,21 @@ wan2.6 및 wan2.7-r2v 모델용. - width*height 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V의 경우 (480P 없음): + width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V (480P 미지원): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, resolution은 -여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 -해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 청구 등급은 size로 결정되며, +resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P +size는 resolution 설명에서 480P 미지원으로 나열된 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 표시됩니다 -Router가 `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -405,7 +418,7 @@ Router가 `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json`에서 제공하 - 오디오 생성이 포함된 I2V 작업의 오디오 URL + 오디오 생성을 포함하는 I2V 작업의 오디오 URL @@ -433,11 +446,11 @@ Router가 `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json`에서 제공하 - 이미지 오류 코드 (일부 작업이 실패할 때 반환됨) + 이미지 오류 코드 (일부 작업이 실패했을 때 반환됨) - 이미지 오류 정보 (일부 작업이 실패할 때 반환됨) + 이미지 오류 정보 (일부 작업이 실패했을 때 반환됨) @@ -483,7 +496,7 @@ Router가 `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json`에서 제공하 - 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간 24시간 + 완료된 비디오 생성 작업의 비디오 URL입니다. 링크 유효 기간은 24시간입니다 @@ -491,7 +504,7 @@ Router가 `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json`에서 제공하 - 출력 정보 통계. 성공한 결과만 집계됨 + 출력 정보 통계입니다. 성공한 결과만 집계됩니다 @@ -539,11 +552,11 @@ Router가 `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json`에서 제공하 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 본문의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 본문의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx b/ko/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx index 856ef4cf56..c961db05a4 100644 --- a/ko/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Wan 2.5 T2I Preview 사용하기" description: "Comfy Router를 통해 wan/wan2.5-t2i-preview를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Wan 2.5 T2I Preview" -translationSourceHash: 9d519a07 +translationSourceHash: 1b62e07d translationFrom: development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx translationBlockHashes: "_intro": 975ad7fc "Quick start": 9cc4b789 - "Schema": 579649db + "Schema": 77ffea28 "Examples": e420aca1 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/wan/wan2.5-t2i-preview.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -176,15 +177,15 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 이미지에서 보고 싶지 않은 콘텐츠를 설명하는 반대 프롬프트 단어입니다 + 이미지에서 보고 싶지 않은 콘텐츠를 설명하는 네거티브 프롬프트 단어입니다. 500자를 초과하면 모델이 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 기대하는 이미지 요소와 시각적 특징을 설명하는 긍정 프롬프트 단어입니다. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 + 기대하는 이미지 요소와 시각적 특징을 설명하는 긍정 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 2,000자를 초과하면 모델이 프롬프트를 거부하지 않고 잘라냅니다. prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)를 초과하는 요청은 공급자가 거부하며, InvalidParameter `Range of input length should be [1, 61440]`를 응답합니다. - 텍스트 기반 이미지 생성에 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채웁니다. `POST /proxy/wan/api/v1/services/aigc/text2image/image-synthesis`에 대한 직접 v1 호출은 반드시 이 값을 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanImageGenerationRequest`에 있습니다. + 텍스트 기반 이미지 생성을 위해 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채웁니다. `POST /proxy/wan/api/v1/services/aigc/text2image/image-synthesis`에 대한 직접 v1 호출에서는 반드시 이 값을 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanImageGenerationRequest`에 있습니다. @@ -192,13 +193,13 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 생성되는 이미지 수입니다. 범위 1-4, 기본값은 4입니다 + 생성할 이미지 수입니다. 범위 1-4, 기본값은 4 범위: `1` ~ `4` - 프롬프트 지능형 재작성을 활성화합니다. 기본값은 true입니다 + 프롬프트 지능형 재작성을 활성화합니다. 기본값은 true입니다. @@ -208,14 +209,15 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 출력 이미지 해상도로, 너비*높이 형식입니다. 기본값은 1280*1280입니다. API는 1638400(1280*1280)에서 2073600(1440*1440) 사이의 픽셀 면적과 1:4에서 4:1 사이의 비율을 허용하므로 768*2700도 유효합니다 + 출력 이미지 해상도이며 너비*높이 형식입니다. 기본값은 1280*1280입니다. API는 1638400(1280*1280)에서 2073600(1440*1440) 사이의 픽셀 면적과 1:4에서 4:1 사이의 가로세로 비율을 허용하므로 768*2700도 유효합니다 - 오른쪽 아래 모서리에 워터마크 로고를 추가할지 여부 + 오른쪽 아래 모서리에 워터마크 로고를 추가할지 여부입니다. -Router가 `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 이전에 호출을 검증하는 동일한 문서입니다. +Router가 `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. + ### 출력 @@ -227,7 +229,7 @@ Router가 `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json`에서 제공하 - 오디오 생성 기능이 있는 I2V 작업의 오디오 URL + 오디오 생성이 포함된 I2V 작업의 오디오 URL @@ -305,7 +307,7 @@ Router가 `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json`에서 제공하 - 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간은 24시간입니다 + 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간 24시간 @@ -361,11 +363,11 @@ Router가 `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json`에서 제공하 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 넘어가기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx b/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx index 5ebe08548e..9dd86e6192 100644 --- a/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Wan 2.5 T2V Preview 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.5-t2v-preview를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 2.5 T2V Preview" -translationSourceHash: 51e7ac3c +translationSourceHash: e7df4aa3 translationFrom: development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx translationBlockHashes: "_intro": 111ed2f7 "Quick start": d4fb170b - "Schema": 73f1810d + "Schema": 62b9e06a "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -182,88 +183,86 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests/$REQUEST_ID ### 입력 - 프롬프트 단어 등 기본 정보를 입력합니다. + 프롬프트 등 기본 정보를 입력합니다. - 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL. 지원 형식: mp3, wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 -받지 않습니다. 이들은 first_frame 유형의 media 요소로 받으며(아래 media 참고), -wan2.6-i2v에서 성공하는 img_url 본문은 공급자가 happyhorse-1.0-i2v와 -happyhorse-1.1-i2v에서 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 -media로 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x의 i2v 표기법은 첫 프레임을 여기에서 받지 않습니다. +이들은 first_frame 타입의 미디어 요소로 받으며(아래 media 참고), wan2.6-i2v에서 성공하는 +img_url 본문은 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서 공급자가 거부합니다. 또한 +wan2.7/wan3.0 표기법도 참조 에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url이나 reference_video_urls가 아닌 여기에서 받는지 -여부는 모델마다 다릅니다. 모델별로 지원되는 type 값은 다음과 같습니다: + 미디어 에셋 목록. 비디오 생성에 사용할 참조 자료(이미지, 오디오, 비디오)를 지정합니다. +각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공하는 모든 +모델이 공유하며, 어떤 type 값을 특정 모델이 허용하는지, 그리고 이미지나 비디오 입력을 +img_url이나 reference_video_urls가 아니라 여기에서 받는지 여부는 모델마다 +다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변 기준 240-8000 픽셀, 가로세로 비율 - 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, - 한 변 기준 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, + 한 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video 중 최소 하나가 필수이며, reference 이미지와 - reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 한 변 기준 240-8000 픽셀, 가로세로 비율 - 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - reference_video: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 한 변 기준 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 - 허용되지 않음)와 선택적으로 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 한 변 기준 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL - 또는 data:\{MIME_type};base64,... URL). -- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), - reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 - 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. - 배열 순서가 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 - 정의합니다. first_frame, last_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP, 한 변 기준 240-8000 픽셀, 가로세로 비율 최대 8:1, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, - reference_audio, file 및 link: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 - 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 +- wan2.7-r2v: first_frame (선택 사항, 최대 1개), reference_image, reference_video. 최소 + 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 + reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP + (알파 채널 없음), 한 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 + 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 + HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 한 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 + 허용되지 않음)와 선택 사항인 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, + 한 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL)로 구성됩니다. +- wan3.0-video, wan3.0-video-prime: first_frame (최대 1개), last_frame (최대 1개), + reference_image (최대 10개), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1개, link와 함께 사용 + 불가), link (최대 1개, file과 함께 사용 불가). reference_*/file/link type과 + first_frame/last_frame type은 같은 요청 안에서 상호 배타적입니다. + 배열 순서가 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, + Audio 1, ...)를 정의합니다. first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 한 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 + HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기법은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 - 모델의 유일한 참조 입력입니다. 최단 변 최소 400픽셀, JPEG/JPG/PNG/WEBP, +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 + 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 - 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096픽셀, 짧은 변 최소 360픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 - 선택적으로 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, - 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL). + 이 연산의 입력 type이 아닙니다. +- happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60 + 초, 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 + 1:2.5에서 2.5:1 사이, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: + URL은 허용되지 않음)와 선택 사항인 0~5개의 reference_image (JPEG/JPG/PNG/WEBP, + 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL)로 구성됩니다. - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 - 기재되어 있지 않으므로 이 필드는 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 media - 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 - img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. 허용되는 유형과 그 -상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 -않습니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 그리고 반대 -방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 -입력인 이미지 입력의 상한이며, 파트너가 최종적으로 받게 되는 에셋에 대한 -파트너의 상한이고, 해당 에셋이 공개 URL일 때는 그대로 적용됩니다. 그 바이트는 -Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 -거치므로 전송 상한도 함께 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 -제한되며 이를 초과하면 413으로 응답되고, base64는 페이로드를 약 4/3로 -부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기 파트너 규칙에 도달하기 -전에 거부됩니다. 그 크기에서는 단일 에셋이 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 갖습니다. 전송 상한은 여러 에셋에 걸쳐 적용되는데, 100 MiB Router 상한이 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 근접하는 항목은 공개 URL로 전송하세요. + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에 media 입력이 없으므로 + 이 필드는 설정하지 마세요. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기법들에 대해 media + 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 + 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. 허용되는 type과 그 상한이 +모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 않습니다. +스키마 검증을 통과했다고 해서 공급자가 받아들인다는 뜻은 아니며, 반대 방향으로도 +마찬가지입니다. 위의 에셋별 "최대 20MB" 수치는 이미지 +입력(인라인으로 전송될 수 있는 유일한 입력)의 상한이며, 파트너가 최종적으로 +보유하는 에셋에 대한 파트너의 상한이고, 에셋이 공개 URL일 때 그대로 적용됩니다. +해당 바이트가 Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... +URL은 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router의 +POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, base64는 +페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기서 설명한 +파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의 단일20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 한도가 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 한도에 가까운 값은 공개 URL로 보내십시오. @@ -273,40 +272,35 @@ Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,.. - 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 (위의 `media` 설명에서 각 모델별로 나열한 바로 그 IMAGE 입력, 즉 wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image에 한해) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 사용하지 않습니다. 파트너의 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL이거나, 인라인 `data:{MIME_type};base64,...` URL입니다. 단, 인라인 URL은 위 `media` 설명에서 각 모델별로 나열한 바로 그 IMAGE 입력에만 해당합니다. wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, 그리고 happyhorse-1.0-video-edit의 reference_image입니다. 이 모델들 중 어느 것도 video, audio, file, link 입력에 인라인 data: URL을 허용하지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그런 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하십시오. - 역방향 프롬프트 단어는 비디오 화면에 나타나지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에 보이지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과하지 않아야 합니다 -(wan3.0-video의 경우 최대 20,000자, 한도를 초과하는 콘텐츠는 잘립니다). -참조 비디오가 여러 개인 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 -참조 비디오 순서대로 피사체를 지칭합니다. 예: "Character1이 길가에서 노래하고, Character2가 그 옆에서 춤을 춥니다" -wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 -media 배열 내의 해당 순서에 있는 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 문서에 명시된 자체 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자까지 받습니다. prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(중국어 약 20,000자)를 넘는 요청은 공급자가 거부하며, InvalidParameter `Range of input length should be [1, 61440]`를 응답합니다. 참조 비디오가 여러 개인 wan2.6-r2v에서는 'character1', 'character2' 등을 사용해 참조 비디오 순서대로 피사체를 지칭하십시오. 예: "Character1 sings on the roadside, Character2 dances beside it" wan3.0-video의 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 media 배열 내 해당 순서의 미디어 에셋을 지칭하십시오. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개 비디오 URL의 배열입니다. + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. 입력 제한: - 형식: mp4, mov -- 수량: 비디오 1-3개 -- 단일 비디오 길이: 2-30초 +- 수량: 비디오 1~3개 +- 단일 비디오 재생 시간: 2~30초 - 단일 파일 크기: 최대 30MB -- audio_url과 함께 사용할 수 없음 -참조 재생 시간: 비디오 1개는 최대 5초, 비디오 2개는 각각 최대 2.5초, 비디오 3개는 그보다 비례적으로 짧습니다. +- audio_url과 함께 사용할 수 없습니다. +참조 재생 시간: 비디오 1개는 최대 5초, 2개는 각각 최대 2.5초, 3개는 그에 비례해 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용하면 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 이를 반드시 제공해야 하며, 허용되는 표기의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 v1 직접 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -314,87 +308,86 @@ media 배열 내의 해당 순서에 있는 미디어 에셋을 지칭합니다. - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video 및 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않았습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이런 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 보존합니다 +- auto (기본값): 모델이 프롬프트 콘텐츠를 바탕으로 지능적으로 판단합니다. +- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다. 가능한 값: `auto`, `origin` - 생성되는 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초)입니다. - wan2.5 모델: 5초 또는 10초 -- wan2.6-t2v, wan2.6-i2v: 5, 10 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) +- wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 합니다. -1은 + 모델이 적절한 재생 시간을 고르는 스마트 재생 시간 모드를 활성화합니다. 이 프록시는 [-1, 30]을 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능형 재작성 사용 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 참입니다. - 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델에만 해당합니다. -wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도를 기반으로 -적절한 화면 비율을 자동으로 추천합니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델의 경우 값을 제공하지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)가 적절한 값을 자동으로 추천합니다.입력 미디어의 비율과 의도에 따른 화면 비율입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 수준. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 크기를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 선택하기 때문입니다. 검사하기 전에 해상도를 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum 밖의 값에 대해서는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P 크기로 보내든)에 대해 400을 반환합니다. +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) +- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) +- happyhorse-1.0-*(t2v, i2v, r2v, video-edit): 720P, 1080P +- happyhorse-1.1-*(t2v, i2v, r2v): 480P, 720P, 1080P +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. resolution 계층이 청구 요금을 선택하기 때문입니다. 확인 전에 resolution을 대문자로 변환하여 검사하고 대문자로 변환된 값을 전달합니다. 이 enum에 없는 값에는 400을 반환하며, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 resolution으로 보내든 480P size로 보내든 480P에 대해 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 + 난수 시드. 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다. 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. + 지능형 다중 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. - single: 단일 샷 비디오(기본값) -- multi: 멀티 샷 비디오 +- multi: 다중 샷 비디오 가능한 값: `multi`, `single` - 너비*높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: + width*height 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: wan2.5 T2V: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 wan2.6 T2V/R2V(480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -크기와 해상도를 모두 보내면 크기가 청구 등급을 선택하며, 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 청구 계층을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부입니다. 워터마크는 오른쪽 아래 모서리에 위치합니다. -Router가 `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 이전에 호출을 검증하는 대상과 동일한 문서입니다. +`GET /v2/models/wan/wan2.5-t2v-preview/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -403,7 +396,7 @@ Router가 `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json`에서 제공하 - 지능형 재작성 이후의 실제 프롬프트 (비디오 작업) + 지능형 재작성 이후의 실제 프롬프트 (비디오 작업용) @@ -419,11 +412,11 @@ Router가 `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json`에서 제공하 - 실패한 요청에 대한 상세 정보 (요청이 성공하면 반환되지 않음) + 실패한 요청에 대한 자세한 정보 (요청이 성공하면 반환되지 않음) - 원본 입력 프롬프트 (비디오 작업) + 원본 입력 프롬프트 (비디오 작업용) @@ -545,7 +538,7 @@ Router가 `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json`에서 제공하 - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 자세한 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index 6a36a63b74..8dd60bf7cf 100644 --- a/ko/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Wan 2.6 I2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.6-i2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태를 설명합니다" sidebarTitle: "Wan 2.6 I2V" -translationSourceHash: 2d86680e +translationSourceHash: 6912559c translationFrom: development/comfy-router/models/wan/wan2-6-i2v/code.mdx translationBlockHashes: "_intro": 53ec6bcb "Quick start": 0163076e - "Schema": 4b1f17d6 + "Schema": a13e6673 "Examples": 2b581e5f --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -190,80 +191,83 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 오디오 파일 다운로드 URL입니다. 지원 형식: mp3, wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 wan2.6-i2v -모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 않습니다. 이들은 -first_frame 타입의 media 요소로 받으며(아래 media 참조), wan2.6-i2v에서 성공하는 img_url -본문은 happyhorse-1.0-i2v와 happyhorse-1.1-i2v에서 공급자가 거부합니다. 또한 -wan2.7/wan3.0 표기는 참조 에셋도 media로 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 +받지 않습니다. 즉 first_frame 유형의 미디어 요소로 받으며(아래 media 참고), +wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 +happyhorse-1.1-i2v에서 공급자가 거부합니다. 그리고 wan2.7/wan3.0 표기는 참조 +에셋을 media에서도 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 모든 -모델이 공유하며, 어떤 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 비디오 입력을 -img_url 또는 reference_video_urls가 아닌 여기에서 받는지는 모델마다 다릅니다. 모델별로 -지원되는 type 값은 다음과 같습니다. + 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 +제공되는 모든 모델이 공유하며, 주어진 모델이 어떤 type 값을 허용하는지, 그리고 +이미지나 비디오 입력을 img_url이나 reference_video_urls가 아닌 여기에서 받는지 +여부는 모델에 따라 다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 - 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL입니다. - driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, 각 변 - 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 - 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1), reference_image, reference_video. - reference_image 또는 reference_video가 최소 하나 필요하며, reference_image와 - reference_video는 합계 최대 5개입니다. first_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 - 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL입니다. - reference_video: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, 각 변 240-4096 - 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택 - 사항인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 - 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)입니다. -- wan3.0-video, wan3.0-video-prime: first_frame(최대 1), last_frame(최대 1), - reference_image(최대 10), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1, link와 함께 - 사용할 수 없음), link(최대 1, file과 함께 사용할 수 없음). reference_*/file/link - 타입과 first_frame/last_frame 타입은 같은 요청 내에서 상호 배타적입니다. 배열 순서가 - 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 정의합니다. first_frame, - last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 - 비율 최대 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL입니다. - reference_video, reference_audio, file 및 link: 공개 HTTP/HTTPS URL이며, 인라인 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8 + ~ 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 첫 - 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 - 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL입니다. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 모델의 - 유일한 참조 입력입니다. 가장 짧은 변이 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, - 공개 URL 또는 data:\{MIME_type};base64,... URL입니다. reference_video는 이 연산의 - 입력 타입이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, 긴 변 - 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 - 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택 사항인 0~5개의 - reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 - 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)입니다. +- wan2.7-r2v: first_frame (선택 사항, 최대 1개), reference_image, reference_video. + 최소 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 + reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP + (알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8 ~ 8:1, 최대 + 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 + HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video (정확히 1개, 편집할 클립: MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 + 허용되지 않음) 및 선택적 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 1:8 ~ 8:1, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL). +- wan3.0-video, wan3.0-video-prime: first_frame (최대 1개), last_frame (최대 1개), + reference_image (최대 10개), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1개, link와 함께 사용할 수 + 없음), link (최대 1개, file과 함께 사용할 수 없음). reference_*/file/link 유형과 + first_frame/last_frame 유형은 같은 요청 안에서 상호 배타적입니다. + 배열 순서가 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, + Audio 1, ...)를 정의합니다. first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: + 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 + 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 + 1:2.5 ~ 2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 + 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, + 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 + 이 작업의 입력 유형이 아닙니다. +- happyhorse-1.0-video-edit: video (정확히 1개, 편집할 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 + 1:2.5 ~ 2.5:1, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: + URL은 허용되지 않음) 및 선택적 0~5개의 reference_image (JPEG/JPG/PNG/WEBP, + 최소 300x300 픽셀, 가로세로 비율 1:2.5 ~ 2.5:1, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 문서화되어 - 있지 않으므로 이 필드는 설정하지 마십시오. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 미디어 - 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url로 - 받고, wan2.6-r2v는 참조 클립을 reference_video_urls로 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 minItems/maxItems가 -선언되지 않았습니다. 허용되는 타입과 그 상한이 모델마다 다르기 때문입니다. 스키마가 받아들인다고 -해서 공급자가 받아들인다는 뜻은 아니며, 다른 방향으로 보면 위의 에셋별 "최대 20MB" 수치는, -인라인으로 전송될 수 있는 유일한 입력인 이미지 입력에 대한 상한으로서, 파트너가 최종적으로 -갖게 되는 에셋에 대한 파트너의 상한이고, 에셋이 공개 URL일 때는 그대로 적용됩니다. 그 바이트가 -Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 -전송 상한도 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413이 -반환되고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기의 -어떤 파트너 규칙에도 도달하기 전에 거부됩니다. 그 크기에서는 파트너 자체의 단일 에셋이20MB 상한은 인라인으로 편안하게 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. -여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 -요청 전체를 제한하기 때문입니다. 이러한 상한에 근접하는 값은 공개 URL로 보내세요. + 텍스트 기반 비디오 생성 연산. 해당 파트너 참조 문서에는 미디어 입력이 문서화되어 있지 않으므로 이 필드를 + 설정하지 않은 채로 두십시오. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 미디어 + 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 + 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. +위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. 허용되는 유형과 +상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되지 +않습니다. 스키마가 수용한다고 해서 공급자가 수용한다는 뜻은 아닙니다. 그리고 +반대 방향으로, 위의 에셋별 "최대 20MB" 수치, 즉 인라인으로 전송될 수 있는 +유일한 입력인 이미지 입력에 대한 상한은 파트너가 최종적으로 받게 되는 +에셋에 대한 파트너의 상한이며, 에셋이 공개 URL일 때는 그 바이트가 +Comfy를 거치지 않으므로 명시된 그대로 적용됩니다. 인라인 data:\{MIME_type};base64,... +URL은 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router +POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, +base64는 페이로드를 약 4/3로 부풀리므로, 대략 75 MB를 초과하는 단일 인라인 +에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서는 단일 에셋이 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 전송 상한은 여러 에셋에 걸쳐 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 값은 공개 URL로 전송하세요. @@ -273,40 +277,37 @@ Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,.. - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위 `media` 설명이 각 모델에 대해 나열한 정확히 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들에서 비디오, 오디오, 파일, 링크 입력 중 인라인 data: URL을 받는 것은 없습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참조하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 정확히 위의 `media` 설명이 각 모델별로 나열한 IMAGE 입력(wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 허용하지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 네거티브 프롬프트 단어는 비디오 화면에 나타나지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 제한을 초과하는 콘텐츠는 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용해 -참조 비디오 순서대로 대상을 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 media 배열 내 -해당 순서의 미디어 에셋을 지칭하세요. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 자체 문서화된 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자를 받습니다. 공급자는 prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000자의 중국어)를 넘는 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. +참조 비디오가 여러 개인 wan2.6-r2v의 경우, 'character1', 'character2' 등을 사용하여 참조 비디오 순서대로 피사체를 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내 해당 순서의 미디어 에셋을 지칭하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. 입력 제한: - 형식: mp4, mov -- 개수: 비디오 1-3개 -- 비디오 1개 길이: 2-30초 +- 개수: 비디오 1~3개 +- 비디오 1개 길이: 2~30초 - 파일 1개 크기: 최대 30MB -- audio_url과 함께 사용할 수 없음 -참조 재생 시간: 비디오 1개는 최대 5초, 2개는 각각 최대 2.5초, 3개는 그보다 비례적으로 짧습니다. -과금: 실제 사용한 참조 재생 시간을 기준으로 합니다. +- audio_url과 함께 사용할 수 없습니다 +참조 재생 시간: 비디오 1개는 최대 5초, 비디오 2개는 각각 최대 2.5초, 비디오 3개는 그에 비례하여 더 짧습니다. +과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용하면 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기 목록은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -319,83 +320,83 @@ wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사 wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 보존합니다 +- auto (기본값): 프롬프트 콘텐츠에 따라 모델이 지능적으로 판단합니다 +- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 가능한 값: `auto`, `origin` - 생성된 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초)입니다: - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 가능(15초 지원 없음) +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없으며, -1은 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수. 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 합니다. -1은 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 재생 시간이 [-1, 30]을 벗어나면 400을 반환합니다. +이 프록시는 [-1, 30] 범위를 벗어난 duration에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성 사용 여부입니다. 기본값은 true입니다 - 생성된 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델에만 해당합니다. -wan2.7 모델의 경우 제공하지 않으면 해상도 등급을 기준으로 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -화면 비율을 자동으로 추천합니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델의 경우, 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우, adaptive(기본값)는 적절한입력 미디어의 비율과 의도에 기반한 가로세로 비율입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 수준입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 가능(480P 지원 없음) -- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원 (480P 미지원) +- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P - -이 프록시는 해상도와 size를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 해상도는 검사하기 전에 대문자로 변환하고 변환된 값을 그대로 전달하며, 이 enum에 없는 값에 대해서는 400을 반환하고, 위에 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P size로 보내든)에 대해 400을 반환합니다. +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 과금 요율을 선택하기 때문입니다. 이 프록시는 검사 전에 resolution을 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum 밖의 값에 대해서는 400을 반환하고, 위에서 480P를 지원하지 않는다고 나열된 wan2.6, wan2.7, happyhorse-1.0 모델의 경우 480P(resolution으로 보내든 480P size로 보내든)에 대해 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용하는 난수 시드 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. -wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오(기본값) -- multi: 멀티 샷 비디오 + 지능형 다중 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. +wan2.6 및 wan2.7-r2v 모델 대상입니다. +- single: 단일 샷 비디오 (기본값) +- multi: 다중 샷 비디오 가능한 값: `multi`, `single` - width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다. -wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V (480P 없음): + 너비*높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V의 경우 (480P 미지원): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 resolution을 모두 보내는 경우 size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 과금 등급을 선택하며, +resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 +해상도 설명에서 480P를 지원하지 않는다고 나열한 모든 모델에서 400을 반환합니다. 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 -Router가 `GET /v2/models/wan/wan2.6-i2v/openapi.json`에서 제공하는 스키마로부터 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/wan/wan2.6-i2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -408,7 +409,7 @@ Router가 `GET /v2/models/wan/wan2.6-i2v/openapi.json`에서 제공하는 스키 - 오디오 생성이 포함된 I2V 작업의 오디오 URL + 오디오 생성을 포함하는 I2V 작업의 오디오 URL @@ -436,11 +437,11 @@ Router가 `GET /v2/models/wan/wan2.6-i2v/openapi.json`에서 제공하는 스키 - 이미지 오류 코드 (일부 작업이 실패하면 반환됨) + 이미지 오류 코드 (일부 작업이 실패할 때 반환됨) - 이미지 오류 정보 (일부 작업이 실패하면 반환됨) + 이미지 오류 정보 (일부 작업이 실패할 때 반환됨) @@ -494,7 +495,7 @@ Router가 `GET /v2/models/wan/wan2.6-i2v/openapi.json`에서 제공하는 스키 - 출력 정보 통계. 성공한 결과만 집계됩니다 + 출력 정보 통계. 성공한 결과만 집계됨 @@ -522,7 +523,7 @@ Router가 `GET /v2/models/wan/wan2.6-i2v/openapi.json`에서 제공하는 스키 - 생성된 비디오의 화면 비율, 예: 16:9 (wan3.0-video 작업) + 생성된 비디오의 가로세로 비율, 예: 16:9 (wan3.0-video 작업) @@ -542,11 +543,11 @@ Router가 `GET /v2/models/wan/wan2.6-i2v/openapi.json`에서 제공하는 스키 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 envelope의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 envelope의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index 8b1d28189e..73fdec0694 100644 --- a/ko/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Wan 2.6 R2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.6-r2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 2.6 R2V" -translationSourceHash: 2a7dc724 +translationSourceHash: f2cccfce translationFrom: development/comfy-router/models/wan/wan2-6-r2v/code.mdx translationBlockHashes: "_intro": dc2fc376 "Quick start": 066eb9ee - "Schema": 104ab356 + "Schema": 789f5781 "Examples": dd88ebee --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,87 +193,82 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-r2v/requests/$REQUEST_ID \ - 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3, wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기서 받지 -않습니다. 대신 first_frame 유형의 media 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서 -공급자가 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 media에서 받습니다. -이미지 형식: JPEG, JPG, PNG, BMP, WEBP. -해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 +않습니다. first_frame 유형의 미디어 요소로 받으며(아래 media 참조), wan2.6-i2v에서 +성공하는 img_url 본문은 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서 공급자가 +거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 media에서 받습니다. 이미지 형식: +JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 + 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아닌 여기에서 받는지 -여부는 모델마다 다릅니다. 모델별 지원 type 값: +제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 +비디오 입력을 img_url 또는 reference_video_urls가 아닌 여기에서 받는지 여부는 +모델마다 다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 1:8~8:1, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, 변당 - 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 - 허용되지 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1), reference_image, reference_video. - 최소 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 - reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 변당 240-8000 픽셀, 가로세로 비율 - 1:8~8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - reference_video: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. + 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 + 않습니다. +- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. + reference_image 또는 reference_video가 최소 하나 필요하며, reference_image와 + reference_video는 합계 최대 5개입니다. first_frame 및 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 변당 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. - wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 - 않음)와 선택적으로 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 변당 - 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL)를 함께 사용합니다. -- wan3.0-video, wan3.0-video-prime: first_frame(최대 1), last_frame(최대 1), - reference_image(최대 10), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1, link와 함께 - 사용할 수 없음), link(최대 1, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 - 순서가 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 - 정의합니다. first_frame, last_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, - 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, - file 및 link: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개입니다. 이들 - 표기는 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, - 가로세로 비율 1:2.5~2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + 않음)와 선택적으로 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 + 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL)를 받습니다. +- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), + reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15s), + reference_audio(최대 5개 클립, 총 재생 시간 \<= 15s), file(최대 1개, link와 함께 + 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link + 유형과 first_frame/last_frame 유형은 동일한 요청 내에서 상호 배타적입니다. 배열 + 순서가 프롬프트 내 에셋의 참조 순서를 정의합니다(Image 1, Video 1, Audio 1, ...). + first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 + 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: + 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 사용하며 정확히 1개입니다. + 이 표기들은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, + 가로세로 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개입니다. 이것이 - 이 모델의 유일한 참조 입력입니다. 최단 변이 최소 400 픽셀, +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 사용하며 1~9개입니다. + 이것이 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 이 연산의 입력 유형이 아닙니다. - happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5~2.5:1, 최대 - 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택적으로 - 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 - 1:2.5~2.5:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)를 함께 - 사용합니다. -- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, - wan2.5-t2v-preview: 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 - 문서에는 미디어 입력이 문서화되어 있지 않으므로 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이들 표기에 대해 - 어떤 media 어휘도 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 - 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, + 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택적으로 + 0~5개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, 가로세로 비율 + 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)를 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되어 있지 않습니다. 허용되는 유형과 그 상한이 모델마다 -다르기 때문입니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 그리고 -반대 방향으로, 위의 에셋별 "최대 20MB" 수치는(이미지 입력, 즉 인라인으로 전송될 수 -있는 유일한 입력에 대한 상한) 파트너가 최종적으로 받는 에셋에 대한 파트너의 -상한이며, 해당 바이트는 Comfy를 거치지 않으므로 에셋이 공개 URL일 때는 적힌 그대로 -적용됩니다. 인라인 data:\{MIME_type};base64,... URL은 실제로 Comfy를 거치며 전송 -상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 -413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로, 대략 75 MB를 넘는 단일 -인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 -자체의 단일 에셋이20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나일 때는 파트너 규칙이 제약이 됩니다. -여러 개일 때는 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 -요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 무엇이든 -공개 URL로 전송하세요. +- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 문서화되어 있지 않으므로 이 필드를 설정하지 않고 비워 두십시오. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 어떤 + media 어휘도 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 프레임을 + img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. +위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. 허용되는 type과 그 +상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 않습니다. +스키마에서 허용된다고 해서 공급자가 허용하는 것은 아닙니다. 반대 방향으로, 위의 +에셋별 "최대 20MB" 수치는 이미지 입력, 즉 인라인으로 전송될 수 있는 유일한 입력에 +대한 상한이며, 파트너가 최종적으로 받는 에셋에 대한 파트너의 상한입니다. 이 수치는 +에셋이 공개 URL일 때 명시된 그대로 적용되는데, 그 바이트는 Comfy를 거치지 않기 +때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 +적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 +응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 초과하는 단일 인라인 +에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의 +단일 에셋20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 실제로 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 가까운 값은 공개 URL로 보내세요. @@ -282,31 +278,26 @@ minItems/maxItems가 선언되어 있지 않습니다. 허용되는 유형과 - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명이 각 모델별로 나열한 IMAGE 입력에 한해(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것에서도 비디오, 오디오, 파일 또는 링크 입력은 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 확인됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명이 각 모델별로 나열한 바로 그 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일, 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스가 발급하는 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그런 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역프롬프트 단어는 비디오 화면에 나타나지 않기를 원하는 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자, 제한을 초과하는 내용은 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우, 참조 비디오 순서에 따라 -'character1', 'character2' 등을 사용해 대상을 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우, media 배열 내 해당 순서에 따라 -'Image 1', 'Video 1', 'Audio 1' 등을 사용해 미디어 에셋을 지칭하세요. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 자체적으로 문서화된 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다: wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자까지 받습니다. 공급자는 prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(중국어 약 20,000자)를 넘는 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`를 응답합니다. 참조 비디오가 여러 개인 wan2.6-r2v에서는 참조 비디오 순서대로 피사체를 가리킬 때 'character1', 'character2' 등을 사용하세요. 예: "Character1이 길가에서 노래하고, Character2가 옆에서 춤춥니다" wan3.0-video 참조 모드에서는 media 배열 내 해당 순서대로 미디어 에셋을 가리킬 때 'Image 1', 'Video 1', 'Audio 1' 등을 사용하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. -입력 제한 사항: + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. +입력 제한: - 형식: mp4, mov -- 개수: 1~3개 비디오 -- 단일 비디오 길이: 2~30초 +- 수량: 비디오 1-3개 +- 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없습니다 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 2개는 각각 최대 2.5초, 비디오 3개는 그에 비례해 더 짧습니다. +참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례해 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. @@ -315,7 +306,7 @@ wan3.0-video 참조 모드의 경우, media 배열 내 해당 순서에 따라 - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -323,93 +314,86 @@ wan3.0-video 참조 모드의 경우, media 배열 내 해당 순서에 따라 - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이런 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 +- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단 +- origin: 입력 비디오의 원본 오디오를 강제로 보존 가능한 값: `auto`, `origin` - 생성된 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초)입니다: - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수; 비디오 입력이 있으면 총 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 넘을 수 없습니다; -1은 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30] 범위를 벗어난 duration에 대해 400을 반환합니다. +이 프록시는 [-1, 30]을 벗어난 재생 시간에 대해 400을 반환합니다. - 범위: `-1` ~ `30` + 범위: `-1`부터 `30`까지 - 프롬프트 지능적 재작성을 활성화할지 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 참입니다 - 생성된 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. -wan2.7 모델의 경우, 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우, adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 -적절한 비율을 자동으로 추천합니다. + 생성되는 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델에서는 제공되지 않으면 해상도 티어에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)가 적절한입력 미디어의 비율과 의도에 따른 종횡비입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 레벨입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만(480P 미지원) +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) - wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 크기를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. -해상도 등급이 과금 요율을 결정하기 때문입니다. 이 프록시는 값을 확인하기 전에 -해상도를 대문자로 변환하고 대문자로 변환한 값을 전달하며, 이 enum에 속하지 않는 -값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 -happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P 크기로 보내든)에 대해 400을 반환합니다. +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 과금 요율을 결정하기 때문입니다. 이 프록시는 검사 전에 resolution을 대문자로 변환하고 변환된 값을 전달하며, 이 enum에 없는 값에 대해서는 400을 반환하고, 위에서 480P 미지원으로 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 (resolution으로 보내든 480P size로 보내든) 480P에 대해 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 난수 시드로, 모델이 생성한 콘텐츠의 무작위성을 제어하는 데 사용됩니다 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다. - 범위: `0`부터 `2147483647`까지 + 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. + 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오 (기본값) +- single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 가능한 값: `multi`, `single` - width*height 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V (480P 없음): + width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V의 경우: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 미지원): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -크기와 해상도를 모두 보내면 크기가 과금 등급을 선택하며, -해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 -해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 과금 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 resolution 설명에서 480P 미지원으로 나열된 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다. -`GET /v2/models/wan/wan2.6-r2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 기준이 되는 동일한 문서입니다. +`GET /v2/models/wan/wan2.6-r2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -418,7 +402,7 @@ wan2.6 T2V/R2V (480P 없음): - 지능형 재작성 이후의 실제 프롬프트 (비디오 작업용) + 지능형 재작성 이후의 실제 프롬프트 (비디오 작업의 경우) @@ -438,7 +422,7 @@ wan2.6 T2V/R2V (480P 없음): - 원본 입력 프롬프트 (비디오 작업용) + 원본 입력 프롬프트 (비디오 작업의 경우) @@ -512,7 +496,7 @@ wan2.6 T2V/R2V (480P 없음): - 비디오 해상도 레벨 (I2V 및 wan3.0-video 작업) + 비디오 해상도 등급 (I2V 및 wan3.0-video 작업) @@ -556,11 +540,11 @@ wan2.6 T2V/R2V (480P 없음): - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 본문의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에서 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 본문의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 42102a4dcd..2ed3096fea 100644 --- a/ko/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Wan 2.7 I2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.7-i2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 2.7 I2V" -translationSourceHash: 6c8ca8c8 +translationSourceHash: 5c0685e4 translationFrom: development/comfy-router/models/wan/wan2-7-i2v/code.mdx translationBlockHashes: "_intro": d49c4d30 "Quick start": 167fa44a - "Schema": ac50dc1f + "Schema": 5e5f0bca "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -205,89 +206,87 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests/$REQUEST_ID \ ### 입력 - 프롬프트 단어 등의 기본 정보를 입력합니다. + 프롬프트 단어 등 기본 정보를 입력하세요. - 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 -사용할 수 없습니다. + 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기법은 첫 프레임을 여기에서 -받지 않습니다. 첫 프레임은 first_frame 유형의 미디어 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서는 -공급자가 거부합니다. 또한 wan2.7/wan3.0 표기법도 참조 에셋을 media에서 받습니다. -이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기법은 첫 프레임을 여기에서 +받지 않습니다. 해당 표기법은 first_frame 타입의 미디어 요소로 첫 프레임을 받으며 +(아래 media 참조), wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v와 +happyhorse-1.1-i2v에서 공급자가 거부합니다. 또한 wan2.7/wan3.0 표기법도 참조 +에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공하는 -모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지(그리고 이미지나 비디오 -입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지)는 모델마다 다릅니다. -모델별로 지원되는 type 값은 다음과 같습니다: + 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 +제공하는 모든 모델이 공유하며, 어떤 type 값을 주어진 모델이 허용하는지, 그리고 +이미지나 비디오 입력을 img_url이나 reference_video_urls가 아닌 여기에서 받는지 +여부는 모델마다 다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 - 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, 변당 - 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 - 않습니다. + last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8 ~ + 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며 인라인 + data: URL은 허용되지 않습니다. - wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - 최소 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 - reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 변당 240-8000 픽셀, 가로세로 비율 1:8에서 - 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - reference_video: 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, 변당 240-4096 - 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다)와 - 선택 사항인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, - 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL). + reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 + reference 비디오는 합쳐 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP + (알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8 ~ 8:1, 최대 + 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 + HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 + 허용되지 않음)와 선택적 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 1:8 ~ 8:1, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL). - wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 - 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 - 순서가 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 정의합니다. - first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 - 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link 타입과 + first_frame/last_frame 타입은 같은 요청 내에서 상호 배타적입니다. 배열 + 순서가 프롬프트 내 에셋의 참조 순서(이미지 1, 비디오 1, 오디오 1, ...)를 정의합니다. + first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 해당하며 정확히 1개입니다. - 이 표기법은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, - 가로세로 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기법들은 + 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 + 1:2.5 ~ 2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 해당하며 1~9개입니다. - 이것이 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, - JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - reference_video는 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, 긴 변 - 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 - 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다)와 선택 - 사항인 0~5개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, 가로세로 - 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL). +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 + 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, + 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 + 이 연산의 입력 타입이 아닙니다. +- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5 ~ 2.5:1, + 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 + 선택적 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, + 최소 300x300 픽셀, 가로세로 비율 1:2.5 ~ 2.5:1, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 - 명시되어 있지 않으므로 이 필드를 설정하지 마십시오. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기법들에 대해 미디어 - 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 - img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다: 허용되는 유형과 그 상한이 -모델마다 다르므로 media에는 minItems/maxItems가 선언되어 있지 않습니다. 스키마가 -허용한다고 해서 공급자가 허용한다는 뜻은 아니며, 반대 방향으로 위의 에셋별 "최대 20MB" -수치는(인라인으로 전송될 수 있는 유일한 입력인 이미지 입력의 상한) 파트너가 최종적으로 -갖게 되는 에셋에 대한 파트너의 상한이며, 에셋이 공개 URL일 때는 그 바이트가 Comfy를 -거치지 않으므로 적힌 그대로 적용됩니다. 인라인 data:\{MIME_type};base64,... URL은 -Comfy를 거치므로 전송 상한도 적용됩니다: Comfy Router POST 본문은 총 100 MiB로 -제한되며 이를 초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 약 -75 MB를 초과하는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. -그 크기에서 파트너 자체의 단일 에셋은20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 실제로 제약이 됩니다. -여러 에셋에 걸치면 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 -요청 전체를 제한하기 때문입니다. 이러한 상한에 근접하는 값은 공개 URL로 전송하세요. + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 + 명시되어 있지 않으므로 이 필드를 설정하지 마세요. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기법들에 대해 + 미디어 어휘를 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 + 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. +위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. media에는 +minItems/maxItems가 선언되어 있지 않은데, 허용되는 타입과 그 상한이 모델마다 다르기 +때문입니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아니며, 반대 방향으로도 +마찬가지입니다. 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 +입력인 이미지 입력의 상한으로, 파트너가 최종적으로 받게 되는 에셋에 대한 파트너의 +상한입니다. 이 수치는 에셋이 공개 URL일 때 그대로 적용되는데, 해당 바이트가 Comfy를 +거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 +전송 상한도 함께 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 +넘으면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 +단일 인라인 에셋은 여기의 어떤 파트너 규칙에도 도달하기 전에 거부됩니다. 그 크기에서는 +파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 가까운 값은 공개 URL로 보내세요. @@ -297,31 +296,28 @@ Comfy를 거치므로 전송 상한도 적용됩니다: Comfy Router POST 본문 - 미디어 파일의 URL: 공개 HTTP/HTTPS URL, 또는 위의 `media` 설명이 각 모델별로 나열한 IMAGE 입력에 한해(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image) 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL 또는 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL이거나, 정확히 위의 `media` 설명이 각 모델별로 나열한 IMAGE 입력에 한해: wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image: 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 허용하지 않습니다. 파트너 자체 업로드 서비스가 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자가 가진 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. 이는 prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자, 제한을 초과하는 콘텐츠는 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 참조 비디오 순서대로 -대상을 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내의 -해당 순서에 따라 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 자체적으로 문서화된 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자까지 받습니다. prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)를 넘는 요청은 공급자가 거부하며, InvalidParameter `Range of input length should be [1, 61440]`를 응답합니다. +참조 비디오가 여러 개인 wan2.6-r2v의 경우, 참조 비디오 순서대로 대상을 지칭할 때 'character1', 'character2' 등을 사용하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드에서는 media 배열 내 해당 순서의 미디어 에셋을 지칭할 때 'Image 1', 'Video 1', 'Audio 1' 등을 사용하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. -입력 제한 사항: + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. +입력 제한: - 형식: mp4, mov -- 개수: 비디오 1-3개 -- 단일 비디오 길이: 2-30초 +- 수량: 비디오 1~3개 +- 단일 비디오 길이: 2~30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없음 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 비디오 세 개는 그보다 비례적으로 적습니다. +참조 재생 시간: 비디오 하나는 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례해 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. @@ -330,7 +326,7 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제한되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트로 이를 채우므로 Router 호출자는 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -338,26 +334,26 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원됩니다. 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 보존합니다 +- auto (기본값): 모델이 prompt 콘텐츠를 기반으로 지능적으로 판단 +- origin: 입력 비디오의 원본 오디오를 강제로 유지 가능한 값: `auto`, `origin` 생성되는 비디오의 재생 시간(초)입니다: -- wan2.5 모델: 5 또는 10초 -- wan2.6-t2v, wan2.6-i2v: 5, 10 또는 15초 -- wan2.6-r2v: 5 또는 10초만 지원(15초 미지원) +- wan2.5 모델: 5초 또는 10초 +- wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 하며, -1은 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. @@ -365,60 +361,61 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 프롬프트 지능적 재작성 활성화 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성 활성화 여부입니다. 기본값은 true입니다 - 생성된 비디오의 비율입니다. wan2.7 및 wan3.0 모델에만 해당됩니다. -wan2.7 모델의 경우 제공되지 않으면 해상도 등급을 기준으로 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어 비율과 의도를 기반으로 적절한 -비율을 자동으로 권장합니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)는 적절한미디어 입력 비율과 의도에 따른 화면 비율입니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 수준입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P - wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) - wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 resolution과 size를 모두 제공하지 않은 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요금을 결정하기 때문입니다. 이 프록시는 resolution을 확인하기 전에 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에 대해서는 400을 반환하고, 위에 480P가 없다고 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P size로 보내든)에 대해 400을 반환합니다. +이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 확인 전에 해상도를 대문자로 변환하여 대문자로 변환된 값을 전달하며, 이 열거형에 없는 값에는 400을 반환하고, 위에 나열된 480P 미지원 모델인 wan2.6, wan2.7, happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P size로 보내든)에 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 모델이 생성한 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드 + 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드입니다. 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. + 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. -- single: 단일 샷 비디오 (기본값) +- single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 가능한 값: `multi`, `single` - width*height 형식의 비디오 해상도. 지원되는 해상도는 모델마다 다릅니다: -wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V (480P 없음): + 너비*높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 미지원): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, +resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 +해상도 설명에서 480P 미지원으로 나열된 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다. -Router가 `GET /v2/models/wan/wan2.7-i2v/openapi.json`에서 제공하는 스키마, 즉 요청이 공급자에 도달하기 전에 호출을 검증하는 기준이 되는 동일한 문서에서 생성되었습니다. +Router가 `GET /v2/models/wan/wan2.7-i2v/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -427,7 +424,7 @@ Router가 `GET /v2/models/wan/wan2.7-i2v/openapi.json`에서 제공하는 스키 - 지능형 재작성 이후의 실제 프롬프트 (비디오 작업) + 지능형 재작성 이후의 실제 프롬프트 (비디오 작업용) @@ -447,7 +444,7 @@ Router가 `GET /v2/models/wan/wan2.7-i2v/openapi.json`에서 제공하는 스키 - 원본 입력 프롬프트 (비디오 작업) + 원본 입력 프롬프트 (비디오 작업용) @@ -509,7 +506,7 @@ Router가 `GET /v2/models/wan/wan2.7-i2v/openapi.json`에서 제공하는 스키 - 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간 24시간 + 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간은 24시간입니다 @@ -565,11 +562,11 @@ Router가 `GET /v2/models/wan/wan2.7-i2v/openapi.json`에서 제공하는 스키 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 envelope의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 envelope의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index 87686ee7a1..d078330c5e 100644 --- a/ko/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -2,18 +2,20 @@ title: "Comfy Router로 Wan 2.7 R2V 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan2.7-r2v를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드, 결과 형태를 설명합니다" sidebarTitle: "Wan 2.7 R2V" -translationSourceHash: f1b372da +translationSourceHash: fc3b1068 translationFrom: development/comfy-router/models/wan/wan2-7-r2v/code.mdx translationBlockHashes: "_intro": 5428b08c "Quick start": 204ef296 - "Schema": 18b98be3 + "Schema": 7d82934a "Examples": a91cb6b1 --- + + {/* 생성된 파일입니다. 이 디렉터리의 code.yaml을 편집한 뒤 `pnpm code-pages:gen`을 실행하세요. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -210,83 +212,82 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-r2v/requests/$REQUEST_ID \ - 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식은 mp3와 wav입니다. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기법은 첫 프레임을 여기서 -받지 않습니다. 이들은 first_frame 유형의 media 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 -happyhorse-1.1-i2v의 공급자에서 거부됩니다. 또한 wan2.7/wan3.0 표기법도 참조 -에셋을 media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 +않습니다. 해당 모델들은 first_frame 타입의 미디어 요소로 받으며(아래 media 참조), +wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서 +공급자가 거부합니다. 또한 wan2.7/wan3.0 표기는 참조 에셋을 media로 받습니다. +이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 주어진 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아니라 여기에서 -받는지 여부는 모델마다 다릅니다. 모델별 지원 type 값: + 미디어 에셋 목록입니다. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공하는 +모든 모델이 공유하며, 어떤 모델이 어떤 type 값을 받아들이는지, 그리고 이미지 또는 +비디오 입력을 img_url이나 reference_video_urls가 아닌 여기에서 받는지 여부는 모델마다 +다릅니다. 모델별 지원 type 값: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 1:8~8:1, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, - 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 data: URL은 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 한 변당 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, + 한 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame (선택 사항, 최대 1개), reference_image, reference_video. - reference_image 또는 reference_video 중 최소 하나가 필요하며, reference 이미지와 - reference 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 변당 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 - 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 - 허용되지 않음)와 선택적으로 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, - 변당 240-8000 픽셀, 가로세로 비율 1:8~8:1, 최대 20MB, 공개 URL - 또는 data:\{MIME_type};base64,... URL). -- wan3.0-video, wan3.0-video-prime: first_frame (최대 1개), last_frame (최대 1개), - reference_image (최대 10개), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1개, link와 함께 - 사용할 수 없음), link (최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 동일한 요청 내에서 상호 배타적입니다. - 배열 순서는 프롬프트에서 에셋의 참조 순서를 정의합니다(Image 1, Video 1, - Audio 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, - 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 +- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. + reference_image 또는 reference_video가 최소 하나 필요하며, reference 이미지와 + reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 한 변당 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, 한 변당 + 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 + 않음)와 선택 사항인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 한 변당 + 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL)입니다. +- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), + reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 + 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link + 타입과 first_frame/last_frame 타입은 같은 요청 안에서 상호 배타적입니다. 배열 + 순서가 프롬프트 내 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 정의합니다. + first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 한 변당 + 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: - 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 해당하며 정확히 1개입니다. - 이 표기법은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, - 가로세로 비율 1:2.5~2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 + 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개입니다. 이 + 표기들은 첫 프레임을 img_url이 아닌 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 + 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 해당하며 1~9개입니다. - 이것이 이 모델의 유일한 참조 입력입니다. 가장 짧은 변이 최소 400 픽셀, JPEG/JPG/PNG/WEBP, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 - 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 - 1:2.5~2.5:1, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: - URL은 허용되지 않음)와 선택적으로 0~5개의 reference_image (JPEG/JPG/PNG/WEBP, - 최소 300x300 픽셀, 가로세로 비율 1:2.5~2.5:1, 최대 20MB, 공개 URL - 또는 data:\{MIME_type};base64,... URL). +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개입니다. 이것이 이 + 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 + 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. 이 연산에서 reference_video는 + 입력 타입이 아닙니다. +- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, + 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 선택 + 사항인 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 + 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... + URL)입니다. - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 - 문서화되어 있지 않으므로 이 필드를 설정하지 않은 상태로 두세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기법들에 대해 - 어떤 media 어휘도 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 - 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되지 않았는데, 허용되는 유형과 그 상한이 모델마다 다르기 -때문입니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 그리고 -반대 방향으로 보면, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 -유일한 입력인 이미지 입력의 상한이며, 파트너가 최종적으로 받는 에셋에 대한 -파트너의 상한이고, 에셋이 공개 URL일 때는 그대로 적용됩니다. 그 바이트는 Comfy를 -거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 실제로 Comfy를 -거치며 전송 상한도 마주합니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 -초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로, 약 75 MB를 -넘는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 -크기에서 파트너 자체의 단일 에셋은20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나일 때는 파트너 규칙이 적용됩니다. 여러 개일 때는 전송 상한이 적용되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 근접하는 것은 모두 공개 URL로 보내세요. + 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 미디어 입력이 없으므로 + 이 필드를 설정하지 않은 채로 둡니다. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 어떤 + 미디어 어휘도 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 + img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. 허용되는 타입과 그 상한이 +모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 않습니다. 스키마 +수용이 공급자 수용을 의미하지는 않으며, 반대 방향으로도 마찬가지입니다. 위의 에셋별 +"최대 20MB" 수치는 이미지 입력, 즉 인라인으로 전송될 수 있는 유일한 입력에 대한 +상한이며, 파트너가 최종적으로 받는 에셋에 대한 파트너의 상한입니다. 이 수치는 에셋이 +공개 URL일 때 명시된 그대로 적용되는데, 그 바이트는 Comfy를 거치지 않기 때문입니다. +인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 적용됩니다. +Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, +base64는 페이로드를 약 4/3로 부풀리므로 대략 75MB를 넘는 단일 인라인 에셋은 여기서 +설명한 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의 단일 에셋20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문에, 여러 에셋에 걸치면 전송 상한이 구속력을 가집니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 보내세요. @@ -296,32 +297,29 @@ minItems/maxItems가 선언되지 않았는데, 허용되는 유형과 그 상 - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명이 각 모델에 대해 나열한 바로 그 IMAGE 입력, 즉 wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image에 한해 인라인 `data:{MIME_type};base64,...` URL을 사용할 수 있습니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 확인됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참조하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위의 `media` 설명에서 각 모델별로 나열한 바로 그 IMAGE 입력(wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 사용하지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 부정 프롬프트 단어는 비디오 화면에 나타나지 않았으면 하는 콘텐츠를 설명하는 데 사용됩니다. + 네거티브 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 제한을 초과한 콘텐츠는 잘립니다). -참조 비디오가 여러 개인 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 -참조 비디오 순서대로 피사체를 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내 -해당 순서의 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. 문서화된 자체 길이를 넘으면 wan2.x 모델은 프롬프트를 거부하지 않고 잘라냅니다. wan2.5와 wan2.6은 1,500자, wan2.7은 5,000자입니다. wan3.0-video와 wan3.0-video-prime은 최대 20,000자를 받습니다. 공급자는 prompt와 negative_prompt를 합친 길이가 약 60,850바이트의 UTF-8 텍스트(약 20,000 중국어 문자)를 넘는 요청을 거부하며, InvalidParameter `Range of input length should be [1, 61440]`로 응답합니다. +참조 비디오가 여러 개인 wan2.6-r2v의 경우, 'character1', 'character2' 등을 사용해 참조 비디오 순서대로 피사체를 지칭합니다. 예: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 media 배열 내 해당 순서의 미디어 에셋을 지칭합니다. wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. 입력 제한: - 형식: mp4, mov -- 수량: 비디오 1~3개 -- 단일 비디오 길이: 2~30초 +- 개수: 1~3개 비디오 +- 비디오 단일 길이: 2~30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없음 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례하여 더 짧습니다. -과금: 실제로 사용된 참조 재생 시간을 기준으로 합니다. +참조 재생 시간: 비디오 1개는 최대 5초, 2개는 각각 최대 2.5초, 3개는 그에 비례해 더 짧습니다. +과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. @@ -329,7 +327,7 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 열거형은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출에서는 반드시 제공해야 하며, 허용되는 표기법의 열거형은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. @@ -342,7 +340,7 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 +- auto (기본값): 모델이 prompt 콘텐츠를 기반으로 지능적으로 판단합니다 - origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 가능한 값: `auto`, `origin` @@ -352,51 +350,51 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 생성되는 비디오의 재생 시간(초)입니다: - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이고, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 + 입력 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 하며, -1은 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 -이 프록시는 [-1, 30]을 벗어나는 재생 시간에 대해 400을 반환합니다. +이 프록시는 [-1, 30]을 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능형 재작성 활성화 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 참입니다 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. -wan2.7 모델의 경우 제공하지 않으면 해상도 등급에 따라 기본값이 결정됩니다. +wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -화면 비율을 자동으로 추천합니다. +화면 비율을 자동으로 권장합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 레벨입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (upstream 기본값 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size 중 어느 것도 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 선택하기 때문입니다. 확인하기 전에 해상도를 대문자로 변환하고 변환된 값을 전달하며, 이 enum에 없는 값에 대해서는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 480P(해상도로 보내든 480P size로 보내든)에 대해 400을 반환합니다. +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) +- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) +- happyhorse-1.0-*(t2v, i2v, r2v, video-edit): 720P, 1080P +- happyhorse-1.1-*(t2v, i2v, r2v): 480P, 720P, 1080P +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 검사 전에 resolution을 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 열거형에 없는 값에 대해서는 400을 반환하고, 위에서 480P를 지원하지 않는 것으로 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서 480P(resolution으로 보내든 480P size로 보내든)에 대해서는 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 난수 시드로, 모델이 생성한 콘텐츠의 무작위성을 제어하는 데 사용됩니다 + 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다. 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. + 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델용입니다. - single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 @@ -406,18 +404,18 @@ wan2.6 및 wan2.7-r2v 모델용입니다. width*height 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: -wan2.5 T2V의 경우: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V의 경우(480P 없음): +wan2.5 T2V: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 미지원): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해상도는 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내는 경우, size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 해상도 설명에서 480P를 지원하지 않는 것으로 나열된 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다. -`GET /v2/models/wan/wan2.7-r2v/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에게 도달하기 이전에 호출을 검증하는 대상이 되는 것과 동일한 문서입니다. +`GET /v2/models/wan/wan2.7-r2v/openapi.json`에서 Router가 제공하는 스키마를 기반으로 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -430,7 +428,7 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 오디오 생성이 포함된 I2V 작업용 오디오 URL + 오디오 생성이 포함된 I2V 작업의 오디오 URL @@ -458,11 +456,11 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 이미지 오류 코드 (일부 작업이 실패할 때 반환됨) + 이미지 오류 코드 (일부 작업이 실패하면 반환됨) - 이미지 오류 정보 (일부 작업이 실패할 때 반환됨) + 이미지 오류 정보 (일부 작업이 실패하면 반환됨) @@ -508,19 +506,19 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간 24시간 + 완료된 비디오 생성 작업의 비디오 URL. 링크 유효 기간은 24시간 - 고유 요청 식별자 + 고유한 요청 식별자 - 출력 정보 통계. 성공한 결과만 집계됩니다 + 출력 정보 통계. 성공한 결과만 집계됨 - 비디오 해상도 등급 (I2V 및 wan3.0-video 작업) + 비디오 해상도 수준 (I2V 및 wan3.0-video 작업) @@ -544,7 +542,7 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 생성된 비디오의 화면 비율, 예: 16:9 (wan3.0-video 작업) + 생성된 비디오의 가로세로 비율, 예: 16:9 (wan3.0-video 작업) @@ -564,11 +562,11 @@ size와 해상도를 모두 보내면 size가 청구 등급을 선택하며, 해 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에서 보고됨 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에서 보고됨 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 읽으세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/ko/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index 9b4402cdbf..cba37c0fb0 100644 --- a/ko/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/ko/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Wan 3.0 Video Prime 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan3.0-video-prime을 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 3.0 Video Prime" -translationSourceHash: 63c2c33a +translationSourceHash: 1fc83550 translationFrom: development/comfy-router/models/wan/wan3-0-video-prime/code.mdx translationBlockHashes: "_intro": 812fcd16 "Quick start": 1ae93564 - "Schema": 8f9dbbd5 + "Schema": d589709d "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -182,131 +183,126 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video-prime/requests/$REQUEST_ID ### 입력 - 프롬프트 단어 등과 같은 기본 정보를 입력합니다. + 프롬프트 단어 등 기본 정보를 입력합니다. - 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL입니다. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 -받지 않습니다. 이들은 first_frame 유형의 media 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서 -공급자가 거부합니다. 또한 wan2.7/wan3.0 표기도 참조 에셋을 media로 받습니다. -이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터입니다. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서는 필수입니다. happyhorse-1.x i2v 표기법은 첫 프레임을 여기에서 +받지 않습니다. 즉, first_frame 유형의 media 요소로 받으며(아래 media 참조), +wan2.6-i2v에서 성공하는 img_url 본문은 공급자가 happyhorse-1.0-i2v 및 +happyhorse-1.1-i2v에서 거부합니다. 또한 wan2.7/wan3.0 표기법도 참조 에셋을 +media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록. 비디오 생성을 위한 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 -이미지나 비디오 입력을 img_url 또는 reference_video_urls가 아니라 여기에서 받는지 -여부는 모델마다 다릅니다. 모델별로 지원되는 type 값: + 미디어 에셋 목록입니다. 비디오 생성에 사용할 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 제공되는 +모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 비디오 +입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지 여부는 모델마다 +다릅니다. 모델별 지원 type 값은 다음과 같습니다. - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. driving_audio(WAV/MP3, 2-30초, 최대 15MB) 및 first_clip(MP4/MOV, 2-10초, - 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 + 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1), reference_image, reference_video. - reference_image 또는 reference_video 중 최소 하나가 필요하며, 참조 이미지와 - 참조 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP - (알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 - 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 중인 클립: MP4/MOV, 2-10초, - 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 - 허용되지 않음) 및 선택적 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL - 또는 data:\{MIME_type};base64,... URL). +- wan2.7-r2v: first_frame(선택 사항, 최대 1), reference_image, reference_video. 최소 + 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 + reference 비디오는 합계 최대 5개입니다. first_frame 및 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 변당 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: + 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 + 허용되지 않음)와 선택 사항인 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 변당 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL)로 구성됩니다. - wan3.0-video, wan3.0-video-prime: first_frame(최대 1), last_frame(최대 1), reference_image(최대 10), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1, link와 함께 사용할 수 없음), link(최대 1, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 - 순서는 프롬프트에서 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 정의합니다. + 유형과 first_frame/last_frame 유형은 같은 요청 안에서 상호 배타적입니다. 배열 + 순서가 프롬프트 내 에셋의 참조 순서(Image 1, Video 1, Audio 1, ...)를 정의합니다. first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, - 각 변 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: - 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 - 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 - 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 - 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, + 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 사용하며, 정확히 1개입니다. + 이 표기법은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, + 가로세로 비율 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL + 또는 data:\{MIME_type};base64,... URL. +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 사용하며, 1~9개입니다. + 이것이 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video는 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 중인 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음) 및 선택적 - 0~5개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, 가로세로 비율 - 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). +- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 + 사이, 최대 100MB, 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않음)와 + 선택 사항인 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, + 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL)로 구성됩니다. - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산. 해당 파트너 참조 문서에는 미디어 입력이 문서화되어 - 있지 않으므로 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 미디어 - 어휘를 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 프레임을 + 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 + 기재되어 있지 않으므로 이 필드를 설정하지 마세요. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기법들에 대한 + 미디어 용어를 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. media에는 -minItems/maxItems가 선언되지 않았는데, 허용되는 유형과 그 상한이 모델마다 다르기 -때문입니다. 스키마가 받아들인다고 해서 공급자가 받아들인다는 뜻은 아닙니다. 그리고 -반대 방향으로, 위의 에셋별 "최대 20MB" 수치(이미지 입력에 대한 상한이며, 인라인으로 -전송될 수 있는 유일한 입력입니다)는 파트너가 최종적으로 다루게 되는 에셋에 대한 -파트너의 상한이며, 에셋이 공개 URL일 때는 그대로 적용됩니다. 그 바이트는 Comfy를 -거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 -전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 넘으면 -413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 약 75 MB를 초과하는 단일 -인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 정도 크기에서는 -파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. -여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한이 각 요소가 아니라 -요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 값은 공개 URL로 보내세요. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. 허용되는 유형과 그 상한이 +모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 않습니다. 스키마가 +수용한다고 해서 공급자도 수용한다는 의미는 아닙니다. 반대 방향으로, 위의 에셋별 +"최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 입력인 이미지 입력에 대한 +상한이며, 파트너가 최종적으로 보유하는 에셋에 대한 상한입니다. 이 수치는 에셋이 +공개 URL일 때 그대로 적용되는데, 해당 바이트가 Comfy를 거치지 않기 때문입니다. +인라인 data:\{MIME_type};base64,... URL은 실제로 Comfy를 거치므로 전송 상한도 +적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 +응답하고, base64는 페이로드를 약 4/3로 부풀리므로 약 75 MB를 넘는 단일 인라인 +에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 해당 크기에서 단일 에셋은 +파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 공개 URL로 보내세요. 미디어 에셋 유형 - 가능한 값: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + Possible values: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` - 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위 `media` 설명에서 각 모델별로 나열한 정확히 IMAGE 입력들(wan2.7-i2v의 first_frame 및 last_frame, wan2.7-r2v의 first_frame 및 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video 및 wan3.0-video-prime의 first_frame, last_frame 및 reference_image, happyhorse-1.0-i2v 및 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v 및 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어떤 비디오, 오디오, 파일 또는 링크 입력도 인라인 data: URL을 허용하지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총합으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참조하세요. + 미디어 파일의 URL: 공개 HTTP/HTTPS URL이거나, 아니면 정확히 위의 `media` 설명에 각 모델별로 나열된 이미지 입력(wan2.7-i2v의 first_frame과 last_frame; wan2.7-r2v의 first_frame과 reference_image; wan2.7-videoedit의 reference_image; wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image; happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame; happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image; happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일, 링크 입력에 인라인 data: URL을 허용하지 않습니다. 파트너 자체 업로드 서비스에서 발급한 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center의 asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그런 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 전체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다 + 역방향 프롬프트 단어는 비디오 화면에 나타나지 않기를 원하는 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며, 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며 제한을 초과하는 콘텐츠는 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용하여 -참조 비디오 순서대로 피사체를 지칭합니다. 예: "Character1이 길가에서 노래하고, Character2가 옆에서 춤춘다" -wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사용하여 media 배열 내 -해당 순서의 미디어 에셋을 지칭합니다. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. wan3.0-video와 wan3.0-video-prime은 최대 +20,000자까지 받습니다. 미디어 배열 내의 해당 순서대로 미디어 에셋을 지칭하려면 'Image 1', 'Video 1', 'Audio 1' 등을 사용하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. 입력 제한: - 형식: mp4, mov -- 개수: 비디오 1~3개 -- 단일 비디오 길이: 2~30초 +- 개수: 비디오 1-3개 +- 단일 비디오 길이: 2-30초 - 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없음 -참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 비디오 세 개는 그보다 비례적으로 짧습니다. +참조 재생 시간: 단일 비디오 최대 5초, 비디오 두 개는 각각 최대 2.5초, 세 개는 그에 비례하여 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용하면 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로, Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다: Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로, Router 호출자는 이를 생략합니다. @@ -314,93 +310,88 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않았습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 -- origin: 입력 비디오의 원본 오디오를 강제로 유지합니다 +- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단 +- origin: 입력 비디오의 원본 오디오를 강제로 유지 - 가능한 값: `auto`, `origin` + Possible values: `auto`, `origin` - 생성된 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초)입니다: - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 - wan2.6-r2v: 5초 또는 10초만 (15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이며, 비디오 입력이 있으면 총 - 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 - 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수; 비디오 입력이 있으면 입력 + 비디오 재생 시간 + 출력 비디오 재생 시간의 합이 30초를 넘지 않아야 함; -1은 모델이 + 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화 이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. 범위: `-1` ~ `30` - 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 true입니다 + 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 참입니다. - 생성된 비디오의 비율입니다. wan2.7 및 wan3.0 모델에만 적용됩니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어 비율과 의도에 따라 적절한 -비율을 자동으로 추천합니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도를 기반으로 적절한 +화면 비율을 자동으로 추천합니다. - 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + Possible values: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 레벨입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P - wan2.6 모델 (t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본 1080P) +- wan2.7 모델 (i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 해상도와 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 -과금 요율을 결정하기 때문입니다. 이 프록시는 검사하기 전에 해상도를 대문자로 변환하고 대문자로 -변환된 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 -wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 보내든 480P size로 보내든)에는 400을 -반환합니다. +이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부하는데, +해상도 등급이 과금 요율을 결정하기 때문입니다. 확인 전에 resolution을 대문자로 +변환하고 대문자로 변환된 값을 전달하며, 400을 반환합니다이 enum 외부의 값에 대해서는, 그리고 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 전송되든 480P 크기로 전송되든)에 대해 400을 반환합니다. - Possible values: `480P`, `720P`, `1080P` + 가능한 값: `480P`, `720P`, `1080P` - 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드 + 모델 생성 콘텐츠의 무작위성을 제어하는 데 사용되는 난수 시드 - 범위: `0` ~ `2147483647` + 범위: `0`부터 `2147483647`까지 - 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. -wan2.6 및 wan2.7-r2v 모델용. -- single: 단일 샷 비디오 (기본값) -- multi: 멀티 샷 비디오 + 지능형 다중 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. wan2.6 및 wan2.7-r2v 모델에서 사용할 수 있습니다. +- single: 단일 샷 비디오(기본값) +- multi: 다중 샷 비디오 - Possible values: `multi`, `single` + 가능한 값: `multi`, `single` - 너비*높이 형식의 비디오 해상도. 지원되는 해상도는 모델마다 다릅니다: -wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 -wan2.6 T2V/R2V (480P 없음): + 너비*높이 형식의 비디오 해상도입니다. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V의 경우: 480P(480*832, 832*480, 624*624), 720P, 1080P 크기 +wan2.6 T2V/R2V(480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 resolution을 모두 보내면 size가 과금 등급을 선택하며, -resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 -resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 보내면 size가 과금 티어를 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다. -`GET /v2/models/wan/wan3.0-video-prime/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 기준이 되는 것과 동일한 문서입니다. +Router가 `GET /v2/models/wan/wan3.0-video-prime/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -413,7 +404,7 @@ resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 - 오디오 생성이 포함된 I2V 작업의 오디오 URL + 오디오 생성이 포함된 I2V 작업용 오디오 URL @@ -503,7 +494,7 @@ resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 - 비디오 해상도 등급 (I2V 및 wan3.0-video 작업) + 비디오 해상도 레벨 (I2V 및 wan3.0-video 작업) @@ -547,11 +538,11 @@ resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 - 실패한 요청의 오류 코드로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). + 실패한 요청의 오류 코드로, `output` 아래가 아니라 응답 봉투의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 봉투의 최상위(ROOT)에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 먼저 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/models/wan/wan3-0-video/code.mdx b/ko/development/comfy-router/models/wan/wan3-0-video/code.mdx index 567f8430a9..6842d77847 100644 --- a/ko/development/comfy-router/models/wan/wan3-0-video/code.mdx +++ b/ko/development/comfy-router/models/wan/wan3-0-video/code.mdx @@ -2,19 +2,20 @@ title: "Comfy Router로 Wan 3.0 Video 사용하기" description: "Comfy Router를 통해 HTTP로 wan/wan3.0-video를 호출하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Wan 3.0 Video" -translationSourceHash: 75a2a69d +translationSourceHash: b17ea6e7 translationFrom: development/comfy-router/models/wan/wan3-0-video/code.mdx translationBlockHashes: "_intro": 352f7edf "Quick start": a6cbe623 "Serving providers": 1e291df8 - "Schema": 133669ca + "Schema": 44f84073 "Examples": 5ffd46d7 --- + {/* 생성된 파일입니다. 이 디렉터리의 code.yaml을 편집한 후 `pnpm code-pages:gen`을 실행하세요. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -211,92 +212,91 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ `strict_mode`의 기본값은 false(false)이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 해당 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이 방식으로 라우팅되는 모든 모델을 다루는 [제공 공급자](/ko/development/comfy-router/providers)를 참고하세요. -## 스키마 +## Schema ### 입력 - 프롬프트 단어 등 기본 정보를 입력하세요. + 프롬프트 단어 등 기본 정보를 입력합니다. - 오디오 파일 다운로드 URL입니다. 지원 형식: mp3, wav. reference_video_urls와 함께 사용할 수 없습니다. + 오디오 파일 다운로드 URL. 지원 형식: mp3 및 wav. reference_video_urls와 함께 사용할 수 없습니다. - 첫 프레임 이미지 URL 또는 Base64로 인코딩된 데이터입니다. wan2.5-i2v-preview 및 -wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기법은 첫 프레임을 여기서 -받지 않습니다. 즉, first_frame 유형의 미디어 요소로 받으며(아래 media 참조), -wan2.6-i2v에서 성공하는 img_url 본문은 공급자가 happyhorse-1.0-i2v 및 -happyhorse-1.1-i2v에서 거부합니다. 또한 wan2.7/wan3.0 표기법도 참조 에셋을 -media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. + 첫 프레임 이미지 URL 또는 Base64 인코딩 데이터. wan2.5-i2v-preview 및 +wan2.6-i2v 모델에서 필수입니다. happyhorse-1.x i2v 표기는 첫 프레임을 여기에서 받지 +않습니다. 즉 첫 프레임은 first_frame 타입의 미디어 엘리먼트로 받으며(아래 media 참고), +wan2.6-i2v에서 성공하는 img_url 본문도 happyhorse-1.0-i2v 및 happyhorse-1.1-i2v에서는 +공급자가 거부합니다. 그리고 wan2.7/wan3.0 표기는 참조 에셋을 마찬가지로 media에서 +받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10MB. - 미디어 에셋 목록입니다. 비디오 생성용 참조 자료(이미지, 오디오, 비디오)를 -지정합니다. 각 요소는 type과 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 -제공되는 모든 모델이 공유하며, 특정 모델이 어떤 type 값을 허용하는지, 그리고 + 미디어 에셋 목록. 비디오 생성에 사용할 참조 자료(이미지, 오디오, 비디오)를 +지정합니다. 각 엘리먼트는 type 및 url 필드를 포함합니다. 이 필드는 이 컴포넌트에서 +제공되는 모든 모델이 공유하며, 어떤 모델이 어떤 type 값을 허용하는지, 그리고 이미지나 비디오 입력을 img_url이나 reference_video_urls가 아니라 여기에서 받는지 -여부는 모델마다 다릅니다. 모델별 지원 type 값은 다음과 같습니다: -- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame과 - last_frame: JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 1:8 - ~ 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - driving_audio(WAV/MP3, 2-30초, 최대 15MB)와 first_clip(MP4/MOV, 2-10초, - 변당 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL이며, 인라인 - data: URL은 허용되지 않습니다. -- wan2.7-r2v: first_frame(선택 사항, 최대 1개), reference_image, reference_video. - 최소 하나의 reference_image 또는 reference_video가 필요하며, reference 이미지와 - reference 비디오를 합쳐 최대 5개입니다. first_frame과 reference_image: - JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 변당 240-8000 픽셀, 가로세로 비율 1:8 ~ 8:1, - 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video: 공개 - HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- wan2.7-videoedit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, - 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 - 허용되지 않음)와 선택적 0~4개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 변당 240-8000 픽셀, 가로세로 비율 1:8 ~ 8:1, 최대 20MB, 공개 URL +여부는 모델마다 다릅니다. 모델별 지원 type 값: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 및 + last_frame: JPEG/JPG/PNG/BMP/WEBP, 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 + 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + driving_audio (WAV/MP3, 2-30초, 최대 15MB) 및 first_clip (MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB): 공개 HTTP/HTTPS URL. 인라인 data: URL은 + 허용되지 않습니다. +- wan2.7-r2v: first_frame (선택 사항, 최대 1개), reference_image, reference_video. + reference_image 또는 reference_video가 최소 하나 필요하며, 참조 이미지와 + 참조 비디오를 합쳐 최대 5개입니다. first_frame 및 reference_image: + JPEG/JPG/PNG/BMP/WEBP(알파 채널 없음), 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 + 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. + reference_video: 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, + 각 변 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 + 허용되지 않음)와 선택적인 0~4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, + 각 변 240-8000 픽셀, 가로세로 비율 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). -- wan3.0-video, wan3.0-video-prime: first_frame(최대 1개), last_frame(최대 1개), - reference_image(최대 10개), reference_video(최대 5개 클립, 총 재생 시간 \<= 15초), - reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 - 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link - 유형과 first_frame/last_frame 유형은 동일한 요청 내에서 상호 배타적입니다. - 배열 순서는 프롬프트에서 에셋의 참조 순서를 정의합니다(Image 1, Video 1, - Audio 1, ...). first_frame, last_frame 및 reference_image: - JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, - 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, - file 및 link: 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만 해당하며 정확히 1개입니다. - 이 표기법들은 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, - 가로세로 비율 1:2.5 ~ 2.5:1, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 +- wan3.0-video, wan3.0-video-prime: first_frame (최대 1개), last_frame (최대 1개), + reference_image (최대 10개), reference_video (최대 5개 클립, 총 재생 시간 \<= 15초), + reference_audio (최대 5개 클립, 총 재생 시간 \<= 15초), file (최대 1개, link와 + 함께 사용할 수 없음), link (최대 1개, file과 함께 사용할 수 없음). reference_*/file/link + 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. 배열 + 순서가 프롬프트 내 에셋의 참조 순서를 정의합니다(Image 1, Video 1, Audio 1, ...). + first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 각 변 + 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 + data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: + 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않습니다. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: first_frame만, 정확히 1개. 이 표기들은 + 첫 프레임을 img_url이 아니라 여기에서 받습니다. 최소 300x300 픽셀, 가로세로 비율 + 1:2.5에서 2.5:1 사이, JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만 해당하며 1~9개입니다. - 이것이 이 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, - JPEG/JPG/PNG/WEBP, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. - reference_video는 이 연산의 입력 유형이 아닙니다. -- happyhorse-1.0-video-edit: video(정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, - 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5 ~ 2.5:1, - 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않음)와 - 선택적 0~5개의 reference_image(JPEG/JPG/PNG/BMP/WEBP, 최소 300x300 픽셀, - 가로세로 비율 1:2.5 ~ 2.5:1, 최대 20MB, 공개 URL 또는 - data:\{MIME_type};base64,... URL). +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: reference_image만, 1~9개. 이것이 이 + 모델의 유일한 참조 입력입니다. 최단 변 최소 400 픽셀, JPEG/JPG/PNG/WEBP, + 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. 이 연산에서 + reference_video는 입력 type이 아닙니다. +- happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, + 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, + 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음)와 선택적인 + 0~5개의 reference_image (JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 + 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: - 텍스트 기반 비디오 생성 연산입니다. 이들의 파트너 참조 문서에는 미디어 입력이 - 문서화되어 있지 않으므로 이 필드를 설정하지 마세요. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기법들에 대한 - 미디어 어휘를 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 + 텍스트 기반 비디오 생성 연산. 이들의 파트너 참조 문서에는 미디어 입력이 문서화되어 + 있지 않으므로 이 필드는 설정하지 않은 채로 둡니다. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대한 + media 어휘를 열거하지 않습니다. wan2.5-i2v-preview 및 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마의 제약이 아니라 파트너의 제약입니다. 허용되는 유형과 -그 상한이 모델마다 다르기 때문에 media에는 minItems/maxItems가 선언되어 있지 -않습니다. 스키마가 허용한다고 해서 공급자가 허용하는 것은 아닙니다. 반대로, 위의 -에셋별 "최대 20MB" 수치는(이미지 입력에 대한 상한이며, 인라인으로 전송될 수 있는 -유일한 입력입니다) 파트너가 최종적으로 받는 에셋에 대한 파트너의 상한이며, 해당 -에셋이 공개 URL일 때는 그대로 적용됩니다. 그 바이트는 Comfy를 거치지 않기 -때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치며 전송 상한도 -적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 -응답되고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 초과하는 단일 인라인 -에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서는 단일 에셋이 -파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 적용됩니다. 여러 에셋에 걸치면 전송 상한이 적용되는데, 100 MiB Router 상한이 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 값은 공개 URL로 전송하세요. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 +minItems/maxItems가 선언되어 있지 않은데, 허용되는 type과 그 상한이 모델마다 +다르기 때문입니다. 스키마가 받아들인다고 해서 공급자가 받아들인다는 뜻은 아닙니다. +그리고 반대 방향으로, 위의 에셋별 "최대 20MB" 수치는 이미지 입력, 즉 인라인으로 +전송될 수 있는 유일한 입력에 대한 상한이며, 파트너가 최종적으로 갖게 되는 에셋에 +대한 상한이고, 에셋이 공개 URL일 때는 그 바이트가 Comfy를 거치지 않으므로 쓰인 +그대로 적용됩니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치며 전송 +상한도 만납니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 넘으면 +413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 +인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 +파트너 자체의 단일 에셋이20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 보내세요. @@ -306,40 +306,36 @@ media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. - 미디어 파일의 URL: 공개 HTTP/HTTPS URL 또는, 위의 `media` 설명이 각 모델에 대해 나열한 바로 그 IMAGE 입력(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 video, audio, file 또는 link 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스의 oss://dashscope-instant 임시 URL 또는 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에 대해서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 노출하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그러한 값은 여기서 거부되지 않고 파트너에게 그대로 전달됩니다. 모델별 크기 및 픽셀 제한과 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한에 대해서는 `media` 설명을 참조하세요. + 미디어 파일의 URL입니다. 공개 HTTP/HTTPS URL이거나, 위 `media` 설명이 각 모델에 대해 나열한 바로 그 IMAGE 입력들(wan2.7-i2v의 first_frame과 last_frame, wan2.7-r2v의 first_frame과 reference_image, wan2.7-videoedit의 reference_image, wan3.0-video와 wan3.0-video-prime의 first_frame, last_frame, reference_image, happyhorse-1.0-i2v와 happyhorse-1.1-i2v의 first_frame, happyhorse-1.0-r2v와 happyhorse-1.1-r2v의 reference_image, happyhorse-1.0-video-edit의 reference_image)에 한해서는 인라인 `data:{MIME_type};base64,...` URL입니다. 이 모델들 중 어느 것도 비디오, 오디오, 파일 또는 링크 입력에 인라인 data: URL을 받지 않습니다. 파트너 자체 업로드 서비스가 발급하는 oss://dashscope-instant 임시 URL이나 (wan2.7-videoedit의 경우) Asset Center asset_id는 이를 업로드한 Alibaba Cloud 계정에서만 해석됩니다. Comfy는 자체 키로 모델을 호출하며 업로드 경로를 제공하지 않으므로, 호출자 자신의 oss:// URL이나 asset_id는 지원되는 입력이 아닙니다. 이 필드는 URL 스킴을 검증하지 않으므로, 그런 값은 여기서 거부되지 않고 그대로 파트너에게 전달됩니다. 모델별 크기 및 픽셀 제한과, 인라인 페이로드를 총체적으로 제한하는 100 MiB Router 요청 본문 상한은 `media` 설명을 참고하세요. - 역방향 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다 + 네거티브 프롬프트 단어는 비디오 화면에서 보고 싶지 않은 콘텐츠를 설명하는 데 사용됩니다. 500자를 넘으면 wan 모델은 이를 거부하지 않고 잘라냅니다. prompt와 동일한 입력 예산에 포함됩니다. - 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원하며 길이는 800자를 초과할 수 없습니다 -(wan3.0-video의 경우 최대 20,000자이며, 한도를 초과하는 콘텐츠는 잘립니다). -여러 참조 비디오를 사용하는 wan2.6-r2v의 경우 'character1', 'character2' 등을 사용해 -참조 비디오 순서대로 피사체를 지칭하세요. 예: "Character1 sings on the roadside, Character2 dances beside it" -wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사용해 -media 배열 내 해당 순서의 미디어 에셋을 지칭하세요. + 텍스트 프롬프트 단어입니다. 중국어와 영어를 지원합니다. wan3.0-video와 wan3.0-video-prime은 최대 +20,000자까지 받습니다. media 배열 내 해당 순서의 미디어 에셋을 지칭하려면 'Image 1', 'Video 1', 'Audio 1' 등을 사용하세요. - wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1~3개의 비디오 URL 배열입니다. -입력 제한: + wan2.6-r2v 모델 전용 참조 비디오 URL입니다. 1-3개의 비디오 URL 배열입니다. +입력 제한 사항: - 형식: mp4, mov -- 개수: 비디오 1~3개 -- 비디오 1개 길이: 2~30초 -- 파일 1개 크기: 최대 30MB +- 수량: 비디오 1-3개 +- 단일 비디오 길이: 2-30초 +- 단일 파일 크기: 최대 30MB - audio_url과 함께 사용할 수 없습니다 -참조 재생 시간: 비디오 1개는 최대 5초, 비디오 2개는 각각 최대 2.5초, 비디오 3개는 그에 비례해 더 짧습니다. +참조 재생 시간: 비디오 1개는 최대 5초, 2개는 각각 최대 2.5초, 3개는 그에 비례해 더 짧습니다. 과금: 실제 사용된 참조 재생 시간을 기준으로 합니다. - 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용 시 prompt 파라미터는 무시됩니다. + 비디오 효과 템플릿 이름입니다. 선택 사항입니다. 현재 지원: squish, flying, carousel. 사용하면 prompt 파라미터는 무시됩니다. - 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약되지 않습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략합니다. `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis`에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 허용되는 표기법의 enum은 해당 오퍼레이션 자체의 컴포넌트인 `WanVideoGenerationRequest`에 있습니다. + 호출할 모델의 ID입니다. 이 컴포넌트에서는 제약이 없습니다. Comfy Router가 `POST /v2/models/wan/{model}`의 `{model}` 경로 세그먼트에서 채우므로 Router 호출자는 이를 생략합니다. @@ -347,25 +343,25 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭하세요. - 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 그러한 전환을 문서화하지 않습니다. + 비디오에 오디오를 추가할지 여부입니다. wan3.0-video와 wan3.0-video-prime에서만 지원되며, 공급자는 다른 wan 모델에 대해서는 이러한 전환을 문서화하지 않았습니다. wan2.7-videoedit 모델의 비디오 오디오 설정입니다. -- auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단합니다 +- auto (기본값): 모델이 prompt 콘텐츠를 기반으로 지능적으로 판단합니다 - origin: 입력 비디오의 원본 오디오를 강제로 보존합니다 가능한 값: `auto`, `origin` - 생성되는 비디오의 재생 시간(초)입니다: + 생성되는 비디오의 재생 시간(초)입니다. - wan2.5 모델: 5초 또는 10초 - wan2.6-t2v, wan2.6-i2v: 5초, 10초 또는 15초 -- wan2.6-r2v: 5초 또는 10초만 (15초 미지원) +- wan2.6-r2v: 5초 또는 10초만 가능(15초 미지원) - wan2.7-i2v, wan2.7-t2v: [2, 15] 범위의 정수 - wan2.7-r2v, wan2.7-videoedit: [2, 10] 범위의 정수 -- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수이며, 비디오 입력이 있으면 총 +- wan3.0-video: 비디오 입력이 없으면 [2, 30] 범위의 정수, 비디오 입력이 있으면 총 입력 비디오 재생 시간 + 출력 비디오 재생 시간이 30초를 초과할 수 없습니다. -1은 모델이 적절한 재생 시간을 선택하는 스마트 재생 시간 모드를 활성화합니다 이 프록시는 [-1, 30] 범위를 벗어난 재생 시간에 대해 400을 반환합니다. @@ -378,36 +374,38 @@ media 배열 내 해당 순서의 미디어 에셋을 지칭하세요. - 생성되는 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. -wan2.7 모델의 경우 제공하지 않으면 해상도 등급을 기준으로 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 -비율을 자동으로 추천합니다. + 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. +wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. +wan3.0-video의 경우 adaptive(기본값)는 입력 미디어의 비율과 의도에 따라 +적절한 화면 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 해상도 등급입니다. 지원되는 값은 모델에 따라 다릅니다: + 해상도 등급입니다. 지원되는 값은 모델마다 다릅니다: - wan2.5-i2v-preview: 480P, 720P, 1080P -- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 (480P 미지원) -- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P (기본값 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (업스트림 기본값 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. resolution 등급이 청구 요금을 결정하기 때문입니다. 이 프록시는 resolution을 검사하기 전에 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 enum 밖의 값에 대해서는 400을 반환하고, 위에 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(resolution으로 보내든 480P size로 보내든)에 대해서도 400을 반환합니다. +- wan2.6 모델(t2v, i2v, r2v): 720P, 1080P만 지원(480P 미지원) +- wan2.7 모델(i2v, t2v, r2v, videoedit): 720P, 1080P(기본값 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(업스트림 기본값 1080P) +- happyhorse-1.0-*(t2v, i2v, r2v, video-edit): 720P, 1080P +- happyhorse-1.1-*(t2v, i2v, r2v): 480P, 720P, 1080P +이 프록시는 해상도도 size도 제공하지 않는 비디오 생성 요청을 거부합니다. +해상도 등급이 과금 요율을 선택하기 때문입니다. 이 프록시는 확인 전에 +해상도를 대문자로 변환하고 대문자로 변환된 값을 전달하며, 400을 반환합니다이 enum 밖의 값에 대해서는 거부하며, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 전송하든 480P 크기로 전송하든)에 대해 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` - 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용하는 난수 시드 + 무작위 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 범위: `0` ~ `2147483647` - 지능형 멀티 렌즈 제어입니다. prompt_extend가 활성화된 경우에만 동작합니다. -wan2.6 및 wan2.7-r2v 모델용입니다. + 지능형 멀티 렌즈 제어. prompt_extend가 활성화된 경우에만 동작합니다. +wan2.6 및 wan2.7-r2v 모델용. - single: 단일 샷 비디오 (기본값) - multi: 멀티 샷 비디오 @@ -415,19 +413,21 @@ wan2.6 및 wan2.7-r2v 모델용입니다. - width*height 형식의 비디오 resolution입니다. 지원되는 resolution은 모델마다 다릅니다: -wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P size + width*height 형식의 비디오 해상도. 지원되는 해상도는 모델에 따라 다릅니다: +wan2.5 T2V: 480P (480*832, 832*480, 624*624), 720P, 1080P 크기 wan2.6 T2V/R2V (480P 없음): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P size는 resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. +size와 resolution을 모두 전송하는 경우 size가 청구 등급을 선택하며, +resolution은 여전히 이 프록시가 해당 모델에 대해 허용하는 값이어야 합니다. 480P 크기는 +resolution 설명에서 480P가 없다고 나열한 모든 모델에서 400을 반환합니다. - 워터마크 로고를 추가할지 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 + 워터마크 로고 추가 여부이며, 워터마크는 오른쪽 아래 모서리에 위치합니다 -`GET /v2/models/wan/wan3.0-video/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/wan/wan3.0-video/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -436,11 +436,11 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 지능형 재작성 이후의 실제 프롬프트 (비디오 작업) + 지능형 재작성 후 실제 프롬프트 (비디오 작업용) - 오디오 생성이 포함된 I2V 작업의 오디오 URL + 오디오 생성을 포함한 I2V 작업의 오디오 URL @@ -456,7 +456,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 원본 입력 프롬프트 (비디오 작업) + 원본 입력 프롬프트 (비디오 작업용) @@ -464,7 +464,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 지능형 재작성 이후의 실제 프롬프트 (활성화된 경우) + 지능형 재작성 후 실제 프롬프트 (활성화된 경우) @@ -530,7 +530,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 비디오 해상도 레벨 (I2V 및 wan3.0-video 작업) + 비디오 해상도 수준 (I2V 및 wan3.0-video 작업) @@ -578,7 +578,7 @@ size와 resolution을 모두 보내면 size가 청구 등급을 선택하며, re - 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 넘어가기 전에 이 값을 먼저 확인하세요. + 실패한 요청에 대한 상세 정보로, `output` 아래가 아니라 응답 envelope의 ROOT에 보고됩니다 (요청이 성공하면 반환되지 않음). `output.message`로 대체하기 전에 이 값을 확인하세요. ## 예시 diff --git a/ko/development/comfy-router/providers.mdx b/ko/development/comfy-router/providers.mdx index 7f4991793b..a53b7e93da 100644 --- a/ko/development/comfy-router/providers.mdx +++ b/ko/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 서빙 공급자" sidebarTitle: "서빙 공급자" description: "각 Comfy Router 모델을 서빙할 수 있는 공급자와 대체 공급자를 선택하는 방법을 확인합니다." -translationSourceHash: fb34b140 +translationSourceHash: 2e5f5f1e translationFrom: development/comfy-router/providers.mdx --- @@ -20,7 +20,7 @@ translationFrom: development/comfy-router/providers.mdx | [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | | [Gemini 2.5 Flash Image](/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | ✓ | - | - | - | - | | [Gemini Nano Banana 2.1](/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | ✓ | - | - | - | - | -| [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | - | ✓ | +| [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | | [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | | [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | | [Kling 3.0 Turbo](/ko/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index 240fc4a100..6c8bb4f029 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 的能力与限制" sidebarTitle: "能力与限制" description: "选择 Comfy Router 还是合作伙伴代理,为长时间运行的调用做好规划,并了解恢复、速率限制与资产存储。" -translationSourceHash: 691c2e79 +translationSourceHash: fbb54868 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": 2b25596f + "Models without a pre-flight estimate": cca3ca82 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -29,6 +29,7 @@ translationBlockHashes: + Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个已排队的请求运行:你提交请求,稍后再收集结果。当你的应用能够等待一个已完成的结果,或稍后收集结果,并且能够处理模型自身的输入和输出字段时,就使用它。 ## Router 支持的功能 @@ -122,6 +123,7 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` +- **minimax**: `minimax/minimax-gpt-image-2` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx index 050962e024..e8027b0224 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,12 +2,12 @@ title: "将 GPT Image 2 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 openai/gpt-image-2:端点、请求结构,以及 Router 返回的响应。" sidebarTitle: "GPT Image 2" -translationSourceHash: b9cb8af5 +translationSourceHash: 2fe15764 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 - "Serving providers": 56df172f + "Serving providers": f3930e40 "Schema": 4e6e5e53 "Examples": c73859ec --- @@ -18,6 +18,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -159,10 +160,11 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2/requests/$REQUEST_ID \ ## 服务提供商 -除非请求中指定了其他提供商,否则此模型由 Comfy Router 直接提供服务。以下提供商也在同一端点上、使用相同的模型 ID 提供该模型,通过 `model_provider` 查询参数来选择。 +除非请求中指定了其他提供商,否则此模型由 Comfy Router 直接提供服务。以下提供商也在同一端点上、使用相同的模型 ID 提供该模型,并通过 `model_provider` 查询参数进行选择。 - **Comfy**(默认):`POST https://api.comfy.org/v2/models/openai/gpt-image-2` - **fal**,以 `fal/fal-gpt-image-2` 的形式:`POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=fal` +- **MiniMax**,以 `minimax/minimax-gpt-image-2` 的形式:`POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=minimax` - **Pika**,以 `pika/pika-gpt-image-2` 的形式:`POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=pika` - **Runware**,以 `runware/runware-gpt-image-2` 的形式:`POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=runware` - **WaveSpeed**,以 `wavespeed/wavespeed-gpt-image-2` 的形式:`POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=wavespeed` diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index 73dcbd096a..75d8888825 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 HappyHorse 1.0 T2V" description: "通过 Comfy Router 以 HTTP 调用 wan/happyhorse-1.0-t2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果结构" sidebarTitle: "HappyHorse 1.0 T2V" -translationSourceHash: f4e2958a +translationSourceHash: a87b2e81 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx translationBlockHashes: "_intro": b98773c2 "Quick start": b4282abb - "Schema": 83267e64 + "Schema": e48d60d6 "Examples": 12f77722 --- + {/* 生成文件。请编辑此目录中的 code.yaml 并运行 `pnpm code-pages:gen`。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -186,71 +187,65 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID - 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 - 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型为必填。happyhorse-1.x i2v 写法不在此处接收其首帧:它们将其作为类型为 first_frame 的媒体元素接收(见下方 media),而在 wan2.6-i2v 上能够成功的 img_url 请求体,会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 写法同样在 media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 写法不在此处接收首帧:它们将首帧作为类型为 first_frame 的媒体元素接收(参见下方的 media);并且在 wan2.6-i2v 上能够成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;此外 wan2.7/wan3.0 的写法也把参考资产放在 media 中。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。该字段由此组件服务的所有模型共享,而某个模型接受哪些 type 值,以及它是否将图像或视频输入放在此处而不是放在 img_url 或 reference_video_urls 中,都因模型而异。各模型支持的 type 值如下: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公开 HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,且参考图像加参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开 HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-videoedit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL)加上可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序定义提示中资产的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公开 HTTP/HTTPS URL;不接受内联 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法在此处接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。 + 媒体资产列表。为视频生成指定参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。该字段由本组件提供的所有模型共用,而某个模型接受哪些 type 值,以及它的图像或视频输入究竟放在此处、还是放在 img_url 或 reference_video_urls 中,均因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 与 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)与 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公开 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,且参考图像加参考视频总共最多 5 个。first_frame 与 reference_image:JPEG/JPG/PNG/BMP/WEBP(无 alpha 通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 同时使用)、link(最多 1 个,不能与 file 同时使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定提示词中资产的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 与 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 与 link:公开 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法在此处接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。 - happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,3-60 秒,较长边最大 4096 像素,较短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL)加上可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其对应的合作伙伴参考文档未记录任何媒体输入,因此请保持此字段未设置。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些写法枚举任何媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上述各模型的数量是合作伙伴的限制,而不是本 schema 的限制:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受;反过来说,上述每个资产“最大 20MB”的数字(图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终获得的资产所设的上限,当资产是公开 URL 时,它们按字面适用,因为这些字节从不经过 Comfy。内联 data:\{MIME_type};base64,... URL 确实经过 Comfy,并且同样会遇到传输上限:Comfy Router POST 请求体总计上限为 100 MiB,超过则返回 413,而 base64 会使载荷膨胀约 4/3,因此单个超过约 75 MB 的内联资产会在触及此处任何合作伙伴规则之前就被拒绝。在该大小下,单个资产处于合作伙伴自身的 -20MB 上限可以轻松容纳内联数据,因此对于单个资产而言,起约束作用的是合作伙伴的规则; -而涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是 -整个请求,而不是每个元素。凡是接近这些上限的内容,请以公共 URL 的形式发送。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其对应的合作伙伴参考文档未记录任何媒体输入,因此请勿设置此字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件没有为这些写法枚举任何媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 +上文中各模型的数量是合作伙伴的约束,而不是本 schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不意味着提供商接受;反过来,上文每项资产“最大 20MB”的数值(这是图像输入的上限,也是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产设定的上限,当资产是公开 URL 时,这些数值按字面生效,因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... URL 确实会经过 Comfy,同时还要满足一项传输层上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413;而 base64 会使载荷膨胀约 4/3,因此单个内联资产超过约 75 MB 时,会在触达此处的任何合作伙伴规则之前就被拒绝。在这种大小下,单个资产按合作伙伴自身的20MB 的上限可以轻松容纳内联数据,因此单个资产受合作伙伴规则约束;而多个资产则受传输上限约束,因为 100 MiB 的 Router 上限限制的是整个请求,而不是每个元素。任何接近这些上限的内容,请以公共 URL 的形式发送。 媒体资产类型 - 可能值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者(仅限上文 `media` 描述为每个模型列出的那些 IMAGE 输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image)一个内联 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不提供任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。该字段不校验 URL scheme,因此此类值会原样转发给合作伙伴,而不会在此处被拒绝。有关各模型的大小与像素限制,以及从整体上约束内联载荷的 100 MiB Router 请求体上限,请参阅 `media` 描述。 + 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者,对于上文 `media` 描述中为各模型列出的那些图像输入(wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image),一个内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只会在上传它的那个阿里云账号下解析;Comfy 使用自己的密钥发起模型调用,并且不提供上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL 协议,因此这类值会原样转发给合作伙伴,而不会在此处被拒绝。有关按模型区分的大小与像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中出现的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符时,wan 模型会截断它,而不是拒绝请求。它与 prompt 计入相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等按参考视频的顺序 -引用主体。示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等按 media 数组中的 -对应顺序引用媒体资产。 + 文本提示词。支持中文和英文。超过各自文档规定的长度时,wan2.x 模型会截断提示词,而不是拒绝请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。当 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符)时,提供商会拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带有多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 的参考模式,请按 media 数组中相应的顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。包含 1-3 个视频 URL 的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 - 单个视频时长:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例更短。 -计费:按实际使用的参考时长计算。 +参考时长:单个视频最长 5s,两个视频各最长 2.5s,三个视频按比例更短。 +计费:根据实际使用的参考时长计算。 - 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。该组件上不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。在此组件上不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它,因此 Router 调用方会省略它。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供它,可接受的拼写枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -258,27 +253,26 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商没有为其他 wan 模型记录此类开关。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型提供此类开关。 - wan2.7-videoedit 模型的视频音频设置。 + 视频音频设置,适用于 wan2.7-videoedit 模型。 - auto(默认):模型根据提示词内容智能判断 - origin:强制保留输入视频的原始音频 - 可能值:`auto`、`origin` + 可能的值:`auto`、`origin` - 生成视频的时长,单位为秒: + 生成视频的时长,以秒为单位: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 - wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) - wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 - wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长 - 不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -本代理在时长超出 [-1, 30] 时返回 400。 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +此代理对超出 [-1, 30] 的 duration 返回 400。 范围:`-1` 到 `30` @@ -288,56 +282,54 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID - 生成视频的画面比例。仅适用于 wan2.7 和 wan3.0 模型。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,如果未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐 -合适的画面比例。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的基于输入媒体的比例与意图确定宽高比。 - 可能值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` - 分辨率档位。支持的取值因模型而异: + 分辨率档位。支持的值因模型而异: - wan2.5-i2v-preview:480P、720P、1080P - wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P -该代理会拒绝既未提供分辨率、也未提供尺寸的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将分辨率转换为大写,并转发转换后的大写值;对于超出该枚举范围的取值返回 400;对于上文列出的、不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,无论 480P 是以分辨率还是以 480P 尺寸的形式发送,都会返回 400。 +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在校验之前将 resolution 转为大写并转发大写后的值,对超出该枚举范围的值返回 400,并且对于上述被列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,传入 480P(无论是以 resolution 还是以 480P 的 size 形式传入)也会返回 400。 - 可选值:`480P`、`720P`、`1080P` + 可能的值:`480P`、`720P`、`1080P` 随机数种子,用于控制模型生成内容的随机性 - 取值范围:`0` 至 `2147483647` + 范围:`0` 到 `2147483647` - 智能多镜头控制。仅在启用 prompt_extend 时生效。 -适用于 wan2.6 和 wan2.7-r2v 模型。 + 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 - single:单镜头视频(默认) - multi:多镜头视频 - 可选值:`multi`、`single` + 可能的值:`multi`、`single` - 视频分辨率,格式为宽*高。支持的分辨率因模型而异: -wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -wan2.6 T2V/R2V(无 480P): + 视频分辨率,格式为 width*height。支持的分辨率因模型而异: +对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +对于 wan2.6 T2V/R2V(无 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时发送尺寸和分辨率时,由尺寸决定计费档位,而分辨率仍必须是该代理为该模型接受的值。对于分辨率描述中列出不支持 480P 的每个模型,发送 480P 尺寸都会返回 400。 +当同时传入 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是本代理对该模型接受的值。对于分辨率描述中列为不支持 480P 的每个模型,传入 480P 的 size 都会返回 400。 是否添加水印 logo,水印位于右下角 -根据 Router 在 `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前 Router 用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/wan/happyhorse-1.0-t2v/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用时所依据的同一份文档。 ### 输出 @@ -350,11 +342,11 @@ wan2.6 T2V/R2V(无 480P): - 带音频生成的 I2V 任务的音频链接 + 带音频生成的 I2V 任务的音频 URL - 失败请求的错误码(请求成功时不会返回) + 失败请求的错误码(请求成功时不返回) @@ -362,7 +354,7 @@ wan2.6 T2V/R2V(无 480P): - 失败请求的详细信息(请求成功时不会返回) + 失败请求的详细信息(请求成功时不返回) @@ -370,7 +362,7 @@ wan2.6 T2V/R2V(无 480P): - 图像生成任务的任务结果列表 + 图像生成任务的结果列表 @@ -390,7 +382,7 @@ wan2.6 T2V/R2V(无 480P): - 已生成图像的网址 + 已生成图像的 URL 地址 @@ -406,7 +398,7 @@ wan2.6 T2V/R2V(无 480P): - 图像生成任务的任务结果统计 + 图像生成任务的结果统计 @@ -424,11 +416,11 @@ wan2.6 T2V/R2V(无 480P): 任务状态 - 可选值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频链接。链接有效期为 24 小时 + 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 @@ -456,7 +448,7 @@ wan2.6 T2V/R2V(无 480P): - 输入视频的时长,单位为秒,无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) @@ -484,11 +476,11 @@ wan2.6 T2V/R2V(无 480P): - 失败请求的错误码,报告在信封的根层级而不是 `output` 下(请求成功时不会返回)。 + 失败请求的错误码,位于响应信封的根层级而非 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,报告在信封的根层级而不是 `output` 下(请求成功时不会返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,位于响应信封的根层级而非 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先读取此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index bc99a669f2..356e7d54e3 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -2,17 +2,18 @@ title: "使用 Comfy Router 调用 HappyHorse 1.0 Video Edit" description: "通过 Comfy Router 以 HTTP 方式调用 wan/happyhorse-1.0-video-edit 的 Python、TypeScript 和 cURL 代码片段,以及请求字段与结果结构" sidebarTitle: "HappyHorse 1.0 视频编辑" -translationSourceHash: 138e4d49 +translationSourceHash: b9922c80 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx translationBlockHashes: "_intro": 3a4cf59c "Quick start": 140976d2 - "Schema": bd0494a3 + "Schema": a762284e "Examples": a41df668 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -205,104 +206,101 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-video-edit/requests/$REQ - 音频文件下载链接。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 + 音频文件的下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 - 首帧图像网址或 Base64 编码数据。对于 wan2.5-i2v-preview 和 wan2.6-i2v -模型为必填。happyhorse-1.x i2v 拼写不在此处传入首帧:它们以类型为 -first_frame 的 media 元素传入首帧(见下方 media),并且在 wan2.6-i2v 上成功的 -img_url 请求体会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;而 -wan2.7/wan3.0 拼写同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 + 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x i2v 写法 +不在此处接收首帧 +-- 它们将其作为类型为 first_frame 的媒体元素接收(参见下方的 media),并且在 +wan2.6-i2v 上能够成功的 img_url 请求体,会被提供商在 +happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝 -- 而 wan2.7/wan3.0 的写法也把其 +参考资产放在 media 中。图像格式:JPEG、JPG、PNG、BMP、WEBP。 分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 -一个 type 和一个 url 字段。此字段由该组件所服务的所有模型共用,而某个给定模型 -接受哪些 type 值(以及它究竟是在此处还是在 img_url 或 reference_video_urls 中 -传入其图像或视频输入)都因模型而异。各模型支持的 type 值如下: + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含一个 type 字段和一个 url 字段。此字段由此组件提供的所有 +模型共用,而某个模型接受哪些 type 值 -- 以及它究竟是在此处还是在 img_url 或 +reference_video_urls 中携带其图像或视频输入 -- 因模型而异。各模型支持的 type 值如下: - wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 - 到 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。 + last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比介于 1:8 + 与 8:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公开 HTTP/HTTPS URL;不接受内联 - data: URL。 + 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS 网址;不接受内联 + data: 网址。 - wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要 1 个 reference_image 或 reference_video,且参考图像加上 - 参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 - 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开 - HTTP/HTTPS URL;不接受内联 data: URL。 + 需要 1 个 reference_image 或 reference_video,并且参考图像加上 + 参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP + (无透明度通道),每边 240-8000 像素,宽高比介于 1:8 与 8:1 之间,最大 + 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开 + HTTP/HTTPS 网址;不接受内联 data: 网址。 - wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL), - 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL - 或 data:\{MIME_type};base64,... URL)。 + 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: + 网址)加上可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比介于 1:8 与 8:1 之间,最大 20MB,公开网址 + 或 data:\{MIME_type};base64,... 网址)。 - wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link - 同时使用)、link(最多 1 个,不能与 file 同时使用)。reference_*/file/link 类型 - 与 first_frame/last_frame 类型在同一请求中互斥。数组顺序定义了提示中 - 资产的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 - reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 - 8:1,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。 - reference_video、reference_audio、file 和 link:公开 HTTP/HTTPS URL;不接受内联 - data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写 - 在此处传入其首帧,而不是在 img_url 中传入。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开 URL 或 - data:\{MIME_type};base64,... URL。 + reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 + link 同时使用)、link(最多 1 个,不能与 file 同时使用)。reference_*/file/link 类型 + 与 first_frame/last_frame 类型在同一请求中互斥。数组 + 顺序决定提示词中资产的参考顺序(Image 1、Video 1、 + Audio 1、...)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可以是公开网址或 + data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link: + 公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法 + 在此处接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 + 介于 1:2.5 与 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开网址或 + data:\{MIME_type};base64,... 网址。 - happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video + 最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video 不是此操作的输入类型。 - happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 - 之间,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: - URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公开 URL - 或 data:\{MIME_type};base64,... URL)。 + 秒,较长边最大 4096 像素,较短边至少 360 像素,宽高 + 比介于 1:2.5 与 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: + 网址)加上可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 + 300x300 像素,宽高比介于 1:2.5 与 2.5:1 之间,最大 20MB,公开网址 + 或 data:\{MIME_type};base64,... 网址)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其合作伙伴参考文档未记录任何 media 输入,因此请勿设置 - 此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些拼写列举任何 media - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入其首帧; - wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 -上述各模型的计数是合作伙伴的限制,而非本 Schema 的限制:media 上未声明 -minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受 -并不意味着提供商接受;反过来说,上述每项资产“最多 20MB”的数值(即图像 -输入的上限,也是唯一可以内联发送的输入)是合作伙伴对其最终获得的 -资产所设的上限,当资产是公开 URL 时,这些限制按字面适用, + 文生视频操作。它们的合作伙伴参考文档未记录任何媒体输入,因此请将此字段 + 保持未设置状态。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些写法枚举任何媒体 + 词表。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首 + 帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 +上文中各模型的数量是合作伙伴的约束,而不是此 schema 的约束:media 上未声明 +minItems/maxItems,因为可接受的类型及其上限 +因模型而异。schema 接受并不意味着提供商接受 -- 而反过来, +上文每项资产“最大 20MB”的数值 -- 即图像 +输入的上限,也是唯一可以内联发送的输入 -- 是合作伙伴对其最终获得的 +资产所设的上限,且当该资产是公开网址时这些数值按字面适用, 因为这些字节从不经过 Comfy 传输。内联的 data:\{MIME_type};base64,... -URL 则会经过 Comfy 传输,并且同样会遇到传输上限:Comfy Router -POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 -负载增大约 4/3,因此单个内联资产超过约 75 MB 就会在任何 -此处所列的合作伙伴规则生效之前被拒绝。在该大小下,单个资产在合作伙伴自身的 -20MB 上限可以轻松容纳内联数据,因此对单个资产而言,起约束作用的是合作伙伴规则;而当涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容都应以公共 URL 形式发送。 +网址确实会经过 Comfy 传输,并且还会遇到传输上限:Comfy Router 的 +POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 +载荷膨胀约 4/3,因此单个内联资产若超过大约 75 MB,会在触及此处任何 +合作伙伴规则之前就被拒绝。在该大小下,单个资产处于合作伙伴自身的20MB 上限可以轻松容纳内联数据,因此对单个资产而言,真正起约束作用的是合作伙伴规则。若涉及多个资产,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。任何接近这些上限的内容,请以公共 URL 的形式发送。 媒体资产类型 - 可能的值:`first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - 媒体文件的 URL:公共 HTTP/HTTPS URL,或(仅针对上文 `media` 描述为每个模型确切列出的图像输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image)内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能在上传它的阿里云账号下解析;Comfy 使用自身的密钥发起模型调用,且不暴露任何上传路由,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不验证 URL 方案,因此此类值会按原样转发给合作伙伴,而不会在此处被拒绝。有关每个模型的大小和像素限制,以及从总体上约束内联负载的 100 MiB Router 请求体上限,请参阅 `media` 描述。 + 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者(仅限上文 `media` 描述中为每个模型列出的那些 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)一个内联的 `data:{MIME_type};base64,...` URL。在这些模型上,任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能针对上传它的阿里云账号解析;Comfy 使用自己的密钥发起模型调用,且不提供任何上传途径,因此调用方自有的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此这类值会原样转发给合作伙伴,而不会在此处被拒绝。关于各模型的大小与像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中看到的内容 + 反向提示词用于描述你不希望在视频画面中出现的内容。超过 500 个字符时,Wan 模型会截断它,而不是拒绝该请求。它与 prompt 计入同一输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,按参考视频的顺序使用 'character1'、'character2' 等来指代主体。 -示例:“Character1 sings on the roadside, Character2 dances beside it” -对于 wan3.0-video 参考模式,使用 'Image 1'、'Video 1'、'Audio 1' 等来指代 media 数组中 -对应顺序的媒体资产。 + 文本提示词。支持中文和英文。超过其各自文档记载的长度时,wan2.x 模型会截断提示词,而不是拒绝该请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。若提示词与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个汉字),提供商将拒绝该请求,返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等,按参考视频的顺序指代其中的主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,按 media 数组中对应的顺序指代媒体资产。 @@ -310,19 +308,19 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 -- 单个视频时长:2-30 秒 +- 单个视频长度:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最大 5 秒,两个视频各最大 2.5 秒,三个视频按比例相应更短。 -计费:基于实际使用的参考时长。 +参考时长:单个视频最大 5s,两个视频各最大 2.5s,三个视频按比例更短。 +计费:按实际使用的参考时长计费。 - 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 - 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它,因此 Router 调用方会将其省略。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受拼写的枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不受约束:Comfy Router 从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供,可接受的拼写枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -330,26 +328,26 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记录此类切换。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;对于其他 Wan 模型,提供商未记载此类开关。 wan2.7-videoedit 模型的视频音频设置。 - auto(默认):模型根据提示词内容智能判断 -- origin:强制保留输入视频的原始音频 +- origin:强制保留输入视频中的原始音频 - 可能的值:`auto`, `origin` + 可能的值:`auto`、`origin` - 已生成视频的时长,单位为秒: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频时长 + 输出视频时长总计不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -此代理在时长超出 [-1, 30] 范围时返回 400。 +- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) +- wan2.7-i2v、wan2.7-t2v:[2, 15] 区间内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 区间内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 区间内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +此代理对 [-1, 30] 范围之外的时长返回 400。 范围:`-1` 到 `30` @@ -359,25 +357,24 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 已生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,如果未提供,则根据分辨率档位设置默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐 -合适的宽高比。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,未提供时根据分辨率档位取默认值。 +对于 wan3.0-video,adaptive(默认)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 - 可能的值:`adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` - 分辨率级别。支持的值因模型而异: -- wan2.5-i2v-preview:480P、720P、1080P + 分辨率档位。支持的取值因模型而异: +- wan2.5-i2v-preview: 480P、720P、1080P - wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上游默认 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P, 1080P -- happyhorse-1.1-*(t2v、i2v、r2v):480P, 720P, 1080P -该代理会拒绝既未提供分辨率、也未提供尺寸的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将分辨率转为大写,并转发大写后的值;对于不在该枚举中的值返回 400;对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,传入 480P(无论是作为分辨率传入,还是作为 480P 的尺寸传入)都会返回 400。 +- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定了计费费率。它在检查之前会先将 resolution 转为大写,并转发大写后的值;对于不在该枚举范围内的值返回 400;对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,返回 400(无论是以 resolution 还是以 480P 的 size 形式发送)。 - 可选值:`480P`, `720P`, `1080P` + 可选值:`480P`、`720P`、`1080P` @@ -387,30 +384,27 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 智能多镜头控制。仅在启用 prompt_extend 时生效。 -适用于 wan2.6 和 wan2.7-r2v 模型。 + 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 - single: 单镜头视频(默认) - multi: 多镜头视频 - 可选值:`multi`, `single` + 可选值:`multi`、`single` 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: -对于 wan2.5 T2V:480P(480*832, 832*480, 624*624)、720P、1080P 尺寸 +对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 对于 wan2.6 T2V/R2V(无 480P): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -当同时传入尺寸和分辨率时,由尺寸决定计费档位,而 -分辨率仍必须是该代理为相应模型接受的值。对于分辨率描述中 -列为不支持 480P 的每个模型,传入 480P 的尺寸都会返回 400。 + 720P: 1280*720、720*1280、960*960、1088*832、832*1088 + 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是本代理对该模型接受的取值。对于分辨率描述中列为不支持 480P 的每个模型,480P 的 size 都会返回 400。 是否添加水印 logo,水印位于右下角 -根据 Router 在 `GET /v2/models/wan/happyhorse-1.0-video-edit/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/wan/happyhorse-1.0-video-edit/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用时所依据的同一份文档。 ### 输出 @@ -419,7 +413,7 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 智能改写后的实际提示词(用于视频任务) + 智能改写后的实际提示词(视频任务) @@ -439,7 +433,7 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 原始输入提示词(用于视频任务) + 原始输入提示词(视频任务) @@ -447,7 +441,7 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 智能改写后的实际提示词(若已启用) + 智能改写后的实际提示词(如果启用) @@ -483,11 +477,11 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 失败任务数量 + 失败任务数 - 成功任务数量 + 成功任务数 @@ -497,11 +491,11 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 任务状态 - 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 + 已完成视频生成任务的视频 URL。链接有效期 24 小时 @@ -517,7 +511,7 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 已生成视频的时长,以秒为单位(I2V 和 wan3.0-video 任务) + 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) @@ -529,11 +523,11 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 输入视频的时长,以秒为单位;无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) - 输出视频的时长,以秒为单位(wan3.0-video 任务) + 输出视频的时长,单位为秒(wan3.0-video 任务) @@ -549,7 +543,7 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 已生成视频的时长,以秒为单位(T2V 任务) + 已生成视频的时长,单位为秒(T2V 任务) @@ -557,11 +551,11 @@ POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使 - 失败请求的错误码,报告在响应信封的 ROOT 层级而非 `output` 下(请求成功时不返回)。 + 失败请求的错误码,在响应包的 ROOT 处报告,而不是在 `output` 下报告(请求成功时不返回)。 - 失败请求的详细信息,报告在响应信封的 ROOT 层级而非 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,在响应包的 ROOT 处报告,而不是在 `output` 下报告(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index fdf56e60eb..07c1e4c36c 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 HappyHorse 1.1 T2V" description: "通过 Comfy Router 以 HTTP 调用 wan/happyhorse-1.1-t2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果结构" sidebarTitle: "HappyHorse 1.1 T2V" -translationSourceHash: e16717b0 +translationSourceHash: e1f68a5b translationFrom: development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx translationBlockHashes: "_intro": f001b07c "Quick start": 125cfd7d - "Schema": 88f94657 + "Schema": 0aa39fbc "Examples": 12f77722 --- + {/* 生成文件。请编辑此目录中的 code.yaml 并运行 `pnpm code-pages:gen`。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -186,83 +187,83 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-t2v/requests/$REQUEST_ID - 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 - 首帧图像 URL 或 Base64 编码数据。对于 wan2.5-i2v-preview 和 -wan2.6-i2v 模型为必填。happyhorse-1.x 的 i2v 拼写不在此处接收其首帧, -它们将首帧作为类型为 first_frame 的媒体元素接收(见下方 media),而一个 -在 wan2.6-i2v 上能够成功的 img_url 请求体,会被提供商在 -happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;并且 wan2.7/wan3.0 的拼写 -同样在 media 中携带其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 + 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 +wan2.6-i2v 模型为必填。happyhorse-1.x 的 i2v 拼写不在 +这里传入首帧:它们将首帧作为 type 为 first_frame 的 media 元素传入(见下方 media); +在 wan2.6-i2v 上能成功的 img_url 请求体,会被提供商在 +happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 的 +拼写同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。用于指定视频生成的参考资料(图像、音频、视频)。每个 -元素包含一个 type 和 url 字段。此字段由该组件提供的所有模型共享,而某个 -模型接受哪些 type 值,以及它是否在此处而非在 img_url 或 -reference_video_urls 中携带其图像或视频输入,都因模型而异。按模型列出的 -受支持 type 值: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。 +每个元素包含 type 和 url 字段。此字段由从该组件提供的每个 +模型共用;某个模型接受哪些 type 值,以及它是把图像或视频 +输入放在这里还是放在 img_url 或 +reference_video_urls 中,都因模型而异。各模型支持的 type 值: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 - 到 8:1 之间,最多 20MB,一个公开 URL 或一个 data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3,2-30 秒,最多 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最多 100MB):一个公开 HTTP/HTTPS URL;不接受 - 内联 data: URL。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要 1 个 reference_image 或 reference_video,并且参考图像加上 - 参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 - 20MB,一个公开 URL 或一个 data:\{MIME_type};base64,... URL。reference_video:一个 - 公开 HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最多 100MB,一个公开 HTTP/HTTPS URL;不接受内联 data: - URL)外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 20MB,一个公开 URL - 或一个 data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 + 到 8:1 之间,最大 20MB,可以是公开网址或 + data:\{MIME_type};base64,... 网址。 + driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 + 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS 网址; + 不接受内联 data: 网址。 +- wan2.7-r2v: first_frame(可选,最多 1 个)、reference_image、reference_video。至少 + 需要一个 reference_image 或 reference_video,并且参考图像加 + 参考视频合计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP + (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 + 20MB,公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开的 + HTTP/HTTPS 网址;不接受内联 data: 网址。 +- wan2.7-videoedit: video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, + 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址) + 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开网址 + 或 data:\{MIME_type};base64,... 网址)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最多 1 个)、last_frame(最多 1 个)、 + reference_image(最多 10 个)、reference_video(最多 5 段,总时长 \<= 15s)、 + reference_audio(最多 5 段,总时长 \<= 15s)、file(最多 1 个,不能与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型 与 first_frame/last_frame 类型在同一请求内互斥。 - 数组顺序定义了提示词中资产的参考顺序(Image 1、Video 1、 - Audio 1、...)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比最多 8:1,最多 20MB,一个公开 URL 或一个 - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:一个 - 公开 HTTP/HTTPS URL;不接受内联 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写 - 在此处接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最多 20MB,一个公开 URL 或一个 - data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 + 数组顺序决定提示中资产的引用顺序(Image 1、Video 1、 + Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公开网址或 + data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link: + 公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: 仅 first_frame,恰好 1 个。这些拼写 + 在这里传入首帧,而不是在 img_url 中传入。至少 300x300 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开网址或 + data:\{MIME_type};base64,... 网址。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: 仅 reference_image,1 到 9 个。这是 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最多 20MB,一个公开 URL 或一个 data:\{MIME_type};base64,... URL。reference_video + 最大 20MB,公开网址或 data:\{MIME_type};base64,... 网址。reference_video 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,较长边最多 4096 像素,较短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 - 之间,最多 100MB,一个公开 HTTP/HTTPS URL;不接受内联 data: - URL)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最多 20MB,一个公开 URL - 或一个 data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。它们的合作伙伴参考资料没有记录媒体输入,因此请保持 - 此字段未设置。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些拼写枚举任何媒体 - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首 - 帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上述按模型给出的数量是合作伙伴的约束,而非本 schema 的约束:media 上没有声明 -minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着 -提供商接受;反过来,上文每项资产“最多 20MB”的数字,也就是图像 -输入(唯一可以内联发送的输入)的上限,是合作伙伴对它最终拿到的 -资产所设的上限,当资产是公开 URL 时,这些上限按原文适用, -因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... -URL 确实会经过 Comfy,并且同样会遇到传输上限:Comfy Router 的 -POST 请求体总量上限为 100 MiB,超过则返回 413,而 base64 会使 -负载膨胀约 4/3,因此单个内联资产只要超过大约 75 MB,就会在此处的 -任何合作伙伴规则被触及之前被拒绝。在这个大小下,单个资产处于合作伙伴自身的 -20MB 的上限可以轻松容纳内联内容,因此对于单个资产而言,起约束作用的是合作伙伴侧的规则;而当涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。接近这些上限的任何内容都应通过公共 URL 发送。 +- happyhorse-1.0-video-edit: video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 + 秒,长边最大 4096 像素,短边至少 360 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: + 网址)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 + 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公开网址 + 或 data:\{MIME_type};base64,... 网址)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: + 文生视频操作。其合作伙伴参考文档未记录任何 media 输入,因此请勿设置 + 此字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: 本组件未为这些拼写枚举任何 media + 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入 + 首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 +上文的按模型计数是合作伙伴的约束,而不是本 Schema 的约束:media 上 +未声明 minItems/maxItems,因为可接受的类型及其上限 +因模型而异。Schema 接受并不意味着提供商接受;反过来说,上文每项资产 +"最大 20MB" 的数字(即图像输入的上限,也是唯一可能内联发送的 +输入)是合作伙伴对其最终接收资产的上限,当资产是公开网址时, +它们按字面适用,因为这些字节从不经过 Comfy。内联 +data:\{MIME_type};base64,... 网址确实会经过 Comfy,因此也会遇到传输上限: +Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 +负载膨胀约 4/3,因此单个内联资产大约超过 75 MB 就会在触及此处任何 +合作伙伴规则之前被拒绝。在这个大小下,单个资产按合作伙伴自身的20MB 的上限对内联数据来说足够宽裕,因此对单个资产而言,起约束作用的是合作伙伴的规则;而传输上限会在涉及多个资产时产生约束,因为 100 MiB 的 Router 上限限制的是整个请求,而不是每个元素。接近这些上限的内容请以公共 URL 的形式发送。 @@ -272,38 +273,37 @@ POST 请求体总量上限为 100 MiB,超过则返回 413,而 base64 会使 - 媒体文件的 URL:公共 HTTP/HTTPS URL,或者(仅针对上文中 `media` 描述为各模型列出的 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不暴露任何上传路由,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。该字段不会校验 URL 协议,因此这类值会原样转发给合作伙伴,而不会在此处被拒绝。有关各模型的大小与像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者,仅针对上面 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image:一个内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的阿里云账号解析;Comfy 使用自己的密钥发起模型调用,且不提供任何上传路由,因此调用方自有的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此这类值会被原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的大小与像素限制,以及从整体上限制内联有效载荷的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中出现的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符时,Wan 模型会将其截断,而不是拒绝请求。它与 prompt 计入相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带有多段参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等来指代 media 数组中对应顺序的媒体资产。 + 文本提示词。支持中文和英文。超过其各自文档规定的长度时,wan2.x 模型会截断提示词,而不是拒绝请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。如果 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个汉字),提供商将拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等来按参考视频的顺序指代主体。示例:"Character1 在路边唱歌,Character2 在旁边跳舞" +对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等来按 media 数组中相应的顺序指代媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。包含 1-3 个视频 URL 的数组。 + 仅适用于 wan2.6-r2v 模型的参考视频 URL。包含 1-3 个视频 URL 的数组。 输入限制: -- 格式:mp4、mov +- 格式:mp4, mov - 数量:1-3 个视频 -- 单个视频时长:2-30 秒 +- 单个视频长度:2-30 秒 - 单个文件大小:最大 30MB -- 不能与 audio_url 同时使用 -参考时长:单个视频最长 5 秒,两个视频每个最长 2.5 秒,三个视频则按比例更短。 +- 不能与 audio_url 一起使用 +参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例更短。 计费:按实际使用的参考时长计算。 - 视频特效模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 - 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它,因此 Router 调用方会省略该字段。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时必须提供它,可接受的拼写枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -311,55 +311,53 @@ POST 请求体总量上限为 100 MiB,超过则返回 413,而 base64 会使 - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;对于其他 wan 模型,提供商未记载此类开关。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 Wan 模型记录此类切换。 wan2.7-videoedit 模型的视频音频设置。 -- auto(默认):模型根据提示词内容智能判断 +- auto(默认):模型根据 prompt 内容智能判断 - origin:强制保留输入视频中的原始音频 可能的值:`auto`、`origin` - 生成视频的时长,单位为秒: + 生成视频的时长,以秒为单位: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 - wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -此代理对超出 [-1, 30] 范围的 duration 返回 400。 +- wan2.7-i2v、wan2.7-t2v:[2, 15] 区间内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 区间内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 区间内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +此时长超出 [-1, 30] 时,该代理返回 400。 范围:`-1` 到 `30` - 是否启用提示词智能改写。默认值为 true + 是否启用提示词智能重写。默认值为 true - 生成视频的画面比例。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,如果未提供,则根据分辨率档位确定默认值。 -对于 wan3.0-video,adaptive(默认)会根据输入媒体的比例和意图自动推荐 -合适的画面比例。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,如果未提供,则根据分辨率档位设置默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 - 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 可选值:`adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` - 分辨率档位。支持的值因模型而异: + 分辨率档位。支持的取值因模型而异: - wan2.5-i2v-preview:480P、720P、1080P - wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定了计费费率。它会在检查前将 resolution 转为大写,并转发大写后的值;对于不在该枚举范围内的取值返回 400;对于上文列出为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,返回 400(无论是以 resolution 还是以 480P 的 size 形式发送)。 -该代理会拒绝既未提供分辨率也未提供尺寸的视频生成请求,因为分辨率档位决定了计费费率。它会在检查之前先把分辨率转换为大写,并转发转换后的值;对于不在该枚举范围内的值返回 400;对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,如果请求 480P(无论是作为分辨率发送,还是作为 480P 的尺寸发送),同样返回 400。 - - 可能的值:`480P`、`720P`、`1080P` + 可选值:`480P`, `720P`, `1080P` @@ -369,27 +367,28 @@ POST 请求体总量上限为 100 MiB,超过则返回 413,而 base64 会使 - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 - single:单镜头视频(默认) - multi:多镜头视频 - 可能的值:`multi`、`single` + 可选值:`multi`, `single` - 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: -wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -wan2.6 T2V/R2V(不支持 480P): + 视频分辨率,格式为宽度*高度。支持的分辨率因模型而异: +对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +对于 wan2.6 T2V/R2V(不支持 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是该代理针对该模型所接受的值。对于分辨率描述中列为不支持 480P 的每个模型,480P 的尺寸都会返回 400。 +当同时发送 size 和 resolution 时,size 决定计费档位,而 resolution 仍必须是本代理为该模型接受的取值。对于分辨率描述中列出为不支持 480P 的每个模型,480P 的 size 都会返回 400。 - 是否添加水印标志,水印位于右下角 + 是否添加水印 logo,水印位于右下角 -根据 Router 在 `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/wan/happyhorse-1.1-t2v/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -402,7 +401,7 @@ wan2.6 T2V/R2V(不支持 480P): - 带音频生成的 I2V 任务的音频网址 + 带音频生成的 I2V 任务的音频 URL @@ -426,7 +425,7 @@ wan2.6 T2V/R2V(不支持 480P): - 智能改写后的实际提示词(如果已启用) + 智能改写后的实际提示词(若启用) @@ -442,7 +441,7 @@ wan2.6 T2V/R2V(不支持 480P): - 已生成图像的网址 + 已生成图像的 URL 地址 @@ -458,15 +457,15 @@ wan2.6 T2V/R2V(不支持 480P): - 图像生成任务的任务结果统计 + 图像生成任务的结果统计 - 失败任务数量 + 失败任务数 - 成功任务数量 + 成功任务数 @@ -480,7 +479,7 @@ wan2.6 T2V/R2V(不支持 480P): - 已完成的视频生成任务的视频网址。链接有效期为 24 小时 + 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 @@ -492,7 +491,7 @@ wan2.6 T2V/R2V(不支持 480P): - 视频分辨率等级(I2V 和 wan3.0-video 任务) + 视频分辨率级别(I2V 和 wan3.0-video 任务) @@ -508,7 +507,7 @@ wan2.6 T2V/R2V(不支持 480P): - 输入视频的时长,单位为秒,没有视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) @@ -536,11 +535,11 @@ wan2.6 T2V/R2V(不支持 480P): - 失败请求的错误码,在信封的根级 ROOT 处返回,而不是在 `output` 下返回(请求成功时不返回)。 + 失败请求的错误码,在响应封装的根级返回,而不是在 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,在信封的根级 ROOT 处返回,而不是在 `output` 下返回(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此信息。 + 失败请求的详细信息,在响应封装的根级返回,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此处。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx b/zh/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx index f706a74724..ac2c12362d 100644 --- a/zh/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx @@ -2,16 +2,17 @@ title: "将 Wan 2.5 T2I Preview 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 wan/wan2.5-t2i-preview:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Wan 2.5 T2I Preview" -translationSourceHash: 9d519a07 +translationSourceHash: 1b62e07d translationFrom: development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx translationBlockHashes: "_intro": 975ad7fc "Quick start": 9cc4b789 - "Schema": 579649db + "Schema": 77ffea28 "Examples": e420aca1 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/wan/wan2.5-t2i-preview.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -176,15 +177,15 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 反向提示词,用于描述你不希望在图像中出现的内容 + 负向提示词,用于描述你不希望在图像中看到的内容。超过 500 个字符时,模型会将其截断,而不是拒绝该请求。它计入与 prompt 相同的输入预算。 - 正向提示词,用于描述期望的图像元素和视觉特征。支持中文和英文,长度不超过 800 个字符 + 正向提示词,用于描述期望的图像元素和视觉特征。支持中文和英文。超过 2,000 个字符时,模型会截断提示词,而不是拒绝该请求。如果 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符),提供商会拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 - 调用文生图生成时使用的模型 ID。此组件不对其做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它。直接以 v1 方式调用 `POST /proxy/wan/api/v1/services/aigc/text2image/image-synthesis` 时必须提供该值,可接受的拼写枚举定义在该操作自身的组件 `WanImageGenerationRequest` 上。 + 用于文生图生成的模型 ID。此组件不约束该字段:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它。直接向 `POST /proxy/wan/api/v1/services/aigc/text2image/image-synthesis` 发起 v1 调用时,必须提供该字段,而可接受拼写的枚举定义在该操作自己的组件 `WanImageGenerationRequest` 上。 @@ -192,30 +193,31 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 生成图像的数量。范围 1-4,默认为 4 + 生成图像的数量。范围为 1-4,默认值为 4 - 范围:`1` 到 `4` + 范围:`1` 至 `4` - 启用提示词智能改写。默认为 true + 启用提示词智能改写。默认值为 true 用于控制随机性的随机数种子。范围 [0, 2147483647] - 范围:`0` 到 `2147483647` + 范围:`0` 至 `2147483647` - 输出图像的分辨率,格式为 width*height。默认为 1280*1280。API 接受的像素面积在 1638400(1280*1280)到 2073600(1440*1440)之间,宽高比在 1:4 到 4:1 之间,因此 768*2700 是有效的 + 输出图像分辨率,格式为 width*height。默认值为 1280*1280。API 接受的像素面积介于 1638400(1280*1280)和 2073600(1440*1440)之间,宽高比介于 1:4 和 4:1 之间,因此 768*2700 是有效的 - 是否在右下角添加水印标识 + 是否在右下角添加水印标志 -由 Router 在 `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json` 提供的 schema 生成,该文档与 Router 在请求到达提供商之前校验调用所依据的文档相同。 + ### 输出 @@ -223,7 +225,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 智能改写后的实际提示词(用于视频任务) + 智能改写后的实际提示词(适用于视频任务) @@ -231,7 +233,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 失败请求的错误代码(请求成功时不返回) + 失败请求的错误码(请求成功时不返回) @@ -243,7 +245,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 原始输入提示词(用于视频任务) + 原始输入提示词(适用于视频任务) @@ -255,7 +257,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 图像错误代码(部分任务失败时返回) + 图像错误码(部分任务失败时返回) @@ -267,7 +269,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 已生成图像的 URL 地址 + 已生成图像的图片网址 @@ -305,7 +307,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 + 已完成的视频生成任务的视频链接。链接有效期为 24 小时 @@ -321,7 +323,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 已生成视频的时长(秒)(I2V 和 wan3.0-video 任务) + 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) @@ -333,11 +335,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 输入视频的时长(秒),无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) - 输出视频的时长(秒)(wan3.0-video 任务) + 输出视频的时长,单位为秒(wan3.0-video 任务) @@ -353,7 +355,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 已生成视频的时长(秒)(T2V 任务) + 已生成视频的时长,单位为秒(T2V 任务) @@ -361,11 +363,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - 失败请求的错误代码,报告在响应外层的根层级(ROOT),而非 `output` 下(请求成功时不返回)。 + 失败请求的错误码,报告在响应信封的根层级(ROOT),而不是在 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,报告在响应外层的根层级(ROOT),而非 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,报告在响应信封的根层级(ROOT),而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此内容。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx b/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx index 4a11ef40c2..8a5c64c373 100644 --- a/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 Wan 2.5 T2V Preview" description: "通过 Comfy Router 以 HTTP 方式调用 wan/wan2.5-t2v-preview 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果结构" sidebarTitle: "Wan 2.5 T2V Preview" -translationSourceHash: 51e7ac3c +translationSourceHash: e7df4aa3 translationFrom: development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx translationBlockHashes: "_intro": 111ed2f7 "Quick start": d4fb170b - "Schema": 73f1810d + "Schema": 62b9e06a "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -186,69 +187,25 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests/$REQUEST_ID - 音频文件下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载链接。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 - 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x - 的 i2v 拼写不在此处接收首帧,而是将其作为类型为 first_frame 的媒体元素接收(见下方 - media);在 wan2.6-i2v 上能成功的 img_url 请求体,会被提供商在 happyhorse-1.0-i2v 和 - happyhorse-1.1-i2v 上拒绝;而 wan2.7/wan3.0 的拼写同样在 media 中接收其参考资产。 - 图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图片网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 写法不在这里传入首帧:它们把首帧作为类型为 first_frame 的媒体元素传入(参见下方的 media);而在 wan2.6-i2v 上能够成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 的写法同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大值 10MB。 - 媒体资产列表。为视频生成指定参考素材(图像、音频、视频)。每个元素包含 type 和 url - 字段。该字段由本组件提供的所有模型共用,而某个模型接受哪些 type 值,以及它到底是在这里 - 还是在 img_url 或 reference_video_urls 中携带图像或视频输入,都因模型而异。各模型支持的 - type 值如下: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间, - 最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要 - 1 个 reference_image 或 reference_video,且参考图像与参考视频合计最多 5 个。first_frame - 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无 alpha 通道),每边 240-8000 像素,宽高比 - 在 1:8 到 8:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 - reference_video:公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- wan2.7-videoedit:video(正好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 - 像素,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址)加上可选的 0 到 4 个 - reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间, - 最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 一起使用)、 - link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型与 first_frame/last_frame - 类型在同一请求中互斥。数组顺序决定提示词中资产的参考顺序(Image 1、Video 1、Audio 1、...)。 - first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素, - 宽高比最大 8:1,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 - reference_video、reference_audio、file 和 link:公开的 HTTP/HTTPS 网址;不接受内联 - data: 网址。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,且正好 1 个。这些拼写在“此处” - 接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间, - JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的 - 参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开网址或 - data:\{MIME_type};base64,... 网址。reference_video 不是该操作的输入类型。 -- happyhorse-1.0-video-edit:video(正好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 - 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 - HTTP/HTTPS 网址;不接受内联 data: 网址)加上可选的 0 到 5 个 reference_image - (JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB, - 可以是公开网址或 data:\{MIME_type};base64,... 网址)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其合作伙伴参考资料未记录任何媒体输入,因此请勿设置此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件没有为这些拼写枚举任何媒体词汇。 - wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧;wan2.6-r2v 在 - reference_video_urls 中接收其参考片段。 -上文按模型给出的数量是合作伙伴的限制,而非本 schema 的限制:media 上没有声明 -minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不代表提供商接受。 -反过来说,上文每个资产“最大 20MB”的数值(图像输入的上限,也是唯一可以内联发送的输入) -是合作伙伴对其最终获得的资产所设的上限;当资产是公开网址时,这些数值按字面适用,因为那些 -字节从不经过 Comfy 传输。内联的 data:\{MIME_type};base64,... 网址确实会经过 Comfy 传输, -因此也会遇到传输上限:一个 Comfy Router POST 请求体总量上限为 100 MiB,超过即返回 413, -而 base64 会使载荷膨胀约 4/3,因此单个内联资产若超过约 75 MB,就会在这里的任何合作伙伴 -规则被触达之前被拒绝。在这种大小下,单个资产若达到合作伙伴自身的20MB 上限可以轻松容纳内联内容,因此对于单个资产而言,真正起作用的是合作伙伴规则;而涉及多个资产时则受传输上限约束,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。任何接近这些上限的内容,请以公共 URL 形式发送。 + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由此组件提供的所有模型共用,而某个模型接受哪些 type 值,以及它是否在此处而不是在 img_url 或 reference_video_urls 中传入图像或视频输入,都因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 与 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 20MB,公网 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最多 15MB)与 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最多 100MB):公网 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-r2v:first_frame(可选,最大值 1)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,且参考图像加参考视频总计最多 5 个。first_frame 与 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 20MB,公网 URL 或 data:\{MIME_type};base64,... URL。reference_video:公网 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被剪辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最多 100MB,公网 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 20MB,公网 URL 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最大值 1)、last_frame(最大值 1)、reference_image(最大值 10)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最大值 1,不能与 link 一起使用)、link(最大值 1,不能与 file 一起使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定资产在提示词中的引用顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 与 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最多 8:1,最多 20MB,公网 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 与 link:公网 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法在这里传入首帧,而不是在 img_url 中传入。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最多 20MB,公网 URL 或 data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最多 20MB,公网 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最多 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最多 100MB,公网 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最多 20MB,公网 URL 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记载任何媒体输入,因此请保持此字段未设置。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些写法枚举任何媒体词汇。wan2.5-i2v-preview 与 wan2.6-i2v 在 img_url 中传入首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 +上述各模型的数量是合作伙伴的约束,而不是本 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受;而反过来说,上文每个资产“最多 20MB”的数字(这是图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产的上限,当资产是公网 URL 时,这些限制按字面生效,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,因此也要满足传输层的上限:Comfy Router 的 POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个内联资产超过约 75 MB 就会在这里的任何合作伙伴规则被触及之前遭到拒绝。在这种大小下,单个资产按合作伙伴自身的20MB 的上限以内可以轻松内联,因此面对单个资产时真正起约束作用的是合作伙伴规则,而传输上限则约束多个资产的情况,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,请以公共 URL 发送。 @@ -258,37 +215,37 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者(仅适用于上文 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 与 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)一个内联的 `data:{MIME_type};base64,...` URL。在这些模型上,没有任何 video、audio、file 或 link 输入接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账户进行解析;Comfy 使用自己的密钥发起模型调用,且不提供任何上传路由,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。该字段不校验 URL scheme,因此这类值会按原样转发给合作伙伴,而不会在此处被拒绝。有关各模型的大小与像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者,仅针对上文中 `media` 描述为各模型列出的 IMAGE 输入,可以是内联的 `data:{MIME_type};base64,...` URL,这些输入为:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image。这些模型上的任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自家上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只会对上传该内容的阿里云账号生效;Comfy 使用自己的密钥发起模型调用,并且不对外暴露上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL 协议,因此这类值会原样转发给合作伙伴,而不会在此处被拒绝。关于各模型的大小与像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中看到的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符时,wan 模型会对其截断,而不是拒绝请求。它与 prompt 计入同一输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,按照 media 数组中对应的顺序来指代媒体资产。 + 文本提示词。支持中文和英文。超出各自文档所载长度时,wan2.x 模型会截断提示词,而不是拒绝请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。若 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个汉字),提供商会拒绝该请求,返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带有多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等,按参考视频的顺序来指代各个主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,按 media 数组中的对应顺序来指代媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅适用于 wan2.6-r2v 模型的参考视频 URL。1 至 3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov -- 数量:1-3 个视频 -- 单个视频时长:2-30 秒 +- 数量:1 至 3 个视频 +- 单个视频时长:2 至 30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例更短。 +参考时长:单个视频最长 5s,两个视频各最长 2.5s,三个视频按比例更短。 计费:按实际使用的参考时长计费。 - 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 + 视频特效模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它,因此 Router 调用方会省略该字段。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受的拼写枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供,可接受拼写的枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 @@ -296,7 +253,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商没有为其他 wan 模型记录此类开关。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;对于其他 wan 模型,提供商未记载此类切换项。 @@ -312,22 +269,22 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 - wan2.6-r2v:仅 5 或 10 秒(不支持 15s) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 之间的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 之间的整数 -- wan3.0-video:无视频输入时为 [2, 30] 之间的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 会启用智能时长模式,由模型选择合适的时长 -对于超出 [-1, 30] 的 duration,此代理会返回 400。 +- wan2.7-i2v、wan2.7-t2v:[2, 15] 内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 内的整数;有视频输入时,输入视频时长与输出视频时长之和不得超过 30 秒;-1 启用智能时长模式,由模型挑选合适的时长 +此代理对 [-1, 30] 之外的时长返回 400。 范围:`-1` 到 `30` - 是否启用提示词智能改写。默认为 true + 是否启用提示词智能改写。默认值为 true - 生成视频的画面比例。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,如果未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体比例和意图自动推荐合适的画面比例。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,若未提供,则根据分辨率档位确定默认值。 +对于 wan3.0-video,adaptive(默认)会自动推荐合适的基于输入媒体的比例和意图确定的宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -340,7 +297,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P -该代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定了计费费率。它会在检查之前将 resolution 转换为大写并转发转换后的值,对于不在此枚举范围内的值返回 400,并且对于上文中列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,在 480P 上返回 400(无论是以 resolution 还是以 480P 的 size 形式发送)。 +此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将 resolution 转换为大写并转发大写后的值,对超出该枚举范围的值返回 400,并且对上面列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型返回 400 拒绝 480P(无论是以 resolution 还是以 480P 的 size 形式发送)。 可能的值:`480P`、`720P`、`1080P` @@ -352,7 +309,8 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 - single:单镜头视频(默认) - multi:多镜头视频 @@ -361,18 +319,18 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: -针对 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -针对 wan2.6 T2V/R2V(无 480P): +对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +对于 wan2.6 T2V/R2V(不支持 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时发送 size 和 resolution 时,由 size 决定计费的档位,而 resolution 仍必须是该代理针对该模型所接受的值。对于分辨率描述中列为不支持 480P 的每个模型,使用 480P 的 size 都会返回 400。 +当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是此代理为该模型接受的值。对于 resolution 说明中列为不支持 480P 的每个模型,传入 480P 的 size 都会返回 400。 - 是否添加水印标识,水印位于右下角 + 是否添加水印 logo,水印位于右下角 -本文档根据 Router 在 `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` 提供的 schema 生成,该 schema 也是请求到达提供商之前用于校验调用的同一份文档。 +由 Router 在 `GET /v2/models/wan/wan2.5-t2v-preview/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 @@ -381,11 +339,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 智能改写后的实际提示词(适用于视频任务) + 智能改写后的实际提示词(视频任务) - 带音频生成的 I2V 任务的音频 URL + 带音频生成的 I2V 任务音频 URL @@ -401,15 +359,15 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 原始输入提示词(适用于视频任务) + 原始输入提示词(视频任务) - 图像生成任务的任务结果列表 + 图像生成任务的结果列表 - 智能改写后的实际提示词(若已启用) + 智能改写后的实际提示词(如已启用) @@ -425,7 +383,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 已生成图像的网址 + 已生成图像的图片网址 @@ -441,15 +399,15 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 图像生成任务的任务结果统计 + 图像生成任务的结果统计 - 失败的任务数 + 失败任务数 - 成功的任务数 + 成功任务数 @@ -459,7 +417,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 任务状态 - 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` @@ -475,7 +433,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 视频分辨率等级(I2V 和 wan3.0-video 任务) + 视频分辨率级别(I2V 和 wan3.0-video 任务) @@ -491,7 +449,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 输入视频的时长,单位为秒,无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) @@ -519,11 +477,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema - 失败请求的错误码,报告在信封的根层级,而非 `output` 下(请求成功时不返回)。 + 失败请求的错误码,在响应结构的根层级返回,而不是在 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,报告在信封的根层级,而非 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此处。 + 失败请求的详细信息,在响应结构的根层级返回,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先读取此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index 25b5af7e7a..cec3ec92fd 100644 --- a/zh/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 Wan 2.6 I2V" description: "通过 Comfy Router 以 HTTP 调用 wan/wan2.6-i2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果形状" sidebarTitle: "Wan 2.6 I2V" -translationSourceHash: 2d86680e +translationSourceHash: 6912559c translationFrom: development/comfy-router/models/wan/wan2-6-i2v/code.mdx translationBlockHashes: "_intro": 53ec6bcb "Quick start": 0163076e - "Schema": 4b1f17d6 + "Schema": a13e6673 "Examples": 2b581e5f --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -190,71 +191,64 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 + 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 - 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x i2v 这些写法不在此处传入首帧:它们把首帧作为 type 为 first_frame 的媒体元素传入(参见下文的 media),而且在 wan2.6-i2v 上能成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 这些写法同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 + 第一帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x i2v 的这些写法不在此处接收其第一帧,而是将其作为类型为 first_frame 的媒体元素(见下方 media)。在 wan2.6-i2v 上能成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;此外,wan2.7/wan3.0 的这些写法也会在 media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。用于指定视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由本组件提供的所有模型共用,而某个模型接受哪些 type 值,以及它究竟是在这里携带图像或视频输入、还是在 img_url 或 reference_video_urls 中携带,都因模型而异。各模型支持的 type 值如下: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):必须是公开的 HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要提供一个 reference_image 或 reference_video,且参考图像加参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(不含透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:必须是公开的 HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,必须是公开的 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15 秒)、reference_audio(最多 5 个片段,总时长 \<= 15 秒)、file(最多 1 个,不能与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 这些类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定提示词中资产的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:必须是公开的 HTTP/HTTPS URL;不接受内联 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法在此处传入首帧,而不是在 img_url 中传入。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,必须是公开的 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其对应的合作伙伴参考文档未记录任何媒体输入,因此请勿设置此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些写法列举任何 media 词表。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 -上述各模型的计数是合作伙伴的约束,而不是本 schema 的约束:media 上没有声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 通过并不意味着提供商接受;反过来说,上面每个资产“最大 20MB”的数值是合作伙伴对其最终收到的资产所设的上限(这也是图像输入的上限,而图像输入是唯一可以内联发送的输入),当资产是公开 URL 时,这些上限按原文生效,因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... URL 确实会经过 Comfy,因而也会遇到传输上限:Comfy Router 的 POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个内联资产只要超过约 75 MB,就会在触及此处的任何合作伙伴规则之前被拒绝。在这样的体积下,单个资产即使处于合作伙伴自身的 -20MB 的上限可以轻松容纳内联内容,因此对于单个资产,真正起约束作用的是合作伙伴规则; -而对于多个资产,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是 -整个请求,而不是其中的每个元素。任何接近这些上限的内容,请以公共 URL -形式发送。 + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由此组件提供的所有模型共用,而给定模型接受哪些 type 值,以及它到底是将图像或视频输入放在这里,还是放在 img_url 或 reference_video_urls 中,这些都因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,并且参考图像加参考视频总数最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video:公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定提示词中资产的参考顺序(Image 1、Video 1、Audio 1、...)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法在此处接收第一帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。它们的合作伙伴参考文档未记录任何媒体输入,因此请保持此字段未设置。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件没有为这些写法枚举任何 media 类型。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其第一帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 +上述各模型的数量是合作伙伴的约束,而不是此 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 通过校验并不意味着提供商会接受;反过来,上文每个资产的“最大 20MB”数值(图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产所设的上限,当资产是公共 URL 时,它们按原文适用,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,并且也会遇到传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使负载膨胀约 4/3,因此单个内联资产只要超过约 75 MB,就会在触达这里的任何合作伙伴规则之前被拒绝。在这种大小下,单个资产在合作伙伴自身的 +20MB 上限对于内联数据来说足够宽裕,因此单个资产真正受限的是合作伙伴规则;多个资产则会触及传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。接近这些上限的任何内容都应作为公共 URL 发送。 媒体资产类型 - 可选值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - 媒体文件的 URL:公共 HTTP/HTTPS URL;或者,仅针对上文 `media` 描述中为各模型列出的 IMAGE 输入(wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image),也可以使用内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何 video、audio、file 或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅在创建它的阿里云账户下才能解析;Comfy 使用自己的密钥发起模型调用,且不对外提供上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此这类值会按原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的大小与像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:公共 HTTP/HTTPS URL;或者,仅对于上文 `media` 描述为各模型列出的图像输入(wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image),才可使用内联 `data:{MIME_type};base64,...` URL。这些模型上任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自身上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能针对上传它的阿里云账户解析;Comfy 使用自己的密钥发起模型调用,并且不暴露上传路由,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此此类值会原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的大小和像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中看到的内容 + 反向提示词用于描述你不希望在视频画面中出现的内容。超过 500 个字符时,wan 模型会将其截断,而不是拒绝请求。它会计入与 prompt 相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。 -示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请按 media 数组中对应的顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 + 文本提示词。支持中文和英文。超过其自身文档规定的长度时,wan2.x 模型会截断提示词,而不是拒绝请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。如果 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符),提供商将拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:“Character1 在路边唱歌,Character2 在旁边跳舞”。对于 wan3.0-video 参考模式,请按媒体数组中对应的顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 - 仅适用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅限 wan2.6-r2v 模型使用的参考视频 URL。包含 1-3 个视频 URL 的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 -- 单个视频时长:2-30 秒 +- 单个视频长度:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最长 5s,两个视频各最长 2.5s,三个视频按比例更短。 -计费:按实际使用的参考时长计费。 +参考时长:单个视频最大 5s,两个视频各最大 2.5s,三个视频按比例更短。 +计费:基于实际使用的参考时长。 - 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 - 要调用的模型 ID。此组件上不作约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发出的 v1 调用必须提供它,而可接受拼写的枚举定义在该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时,必须提供该字段;可接受拼写的枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 @@ -262,56 +256,53 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商没有为其他 wan 模型记录此类切换。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未记录其他 wan 模型有此开关。 wan2.7-videoedit 模型的视频音频设置。 -- auto(默认):模型根据提示词内容智能判断 +- auto(默认):模型根据 prompt 内容智能判断 - origin:强制保留输入视频中的原始音频 - 可选值:`auto`、`origin` + 可能的值:`auto`、`origin` - 生成视频的时长,单位为秒: + 生成的视频时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 - wan2.6-r2v:仅 5 或 10 秒(不支持 15s) - wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 - wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + - 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型自行挑选合适的时长 -此代理对超出 [-1, 30] 范围的时长返回 400。 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频总时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +对于超出 [-1, 30] 范围的时长,此代理返回 400。 范围:`-1` 到 `30` - 是否启用提示词智能改写。默认为 true + 是否启用 prompt 智能改写。默认值为 true 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,如果未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图 -自动推荐合适的宽高比。 +对于 wan2.7 模型,如果未提供,则根据分辨率档位确定默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` - 分辨率档位。支持的值因模型而异: + 分辨率档位。支持的取值因模型而异: - wan2.5-i2v-preview:480P、720P、1080P -- wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) +- wan2.6 模型(t2v、i2v、r2v):仅支持 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认为 1080P) +- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +该代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在校验前将 resolution 转为大写并转发转为大写后的值;对于该枚举之外的取值返回 400;对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,遇到 480P 时返回 400(无论是以 resolution 传入,还是以 480P 的 size 传入)。 -该代理会拒绝既未提供分辨率也未提供尺寸的视频生成请求,因为分辨率档位决定计费费率。它会在检查之前将分辨率转为大写并转发大写后的值,对于超出该枚举范围的值返回 400,并且对于上方列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,在收到 480P 时返回 400(无论是以分辨率还是以 480P 尺寸发送)。 - - 可选值:`480P`, `720P`, `1080P` + 可选值:`480P`、`720P`、`1080P` @@ -323,28 +314,26 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ 智能多镜头控制。仅在启用 prompt_extend 时生效。 适用于 wan2.6 和 wan2.7-r2v 模型。 -- single:单镜头视频(默认) -- multi:多镜头视频 +- single: 单镜头视频(默认) +- multi: 多镜头视频 - 可选值:`multi`, `single` + 可选值:`multi`、`single` 视频分辨率,格式为 width*height。支持的分辨率因模型而异: -对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(无 480P): +wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +wan2.6 T2V/R2V(不支持 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时发送尺寸和分辨率时,尺寸决定计费档位, -分辨率仍必须是该代理为此模型接受的值。对于分辨率描述中列为不支持 480P 的每个模型, -480P 的尺寸都会返回 400。 +当同时传入 size 和 resolution 时,size 决定计费档位,而 resolution 仍必须是该代理接受的、适用于该模型的取值。在分辨率说明中列为不支持 480P 的每个模型上,传入 480P 的 size 都会返回 400。 - 是否添加水印标识,水印位于右下角 + 是否添加水印 logo,水印位于右下角 -由 Router 在 `GET /v2/models/wan/wan2.6-i2v/openapi.json` 提供的 schema 生成,该文档也正是它在请求到达提供商之前用于校验调用的同一份文档。 +本文档根据 Router 在 `GET /v2/models/wan/wan2.6-i2v/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 @@ -361,7 +350,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 失败请求的错误码(请求成功时不返回) + 失败请求的错误代码(请求成功时不返回) @@ -377,15 +366,15 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 图像生成任务的结果列表 + 图像生成任务的任务结果列表 - 智能改写后的实际提示词(如果启用) + 智能改写后的实际提示词(如果已启用) - 图像错误码(部分任务失败时返回) + 图像错误代码(部分任务失败时返回) @@ -397,7 +386,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 已生成图像的网址 + 已生成图像的 URL 地址 @@ -413,7 +402,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 图像生成任务的结果统计 + 图像生成任务的任务结果统计 @@ -431,11 +420,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ 任务状态 - 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 视频生成任务完成后的视频 URL。链接有效期为 24 小时 + 已完成视频生成任务的视频 URL。链接有效期 24 小时 @@ -447,7 +436,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 视频分辨率等级(I2V 和 wan3.0-video 任务) + 视频分辨率级别(I2V 和 wan3.0-video 任务) @@ -459,11 +448,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 已生成图像的数量(T2I 和 I2I 任务) + 已生成图像数量(T2I 和 I2I 任务) - 输入视频的时长,单位为秒;没有视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) @@ -471,7 +460,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 已生成视频的宽高比,例如 16:9(wan3.0-video 任务) + 已生成视频的比例,例如 16:9(wan3.0-video 任务) @@ -479,7 +468,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 已生成视频的数量(T2V 任务) + 已生成视频数量(T2V 任务) @@ -491,11 +480,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - 失败请求的错误码,在响应信封的 ROOT 层级返回,而不是在 `output` 下(请求成功时不返回)。 + 失败请求的错误代码,报告在响应信封的根层级,而不是 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,在响应信封的 ROOT 层级返回,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此项。 + 失败请求的详细信息,报告在响应信封的根层级,而不是 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此信息。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index d7f424fae2..e709f80e45 100644 --- a/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -14,6 +14,7 @@ translationBlockHashes: + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; diff --git a/zh/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 1d6aad19be..347ec603bb 100644 --- a/zh/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -2,17 +2,18 @@ title: "使用 Comfy Router 调用 Wan 2.7 I2V" description: "通过 Comfy Router 以 HTTP 方式调用 wan/wan2.7-i2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果形状" sidebarTitle: "Wan 2.7 I2V" -translationSourceHash: 6c8ca8c8 +translationSourceHash: 5c0685e4 translationFrom: development/comfy-router/models/wan/wan2-7-i2v/code.mdx translationBlockHashes: "_intro": d49c4d30 "Quick start": 167fa44a - "Schema": ac50dc1f + "Schema": 5e5f0bca "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -209,77 +210,25 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests/$REQUEST_ID \ - 音频文件下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 - 首帧图像网址或 Base64 编码数据。对于 wan2.5-i2v-preview 和 -wan2.6-i2v 模型为必填。happyhorse-1.x 的 i2v 写法不在此处接收其首帧: -它们将首帧作为类型为 first_frame 的媒体元素传入(见下文 media),而在 -wan2.6-i2v 上能成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 -happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 的写法同样在 media 中 -传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 -分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像 URL 或 Base64 编码数据。对于 wan2.5-i2v-preview 和 wan2.6-i2v 模型为必填。happyhorse-1.x 的 i2v 写法**不**在这里传入首帧:它们将首帧作为 type 为 first_frame 的媒体元素传入(见下方 media),并且在 wan2.6-i2v 上能够成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 的写法同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含一个 -type 字段和一个 url 字段。此字段由此组件提供的所有模型共用,而给定模型接受哪些 -type 值,以及它究竟是在此处还是在 img_url 或 reference_video_urls 中携带其图像或 -视频输入,都因模型而异。按模型分别列出的受支持 type 值: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 与 8:1 - 之间,最大 20MB,公开网址或 data:\{MIME_type};base64,... 网址。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公开 HTTP/HTTPS 网址;不接受内联 - data: 网址。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要一个 reference_image 或 reference_video,且参考图像加参考视频总计最多 5 个。 - first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 - 240-8000 像素,宽高比在 1:8 与 8:1 之间,最大 20MB,公开网址或 - data:\{MIME_type};base64,... 网址。reference_video:公开 HTTP/HTTPS 网址; - 不接受内联 data: 网址。 -- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公开 HTTP/HTTPS 网址;不接受内联 data: - 网址)外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 与 8:1 之间,最大 20MB,公开网址 - 或 data:\{MIME_type};base64,... 网址)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link - 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型 - 与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定提示词中资产的 - 参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image: - JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最多 8:1,最大 20MB,公开网址或 - data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link: - 公开 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法 - 在此处接收其首帧,而非在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 与 2.5:1 - 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开网址或 - data:\{MIME_type};base64,... 网址。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 - 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,公开网址或 data:\{MIME_type};base64,... 网址。reference_video - 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,最长边最多 4096 像素,最短边至少 360 像素,宽高比在 1:2.5 与 2.5:1 之间, - 最大 100MB,公开 HTTP/HTTPS 网址;不接受内联 data: 网址)外加可选的 - 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素, - 宽高比在 1:2.5 与 2.5:1 之间,最大 20MB,公开网址或 - data:\{MIME_type};base64,... 网址)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其合作伙伴参考文档未记录任何媒体输入,因此请保持此字段未设置。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件没有为这些写法枚举任何媒体 - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧; - wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上文中按模型给出的数量是合作伙伴的约束,而非本 schema 的约束:media 上没有声明 -minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不代表提供商接受; -反过来说,上文每项资产“最大 20MB”的数值(图像输入的上限,而图像输入是唯一可以内联 -发送的输入)是合作伙伴对其最终收到的资产设置的上限,当资产是公开网址时,它们按字面 -适用,因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... 网址确实会经过 -Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB, -超出后会返回 413,而 base64 会使负载膨胀约 4/3,因此单个超过约 75 MB 的内联资产会在 -触达此处任何合作伙伴规则之前就被拒绝。在这一大小下,单个资产若达到合作伙伴自身的20MB 的上限可以轻松容纳内联数据,因此对于单个资产来说,真正起约束作用的是合作伙伴规则。而传输上限则在涉及多个资产时起约束作用,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,都应通过公共 URL 发送。 + 媒体资产列表。指定用于视频生成的参考资料(图像、音频、视频)。每个元素包含 type 和 url 字段。该字段由本组件提供的所有模型共用,而某个模型接受哪些 type 值,以及它是将图像或视频输入放在这里,还是放在 img_url 或 reference_video_urls 中,均因模型而异。各模型支持的 type 值: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,支持公网 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公网 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要 1 个 reference_image 或 reference_video,且参考图像加参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,支持公网 URL 或 data:\{MIME_type};base64,... URL。reference_video:公网 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公网 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,支持公网 URL 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 同时使用)、link(最多 1 个,不能与 file 同时使用)。在同一请求中,reference_*/file/link 类型与 first_frame/last_frame 类型互斥。数组顺序决定提示词中资产的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,支持公网 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公网 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法在这里传入首帧,而不是在 img_url 中传入。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,支持公网 URL 或 data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,数量为 1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,支持公网 URL 或 data:\{MIME_type};base64,... URL。对于该操作,reference_video 不是输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公网 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,支持公网 URL 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其对应的合作伙伴参考文档未记载任何媒体输入,因此请勿设置该字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些写法列举任何媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入其首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 +上述各模型的数量限制属于合作伙伴的约束,而非本 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 校验通过并不意味着提供商会接受;反过来,上述每个资产"最大 20MB"的数值(图像输入即唯一可能以内联方式发送的输入的上限)是合作伙伴对其最终收到的资产所设的上限,当资产是公网 URL 时,这些限制按字面生效,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,因此还要面对一层传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个内联资产若超过约 75 MB,就会在触及此处任何合作伙伴规则之前被拒绝。在这种大小下,单个资产按合作伙伴自身20MB 的上限单靠内联方式就能轻松容纳,因此对于单个资产来说,真正起约束作用的是合作伙伴的规则;而跨多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中每个元素。接近这些上限的任何内容都请以公共 URL 发送。 @@ -289,38 +238,37 @@ Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体 - 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者,仅针对上文 `media` 描述中为各模型列出的 IMAGE 输入(wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image),一个内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何 video、audio、file 或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不提供任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不会校验 URL scheme,因此这类值会原样转发给合作伙伴,而不会在此处被拒绝。各模型的尺寸和像素限制,以及从整体上约束内联载荷的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:一个公共 HTTP/HTTPS URL;或者,仅限上文 `media` 描述中为各模型列出的那几种 IMAGE 输入(wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image),可以是一个内联的 `data:{MIME_type};base64,...` URL。这些模型上没有任何视频、音频、文件或 link 类型的输入接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只会在上传它的那个阿里云账号下才能解析;Comfy 使用自己的密钥发起模型调用,并且不提供任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。此字段不校验 URL scheme,因此这类值会被原样转发给合作伙伴,而不会在这里被拒绝。各模型的大小与像素限制,以及以聚合方式约束内联负载的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不想在视频画面中看到的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符后,wan 模型会将其截断,而不是拒绝该请求。它和 prompt 计入同一份输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等按参考视频的顺序指代主体。例如:"Character1 在路边唱歌,Character2 在旁边跳舞" -对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,按 media 数组中对应的顺序指代媒体资产。 + 文本提示词。支持中文和英文。超过各自文档记载的长度后,wan2.x 模型会截断提示词,而不是拒绝请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。如果 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个中文字符),提供商会拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对于 wan3.0-video 的参考模式,请按媒体数组中对应的顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 - 仅适用于 wan2.6-r2v 模型的参考视频 URL。由 1 至 3 个视频 URL 组成的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov -- 数量:1 至 3 个视频 -- 单个视频长度:2 至 30 秒 -- 单个文件大小:最大 30MB -- 不能与 audio_url 一起使用 -参考时长:单个视频最长 5 秒,两个视频每个最长 2.5 秒,三个视频按比例更短。 +- 数量:1-3 个视频 +- 单视频时长:2-30 秒 +- 单文件大小:最大 30MB +- 不能与 audio_url 同时使用 +参考时长:单个视频最长 5s,两个视频各最长 2.5s,三个视频则按比例更短。 计费:按实际使用的参考时长计算。 - 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受拼写的枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接向 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受拼写的枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -328,56 +276,53 @@ Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体 - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未记录其他 wan 模型有此切换项。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商没有为其他 wan 模型记载此类开关。 wan2.7-videoedit 模型的视频音频设置。 - auto(默认):模型根据提示词内容智能判断 -- origin:强制保留输入视频的原始音频 +- origin:强制保留输入视频中的原始音频 可选值:`auto`、`origin` - 已生成视频的时长,单位为秒: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 之间的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 之间的整数 -- wan3.0-video:无视频输入时为 [2, 30] 之间的整数;有视频输入时,输入视频总时长 - 加输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -此时长若超出 [-1, 30],此代理会返回 400。 - - 范围:`-1` 到 `30` +- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) +- wan2.7-i2v、wan2.7-t2v:[2, 15] 区间内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 区间内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 区间内的整数;有视频输入时,输入视频总时长与输出视频总时长之和不得超过 30 秒;-1 表示启用智能时长模式,由模型选择合适的时长 +当 duration 超出 [-1, 30] 范围时,该代理返回 400。 + + 范围:`-1` 至 `30` - 是否启用提示词智能改写。默认为 true + 是否启用提示词智能改写。默认值为 true - 生成视频的比例。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,如果未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图 -自动推荐合适的比例。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 分辨率档位。支持的取值因模型而异: -- wan2.5-i2v-preview:480P、720P、1080P +- wan2.5-i2v-preview: 480P、720P、1080P - wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video, wan3.0-video-prime: 480P、720P、1080P(上游默认为 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P、1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P、720P、1080P - -该代理会拒绝既未提供分辨率也未提供尺寸的视频生成请求,因为分辨率档位决定了计费费率。它会在检查之前将分辨率转换为大写并转发该大写值,对于不在此枚举范围内的值返回 400;对于上文列出的不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,无论是以分辨率还是以 480P 尺寸发送 480P,都会返回 400。 +- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +该代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它在检查前会先将 resolution 转为大写,并转发大写形式的值;对于超出该枚举范围的取值返回 400,并且对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,会针对 480P 返回 400(无论是以 resolution 还是以 480P 的 size 形式发送)。 - 可能的值:`480P`、`720P`、`1080P` + 可选值:`480P`、`720P`、`1080P` @@ -387,27 +332,28 @@ Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体 - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 - single: 单镜头视频(默认) - multi: 多镜头视频 - 可能的值:`multi`、`single` + 可选值:`multi`、`single` - 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: -对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(无 480P): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -当同时发送尺寸和分辨率时,由尺寸决定计费档位,并且分辨率仍必须是该代理针对该模型接受的值。对于分辨率说明中列为不支持 480P 的每个模型,480P 尺寸都会返回 400。 + 视频分辨率,格式为 宽*高。支持的分辨率因模型而异: +wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +wan2.6 T2V/R2V(无 480P): + 720P:1280*720、720*1280、960*960、1088*832、832*1088 + 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是该代理针对该模型接受的取值。对于分辨率描述中列为不支持 480P 的每个模型,480P 的 size 都会返回 400。 - 是否添加水印标志,水印位于右下角 + 是否添加水印 logo,水印位于右下角 -由 Router 在 `GET /v2/models/wan/wan2.7-i2v/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 +本页内容根据 Router 在 `GET /v2/models/wan/wan2.7-i2v/openapi.json` 提供的 schema 生成,该文档也正是它在请求到达提供商之前校验调用时所依据的同一份文档。 ### 输出 @@ -416,11 +362,11 @@ Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体 - 智能改写后的实际提示词(适用于视频任务) + 智能改写后的实际提示词(视频任务) - 带有音频生成的 I2V 任务的音频网址 + 带音频生成的 I2V 任务的音频 URL @@ -432,11 +378,11 @@ Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体 - 有关失败请求的详细信息(请求成功时不返回) + 失败请求的详细信息(请求成功时不返回) - 原始输入提示词(适用于视频任务) + 原始输入提示词(视频任务) @@ -460,7 +406,7 @@ Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体 - 已生成图像的图片网址 + 已生成图像的 URL 地址 @@ -498,7 +444,7 @@ Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体 - 已完成的视频生成任务的视频网址。链接有效期为 24 小时 + 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 @@ -554,11 +500,11 @@ Comfy,并且还会遇到一个传输上限:Comfy Router 的 POST 请求体 - 失败请求的错误码,报告在响应信封的 ROOT 层级,而不是 `output` 下(请求成功时不返回)。 + 失败请求的错误码,位于响应封装结构的根层级,而不是 `output` 下(请求成功时不返回)。 - 有关失败请求的详细信息,报告在响应信封的 ROOT 层级,而不是 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,位于响应封装结构的根层级,而不是 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index 8cc7b4b5e5..55ac85956b 100644 --- a/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -14,6 +14,7 @@ translationBlockHashes: + {/* 生成文件。请编辑本目录下的 code.yaml 并运行 `pnpm code-pages:gen`。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; diff --git a/zh/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/zh/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index e23e00aaf5..604224e8aa 100644 --- a/zh/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/zh/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -2,18 +2,19 @@ title: "将 Wan 3.0 Video Prime 与 Comfy Router 配合使用" description: "通过 Comfy Router 以 HTTP 方式调用 wan/wan3.0-video-prime 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果形状" sidebarTitle: "Wan 3.0 Video Prime" -translationSourceHash: 63c2c33a +translationSourceHash: 1fc83550 translationFrom: development/comfy-router/models/wan/wan3-0-video-prime/code.mdx translationBlockHashes: "_intro": 812fcd16 "Quick start": 1ae93564 - "Schema": 8f9dbbd5 + "Schema": d589709d "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -186,73 +187,79 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video-prime/requests/$REQUEST_ID - 音频文件下载链接。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 - 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。 -happyhorse-1.x 的 i2v 拼写不在这里传入首帧,而是将其作为 type 为 first_frame 的媒体元素传入 -(见下文 media),并且在 wan2.6-i2v 上可以成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 -happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 的拼写同样在 media 中传入其参考资产。 -图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。 +happyhorse-1.x 的 i2v 拼写不在此处接收首帧,而是将其作为类型为 first_frame 的媒体元素接收 +(见下方 media);此外,在 wan2.6-i2v 上能成功的 img_url 请求体,在 +happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;而 wan2.7/wan3.0 的拼写同样在 +media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 +分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。用于指定视频生成的参考素材(图像、音频、视频)。每个元素包含一个 type 和一个 -url 字段。该字段由本组件所服务的每个模型共享,而某个给定模型接受哪些 type 值,以及它究竟是 -在这里还是在 img_url 或 reference_video_urls 中携带图像或视频输入,都因模型而异。各模型支持的 -type 值如下: + 媒体资产列表。为视频生成指定参考素材(图像、音频、视频)。每个元素包含 type 和 url +字段。该字段由本组件提供的所有模型共享,而某个模型接受哪些 type 值,以及它究竟在此处 +还是在 img_url 或 reference_video_urls 中携带其图像或视频输入,都因模型而异。按模型 +列出的受支持 type 值如下: - wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB, - 可以是公开 URL 或 data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 - 像素,最大 100MB):公开的 HTTP/HTTPS URL;不接受内联的 data: URL。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 - reference_image 或 reference_video,且参考图像加参考视频合计最多 5 个。first_frame 和 - reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 - 8:1 之间,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。reference_video: - 公开的 HTTP/HTTPS URL;不接受内联的 data: URL。 -- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素, - 最大 100MB,公开的 HTTP/HTTPS URL;不接受内联的 data: URL),外加可选的 0 到 4 个 - reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间, - 最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL)。 + last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间, + 最大 20MB,可使用公开 URL 或 data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒, + 每边 240-4096 像素,最大 100MB):必须是公开的 HTTP/HTTPS URL;不接受内联 + data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 + 需要一个 reference_image 或 reference_video,并且参考图像加参考视频总共最多 5 个。 + first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 + 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可使用公开 URL 或 + data:\{MIME_type};base64,... URL。reference_video:公开的 HTTP/HTTPS URL;不接受 + 内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, + 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: URL) + 加上可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可使用公开 URL + 或 data:\{MIME_type};base64,... URL)。 - wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link 一起使用)、 - link(最多 1 个,不能与 file 一起使用)。在同一请求中,reference_*/file/link 类型与 - first_frame/last_frame 类型互斥。数组顺序定义了提示词中资产的参考顺序(Image 1, Video 1, - Audio 1, ...)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 - 240-8000 像素,宽高比最大 8:1,最大 20MB,可以是公开 URL 或 - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公开的 - HTTP/HTTPS URL;不接受内联的 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写的首帧是在这里 - 传入的,而不是在 img_url 中传入。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间, - JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的 - 参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,可以是公开 URL 或 - data:\{MIME_type};base64,... URL。reference_video 不是该操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,最长边 - 最多 4096 像素,最短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 - HTTP/HTTPS URL;不接受内联的 data: URL),外加可选的 0 到 5 个 reference_image - (JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB, - 可以是公开 URL 或 data:\{MIME_type};base64,... URL)。 + reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 link + 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link 类型 + 与 first_frame/last_frame 类型在同一请求内互斥。 + 数组顺序决定提示词中资产的参考顺序(Image 1、Video 1、 + Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可使用公开 URL 或 + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link: + 公开的 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写 + 在此处接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可使用公开 URL 或 + data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 + 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, + 最大 20MB,可使用公开 URL 或 data:\{MIME_type};base64,... URL。reference_video + 不是此操作的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 + 秒,长边最大 4096 像素,短边至少 360 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS URL;不接受内联 data: + URL)加上可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 + 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可使用公开 URL + 或 data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其对应的合作伙伴参考文档未记录任何媒体输入,因此请不要设置该字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些拼写枚举任何 media 词汇。 - wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入首帧;wan2.6-r2v 在 - reference_video_urls 中传入其参考片段。 -上面按模型列出的数量是合作伙伴的限制,而不是本 schema 的限制:media 上未声明任何 -minItems/maxItems,因为可接受的类型及其上限因模型而异。接受 schema 并不代表提供商接受; -反过来说,上面每个资产“最多 20MB”的数字(即图像输入的上限,而图像输入是唯一可以内联发送的 -输入)是合作伙伴对其最终获得资产的上限,当资产是公开 URL 时这些限制按字面生效,因为那些字节 -从不经过 Comfy。内联的 data:\{MIME_type};base64,... URL 则确实会经过 Comfy,并且还会遇到传输 -上限:Comfy Router 的 POST 请求体总量上限为 100 MiB,超过则返回 413,而 base64 会将负载膨胀约 -4/3,因此单个超过约 75 MB 的内联资产会在触及这里任何合作伙伴规则之前就被拒绝。在这一大小下, -单个资产按合作伙伴自身的 -20MB 上限能轻松容纳内联内容,因此对于单个资产而言,起约束作用的是合作伙伴规则; -而当涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是 -整个请求,而不是其中的每个元素。凡接近这些上限的内容,请以 -公开 URL 的形式发送。 + 文生视频操作。其对应的合作伙伴参考文档未记录任何媒体输入,因此请勿设置 + 此字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些拼写枚举任何 media + 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧; + wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 +上表中按模型列出的计数是合作伙伴的约束,而不是本 schema 的约束:media 上没有 +声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。被 schema 接受并不意味着 +被提供商接受;反过来说,上述每个资产"最大 20MB"的数字,即图像输入的上限,也是唯一 +可以内联发送的输入,是合作伙伴对其最终拿到的资产的上限,并且当资产是公开 URL 时, +这些数字按字面生效,因为这些字节从不经过 Comfy。内联 data:\{MIME_type};base64,... +URL 确实会经过 Comfy,并且还会遇到传输层上限:Comfy Router 的 +POST 请求体总计上限为 100 MiB,超过即返回 413;而 base64 会使 +载荷膨胀约 4/3,因此单个内联资产超过大约 75 MB 时,会在触及此处任何 +合作伙伴规则之前就被拒绝。在这个尺寸下,单个资产即便符合合作伙伴自身的20MB 的上限对内联而言完全够用,因此对于单个资产来说,真正起约束作用的是合作伙伴规则;而传输上限则在同时有多个资产时生效,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。凡是接近这些上限的内容,请以公共 URL 的形式发送。 @@ -262,40 +269,35 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。接受 - 媒体文件的 URL:公开的 HTTP/HTTPS URL,或者(仅限上文 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image)内联的 `data:{MIME_type};base64,...` URL。以上任何模型上的 video、audio、file 或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能对上传它的阿里云账号解析;Comfy 使用自己的密钥发起模型调用,不暴露任何上传路径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此这类值会被原样转发给合作伙伴,而不会在此处被拒绝。有关各模型的大小和像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:一个公共 HTTP/HTTPS URL,或者(仅限上文 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image)一个内联的 `data:{MIME_type};base64,...` URL。在这些模型上,任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能在执行上传的阿里云账号下解析;Comfy 使用自己的密钥发起模型调用,并不对外暴露上传路由,因此调用方自有的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL scheme,因此此类值会被原样转发给合作伙伴,而不是在此处被拒绝。关于各模型的大小和像素限制,以及从整体上约束内联负载的 100 MiB Router 请求体上限,请参见 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中看到的内容 + 反向提示词用于描述你不希望在视频画面中出现的内容。超过 500 个字符时,wan 模型会将其截断,而不是拒绝它。它与 prompt 计入相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代 -主体。示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请按媒体数组中的对应顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代 -媒体资产。 + 文本提示词。支持中文和英文。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。使用 'Image 1'、'Video 1'、'Audio 1' 等来按 media 数组中的对应顺序引用媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。包含 1-3 个视频 URL 的数组。 输入限制: -- 格式:mp4、mov +- 格式:mp4, mov - 数量:1-3 个视频 -- 单个视频长度:2-30 秒 +- 单个视频时长:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最多 5s,两个视频各最多 2.5s,三个视频按比例更短。 -计费:按实际使用的参考时长计费。 +参考时长:单个视频最大 5 秒,两个视频各最大 2.5 秒,三个视频则按比例更短。 +计费:基于实际使用的参考时长。 - 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 - 要调用的模型 ID。此组件上不做约束:Comfy Router 从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方可省略该字段。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起的 v1 调用则必须提供它,可接受拼写的枚举定义在该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方应省略此字段。 @@ -303,7 +305,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。接受 - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;对于其他 wan 模型,提供商未记录此类切换开关。 + 是否向视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商并未为其他 wan 模型记载此类开关。 @@ -318,12 +320,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。接受 生成的视频时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) +- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) - wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 - wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + - 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型挑选合适的时长 -对于超出 [-1, 30] 范围的时长,此代理会返回 400。 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +此代理对超出 [-1, 30] 范围的 duration 返回 400。 范围:`-1` 到 `30` @@ -334,9 +335,8 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。接受 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐 -合适的宽高比。 +对于 wan2.7 模型,若未提供则根据分辨率档位设置默认值。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -349,45 +349,40 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。接受 - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P -此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定 -计费费率。它会在检查之前将 -resolution 转换为大写并转发大写后的值,对于超出此枚举的值返回 400,并且对于上文 -列出的不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,会返回 400(无论是作为 -resolution 还是作为 480P 的 size 发送)。 +此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查前将 resolution 转为大写并转发大写后的值,返回 400值超出此枚举范围时会报错,并且在上面列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型上,对 480P(无论以 resolution 还是以 480P 尺寸的形式发送)返回 400。 - 可选值:`480P`、`720P`、`1080P` + 可能的值:`480P`、`720P`、`1080P` 随机数种子,用于控制模型生成内容的随机性 - 取值范围:`0` 到 `2147483647` + 范围:`0` 到 `2147483647` - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 -- single:单镜头视频(默认) -- multi:多镜头视频 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 +- single: 单镜头视频(默认) +- multi: 多镜头视频 - 可选值:`multi`、`single` + 可能的值:`multi`、`single` 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: -wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -wan2.6 T2V/R2V(不支持 480P): +对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +对于 wan2.6 T2V/R2V(不支持 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时发送 size 和 resolution 时,由 size 决定计费档位,而 -resolution 仍必须是此代理为该模型接受的值。若 size 为 480P,则在上文 resolution -描述中列出不支持 480P 的每个模型上都会返回 400。 +当同时发送 size 和 resolution 时,size 决定计费档位,而 resolution 仍必须是该代理为相应模型接受的值。对于分辨率描述中列为不支持 480P 的每个模型,传入 480P 尺寸都会返回 400。 - 是否添加水印 logo,水印位于右下角 + 是否添加水印标志,水印位于右下角 -本文档根据 Router 在 `GET /v2/models/wan/wan3.0-video-prime/openapi.json` 提供的 schema 生成,也就是请求到达提供商之前 Router 用于校验调用的同一份文档。 +本文档根据 Router 在 `GET /v2/models/wan/wan3.0-video-prime/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用时所使用的同一份文档。 ### 输出 @@ -396,11 +391,11 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 经智能改写后的实际提示词(用于视频任务) + 经过智能改写后的实际提示词(用于视频任务) - 带音频生成的 I2V 任务的音频网址 + 带音频生成的 I2V 任务的音频链接 @@ -420,11 +415,11 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 图像生成任务的结果列表 + 图像生成任务的任务结果列表 - 经智能改写后的实际提示词(如果已启用) + 经过智能改写后的实际提示词(若已启用) @@ -440,7 +435,7 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 已生成图像的 URL 地址 + 已生成图像的网址 @@ -456,7 +451,7 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 图像生成任务的结果统计 + 图像生成任务的任务结果统计 @@ -478,11 +473,11 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 已完成的视频生成任务的视频 URL。链接有效期 24 小时 + 已完成的视频生成任务的视频链接。链接有效期为 24 小时 - 唯一请求标识符 + 唯一请求标识 @@ -490,11 +485,11 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 视频分辨率等级(I2V 和 wan3.0-video 任务) + 视频分辨率档位(I2V 与 wan3.0-video 任务) - 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) + 已生成视频的时长,单位为秒(I2V 与 wan3.0-video 任务) @@ -502,11 +497,11 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 已生成图像的数量(T2I 和 I2I 任务) + 已生成图像的数量(T2I 与 I2I 任务) - 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒,无视频输入时为 0.0(wan3.0-video 任务) @@ -514,11 +509,11 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 已生成视频的宽高比,例如 16:9(wan3.0-video 任务) + 已生成视频的比例,例如 16:9(wan3.0-video 任务) - 图像分辨率(T2I 和 I2I 任务) + 图像分辨率(T2I 与 I2I 任务) @@ -534,11 +529,11 @@ resolution 仍必须是此代理为该模型接受的值。若 size 为 480P, - 失败请求的错误码,返回在信封的根层级,而非 `output` 下(请求成功时不返回)。 + 失败请求的错误码,在响应信封的根层级报告,而不是在 `output` 下报告(请求成功时不返回)。 - 失败请求的详细信息,返回在信封的根层级,而非 `output` 下(请求成功时不返回)。在改用 `output.message` 之前,请先阅读此项。 + 失败请求的详细信息,在响应信封的根层级报告,而不是在 `output` 下报告(请求成功时不返回)。在回退读取 `output.message` 之前请先读取此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan3-0-video/code.mdx b/zh/development/comfy-router/models/wan/wan3-0-video/code.mdx index 41369ec69f..abe1de39fa 100644 --- a/zh/development/comfy-router/models/wan/wan3-0-video/code.mdx +++ b/zh/development/comfy-router/models/wan/wan3-0-video/code.mdx @@ -2,19 +2,20 @@ title: "通过 Comfy Router 使用 Wan 3.0 Video" description: "通过 Comfy Router 以 HTTP 方式调用 wan/wan3.0-video 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果的形状" sidebarTitle: "Wan 3.0 Video" -translationSourceHash: 75a2a69d +translationSourceHash: b17ea6e7 translationFrom: development/comfy-router/models/wan/wan3-0-video/code.mdx translationBlockHashes: "_intro": 352f7edf "Quick start": a6cbe623 "Serving providers": 1e291df8 - "Schema": 133669ca + "Schema": 44f84073 "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -224,61 +225,108 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x i2v 这些拼写不在此处接收其首帧:它们将其作为 type 为 first_frame 的媒体元素接收(见下方 media)。在 wan2.6-i2v 上成功的 img_url 请求体会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 这些拼写也在 media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像的网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。 +happyhorse-1.x i2v 这些写法不在此处接收首帧:它们将首帧作为类型为 first_frame 的媒体元素传入(见下文 media),并且一个在 wan2.6-i2v 上能够成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 这些写法同样在 media 中传入参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 +分辨率:360-2000 像素。文件大小:最大值 10MB。 - 媒体资产列表。指定用于视频生成的参考资料(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由此组件提供的每个模型共享,而给定模型接受哪些 type 值,以及它是将图像或视频输入放在此处而不是放在 img_url 或 reference_video_urls 中,都因模型而异。各模型支持的 type 值: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。driving_audio(WAV/MP3,2-30 秒,最多 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最多 100MB):公开 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- wan2.7-r2v:first_frame(可选,最大值 1)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,且参考图像加参考视频总共最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- wan2.7-videoedit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最多 100MB,公开 HTTP/HTTPS 网址;不接受内联 data: 网址),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最多 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最大值 1)、last_frame(最大值 1)、reference_image(最大值 10)、reference_video(最多 5 个片段,总时长 \<= 15 秒)、reference_audio(最多 5 个片段,总时长 \<= 15 秒)、file(最大值 1,不能与 link 一起使用)、link(最大值 1,不能与 file 一起使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定提示中资产的参考顺序(Image 1、Video 1、Audio 1、...)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最多 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link:公开 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些拼写在此处接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最多 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最多 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。reference_video 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最多 100MB,公开 HTTP/HTTPS 网址;不接受内联 data: 网址),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最多 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记录任何媒体输入,因此请不要设置此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件并未为这些拼写枚举任何媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上述各模型的数量是合作伙伴的约束,而非本 schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受。反过来说,上述每个资产的“最多 20MB”数值(图像输入的上限,也是唯一可以内联发送的输入)是合作伙伴对其最终获得的资产所设的上限,当资产是公开网址时,这些数值按字面适用,因为这些字节从不经过 Comfy。内联 data:\{MIME_type};base64,... 网址确实会经过 Comfy,并且也会遇到传输上限:Comfy Router POST 请求体总计上限为 100 MiB,超过则返回 413,而 base64 会使负载膨胀约 4/3,因此任何单个内联资产只要超过约 75 MB,就会在触达此处任何合作伙伴规则之前被拒绝。在该大小下,单个资产在合作伙伴自身的20MB 上限可轻松容纳内联数据,因此对于单个资产而言,真正起约束作用的是合作伙伴规则;而在多个资产的情况下,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,请以公开 URL 的形式发送。 + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。该字段由本组件提供的所有模型共享,而某个具体模型接受哪些 type 值,以及它是否把图像或视频输入放在这里而不是放在 img_url 或 reference_video_urls 中,都因模型而异。各模型支持的 type 值如下: + +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 + last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 + 到 8:1 之间,最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 + 秒,每边 240-4096 像素,最大 100MB):公开 HTTP/HTTPS URL;不接受内联 + data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 + 需要 1 个 reference_image 或 reference_video,且参考图像加 + 参考视频总计不超过 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP + (无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 + 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video:公开 + HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, + 每边 240-4096 像素,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: URL) + 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开 URL + 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 + reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 + reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能与 + link 一起使用)、link(最多 1 个,不能与 file 一起使用)。在同一次请求中, + reference_*/file/link 类型与 first_frame/last_frame 类型互斥。数组 + 顺序定义了提示词中资产的参考顺序(Image 1、Video 1、 + Audio 1、……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, + 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公开 URL 或 + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link: + 公开 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些写法 + 在此处接收首帧,而不是在 img_url 中接收。至少 300x300 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开 URL 或 + data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 + 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, + 最大 20MB,公开 URL 或 data:\{MIME_type};base64,... URL。reference_video + 不是此操作的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 + 秒,长边最大 4096 像素,短边至少 360 像素,宽高比 + 在 1:2.5 到 2.5:1 之间,最大 100MB,公开 HTTP/HTTPS URL;不接受内联 data: + URL)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 + 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公开 URL + 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: + 文生视频操作。其对应文档未记录任何媒体输入,因此请将该字段留空。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件没有为这些写法列举任何媒体 + 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧; + wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 + +上文中按模型给出的数量是合作伙伴的约束,而非本 Schema 的约束:media 上未声明 +minItems/maxItems,因为每个模型允许的类型及其上限各不相同。Schema 接受并不 +意味着提供商接受。反过来说,上文每项资产“最大 20MB”的数值(这是图像输入的上限, +而图像是唯一可以内联发送的输入)是合作伙伴对其最终获得的资产设定的上限,当资产 +是公开 URL 时,这些数值按原样适用,因为这些字节从不经过 Comfy。内联的 +data:\{MIME_type};base64,... URL 则会经过 Comfy,同时还要面对传输层上限:Comfy Router +POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会让负载膨胀约 4/3, +因此单个内联资产只要超过约 75 MB,就会在触达此处任何合作伙伴规则之前被拒绝。 +在这种大小下,单个资产按合作伙伴自身的20MB 的上限可以轻松容纳内联内容,因此对于单个资产,起约束作用的是合作伙伴规则。传输上限会约束多个资产,因为 100 MiB 的 Router 上限限制的是整个请求,而不是每个元素。接近这些上限的任何内容,请以公共 URL 发送。 媒体资产类型 - 可选值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - 媒体文件的 URL:一个公开的 HTTP/HTTPS URL;或者,仅针对上文 `media` 描述为各模型列出的 IMAGE 输入(wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image),也可以是一个内联的 `data:{MIME_type};base64,...` URL。这些模型中,任何 video、audio、file 或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或者(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的阿里云账号解析;Comfy 使用自己的密钥发起模型调用且不提供上传路由,因此调用方自己的 oss:// URL 或 asset_id 并非受支持的输入。此字段不校验 URL 协议,因此这样的值会原样转发给合作伙伴,而不会在此处被拒绝。有关各模型的大小和像素限制,以及以整体方式约束内联负载的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:公共 HTTP/HTTPS URL,或者,仅对于上文 `media` 描述中为各模型列出的那些图像输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image,则为内联的 `data:{MIME_type};base64,...` URL。这些模型上的任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自己的上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能在上传它的阿里云账户下解析;Comfy 使用自己的密钥发起模型调用,并且不暴露上传路由,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不会校验 URL scheme,因此此类值会按原样转发给合作伙伴,而不是在此处被拒绝。有关每个模型的大小和像素限制,以及会从总体上限制内联负载的 100 MiB Router 请求体上限,请参阅 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中出现的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符时,Wan 模型会截断它,而不是拒绝它。它与 prompt 计入相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于带有多个参考视频的 wan2.6-r2v,请使用 'character1'、'character2' 等,按参考视频的顺序来指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,来指代 media 数组中对应顺序的媒体资产。 + 文本提示词。支持中文和英文。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。使用“Image 1”“Video 1”“Audio 1”等按 media 数组中的对应顺序引用媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅适用于 wan2.6-r2v 模型的参考视频 URL。由 1 到 3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov -- 数量:1-3 个视频 -- 单个视频长度:2-30 秒 +- 数量:1 到 3 个视频 +- 单个视频长度:2 到 30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 一起使用 参考时长:单个视频最大 5 秒,两个视频各最大 2.5 秒,三个视频按比例更短。 -计费:按实际使用的参考时长计算。 +计费:基于实际使用的参考时长。 - 视频效果模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 - 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供它,其可接受拼写的枚举定义在该操作自己的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件不约束该字段:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 @@ -286,15 +334,15 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 是否为视频添加音频。仅支持 wan3.0-video 和 wan3.0-video-prime;提供商未为其他 wan 模型记录此类切换。 + 是否向视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未记录其他 Wan 模型的此类切换项。 wan2.7-videoedit 模型的视频音频设置。 - auto(默认):模型根据提示词内容智能判断 -- origin:强制保留输入视频中的原始音频 +- origin:强制保留输入视频的原始音频 - 可选值:`auto`、`origin` + 可能的值:`auto`、`origin` @@ -304,8 +352,8 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) - wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 - wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频时长与输出视频时长之和不得超过 30 秒;-1 会启用智能时长模式,由模型选择合适的时长 -当时长超出 [-1, 30] 范围时,该代理会返回 400。 +- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 +此代理对超出 [-1, 30] 范围的时长返回 400。 范围:`-1` 到 `30` @@ -316,10 +364,10 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ 已生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 +对于 wan2.7 模型,如果未提供,则根据分辨率档位使用默认值。 对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 - 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -327,43 +375,44 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - wan2.5-i2v-preview:480P、720P、1080P - wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(上游默认 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P -- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P - -该代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定了计费费率。它会在检查之前将 resolution 转为大写,并转发大写后的值;对于超出该枚举范围的值返回 400;对于上文中列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,请求 480P(无论以 resolution 还是以 480P 的 size 发送)时返回 400。 +- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费率。它会在检查前将 resolution 转为大写,并转发转为大写后的值,返回 400对于此枚举之外的值,并在上述列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型上,对 480P(无论是以 resolution 还是以 480P 的 size 发送)返回 400。 - 可选值: `480P`, `720P`, `1080P` + 可能的值:`480P`、`720P`、`1080P` 随机数种子,用于控制模型生成内容的随机性 - 范围: `0` 到 `2147483647` + 范围:`0` 到 `2147483647` - 智能多镜头控制。仅在启用 prompt_extend 时生效。适用于 wan2.6 和 wan2.7-r2v 模型。 -- single: 单镜头视频(默认) -- multi: 多镜头视频 + 智能多镜头控制。仅在启用 prompt_extend 时生效。 +适用于 wan2.6 和 wan2.7-r2v 模型。 +- single:单镜头视频(默认) +- multi:多镜头视频 - 可选值: `multi`, `single` + 可能的值:`multi`、`single` - 视频分辨率,格式为 width*height。支持的分辨率因模型而异: + 视频分辨率,格式为宽度*高度。支持的分辨率因模型而异: 对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 对于 wan2.6 T2V/R2V(无 480P): - 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 - 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -当同时发送 size 和 resolution 时,由 size 决定计费档位,而 resolution 仍必须是该代理针对该模型接受的值。在任何被 resolution 描述列为不支持 480P 的模型上,480P 的 size 都会返回 400。 + 720P:1280*720、720*1280、960*960、1088*832、832*1088 + 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 +当同时发送 size 和 resolution 时,size 决定计费档位,而 +resolution 仍必须是此代理针对该模型接受的值。对于 resolution 描述中列为不支持 480P 的每个模型,480P 的 size 会返回 400。 是否添加水印标识,水印位于右下角 -由 Router 在 `GET /v2/models/wan/wan3.0-video/openapi.json` 提供的 schema 生成,该 schema 也是它在请求到达提供商之前用于校验调用的同一份文档。 +本文档根据 Router 在 `GET /v2/models/wan/wan3.0-video/openapi.json` 提供的 schema 生成,该 schema 也是其在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -376,7 +425,7 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 带音频生成的 I2V 任务的音频 URL + 启用音频生成的 I2V 任务的音频网址 @@ -396,11 +445,11 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 图像生成任务的结果列表 + 图像生成任务的任务结果列表 - 智能改写后的实际提示词(若已启用) + 智能改写后的实际提示词(如果启用) @@ -432,15 +481,15 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 图像生成任务的结果统计 + 图像生成任务的任务结果统计 - 失败的任务数 + 失败任务数 - 成功的任务数 + 成功任务数 @@ -450,15 +499,15 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ 任务状态 - 可能的取值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频 URL。链接有效期 24 小时 + 已完成的视频生成任务的视频网址。链接有效期为 24 小时 - 唯一的请求标识符 + 唯一请求标识符 @@ -466,11 +515,11 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 视频分辨率等级(I2V 与 wan3.0-video 任务) + 视频分辨率级别(I2V 和 wan3.0-video 任务) - 已生成视频的时长,单位为秒(I2V 与 wan3.0-video 任务) + 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) @@ -478,11 +527,11 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 已生成图像的数量(T2I 与 I2I 任务) + 已生成图像的数量(T2I 和 I2I 任务) - 输入视频的时长,单位为秒,无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) @@ -494,7 +543,7 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 图像分辨率(T2I 与 I2I 任务) + 图像分辨率(T2I 和 I2I 任务) @@ -510,11 +559,11 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video/requests/$REQUEST_ID \ - 失败请求的错误码,在响应信封的根层级而非 `output` 下返回(请求成功时不返回)。 + 失败请求的错误码,报告在响应结构的根层级,而不是在 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,在响应信封的根层级而非 `output` 下返回(请求成功时不返回)。在回退到 `output.message` 之前请先读取此项。 + 失败请求的详细信息,报告在响应结构的根层级,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此内容。 ## 示例 diff --git a/zh/development/comfy-router/providers.mdx b/zh/development/comfy-router/providers.mdx index 98a6d91e72..7b7120e2ed 100644 --- a/zh/development/comfy-router/providers.mdx +++ b/zh/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 服务提供商" sidebarTitle: "服务提供商" description: "查看每个 Comfy Router 模型可由哪些提供商提供服务,以及如何选择备用提供商。" -translationSourceHash: fb34b140 +translationSourceHash: 2e5f5f1e translationFrom: development/comfy-router/providers.mdx --- From 651e657406a2dd261e8d26ea1463c2b0facc59c8 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 11:57:30 +0800 Subject: [PATCH 03/36] i18n(es): sync Comfy Router pages with upstream/main (2026-11-10) --- es/development/comfy-router/models.mdx | 120 +++- .../google/gemini-2-5-flash-image/code.mdx | 19 +- .../google/gemini-nano-banana-2-1/code.mdx | 13 +- .../models/google/nano-banana-2/code.mdx | 14 +- .../models/google/nano-banana-pro/code.mdx | 10 +- .../models/kling/kling-4-0/code.mdx | 450 +++++++++++++++ .../models/kling/kling-v2-5-turbo/code.mdx | 23 +- .../models/luma/photon-1/code.mdx | 9 +- .../models/luma/photon-flash-1/code.mdx | 7 +- es/development/comfy-router/reference.mdx | 544 ++++++++++-------- 10 files changed, 913 insertions(+), 296 deletions(-) create mode 100644 es/development/comfy-router/models/kling/kling-4-0/code.mdx diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 932c53a9e1..196e518a2e 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Modelos de Comfy Router" sidebarTitle: "Todos los modelos" description: "Todos los modelos disponibles en Comfy Router, agrupados por proveedor, con su modalidad de entrada y salida." -translationSourceHash: d299c0f0 +translationSourceHash: 947ab0cb translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 5ddf7991 + "Find by output": 47e9d047 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -15,12 +15,12 @@ translationBlockHashes: "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 - "Gemini Interactions": ca46b908 + "Gemini Interactions": 38163caf "Google": 4932820b "HeyGen": 76fe1a0d "Higgsfield": 0ce2b918 "Ideogram": c22a0e5e - "Kling": 3002befa + "Kling": aec38bcd "Krea": 16b83e5e "LTX": 32595bf9 "Luma": 8cd2a7ce @@ -28,13 +28,14 @@ translationBlockHashes: "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 - "OpenAI": 5bbf3b2c + "OpenAI": 8652024f "Openrouter": a4f6806b - "Pika": 8b17ff30 + "Pika": 0cc24098 "Pruna": 903d76ee "Qwen": b3ef78a1 "Recraft": 02b7d9cd "Runway": be098f8c + "Stability": a3bcfddd "Synclabs": 12e79a66 "Tencent": c17946d6 "Veed": c17fdba2 @@ -45,6 +46,7 @@ translationBlockHashes: --- + {/* ARCHIVO GENERADO. Generado a partir del catálogo del Router por `pnpm code-pages:gen`. */} Todos los modelos que aparecen a continuación se sirven por la misma ruta, `POST /v2/models/{provider}/{model}`, con el cuerpo JSON propio del modelo. Cada página muestra una solicitud funcional en Python, TypeScript y cURL. Para descubrimiento, esquemas, errores, reintentos y facturación, consulta [Usar la API de Comfy Router](/es/development/comfy-router/api). @@ -54,7 +56,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta ## Buscar por salida - + - [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [FLUX 3 Video](/es/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` @@ -75,10 +77,12 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [FLUX 3 Max](/es/development/comfy-router/models/fal/flux-3-max/code): `fal/flux-3-max` - [H3 Max Turbo](/es/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo` - [H3 Max](/es/development/comfy-router/models/fal/h3-max/code): `fal/h3-max` +- [Gemini Omni 1.2 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code): `gemini-interactions/gemini-omni-1.2-flash` - [Higgsfield Genjutsu Motion Transfer V1.0](/es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` - [Higgsfield Kling 3.4k](/es/development/comfy-router/models/higgsfield/higgsfield-kling-3-4k/code): `higgsfield/higgsfield-kling-3-4k` - [Higgsfield Kling 3 Pro](/es/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` - [Kling 3.0 Turbo](/es/development/comfy-router/models/kling/kling-3-0-turbo/code): `kling/kling-3.0-turbo` +- [Kling 4.0](/es/development/comfy-router/models/kling/kling-4-0/code): `kling/kling-4.0` - [Kling V2.5 Turbo](/es/development/comfy-router/models/kling/kling-v2-5-turbo/code): `kling/kling-v2-5-turbo` - [Kling V2.6](/es/development/comfy-router/models/kling/kling-v2-6/code): `kling/kling-v2-6` - [Kling V3 Omni](/es/development/comfy-router/models/kling/kling-v3-omni/code): `kling/kling-v3-omni` @@ -86,7 +90,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Kling Video O1](/es/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1` - [Videos Avatar Image 2video](/es/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` - [Videos Lip Sync](/es/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` -- [Videos Video Extend](/es/development/comfy-router/models/kling/videos-video-extend/code): `kling/videos-video-extend` - [LTX 2.5 Fast](/es/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/es/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/es/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` @@ -96,14 +99,16 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Video To Video](/es/development/comfy-router/models/moonvalley/video-to-video/code): `moonvalley/video-to-video` - [Pika 2.5 Image To Video](/es/development/comfy-router/models/pika/pika-2-5-image-to-video/code): `pika/pika-2.5-image-to-video` - [Pika 2.5 Text To Video](/es/development/comfy-router/models/pika/pika-2-5-text-to-video/code): `pika/pika-2.5-text-to-video` +- [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` +- [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` +- [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika Soundtrack](/es/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` - [P Video 2](/es/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/es/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/es/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [Clean Audio Video](/es/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/es/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [Lipsync 2.0](/es/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Fabric 1.0](/es/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`- [Lipsync 2.0](/es/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/es/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/es/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` - [Video Background Removal](/es/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` @@ -135,7 +140,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Grok Imagine Video](/es/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/es/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -157,8 +162,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/es/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` -- [Image Edit Remove Background Guided](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/es/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/es/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [Image Edit Replace Object By Text](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -200,14 +204,15 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` +- [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare` +- [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` - [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Qwen Image 3.0 Pro](/es/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/es/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/es/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` - [Recraft V3](/es/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` - [Recraft V4.1 Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` -- [Recraft V4.1 Pro](/es/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` -- [Recraft V4.1 Utility Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` +- [Recraft V4.1 Pro](/es/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro`- [Recraft V4.1 Utility Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code): `recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code): `recraft/recraftv4_1_utility_vector` - [Recraft V4.1 Utility](/es/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` @@ -220,6 +225,29 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Recraft V4 Styles](/es/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` - [Recraft V4](/es/development/comfy-router/models/recraft/recraftv4/code): `recraft/recraftv4` - [Gen 4 Image](/es/development/comfy-router/models/runway/gen4-image/code): `runway/gen4_image` +- [Control Sketch](/es/development/comfy-router/models/stability/control-sketch/code): `stability/control-sketch` +- [Control Structure](/es/development/comfy-router/models/stability/control-structure/code): `stability/control-structure` +- [Control Style Transfer](/es/development/comfy-router/models/stability/control-style-transfer/code): `stability/control-style-transfer` +- [Control Style](/es/development/comfy-router/models/stability/control-style/code): `stability/control-style` +- [Edit Erase](/es/development/comfy-router/models/stability/edit-erase/code): `stability/edit-erase` +- [Edit Inpaint](/es/development/comfy-router/models/stability/edit-inpaint/code): `stability/edit-inpaint` +- [Edit Outpaint](/es/development/comfy-router/models/stability/edit-outpaint/code): `stability/edit-outpaint` +- [Edit Remove Background](/es/development/comfy-router/models/stability/edit-remove-background/code): `stability/edit-remove-background` +- [Edit Replace Background And Relight](/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code): `stability/edit-replace-background-and-relight` +- [Edit Search And Recolor](/es/development/comfy-router/models/stability/edit-search-and-recolor/code): `stability/edit-search-and-recolor` +- [Edit Search And Replace](/es/development/comfy-router/models/stability/edit-search-and-replace/code): `stability/edit-search-and-replace` +- [Generate Core](/es/development/comfy-router/models/stability/generate-core/code): `stability/generate-core` +- [Generate Ultra](/es/development/comfy-router/models/stability/generate-ultra/code): `stability/generate-ultra` +- [Sd3.5 Flash](/es/development/comfy-router/models/stability/sd3-5-flash/code): `stability/sd3.5-flash` +- [Sd3.5 Large Turbo](/es/development/comfy-router/models/stability/sd3-5-large-turbo/code): `stability/sd3.5-large-turbo` +- [Sd3.5 Large](/es/development/comfy-router/models/stability/sd3-5-large/code): `stability/sd3.5-large` +- [Sd3.5 Medium](/es/development/comfy-router/models/stability/sd3-5-medium/code): `stability/sd3.5-medium` +- [Sdxl 1.0 Image To Image](/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code): `stability/sdxl-1.0-image-to-image` +- [Sdxl 1.0 Masking](/es/development/comfy-router/models/stability/sdxl-1-0-masking/code): `stability/sdxl-1.0-masking` +- [Sdxl 1.0 Text To Image](/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code): `stability/sdxl-1.0-text-to-image` +- [Upscale Conservative](/es/development/comfy-router/models/stability/upscale-conservative/code): `stability/upscale-conservative` +- [Upscale Creative](/es/development/comfy-router/models/stability/upscale-creative/code): `stability/upscale-creative` +- [Upscale Fast](/es/development/comfy-router/models/stability/upscale-fast/code): `stability/upscale-fast` - [Wan 2.5 I2I Preview](/es/development/comfy-router/models/wan/wan2-5-i2i-preview/code): `wan/wan2.5-i2i-preview` - [Wan 2.5 T2I Preview](/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` - [Seedvr 2](/es/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` @@ -230,13 +258,12 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Grok Imagine Image](/es/development/comfy-router/models/xai/grok-imagine-image/code): `xai/grok-imagine-image` - + - [FLUX 3 Video](/es/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` - [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` -- [Dreamina Seedance 2.0 Mini](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` -- [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` +- [Dreamina Seedance 2.0 Mini](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini`- [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/es/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/es/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` - [Seedance 1.5 Pro 251215](/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` @@ -256,6 +283,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [LTX 2.5 Fast](/es/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/es/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [MiniMax H3](/es/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` +- [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` +- [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` +- [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika Music](/es/development/comfy-router/models/pika/pika-music/code): `pika/pika-music` - [Pika Sfx](/es/development/comfy-router/models/pika/pika-sfx/code): `pika/pika-sfx` - [Pika Soundtrack](/es/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` @@ -278,7 +308,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Wan 3.0 Video](/es/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - + - [Animations](/es/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/es/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` @@ -286,13 +316,14 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Meshy 7](/es/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` - [Remesh](/es/development/comfy-router/models/meshy/remesh/code): `meshy/remesh` - [Rigging](/es/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` +- [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` +- [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` - [Hunyuan 3D Part](/es/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` - [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` -- [Hunyuan 3D Texture Edit](/es/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` -- [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` +- [Hunyuan 3D Texture Edit](/es/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit`- [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/es/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/es/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -310,6 +341,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Seed 2.0 Mini 260215](/es/development/comfy-router/models/byteplus/seed-2-0-mini-260215/code): `byteplus/seed-2-0-mini-260215` - [Seed 2.0 Pro 260328](/es/development/comfy-router/models/byteplus/seed-2-0-pro-260328/code): `byteplus/seed-2-0-pro-260328` - [Gemini Omni 1.1 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code): `gemini-interactions/gemini-omni-1.1-flash` +- [Gemini Omni 1.2 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code): `gemini-interactions/gemini-omni-1.2-flash` - [Gemini Omni Flash Preview](/es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code): `gemini-interactions/gemini-omni-flash-preview` - [Gemini 2.5 Flash Image](/es/development/comfy-router/models/google/gemini-2-5-flash-image/code): `vertexai/gemini-2.5-flash-image` - [Gemini 3.1 Flash Lite](/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code): `vertexai/gemini-3.1-flash-lite` @@ -466,6 +498,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | | [Gemini Omni 1.1 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code) | `gemini-interactions/gemini-omni-1.1-flash` | Texto, imagen, audio, video | Texto + imagen + audio | +| [Gemini Omni 1.2 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code) | `gemini-interactions/gemini-omni-1.2-flash` | Texto, imagen, audio, video | Texto + video | | [Gemini Omni Flash Preview](/es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code) | `gemini-interactions/gemini-omni-flash-preview` | Texto, imagen, audio, video | Texto + imagen + audio | ## Google @@ -510,15 +543,15 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | | [Kling 3.0 Turbo](/es/development/comfy-router/models/kling/kling-3-0-turbo/code) | `kling/kling-3.0-turbo` | Texto | Video | +| [Kling 4.0](/es/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | Texto, Imagen, Video | Video | | [Kling Image O1](/es/development/comfy-router/models/kling/kling-image-o1/code) | `kling/kling-image-o1` | Texto, Imagen | Imagen | -| [Kling V2.5 Turbo](/es/development/comfy-router/models/kling/kling-v2-5-turbo/code) | `kling/kling-v2-5-turbo` | Texto | Video | -| [Kling V2.6](/es/development/comfy-router/models/kling/kling-v2-6/code) | `kling/kling-v2-6` | Texto | Video | +| [Kling V2.5 Turbo](/es/development/comfy-router/models/kling/kling-v2-5-turbo/code) | `kling/kling-v2-5-turbo` | Imagen, Texto | Video | +| [Kling V2.6](/es/development/comfy-router/models/kling/kling-v2-6/code) | `kling/kling-v2-6` | Imagen, Texto | Video | | [Kling V3 Omni](/es/development/comfy-router/models/kling/kling-v3-omni/code) | `kling/kling-v3-omni` | Texto, Imagen, Video | Video | -| [Kling V3](/es/development/comfy-router/models/kling/kling-v3/code) | `kling/kling-v3` | Texto | Video | +| [Kling V3](/es/development/comfy-router/models/kling/kling-v3/code) | `kling/kling-v3` | Imagen, Texto | Video | | [Kling Video O1](/es/development/comfy-router/models/kling/kling-video-o1/code) | `kling/kling-video-o1` | Texto, Imagen, Video | Video | | [Videos Avatar Image 2video](/es/development/comfy-router/models/kling/videos-avatar-image2video/code) | `kling/videos-avatar-image2video` | Imagen, Audio | Video | | [Videos Lip Sync](/es/development/comfy-router/models/kling/videos-lip-sync/code) | `kling/videos-lip-sync` | Video, Audio | Video | -| [Videos Video Extend](/es/development/comfy-router/models/kling/videos-video-extend/code) | `kling/videos-video-extend` | Video, Texto | Video | ## Krea @@ -600,6 +633,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | Texto, Imagen | Imagen | | [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | Texto, Imagen | Imagen | | [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | Texto, Imagen | Imagen | +| [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | `openai/gpt-image-2.6-flare` | Texto, Imagen | Imagen | +| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | `openai/gpt-image-2.6-sunburst` | Texto, Imagen | Imagen | | [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | Texto, Imagen | Imagen | | [o3](/es/development/comfy-router/models/openai/o3/code) | `openai/o3` | Texto, Imagen | Texto | @@ -615,6 +650,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | --- | --- | --- | --- | | [Pika 2.5 Image To Video](/es/development/comfy-router/models/pika/pika-2-5-image-to-video/code) | `pika/pika-2.5-image-to-video` | Texto, Imagen | Video | | [Pika 2.5 Text To Video](/es/development/comfy-router/models/pika/pika-2-5-text-to-video/code) | `pika/pika-2.5-text-to-video` | Texto | Video | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | Texto, Imagen | Video + Audio | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | Texto, Imagen, Video, Audio | Video + Audio | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | Texto | Video + Audio | | [Pika Music](/es/development/comfy-router/models/pika/pika-music/code) | `pika/pika-music` | Texto, Audio | Audio | | [Pika Sfx](/es/development/comfy-router/models/pika/pika-sfx/code) | `pika/pika-sfx` | Texto | Audio | | [Pika Soundtrack](/es/development/comfy-router/models/pika/pika-soundtrack/code) | `pika/pika-soundtrack` | Video, Texto | Video + Audio | @@ -661,6 +699,36 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [Gen 4 Image](/es/development/comfy-router/models/runway/gen4-image/code) | `runway/gen4_image` | Texto, Imagen | Imagen | | [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | Imagen, Texto | Video | +## Stability + +| Modelo | ID | Entrada | Salida | +| --- | --- | --- | --- | +| [Control Sketch](/es/development/comfy-router/models/stability/control-sketch/code) | `stability/control-sketch` | Texto, Imagen | Imagen | +| [Control Structure](/es/development/comfy-router/models/stability/control-structure/code) | `stability/control-structure` | Texto, Imagen | Imagen | +| [Control Style Transfer](/es/development/comfy-router/models/stability/control-style-transfer/code) | `stability/control-style-transfer` | Texto, Imagen | Imagen | +| [Control Style](/es/development/comfy-router/models/stability/control-style/code) | `stability/control-style` | Texto, Imagen | Imagen | +| [Edit Erase](/es/development/comfy-router/models/stability/edit-erase/code) | `stability/edit-erase` | Imagen | Imagen | +| [Edit Inpaint](/es/development/comfy-router/models/stability/edit-inpaint/code) | `stability/edit-inpaint` | Texto, Imagen | Imagen | +| [Edit Outpaint](/es/development/comfy-router/models/stability/edit-outpaint/code) | `stability/edit-outpaint` | Texto, Imagen | Imagen | +| [Edit Eliminar fondo](/es/development/comfy-router/models/stability/edit-remove-background/code) | `stability/edit-remove-background` | Imagen | Imagen | +| [Edit Reemplazar fondo y reiluminar](/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code) | `stability/edit-replace-background-and-relight` | Texto, Imagen | Imagen | +| [Edit Buscar y recolorear](/es/development/comfy-router/models/stability/edit-search-and-recolor/code) | `stability/edit-search-and-recolor` | Texto, Imagen | Imagen | +| [Edit Buscar y reemplazar](/es/development/comfy-router/models/stability/edit-search-and-replace/code) | `stability/edit-search-and-replace` | Texto, Imagen | Imagen | +| [Generar Core](/es/development/comfy-router/models/stability/generate-core/code) | `stability/generate-core` | Texto | Imagen | +| [Generar Ultra](/es/development/comfy-router/models/stability/generate-ultra/code) | `stability/generate-ultra` | Texto, Imagen | Imagen | +| [Sd3.5 Flash](/es/development/comfy-router/models/stability/sd3-5-flash/code) | `stability/sd3.5-flash` | Texto, Imagen | Imagen | +| [Sd3.5 Large Turbo](/es/development/comfy-router/models/stability/sd3-5-large-turbo/code) | `stability/sd3.5-large-turbo` | Texto, Imagen | Imagen | +| [Sd3.5 Large](/es/development/comfy-router/models/stability/sd3-5-large/code) | `stability/sd3.5-large` | Texto, Imagen | Imagen | +| [Sd3.5 Medium](/es/development/comfy-router/models/stability/sd3-5-medium/code) | `stability/sd3.5-medium` | Texto, Imagen | Imagen | +| [Sdxl 1.0 Imagen a imagen](/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code) | `stability/sdxl-1.0-image-to-image` | Texto, Imagen | Imagen | +| [Sdxl 1.0 Masking](/es/development/comfy-router/models/stability/sdxl-1-0-masking/code) | `stability/sdxl-1.0-masking` | Texto, Imagen | Imagen | +| [Sdxl 1.0 Texto a imagen](/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code) | `stability/sdxl-1.0-text-to-image` | Texto | Imagen | +| [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code) | `stability/stable-fast-3d` | Imagen | 3D | +| [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code) | `stability/stable-point-aware-3d` | Imagen | 3D | +| [Upscale Conservative](/es/development/comfy-router/models/stability/upscale-conservative/code) | `stability/upscale-conservative` | Texto, Imagen | Imagen | +| [Upscale Creative](/es/development/comfy-router/models/stability/upscale-creative/code) | `stability/upscale-creative` | Texto, Imagen | Imagen | +| [Upscale Fast](/es/development/comfy-router/models/stability/upscale-fast/code) | `stability/upscale-fast` | Imagen | Imagen | + ## Synclabs | Modelo | ID | Entrada | Salida | diff --git a/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index 46a50bdb1c..985cb0a95c 100644 --- a/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -2,14 +2,16 @@ title: "Usa Gemini 2.5 Flash Image con Comfy Router" description: "Llama a vertexai/gemini-2.5-flash-image con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Gemini 2.5 Flash Image" -translationSourceHash: afd1374a +translationSourceHash: 9bd54fc7 translationFrom: development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx translationBlockHashes: "_intro": ac1aef55 "Quick start": 7ec68bbf + "Serving providers": beb2dd36 "Schema": f124875a "Examples": 19258aaa --- + {/* GENERATED FILE. Generado desde router-schemas/vertexai/gemini-2.5-flash-image.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -177,6 +179,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R +## Proveedores de servicio + +Comfy Router sirve este modelo directamente a menos que la solicitud indique otro proveedor. Los proveedores siguientes también lo sirven, en el mismo endpoint y con el mismo ID de modelo, y se seleccionan con el parámetro de consulta `model_provider`. + +- **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image` +- **MiniMax**, como `minimax/minimax-nano-banana`: `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image?model_provider=minimax` + +El valor predeterminado de `strict_mode` es falso, por lo que Router traduce el cuerpo nativo de la solicitud documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la Referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para ver todos los modelos enrutados de esta forma. + ## Esquema ### Entrada @@ -367,7 +378,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON para los parámetros de la función @@ -552,7 +565,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - La categoría de seguridad a la que aplica esta calificación. Para obtener más información sobre las categorías, consulta [SafetyCategory](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#safetycategory). + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx b/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx index 8744c232e6..ee72d5d4a7 100644 --- a/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx +++ b/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx @@ -2,14 +2,16 @@ title: "Usa Gemini Nano Banana 2.1 con Comfy Router" description: "Llama a vertexai/gemini-nano-banana-2.1 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Gemini Nano Banana 2.1" -translationSourceHash: 9e904f90 +translationSourceHash: 6f9161dd translationFrom: development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx translationBlockHashes: "_intro": 5cb6762b "Quick start": df454451 + "Serving providers": af126fd5 "Schema": 02b80e67 "Examples": dff3e9f8 --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-nano-banana-2.1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -177,6 +179,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R +## Proveedores de servicio + +Comfy Router sirve este modelo directamente, a menos que la solicitud nombre otro proveedor. Los proveedores siguientes también lo sirven, en el mismo endpoint y con el mismo ID de modelo, seleccionados con el parámetro de consulta `model_provider`. + +- **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1` +- **MiniMax**, como `minimax/minimax-nano-banana-2.1`: `POST https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1?model_provider=minimax` + +El valor predeterminado de `strict_mode` es `false`, así que Router traduce el cuerpo de solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para todos los modelos enrutados de esta forma. + ## Esquema ### Entrada diff --git a/es/development/comfy-router/models/google/nano-banana-2/code.mdx b/es/development/comfy-router/models/google/nano-banana-2/code.mdx index ce79a27f84..a3d2555b69 100644 --- a/es/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -2,16 +2,17 @@ title: "Usa Nano Banana 2 con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para generar imágenes con Nano Banana 2 (Gemini 3.1 Flash Image) a través de Comfy Router, y campos de la solicitud" sidebarTitle: "Nano Banana 2" -translationSourceHash: 29a236f1 +translationSourceHash: f8c4ed89 translationFrom: development/comfy-router/models/google/nano-banana-2/code.mdx translationBlockHashes: "_intro": e6f85ac2 "Quick start": 7fb17070 - "Serving providers": 5e97418c + "Serving providers": a9deb946 "Schema": 63c93920 "Examples": d294783d --- + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -211,15 +212,16 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R ## Proveedores de servicio -Este modelo es servida por Comfy Router directamente a menos que la solicitud nombre otro proveedor. Los proveedores a continuación también lo sirven, en el mismo endpoint y con el mismo ID de modelo, seleccionados con el parámetro de consulta `model_provider`. +Comfy Router sirve este modelo directamente, a menos que la solicitud indique otro proveedor. Los siguientes proveedores también lo sirven, en el mismo endpoint y con el mismo ID de modelo, y se seleccionan con el parámetro de consulta `model_provider`. - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image` - **fal**, como `fal/fal-nano-banana-2`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image?model_provider=fal` +- **MiniMax**, como `minimax/minimax-nano-banana-2`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image?model_provider=minimax` - **Pika**, como `pika/pika-nano-banana-2`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image?model_provider=pika` - **Runware**, como `runware/runware-nano-banana-2`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image?model_provider=runware` - **WaveSpeed**, como `wavespeed/wavespeed-nano-banana-2`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image?model_provider=wavespeed` -`strict_mode` tiene como valor predeterminado false, por lo que Router traduce el cuerpo de la solicitud nativa documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la Referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para cada modelo enrutado de esta manera. +`strict_mode` tiene como valor predeterminado falso, así que Router traduce el cuerpo de la solicitud nativa documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la Referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para ver todos los modelos que se enrutan de esta manera. ## Esquema @@ -411,7 +413,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON de los parámetros de la función diff --git a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx index e97cf943a4..9ff0ac91a4 100644 --- a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -2,15 +2,16 @@ title: "Usa Nano Banana Pro con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para generar imágenes con Nano Banana Pro (Gemini 3 Pro Image) mediante Comfy Router, además de los campos de solicitud" sidebarTitle: "Nano Banana Pro" -translationSourceHash: 14675d65 +translationSourceHash: 48881f72 translationFrom: development/comfy-router/models/google/nano-banana-pro/code.mdx translationBlockHashes: "_intro": 34f7de08 "Quick start": b78c780a - "Serving providers": 1176620b + "Serving providers": caff9b45 "Schema": b9a919e8 "Examples": 54f56549 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -214,6 +215,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image` - **fal**, como `fal/fal-nano-banana-pro`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image?model_provider=fal` +- **MiniMax**, como `minimax/minimax-nano-banana-pro`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image?model_provider=minimax` - **Pika**, como `pika/pika-nano-banana-pro`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image?model_provider=pika` - **Runware**, como `runware/runware-nano-banana-pro`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image?model_provider=runware` - **WaveSpeed**, como `wavespeed/wavespeed-nano-banana-pro`: `POST https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image?model_provider=wavespeed` @@ -411,7 +413,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON para los parámetros de la función diff --git a/es/development/comfy-router/models/kling/kling-4-0/code.mdx b/es/development/comfy-router/models/kling/kling-4-0/code.mdx new file mode 100644 index 0000000000..a02d3260eb --- /dev/null +++ b/es/development/comfy-router/models/kling/kling-4-0/code.mdx @@ -0,0 +1,450 @@ +--- +title: "Usar Kling 4.0 con Comfy Router" +description: "Llama a kling/kling-4.0 a través de Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." +sidebarTitle: "Kling 4.0" +translationSourceHash: df75d2dd +translationFrom: development/comfy-router/models/kling/kling-4-0/code.mdx +translationBlockHashes: + "_intro": 1eb48be4 + "Quick start": 44d4a538 + "Schema": 659ba1ad + "Examples": c9f5b052 +--- +{/* GENERATED FILE. Generated from router-schemas/kling/kling-4.0.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `kling/kling-4.0`, servido por Comfy Router desde Kling. + +**Entrada:** Texto, Imagen, Video · **Salida:** Video + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. + +**ID del modelo:** `kling/kling-4.0` + +**Endpoint:** `POST https://api.comfy.org/v2/models/kling/kling-4.0` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "kling/kling-4.0", + { + "contents": [ + { + "text": "The fox turns toward the camera.", + "type": "prompt", + }, + { + "type": "first_frame", + "url": "https://example.com/fox.png", + }, + ], + "settings": { + "duration": 3, + "resolution": "720p", + }, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("kling/kling-4.0", { + contents: [ + { + text: "The fox turns toward the camera.", + type: "prompt", + }, + { + type: "first_frame", + url: "https://example.com/fox.png", + }, + ], + settings: { + duration: 3, + resolution: "720p", + }, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/kling/kling-4.0 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"text\":\"The fox turns toward the camera.\",\"type\":\"prompt\"},{\"type\":\"first_frame\",\"url\":\"https://example.com/fox.png\"}], \"settings\": {\"duration\":3,\"resolution\":\"720p\"}}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/kling/kling-4.0/requests`. Router responde `201` con un `request_id` en cuanto admite la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso o desde otro. [La entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "kling/kling-4.0", + { + "contents": [ + { + "text": "The fox turns toward the camera.", + "type": "prompt", + }, + { + "type": "first_frame", + "url": "https://example.com/fox.png", + }, + ], + "settings": { + "duration": 3, + "resolution": "720p", + }, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud fallida o cancelada genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("kling/kling-4.0", { + contents: [ + { + text: "The fox turns toward the camera.", + type: "prompt", + }, + { + type: "first_frame", + url: "https://example.com/fox.png", + }, + ], + settings: { + duration: 3, + resolution: "720p", + }, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud fallida o cancelada se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/kling/kling-4.0/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"text\":\"The fox turns toward the camera.\",\"type\":\"prompt\"},{\"type\":\"first_frame\",\"url\":\"https://example.com/fox.png\"}], \"settings\": {\"duration\":3,\"resolution\":\"720p\"}}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/kling/kling-4.0/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/kling/kling-4.0/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + El prompt y los medios de entrada. Incluir solo elementos "prompt", "first_frame", "middle_frame" y "last_frame" selecciona imagen a video (un prompt y hasta 10 fotogramas); incluir cualquier "refer_image", "feature_video", "base_video", "element" o "voice" selecciona omni video (hasta 15 entradas, con como máximo 10 imágenes, 5 videos, 7 elementos y 3 voces). Una solicitud con un "feature_video", un "base_video" o un elemento de personaje de video se factura con la tarifa de entrada de video. + + + + ID del elemento, cuando el tipo es "element". + + + + ID de referencia para esta entrada, usado como @id en el prompt. Debe ser único dentro de la tarea. Requerido para "element" y "voice". + + + + Prompt de texto, cuando el tipo es "prompt". Hasta 26,000 caracteres en inglés u 11,000 en caracteres de otro idioma; comfy-api exige de 1 a 26,000 caracteres, y Kling rechaza el texto no inglés más largo. Haz referencia a otras entradas como @id. + + + + Tipo de entrada. Imagen a video acepta solo "prompt", "first_frame", "middle_frame" y "last_frame", y rechaza cualquier otro tipo. Omni video también acepta "refer_image", "feature_video" (un video de referencia), "base_video" (el video a editar, como máximo uno), "element" y "voice". + + Valores posibles: `prompt`, `first_frame`, `middle_frame`, `last_frame`, `refer_image`, `feature_video`, `base_video`, `element`, `voice` + + + + URL de imagen o video, cuando el tipo es un fotograma, "refer_image", "feature_video" o "base_video". Las imágenes también pueden ser Base64. Las imágenes son .jpg, .jpeg o .png de hasta 30MB, con al menos 300px por lado y una relación de aspecto entre 2:5 y 5:2. Los videos son .mp4 o .mov de hasta 300MB y de 3 a 30 segundos de duración. + + + + ID de voz, cuando el tipo es "voice". Una voz predefinida de Kling o una voz personalizada. + + + + Configuración general, como las opciones de marca de agua. `options.callback_url` y `options.external_task_id` no son compatibles con Kling 4.0; Comfy Router rechaza una solicitud que establezca cualquiera de los dos dentro de `options`. Un `callback_url` o `external_task_id` de nivel superior no forma parte de este esquema y se elimina antes de que la solicitud llegue a Kling. + + + + Indica si se generan resultados con marca de agua de forma simultánea. Las marcas de agua personalizadas no son compatibles. Un null explícito se trata como ausente, igual que lo hacen la comprobación de Kling 4.0 en /proxy y Kling. + + + + true significa generar el resultado con marca de agua, false significa no generarlo. Valor predeterminado false. + + + + Prompt de texto a video. Requerido cuando `contents` está ausente o vacío, y rechazado junto con un `contents` no vacío. Hasta 26,000 caracteres en inglés u 11,000 en caracteres de otro idioma; comfy-api exige de 1 a 26,000 caracteres, y Kling rechaza el texto no inglés más largo. + + + + Configuración de salida, como resolución, relación de aspecto y duración. + + + + Relación de aspecto (ancho:alto) de los fotogramas generados. Una de "21:9", "16:9", "9:16" o "1:1" para texto a video (predeterminada "16:9"), esas mismas o "adaptive" para omni video (predeterminada "adaptive"). Imagen a video sigue a las imágenes. Un null explícito se trata como ausente, igual que lo hacen la comprobación de Kling 4.0 en /proxy y Kling. + + Valores posibles: `21:9`, `16:9`, `9:16`, `1:1`, `adaptive` + + + + Duración del video en segundos, de 3 a 30. Requerido a menos que `contents` contenga un "base_video", donde una edición puede omitirlo para conservar la duración del video base. Esa llamada se retiene y se estima con el máximo de 30 segundos en la resolución solicitada, un límite superior en lugar del precio, y se factura según el precio que Kling reporta para la tarea finalizada. + + Alcance: `3` a `30` + + + + Resolución del video generado. Una de "720p" o "1080p". Requerido. + + Valores posibles: `720p`, `1080p` + + +Generado a partir del esquema que Router publica en `GET /v2/models/kling/kling-4.0/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Código de error. 0 indica éxito. + + + + Tareas que coinciden con la consulta. + + + + Detalles de facturación de la tarea. + + + + Cantidad de consumo, con precisión de dos decimales. + + + + Cuenta de efectivo desde la que se cobró el cargo (solo está presente cuando charge_type es "cash"), por ejemplo "balance". Algunas tareas la devuelven; otras pueden omitirla. + + + + Tipo de cuenta de consumo. "cash" para saldo, "unit" para un paquete de recursos. + + + + Código de moneda ISO 4217 de `amount` y `list_price`, por ejemplo "USD". Algunas tareas lo devuelven; otras pueden omitirlo. + + + + Precio de lista de la tarea antes de cualquier descuento, como cadena decimal. Algunas tareas lo devuelven; otras pueden omitirlo. + + + + Tipo de paquete de recursos consumibles (solo está presente cuando charge_type es "unit"). Uno de "video", "image" o "audio". + + + + Hora de creación de la tarea. Marca de tiempo Unix en milisegundos. + + Formato: `int64` + + + + El ID de tarea personalizado de esta tarea, si existe. + + + + El ID de la tarea. + + + + Información del estado de la tarea, que muestra el motivo del fallo cuando la tarea falla. + + + + Salidas generadas de la tarea. + + + + Duración del video generado en segundos. + + + + Marcador de agrupación, presente solo en imágenes agrupadas. + + + + ID de salida generado por el sistema. + + + + Duración del audio MP3 generado en segundos. + + + + URL del MP3 del audio generado (con protección contra hotlinking). + + + + Nombre del material generado. + + + + Fuente del material. "kling" indica la biblioteca oficial; los números son IDs de creador. + + + + Estado del material. Uno de "succeeded" o "deleted". + + + + Tipo de contenido de salida. Uno de "video", "image", "audio", "voice" o "element". + + + + URL del resultado generado (con protección contra hotlinking). Se borra después de 30 días. + + + + URL del resultado con marca de agua (con protección contra hotlinking). + + + + Duración del audio WAV generado en segundos. + + + + URL del WAV del audio generado (con protección contra hotlinking). + + + + Estado de la tarea. Uno de "submitted", "processing", "succeeded" o "failed". + + + + Hora de actualización de la tarea. Marca de tiempo Unix en milisegundos. + + Formato: `int64` + + + + Mensaje de error. + + + + ID de solicitud generado por el sistema. + + +## Ejemplos + +### Entrada + +```json +{ + "contents": [ + { + "text": "The fox turns toward the camera.", + "type": "prompt" + }, + { + "type": "first_frame", + "url": "https://example.com/fox.png" + } + ], + "settings": { + "duration": 3, + "resolution": "720p" + } +} +``` + +### Salida + +```json +{ + "code": 0, + "data": [ + { + "create_time": 1798761600000, + "id": "kling-v2-task-7c8d9e0f1a2b", + "message": "", + "outputs": [ + { + "duration": "5", + "id": "kling-v2-output-2b1a0f9e8d7c", + "type": "video", + "url": "https://example.invalid/kling/v2/generated.mp4" + } + ], + "status": "succeeded", + "update_time": 1798761820000 + } + ], + "message": "SUCCEED", + "request_id": "3d7e5c91-0b42-4f68-9a13-8e2c6d4b0a75" +} +``` + + diff --git a/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index 45182d5028..e3e9181792 100644 --- a/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,21 +2,22 @@ title: "Usa Kling V2.5 Turbo con Comfy Router" description: "Llama a kling/kling-v2-5-turbo a través de Comfy Router: punto de acceso, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 1671e7b6 +translationSourceHash: 06b3d8e9 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: - "_intro": 2495a4d3 + "_intro": 785eeca2 "Quick start": dc63b3ac - "Schema": 3bcb036e + "Schema": e36b5646 "Examples": 8623c725 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-v2-5-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; Referencia de API para `kling/kling-v2-5-turbo`, ofrecido por Comfy Router de Kling. -**Entrada:** Texto · **Salida:** Video +**Entrada:** Imagen, Texto · **Salida:** Video ## Inicio rápido @@ -248,7 +249,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - Información de cada storyboard, como los prompts y la duración. Admite hasta 6 storyboards, con un mínimo de 1. Es requerido cuando multi_shot es true y shot_type es customize. + Información de cada storyboard, como los prompts y la duración. Admite hasta 6 storyboards, con un mínimo de 1. Requerido cuando multi_shot es true y shot_type es customize. @@ -288,7 +289,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; haz referencia a ellas en el `prompt` como \<\<\>> y \<\<\>> según el orden de la lista. Requiere que `sound` esté en "on", lo cual solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o si dejas `sound` en su valor predeterminado "off", las voces no se aplican. + Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; referéncialas en `prompt` como \<\<\>> y \<\<\>> en el orden de la lista. Requiere que `sound` esté definido en "on", lo cual solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o si `sound` se deja en su valor predeterminado "off", las voces no se aplican. @@ -303,6 +304,14 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID true significa generar marca de agua, false significa no generarla. + + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, resolución no inferior a 300*300px, relación de aspecto entre 1:2.5 y 2.5:1. Base64 no debe incluir el prefijo data:image. + + + + Imagen de referencia: control del fotograma final. URL o cadena codificada en Base64, no puede superar los 10MB, resolución no inferior a 300*300px. Base64 no debe incluir el prefijo data:image. No se puede usar simultáneamente con dynamic_masks/static_mask ni con camera_control. + + Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v2-5-turbo/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -370,7 +379,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v2 - Información del estado de la tarea; muestra el motivo del fallo cuando la tarea falla + Información del estado de la tarea, que muestra el motivo del fallo cuando la tarea falla diff --git a/es/development/comfy-router/models/luma/photon-1/code.mdx b/es/development/comfy-router/models/luma/photon-1/code.mdx index 531bf18384..22d01dee28 100644 --- a/es/development/comfy-router/models/luma/photon-1/code.mdx +++ b/es/development/comfy-router/models/luma/photon-1/code.mdx @@ -2,14 +2,15 @@ title: "Usa Photon 1 con Comfy Router" description: "Llama a luma/photon-1 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Photon 1" -translationSourceHash: e781a769 +translationSourceHash: b6889dd2 translationFrom: development/comfy-router/models/luma/photon-1/code.mdx translationBlockHashes: "_intro": ea6e3ec8 "Quick start": edc0fd66 - "Schema": 497edabd + "Schema": 729cdd6b "Examples": 92a7a3f8 --- + {/* GENERATED FILE. Generated from router-schemas/luma/photon-1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -236,7 +237,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/luma/photon-1/ - La URL de la imagen generada: la hoja que rellena una generación `luma/photon-*`. Es null hasta que la generación alcanza `completed`. + La URL de la imagen generada: el campo hoja que rellena una generación `luma/photon-*`. Es null hasta que la generación alcanza `completed`. Formato: `uri` @@ -248,7 +249,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/luma/photon-1/ - Siempre es null en una generación de imágenes; en su lugar, lo rellenan los modelos de video `luma/ray-*`. + Siempre es null en una generación de imágenes. Solo lo rellena una generación VIDEO de Dream Machine, y ninguna operación actual inicia una; solo se establece en una generación de video anterior leída de vuelta a través de la ruta de estado. Formato: `uri` diff --git a/es/development/comfy-router/models/luma/photon-flash-1/code.mdx b/es/development/comfy-router/models/luma/photon-flash-1/code.mdx index c4b12b9a6d..c7c77be457 100644 --- a/es/development/comfy-router/models/luma/photon-flash-1/code.mdx +++ b/es/development/comfy-router/models/luma/photon-flash-1/code.mdx @@ -2,14 +2,15 @@ title: "Usa Photon Flash 1 con Comfy Router" description: "Llama a luma/photon-flash-1 desde Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Photon Flash 1" -translationSourceHash: b7487b89 +translationSourceHash: 68a3eaf1 translationFrom: development/comfy-router/models/luma/photon-flash-1/code.mdx translationBlockHashes: "_intro": 815a8c5f "Quick start": f8e29b99 - "Schema": 5ea08f51 + "Schema": 3e37bc18 "Examples": e94faa92 --- + {/* GENERATED FILE. Generated from router-schemas/luma/photon-flash-1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -248,7 +249,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/luma/photon-fl - Siempre es null en una generación de imágenes; en su lugar lo rellenan los modelos de video `luma/ray-*`. + Siempre es null en una generación de imágenes. Solo lo rellena una generación VIDEO de Dream Machine, y ninguna operación actual inicia una; únicamente se define en una generación de video anterior leída de nuevo a través de la ruta de estado. Formato: `uri` diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index 559eb6a86c..92de83f129 100644 --- a/es/development/comfy-router/reference.mdx +++ b/es/development/comfy-router/reference.mdx @@ -2,18 +2,19 @@ title: "Referencia de la API de Comfy Router" sidebarTitle: "Referencia de la API" description: "Todos los endpoints, parámetros, respuestas y errores de Comfy Router, según el contrato de la API de Comfy." -translationSourceHash: aee933a1 +translationSourceHash: f49adc91 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": e0879d3c + "Endpoints": e6679d4b "Error buckets": 02a09cb4 - "Response headers": 403c8bf5 - "Pre-flight cost estimates": f0ba96a1 - "Result assets": 5936427c + "Response headers": 3ac389bd + "Pre-flight cost estimates": 7405db0d + "Result assets": 3520a8bf "Per-model input and output schemas": 61c6bde8 - "Schemas": c1245cc9 + "Schemas": 9738e3aa --- + {/* ARCHIVO GENERADO -- NO EDITAR A MANO. @@ -36,9 +37,9 @@ Las claves de API de Comfy también se pueden enviar como tokens Bearer. `X-API- ### `GET /v2/models` -**Enumera los modelos que Comfy Router puede ejecutar.** +**Listar los modelos que Comfy Router puede ejecutar.** -Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cursor` mientras `has_more` sea verdadero. +Enumera los IDs de modelo disponibles y los datos de facturación. Usa `next_cursor` mientras `has_more` sea verdadero. **Parámetros** @@ -55,7 +56,7 @@ Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cu - El `ETag` que el solicitante conserva de un `200` anterior. + El `ETag` que el cliente conserva de un `200` anterior. **Respuestas** @@ -67,7 +68,7 @@ Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cu - Not Modified: la página no cambió desde el `ETag` que el solicitante envió en `If-None-Match`. + Not Modified: la página no ha cambiado desde el `ETag` que el cliente envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -85,13 +86,19 @@ Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cu - La solicitud no está permitida para este solicitante o modelo. + La solicitud no está permitida para este cliente ni para este modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + + `rate_limited`: se agotó la cuota de solicitudes por cliente. Espera el tiempo indicado en `Retry-After` antes de enviar la siguiente solicitud. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + + - El router no está disponible temporalmente. Reintenta con retroceso exponencial. + El router no está disponible temporalmente. Reintenta aplicando backoff. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -100,24 +107,24 @@ Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cu **Lee la entrada del catálogo de un modelo socio por su ID de modelo canónico.** -Lee los detalles de un modelo sin listar el catálogo completo. +Consulta los detalles de un modelo sin listar el catálogo completo. **Parámetros** Parte del proveedor en el ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment). Slug alfanumérico, p. ej. `anthropic`. Hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres Parte del modelo en el ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment). Slug alfanumérico, p. ej. `claude-opus-4-6`. Hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - El `ETag` que un llamador conserva de un `200` anterior. + El `ETag` que el solicitante obtuvo de un `200` anterior. **Respuestas** @@ -125,57 +132,63 @@ Lee los detalles de un modelo sin listar el catálogo completo. OK: la entrada del catálogo del modelo. - Cuerpo: [`RouterModelDetail`](#routermodeldetail). Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` + Cuerpo: [`RouterModelDetail`](#routermodeldetail) -- Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - No modificado: la entrada no ha cambiado desde el `ETag` que el llamador envió en `If-None-Match`. + Not Modified: la entrada no ha cambiado desde el `ETag` que el solicitante envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Credenciales faltantes o inválidas. + Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este llamador ni para este modelo. + La solicitud no está permitida para este solicitante o modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + + + + `rate_limited`: se agotó la cuota de solicitudes por solicitante. Espera el valor de `Retry-After` antes de enviar la siguiente solicitud. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - Router no está disponible temporalmente. Reintenta con retroceso exponencial. + El Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}` -**Ejecuta un modelo socio de forma sincrónica mediante el ID canónico del modelo.** +**Ejecuta un modelo socio de forma síncrona por su ID de modelo canónico.** Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. **Parámetros** - Parte del proveedor en el ID canónico `{provider}/{model}` del modelo. + Porción del proveedor en el ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, de hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, hasta 64 caracteres - Parte del modelo en el ID canónico `{provider}/{model}` del modelo. + Porción del modelo en el ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, de hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, hasta 128 caracteres @@ -185,7 +198,7 @@ Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. - Selecciona un proveedor alternativo para servir este modelo, en lugar de su valor predeterminado actual; `fal`, `wavespeed`, `runware` y `higgsfield` son los alternativos, y `GET /v2/models/{provider}/{model}` informa cuáles de ellos admite un modelo dado. Sus rechazos se comprueban en un orden fijo, y los anteriores responden tanto si los posteriores lo harían como si no: un valor no reconocido, que no es un proveedor registrado en absoluto, se rechaza con `400`; después, un proveedor alternativo en una solicitud cuyo cuerpo selecciona una operación multipart (una edición) se rechaza con `409` y un `detail` que comienza con "this request's `image` selects the edit operation", pero solo cuando el traductor de ese proveedor para este modelo no puede servir la operación: una opción cuyo traductor sí admite el medio continúa con normalidad; después, cualquier proveedor alternativo en una solicitud que resolvió una credencial de tipo bring-your-own-key se rechaza con `409` y un `detail` que comienza con `this request resolved a BYOK credential` (consulta esa respuesta), sirva o no ese proveedor a este modelo; después, la compuerta propia del proveedor indicado, que rechaza con `403` y `error_type: not_enabled` cuando ese proveedor no está activado para ti y con `503` y `error_type: service_unavailable` cuando la compuerta no se puede evaluar; y solo después de las cuatro se rechaza con `400` y `error_type: invalid_input` un proveedor real sin opción para este modelo, la misma respuesta que la de un valor no reconocido. `fallback_provider` queda inerte en lugar de rechazarse en una solicitud bring-your-own-key, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`. + Selecciona un proveedor alternativo para servir este modelo en lugar de su valor predeterminado actual; `fal`, `wavespeed`, `runware` y `higgsfield` son los alternativos, y `GET /v2/models/{provider}/{model}` informa cuáles de ellos admite un modelo determinado. Sus rechazos se comprueban en un orden fijo, y los anteriores responden tanto si los posteriores lo harían como si no: un valor no reconocido (que no es un proveedor registrado en absoluto) se rechaza con `400`; después, un proveedor alternativo en una solicitud cuyo cuerpo selecciona una operación multipart (una edición) se rechaza con `409` y un `detail` que comienza con "this request's `image` selects the edit operation", pero solo cuando el traductor de ese proveedor para este modelo no puede servir la operación; una rama cuyo traductor sí incluye los medios continúa con normalidad; luego, cualquier proveedor alternativo en una solicitud que resolvió una credencial BYOK (trae tu propia clave) se rechaza con `409` y un `detail` que comienza con `this request resolved a BYOK credential` (consulta esa respuesta), independientemente de si ese proveedor sirve este modelo; luego, la compuerta propia del proveedor nombrado, que rechaza con `403` y `error_type: not_enabled` cuando ese proveedor no está habilitado para ti, y con `503` y `error_type: service_unavailable` cuando la compuerta no se puede evaluar; y solo después de las cuatro se rechaza con `400` y `error_type: invalid_input` un proveedor real sin rama para este modelo, la misma respuesta que un valor no reconocido. `fallback_provider` queda inerte en lugar de rechazarse en una solicitud BYOK, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`. @@ -195,11 +208,11 @@ Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. - Controla si Router reintenta esta llamada contra el otro proveedor registrado del modelo cuando el primer intento falla por un motivo atribuible a Router o al proveedor probado. Si se omite, o con cualquier valor distinto de `false`, el fallback queda activo; `false` lo desactiva. Una respuesta de fallback exitosa incluye `X-Comfy-Router-Fallback-Provider`. En una solicitud que resolvió una credencial de tipo bring-your-own-key el fallback no está disponible diga lo que diga este parámetro: el intento simplemente no se hace y el primer fallo te llega sin cambios, lo cual es inerte, no un rechazo: aquí no se origina ningún `409`. Lo mismo ocurre, por la misma razón, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`: cada una vincula la llamada a un único proveedor que no se puede reproducir fielmente contra otro, así que el fallback simplemente se omite en lugar de rechazarse. Solo un `model_provider` explícito se rechaza con ese `409`, y a diferencia de esta omisión incondicional, su `409` por multipart se aplica únicamente a una opción cuyo traductor no puede servir la operación. + Controla si Router reintenta esta llamada con el otro proveedor registrado del modelo cuando el primer intento falla por una razón atribuible a Router o al proveedor probado. Si se omite, o con cualquier valor distinto de `false`, el fallback queda activado; `false` lo desactiva. Una respuesta de fallback correcta incluye `X-Comfy-Router-Fallback-Provider`. En una solicitud que resolvió una credencial BYOK el fallback no está disponible diga lo que diga este parámetro: simplemente no se hace el intento y el primer fallo te llega sin cambios, lo cual es inerte, no un rechazo: aquí no se origina ningún `409`. Lo mismo ocurre, por la misma razón, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`: cada una vincula la llamada a un único proveedor que no se puede reproducir fielmente contra otro, así que el fallback simplemente se omite en lugar de rechazarse. Solo un `model_provider` explícito se rechaza con ese `409`, y a diferencia de esta omisión incondicional, su `409` de multipart se aplica únicamente a una rama cuyo traductor no puede servir la operación. - Actívalo para rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declara, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada para un modelo cuyo esquema permite campos no declarados o que no tiene esquema creado, ni en un envío en cola enviado con `strict_mode=true`. + Opta por rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declara, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada para un modelo cuyo esquema permite campos no declarados o que no tiene esquema redactado, ni en un envío en cola enviado con `strict_mode=true`. Predeterminado: False @@ -208,20 +221,18 @@ Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. `application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) -La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejecuta el despacho nativo en el proveedor predeterminado del modelo y este cuerpo es el propio esquema nativo del modelo, reenviado sin cambios (`strict_mode` no tiene sentido ahí y no cambia nada). Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=false` (el valor predeterminado), el cuerpo se traduce al esquema real de ese proveedor antes de enviarse: cualquier campo nativo que no se pueda expresar con exactitud se descarta y se divulga mediante el encabezado `X-Comfy-Router-Dropped-Params` de la respuesta, nunca en silencio. Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=true` no se ejecuta ninguna traducción: el cuerpo ya debe ser el esquema real propio de ese proveedor alternativo, no el nativo de este modelo (consulta `strict_mode`), y se reenvía sin cambios. Los propios campos del cuerpo también seleccionan qué operación ejecuta Router en un modelo que admite más de una: para un modelo de imagen editable, incluir una imagen de entrada lo cambia de la operación texto a imagen a la operación imagen a imagen (edición), que puede facturarse con su propia tarifa; para un modelo de video Seedance, `content[].role` selecciona la operación (una imagen de primer fotograma selecciona imagen a video, y una imagen o un clip de referencia selecciona referencia a video). En el despacho nativo, la facturación de Seedance sigue los tipos de medio en `content`, no los roles: una solicitud con cualquier entrada de video se factura como video a video; si no, una con cualquier imagen se factura como imagen a video; si no, texto a video, salvo que un render final de un elemento `draft_task` se factura como la operación del Draft que renderiza; algunos modelos cobran la misma tarifa para texto a video e imagen a video. Con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. +La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejecuta el despacho nativo en el proveedor predeterminado del modelo y este cuerpo es el esquema nativo propio del modelo, reenviado sin cambios (`strict_mode` no tiene sentido ahí y no cambia nada). Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=false` (el valor predeterminado), el cuerpo se traduce al esquema real de ese proveedor antes de enviarse: cualquier campo nativo que no se pueda expresar exactamente se descarta y se divulga mediante el encabezado `X-Comfy-Router-Dropped-Params` de la respuesta, nunca de forma silenciosa. Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=true` no se ejecuta ninguna traducción: el cuerpo ya debe ser el esquema real propio de ese proveedor alternativo, no el nativo de este modelo (consulta `strict_mode`), y se reenvía sin cambios. Los campos del propio cuerpo también seleccionan qué operación ejecuta Router en un modelo que admite más de una: en un modelo de imagen editable, incluir una imagen de entrada lo cambia de texto a imagen a la operación imagen a imagen (edición), que puede facturarse con su propia tarifa; en un modelo de video Seedance, `content[].role` selecciona la operación (una imagen de primer fotograma selecciona imagen a video, una imagen o un clip de referencia selecciona referencia a video). En el despacho nativo, la facturación de Seedance sigue los tipos de medios en `content`, no los roles: una solicitud con cualquier entrada de video se factura como video a video; si no, una con cualquier imagen se factura como imagen a video; si no, como texto a video, salvo que un render final a partir de un elemento `draft_task` se factura como la operación del Draft que renderiza; algunos modelos cobran la misma tarifa por texto a video y por imagen a video. Con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. -**Respuestas** +**Respuestas** + OK: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, que se convierte de vuelta al contrato nativo de este modelo cuando es posible, y recurre a la respuesta en bruto del proveedor alternativo si la conversión falla, algo que se registra en el log y nunca ocurre en silencio), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. En un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes con el `Content-Type` propio del socio en lugar de `application/json`; decide según el `Content-Type` de la respuesta y no asumas que se trata de un documento JSON. - - OK: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado; se traduce de vuelta al contrato nativo de este modelo cuando es posible, y si la traducción falla se recurre a la respuesta sin procesar del proveedor alternativo, registrada en el log y nunca silenciosa), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes con el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no des por hecho que se trata de un documento JSON. - - Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` + Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes en bruto (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` Solicitud no válida. Revisa el tipo de error y el cuerpo de la solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `Idempotent-Replayed` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `X-Comfy-Credits-Used`, `Idempotent-Replayed` @@ -237,7 +248,7 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - La solicitud no está permitida para este solicitante o este modelo. + La solicitud no está permitida para este solicitante ni para este modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -249,7 +260,7 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera el `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: se rechaza un `model_provider` que nombra a un proveedor alternativo cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, y cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial de tipo bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. + Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en curso, así que espera el `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: un `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, y cuyo `detail` empieza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial de tipo bring-your-own-key para el proveedor de la ruta, cuyo `detail` empieza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `concurrency_limit_exceeded`) @@ -261,15 +272,15 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - El contenido de la solicitud fue rechazado contra el esquema del modelo. + El contenido de la solicitud se rechazó contra el esquema del modelo. Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que debes reducir las llamadas en curso; `rate_limited` significa que debes esperar a que se abra la ventana de cupo. + Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que debes reducir las llamadas en curso; `rate_limited` significa que debes esperar el `Retry-After`. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining`, `Retry-After` (cuando es `rate_limited`) @@ -279,9 +290,9 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - Router no está disponible temporalmente. Reintenta con retroceso exponencial. + El Router no está disponible temporalmente. Reintenta aplicando backoff. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo en rechazos por capacidad) @@ -294,7 +305,7 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec **Calcula el precio de una llamada a un modelo antes de ejecutarla, sin ejecutarla.** -Devuelve una estimación previa, en dólares estadounidenses, de lo que costará ejecutar este cuerpo en este modelo, con precios tomados de la misma tarifa con la que se factura la ejecución (un modelo que se factura al costo que informa su proveedor se estima a partir de la lista de precios publicada por ese proveedor). Es una estimación, no el cargo final: lo que pagas es el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo. El cuerpo se valida primero contra el esquema de entrada del modelo, tal como lo valida una ejecución predeterminada (sin `strict_mode`, sin `reject_unknown_fields`), así que un cuerpo que no cumple el esquema del modelo produce aquí el mismo `422` que en la ejecución; no se despacha nada a un proveedor y no se cobra nada. La respuesta no es un bloqueo de precio: se calcula con las tarifas vigentes en `pricing_as_of`, y una ejecución se cobra con las tarifas vigentes cuando se tarifica. Mientras la función se está desplegando, la ruta responde `403` con `error_type: not_enabled`; un modelo que Router aún no puede ejecutar responde el mismo `403` con el `detail` propio de la ruta de ejecución, así que lee `detail` para distinguir ambos casos. +Devuelve una estimación previa, en dólares estadounidenses, de lo que costará ejecutar este cuerpo en este modelo, con el precio de lista estándar de Comfy (un modelo que se factura según el costo que reporta su proveedor se estima a partir de la lista de precios publicada por ese proveedor). No refleja tarifas por contrato ni específicas del cliente: a un espacio de trabajo con precios negociados se le cotiza el precio de lista y se le cobra su tarifa contractual, y `source: exact` entonces significa exacto según el precio de lista, no el cargo de ese espacio de trabajo. Es una estimación, no el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es lo que pagas. El cuerpo se valida primero contra el esquema de entrada del modelo, tal como lo valida una ejecución predeterminada (sin `strict_mode`, sin `reject_unknown_fields`), así que un cuerpo que no cumple el esquema del modelo devuelve aquí el mismo `422` que en la ejecución; no se envía nada a un proveedor y no se cobra nada. La respuesta no es una fijación de precio: se calcula con las tarifas vigentes en `pricing_as_of`, y una ejecución se cobra con las tarifas vigentes cuando se tarifica. Si las estimaciones están desactivadas para una implementación, la ruta responde `403` con `error_type: not_enabled`; un modelo que Router aún no puede ejecutar responde el mismo `403` con el `detail` de la propia ruta de ejecución, así que lee `detail` para distinguir ambos casos. El cuerpo se tarifica tal como Router lo enviaría: traducido para el tramo `model_provider` que nombra y reorientado a la operación con la que se ejecuta, en el mismo orden que el `estimate` del `201` del envío en cola. Sin embargo, ese `estimate` no es un precio previo: llega solo después de que la ejecución se admite y se pone en cola, y esa ejecución se cobra a menos que se cancele antes del envío. **Parámetros** @@ -318,92 +329,104 @@ Devuelve una estimación previa, en dólares estadounidenses, de lo que costará `application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) -La entrada JSON nativa del modelo del socio, idéntica al cuerpo que la ruta síncrona acepta para este modelo. Se valida contra el esquema de entrada propio del modelo tal como lo valida una ejecución predeterminada (esta ruta no acepta `strict_mode` ni `reject_unknown_fields`), y sus propios campos (el número de salidas, la operación que selecciona una imagen de entrada) deciden qué se tarifica. +La entrada JSON nativa del modelo del socio, idéntica al cuerpo que acepta la ruta síncrona para este modelo. Se valida contra el esquema de entrada propio del modelo tal como lo valida una ejecución predeterminada (esta ruta no acepta `strict_mode` ni `reject_unknown_fields`), y sus propios campos (la cantidad de salidas, la operación que selecciona una imagen de entrada) deciden qué se tarifica. **Respuestas** La cotización. - Cuerpo: [`RouterCostEstimate`](#routercostestimate) -- Encabezados: `X-Comfy-Request-Id` + Body: [`RouterCostEstimate`](#routercostestimate) -- Headers: `X-Comfy-Request-Id` Solicitud no válida. Revisa el tipo de error y el cuerpo de la solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud no está permitida para este solicitante o modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` El cuerpo de la solicitud es demasiado grande. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - El cuerpo de la estimación se rechazó contra el esquema del modelo, o nombraba un modelo distinto del de la ruta. + El cuerpo de la estimación fue rechazado por el esquema del modelo, o nombraba un modelo distinto del indicado en la ruta. + + Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + + + + `rate_limited`: se agotó la cuota de solicitudes por solicitante. Espera `Retry-After` antes de enviar la siguiente solicitud. - Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - Router no está disponible temporalmente. Reintenta aplicando backoff. + Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) + + + + La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. + + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/openapi.json` **Lee los esquemas de entrada y salida de un modelo socio como documento OpenAPI.** -Lee los esquemas de entrada y salida de un modelo como un documento OpenAPI independiente. +Lee los esquemas de entrada y salida de un modelo como documento OpenAPI independiente. **Parámetros** - Parte del proveedor en el ID de modelo canónico `{provider}/{model}`. + Porción de proveedor del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment). Slug alfanumérico, p. ej. `anthropic`. Hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Parte del modelo en el ID de modelo canónico `{provider}/{model}`. + Porción de modelo del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment). Slug alfanumérico, p. ej. `claude-opus-4-6`. Hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - El `ETag` que el solicitante conserva de una respuesta `200` anterior. + El `ETag` que el cliente conserva de un `200` anterior. **Respuestas** - OK: los esquemas de entrada y salida del modelo, como un documento OpenAPI independiente. + OK: los esquemas de entrada y salida del modelo, como documento OpenAPI independiente. - Cuerpo: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument). Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` + Cuerpo: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Not Modified: el documento no ha cambiado desde el `ETag` que el solicitante envió en `If-None-Match`. + Not Modified: el documento no ha cambiado desde el `ETag` que el cliente envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -411,59 +434,65 @@ Lee los esquemas de entrada y salida de un modelo como un documento OpenAPI inde Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este solicitante ni para este modelo. + La solicitud no está permitida para este cliente o modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID del modelo. + No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router no pudo completar la solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + + + + `rate_limited`: se agotó la cuota de solicitudes por cliente. Espera el tiempo indicado en `Retry-After` antes de enviar la siguiente solicitud. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}/requests` -**Envía una ejecución de modelo asociado a la cola y regresa de inmediato.** +**Envía una ejecución de modelo de socio a la cola y responde de inmediato.** -El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es la misma entrada JSON nativa del socio que `POST /v2/models/{provider}/{model}` acepta para este modelo: una sola forma de cuerpo, un esquema por modelo, dos modos de entrega; pero esta ruta no mantiene la conexión para el resultado. Admite la ejecución, responde `201` con un identificador y quien llama recoge el resultado más tarde mediante las tres lecturas que aparecen a continuación. +El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es el mismo JSON de entrada nativo del socio que `POST /v2/models/{provider}/{model}` acepta para este modelo: una sola forma de cuerpo, un esquema por modelo, dos modos de entrega; pero esta ruta no mantiene la conexión abierta para el resultado. Admite la ejecución, responde `201` con un identificador y quien llama recoge el resultado más tarde mediante las tres lecturas siguientes. **Parámetros** - Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`, es decir, el socio cuyo modelo se está ejecutando. + Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`, es decir, el modelo que se ejecutará dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - Selecciona un proveedor alternativo para atender este modelo en lugar de su proveedor predeterminado actual. + Selecciona un proveedor alternativo para servir este modelo en lugar de su valor predeterminado actual. - Solo tiene sentido junto con `model_provider`. + Solo tiene efecto junto con `model_provider`. Predeterminado: False @@ -471,11 +500,11 @@ El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es la mism Clave generada por quien llama que hace seguro reintentar una misma llamada lógica. - 1–255 caracteres + De 1 a 255 caracteres - Actívalo para rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declare, en lugar de aceptarlo; los campos anidados no se revisan, y no se rechaza nada en un modelo cuyo esquema permita campos no declarados o que no tenga esquema definido, ni en un envío en cola enviado con `strict_mode=true`. + Actívalo para rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declare, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada para un modelo cuyo esquema permita campos no declarados o que no tenga un esquema definido, ni en un envío en cola enviado con `strict_mode=true`. Predeterminado: False @@ -484,12 +513,12 @@ El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es la mism `application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) -La entrada JSON nativa del modelo asociado, idéntica al cuerpo que la ruta síncrona acepta para este modelo, y que selecciona la operación y se factura de la misma manera: los campos del propio cuerpo eligen qué operación ejecuta Router en un modelo que admite más de una (una imagen de entrada cambia un modelo de imagen editable a imagen a imagen, lo que puede facturarse con su propia tarifa; una imagen de primer fotograma de Seedance selecciona imagen a video, y una imagen o clip de referencia selecciona referencia a video). En el despacho nativo, una solicitud de Seedance se factura según los tipos de medio en `content`, no según los roles: cualquier entrada de video se factura como video a video; de lo contrario, cualquier imagen se factura como imagen a video; de lo contrario, texto a video; salvo que un render final a partir de un elemento `draft_task` se factura como la operación del Draft que renderiza, con algunos modelos cobrando la misma tarifa para texto a video e imagen a video; y con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. El mismo contrato de selección de proveedor se aplica en el despacho: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado), el cuerpo es el documento nativo del modelo y se valida contra el esquema de entrada propio del modelo antes de admitir la ejecución, por lo que un cuerpo que el modelo rechazaría es un `422` aquí en vez de una solicitud en cola que falla minutos después; además, un cuerpo no estricto de proveedor alternativo se traduce al esquema real de ese proveedor en el despacho. Con `strict_mode=true`, el cuerpo ya debe ser el esquema propio del proveedor alternativo y se reenvía sin cambios: la validación del esquema nativo se omite, exactamente como en la ruta síncrona (consulta `model_provider` y `strict_mode`). +El JSON de entrada nativo del modelo del socio, idéntico al cuerpo que la ruta síncrona acepta para este modelo, y que selecciona la operación y se factura de la misma manera: los propios campos del cuerpo eligen qué operación ejecuta Router en un modelo que admite más de una (una imagen de entrada cambia un modelo de imagen editable a imagen a imagen, lo que puede facturarse con su propia tarifa; una imagen de primer fotograma de Seedance selecciona imagen a video, y una imagen o un clip de referencia seleccionan referencia a video). En el despacho nativo, una solicitud de Seedance se factura según los tipos de medio en `content`, no según los roles: cualquier entrada de video se factura como video a video; de lo contrario, cualquier imagen se factura como imagen a video; de lo contrario, texto a video; salvo que un render final de un elemento `draft_task` se factura como la operación del Draft que renderiza, y algunos modelos cobran la misma tarifa para texto a video e imagen a video; con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. El mismo contrato de selección de proveedor se aplica en el despacho: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado), el cuerpo es el documento nativo del modelo y se valida contra el esquema de entrada propio del modelo antes de admitir la ejecución, así que un cuerpo que el modelo rechazaría es un `422` aquí en lugar de una solicitud en cola que falla minutos más tarde; además, un cuerpo no estricto de proveedor alternativo se traduce al esquema real de ese proveedor en el despacho. Con `strict_mode=true`, el cuerpo ya debe ser el esquema propio del proveedor alternativo y se reenvía sin cambios: la validación contra el esquema nativo se omite, exactamente igual que en la ruta síncrona (consulta `model_provider` y `strict_mode`). **Respuestas** - Created: la ejecución se admitió en la cola. + Creada: la ejecución se admitió en la cola. Cuerpo: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- Encabezados: `X-Comfy-Request-Id`, `Idempotent-Replayed` @@ -513,13 +542,13 @@ La entrada JSON nativa del modelo asociado, idéntica al cuerpo que la ruta sín - Un fallo de nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para quien llama ni para este modelo. Un modelo cuyo socio responde una generación directamente como bytes aún no se puede poner en cola y se rechaza con `not_enabled`; ejecútalo en la ruta síncrona en su lugar. + La solicitud no está permitida para este llamador o este modelo. Un modelo cuyo socio responde una generación directamente como bytes todavía no se puede poner en cola y se rechaza con `not_enabled`; ejecútalo en la ruta síncrona. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -530,66 +559,71 @@ La entrada JSON nativa del modelo asociado, idéntica al cuerpo que la ruta sín Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera el `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos de `invalid_input` en esta ruta no tienen nada que ver con la clave y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede servir, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya ha resuelto una credencial de tipo bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. +Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos de `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Omite `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `concurrency_limit_exceeded`) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando `concurrency_limit_exceeded`) - El contenido de la solicitud se rechazó contra el esquema del modelo. + El contenido de la solicitud fue rechazado según el esquema del modelo. Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - Revisa `X-Comfy-Error-Type`: `queue_backlog_full` significa que ya tienes tantas solicitudes en cola sin terminar como se te permite, así que vuelve a enviar cuando una de ellas termine; `rate_limited` significa que debes esperar a la ventana de margen. + Inspecciona `X-Comfy-Error-Type`: `queue_backlog_full` significa que ya tienes tantas solicitudes en cola sin terminar como se te permite, así que vuelve a enviar cuando una de ellas termine; `rate_limited` significa que debes esperar el número de segundos indicado en `Retry-After`. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando `rate_limited`) - El router no está disponible temporalmente. Reintenta con retroceso exponencial. + El router no está disponible temporalmente. Reintenta con retroceso. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo en rechazos por capacidad) + - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo para rechazos por capacidad) + + La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}` **Recupera el resultado de una solicitud enviada.** -El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, devuelve la salida nativa del modelo del socio, byte por byte lo que la ruta síncrona entrega en su `200` para el mismo modelo y la misma entrada, de modo que los dos modos de entrega producen una sola forma de resultado y un cliente puede pasar de uno a otro sin necesidad de un segundo analizador. +El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, devuelve la salida nativa del propio modelo del socio, byte por byte lo que la ruta síncrona entrega en su `200` para el mismo modelo y la misma entrada, de modo que los dos modos de entrega producen una sola forma de resultado y quien llama puede pasar de uno a otro sin un segundo analizador. **Parámetros** Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, Hasta 64 caracteres Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecutará dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, Hasta 128 caracteres - La solicitud en cola a la que se dirige: el `request_id` que el envío devolvió en su cuerpo. + La solicitud en cola que se va a atender: el `request_id` que el envío devolvió en su cuerpo. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres **Respuestas** - OK: el resultado almacenado para una solicitud que produjo uno, una solicitud que se completó correctamente, o una terminal que lleva tanto un cargo registrado como un resultado almacenado, devuelto sin cambios bajo el tipo de medio propio del socio, exactamente como lo devuelve el `200` de la ruta síncrona, y bajo el mismo contrato de selección de proveedor que aceptó el envío: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, traducido de vuelta al contrato nativo de este modelo cuando sea posible, recurriendo a la respuesta sin procesar del propio proveedor alternativo cuando falle la traducción, registrado en el log, nunca de forma silenciosa), la forma es la salida nativa de este modelo; con `strict_mode=true`, es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes bajo el `Content-Type` del propio socio en lugar de `application/json`; decide según el `Content-Type` de la respuesta y no asumas que hay un documento JSON. + OK: el resultado almacenado de una solicitud que lo produjo (una solicitud que se completó correctamente, o una terminal que lleva tanto un cargo registrado como un resultado almacenado), devuelto sin cambios bajo el tipo de medio propio del socio, exactamente como lo devuelve el `200` de la ruta síncrona, y bajo el mismo contrato de selección de proveedor que aceptó el envío: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, traducido de vuelta al contrato nativo de este modelo cuando es posible, recurriendo a la respuesta sin procesar del proveedor alternativo si falla la traducción, registrado en el log y nunca en silencio), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde una generación directamente como bytes, el cuerpo son esos bytes bajo el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no des por hecho que hay un documento JSON. Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` - Aceptado: la solicitud aún no ha finalizado. + Aceptada: la solicitud no ha finalizado. Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After` @@ -601,71 +635,77 @@ El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, de - La solicitud no está permitida para este cliente ni para este modelo. + La solicitud no está permitida para este llamador o modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID del modelo. + No se encontró el ID de modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por una razón que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + + `rate_limited`: se agotó la cuota de solicitudes por llamador. Espera el `Retry-After` antes de enviar la siguiente solicitud. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + + - Router no está disponible temporalmente. Reintenta con un retroceso progresivo. + El Router no está disponible temporalmente. Reintenta con retroceso exponencial. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud está en un estado que entra en conflicto con la operación. Comprueba el tipo de error. + La solicitud está en un estado que entra en conflicto con la operación. Revisa el tipo de error. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud superó un plazo límite. Comprueba el tipo de error antes de reintentar. + La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por una razón que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` -**Solicitar la cancelación de una solicitud enviada.** +**Solicita la cancelación de una solicitud enviada.** -Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una solicitud, no una garantía, y el `202` lo dice exactamente: `CANCELLATION_REQUESTED` significa que la petición fue aceptada, no que la ejecución se haya detenido. Una ejecución que ya está en curso en un socio puede completarse de todos modos, y una generación del socio que se completa se cobra, se haya recogido o no, así que quien llama y necesita saber qué pasó realmente consulta el endpoint de estado después, donde una cancelación que surtió efecto aparece como `COMPLETED` con un `error_type`, igual que cualquier otro resultado terminal. +Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una petición, no una garantía, y el `202` dice exactamente eso: `CANCELLATION_REQUESTED` significa que se aceptó la petición, no que la ejecución se haya detenido. Una ejecución que ya está en curso en un socio puede completarse de todos modos, y una generación del socio que se completa se cobra, sin importar si alguien la recogió, así que quien llama y necesita saber qué ocurrió realmente consulta el endpoint de estado después, donde una cancelación que surtió efecto es `COMPLETED` y lleva un `error_type` como cualquier otro resultado terminal. **Parámetros** Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, Hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecutará dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, Hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - La solicitud en cola que se va a atender: el `request_id` que el envío devolvió en su cuerpo. + La solicitud en cola que se va a atender: el `request_id` que devolvió el envío en su cuerpo. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres **Respuestas** @@ -695,7 +735,7 @@ Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una solicitud - La solicitud no está permitida para quien llama ni para este modelo. + La solicitud no está permitida para este solicitante o modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -706,89 +746,101 @@ Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una solicitud Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + + `rate_limited`: se agotó la cuota de solicitudes por solicitante. Espera `Retry-After` antes de enviar la siguiente solicitud. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + + - Router no está disponible temporalmente. Reintenta con retroceso exponencial. + El Router no está disponible temporalmente. Reintenta con retroceso exponencial. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` -**Lee el estado en la cola de una solicitud enviada.** +**Consulta el estado en cola de una solicitud enviada.** -El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con el resultado, así que un cliente puede seguir una generación larga sin transferir su salida en cada sondeo: el resultado se recoge una sola vez, desde la lectura de abajo, cuando este indica `COMPLETED`. +El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con el resultado, así que un cliente puede seguir una generación larga sin transferir su salida en cada sondeo: el resultado se recoge una sola vez, con la lectura de más abajo, cuando este indica `COMPLETED`. **Parámetros** Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. - Tipo: [`RouterProviderSegment`](#routerprovidersegment). Slug alfanumérico, por ejemplo `anthropic`. Hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecuta dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment). Slug alfanumérico, por ejemplo `claude-opus-4-6`. Hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - La solicitud en cola que se quiere consultar: el `request_id` que devolvió el envío en su cuerpo. + La solicitud en cola que quieres consultar: el `request_id` que el envío devolvió en su cuerpo. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid). `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres **Respuestas** - OK: el estado actual de la solicitud en la cola. + OK: el estado actual de la cola de la solicitud. - Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse). Encabezados: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` + Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Credits-Used`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este solicitante o modelo. + La solicitud no está permitida para este cliente o este modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID del modelo. + No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. + + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + + + + `rate_limited`: se agotó la cuota de solicitudes por cliente. Espera `Retry-After` antes de enviar la siguiente solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - Router no está disponible temporalmente. Reintenta con retroceso progresivo. + Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` -Las descripciones aquí son breves. Usa [Uso de la API de Comfy Router](/es/development/comfy-router/api) para la selección de modelos, la validación, los reintentos y la facturación, y [Encabezados](/es/development/comfy-router/headers) para el comportamiento de los encabezados. +Las descripciones aquí son breves. Consulta [Uso de la API de Comfy Router](/es/development/comfy-router/api) para la selección de modelos, la validación, los reintentos y la facturación, y [Encabezados](/es/development/comfy-router/headers) para el comportamiento de los encabezados. ## Categorías de error @@ -870,6 +922,12 @@ Las genera el propio Router, antes de la llamada al modelo o en torno a ella. Se envía en: `200`, `202` + + Segundos de espera antes de enviar otra solicitud después de un `429` que lleve `error_type: rate_limited`: el tiempo hasta que la cuota de solicitudes por minuto del llamador se haya rellenado lo suficiente como para admitir una solicitud más. + + Se envía en: `429` + + Segundos de espera antes de reintentar la misma solicitud con la misma `Idempotency-Key`. @@ -930,33 +988,32 @@ Las genera el propio Router, antes de la llamada al modelo o en torno a ella. Los centavos de USD que el llamador tiene comprometidos actualmente en llamadas aún en curso. - - El límite máximo, en centavos de USD, del gasto de socio que el llamador puede tener comprometido en llamadas aún en curso: dinero retenido desde el momento en que se admite una llamada y liberado cuando esa llamada termina. +El límite máximo, en centavos de USD, del gasto de socio que el llamador puede haber comprometido en llamadas aún en curso: dinero retenido desde el momento en que se admite una llamada y liberado cuando esa llamada termina. - Los centavos de USD de margen disponible que quedan por debajo del límite máximo, con un mínimo de cero. + Los centavos de USD de margen restante por debajo del límite máximo, con un mínimo de cero. - Siempre `nosniff`, en toda ejecución exitosa de un modelo de Router. + Siempre `nosniff`, en cada ejecución exitosa de un modelo de Router. - Las llamadas simultáneas del solicitante a modelos clasificados como costosos, tal como las cuenta la compuerta que rechazó esta llamada. + Las llamadas simultáneas del llamador a modelos clasificados como costosos, tal como las cuenta la compuerta que rechazó esta llamada. - La mayor cantidad de llamadas simultáneas a modelos clasificados como costosos que el solicitante puede mantener a la vez, una cuarta parte del límite de llamadas simultáneas, compartida con las llamadas de nodos asociados. + El máximo de llamadas simultáneas a modelos clasificados como costosos que el llamador puede mantener a la vez, una cuarta parte del límite de llamadas simultáneas, compartido con las llamadas de nodos de socio. - Las llamadas a modelos costosos que el solicitante aún puede iniciar; `0` en el `429`. + Las llamadas a modelos costosos que el llamador aún puede iniciar; `0` en el `429`. ## Estimaciones de costos previas a la ejecución -`POST /v2/models/{provider}/{model}/estimate` tarifica un cuerpo sin ejecutarlo, y un envío en cola (`POST /v2/models/{provider}/{model}/requests`) devuelve el mismo [`RouterCostEstimate`](#routercostestimate) que `estimate` en su `201`. Ambos se calculan con la tarjeta de tarifas contra la que Comfy factura la ejecución, salvo un modelo que se factura al costo que informa su proveedor, que se marca como `estimated` a partir de la lista de precios publicada por ese proveedor. Cada cifra que devuelve cualquiera de los dos es una estimación, no el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. Comfy no factura una ejecución con tu propia clave de proveedor (ver abajo). Mientras la estimación se está implementando, la ruta responde `403` con `error_type: not_enabled` y la respuesta del envío omite `estimate`. El catálogo sigue sin mostrar precios. +`POST /v2/models/{provider}/{model}/estimate` tarifica un cuerpo sin ejecutarlo, y un envío en cola (`POST /v2/models/{provider}/{model}/requests`) devuelve el mismo [`RouterCostEstimate`](#routercostestimate) que `estimate` en su `201`. Ambos se tarifican al precio de lista estándar de Comfy, salvo un modelo que se factura al costo que informa su proveedor, que se calcula como `estimated` a partir de la lista de precios publicada por ese proveedor. Ninguno refleja tarifas contractuales ni específicas del cliente: a un espacio de trabajo con precios negociados se le cotiza el precio de lista y se le cobra su tarifa contractual, y `source: exact` significa entonces exacto al precio de lista, no el cargo de ese espacio de trabajo. Toda cifra que devuelva cualquiera de los dos es una estimación, no el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. Comfy no factura una ejecución hecha con tu propia clave de proveedor (ver abajo). Si las estimaciones están desactivadas en un despliegue, la ruta responde `403` con `error_type: not_enabled` y la respuesta del envío omite `estimate`. Ambos tarifican el cuerpo tal como Router lo despacharía (traducido para un tramo `model_provider`, reorientado a la operación en la que se ejecuta), pero el `estimate` del envío no es un precio previo a la ejecución: llega solo después de que la ejecución se admite y se pone en cola, y esa ejecución se cobra a menos que se cancele antes del despacho. El catálogo sigue sin mostrar precios. Lee `source` antes de cualquier cantidad. Que falte una cifra nunca significa que sea gratis. @@ -974,9 +1031,9 @@ El `reason` de una estimación `unknown` es uno de los siguientes: - `byok` (solo envío en cola): la ejecución usa tu propia clave de proveedor, por lo que Comfy no cobra nada por ella. - `pricing_unavailable` (solo envío en cola): no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud. El envío se acepta igualmente y la ejecución se cobra como de costumbre. -Los modelos para los que Router aún no puede calcular un precio antes de una ejecución se enumeran en [modelos sin una estimación previa a la ejecución](/es/development/comfy-router/limitations#modelos-sin-estimación-previa). Un modelo que no aparezca allí puede responder igualmente `unknown` para un cuerpo concreto, así que lee `source` en cada estimación. +Los modelos que Router aún no puede tarificar antes de una ejecución se enumeran en [modelos sin una estimación previa a la ejecución](/es/development/comfy-router/limitations#modelos-sin-estimación-previa). Un modelo que no aparezca allí puede responder igualmente `unknown` para un cuerpo concreto, así que lee `source` en cada estimación. -Cuándo la estimación falla de forma segura: +En qué casos la estimación falla de forma segura: - Cuando una cifra necesita la tarjeta de tarifas y la tarjeta no está cargada o está desactualizada, `/estimate` responde `503` en lugar de adivinar. Router nunca rechaza el envío en cola por su estimación; en su lugar, este lleva `source: unknown` con `reason: pricing_unavailable`. Router responde a una llamada que no se puede tarificar antes de ejecutarse en absoluto (`not_quotable`), o a un envío en cola con tu propia clave de proveedor (`byok`), sin leer la tarjeta, así que ese `200` no dice nada sobre si la tarjeta está actualizada. - `/estimate` valida el cuerpo con el esquema de entrada propio del modelo igual que lo hace una ejecución predeterminada, así que un cuerpo que no cumple el esquema del modelo recibe el mismo `422`, con la misma forma de `detail[]`, que respondería la ejecución. No se calcula ningún precio ni se despacha nada. @@ -985,10 +1042,8 @@ Cuándo la estimación falla de forma segura: Límites de la estimación. Una cifra de `200` no garantiza que la ejecución se acepte ni que se cobre exactamente eso: - `/estimate` no acepta `strict_mode` ni `reject_unknown_fields`, así que solo comprueba el contrato nativo del modelo: un cuerpo que una ejecución con `strict_mode=true` acepta en el esquema propio del proveedor alternativo puede recibir aquí un `422`, y aquí se calcula el precio de un campo de nivel superior no declarado que una ejecución con `reject_unknown_fields=true` rechazaría. Un modelo de Anthropic Messages es la excepción: su esquema permite campos no declarados, así que una ejecución con `reject_unknown_fields=true` no rechaza ninguno, y la estimación solo tarifica los campos de nivel superior no declarados `tools`, `tool_choice`, `temperature`, `top_p`, `top_k`, `stop_sequences`, `metadata`, `thinking` y un `mcp_servers` vacío. Cualquier otro campo de nivel superior no declarado hace que responda `unknown` con `reason: not_quotable`. -- `pricing_as_of` indica cuándo se obtuvo la tarjeta de tarifas. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor lleva la fecha en que se leyó esa lista. Una cotización `exact` o `estimated` cuya cantidad facturable se predice a partir de un calendario publicado por el proveedor lleva la fecha de lectura de ese calendario cuando es anterior a la de la tarjeta. Cuando no se leyó ni tarjeta ni calendario, indica cuándo se respondió la estimación. No es un bloqueo de precio: la ejecución se cobra con las tarifas vigentes cuando se tarifica. -- `/estimate` cotiza el tramo que indica `model_provider`, o el proveedor nativo. No acepta el parámetro `fallback_provider` ni `strict_mode`. Una ejecución síncrona cuyo reintento de respaldo recae en otro proveedor se cobra con la tarifa de ese proveedor, que la estimación no cotizó; `X-Comfy-Router-Fallback-Provider` en la respuesta de la ejecución indica que ocurrió. Un envío en cola no tiene respaldo, así que su `estimate` cotiza el tramo que se ejecuta. -- `/estimate` y el `estimate` de un envío en cola pueden calcular el precio de documentos ligeramente distintos para el mismo cuerpo en un tramo de `model_provider`, o para un cuerpo que se ejecuta en una operación hermana. El `estimate` del envío se calcula sobre el documento que envía la ejecución. -- `/estimate` siempre cotiza el cargo de la plataforma. Comfy no factura una ejecución con tu propia clave de proveedor, pero `/estimate` no lo detecta y aun así devuelve una cifra; solo un envío en cola responde `reason: byok`. +- `pricing_as_of` indica cuándo se obtuvo la tarjeta de tarifas. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor lleva la fecha en que se leyó esa lista. Una cotización `exact` o `estimated` cuya cantidad facturable se predice a partir de un calendario de precios publicado por el proveedor lleva la fecha de lectura de ese calendario cuando es anterior a la de la tarjeta. Cuando no se leyó ni tarjeta ni calendario, indica cuándo se respondió la estimación. No es un bloqueo de precio: la ejecución se cobra con las tarifas vigentes cuando se tarifica. +- `/estimate` cotiza el tramo que nombra `model_provider`, o el proveedor nativo. No acepta los parámetros `fallback_provider` ni `strict_mode`. Una ejecución síncrona cuyo reintento de fallback recae en otro proveedor se cobra a la tarifa de ese proveedor, que la estimación no cotizó; `X-Comfy-Router-Fallback-Provider` en la respuesta de la ejecución indica que ocurrió. Un envío en cola no tiene fallback, así que su `estimate` cotiza el tramo que se ejecuta.- `/estimate` siempre cotiza el cargo de la plataforma. Comfy no factura una ejecución con tu propia clave de proveedor, pero `/estimate` no lo detecta y aun así devuelve una cifra; solo un envío en cola responde `reason: byok`. - Los dólares se calculan a partir de centavos sin redondear, con hasta 8 decimales, y una `amount` cobrable inferior a un centavo nunca se muestra como `0`. `credits` es `round(amount × 211, 2)`, la misma conversión que `X-Comfy-Credits-Used` aplica a un cargo, así que `credits` puede redondearse a `0` para un precio muy pequeño distinto de cero; presupuesta con `amount` o `amount_cents`, no con `credits`, cuando eso importe. Ese encabezado sigue siendo la cifra a posteriori de una ejecución; los saldos están en la plataforma de Comfy. ## Recursos del resultado @@ -1002,7 +1057,7 @@ Un modelo puede devolver URL de recursos, bytes en línea o ambos. Los proveedor | `minimax/*` | el video finalizado | 12 horas | | `xai/*` | cada imagen generada, y el video finalizado | 24 horas | -Estos tiempos de vida empiezan cuando se firma la URL, no cuando la abres. Las URL en caché o de una llamada repetida pueden tener menos tiempo restante; repetir la llamada no las renueva. Un registro de `Idempotency-Key` puede sobrevivir a las URL que contiene, así que desde una hora antes de que expire una URL de ese tipo, un reintento con la misma clave recibe `409 invalid_input` en lugar de la respuesta registrada; una respuesta que ya estaba tan cerca de expirar cuando se sirvió sigue siendo reproducible durante 5 minutos. Descarga el recurso cuanto antes. Solo se copian los recursos indicados en cada fila: las imágenes `byteplus/seedream-*` y `byteplus/seededit-*` no están cubiertas por la fila de video de BytePlus. +Estos tiempos de vida empiezan cuando se firma la URL, no cuando la abres. Las URL en caché o de una respuesta repetida pueden tener menos tiempo restante; repetir la llamada no las renueva. Un registro de `Idempotency-Key` puede sobrevivir a las URL que contiene, así que desde una hora antes de que expire una URL de ese tipo, un reintento con la misma clave recibe `409 invalid_input` en lugar de la respuesta registrada; una respuesta que ya estaba tan cerca de expirar cuando se sirvió sigue siendo reproducible durante 5 minutos. Descarga el recurso cuanto antes. Solo se copian los recursos indicados en cada fila: las imágenes `byteplus/seedream-*` y `byteplus/seededit-*` no están cubiertas por la fila de video de BytePlus. La copia la realiza únicamente el proveedor nativo del modelo. Una ejecución atendida por un proveedor alternativo (`model_provider` que nombre uno, o una ejecución nativa cuyo reintento de respaldo haya recaído en uno, indicado por `X-Comfy-Router-Fallback-Provider`) devuelve las URL propias de ese proveedor, que siguen la caducidad del proveedor y no se copian. Los valores `default`, `comfy` y `comfyui` de `model_provider` no nombran ningún proveedor alternativo, por lo que esas ejecuciones son nativas y se copian como se describe arriba, igual que una ejecución con `model_provider` cuyo reintento de respaldo haya vuelto a recaer en el proveedor nativo. @@ -1010,9 +1065,11 @@ La copia la realiza únicamente el proveedor nativo del modelo. Una ejecución a Otros modelos devuelven referencias a recursos del proveedor o bytes en línea. Las URL del proveedor siguen la caducidad del proveedor, que puede ser mucho más corta que los tiempos de vida anteriores y no está especificada por el contrato del Router. -**URL originales de BytePlus (Seedance 2.x, opcional).** En un espacio de trabajo al que Comfy haya habilitado la opción del lado del servidor, un resultado de Seedance 2.x también incluye las URL propias de BytePlus en `content.upstream_video_url` y `content.upstream_last_frame_url`, junto a las copiadas, además de `content.upstream_expires_at`. No hay ningún parámetro de solicitud y ningún espacio de trabajo tiene la opción habilitada de forma predeterminada. Estas URL expiran 24 horas después de la generación y dejan de estar presentes cuando BytePlus las borra; en Seedance 2.5, BytePlus limita cada una a 100 descargas, y la copia propia de Router usa una. Cada una es una credencial de portador para su objeto: cualquiera que la tenga puede descargar el recurso hasta que expire. +**URL originales de BytePlus (Seedance 2.x, opcional).** En un espacio de trabajo en el que Comfy haya habilitado la opción del lado del servidor, un resultado de Seedance 2.x también incluye las URL propias de BytePlus en `content.upstream_video_url` y `content.upstream_last_frame_url`, junto a las copiadas, además de `content.upstream_expires_at`. No hay ningún parámetro de solicitud y ningún espacio de trabajo tiene la opción habilitada de forma predeterminada. Estas URL expiran 24 horas después de la generación y dejan de estar presentes cuando BytePlus las borra; en Seedance 2.5, BytePlus limita cada una a 100 descargas, y la copia propia de Router consume una. Cada una es una credencial de portador para su objeto: cualquiera que la tenga puede descargar el recurso hasta que expire. -La copia se hace con el mejor esfuerzo en cada recurso. Si una copia falla, esa entrada conserva su referencia del proveedor; la respuesta puede contener tanto URL de Comfy como del proveedor, sin un campo explícito de estado de copia por recurso. La generación se completa igualmente y se cobra. No deduzcas el tiempo de vida de todas las URL a partir de un recurso realojado con éxito. +**Espacios de trabajo con retención cero de datos.** Para un espacio de trabajo que Comfy haya configurado para retención cero de datos, los resultados de BytePlus no se copian en el almacenamiento de Comfy: la fila de video de `byteplus/*` anterior no se aplica, y `content.video_url` y `content.last_frame_url` son las URL del proveedor propio de BytePlus, devueltas tal como BytePlus las envió. Son válidas durante 24 horas y, en Seedance 2.5, BytePlus limita cada una a 100 descargas, así que descarga el recurso cuanto antes. Ese resultado no se reproduce a partir de su registro de `Idempotency-Key`. + +La copia se realiza con el mejor esfuerzo posible para cada recurso. Si una copia falla, esa entrada conserva su referencia del proveedor; la respuesta puede contener tanto URL de Comfy como del proveedor, sin un campo explícito de estado de copia por recurso. La generación se completa igualmente y se cobra. No deduzcas el tiempo de vida de todas las URL a partir de un recurso realojado con éxito. Que un resultado esté alojado en Comfy también determina si más tarde aún es posible repetir una llamada completada desde su registro de `Idempotency-Key`; el parámetro `Idempotency-Key` de arriba indica qué recibe un reintento cuando no es posible. @@ -1022,40 +1079,40 @@ Que un resultado esté alojado en Comfy también determina si más tarde aún es Lee los campos de cada modelo desde `GET /v2/models/{provider}/{model}/openapi.json`. Esa llamada requiere una clave API. El mismo documento, para cada modelo con un esquema definido explícitamente, también se publica en este sitio sin clave, en `/router-schemas/{provider}/{model}.json`. Esa copia es una instantánea tomada en la última actualización de la documentación, así que el endpoint es la fuente autoritativa cuando hay diferencias. El `requestBody` de la operación describe la validación de la entrada; su respuesta `200` describe la forma de la salida y el tipo de medio cuando este está definido explícitamente. Cuando `x-comfy-input-schema-authored` es `false`, Router acepta cualquier objeto JSON sin prevalidación específica del modelo. Los requisitos del proveedor siguen aplicando. Los esquemas de salida describen resultados; Router no valida contra ellos las cargas útiles que devuelve el proveedor. Una salida sin esquema definido explícitamente puede usar `*/*` en lugar de `application/json`; revisa el tipo de contenido de la respuesta antes de decodificarla. -## Esquemas +## Esquema ### RouterBilledWorkspace -La cartera a la que se habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a «¿qué cartera está vacía?»: no es necesariamente el espacio de trabajo que la interfaz del llamador tiene seleccionado en ese momento, y la credencial personal de un miembro del equipo nombra aquí su cartera personal incluso mientras hay un equipo con fondos abierto. Presente solo junto con `denied_reason`. +La cartera a la que se habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a "¿qué cartera está vacía?": no es necesariamente el espacio de trabajo que la interfaz de quien llama tiene seleccionado en este momento, y la credencial personal de un miembro del equipo indica aquí su cartera personal incluso mientras hay un equipo con fondos abierto. Solo aparece junto con `denied_reason`. **Campos** - El id del espacio de trabajo de Cloud. Ausente en la vía heredada. + El id del espacio de trabajo de Cloud. Ausente en el carril clásico. - `personal` o `team`. Cadena abierta: trata cualquier otro valor como personal. + `personal` o `team`. Una cadena abierta: trata cualquier otro valor como personal. - `legacy` cuando la llamada factura al cliente de Metronome previo a los espacios de trabajo en lugar de a un espacio de trabajo de Cloud; ese cliente no tiene id de espacio de trabajo. Ausente para un espacio de trabajo de Cloud. + `legacy` cuando la llamada factura al cliente de Metronome anterior a los espacios de trabajo de quien llama en lugar de a un espacio de trabajo de Cloud; ese cliente no tiene id de espacio de trabajo. Ausente para un espacio de trabajo de Cloud. ### RouterChargesOnPolicyRejection -Indica si un rechazo por política de contenido se cobra en este modelo. Trata un valor desconocido como potencialmente cobrado. +Indica si se cobra un rechazo por política de contenido en este modelo. Trata un valor desconocido como posiblemente cobrado. Tipo: `string` ### RouterCostEstimate -Una estimación previa de cuánto costará esta llamada, en dólares estadounidenses, calculada antes del despacho a partir de la misma tabla de tarifas con la que se factura la ejecución (o, para un modelo que se factura al costo que informa su proveedor, estimada a partir de la lista de precios publicada por ese proveedor). No es el cargo final: el cargo que pagas es el liquidado en los registros de uso y facturación de tu espacio de trabajo. `X-Comfy-Credits-Used`, que se informa después de la ejecución, es una cifra redondeada calculada a posteriori, no un recibo. `source` indica cuánto puedes confiar en el número: `exact` incluye `amount`; `free` incluye `amount` "0" (la tabla de tarifas da a esta solicitud un precio de cero); `estimated` incluye `min_amount` y `max_amount` y ningún `amount`; `unknown` no incluye ninguno de los dos y sí un `reason`. Nunca interpretes un `amount` ausente como gratis. No es un bloqueo de precio: consulta `pricing_as_of`. +Una estimación previa a la ejecución de lo que costará esta llamada, en dólares estadounidenses, calculada antes del despacho con el precio de lista estándar de Comfy o, en el caso de un modelo facturado por el costo que reporta su proveedor, a partir de la lista de precios publicada por el proveedor. En ese caso de costo reportado por el proveedor, `source: exact` se devuelve solo para un conjunto pequeño de modelos que optaron por ello, y solo cuando la lista de precios publicada determina por completo la cifra (todos los campos que influyen en el precio se declararon, o se dejaron en un valor predeterminado que no puede cambiarla); cualquier otra cotización reportada por el proveedor es `estimated`, incluidas algunas que la lista determinaría por completo. En cualquier caso, la ejecución se factura por el monto que reporta el proveedor después de completarse, nunca por la cifra cotizada al pie de la letra. No refleja tarifas contractuales ni específicas del cliente: a un espacio de trabajo con precios negociados se le cotiza el precio de lista y se le cobra su tarifa contractual, y `source: exact` entonces significa exacto al precio de lista, no el cargo de ese espacio de trabajo. No es el cargo final: lo que pagas es el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo. `X-Comfy-Credits-Used`, que se reporta después de la ejecución, es una cifra redondeada a posteriori, no un recibo. `source` indica cuánto confiar en el número: `exact` incluye `amount`; `free` incluye `amount` "0" (la tarjeta de tarifas cotiza esta solicitud en cero); `estimated` incluye `min_amount` y `max_amount` y ningún `amount`; `unknown` no incluye ninguno de los dos y sí un `reason`. Nunca interpretes un `amount` ausente como gratis. No es un bloqueo de precio: consulta `pricing_as_of`. **Campos** - `exact` | `estimated` | `free` | `unknown`; interpreta cualquier otro valor como `unknown`. Tanto `exact` como `estimated` etiquetan una estimación; ninguno es el cargo final. `free` significa que la tabla de tarifas da a esta solicitud un precio de cero, así que `amount` es "0". `unknown` no incluye ninguna cifra. + `exact` | `estimated` | `free` | `unknown`; lee cualquier otro valor como `unknown`. Tanto `exact` como `estimated` etiquetan una estimación; ninguno es el cargo final. `free` significa que la tarjeta de tarifas cotiza esta solicitud en cero, por lo que `amount` es "0". `unknown` no incluye ninguna cifra. @@ -1063,59 +1120,58 @@ Una estimación previa de cuánto costará esta llamada, en dólares estadounide - El costo estimado en dólares como cadena decimal, por ejemplo "0.04", con hasta 8 decimales y sin exponente. Un precio inferior a un centavo que sí se cobra nunca se representa como "0"; solo una cotización `free` dice "0". Presente solo cuando `source` es `exact` o `free`. No es el cargo final: lo es el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo. + El costo estimado en dólares como cadena decimal, por ejemplo "0.04", con hasta 8 decimales y sin exponente. Un precio cobrable de menos de un centavo nunca se representa como "0"; solo una cotización `free` se lee "0". Presente solo cuando `source` es `exact` o `free`. No es el cargo final: el cargo final es el liquidado en los registros de uso y facturación de tu espacio de trabajo. - El extremo inferior de la estimación en dólares como cadena decimal. Es una estimación, no un mínimo garantizado: una llamada puede facturarse menos, por ejemplo cuando el proveedor devuelve menos de lo que pedía la solicitud (como ninguna imagen), cuando la estimación es un precio típico aprendido de llamadas anteriores, o cuando el precio no sube de forma constante con la cantidad solicitada. Presente solo cuando `source` es `estimated`. + El extremo inferior de la estimación en dólares como cadena decimal. Es una estimación, no un piso garantizado: una llamada puede facturarse menos, por ejemplo cuando el proveedor devuelve menos de lo que pidió la solicitud (como ninguna imagen), cuando la estimación es un precio típico aprendido de llamadas anteriores, o cuando el precio no sube de forma constante con la cantidad solicitada. Presente solo cuando `source` es `estimated`. - El extremo superior de la estimación en dólares como cadena decimal. Es una estimación, no un máximo garantizado: una llamada puede facturarse más, por ejemplo cuando el proveedor devuelve más de lo pedido (como más imágenes de las solicitadas), cuando la estimación se aprende de llamadas anteriores, o cuando el precio no sube de forma constante con la cantidad solicitada. Presente solo cuando `source` es `estimated`. + El extremo superior de la estimación en dólares como cadena decimal. Es una estimación, no un techo garantizado: una llamada puede facturarse más, por ejemplo cuando el proveedor devuelve más de lo que se pidió (como más imágenes de las solicitadas), cuando la estimación se aprende de llamadas anteriores, o cuando el precio no sube de forma constante con la cantidad solicitada. Presente solo cuando `source` es `estimated`. - La misma cifra en centavos de dólar, sin redondear, para operaciones aritméticas. Presente junto con `amount`. + La misma cifra en centavos de dólar estadounidenses, sin redondear, para operaciones aritméticas. Presente junto con `amount`. double - `min_amount` en centavos de dólar, sin redondear. Presente junto con `min_amount`. + `min_amount` en centavos de dólar estadounidenses, sin redondear. Presente junto con `min_amount`. double - `max_amount` en centavos de dólar. Presente junto con `max_amount`. + `max_amount` en centavos de dólar estadounidenses. Presente junto con `max_amount`. double - `amount` en créditos de Comfy usando la conversión de la plataforma ($1 = 211 créditos), redondeado a 2 decimales: la cifra que se espera que lleve `X-Comfy-Credits-Used` para una cotización `exact`. Ese encabezado es una cifra redondeada calculada a posteriori, no un recibo; el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. + `amount` en créditos de Comfy usando la conversión de la plataforma ($1 = 211 créditos), redondeado a 2 decimales: la cifra que se espera que lleve `X-Comfy-Credits-Used` para una cotización `exact`. Ese encabezado es una cifra redondeada a posteriori, no un recibo; el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es el definitivo. double - El tramo del proveedor al que corresponde esta cotización. En un envío en cola, es el tramo que se ejecutará. + El segmento de proveedor al que corresponde esta cotización. En un envío en cola, es el segmento que se ejecutará. - Un ID de modelo canónico de Comfy Router, `{provider}/{model}`, exactamente el valor que direcciona el modelo en `POST /v2/models/{provider}/{model}`, de modo que quien llama pueda interpolarlo en esa ruta sin volver a derivarlo de nada. Su `pattern` es `RouterProviderSegment` y `RouterModelSegment` unidos por un solo `/`, y `maxLength` es su suma más ese separador. + Un ID de modelo canónico de Comfy Router, `{provider}/{model}`: exactamente el valor que direcciona el modelo en `POST /v2/models/{provider}/{model}`, de modo que quien llama puede interpolarlo en esa ruta sin volver a derivarlo de nada. Su `pattern` es `RouterProviderSegment` y `RouterModelSegment` unidos por un único `/`, y `maxLength` es su suma más ese separador. Tipo: [`RouterModelId`](#routermodelid) -- ID de modelo, por ejemplo `anthropic/claude-opus-4-6`, hasta 193 caracteres - Cuándo se obtuvo la tabla de tarifas con la que se calculó esta cotización. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor (un modelo que se factura al costo que informa su proveedor) lleva en su lugar la fecha en que se leyó esa lista. Una cotización cuya cantidad facturable se predice a partir de un calendario publicado por el proveedor y luego se tarifica con la tabla de tarifas lleva la más antigua entre la fecha de lectura de ese calendario y el momento en que se obtuvo la tabla, tanto para una respuesta `exact` como para una `estimated` (un modelo que se factura con los créditos que informa su proveedor es el caso `estimated`). La estimación no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, no en este instante. Siempre que no se leyó ninguna tabla de tarifas (`reason: pricing_unavailable`, `byok`, o una llamada `not_quotable` que no puede cotizarse con ninguna tabla), esto es el momento en que se respondió la cotización. + Cuándo se obtuvo la tarjeta de tarifas con la que se cotizó esta estimación. La estimación no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, no en este instante. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor (un modelo facturado por el costo que reporta el proveedor) lleva en su lugar la fecha en que se leyó esa lista. Una cotización cuya cantidad facturable se predice a partir de un calendario publicado por el proveedor y luego se tarifica con la tarjeta lleva la más antigua entre la fecha de lectura de ese calendario y la hora de obtención de la tarjeta, tanto para una respuesta `exact` como para una `estimated` (un modelo facturado por los créditos que reporta su proveedor es el caso `estimated`). Siempre que no se haya leído ninguna tarjeta de tarifas (`reason: pricing_unavailable`, `byok` o una llamada `not_quotable` que no se puede tarificar con ninguna tarjeta), esto es cuándo se respondió la cotización. date-time - - Presente solo cuando `source` es `unknown`: `not_quotable` (el Router no puede poner precio a esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no delimita una cantidad facturable), `unpriced_model` (la tabla de tarifas no da precio a esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella), o `pricing_unavailable` (solo envío en cola: no se pudo leer la tabla de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra igual que siempre). Interpreta cualquier otro valor como `not_quotable`. +Se presenta solo cuando `source` es `unknown`: `not_quotable` (Router no puede calcular el precio de esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no limita una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no tiene precio para esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella) o `pricing_unavailable` (solo envío en cola: no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra como de costumbre). Interpreta cualquier otro valor como `not_quotable`. ### RouterErrorResponse @@ -1125,60 +1181,60 @@ Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelos, cuo **Campos** - Descripción legible del fallo, apta para mostrarse a un usuario final. No se analiza automáticamente: en su lugar, ramifica según `error_type`. Para `model_not_found` en un modelo retirado, `detail` contiene ` was retired on ; use ` cuando hay un sucesor registrado y visible para quien llama, o solo ` was retired on ` cuando no lo hay, en lugar de la lista de sugerencias habitual. Un sucesor nombrado aquí es siempre un ID de catálogo vigente al que se puede redirigir la llamada. Un modelo cuya fecha de retiro todavía está en el futuro no está retirado: sigue apareciendo en `GET /v2/models` y se puede ejecutar hasta esa fecha. Como el resto de `detail`, este texto de retiro es solo para mostrar y no conlleva ninguna garantía de compatibilidad. Dos excepciones documentadas a la regla de no analizar automáticamente: en `POST /v2/models/{provider}/{model}` el `409` responde a tres condiciones no relacionadas que comparten el grupo `invalid_input`, y solo `detail` las distingue: un `detail` que empieza por "this request's `image` selects the edit operation" es el rechazo multipart de `model_provider`, y un `detail` que empieza por `this request resolved a BYOK credential` es el rechazo BYOK de `model_provider`; ninguno se resuelve con una nueva `Idempotency-Key`. Cualquier otro `409` de `invalid_input` en esa ruta es el conflicto de clave. Ambos prefijos son términos de contrato estables y se pueden comparar. En ningún otro caso ramificar según `detail` conlleva una garantía de compatibilidad. + Descripción legible por humanos del fallo, segura para mostrarla a un usuario final. No se analiza por máquina: en su lugar, ramifica según `error_type`. Para `model_not_found` en un modelo retirado, `detail` muestra ` was retired on ; use ` cuando hay un sucesor registrado y visible para quien llama, o solo ` was retired on ` cuando no lo hay, en lugar de la lista de sugerencias habitual. Un sucesor nombrado aquí siempre es un ID de catálogo activo al que se puede redirigir la llamada. Un modelo cuya fecha de retiro todavía está en el futuro no está retirado: sigue apareciendo en `GET /v2/models` y se puede ejecutar hasta esa fecha. Como el resto de `detail`, este texto sobre el retiro es solo para mostrar y no conlleva ninguna garantía de compatibilidad. Las dos excepciones documentadas a la regla de que no se analiza por máquina: en `POST /v2/models/{provider}/{model}` la respuesta `409` cubre tres condiciones no relacionadas que comparten la categoría `invalid_input`, y solo `detail` las distingue: un `detail` que comienza con "this request's `image` selects the edit operation" es el rechazo de `model_provider` en multipart, y un `detail` que comienza con `this request resolved a BYOK credential` es el rechazo de `model_provider` por BYOK; ninguna de las dos desaparece con un nuevo `Idempotency-Key`. Cualquier otra respuesta `409` de `invalid_input` en esa ruta es el conflicto de clave. Ambos prefijos son términos de contrato estables y se pueden comparar. En ningún otro caso, ramificar según `detail` conlleva una garantía de compatibilidad. - Grupo amplio y legible por máquina para un fallo del Router, replicado en el encabezado de respuesta `X-Comfy-Error-Type` para que quien llama pueda ramificar sin analizar el cuerpo. El conjunto está cerrado en veinte valores: los seis grupos de nivel de solicitud `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits` y `model_not_found`, más los de nivel de transporte `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full` y `result_expired`. «Cerrado» describe el conjunto tal como se documenta hoy, no un límite que se mantenga para siempre: se espera que el conjunto crezca, y por eso esto es deliberadamente una cadena simple y no un `enum`, de modo que un cliente debe tratar cualquier valor no reconocido como `internal_error` en lugar de hacer un switch exhaustivo sobre la lista anterior y romperse con la próxima adición. + Categoría general legible por máquina para un fallo del Router, replicada en el encabezado de respuesta `X-Comfy-Error-Type` para que quien llama pueda ramificar sin analizar el cuerpo. El conjunto está cerrado en veinte valores: las seis categorías de nivel de solicitud `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits` y `model_not_found`, más las de nivel de transporte `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full` y `result_expired`. Que el conjunto esté cerrado describe cómo se documenta hoy, no un límite que se mantenga para siempre: se espera que el conjunto crezca, por lo que esto es deliberadamente una cadena simple y no un `enum`, así que un cliente debe tratar cualquier valor no reconocido como `internal_error` en lugar de ramificar de forma exhaustiva sobre la lista anterior y romper con la próxima adición. Tipo: [`RouterErrorType`](#routererrortype) - Motivo acotado y saneado que dio el proveedor del modelo para rechazar la solicitud; solo está presente cuando `error_type` es `invalid_input` y `X-Comfy-Upstream-Status` es un `4xx` o `2xx` del proveedor, es decir, el proveedor rechazó la solicitud por malformada y explicó por qué. Normalmente ese estado es un `4xx`; es un `2xx` para un proveedor que informa de una generación rechazada dentro de una envoltura de éxito (una consulta de tarea fallida de BytePlus es HTTP `200` con el motivo en su cuerpo). Está ausente en cualquier otro fallo, incluidos los `5xx` del proveedor, los fallos de transporte, los rechazos por políticas de contenido y cualquier rechazo que el Router haya generado sobre sí mismo. Replica el encabezado `X-Comfy-Upstream-Detail`. + Un motivo acotado y saneado que dio el proveedor del modelo para rechazar la solicitud, presente solo cuando `error_type` es `invalid_input` y `X-Comfy-Upstream-Status` es un `4xx` o `2xx` del proveedor, es decir, cuando el proveedor rechazó la solicitud por estar mal formada e indicó por qué. Normalmente ese estado es un `4xx`; es un `2xx` para un proveedor que informa una generación rechazada dentro de una respuesta de éxito (una consulta de tarea fallida de BytePlus es HTTP `200` con el motivo en su cuerpo). Ausente en cualquier otro fallo, incluidos los `5xx` del proveedor, los fallos de transporte, los rechazos por política de contenido y cualquier rechazo que el Router haya generado sobre sí mismo. Replica el encabezado `X-Comfy-Upstream-Detail`. La consulta en cola (`GET /v2/models/{provider}/{model}/requests/{request_id}`) de una ejecución que terminó en `invalid_input` incluye el mismo motivo en este campo en su primera consulta, que luego lo elimina de la solicitud: una consulta posterior normalmente responde el mismo `error_type` y `detail` sin él, así que léelo en la primera consulta. Esa lectura no envía ninguno de los dos encabezados. - Sobre qué entrada o salida se produjo un rechazo por políticas de contenido, como vocabulario cerrado a nivel del Router: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. Los valores simples `input` / `output` indican el lado cuando el proveedor no especificó una modalidad. Solo está presente cuando `error_type` es `content_policy_violation` y el proveedor indicó el sujeto rechazado con un código legible por máquina; en caso contrario, está ausente. Nunca es texto del proveedor. Hoy se rellena para rechazos de BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI y Wan, y para los rechazos de Gemini de las vertientes Nano Banana del Router de MiniMax; un proveedor cuyo rechazo no indica de qué lado se trataba lo deja ausente. Replica el encabezado `X-Comfy-Refusal-Subject`. + Indica a qué entrada o salida se refería un rechazo por política de contenido, mediante un vocabulario cerrado a nivel del Router: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. Los valores simples `input` / `output` indican el lado cuando el proveedor no nombró una modalidad. Presente solo cuando `error_type` es `content_policy_violation` y el proveedor nombró el sujeto rechazado con un código legible por máquina; ausente en caso contrario. Nunca es texto del proveedor. Se informa hoy para los rechazos de BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI y Wan, y para los rechazos de Gemini de las variantes Nano Banana del Router de MiniMax; un proveedor cuyo rechazo no indica de qué lado se trataba lo deja ausente. Replica el encabezado `X-Comfy-Refusal-Subject`. - La rama de política de facturación para una denegación de gasto de un nodo asociado: `no_funds` cuando la cartera facturada está vacía, `unspecified` cuando la llamada se rechazó sin una lectura de fondos que lo indicara. Presente solo cuando `error_type` es `insufficient_credits` y el despliegue informa datos de la cartera; ausente en caso contrario. Es un código legible por máquina, no texto para mostrar: muestra `detail` y ramifica según este valor. + La rama de política de facturación para un rechazo de gasto de un nodo de socio: `no_funds` cuando la billetera facturada está vacía, `unspecified` cuando la llamada se rechazó sin una lectura de fondos que lo indique. Presente solo cuando `error_type` es `insufficient_credits` y el despliegue informa datos de la billetera; ausente en caso contrario. Es un código legible por máquina, no texto para mostrar: muestra `detail`, ramifica según este valor. - La cartera a la que se habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a «¿qué cartera está vacía?»: no es necesariamente el espacio de trabajo que la interfaz del llamador tiene seleccionado, y la credencial personal de un miembro del equipo nombra aquí su cartera personal incluso mientras hay un equipo con fondos abierto. Presente solo junto con `denied_reason`. + La billetera que habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a "¿qué billetera está vacía?": no es necesariamente el espacio de trabajo que la interfaz de quien llama tiene seleccionado en este momento, y la credencial personal de un miembro del equipo nombra aquí su billetera personal incluso mientras está abierto un equipo con fondos. Presente solo junto con `denied_reason`. Tipo: [`RouterBilledWorkspace`](#routerbilledworkspace) - Cómo se autenticó la solicitud rechazada: `personal_api_key`, `team_api_key`, `personal_session` o `team_session`. Responde a «¿a qué credencial cambio para facturar a la otra cartera?». No es un permiso y no concede nada. Presente solo junto con `denied_reason`. + Cómo se autenticó la solicitud rechazada: `personal_api_key`, `team_api_key`, `personal_session` o `team_session`. Responde a "¿a qué credencial cambio para facturar a la otra billetera?". No es un permiso y no otorga nada. Presente solo junto con `denied_reason`. ### RouterErrorType -Categoría de error del Router legible por máquina, que también se envía en el encabezado `X-Comfy-Error-Type`. +Categoría de error del Router legible por máquina, que además se envía en el encabezado `X-Comfy-Error-Type`. Tipo: `string` ### RouterModelBilling -Comportamiento de facturación que debes revisar antes de invocar un modelo. No incluye precios ni uso. +Comportamiento de facturación que debes verificar antes de invocar un modelo. No incluye precios ni uso. **Campos** - Si una llamada que este modelo rechaza por motivos de política de contenido se cobra de todos modos a quien realiza la llamada. Los proveedores difieren, la diferencia es invisible en el momento de la llamada, y un usuario que ve un error y un cargo por la misma llamada no tendría forma de saberlo, así que se indica por modelo, antes de la llamada, en lugar de dejarlo a la tradición de cada proveedor. Cuando es `yes`, un error `content_policy_violation` en la ruta síncrona puede incluir `X-Comfy-Credits-Used`: lo hace cuando el proveedor rechazó la salida generada por el modelo y Comfy registró uso para esa generación rechazada, y entonces incluye ese importe. Un rechazo del lado de la entrada, una repetición con la misma clave (`Idempotent-Replayed: true`) y un cargo demasiado pequeño para verse en los dos decimales del encabezado no lo incluyen; un rechazo sin el encabezado no se informa, y eso no prueba que fuera gratis. + Si una llamada que este modelo rechaza por motivos de política de contenido se cobra de todos modos al solicitante. Los proveedores difieren, la diferencia es invisible en el momento de la llamada, y un usuario que ve un error y un cargo por la misma llamada no tiene forma de haberlo sabido, así que se indica por modelo, antes de la llamada, en lugar de dejarlo al folclore de cada proveedor. Cuando es `yes`, un error `content_policy_violation` en la ruta síncrona puede llevar `X-Comfy-Credits-Used`: lo lleva cuando el proveedor rechazó la salida generada por el modelo y Comfy registró uso para esa generación rechazada, y lleva esa cantidad. Un rechazo del lado de la entrada, una repetición con la misma clave (`Idempotent-Replayed: true`) y un cargo demasiado pequeño para mostrarse en los dos decimales del encabezado no lo llevan; un rechazo sin el encabezado no se reporta, no es prueba de que haya sido gratis. Tipo: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -Detalle por modelo de un modelo de Comfy Router: todo lo que el listado del catálogo reporta para ese modelo, más los campos por modelo que solo incluye la ruta de modelo único. +Detalle por modelo de un modelo de Comfy Router: todo lo que el listado del catálogo reporta para él, más los campos por modelo que solo incluye la ruta de modelo único. -Combina [`RouterModelListEntry`](#routermodellistentry) y [`RouterModelDetailFields`](#routermodeldetailfields). +Compone [`RouterModelListEntry`](#routermodellistentry) y [`RouterModelDetailFields`](#routermodeldetailfields). Tipo: `object` @@ -1191,14 +1247,14 @@ Campos opcionales que devuelve el endpoint de detalles del modelo. URL del documento OpenAPI de este modelo, incluidos sus esquemas de entrada y salida. - URL HTTPS, por ejemplo, `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, hasta 2048 caracteres + URL HTTPS, p. ej. `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, hasta 2048 caracteres ### RouterModelId -El ID del modelo que se usa en `POST /v2/models/{provider}/{model}`. +El ID de modelo que se usa en `POST /v2/models/{provider}/{model}`. -Tipo: `string`. ID del modelo, p. ej. `anthropic/claude-opus-4-6`. Hasta 193 caracteres. +Tipo: `string`: ID de modelo, p. ej. `anthropic/claude-opus-4-6`, hasta 193 caracteres ### RouterModelInput @@ -1219,19 +1275,19 @@ El ID de un modelo y sus datos de facturación. **Campos** - Un ID de modelo canónico de Comfy Router, `{provider}/{model}`: exactamente el valor que direcciona el modelo en `POST /v2/models/{provider}/{model}`, así que quien llama puede interpolarlo en esa ruta sin volver a derivarlo de otra cosa. Su `pattern` es `RouterProviderSegment` y `RouterModelSegment` unidos por un solo `/`, y `maxLength` es su suma más ese separador. + Un ID canónico de modelo de Comfy Router, `{provider}/{model}`, exactamente el valor que direcciona el modelo en `POST /v2/models/{provider}/{model}`, de modo que quien llama puede interpolarlo en esa ruta sin volver a derivarlo de nada. Su `pattern` es `RouterProviderSegment` y `RouterModelSegment` unidos por un único `/`, y `maxLength` es su suma más ese separador. Tipo: [`RouterModelId`](#routermodelid) -- ID de modelo, p. ej. `anthropic/claude-opus-4-6`, hasta 193 caracteres - Segmento `provider` en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está direccionando. El parámetro de ruta `provider` de la ruta de invocación y el campo `provider` de una entrada de catálogo hacen referencia a este mismo esquema, y eso es lo que evita que los IDs listados y los IDs aceptados se separen con el tiempo. + Segmento `provider` en minúsculas del ID canónico de modelo `{provider}/{model}`, es decir, el socio cuyo modelo se está direccionando. El parámetro de ruta `provider` de la ruta de invocación y el campo `provider` de una entrada del catálogo referencian ambos este mismo esquema, y eso es justamente lo que evita que los IDs listados y los IDs aceptados se vayan separando. Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Segmento `model` en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. Lo comparten el parámetro de ruta `model` de la ruta de invocación y el campo `model` de una entrada de catálogo, por la misma razón de evitar divergencias que en `RouterProviderSegment`. + Segmento `model` en minúsculas del ID canónico de modelo `{provider}/{model}`, es decir, el modelo que se va a ejecutar dentro de ese proveedor. Lo comparten el parámetro de ruta `model` de la ruta de invocación y el campo `model` de una entrada del catálogo, por la misma razón de evitar divergencias que en `RouterProviderSegment`. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres @@ -1243,33 +1299,33 @@ El ID de un modelo y sus datos de facturación. - El `ETag` fuerte actual del documento `GET /v2/models/{provider}/{model}/openapi.json` de este modelo. Envíalo como `If-None-Match` en esa lectura para obtener un `304` mientras el esquema no cambie, o compáralo con el valor visto la última vez para saber qué esquemas de modelos cambiaron sin descargar todos los documentos. Está ausente siempre que esa lectura no vaya a responder `200` para quien llama en este momento: el servicio de esquemas no está disponible, el documento del modelo no se puede renderizar, o el modelo dejó de estar disponible para quien llama mientras se construía la respuesta. Una etiqueta ausente no es un cambio de esquema; vuelve a leer el documento del modelo para conocer su etiqueta actual. + El `ETag` fuerte actual del documento `GET /v2/models/{provider}/{model}/openapi.json` de este modelo. Envíalo como `If-None-Match` en esa lectura para obtener un `304` mientras el esquema no cambie, o compáralo con el valor visto la última vez para saber qué esquemas de modelos cambiaron sin descargar todos los documentos. Está ausente siempre que esa lectura no vaya a responder `200` a quien llama en este momento: el servicio de esquemas no está disponible, el documento del modelo no se puede renderizar, o el modelo dejó de estar disponible para quien llama mientras se construía la respuesta. Una etiqueta ausente no es un cambio de esquema; vuelve a leer el documento del modelo para conocer su etiqueta actual. ### RouterModelListResponse -Una página del catálogo de modelos del Router. +Una página del catálogo de modelos de Router. **Campos** - + Los modelos de esta página, como máximo `limit` de ellos. - Tipo: array de [`RouterModelListEntry`](#routermodellistentry) + Tipo: arreglo de [`RouterModelListEntry`](#routermodellistentry) - - Indica si existe otra página después de esta. Sigue avanzando mientras sea verdadero; no deduzcas el final del catálogo a partir de un `data` corto o vacío. + + Indica si existe otra página después de esta. Sigue avanzando mientras esto sea verdadero; no deduzcas el final del catálogo a partir de un `data` corto o vacío. - Un cursor opaco hacia una lista del Router. Lo produce el servidor y solo se reenvía tal cual: no es un offset, no es un ID de modelo, no está ordenado y no es estable entre reconstrucciones del catálogo, así que analizarlo, incrementarlo o persistirlo más allá del recorrido del que proviene queda fuera del contrato. Se usa un cursor en lugar de un offset porque el catálogo es una lista cambiante: un recorrido por offset omite o repite entradas de forma silenciosa cuando se agregan o quitan entradas a mitad del recorrido, y quien llama no puede detectar que eso ocurrió. + Un cursor opaco dentro de una lista de Router. Lo produce el servidor y solo se reenvía tal cual: no es un desplazamiento, no es un ID de modelo, no está ordenado y no es estable entre reconstrucciones del catálogo; por lo tanto, analizarlo, incrementarlo o persistirlo más allá del recorrido del que provino quedan fuera del contrato. Se usa un cursor en lugar de un desplazamiento porque el catálogo es una lista en movimiento: un recorrido por desplazamiento omite o repite entradas de forma silenciosa cuando se agregan o eliminan entradas a mitad del recorrido, y quien llama no puede detectar que eso ocurrió. - Tipo: [`RouterPageCursor`](#routerpagecursor) -- Cursor opaco devuelto como `next_cursor`, de 1 a 512 caracteres + Tipo: [`RouterPageCursor`](#routerpagecursor): cursor opaco devuelto como `next_cursor`, de 1–512 caracteres - - El tamaño de página que realmente se entregó. Un `limit` solicitado por encima del máximo se ajusta al máximo en lugar de rechazarse, así que puede ser menor que el valor pedido: pagina con este número, no con el que enviaste, o supondrás filas que nunca recibiste. + + El tamaño de página que realmente se entregó. Un `limit` solicitado que supere el máximo se ajusta al máximo en lugar de rechazarse, así que este valor puede ser menor que el solicitado: pagina con este número, no con el que enviaste, o asumirás filas que nunca recibiste. 1–100 @@ -1282,51 +1338,51 @@ Tipo: `object` ### RouterModelSegment -La parte del modelo de un ID de modelo `{provider}/{model}`. +La parte del modelo en un ID de modelo con formato `{provider}/{model}`. -Tipo: `string`. Slug alfanumérico, p. ej. `claude-opus-4-6`, de hasta 128 caracteres +Tipo: `string` -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, de hasta 128 caracteres ### RouterPageCursor Un cursor de catálogo opaco. Devuélvelo sin cambios como `cursor`. -Tipo: `string`. Cursor opaco devuelto como `next_cursor`, de 1 a 512 caracteres. +Tipo: `string` -- Cursor opaco devuelto como `next_cursor`, de 1 a 512 caracteres. ### RouterProviderSegment La parte del proveedor de un ID de modelo `{provider}/{model}`. -Tipo: `string`: slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres +Tipo: `string`. Slug alfanumérico, p. ej. `anthropic`. Hasta 64 caracteres. ### RouterQueueCancelResponse -La respuesta a una solicitud de cancelación en los dos estados que describen una solicitud que esta ruta resolvió: el `202` y el `409`. Una sola forma de cuerpo para ambos en lugar de un envelope de éxito más un envelope de error, porque ambos son la misma afirmación (lo que encontró la cancelación) y un cliente que tiene que analizar un tipo distinto por código de estado no gana nada con la separación. +La respuesta a una solicitud de cancelación para los dos estados que describen una solicitud que esta ruta resolvió: el `202` y el `409`. Una sola forma de cuerpo para ambos en lugar de un sobre de éxito más un sobre de error, porque ambos son la misma declaración (lo que encontró la cancelación), y un cliente que tiene que analizar un tipo distinto por código de estado no gana nada con la división. **Campos** - Identificador de una solicitud de Router en cola: el identificador por el que un cliente consulta, cancela y recoge un resultado. + Identificador de una solicitud de Router en cola: el identificador mediante el cual un cliente consulta, cancela y recoge un resultado. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) (`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres) - Lo que encontró una solicitud de cancelación, para los dos resultados que describen una solicitud que esta ruta efectivamente resolvió. Ambos se reflejan en el estado HTTP, así que un cliente puede ramificar según cualquiera de los dos. + Lo que encontró una solicitud de cancelación, para los dos resultados que describen una solicitud que esta ruta resolvió realmente. El estado HTTP refleja ambos, así que un cliente puede ramificar según cualquiera de los dos. Tipo: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -Qué encontró una solicitud de cancelación, para los dos resultados que describen una solicitud que esta ruta realmente resolvió. Ambos se reflejan en el estado HTTP, así que un cliente puede ramificar según cualquiera de los dos. +Lo que encontró una solicitud de cancelación, para los dos resultados que describen una solicitud que esta ruta resolvió realmente. Ambos quedan reflejados en el estado HTTP, así que un cliente puede ramificar según cualquiera de los dos. Tipo: `string` ### RouterQueuePosition -Cuántas solicitudes hay por delante de esta en la cola, en el instante en que se compuso la respuesta. Cero significa que esta solicitud está al frente. +Cuántas solicitudes van delante de esta en la cola, en el instante en que se compuso la respuesta. Cero significa que esta solicitud está al frente. -Tipo: `integer` -- Al menos 0 +Tipo: `integer`. Al menos 0 ### RouterQueueRequestId @@ -1336,24 +1392,24 @@ Tipo: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0- ### RouterQueueStatus -El estado de una solicitud Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas están cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica los fallos y se espera que su conjunto crezca, por lo que un cliente generado que rechazara de forma estricta un bucket no reconocido fallaría más justo cuando algo ya hubiera salido mal. Este es un ciclo de vida, y un ciclo de vida al que se le añade más tarde un cuarto estado es un cambio incompatible para todos los bucles de sondeo escritos contra él, se declare como enum o no, así que se declara como uno y la restricción se indica donde un cliente pueda verla. +El estado de una solicitud de Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas están cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta una categoría no reconocida fallaría de la peor manera justo cuando algo ya había salido mal. Este es un ciclo de vida, y un ciclo de vida al que más adelante se le añada un cuarto estado es un cambio incompatible para todos los bucles de sondeo escritos contra él, se declare o no como enum; por eso se declara como uno, y la restricción se indica donde un cliente puede verla. Tipo: `string` ### RouterQueueStatusFields -La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad de una solicitud en cola, su estado actual y, cuando ese estado es terminal y la ejecución no tuvo éxito, el grupo genérico que indica por qué. +La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad de una solicitud en cola, su estado actual y, cuando ese estado es terminal y la ejecución no tuvo éxito, el grupo general que indica por qué. **Campos** - Identificador de una solicitud en cola del Router: el identificador que usa quien llama para consultar, cancelar y recoger un resultado. + Identificador de una solicitud en cola del Router: el identificador con el que quien llama consulta, cancela y recoge un resultado. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres - El estado de una solicitud en cola del Router. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas son cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta un grupo no reconocido fallaría con más fuerza justo cuando algo ya había salido mal. Este es un ciclo de vida, y un ciclo de vida al que más tarde se le añade un cuarto estado es un cambio incompatible para todos los bucles de polling escritos contra él, se declare como enum o no; por eso se declara como uno y la restricción se indica donde un cliente puede verla. + El estado de una solicitud en cola del Router. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas son cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta un grupo no reconocido fallaría con más fuerza justo cuando algo ya había salido mal. Este es un ciclo de vida, y un ciclo de vida con un cuarto estado añadido más tarde es un cambio incompatible para todos los bucles de consulta escritos contra él, se declare como enum o no. Por eso se declara como uno, y la restricción se indica donde un cliente puede verla. Tipo: [`RouterQueueStatus`](#routerqueuestatus) @@ -1365,7 +1421,7 @@ La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad - Presente solo en una solicitud `COMPLETED` que no tuvo éxito, y lleva el mismo grupo genérico que la lectura del resultado pone en `X-Comfy-Error-Type` cuando devuelve ese fallo. Es lo que distingue una solicitud terminal que tuvo éxito de una que falló o se canceló (no hay un estado terminal separado para ninguna de las dos), y está ausente en caso de éxito en lugar de ser null, así que ramifica en función de su presencia. + Presente solo en una solicitud `COMPLETED` que no tuvo éxito, y contiene el mismo grupo general que la lectura del resultado pone en `X-Comfy-Error-Type` cuando devuelve ese fallo. Es lo que distingue una solicitud terminal que tuvo éxito de una que falló o se canceló (no hay un estado terminal separado para ninguna de las dos), y está ausente en caso de éxito en lugar de ser null, así que comprueba su presencia. Tipo: [`RouterErrorType`](#routererrortype) @@ -1374,62 +1430,62 @@ La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad Estado actual de una solicitud en cola, compuesto con las mismas tres URL que devolvió el envío. -Compone [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueStatusFields`](#routerqueuestatusfields). +Compone [`RouterQueueUrls`](#routerqueueurls) y [`RouterQueueStatusFields`](#routerqueuestatusfields). Tipo: `object` ### RouterQueueSubmitFields -La mitad de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad de la nueva solicitud y su estado en el instante en que fue admitida. +La parte de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad de la nueva solicitud y su estado en el instante en que se admitió. **Campos** - Identificador de una solicitud de Router en cola: el identificador con el que un llamador consulta, cancela y recoge un resultado. + Identificador de una solicitud de Router en cola: el identificador con el que quien llama consulta, cancela y recoge un resultado. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid): `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres - El estado de una solicitud de Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas se cierran en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta una categoría no reconocida fallaría con más fuerza justo cuando algo ya había salido mal. Este otro es un ciclo de vida, y añadir más tarde un cuarto estado a un ciclo de vida es un cambio incompatible para todo bucle de consulta escrito contra él, se declare como enum o no; por eso se declara como uno, y la restricción se indica donde un cliente puede verla. + El estado de una solicitud de Router en cola. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas están cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta una categoría no reconocida fallaría de la forma más grave justo cuando algo ya había salido mal. Este es un ciclo de vida, y añadir más tarde un cuarto estado a un ciclo de vida es un cambio incompatible para todos los bucles de sondeo escritos contra él, tanto si se declara como enum como si no. Por eso se declara como tal, y la restricción se indica donde un cliente puede verla. Tipo: [`RouterQueueStatus`](#routerqueuestatus) - Cuántas solicitudes hay delante de esta en la cola, en el instante en que se compuso la respuesta. Cero significa que esta solicitud está al frente. + Cuántas solicitudes hay por delante de esta en la cola, en el instante en que se compuso la respuesta. Cero significa que esta solicitud está al frente. - Tipo: [`RouterQueuePosition`](#routerqueueposition) -- Al menos 0 + Tipo: [`RouterQueuePosition`](#routerqueueposition): al menos 0 - La estimación de costo previa para esta solicitud, presente en una admisión nueva cuando la estimación de costo está habilitada para el llamador. Cotiza el tramo del proveedor al que se fijó esta solicitud (la cola no tiene bucle de respaldo, así que `fallback_provider` nunca cambia el tramo que se ejecuta). Cuando no se puede dar una cifra, sigue presente, con `source: unknown`; el envío nunca falla por la estimación. Se omite en una repetición idempotente (`Idempotent-Replayed: true`), porque la cotización original no se almacena. Es una estimación, no el cargo final, y no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es definitivo. + La estimación de costo previa a la ejecución para esta solicitud, presente en una admisión nueva cuando la estimación de costo está habilitada para quien llama. Cotiza el tramo del proveedor al que está fijada esta solicitud (la cola no tiene un bucle de respaldo, así que `fallback_provider` nunca cambia el tramo que se ejecuta). Cuando no se puede dar una cifra, sigue presente, con `source: unknown`; el envío nunca falla por la estimación. Se omite en una repetición idempotente (`Idempotent-Replayed: true`), porque no se almacena la cotización original. Es una estimación, no el cargo final, y no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, y el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es definitivo. Tipo: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -El identificador que se devuelve cuando una ejecución se admite en la cola: la identidad y el estado de la solicitud, compuesto con las tres URL que direccionan el resto de su ciclo de vida. +El identificador devuelto cuando la cola admite una ejecución: la identidad y el estado de la solicitud, junto con las tres URL que abarcan el resto de su ciclo de vida. -Está compuesto por [`RouterQueueUrls`](#routerqueueurls) y [`RouterQueueSubmitFields`](#routerqueuesubmitfields). +Combina [`RouterQueueUrls`](#routerqueueurls) y [`RouterQueueSubmitFields`](#routerqueuesubmitfields). Tipo: `object` ### RouterQueueUrls -Las tres URL que abarcan el resto del ciclo de vida de una solicitud en cola y que se devuelven en cada respuesta que incluye un handle activo, para que el cliente nunca tenga que componer por su cuenta una URL de cola. +Las tres URL que abarcan el resto del ciclo de vida de una solicitud en cola; se devuelven en cada respuesta que incluye un handle activo para que el cliente nunca tenga que componer por su cuenta una URL de cola. **Campos** - URL absoluta de la lectura de estado de esta solicitud. + URL absoluta de lectura del estado de esta solicitud. URI - URL absoluta desde la que se recopila el resultado de esta solicitud. + URL absoluta desde la que se recoge el resultado de esta solicitud. URI @@ -1442,7 +1498,7 @@ Las tres URL que abarcan el resto del ciclo de vida de una solicitud en cola y q ### RouterValidationErrorContext -Detalles proporcionados por el proveedor sobre la regla de validación que falló. +Detalles proporcionados por el proveedor acerca de la regla de validación que falló. Tipo: `object` @@ -1453,25 +1509,25 @@ Un fallo de validación a nivel de campo. **Campos** - Ruta al campo que causó el error, con el segmento más externo primero; por ejemplo `["body", "image_url"]`, o `["body", "images", 0]` donde un entero indexa dentro de un arreglo. + Ruta al campo infractor, con el segmento más externo primero. Por ejemplo, `["body", "image_url"]`, o `["body", "images", 0]` donde un entero indexa dentro de un arreglo. - Descripción legible para humanos de este fallo individual. + Descripción legible por humanos de este único fallo. - Motivo específico y legible por máquina de este fallo, que el proveedor entrega sin cambios. Es el valor sobre el que se ramifica una jerarquía tipada de excepciones del SDK; `error_type` en el encabezado de la respuesta es solo su categoría general. + Motivo específico y legible por máquina de este fallo, transmitido desde el proveedor sin cambios. Este es el valor sobre el que ramifica una jerarquía de excepciones tipadas del SDK; `error_type` en la cabecera de la respuesta es solo su categoría general. - El límite violado para un `RouterValidationErrorDetail`, tomado literalmente del proveedor; por ejemplo `{"limit_value": 8}` junto con `greater_than`, `{"min_width": 512}` junto con `image_too_small`, o `{"max_size_bytes": 10485760}` junto con `file_too_large`. El conjunto de claves es específico del proveedor y del tipo de error, así que este objeto es deliberadamente abierto: reducirlo a una lista fija de campos, o incorporarlo a la cadena `msg`, es justo la forma en que una integración portada compila y luego pierde en silencio la rama que leía el límite. No está presente cuando el tipo de error no lleva ningún límite. + El límite violado para un `RouterValidationErrorDetail`, transmitido literalmente desde el proveedor. Por ejemplo, `{"limit_value": 8}` junto a `greater_than`, `{"min_width": 512}` junto a `image_too_small`, o `{"max_size_bytes": 10485760}` junto a `file_too_large`. El conjunto de claves es específico del proveedor y del tipo de error, así que deliberadamente es un objeto abierto: restringirlo a una lista fija de campos, o plegarlo dentro de la cadena `msg`, es precisamente cómo una integración portada compila y luego pierde silenciosamente la rama que leía el límite. Ausente cuando el tipo de error no lleva un límite. Tipo: [`RouterValidationErrorContext`](#routervalidationerrorcontext) - El valor de entrada que causó el error, devuelto literalmente para que quien llama pueda ver qué se rechazó sin volver a deducirlo a partir de `loc`. Puede ser cualquier tipo JSON (cadena, número, booleano, arreglo, objeto o null), por lo que este esquema se deja deliberadamente sin tipar en lugar de reducirlo a un objeto. No está presente cuando el proveedor no devuelve la entrada. + El valor de entrada infractor, devuelto literalmente para que quien llama pueda ver qué se rechazó sin volver a derivarlo desde `loc`. Cualquier tipo JSON (cadena, número, booleano, arreglo, objeto o null), por lo que este esquema se deja deliberadamente sin tipo en lugar de restringirse a un objeto. Ausente cuando el proveedor no devuelve la entrada. Tipo: [`RouterValidationErrorInput`](#routervalidationerrorinput) @@ -1482,12 +1538,12 @@ El valor de entrada rechazado, cuando el proveedor lo incluye. ### RouterValidationErrorResponse -El cuerpo del error de validación `422`. Lee `X-Comfy-Error-Type` para conocer su categoría. +El cuerpo del error de validación `422`. Consulta `X-Comfy-Error-Type` para conocer su categoría. **Campos** - Todos los fallos de validación encontrados en la solicitud, una entrada por cada campo no válido. + Cada fallo de validación encontrado en la solicitud, una entrada por campo con problemas. Tipo: array de [`RouterValidationErrorDetail`](#routervalidationerrordetail) From 0f64ccd070c47f93a9499ff108abde6a17d8c682 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:03:47 +0800 Subject: [PATCH 04/36] i18n(es): sync router model pages with upstream/main (2026-11-10) --- .../models/kling/kling-v2-6/code.mdx | 25 +- .../models/kling/kling-v3/code.mdx | 30 +- .../pika/pika-h3-flex-image-to-video/code.mdx | 308 ++++++++++++++++ .../pika-h3-flex-reference-to-video/code.mdx | 337 ++++++++++++++++++ .../pika/pika-h3-flex-text-to-video/code.mdx | 294 +++++++++++++++ .../models/stability/control-sketch/code.mdx | 241 +++++++++++++ .../models/stability/control-style/code.mdx | 253 +++++++++++++ .../models/stability/generate-core/code.mdx | 243 +++++++++++++ .../stability/sdxl-1-0-masking/code.mdx | 298 ++++++++++++++++ .../stability/upscale-creative/code.mdx | 243 +++++++++++++ 10 files changed, 2255 insertions(+), 17 deletions(-) create mode 100644 es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx create mode 100644 es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx create mode 100644 es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx create mode 100644 es/development/comfy-router/models/stability/control-sketch/code.mdx create mode 100644 es/development/comfy-router/models/stability/control-style/code.mdx create mode 100644 es/development/comfy-router/models/stability/generate-core/code.mdx create mode 100644 es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx create mode 100644 es/development/comfy-router/models/stability/upscale-creative/code.mdx diff --git a/es/development/comfy-router/models/kling/kling-v2-6/code.mdx b/es/development/comfy-router/models/kling/kling-v2-6/code.mdx index eb607dc8cd..ed0456a01d 100644 --- a/es/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,21 +2,22 @@ title: "Usa Kling V2.6 con Comfy Router" description: "Llama a kling/kling-v2-6 con Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Kling V2.6" -translationSourceHash: c445a7bd +translationSourceHash: 94eb0863 translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: - "_intro": 04868509 + "_intro": c2065202 "Quick start": 48a3d970 - "Schema": a61a551f + "Schema": cd52808d "Examples": 8623c725 --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/kling/kling-v2-6.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; Referencia de API para `kling/kling-v2-6`, servida por Comfy Router de Kling. -**Entrada:** Texto · **Salida:** Video +**Entrada:** Imagen, Texto · **Salida:** Video ## Inicio rápido @@ -288,21 +289,29 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; haz referencia a ellas en `prompt` como \<\<\>> y \<\<\>> según el orden de la lista. Requiere `sound` establecido en "on", lo cual solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o con `sound` en su valor predeterminado "off", las voces no se aplican. + Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; referéncialas en `prompt` como \<\<\>> y \<\<\>> en el orden de la lista. Requiere que `sound` esté establecido en "on", lo cual solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o si `sound` se deja en su valor predeterminado "off", las voces no se aplican. - ID de voz devuelto a través de la API de personalización de voces o un ID de voz predefinido del sistema. + ID de voz devuelto por la API de personalización de voces o un ID de voz preestablecido del sistema. - Indica si se generan resultados con marca de agua simultáneamente. Actualmente no se admiten marcas de agua personalizadas. + Indica si se generan resultados con marca de agua de forma simultánea. Actualmente no se admiten marcas de agua personalizadas. true significa generar marca de agua, false significa no generarla. + + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10 MB, la resolución no debe ser inferior a 300*300 px y la relación de aspecto debe estar entre 1:2.5 ~ 2.5:1. Base64 no debe incluir el prefijo data:image. + + + + Imagen de referencia: control de fotograma final. URL o cadena codificada en Base64, no puede superar los 10 MB, la resolución no debe ser inferior a 300*300 px. Base64 no debe incluir el prefijo data:image. No se puede usar simultáneamente con dynamic_masks/static_mask o camera_control. + + Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v2-6/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -320,7 +329,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v2 - Las unidades de deducción de la tarea + Unidades de deducción de la tarea diff --git a/es/development/comfy-router/models/kling/kling-v3/code.mdx b/es/development/comfy-router/models/kling/kling-v3/code.mdx index a242905aec..6826f0fb7c 100644 --- a/es/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,22 +2,23 @@ title: "Usa Kling V3 con Comfy Router" description: "Llama a kling/kling-v3 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Kling V3" -translationSourceHash: e07d4035 +translationSourceHash: f5127eab translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: - "_intro": 74a12e0f + "_intro": 6b9cddba "Quick start": 09c0a41a - "Serving providers": a8b20c72 - "Schema": 8e8b04e6 + "Serving providers": b4093d36 + "Schema": 2fce4523 "Examples": 8623c725 --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/kling/kling-v3.json mediante `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; Referencia de API para `kling/kling-v3`, proporcionada por Comfy Router de Kling. -**Entrada:** Texto · **Salida:** Video +**Entrada:** Imagen, Texto · **Salida:** Video ## Inicio rápido @@ -156,11 +157,14 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ ## Proveedores que lo sirven -Comfy Router sirve este modelo directamente a menos que la solicitud indique otro proveedor. Los proveedores siguientes también lo sirven, en el mismo endpoint y con el mismo ID de modelo, y se seleccionan con el parámetro de consulta `model_provider`. +Comfy Router presta este modelo directamente a menos que la solicitud indique otro proveedor. Los proveedores siguientes también lo sirven, en el mismo endpoint y con el mismo ID de modelo, y se seleccionan con el parámetro de consulta `model_provider`. - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/kling/kling-v3` - **Higgsfield**, como `higgsfield/higgsfield-kling-3-std`: `POST https://api.comfy.org/v2/models/kling/kling-v3?model_provider=higgsfield` - **Tencent**: `POST https://api.comfy.org/v2/models/kling/kling-v3?model_provider=tencent` + - Límites: 720P, sin sonido; de 3 a 15 segundos (5 de forma predeterminada); relación de aspecto 16:9, 9:16 o 1:1 + - Se rechazan con `invalid_input`: `image`, `image_tail`, `sound: "on"`, `mode` distinto de `std` (por ejemplo, `"pro"`), `multi_shot`, `multi_prompt`, `shot_type` + - Respaldo: si Tencent falla, la solicitud se reintenta una vez en Kling (el proveedor predeterminado). Envía `fallback_provider=false` para desactivarlo. Las entradas rechazadas y las solicitudes BYOK no recurren al respaldo. `strict_mode` tiene como valor predeterminado falso, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la Referencia de la API, y [Proveedores que lo sirven](/es/development/comfy-router/providers) para todos los modelos enrutados de esta forma. @@ -299,21 +303,29 @@ Comfy Router sirve este modelo directamente a menos que la solicitud indique otr - Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; referéncialas en `prompt` como \<\<\>> y \<\<\>> según el orden de la lista. Requiere `sound` establecido en “on”, que solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o con `sound` en su valor predeterminado “off”, las voces no se aplican. + Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; referéncialas en `prompt` como \<\<\>> y \<\<\>> según el orden de la lista. Requiere que `sound` esté en "on", algo que solo admiten las versiones V2.6 y posteriores del modelo; en una versión anterior, o si `sound` se deja en su valor predeterminado "off", las voces no se aplican. - ID de voz devuelto por la API de personalización de voces o un ID de voz preestablecido del sistema. + ID de voz devuelto a través de la API de personalización de voces o un ID de voz preestablecido del sistema. - Indica si se generan resultados con marca de agua simultáneamente. Actualmente no se admite una marca de agua personalizada. + Indica si se generan resultados con marca de agua simultáneamente. Actualmente no se admite la marca de agua personalizada. true significa generar marca de agua, false significa no generarla. + + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, la resolución no puede ser inferior a 300*300px, la relación de aspecto debe estar entre 1:2.5 ~ 2.5:1. Base64 no debe incluir el prefijo data:image. + + + + Imagen de referencia: control del fotograma final. URL o cadena codificada en Base64, no puede superar los 10MB, la resolución no puede ser inferior a 300*300px. Base64 no debe incluir el prefijo data:image. No se puede usar simultáneamente con dynamic_masks/static_mask ni con camera_control. + + Generado a partir del esquema que Router expone en `GET /v2/models/kling/kling-v3/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida diff --git a/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx b/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx new file mode 100644 index 0000000000..f034f72fe3 --- /dev/null +++ b/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx @@ -0,0 +1,308 @@ +--- +title: "Usa Pika H3 Flex Image To Video con Comfy Router" +description: "Llama a pika/pika-h3-flex-image-to-video con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Pika H3 Flex Image To Video" +translationSourceHash: fbf61f76 +translationFrom: development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx +translationBlockHashes: + "_intro": 17b05692 + "Quick start": d6384744 + "Schema": af5724ab + "Examples": 01f7aa37 +--- + +{/* ARCHIVO GENERADO. Generado desde router-schemas/pika/pika-h3-flex-image-to-video.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API para `pika/pika-h3-flex-image-to-video`, servido por Comfy Router desde Pika. + +**Entrada:** Texto, Imagen · **Salida:** Video + Audio + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. + +**ID del modelo:** `pika/pika-h3-flex-image-to-video` + +**Endpoint:** `POST https://api.comfy.org/v2/models/pika/pika-h3-flex-image-to-video` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "pika/pika-h3-flex-image-to-video", + { + "duration": 5, + "image": "https://example.invalid/pika/first-frame.png", + "prompt": "The camera slowly pushes in as the leaves begin to sway in the wind", + "resolution": "480p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("pika/pika-h3-flex-image-to-video", { + duration: 5, + image: "https://example.invalid/pika/first-frame.png", + prompt: "The camera slowly pushes in as the leaves begin to sway in the wind", + resolution: "480p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-image-to-video \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"duration\": 5, \"image\": \"https://example.invalid/pika/first-frame.png\", \"prompt\": \"The camera slowly pushes in as the leaves begin to sway in the wind\", \"resolution\": \"480p\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/pika/pika-h3-flex-image-to-video/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y recoges el resultado cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pika/pika-h3-flex-image-to-video", + { + "duration": 5, + "image": "https://example.invalid/pika/first-frame.png", + "prompt": "The camera slowly pushes in as the leaves begin to sway in the wind", + "resolution": "480p", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Sondea hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("pika/pika-h3-flex-image-to-video", { + duration: 5, + image: "https://example.invalid/pika/first-frame.png", + prompt: "The camera slowly pushes in as the leaves begin to sway in the wind", + resolution: "480p", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Sondea hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-image-to-video/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"duration\": 5, \"image\": \"https://example.invalid/pika/first-frame.png\", \"prompt\": \"The camera slowly pushes in as the leaves begin to sway in the wind\", \"resolution\": \"480p\"}" + +# 2. Sondea hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pika/pika-h3-flex-image-to-video/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se está ejecutando. +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-image-to-video/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Relación de aspecto de salida. `auto` elige una a partir del prompt y de las entradas de medios. Omítela para que Pika elija: `auto` cuando `rewrite` está activado; si no, la relación del primer medio de entrada; si no, 16:9. + + Valores posibles: `auto`, `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`, `9:21` + + + + Solo para pistas de audio. `mono` mezcla a un solo canal antes de la separación; `stereo` conserva ambos canales. El audio del video no cambia. + + Valores posibles: `stereo`, `mono` + + + + Duración del video en segundos enteros, de 5 a 15. + + Alcance: `5` a `15` + + + + URL de la imagen del primer fotograma, un JPEG, PNG o WebP estático de como máximo 24 MiB y 40 millones de píxeles. + + + + URL de la imagen del último fotograma, con el mismo formato y los mismos límites de tamaño que `image`. + + + + `video` devuelve solo el video. `audio-stems` también devuelve pistas WAV de diálogo, música y efectos en `output.stems`, y agrega el cargo de Pika por separación de pistas por segundo. + + Valores posibles: `video`, `audio-stems` + + + + Prompt de texto que describe el video y su audio. + + + + Resolución de salida. 480p y 768p son nativas. 1080p, 2k y 4k se generan a 768p y después reciben upscale, y conservan el audio y la frecuencia de cuadros. + + Valores posibles: `480p`, `768p`, `1080p`, `2k`, `4k` + + + + Mejora el prompt antes de generar. Establécelo en false para usar el prompt tal como se escribió. + + + + Semilla para el video, 0 o más. + + Alcance: `0` a `…` + + Formato: `int64` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/pika/pika-h3-flex-image-to-video/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Se define cuando la tarea está `failed`. + + + + Código de fallo legible por máquina, como invalid_input, content_moderation o provider_error. + + + + Texto de diagnóstico. + + + + ID de trabajo que se usa para consultar el estado. + + + + La entrada del catálogo de Pika con la que se ejecutó la tarea. + + + + Los archivos multimedia de la tarea finalizada; se establecen cuando `status` es `completed`. + + + + Un archivo multimedia generado. + + + + Tipo MIME del archivo. + + + + URL de descarga del archivo generado. + + + + Qué campo contiene el archivo: video o audio. + + + + Un archivo multimedia generado. + + + + Tipo MIME del archivo. + + + + URL de descarga del archivo generado. + + + + Estado de la tarea: queued, running, completed o failed. + + + + Unidades que Pika informó para la tarea. + + +## Ejemplos + +### Entrada + +```json +{ + "duration": 5, + "image": "https://example.invalid/pika/first-frame.png", + "prompt": "The camera slowly pushes in as the leaves begin to sway in the wind", + "resolution": "480p" +} +``` + +### Salida + +```json +{ + "id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0", + "output": { + "media_type": "video", + "video": { + "content_type": "video/mp4", + "url": "https://example.invalid/pika/video.mp4" + } + }, + "status": "completed" +} +``` + + diff --git a/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx b/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx new file mode 100644 index 0000000000..020dcd0121 --- /dev/null +++ b/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx @@ -0,0 +1,337 @@ +--- +title: "Usa Pika H3 Flex Reference To Video con Comfy Router" +description: "Llama a pika/pika-h3-flex-reference-to-video con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Pika H3 Flex Reference To Video" +translationSourceHash: 7e59665d +translationFrom: development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx +translationBlockHashes: + "_intro": 2649fcc7 + "Quick start": a1a8fc23 + "Schema": 3c1a29f8 + "Examples": f7cff3b0 +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/pika/pika-h3-flex-reference-to-video.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API para `pika/pika-h3-flex-reference-to-video`, servida por Comfy Router desde Pika. + +**Entrada:** Texto, Imagen, Video, Audio · **Salida:** Video + Audio + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP directo. + +**ID del modelo:** `pika/pika-h3-flex-reference-to-video` + +**Endpoint:** `POST https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video` + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY desde el entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "pika/pika-h3-flex-reference-to-video", + { + "duration": 5, + "prompt": "The woman from the first image walks through the market from the video, humming the tune from the audio", + "references": [ + { + "type": "image", + "url": "https://example.invalid/pika/character.png", + }, + ], + "resolution": "480p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("pika/pika-h3-flex-reference-to-video", { + duration: 5, + prompt: "The woman from the first image walks through the market from the video, humming the tune from the audio", + references: [ + { + type: "image", + url: "https://example.invalid/pika/character.png", + }, + ], + resolution: "480p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"duration\": 5, \"prompt\": \"The woman from the first image walks through the market from the video, humming the tune from the audio\", \"references\": [{\"type\":\"image\",\"url\":\"https://example.invalid/pika/character.png\"}], \"resolution\": \"480p\"}" +``` + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado una vez que esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida del resultado. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pika/pika-h3-flex-reference-to-video", + { + "duration": 5, + "prompt": "The woman from the first image walks through the market from the video, humming the tune from the audio", + "references": [ + { + "type": "image", + "url": "https://example.invalid/pika/character.png", + }, + ], + "resolution": "480p", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("pika/pika-h3-flex-reference-to-video", { + duration: 5, + prompt: "The woman from the first image walks through the market from the video, humming the tune from the audio", + references: [ + { + type: "image", + url: "https://example.invalid/pika/character.png", + }, + ], + resolution: "480p", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"duration\": 5, \"prompt\": \"The woman from the first image walks through the market from the video, humming the tune from the audio\", \"references\": [{\"type\":\"image\",\"url\":\"https://example.invalid/pika/character.png\"}], \"resolution\": \"480p\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Relación de aspecto de salida. `auto` elige una a partir del prompt y de las entradas de medios. Omítelo para que Pika elija: `auto` cuando `rewrite` está activado; si no, la relación de la primera entrada de medios; si no, 16:9. + + Valores posibles: `auto`, `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`, `9:21` + + + + Solo para stems de audio. `mono` hace downmix antes de la separación; `stereo` conserva ambos canales. El audio del video no cambia. + + Valores posibles: `stereo`, `mono` + + + + Duración del video en segundos enteros, de 5 a 15. + + Alcance: `5` a `15` + + + + `video` devuelve solo el video. `audio-stems` también devuelve stems WAV de Dialogue, Music y Effect en `output.stems`, y agrega el cargo por segundo de separación de stems de Pika. + + Valores posibles: `video`, `audio-stems` + + + + Prompt de texto que describe el video y su audio. + + + + Medios de referencia ordenados: hasta 9 imágenes, 3 videos y 3 archivos de audio, 12 en total. Se requiere al menos una imagen o un video. Cada archivo es de 24 MiB como máximo. Los clips de video y audio duran de 2 a 15 segundos, y como máximo 15 segundos en total por tipo. Pika cobra los segundos de video de referencia además de los segundos de salida. + + + + El tipo de medio del archivo. + + Valores posibles: `image`, `video`, `audio` + + + + URL del archivo de referencia. Las imágenes son PNG, JPEG o WebP. + + + + Resolución de salida. 480p y 768p son nativas. 1080p, 2k y 4k generan a 768p y luego hacen upscale, conservando el audio y la frecuencia de cuadros. + + Valores posibles: `480p`, `768p`, `1080p`, `2k`, `4k` + + + + Mejora el prompt antes de la generación. Ponlo en false para usar el prompt tal como se escribió. + + + + Semilla para el video, 0 o más. + + Alcance: `0` a `…` + + Formato: `int64` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/pika/pika-h3-flex-reference-to-video/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Se establece en una tarea con estado `failed`. + + + + Código de falla legible por máquina, como invalid_input, content_moderation o provider_error. + + + + Texto de diagnóstico. + + + + ID de trabajo que se usa para consultar el estado. + + + + La entrada del catálogo de Pika con la que se ejecutó la tarea. + + + + Los medios de la tarea finalizada; se establece cuando `status` es `completed`. + + + + Un archivo de medios generado. + + + + Tipo MIME del archivo. + + + + URL de descarga del archivo generado. + + + + Qué campo contiene el archivo: video o audio. + + + + Un archivo de medios generado. + + + + Tipo MIME del archivo. + + + + URL de descarga del archivo generado. + + + + Estado de la tarea: queued, running, completed o failed. + + + + Unidades que Pika reportó para la tarea. + + +## Ejemplos + +### Entrada + +```json +{ + "duration": 5, + "prompt": "The woman from the first image walks through the market from the video, humming the tune from the audio", + "references": [ + { + "type": "image", + "url": "https://example.invalid/pika/character.png" + } + ], + "resolution": "480p" +} +``` + +### Salida + +```json +{ + "id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0", + "output": { + "media_type": "video", + "video": { + "content_type": "video/mp4", + "url": "https://example.invalid/pika/video.mp4" + } + }, + "status": "completed" +} +``` + + + diff --git a/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx b/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx new file mode 100644 index 0000000000..a82973879e --- /dev/null +++ b/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx @@ -0,0 +1,294 @@ +--- +title: "Usa Pika H3 Flex Text To Video con Comfy Router" +description: "Llama a pika/pika-h3-flex-text-to-video mediante Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." +sidebarTitle: "Pika H3 Flex Text To Video" +translationSourceHash: 701f78f6 +translationFrom: development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx +translationBlockHashes: + "_intro": f473daeb + "Quick start": 1ec8f079 + "Schema": ec7d8630 + "Examples": aaa4ed94 +--- +{/* GENERATED FILE. Generated from router-schemas/pika/pika-h3-flex-text-to-video.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `pika/pika-h3-flex-text-to-video`, servida por Comfy Router desde Pika. + +**Entrada:** Texto · **Salida:** video + audio + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar. + +**ID del modelo:** `pika/pika-h3-flex-text-to-video` + +**Endpoint:** `POST https://api.comfy.org/v2/models/pika/pika-h3-flex-text-to-video` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "pika/pika-h3-flex-text-to-video", + { + "duration": 5, + "prompt": "A paper boat drifts down a rain-soaked street at dusk while thunder rolls in the distance", + "resolution": "480p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("pika/pika-h3-flex-text-to-video", { + duration: 5, + prompt: "A paper boat drifts down a rain-soaked street at dusk while thunder rolls in the distance", + resolution: "480p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-text-to-video \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"duration\": 5, \"prompt\": \"A paper boat drifts down a rain-soaked street at dusk while thunder rolls in the distance\", \"resolution\": \"480p\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/pika/pika-h3-flex-text-to-video/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pika/pika-h3-flex-text-to-video", + { + "duration": 5, + "prompt": "A paper boat drifts down a rain-soaked street at dusk while thunder rolls in the distance", + "resolution": "480p", + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que otro proceso necesita + + # Sondea hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("pika/pika-h3-flex-text-to-video", { + duration: 5, + prompt: "A paper boat drifts down a rain-soaked street at dusk while thunder rolls in the distance", + resolution: "480p", +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que otro proceso necesita + +// Sondea hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-text-to-video/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"duration\": 5, \"prompt\": \"A paper boat drifts down a rain-soaked street at dusk while thunder rolls in the distance\", \"resolution\": \"480p\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pika/pika-h3-flex-text-to-video/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/pika/pika-h3-flex-text-to-video/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Relación de aspecto de salida. `auto` elige una a partir del prompt y de las entradas de medios. Omítela para que Pika elija: `auto` cuando `rewrite` está activado; si no, la relación de la primera entrada de medios; si no, 16:9. + + Valores posibles: `auto`, `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`, `9:21` + + + + Solo afecta a los stems de audio. `mono` hace una mezcla descendente antes de la separación; `stereo` conserva ambos canales. El audio del video no cambia. + + Valores posibles: `stereo`, `mono` + + + + Duración del video en segundos enteros, de 5 a 15. + + Alcance: `5` a `15` + + + + `video` devuelve solo el video. `audio-stems` también devuelve los stems WAV de diálogo, música y efectos en `output.stems`, y añade el cargo por segundo de separación de stems de Pika. + + Valores posibles: `video`, `audio-stems` + + + + Prompt de texto que describe el video y su audio. + + + + Resolución de salida. 480p y 768p son nativas. 1080p, 2k y 4k generan a 768p y luego aplican upscale, manteniendo el audio y la frecuencia de cuadros. + + Valores posibles: `480p`, `768p`, `1080p`, `2k`, `4k` + + + + Mejora el prompt antes de la generación. Ponlo en `false` para usar el prompt tal como está escrito. + + + + Semilla del video, 0 o más. + + Alcance: `0` a `…` + + Formato: `int64` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/pika/pika-h3-flex-text-to-video/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Se define en una tarea con estado `failed`. + + + + Código de fallo legible por máquina, como invalid_input, content_moderation o provider_error. + + + + Texto de diagnóstico. + + + + ID de trabajo que se usa para consultar el estado. + + + + La entrada del catálogo de Pika con la que se ejecutó la tarea. + + + + Los medios de la tarea finalizada; se define cuando `status` es `completed`. + + + + Un archivo de medios generado. + + + + Tipo MIME del archivo. + + + + URL de descarga del archivo generado. + + + + Qué campo lleva el archivo: video o audio. + + + + Un archivo de medios generado. + + + + Tipo MIME del archivo. + + + + URL de descarga del archivo generado. + + + + Estado de la tarea: queued, running, completed o failed. + + + + Unidades que Pika reportó para la tarea. + + +## Ejemplos + +### Entrada + +```json +{ + "duration": 5, + "prompt": "A paper boat drifts down a rain-soaked street at dusk while thunder rolls in the distance", + "resolution": "480p" +} +``` + +### Salida + +```json +{ + "id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0", + "output": { + "media_type": "video", + "video": { + "content_type": "video/mp4", + "url": "https://example.invalid/pika/video.mp4" + } + }, + "status": "completed" +} +``` + + diff --git a/es/development/comfy-router/models/stability/control-sketch/code.mdx b/es/development/comfy-router/models/stability/control-sketch/code.mdx new file mode 100644 index 0000000000..c924d50e78 --- /dev/null +++ b/es/development/comfy-router/models/stability/control-sketch/code.mdx @@ -0,0 +1,241 @@ +--- +title: "Usa Control Sketch con Comfy Router" +description: "Llama a stability/control-sketch con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Control Sketch" +translationSourceHash: f4f4dde3 +translationFrom: development/comfy-router/models/stability/control-sketch/code.mdx +translationBlockHashes: + "_intro": a3d4d5ba + "Quick start": 4c9b7a86 + "Schema": 9ba5dd73 + "Examples": fb83bd94 +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/stability/control-sketch.json con `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/control-sketch`, servida por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `stability/control-sketch` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/control-sketch` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/control-sketch", + { + "control_strength": 0.7, + "image": "https://storage.googleapis.com/example-bucket/sketch.png", + "prompt": "a castle on a cliff", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/control-sketch", { + control_strength: 0.7, + image: "https://storage.googleapis.com/example-bucket/sketch.png", + prompt: "a castle on a cliff", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/control-sketch \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"control_strength\": 0.7, \"image\": \"https://storage.googleapis.com/example-bucket/sketch.png\", \"prompt\": \"a castle on a cliff\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/control-sketch/requests`. Router responde `201` con un `request_id` en cuanto admite la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) repasa el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() crea su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/control-sketch", + { + "control_strength": 0.7, + "image": "https://storage.googleapis.com/example-bucket/sketch.png", + "prompt": "a castle on a cliff", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() crea su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/control-sketch", { + control_strength: 0.7, + image: "https://storage.googleapis.com/example-bucket/sketch.png", + prompt: "a castle on a cliff", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/control-sketch/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"control_strength\": 0.7, \"image\": \"https://storage.googleapis.com/example-bucket/sketch.png\", \"prompt\": \"a castle on a cliff\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/control-sketch/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se ejecuta. +curl https://api.comfy.org/v2/models/stability/control-sketch/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Qué tan fielmente sigue el resultado a la imagen fuente. Valor predeterminado: 0.7. + + Alcance: `0` a `1` + + + + Una URL de recurso firmada por Comfy de la imagen fuente. + + Formato: `uri` + + + + Qué mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué generar a partir de la imagen fuente. + + + + 0 u omitido elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + + + Se acepta y no se aplica. + + +Generated from the schema Router serves at `GET /v2/models/stability/control-sketch/openapi.json`, the same document it validates a call against before the request reaches the provider. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, y cada una válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "control_strength": 0.7, + "image": "https://storage.googleapis.com/example-bucket/sketch.png", + "prompt": "a castle on a cliff", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/control-style/code.mdx b/es/development/comfy-router/models/stability/control-style/code.mdx new file mode 100644 index 0000000000..5d3e931a5b --- /dev/null +++ b/es/development/comfy-router/models/stability/control-style/code.mdx @@ -0,0 +1,253 @@ +--- +title: "Usa Control Style con Comfy Router" +description: "Llama a stability/control-style con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Control Style" +translationSourceHash: e767576c +translationFrom: development/comfy-router/models/stability/control-style/code.mdx +translationBlockHashes: + "_intro": 44625662 + "Quick start": dc58c65b + "Schema": e430e365 + "Examples": 24d11590 +--- + +{/* GENERATED FILE. Generated from router-schemas/stability/control-style.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/control-style`, que Comfy Router ofrece desde Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar. + +**ID del modelo:** `stability/control-style` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/control-style` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/control-style", + { + "aspect_ratio": "16:9", + "fidelity": 0.5, + "image": "https://storage.googleapis.com/example-bucket/style.png", + "prompt": "a castle on a cliff", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para reintentos automáticos. +const { data } = await comfy.models.run("stability/control-style", { + aspect_ratio: "16:9", + fidelity: 0.5, + image: "https://storage.googleapis.com/example-bucket/style.png", + prompt: "a castle on a cliff", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/control-style \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"fidelity\": 0.5, \"image\": \"https://storage.googleapis.com/example-bucket/style.png\", \"prompt\": \"a castle on a cliff\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/control-style/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado una vez que esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) revisa el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/control-style", + { + "aspect_ratio": "16:9", + "fidelity": 0.5, + "image": "https://storage.googleapis.com/example-bucket/style.png", + "prompt": "a castle on a cliff", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil del propio proveedor, el mismo valor que devuelve models.run(). + # Una solicitud fallida o cancelada lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para reintentos automáticos. +const handle = await comfy.models.submit("stability/control-style", { + aspect_ratio: "16:9", + fidelity: 0.5, + image: "https://storage.googleapis.com/example-bucket/style.png", + prompt: "a castle on a cliff", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud fallida o cancelada se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/control-style/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"fidelity\": 0.5, \"image\": \"https://storage.googleapis.com/example-bucket/style.png\", \"prompt\": \"a castle on a cliff\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/control-style/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras aún se ejecuta. +curl https://api.comfy.org/v2/models/stability/control-style/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Relación de aspecto de salida a aproximadamente un megapíxel. Por defecto, 1:1. + + Valores posibles: `1:1`, `16:9`, `9:16`, `21:9`, `9:21`, `3:2`, `2:3`, `5:4`, `4:5` + + + + Qué tan fielmente el resultado sigue el estilo de la fuente. Por defecto, 0.5. + + Alcance: `0` a `1` + + + + Una URL de recurso firmada por Comfy de la fuente del estilo. + + Formato: `uri` + + + + Qué mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué generar con el estilo de la imagen de origen. + + + + 0, u omitir el campo, elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + + + Se acepta y no se aplica. + + +Generado a partir del esquema que Router publica en `GET /v2/models/stability/control-style/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, cada una válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "fidelity": 0.5, + "image": "https://storage.googleapis.com/example-bucket/style.png", + "prompt": "a castle on a cliff", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/generate-core/code.mdx b/es/development/comfy-router/models/stability/generate-core/code.mdx new file mode 100644 index 0000000000..00826a4339 --- /dev/null +++ b/es/development/comfy-router/models/stability/generate-core/code.mdx @@ -0,0 +1,243 @@ +--- +title: "Usar Generate Core con Comfy Router" +description: "Llama a stability/generate-core mediante Comfy Router: el endpoint, la forma de la solicitud y la respuesta que devuelve Router." +sidebarTitle: "Generate Core" +translationSourceHash: 600a8e31 +translationFrom: development/comfy-router/models/stability/generate-core/code.mdx +translationBlockHashes: + "_intro": e1390a90 + "Quick start": c8de29b5 + "Schema": e487e318 + "Examples": cfbf5d5e +--- +{/* GENERATED FILE. Generated from router-schemas/stability/generate-core.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/generate-core`, servido por Comfy Router desde Stability. + +**Entrada:** Texto · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada con HTTP sin procesar. + +**ID del modelo:** `stability/generate-core` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/generate-core` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY desde el entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/generate-core", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/generate-core", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/generate-core \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/generate-core/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY desde el entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/generate-core", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud fallida o cancelada genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/generate-core", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud fallida o cancelada se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/generate-core/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/generate-core/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/generate-core/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Solo texto a imagen. Relación de aspecto de salida. Por defecto 1:1. + + Valores posibles: `1:1`, `16:9`, `9:16`, `21:9`, `9:21`, `3:2`, `2:3`, `5:4`, `4:5` + + + + Solo para `stability/generate-ultra`. Una URL de recurso firmada por Comfy de una imagen de origen; enviarla cambia a imagen a imagen y requiere `strength`. + + Formato: `uri` + + + + Lo que quieres mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Lo que quieres generar. + + + + 0 u omitido elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + + + Solo para imagen a imagen de `stability/generate-ultra`. Cuánto mover desde la imagen de origen; 1 la ignora. + + Alcance: `0` a `1` + + + + Preajuste de estilo de Stability, por ejemplo `photographic`. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/generate-core/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la (primera) imagen PNG, válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, cada una válida hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + + diff --git a/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx b/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx new file mode 100644 index 0000000000..eb6f992fec --- /dev/null +++ b/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx @@ -0,0 +1,298 @@ +--- +title: "Usa Sdxl 1.0 Masking con Comfy Router" +description: "Llama a stability/sdxl-1.0-masking desde Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Sdxl 1.0 Masking" +translationSourceHash: 8d04e210 +translationFrom: development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx +translationBlockHashes: + "_intro": f0f0920c + "Quick start": c170fe18 + "Schema": f4be99d1 + "Examples": ff8da387 +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/stability/sdxl-1.0-masking.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API de `stability/sdxl-1.0-masking`, servido por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL realiza la misma llamada mediante HTTP sin procesar. + +**ID del modelo:** `stability/sdxl-1.0-masking` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-masking` + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY desde el entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/sdxl-1.0-masking", + { + "init_image": "https://storage.googleapis.com/example-bucket/source.png", + "mask_image": "https://storage.googleapis.com/example-bucket/mask.png", + "mask_source": "MASK_IMAGE_WHITE", + "seed": 12345, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("stability/sdxl-1.0-masking", { + init_image: "https://storage.googleapis.com/example-bucket/source.png", + mask_image: "https://storage.googleapis.com/example-bucket/mask.png", + mask_source: "MASK_IMAGE_WHITE", + seed: 12345, + text_prompts: [ + { + text: "a lighthouse on a cliff at sunset, oil painting", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-masking \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"init_image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"mask_image\": \"https://storage.googleapis.com/example-bucket/mask.png\", \"mask_source\": \"MASK_IMAGE_WHITE\", \"seed\": 12345, \"text_prompts\": [{\"text\":\"a lighthouse on a cliff at sunset, oil painting\"}]}" +``` + + +El mismo body, enviado a `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-masking/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/sdxl-1.0-masking", + { + "init_image": "https://storage.googleapis.com/example-bucket/source.png", + "mask_image": "https://storage.googleapis.com/example-bucket/mask.png", + "mask_source": "MASK_IMAGE_WHITE", + "seed": 12345, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting", + }, + ], + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado del Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("stability/sdxl-1.0-masking", { + init_image: "https://storage.googleapis.com/example-bucket/source.png", + mask_image: "https://storage.googleapis.com/example-bucket/mask.png", + mask_source: "MASK_IMAGE_WHITE", + seed: 12345, + text_prompts: [ + { + text: "a lighthouse on a cliff at sunset, oil painting", + }, + ], +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. El Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-masking/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"init_image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"mask_image\": \"https://storage.googleapis.com/example-bucket/mask.png\", \"mask_source\": \"MASK_IMAGE_WHITE\", \"seed\": 12345, \"text_prompts\": [{\"text\":\"a lighthouse on a cliff at sunset, oil painting\"}]}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/sdxl-1.0-masking/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-masking/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Qué tan estrictamente sigue la imagen al prompt. Valor predeterminado: 7. + + Alcance: `0` a `35` + + + + El preset de orientación CLIP de Stability, por ejemplo `NONE`. + + + + Se acepta por compatibilidad y se ignora. + + + + Una URL de asset firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Una URL de asset firmada por Comfy de la máscara. Requerida con MASK_IMAGE_WHITE y MASK_IMAGE_BLACK, rechazada con INIT_IMAGE_ALPHA. + + Formato: `uri` + + + + De dónde proviene la máscara. MASK_IMAGE_WHITE y MASK_IMAGE_BLACK leen `mask_image` y repintan sus píxeles blancos o negros; INIT_IMAGE_ALPHA lee el canal alfa de `init_image`. + + Valores posibles: `MASK_IMAGE_WHITE`, `MASK_IMAGE_BLACK`, `INIT_IMAGE_ALPHA` + + + + El nombre del sampler de Stability, por ejemplo `K_DPMPP_2M`. + + + + Cantidad de imágenes a generar. Valor predeterminado: 1. Cada imagen devuelta se factura. + + Alcance: `1` a `10` + + + + Semilla para todo el lote. 0 u omitida elige una semilla aleatoria. + + Alcance: `0` a `…` + + + + Pasos de diffusion. Valor predeterminado: 30. + + Alcance: `10` a `30` + + + + Preset de estilo de Stability, por ejemplo `photographic`. + + + + Prompts, cada uno con un peso opcional. Un peso negativo lo convierte en prompt negativo. + + + + + + + + + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/sdxl-1.0-masking/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en un 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, cada una válida hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "init_image": "https://storage.googleapis.com/example-bucket/source.png", + "mask_image": "https://storage.googleapis.com/example-bucket/mask.png", + "mask_source": "MASK_IMAGE_WHITE", + "seed": 12345, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting" + } + ] +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/upscale-creative/code.mdx b/es/development/comfy-router/models/stability/upscale-creative/code.mdx new file mode 100644 index 0000000000..dfd3a9486e --- /dev/null +++ b/es/development/comfy-router/models/stability/upscale-creative/code.mdx @@ -0,0 +1,243 @@ +--- +title: "Usa Upscale Creative con Comfy Router" +description: "Llama a stability/upscale-creative desde Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Upscale Creative" +translationSourceHash: b7d002b5 +translationFrom: development/comfy-router/models/stability/upscale-creative/code.mdx +translationBlockHashes: + "_intro": 329bdbfa + "Quick start": dc9ebad8 + "Schema": 0c55f2e7 + "Examples": 12491ff3 +--- +{/* ARCHIVO GENERADO. Generado a partir de router-schemas/stability/upscale-creative.json con `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/upscale-creative`, servido por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. + +**ID del modelo:** `stability/upscale-creative` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/upscale-creative` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/upscale-creative", + { + "creativity": 0.3, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a detailed photo of a cat", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/upscale-creative", { + creativity: 0.3, + image: "https://storage.googleapis.com/example-bucket/source.png", + prompt: "a detailed photo of a cat", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/upscale-creative \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"creativity\": 0.3, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"prompt\": \"a detailed photo of a cat\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/upscale-creative/requests`. Router responde `201` con un `request_id` en cuanto admite la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica paso a paso el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/upscale-creative", + { + "creativity": 0.3, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a detailed photo of a cat", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita + + # Consulta periódicamente hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/upscale-creative", { + creativity: 0.3, + image: "https://storage.googleapis.com/example-bucket/source.png", + prompt: "a detailed photo of a cat", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita + +// Consulta periódicamente hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/upscale-creative/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"creativity\": 0.3, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"prompt\": \"a detailed photo of a cat\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/upscale-creative/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/upscale-creative/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Cuánto detalle inventar. Predeterminado 0.3. + + Rango: `0.1` a `0.5` + + + + Una URL de recurso firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Lo que hay que dejar fuera de la imagen con upscale. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Lo que muestra la imagen con upscale. + + + + Un valor de 0, o si se omite, elige una semilla aleatoria. + + Rango: `0` a `4294967294` + + + + Un estilo aplicado a `prompt` y `negative_prompt`. + + Valores posibles: `3d-model`, `analog-film`, `anime`, `cinematic`, `comic-book`, `digital-art`, `enhance`, `fantasy-art`, `isometric`, `line-art`, `low-poly`, `modeling-compound`, `neon-punk`, `origami`, `photographic`, `pixel-art`, `tile-texture` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/upscale-creative/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imágenes firmadas por Comfy, en el orden de salida, cada una válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "creativity": 0.3, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a detailed photo of a cat", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + From 48e69ffe8fc5078d94d43d5663d09552c118be36 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:04:47 +0800 Subject: [PATCH 05/36] i18n(ltx): drop stale duplicate workflow headings in zh/ja/ko LTX-2.3 page --- ja/tutorials/video/ltx/ltx-2-3.mdx | 35 +++--------------------------- ko/tutorials/video/ltx/ltx-2-3.mdx | 35 +++--------------------------- zh/tutorials/video/ltx/ltx-2-3.mdx | 35 +++--------------------------- 3 files changed, 9 insertions(+), 96 deletions(-) diff --git a/ja/tutorials/video/ltx/ltx-2-3.mdx b/ja/tutorials/video/ltx/ltx-2-3.mdx index 3b5d382da6..4e5afd9c14 100644 --- a/ja/tutorials/video/ltx/ltx-2-3.mdx +++ b/ja/tutorials/video/ltx/ltx-2-3.mdx @@ -2,13 +2,14 @@ title: "LTX-2.3: ComfyUI 動画・音声ワークフロー" description: "ComfyUI で LTX-2.3 のネイティブワークフローを使い、テキストから動画、画像から動画、FLF2V、音声駆動動画、IC-LoRA 制御、ID-LoRA 個別化を実行できます。" sidebarTitle: "LTX-2.3" -translationSourceHash: 2e21405a +translationSourceHash: a1ba82c9 translationFrom: tutorials/video/ltx/ltx-2-3.mdx translationBlockHashes: "_intro": 2afce33d "Key features": 3ddea9bd "Getting started": 8bd36b77 - "ComfyUI Native Workflows": fb09a224 + "Choosing a template workflow": b1568fc8 + "ComfyUI Native Workflows": 0a450aa5 "Prompting tips": f92227b7 "Resources": 3f045765 --- @@ -74,12 +75,6 @@ LTX-2.3はComfyUIでネイティブサポートされています。開始する ## ComfyUIネイティブワークフロー -### LTX-2.3 テキストから動画(T2V) - -改善されたプロンプト理解とテキストレンダリングにより、テキストプロンプトから動画を生成します。 - - - ### LTX-2.3 テキストから動画(`video_ltx2_3_t2v`) {#video_ltx2_3_t2v} 改善されたプロンプト理解とテキストレンダリングにより、テキストプロンプトから動画を生成します。 @@ -138,12 +133,6 @@ ComfyUI/ --- -### LTX-2.3 画像から動画(I2V) - -より一貫したモーションとスムーズなアニメーションで、入力画像から動画を生成します。 - - - ### LTX-2.3 画像から動画(`video_ltx2_3_i2v`) {#video_ltx2_3_i2v} 改善されたモーション一貫性で、入力画像から動画を生成します。 @@ -204,12 +193,6 @@ ComfyUI/ --- -### LTX-2.3 FLF2V - -開始画像と終了画像の間を補間し、スムーズな動画トランジションを生成します。 - - - ### LTX-2.3 最初・最後フレームから動画(`video_ltx2_3_flf2v`) {#video_ltx2_3_flf2v} 開始画像と終了画像の間を補間します。 @@ -259,12 +242,6 @@ ComfyUI/ --- -### LTX-2.3 画像・音声から動画(IA2V) - -画像と音声ファイルをアップロードして、同期された口の動きを持つ高品質な動画を生成します。 - - - ### LTX-2.3 画像・音声から動画(`video_ltx2_3_ia2v`) {#video_ltx2_3_ia2v} 画像と音声からリップシンク動画を生成します。 @@ -542,12 +519,6 @@ Remove subtitles, captions, and related text occlusions from the video, restorin --- -### LTX-2.3 ID-LoRA - -テキストプロンプト、参照画像、および短い音声クリップから、同期オーディオ付きのパーソナライズ動画を生成します。ID-LoRAを使用して、人物の外見と声を単一の生成モデルで適応させます。 - - - ### LTX-2.3 ID LoRA(`video_ltx2_3_id_lora`) {#video_ltx2_3_id_lora} 参照画像と音声クリップから、同期オーディオ付きのパーソナライズ動画を生成します。 diff --git a/ko/tutorials/video/ltx/ltx-2-3.mdx b/ko/tutorials/video/ltx/ltx-2-3.mdx index cb93815231..e22459eff4 100644 --- a/ko/tutorials/video/ltx/ltx-2-3.mdx +++ b/ko/tutorials/video/ltx/ltx-2-3.mdx @@ -2,13 +2,14 @@ title: "LTX-2.3: ComfyUI 비디오 및 오디오 워크플로" description: "ComfyUI에서 LTX-2.3 네이티브 워크플로로 텍스트-투-비디오, 이미지-투-비디오, FLF2V, 오디오 기반 비디오, IC-LoRA 제어, ID-LoRA 개인화를 사용할 수 있습니다." sidebarTitle: "LTX-2.3" -translationSourceHash: 2e21405a +translationSourceHash: a1ba82c9 translationFrom: tutorials/video/ltx/ltx-2-3.mdx translationBlockHashes: "_intro": 2afce33d "Key features": 3ddea9bd "Getting started": 8bd36b77 - "ComfyUI Native Workflows": fb09a224 + "Choosing a template workflow": b1568fc8 + "ComfyUI Native Workflows": 0a450aa5 "Prompting tips": f92227b7 "Resources": 3f045765 --- @@ -76,12 +77,6 @@ LTX-2.3은 ComfyUI에서 기본적으로 지원됩니다. 시작하려면: ## ComfyUI 기본 워크플로 -### LTX-2.3 텍스트-투-비디오 (T2V) - -향상된 프롬프트 이해와 텍스트 렌더링으로 텍스트 프롬프트에서 비디오를 생성합니다. - - - ### LTX-2.3 텍스트-투-비디오 {#video_ltx2_3_t2v} 향상된 프롬프트 이해와 텍스트 렌더링으로 텍스트 프롬프트에서 비디오를 생성합니다. @@ -141,12 +136,6 @@ ComfyUI/ --- -### LTX-2.3 이미지-투-비디오 (I2V) - -더 일관된 움직임과 부드러운 애니메이션으로 입력 이미지에서 비디오를 생성합니다. - - - ### LTX-2.3 이미지-투-비디오 {#video_ltx2_3_i2v} 향상된 움직임 일관성으로 입력 이미지에서 비디오를 생성합니다. @@ -208,12 +197,6 @@ ComfyUI/ --- -### LTX-2.3 FLF2V - -시작 이미지와 종료 이미지 간 보간하여 부드러운 비디오 전환을 생성합니다. - - - ### LTX-2.3 처음-마지막 프레임 투 비디오 {#video_ltx2_3_flf2v} 시작 이미지와 종료 이미지 사이를 보간합니다. @@ -264,12 +247,6 @@ ComfyUI/ --- -### LTX-2.3 이미지-오디오-투-비디오 (IA2V) - -이미지와 오디오 파일을 업로드하여 립싱크가 적용된 고품질 비디오를 생성합니다. - - - ### LTX-2.3 이미지-오디오-투-비디오 {#video_ltx2_3_ia2v} 이미지와 오디오에서 립싱크 비디오를 생성합니다. @@ -548,12 +525,6 @@ Remove subtitles, captions, and related text occlusions from the video, restorin --- -### LTX-2.3 ID-LoRA - -텍스트 프롬프트, 참조 이미지 및 짧은 오디오 클립으로 동기화된 오디오가 포함된 개인화된 비디오를 생성합니다. ID-LoRA를 사용하여 단일 생성 모델에서 사람의 외모와 목소리를 적용합니다. - - - ### LTX-2.3 ID LoRA {#video_ltx2_3_id_lora} 참조 이미지와 오디오 클립으로 동기화된 오디오가 포함된 개인화된 비디오를 생성합니다. diff --git a/zh/tutorials/video/ltx/ltx-2-3.mdx b/zh/tutorials/video/ltx/ltx-2-3.mdx index 92ac5813f5..8414120f2c 100644 --- a/zh/tutorials/video/ltx/ltx-2-3.mdx +++ b/zh/tutorials/video/ltx/ltx-2-3.mdx @@ -2,13 +2,14 @@ title: "LTX-2.3:ComfyUI 视频与音频工作流" description: "在 ComfyUI 中使用 LTX-2.3 原生工作流,涵盖文本转视频、图像转视频、FLF2V、音频驱动视频、IC-LoRA 控制和 ID-LoRA 个性化。" sidebarTitle: "LTX-2.3" -translationSourceHash: 2e21405a +translationSourceHash: a1ba82c9 translationFrom: tutorials/video/ltx/ltx-2-3.mdx translationBlockHashes: "_intro": 2afce33d "Key features": 3ddea9bd "Getting started": 8bd36b77 - "ComfyUI Native Workflows": fb09a224 + "Choosing a template workflow": b1568fc8 + "ComfyUI Native Workflows": 0a450aa5 "Prompting tips": f92227b7 "Resources": 3f045765 --- @@ -76,12 +77,6 @@ ComfyUI 自带六个原生 LTX-2.3 模板,位于 **模板库** > **视频**( ## ComfyUI 原生工作流 -### LTX-2.3 文本转视频 (T2V) - -通过改进的提示理解和文本渲染,根据文本提示生成视频。 - - - ### LTX-2.3 文本转视频(`video_ltx2_3_t2v`) {#video_ltx2_3_t2v} 通过改进的提示理解和文本渲染,根据文本提示生成视频。 @@ -140,12 +135,6 @@ ComfyUI/ --- -### LTX-2.3 图像转视频 (I2V) - -根据输入图像生成视频,具有更一致的动态和更流畅的动画。 - - - ### LTX-2.3 图像转视频(`video_ltx2_3_i2v`) {#video_ltx2_3_i2v} 根据输入图像生成视频,运动一致性更佳。 @@ -206,12 +195,6 @@ ComfyUI/ --- -### LTX-2.3 FLF2V - -在起始图像和结束图像之间进行插值,生成流畅的视频过渡。 - - - ### LTX-2.3 首尾帧转视频(`video_ltx2_3_flf2v`) {#video_ltx2_3_flf2v} 在起始图像和结束图像之间进行插值。 @@ -261,12 +244,6 @@ ComfyUI/ --- -### LTX-2.3 图像音频转视频 (IA2V) - -上传图像和音频文件,生成具有同步唇部运动的高质量视频。 - - - ### LTX-2.3 图像音频转视频(`video_ltx2_3_ia2v`) {#video_ltx2_3_ia2v} 从图像和音频生成唇形同步视频。 @@ -544,12 +521,6 @@ Remove subtitles, captions, and related text occlusions from the video, restorin --- -### LTX-2.3 ID-LoRA - -根据文本提示、参考图像和短音频片段,生成带同步音频的个性化视频。使用 ID-LoRA 在单个生成模型中适应人物的外貌和声音。 - - - ### LTX-2.3 ID LoRA(`video_ltx2_3_id_lora`) {#video_ltx2_3_id_lora} 从参考图像和音频片段生成带同步音频的个性化视频。 From ee231e0830c6d4270a255f2ef7cb82f4f07d0625 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:05:35 +0800 Subject: [PATCH 06/36] i18n(es): sync router model pages with upstream/main (2026-11-10) --- .../stability/control-style-transfer/code.mdx | 254 ++++++++++++++ .../models/stability/edit-erase/code.mdx | 235 +++++++++++++ .../edit-search-and-recolor/code.mdx | 241 ++++++++++++++ .../models/stability/generate-ultra/code.mdx | 243 ++++++++++++++ .../models/stability/sd3-5-flash/code.mdx | 254 ++++++++++++++ .../stability/sd3-5-large-turbo/code.mdx | 254 ++++++++++++++ .../models/stability/sd3-5-medium/code.mdx | 254 ++++++++++++++ .../sdxl-1-0-image-to-image/code.mdx | 315 ++++++++++++++++++ .../stability/sdxl-1-0-text-to-image/code.mdx | 315 ++++++++++++++++++ .../models/stability/stable-fast-3d/code.mdx | 229 +++++++++++++ 10 files changed, 2594 insertions(+) create mode 100644 es/development/comfy-router/models/stability/control-style-transfer/code.mdx create mode 100644 es/development/comfy-router/models/stability/edit-erase/code.mdx create mode 100644 es/development/comfy-router/models/stability/edit-search-and-recolor/code.mdx create mode 100644 es/development/comfy-router/models/stability/generate-ultra/code.mdx create mode 100644 es/development/comfy-router/models/stability/sd3-5-flash/code.mdx create mode 100644 es/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx create mode 100644 es/development/comfy-router/models/stability/sd3-5-medium/code.mdx create mode 100644 es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx create mode 100644 es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx create mode 100644 es/development/comfy-router/models/stability/stable-fast-3d/code.mdx diff --git a/es/development/comfy-router/models/stability/control-style-transfer/code.mdx b/es/development/comfy-router/models/stability/control-style-transfer/code.mdx new file mode 100644 index 0000000000..873ead86aa --- /dev/null +++ b/es/development/comfy-router/models/stability/control-style-transfer/code.mdx @@ -0,0 +1,254 @@ +--- +title: "Usa Control Style Transfer con Comfy Router" +description: "Llama a stability/control-style-transfer mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Control Style Transfer" +translationSourceHash: 9d33c41c +translationFrom: development/comfy-router/models/stability/control-style-transfer/code.mdx +translationBlockHashes: + "_intro": 41f0a0a8 + "Quick start": 78f5d834 + "Schema": bba4b14e + "Examples": 19a9665b +--- +{/* GENERATED FILE. Generated from router-schemas/stability/control-style-transfer.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/control-style-transfer`, servida por Comfy Router desde Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `stability/control-style-transfer` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/control-style-transfer` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/control-style-transfer", + { + "init_image": "https://storage.googleapis.com/example-bucket/photo.png", + "seed": 12345, + "style_image": "https://storage.googleapis.com/example-bucket/style.png", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/control-style-transfer", { + init_image: "https://storage.googleapis.com/example-bucket/photo.png", + seed: 12345, + style_image: "https://storage.googleapis.com/example-bucket/style.png", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/control-style-transfer \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"init_image\": \"https://storage.googleapis.com/example-bucket/photo.png\", \"seed\": 12345, \"style_image\": \"https://storage.googleapis.com/example-bucket/style.png\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/control-style-transfer/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/control-style-transfer", + { + "init_image": "https://storage.googleapis.com/example-bucket/photo.png", + "seed": 12345, + "style_image": "https://storage.googleapis.com/example-bucket/style.png", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud fallida o cancelada lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/control-style-transfer", { + init_image: "https://storage.googleapis.com/example-bucket/photo.png", + seed: 12345, + style_image: "https://storage.googleapis.com/example-bucket/style.png", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud fallida o cancelada se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/control-style-transfer/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"init_image\": \"https://storage.googleapis.com/example-bucket/photo.png\", \"seed\": 12345, \"style_image\": \"https://storage.googleapis.com/example-bucket/style.png\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/control-style-transfer/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se ejecuta. +curl https://api.comfy.org/v2/models/stability/control-style-transfer/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Cuánto puede alejarse el resultado de `init_image`. Valor predeterminado: 0.9. + + Rango: `0.1` a `1` + + + + Qué tan fielmente se conserva la composición de `init_image`. Valor predeterminado: 0.9. + + Rango: `0` a `1` + + + + Una URL de recurso firmada por Comfy de la imagen a la que se le cambiará el estilo. + + Formato: `uri` + + + + Qué excluir de la imagen. + + + + Solo devuelve `png`. + + Valores posibles: `png` + + + + Sugerencia opcional para el resultado. + + + + 0 o si se omite, se elige una semilla aleatoria. + + Rango: `0` a `4294967294` + + + + Una URL de recurso firmada por Comfy de la fuente de estilo. + + Formato: `uri` + + + + Se acepta pero no se aplica. + + + + Qué tan intensamente se aplica el estilo. Valor predeterminado: 1. + + Rango: `0` a `1` + + +Generado a partir del esquema que Router publica en `GET /v2/models/stability/control-style-transfer/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS con un 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida durante un máximo de 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, cada una válida durante un máximo de 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "init_image": "https://storage.googleapis.com/example-bucket/photo.png", + "seed": 12345, + "style_image": "https://storage.googleapis.com/example-bucket/style.png" +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/edit-erase/code.mdx b/es/development/comfy-router/models/stability/edit-erase/code.mdx new file mode 100644 index 0000000000..10577d3d06 --- /dev/null +++ b/es/development/comfy-router/models/stability/edit-erase/code.mdx @@ -0,0 +1,235 @@ +--- +title: "Usar Edit Erase con Comfy Router" +description: "Llama a stability/edit-erase mediante Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." +sidebarTitle: "Edit Erase" +translationSourceHash: b2ba66c5 +translationFrom: development/comfy-router/models/stability/edit-erase/code.mdx +translationBlockHashes: + "_intro": ef122458 + "Quick start": 3d095f5a + "Schema": 9353a1d0 + "Examples": e0bbd906 +--- +{/* ARCHIVO GENERADO. Generado a partir de router-schemas/stability/edit-erase.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API de `stability/edit-erase`, servida por Comfy Router de Stability. + +**Entrada:** Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP puro. + +**Model ID:** `stability/edit-erase` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/edit-erase` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/edit-erase", + { + "grow_mask": 5, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "mask": "https://storage.googleapis.com/example-bucket/mask.png", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/edit-erase", { + grow_mask: 5, + image: "https://storage.googleapis.com/example-bucket/source.png", + mask: "https://storage.googleapis.com/example-bucket/mask.png", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/edit-erase \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"grow_mask\": 5, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"mask\": \"https://storage.googleapis.com/example-bucket/mask.png\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/edit-erase/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/edit-erase", + { + "grow_mask": 5, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "mask": "https://storage.googleapis.com/example-bucket/mask.png", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/edit-erase", { + grow_mask: 5, + image: "https://storage.googleapis.com/example-bucket/source.png", + mask: "https://storage.googleapis.com/example-bucket/mask.png", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/edit-erase/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"grow_mask\": 5, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"mask\": \"https://storage.googleapis.com/example-bucket/mask.png\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/edit-erase/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/edit-erase/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Cuántos píxeles crece la máscara. Valor predeterminado: 5. + + Alcance: `0` a `20` + + + + Una URL de recurso firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Una URL de recurso firmada por Comfy de la máscara. El blanco marca el área que se va a borrar. Si se omite, el alfa de la propia imagen es la máscara. + + Formato: `uri` + + + + Solo devuelve `png`. + + Valores posibles: `png` + + + + 0 u omitido elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/edit-erase/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, válida cada una hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "grow_mask": 5, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "mask": "https://storage.googleapis.com/example-bucket/mask.png", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/edit-search-and-recolor/code.mdx b/es/development/comfy-router/models/stability/edit-search-and-recolor/code.mdx new file mode 100644 index 0000000000..0bb8713441 --- /dev/null +++ b/es/development/comfy-router/models/stability/edit-search-and-recolor/code.mdx @@ -0,0 +1,241 @@ +--- +title: "Usa Edit Search And Recolor con Comfy Router" +description: "Llama a stability/edit-search-and-recolor mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Edit Search And Recolor" +translationSourceHash: 1b8b8cae +translationFrom: development/comfy-router/models/stability/edit-search-and-recolor/code.mdx +translationBlockHashes: + "_intro": e2246389 + "Quick start": 8016c839 + "Schema": 9c3e8686 + "Examples": 5bfbf748 +--- +{/* GENERATED FILE. Generated from router-schemas/stability/edit-search-and-recolor.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/edit-search-and-recolor`, servido por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. + +**ID del modelo:** `stability/edit-search-and-recolor` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/edit-search-and-recolor` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/edit-search-and-recolor", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "bright red", + "seed": 12345, + "select_prompt": "the cat", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/edit-search-and-recolor", { + image: "https://storage.googleapis.com/example-bucket/source.png", + prompt: "bright red", + seed: 12345, + select_prompt: "the cat", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/edit-search-and-recolor \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"prompt\": \"bright red\", \"seed\": 12345, \"select_prompt\": \"the cat\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/edit-search-and-recolor/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/edit-search-and-recolor", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "bright red", + "seed": 12345, + "select_prompt": "the cat", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/edit-search-and-recolor", { + image: "https://storage.googleapis.com/example-bucket/source.png", + prompt: "bright red", + seed: 12345, + select_prompt: "the cat", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/edit-search-and-recolor/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"prompt\": \"bright red\", \"seed\": 12345, \"select_prompt\": \"the cat\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/edit-search-and-recolor/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/edit-search-and-recolor/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Cuántos píxeles expandir el área encontrada. Valor predeterminado: 3. + + Rango: `0` a `20` + + + + Una URL de activo firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Lo que quieres mantener fuera del recoloreado. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + El nuevo color o aspecto. + + + + 0 u omitido elige una semilla aleatoria. + + Rango: `0` a `4294967294` + + + + Qué recolorear. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/edit-search-and-recolor/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (primera), válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, válida cada una hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "bright red", + "seed": 12345, + "select_prompt": "the cat" +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/generate-ultra/code.mdx b/es/development/comfy-router/models/stability/generate-ultra/code.mdx new file mode 100644 index 0000000000..1bc7d98152 --- /dev/null +++ b/es/development/comfy-router/models/stability/generate-ultra/code.mdx @@ -0,0 +1,243 @@ +--- +title: "Usar Generate Ultra con Comfy Router" +description: "Llama a stability/generate-ultra mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Generate Ultra" +translationSourceHash: 890c3c64 +translationFrom: development/comfy-router/models/stability/generate-ultra/code.mdx +translationBlockHashes: + "_intro": b61e73dc + "Quick start": 56db1f55 + "Schema": 7fa50f56 + "Examples": cfbf5d5e +--- + +{/* ARCHIVO GENERADO. Generado desde router-schemas/stability/generate-ultra.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API de `stability/generate-ultra`, que Comfy Router sirve desde Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `stability/generate-ultra` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/generate-ultra` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/generate-ultra", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("stability/generate-ultra", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/generate-ultra \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/generate-ultra/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y recoges el resultado cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/generate-ultra", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que necesita otro proceso + + # Sondea hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado del Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("stability/generate-ultra", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que necesita otro proceso + +// Sondea hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. El Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/generate-ultra/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" + +# 2. Sondea hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/generate-ultra/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/generate-ultra/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Solo texto a imagen. Relación de aspecto de salida. Predeterminado 1:1. + + Valores posibles: `1:1`, `16:9`, `9:16`, `21:9`, `9:21`, `3:2`, `2:3`, `5:4`, `4:5` + + + + Solo `stability/generate-ultra`. Una URL de recurso firmada por Comfy de una imagen de origen; si la envías, cambia a imagen a imagen y requiere `strength`. + + Formato: `uri` + + + + Lo que quieres mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Lo que quieres generar. + + + + 0 u omitido selecciona una semilla aleatoria. + + Alcance: `0` a `4294967294` + + + + Solo imagen a imagen de `stability/generate-ultra`. Cuánto desplazarse desde la imagen de origen; 1 la ignora. + + Alcance: `0` a `1` + + + + Preajuste de estilo de Stability, por ejemplo `photographic`. + + +Se genera a partir del esquema que el Router sirve en `GET /v2/models/stability/generate-ultra/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en un 200. + + + + URL firmada por Comfy de la (primera) imagen PNG, válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, y cada una válida hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/sd3-5-flash/code.mdx b/es/development/comfy-router/models/stability/sd3-5-flash/code.mdx new file mode 100644 index 0000000000..e14c197ebe --- /dev/null +++ b/es/development/comfy-router/models/stability/sd3-5-flash/code.mdx @@ -0,0 +1,254 @@ +--- +title: "Usar Sd3.5 Flash con Comfy Router" +description: "Llama a stability/sd3.5-flash mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Sd3.5 Flash" +translationSourceHash: 0d352729 +translationFrom: development/comfy-router/models/stability/sd3-5-flash/code.mdx +translationBlockHashes: + "_intro": 0c7d0a5f + "Quick start": 9fbd3cec + "Schema": 82b08ce1 + "Examples": cfbf5d5e +--- +{/* GENERATED FILE. Generated from router-schemas/stability/sd3.5-flash.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/sd3.5-flash`, servido por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. + +**ID del modelo:** `stability/sd3.5-flash` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/sd3.5-flash` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/sd3.5-flash", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/sd3.5-flash", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/sd3.5-flash \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/sd3.5-flash/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/sd3.5-flash", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/sd3.5-flash", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/sd3.5-flash/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/sd3.5-flash/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/sd3.5-flash/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Solo texto a imagen. Relación de aspecto de salida de aproximadamente un megapíxel. Predeterminado: 1:1. + + Valores posibles: `1:1`, `16:9`, `9:16`, `21:9`, `9:21`, `3:2`, `2:3`, `5:4`, `4:5` + + + + Qué tan estrictamente sigue la imagen al prompt. + + Alcance: `1` a `10` + + + + Solo imagen a imagen. Una URL de recurso firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Predeterminado: texto a imagen. imagen a imagen requiere `image` y `strength`. + + Valores posibles: `text-to-image`, `image-to-image` + + + + Qué mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué generar. + + + + 0 u omitido elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + + + Solo imagen a imagen. Cuánto alejarse de la imagen de origen; 1 la ignora. + + Alcance: `0` a `1` + + + + Preajuste de estilo de Stability, por ejemplo `photographic`. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/sd3.5-flash/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la (primera) imagen PNG, válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, válida hasta 24 horas cada una. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx b/es/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx new file mode 100644 index 0000000000..56b3cad0d7 --- /dev/null +++ b/es/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx @@ -0,0 +1,254 @@ +--- +title: "Usa Sd3.5 Large Turbo con Comfy Router" +description: "Llama a stability/sd3.5-large-turbo mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Sd3.5 Large Turbo" +translationSourceHash: bf1698d4 +translationFrom: development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx +translationBlockHashes: + "_intro": edeedaf4 + "Quick start": 91e98117 + "Schema": 7695d82d + "Examples": cfbf5d5e +--- +{/* GENERATED FILE. Generated from router-schemas/stability/sd3.5-large-turbo.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/sd3.5-large-turbo`, servido por Comfy Router desde Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**Model ID:** `stability/sd3.5-large-turbo` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/sd3.5-large-turbo` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY desde el entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/sd3.5-large-turbo", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("stability/sd3.5-large-turbo", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/sd3.5-large-turbo \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/sd3.5-large-turbo/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida del resultado. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY desde el entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/sd3.5-large-turbo", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # junto con el model ID, es todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Si una solicitud falló o se canceló, aquí se lanza el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("stability/sd3.5-large-turbo", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // junto con el model ID, es todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Si una solicitud falló o se canceló, aquí se rechaza. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/sd3.5-large-turbo/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/sd3.5-large-turbo/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se ejecuta. +curl https://api.comfy.org/v2/models/stability/sd3.5-large-turbo/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Solo texto a imagen. Relación de aspecto de salida a aproximadamente un megapíxel. Predeterminado 1:1. + + Valores posibles: `1:1`, `16:9`, `9:16`, `21:9`, `9:21`, `3:2`, `2:3`, `5:4`, `4:5` + + + + Qué tan estrictamente sigue la imagen al prompt. + + Rango: `1` a `10` + + + + Solo imagen a imagen. Una URL de recurso firmada por Comfy de la imagen fuente. + + Formato: `uri` + + + + Predeterminado texto a imagen. imagen a imagen requiere `image` y `strength`. + + Valores posibles: `text-to-image`, `image-to-image` + + + + Qué mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué generar. + + + + 0, o si se omite, elige una semilla aleatoria. + + Rango: `0` a `4294967294` + + + + Solo imagen a imagen. Qué tanto alejarse de la imagen fuente; 1 la ignora. + + Rango: `0` a `1` + + + + Preajuste de estilo de Stability, por ejemplo `photographic`. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/sd3.5-large-turbo/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/sd3-5-medium/code.mdx b/es/development/comfy-router/models/stability/sd3-5-medium/code.mdx new file mode 100644 index 0000000000..eec939b255 --- /dev/null +++ b/es/development/comfy-router/models/stability/sd3-5-medium/code.mdx @@ -0,0 +1,254 @@ +--- +title: "Usar Sd3.5 Medium con Comfy Router" +description: "Llama a stability/sd3.5-medium con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Sd3.5 Medium" +translationSourceHash: 44cef259 +translationFrom: development/comfy-router/models/stability/sd3-5-medium/code.mdx +translationBlockHashes: + "_intro": 7ca55da1 + "Quick start": 2818786d + "Schema": 350e18e2 + "Examples": cfbf5d5e +--- +{/* GENERATED FILE. Generated from router-schemas/stability/sd3.5-medium.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API de `stability/sd3.5-medium`, servida por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. + +**ID del modelo:** `stability/sd3.5-medium` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/sd3.5-medium` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/sd3.5-medium", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/sd3.5-medium", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/sd3.5-medium \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/sd3.5-medium/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/sd3.5-medium", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta en bucle hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/sd3.5-medium", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta en bucle hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/sd3.5-medium/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" + +# 2. Consulta en bucle hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/sd3.5-medium/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/sd3.5-medium/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Solo texto a imagen. Relación de aspecto de salida de aproximadamente un megapíxel. Predeterminado 1:1. + + Valores posibles: `1:1`, `16:9`, `9:16`, `21:9`, `9:21`, `3:2`, `2:3`, `5:4`, `4:5` + + + + Qué tan estrictamente sigue la imagen al prompt. + + Alcance: `1` a `10` + + + + Solo imagen a imagen. Una URL de recurso firmada por Comfy de la imagen fuente. + + Formato: `uri` + + + + Predeterminado texto a imagen. imagen a imagen requiere `image` y `strength`. + + Valores posibles: `text-to-image`, `image-to-image` + + + + Lo que quieres mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué generar. + + + + Con 0 u omitida se elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + + + Solo imagen a imagen. Cuánto alejarse de la imagen fuente; 1 la ignora. + + Alcance: `0` a `1` + + + + Preset de estilo de Stability, por ejemplo `photographic`. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/sd3.5-medium/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en un 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, cada una válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx b/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx new file mode 100644 index 0000000000..e60d07a3cc --- /dev/null +++ b/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx @@ -0,0 +1,315 @@ +--- +title: "Usar Sdxl 1.0 Imagen a imagen con Comfy Router" +description: "Llama a stability/sdxl-1.0-image-to-image con Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." +sidebarTitle: "Sdxl 1.0 Imagen a imagen" +translationSourceHash: 3292fed8 +translationFrom: development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx +translationBlockHashes: + "_intro": 7a6c7089 + "Quick start": 47eae0dd + "Schema": e177bff5 + "Examples": c35b2edf +--- +{/* ARCHIVO GENERADO. Generado a partir de router-schemas/stability/sdxl-1.0-image-to-image.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API para `stability/sdxl-1.0-image-to-image`, servido por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `stability/sdxl-1.0-image-to-image` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-image-to-image` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/sdxl-1.0-image-to-image", + { + "samples": 1, + "seed": 12345, + "steps": 30, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/sdxl-1.0-image-to-image", { + samples: 1, + seed: 12345, + steps: 30, + text_prompts: [ + { + text: "a lighthouse on a cliff at sunset, oil painting", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-image-to-image \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"samples\": 1, \"seed\": 12345, \"steps\": 30, \"text_prompts\": [{\"text\":\"a lighthouse on a cliff at sunset, oil painting\"}]}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-image-to-image/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y recoges el resultado cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/sdxl-1.0-image-to-image", + { + "samples": 1, + "seed": 12345, + "steps": 30, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting", + }, + ], + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/sdxl-1.0-image-to-image", { + samples: 1, + seed: 12345, + steps: 30, + text_prompts: [ + { + text: "a lighthouse on a cliff at sunset, oil painting", + }, + ], +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-image-to-image/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"samples\": 1, \"seed\": 12345, \"steps\": 30, \"text_prompts\": [{\"text\":\"a lighthouse on a cliff at sunset, oil painting\"}]}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/sdxl-1.0-image-to-image/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se está ejecutando. +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-image-to-image/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Qué tan estrictamente sigue la imagen al prompt. Predeterminado 7. + + Alcance: `0` a `35` + + + + Preajuste de orientación CLIP de Stability, por ejemplo `NONE`. + + + + Se acepta por compatibilidad y se ignora. + + + + Solo texto a imagen. Alto de salida; debe formar uno de los tamaños compatibles de SDXL 1.0 junto con `width`. Predeterminado 1024. + + + + Solo imagen a imagen. Cuánto de la imagen fuente se conserva. + + Alcance: `0` a `1` + + + + Solo imagen a imagen, requerido en ese caso. Una URL de recurso firmada por Comfy de la imagen fuente. + + Formato: `uri` + + + + Solo imagen a imagen. Si `image_strength` o el programa de pasos controla cuánto de la imagen fuente se conserva. Predeterminado IMAGE_STRENGTH. + + Valores posibles: `IMAGE_STRENGTH`, `STEP_SCHEDULE` + + + + Nombre del sampler de Stability, por ejemplo `K_DPMPP_2M`. + + + + Cantidad de imágenes a generar. Predeterminado 1. Cada imagen devuelta se factura. + + Alcance: `1` a `10` + + + + Semilla para todo el lote. 0 u omitida elige una semilla aleatoria. + + Alcance: `0` a `…` + + + + Solo imagen a imagen, con `init_image_mode` STEP_SCHEDULE. + + Alcance: `0` a `1` + + + + Solo imagen a imagen, con `init_image_mode` STEP_SCHEDULE. + + Alcance: `0` a `1` + + + + Pasos de difusión. Predeterminado 30. + + Alcance: `10` a `30` + + + + Preajuste de estilo de Stability, por ejemplo `photographic`. + + + + Prompts, cada uno con un peso opcional. Un peso negativo lo convierte en un prompt negativo. + + + + + + + + + + + + Solo texto a imagen. Ancho de salida; debe formar uno de los tamaños compatibles de SDXL 1.0 junto con `height`. Predeterminado 1024. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/sdxl-1.0-image-to-image/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, cada una válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "samples": 1, + "seed": 12345, + "steps": 30, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting" + } + ] +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx b/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx new file mode 100644 index 0000000000..633a4a021e --- /dev/null +++ b/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx @@ -0,0 +1,315 @@ +--- +title: "Usa Sdxl 1.0 Text To Image con Comfy Router" +description: "Llama a stability/sdxl-1.0-text-to-image con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Sdxl 1.0 Text To Image" +translationSourceHash: 9cfae5ef +translationFrom: development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx +translationBlockHashes: + "_intro": 971090ae + "Quick start": a150d0c9 + "Schema": 79c052ef + "Examples": c35b2edf +--- +{/* GENERATED FILE. Generated from router-schemas/stability/sdxl-1.0-text-to-image.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/sdxl-1.0-text-to-image`, servido por Comfy Router desde Stability. + +**Entrada:** Texto · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. + +**ID del modelo:** `stability/sdxl-1.0-text-to-image` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-text-to-image` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/sdxl-1.0-text-to-image", + { + "samples": 1, + "seed": 12345, + "steps": 30, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/sdxl-1.0-text-to-image", { + samples: 1, + seed: 12345, + steps: 30, + text_prompts: [ + { + text: "a lighthouse on a cliff at sunset, oil painting", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-text-to-image \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"samples\": 1, \"seed\": 12345, \"steps\": 30, \"text_prompts\": [{\"text\":\"a lighthouse on a cliff at sunset, oil painting\"}]}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-text-to-image/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado en cuanto esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/sdxl-1.0-text-to-image", + { + "samples": 1, + "seed": 12345, + "steps": 30, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting", + }, + ], + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/sdxl-1.0-text-to-image", { + samples: 1, + seed: 12345, + steps: 30, + text_prompts: [ + { + text: "a lighthouse on a cliff at sunset, oil painting", + }, + ], +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-text-to-image/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"samples\": 1, \"seed\": 12345, \"steps\": 30, \"text_prompts\": [{\"text\":\"a lighthouse on a cliff at sunset, oil painting\"}]}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/sdxl-1.0-text-to-image/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se ejecuta. +curl https://api.comfy.org/v2/models/stability/sdxl-1.0-text-to-image/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Qué tan estrictamente sigue la imagen el prompt. Predeterminado: 7. + + Alcance: `0` a `35` + + + + Preajuste de orientación CLIP de Stability, por ejemplo `NONE`. + + + + Se acepta por compatibilidad y se ignora. + + + + Solo texto a imagen. Alto de salida; debe formar uno de los tamaños compatibles de SDXL 1.0 junto con `width`. Predeterminado: 1024. + + + + Solo imagen a imagen. Cuánto se conserva de la imagen fuente. + + Alcance: `0` a `1` + + + + Solo imagen a imagen, requerido allí. Una URL de recurso de la imagen fuente, firmada por Comfy. + + Formato: `uri` + + + + Solo imagen a imagen. Indica si `image_strength` o la programación de pasos controla cuánto se conserva de la imagen fuente. Predeterminado: IMAGE_STRENGTH. + + Valores posibles: `IMAGE_STRENGTH`, `STEP_SCHEDULE` + + + + Nombre del sampler de Stability, por ejemplo `K_DPMPP_2M`. + + + + Número de imágenes a generar. Predeterminado: 1. Cada imagen devuelta genera un cargo. + + Alcance: `1` a `10` + + + + Semilla para todo el lote. 0 u omitido elige una semilla aleatoria. + + Alcance: `0` a `…` + + + + Solo imagen a imagen, con `init_image_mode` STEP_SCHEDULE. + + Alcance: `0` a `1` + + + + Solo imagen a imagen, con `init_image_mode` STEP_SCHEDULE. + + Alcance: `0` a `1` + + + + Pasos de diffusion. Predeterminado: 30. + + Alcance: `10` a `30` + + + + Preajuste de estilo de Stability, por ejemplo `photographic`. + + + + Prompts, cada uno con un peso opcional. Un peso negativo lo convierte en un prompt negativo. + + + + + + + + + + + + Solo texto a imagen. Ancho de salida; debe formar uno de los tamaños compatibles de SDXL 1.0 junto con `height`. Predeterminado: 1024. + + +Generado a partir del esquema que Router publica en `GET /v2/models/stability/sdxl-1.0-text-to-image/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL de la imagen PNG (la primera), firmada por Comfy, válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de la imagen firmadas por Comfy, en el orden de salida, cada una válida hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "samples": 1, + "seed": 12345, + "steps": 30, + "text_prompts": [ + { + "text": "a lighthouse on a cliff at sunset, oil painting" + } + ] +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/stable-fast-3d/code.mdx b/es/development/comfy-router/models/stability/stable-fast-3d/code.mdx new file mode 100644 index 0000000000..0c7937eb69 --- /dev/null +++ b/es/development/comfy-router/models/stability/stable-fast-3d/code.mdx @@ -0,0 +1,229 @@ +--- +title: "Usa Stable Fast 3D con Comfy Router" +description: "Llama a stability/stable-fast-3d mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Stable Fast 3D" +translationSourceHash: 840853ec +translationFrom: development/comfy-router/models/stability/stable-fast-3d/code.mdx +translationBlockHashes: + "_intro": 80864960 + "Quick start": 6dea4ed8 + "Schema": 29acba54 + "Examples": 5ebf5f84 +--- + +{/* GENERATED FILE. Generated from router-schemas/stability/stable-fast-3d.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/stable-fast-3d`, servido por Comfy Router de Stability. + +**Entrada:** Imagen · **Salida:** 3D + + + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. + +**Model ID:** `stability/stable-fast-3d` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/stable-fast-3d` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/stable-fast-3d", + { + "foreground_ratio": 0.85, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "remesh": "none", + "texture_resolution": 1024, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("stability/stable-fast-3d", { + foreground_ratio: 0.85, + image: "https://storage.googleapis.com/example-bucket/source.png", + remesh: "none", + texture_resolution: 1024, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/stable-fast-3d \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"foreground_ratio\": 0.85, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"remesh\": \"none\", \"texture_resolution\": 1024}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/stable-fast-3d/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/stable-fast-3d", + { + "foreground_ratio": 0.85, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "remesh": "none", + "texture_resolution": 1024, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("stability/stable-fast-3d", { + foreground_ratio: 0.85, + image: "https://storage.googleapis.com/example-bucket/source.png", + remesh: "none", + texture_resolution: 1024, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Aquí se rechaza una solicitud que falló o se canceló. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Enviar. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/stable-fast-3d/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"foreground_ratio\": 0.85, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"remesh\": \"none\", \"texture_resolution\": 1024}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/stable-fast-3d/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoger. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/stable-fast-3d/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Qué proporción del encuadre ocupa el sujeto. Predeterminado 0.85. + + Rango: `0.1` a `1` + + + + Una URL de recurso firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Modo de remallado. Predeterminado `none`. + + Valores posibles: `none`, `triangle`, `quad` + + + + Tamaño de textura. Predeterminado 1024. + + Valores posibles: `512`, `1024`, `2048` + + + + Recuento de vértices objetivo. -1 deja el recuento propio del gráfico. Predeterminado -1. + + Rango: `-1` a `20000` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/stable-fast-3d/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en un 200. + + + + URL firmada por Comfy del GLB, válida por hasta 24 horas. + + Formato: `uri` + + +## Ejemplos + +### Entrada + +```json +{ + "foreground_ratio": 0.85, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "remesh": "none", + "texture_resolution": 1024 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "model": "https://example.invalid/stability/model.glb" +} +``` + + From b39e94bcd4c2e8d6a1bb04101013271cbca93f1f Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:07:27 +0800 Subject: [PATCH 07/36] i18n(es): sync router model pages with upstream/main (2026-11-10) --- .../stability/control-structure/code.mdx | 241 +++++++++++++++ .../models/stability/edit-inpaint/code.mdx | 243 +++++++++++++++ .../models/stability/edit-outpaint/code.mdx | 261 ++++++++++++++++ .../stability/edit-remove-background/code.mdx | 202 +++++++++++++ .../code.mdx | 282 ++++++++++++++++++ .../edit-search-and-replace/code.mdx | 241 +++++++++++++++ .../models/stability/sd3-5-large/code.mdx | 254 ++++++++++++++++ .../stability/stable-point-aware-3d/code.mdx | 249 ++++++++++++++++ .../stability/upscale-conservative/code.mdx | 237 +++++++++++++++ .../models/stability/upscale-fast/code.mdx | 203 +++++++++++++ 10 files changed, 2413 insertions(+) create mode 100644 es/development/comfy-router/models/stability/control-structure/code.mdx create mode 100644 es/development/comfy-router/models/stability/edit-inpaint/code.mdx create mode 100644 es/development/comfy-router/models/stability/edit-outpaint/code.mdx create mode 100644 es/development/comfy-router/models/stability/edit-remove-background/code.mdx create mode 100644 es/development/comfy-router/models/stability/edit-replace-background-and-relight/code.mdx create mode 100644 es/development/comfy-router/models/stability/edit-search-and-replace/code.mdx create mode 100644 es/development/comfy-router/models/stability/sd3-5-large/code.mdx create mode 100644 es/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx create mode 100644 es/development/comfy-router/models/stability/upscale-conservative/code.mdx create mode 100644 es/development/comfy-router/models/stability/upscale-fast/code.mdx diff --git a/es/development/comfy-router/models/stability/control-structure/code.mdx b/es/development/comfy-router/models/stability/control-structure/code.mdx new file mode 100644 index 0000000000..9c90e3e417 --- /dev/null +++ b/es/development/comfy-router/models/stability/control-structure/code.mdx @@ -0,0 +1,241 @@ +--- +title: "Usa Control Structure con Comfy Router" +description: "Llama a stability/control-structure con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Control Structure" +translationSourceHash: 7b7a5eb8 +translationFrom: development/comfy-router/models/stability/control-structure/code.mdx +translationBlockHashes: + "_intro": b4312d32 + "Quick start": bfa44e74 + "Schema": 574856e9 + "Examples": fb83bd94 +--- +{/* ARCHIVO GENERADO. Generado a partir de router-schemas/stability/control-structure.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API de `stability/control-structure`, servida por Comfy Router desde Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. + +**ID del modelo:** `stability/control-structure` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/control-structure` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/control-structure", + { + "control_strength": 0.7, + "image": "https://storage.googleapis.com/example-bucket/sketch.png", + "prompt": "a castle on a cliff", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/control-structure", { + control_strength: 0.7, + image: "https://storage.googleapis.com/example-bucket/sketch.png", + prompt: "a castle on a cliff", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/control-structure \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"control_strength\": 0.7, \"image\": \"https://storage.googleapis.com/example-bucket/sketch.png\", \"prompt\": \"a castle on a cliff\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/control-structure/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso o desde otro. [Queued delivery](/es/development/comfy-router/queue) explica paso a paso el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/control-structure", + { + "control_strength": 0.7, + "image": "https://storage.googleapis.com/example-bucket/sketch.png", + "prompt": "a castle on a cliff", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/control-structure", { + control_strength: 0.7, + image: "https://storage.googleapis.com/example-bucket/sketch.png", + prompt: "a castle on a cliff", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/control-structure/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"control_strength\": 0.7, \"image\": \"https://storage.googleapis.com/example-bucket/sketch.png\", \"prompt\": \"a castle on a cliff\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/control-structure/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/control-structure/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Qué tan fielmente sigue el resultado a la imagen fuente. Predeterminado 0.7. + + Alcance: `0` a `1` + + + + Una URL de recurso firmada por Comfy de la imagen fuente. + + Formato: `uri` + + + + Lo que se debe mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué generar a partir de la imagen fuente. + + + + 0 u omitido elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + + + Se acepta y no se aplica. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/control-structure/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la (primera) imagen PNG, válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "control_strength": 0.7, + "image": "https://storage.googleapis.com/example-bucket/sketch.png", + "prompt": "a castle on a cliff", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/edit-inpaint/code.mdx b/es/development/comfy-router/models/stability/edit-inpaint/code.mdx new file mode 100644 index 0000000000..d24c4775aa --- /dev/null +++ b/es/development/comfy-router/models/stability/edit-inpaint/code.mdx @@ -0,0 +1,243 @@ +--- +title: "Usar Edit Inpaint con Comfy Router" +description: "Llama a stability/edit-inpaint con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Edit Inpaint" +translationSourceHash: 12d21573 +translationFrom: development/comfy-router/models/stability/edit-inpaint/code.mdx +translationBlockHashes: + "_intro": 57632da7 + "Quick start": 11679758 + "Schema": fbd7a87c + "Examples": dc141907 +--- +{/* GENERATED FILE. Generated from router-schemas/stability/edit-inpaint.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/edit-inpaint`, servido por Comfy Router desde Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `stability/edit-inpaint` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/edit-inpaint` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/edit-inpaint", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + "mask": "https://storage.googleapis.com/example-bucket/mask.png", + "prompt": "a red door", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/edit-inpaint", { + image: "https://storage.googleapis.com/example-bucket/source.png", + mask: "https://storage.googleapis.com/example-bucket/mask.png", + prompt: "a red door", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/edit-inpaint \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"mask\": \"https://storage.googleapis.com/example-bucket/mask.png\", \"prompt\": \"a red door\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/edit-inpaint/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida del resultado. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/edit-inpaint", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + "mask": "https://storage.googleapis.com/example-bucket/mask.png", + "prompt": "a red door", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/edit-inpaint", { + image: "https://storage.googleapis.com/example-bucket/source.png", + mask: "https://storage.googleapis.com/example-bucket/mask.png", + prompt: "a red door", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/edit-inpaint/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"mask\": \"https://storage.googleapis.com/example-bucket/mask.png\", \"prompt\": \"a red door\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/edit-inpaint/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge el resultado. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/edit-inpaint/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Cuánto crecer la máscara, en píxeles. Predeterminado 5. + + Alcance: `0` a `100` + + + + Una URL de recurso firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Una URL de recurso firmada por Comfy de la máscara. El blanco marca el área a repintar. Si se omite, el alfa de la propia imagen es la máscara. + + Formato: `uri` + + + + Lo que quieres mantener fuera del área pintada. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Lo que quieres pintar dentro del área enmascarada. + + + + 0 u omitido elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/edit-inpaint/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la (primera) imagen PNG, válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, cada una válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "image": "https://storage.googleapis.com/example-bucket/source.png", + "mask": "https://storage.googleapis.com/example-bucket/mask.png", + "prompt": "a red door", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/edit-outpaint/code.mdx b/es/development/comfy-router/models/stability/edit-outpaint/code.mdx new file mode 100644 index 0000000000..503e8a110a --- /dev/null +++ b/es/development/comfy-router/models/stability/edit-outpaint/code.mdx @@ -0,0 +1,261 @@ +--- +title: "Usa Edit Outpaint con Comfy Router" +description: "Llama a stability/edit-outpaint mediante Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." +sidebarTitle: "Edit Outpaint" +translationSourceHash: 3d71fc67 +translationFrom: development/comfy-router/models/stability/edit-outpaint/code.mdx +translationBlockHashes: + "_intro": f141a34a + "Quick start": 9f30e560 + "Schema": feda2e9e + "Examples": d4acf3eb +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/stability/edit-outpaint.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/edit-outpaint`, servida por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar. + +**ID del modelo:** `stability/edit-outpaint` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/edit-outpaint` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/edit-outpaint", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + "left": 64, + "prompt": "a cliff beyond the frame", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/edit-outpaint", { + image: "https://storage.googleapis.com/example-bucket/source.png", + left: 64, + prompt: "a cliff beyond the frame", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/edit-outpaint \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"left\": 64, \"prompt\": \"a cliff beyond the frame\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/edit-outpaint/requests`. Router responde con `201` y un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/edit-outpaint", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + "left": 64, + "prompt": "a cliff beyond the frame", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/edit-outpaint", { + image: "https://storage.googleapis.com/example-bucket/source.png", + left: 64, + prompt: "a cliff beyond the frame", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/edit-outpaint/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"left\": 64, \"prompt\": \"a cliff beyond the frame\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/edit-outpaint/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras aún se ejecuta. +curl https://api.comfy.org/v2/models/stability/edit-outpaint/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Con qué libertad inventar el área extendida. Predeterminado: 0.5. + + Rango: `0` a `1` + + + + Píxeles que se agregan debajo. Predeterminado: 0. + + Rango: `0` a `2000` + + + + Una URL de recurso firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Píxeles que se agregan a la izquierda. Predeterminado: 0. Al menos uno de left, right, up o down debe ser mayor que 0. + + Rango: `0` a `2000` + + + + Se acepta y no se aplica. El gráfico de outpainting no tiene prompt negativo. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué pintar en el área extendida. + + + + Píxeles que se agregan a la derecha. Predeterminado: 0. + + Rango: `0` a `2000` + + + + 0 u omitido elige una semilla aleatoria. + + Rango: `0` a `4294967294` + + + + Píxeles que se agregan arriba. Predeterminado: 0. + + Rango: `0` a `2000` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/edit-outpaint/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida hasta por 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, válida cada una hasta por 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "image": "https://storage.googleapis.com/example-bucket/source.png", + "left": 64, + "prompt": "a cliff beyond the frame", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/edit-remove-background/code.mdx b/es/development/comfy-router/models/stability/edit-remove-background/code.mdx new file mode 100644 index 0000000000..b401e0651f --- /dev/null +++ b/es/development/comfy-router/models/stability/edit-remove-background/code.mdx @@ -0,0 +1,202 @@ +--- +title: "Usa Edit Remove Background con Comfy Router" +description: "Llama a stability/edit-remove-background con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Edit Remove Background" +translationSourceHash: 955b6df3 +translationFrom: development/comfy-router/models/stability/edit-remove-background/code.mdx +translationBlockHashes: + "_intro": 184c5af6 + "Quick start": f0ebf0c5 + "Schema": d19c8b5f + "Examples": 83ee045c +--- +{/* GENERATED FILE. Generated from router-schemas/stability/edit-remove-background.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API para `stability/edit-remove-background`, servida por Comfy Router de Stability. + +**Entrada:** Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. + +**ID del modelo:** `stability/edit-remove-background` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/edit-remove-background` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/edit-remove-background", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/edit-remove-background", { + image: "https://storage.googleapis.com/example-bucket/source.png", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/edit-remove-background \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/edit-remove-background/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/edit-remove-background", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/edit-remove-background", { + image: "https://storage.googleapis.com/example-bucket/source.png", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/edit-remove-background/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/edit-remove-background/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/edit-remove-background/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Una URL de asset firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/edit-remove-background/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en un 200. + + + + URL firmada por Comfy de la (primera) imagen PNG, válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "image": "https://storage.googleapis.com/example-bucket/source.png" +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code.mdx b/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code.mdx new file mode 100644 index 0000000000..94d2ced0d0 --- /dev/null +++ b/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code.mdx @@ -0,0 +1,282 @@ +--- +title: "Usar Edit Replace Background And Relight con Comfy Router" +description: "Llama a stability/edit-replace-background-and-relight con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Edit Replace Background And Relight" +translationSourceHash: 8246dd26 +translationFrom: development/comfy-router/models/stability/edit-replace-background-and-relight/code.mdx +translationBlockHashes: + "_intro": 4905026e + "Quick start": bcd86eb7 + "Schema": 0d992a1c + "Examples": 2e983eb6 +--- +{/* GENERATED FILE. Generated from router-schemas/stability/edit-replace-background-and-relight.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/edit-replace-background-and-relight`, servida por Comfy Router desde Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. + +**ID del modelo:** `stability/edit-replace-background-and-relight` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/edit-replace-background-and-relight` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/edit-replace-background-and-relight", + { + "background_prompt": "a sunlit beach at golden hour", + "light_source_direction": "above", + "light_source_strength": 0.5, + "seed": 12345, + "subject_image": "https://storage.googleapis.com/example-bucket/subject.png", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("stability/edit-replace-background-and-relight", { + background_prompt: "a sunlit beach at golden hour", + light_source_direction: "above", + light_source_strength: 0.5, + seed: 12345, + subject_image: "https://storage.googleapis.com/example-bucket/subject.png", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/edit-replace-background-and-relight \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"background_prompt\": \"a sunlit beach at golden hour\", \"light_source_direction\": \"above\", \"light_source_strength\": 0.5, \"seed\": 12345, \"subject_image\": \"https://storage.googleapis.com/example-bucket/subject.png\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/edit-replace-background-and-relight/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/edit-replace-background-and-relight", + { + "background_prompt": "a sunlit beach at golden hour", + "light_source_direction": "above", + "light_source_strength": 0.5, + "seed": 12345, + "subject_image": "https://storage.googleapis.com/example-bucket/subject.png", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("stability/edit-replace-background-and-relight", { + background_prompt: "a sunlit beach at golden hour", + light_source_direction: "above", + light_source_strength: 0.5, + seed: 12345, + subject_image: "https://storage.googleapis.com/example-bucket/subject.png", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/edit-replace-background-and-relight/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"background_prompt\": \"a sunlit beach at golden hour\", \"light_source_direction\": \"above\", \"light_source_strength\": 0.5, \"seed\": 12345, \"subject_image\": \"https://storage.googleapis.com/example-bucket/subject.png\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/edit-replace-background-and-relight/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se está ejecutando. +curl https://api.comfy.org/v2/models/stability/edit-replace-background-and-relight/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + El nuevo fondo. Requerido cuando se omite `background_reference`. + + + + URL de un recurso firmado por Comfy de una imagen que sirve de referencia para el nuevo fondo. + + Formato: `uri` + + + + Qué es el sujeto. + + + + `true` conserva elementos del fondo original. Predeterminado `false`. Es una cadena, como en los campos de formulario de Stability. + + Valores posibles: `true`, `false` + + + + URL de un recurso firmado por Comfy de una imagen que sirve de referencia para la iluminación. + + Formato: `uri` + + + + De dónde viene la luz. `left` no está disponible. + + Valores posibles: `right`, `below`, `above` + + + + Qué tan intensa es la luz. Requiere `light_reference` o `light_source_direction`. + + Rango: `0` a `1` + + + + Lo que quieres mantener fuera de la imagen. + + + + Qué tan fielmente el nuevo fondo coincide con la profundidad del sujeto. Predeterminado 0.5. + + Rango: `0` a `1` + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué tan exactamente se conserva el sujeto original. Predeterminado 0.6. + + Rango: `0` a `1` + + + + `0` o si se omite, se elige una semilla al azar. + + Rango: `0` a `4294967294` + + + + URL de un recurso firmado por Comfy de la imagen cuyo sujeto se conserva. + + Formato: `uri` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/edit-replace-background-and-relight/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la (primera) imagen PNG, válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "background_prompt": "a sunlit beach at golden hour", + "light_source_direction": "above", + "light_source_strength": 0.5, + "seed": 12345, + "subject_image": "https://storage.googleapis.com/example-bucket/subject.png" +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/edit-search-and-replace/code.mdx b/es/development/comfy-router/models/stability/edit-search-and-replace/code.mdx new file mode 100644 index 0000000000..97e949a635 --- /dev/null +++ b/es/development/comfy-router/models/stability/edit-search-and-replace/code.mdx @@ -0,0 +1,241 @@ +--- +title: "Usar Edit Search And Replace con Comfy Router" +description: "Llama a stability/edit-search-and-replace mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Edit Search And Replace" +translationSourceHash: 5a9ea435 +translationFrom: development/comfy-router/models/stability/edit-search-and-replace/code.mdx +translationBlockHashes: + "_intro": 586d8d91 + "Quick start": fca8e74c + "Schema": 3cf4e7fd + "Examples": a6bc9010 +--- +{/* GENERATED FILE. Generated from router-schemas/stability/edit-search-and-replace.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/edit-search-and-replace`, servida por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. + +**ID del modelo:** `stability/edit-search-and-replace` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/edit-search-and-replace` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/edit-search-and-replace", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a dog", + "search_prompt": "the cat", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("stability/edit-search-and-replace", { + image: "https://storage.googleapis.com/example-bucket/source.png", + prompt: "a dog", + search_prompt: "the cat", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/edit-search-and-replace \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"prompt\": \"a dog\", \"search_prompt\": \"the cat\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/edit-search-and-replace/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/edit-search-and-replace", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a dog", + "search_prompt": "the cat", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que otro proceso necesita + + # Sondea hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("stability/edit-search-and-replace", { + image: "https://storage.googleapis.com/example-bucket/source.png", + prompt: "a dog", + search_prompt: "the cat", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que otro proceso necesita + +// Sondea hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/edit-search-and-replace/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"prompt\": \"a dog\", \"search_prompt\": \"the cat\", \"seed\": 12345}" + +# 2. Sondea hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indique cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/edit-search-and-replace/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/edit-search-and-replace/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Cuánto expandir, en píxeles, el área encontrada. Predeterminado: 3. + + Rango: `0` a `20` + + + + Una URL de activo firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Qué excluir del reemplazo. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué colocar en lugar del objeto encontrado. + + + + Qué buscar en la imagen. + + + + 0 o si se omite, se elige una semilla aleatoria. + + Rango: `0` a `4294967294` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/edit-search-and-replace/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida por hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Cada URL de imagen firmada por Comfy, en el orden de salida, y cada una válida por hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a dog", + "search_prompt": "the cat", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/sd3-5-large/code.mdx b/es/development/comfy-router/models/stability/sd3-5-large/code.mdx new file mode 100644 index 0000000000..62608b540d --- /dev/null +++ b/es/development/comfy-router/models/stability/sd3-5-large/code.mdx @@ -0,0 +1,254 @@ +--- +title: "Usa Sd3.5 Large con Comfy Router" +description: "Llama a stability/sd3.5-large con Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." +sidebarTitle: "Sd3.5 Large" +translationSourceHash: eeeae888 +translationFrom: development/comfy-router/models/stability/sd3-5-large/code.mdx +translationBlockHashes: + "_intro": 0cefb85f + "Quick start": 4d396c75 + "Schema": 7bc13fc4 + "Examples": cfbf5d5e +--- +{/* GENERATED FILE. Generated from router-schemas/stability/sd3.5-large.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/sd3.5-large`, servido por Comfy Router de Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `stability/sd3.5-large` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/sd3.5-large` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/sd3.5-large", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/sd3.5-large", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/sd3.5-large \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/sd3.5-large/requests`. Router responde `201` con un `request_id` en cuanto acepta la ejecución, y puedes recoger el resultado en cuanto esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/sd3.5-large", + { + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/sd3.5-large", { + aspect_ratio: "16:9", + prompt: "a lighthouse on a cliff at sunset, oil painting", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló provoca aquí un rechazo. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/sd3.5-large/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"prompt\": \"a lighthouse on a cliff at sunset, oil painting\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indique cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/sd3.5-large/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se está ejecutando. +curl https://api.comfy.org/v2/models/stability/sd3.5-large/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Solo texto a imagen. Relación de aspecto de salida a aproximadamente un megapíxel. Predeterminado 1:1. + + Valores posibles: `1:1`, `16:9`, `9:16`, `21:9`, `9:21`, `3:2`, `2:3`, `5:4`, `4:5` + + + + Qué tan estrictamente sigue la imagen el prompt. + + Alcance: `1` a `10` + + + + Solo imagen a imagen. URL de recurso firmada por Comfy de la imagen fuente. + + Formato: `uri` + + + + Predeterminado: texto a imagen. imagen a imagen requiere `image` y `strength`. + + Valores posibles: `text-to-image`, `image-to-image` + + + + Qué mantener fuera de la imagen. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Qué generar. + + + + 0 u omitido elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + + + Solo imagen a imagen. Cuánto alejarse de la imagen fuente; 1 la ignora. + + Alcance: `0` a `1` + + + + Preajuste de estilo de Stability, por ejemplo `photographic`. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/sd3.5-large/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en un 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imágenes firmadas por Comfy, en el orden de salida, cada una válida hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "prompt": "a lighthouse on a cliff at sunset, oil painting", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx b/es/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx new file mode 100644 index 0000000000..d266914fc4 --- /dev/null +++ b/es/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx @@ -0,0 +1,249 @@ +--- +title: "Usa Stable Point Aware 3D con Comfy Router" +description: "Llama a stability/stable-point-aware-3d mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Stable Point Aware 3D" +translationSourceHash: 3809be2d +translationFrom: development/comfy-router/models/stability/stable-point-aware-3d/code.mdx +translationBlockHashes: + "_intro": 4db98c10 + "Quick start": e0f9e3ee + "Schema": 8b3161fc + "Examples": 103a1dd8 +--- +{/* ARCHIVO GENERADO. Generado a partir de router-schemas/stability/stable-point-aware-3d.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/stable-point-aware-3d`, ofrecida por Comfy Router de Stability. + +**Entrada:** Imagen · **Salida:** 3D + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `stability/stable-point-aware-3d` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/stable-point-aware-3d` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/stable-point-aware-3d", + { + "foreground_ratio": 1.3, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "seed": 12345, + "texture_resolution": 1024, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/stable-point-aware-3d", { + foreground_ratio: 1.3, + image: "https://storage.googleapis.com/example-bucket/source.png", + seed: 12345, + texture_resolution: 1024, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/stable-point-aware-3d \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"foreground_ratio\": 1.3, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"seed\": 12345, \"texture_resolution\": 1024}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/stable-point-aware-3d/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/stable-point-aware-3d", + { + "foreground_ratio": 1.3, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "seed": 12345, + "texture_resolution": 1024, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/stable-point-aware-3d", { + foreground_ratio: 1.3, + image: "https://storage.googleapis.com/example-bucket/source.png", + seed: 12345, + texture_resolution: 1024, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/stable-point-aware-3d/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"foreground_ratio\": 1.3, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"seed\": 12345, \"texture_resolution\": 1024}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/stable-point-aware-3d/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras aún se ejecuta. +curl https://api.comfy.org/v2/models/stability/stable-point-aware-3d/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Qué proporción del encuadre ocupa el sujeto. Predeterminado: 1.3. + + Rango: `1` a `2` + + + + Qué tan fielmente sigue el resultado a la fuente. Predeterminado: 3. + + Rango: `1` a `10` + + + + URL firmada por Comfy del recurso de la imagen fuente. + + Formato: `uri` + + + + Modo de remallado. Predeterminado: `none`. + + Valores posibles: `none`, `triangle`, `quad` + + + + 0 o su omisión seleccionan una semilla aleatoria. + + Rango: `0` a `4294967294` + + + + Cantidad objetivo de vértices o caras. Predeterminado: 1000. + + Rango: `100` a `20000` + + + + Qué cuenta `target_count`. Predeterminado: `none`. + + Valores posibles: `none`, `vertex`, `face` + + + + Tamaño de la textura. Predeterminado: 1024. + + Valores posibles: `512`, `1024`, `2048` + + +Generado a partir del esquema que Router expone en `GET /v2/models/stability/stable-point-aware-3d/openapi.json`, el mismo documento que usa para validar una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL del GLB firmada por Comfy, válida por un máximo de 24 horas. + + Formato: `uri` + + + + La semilla con la que se generó el modelo. + + +## Ejemplos + +### Entrada + +```json +{ + "foreground_ratio": 1.3, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "seed": 12345, + "texture_resolution": 1024 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "model": "https://example.invalid/stability/model.glb", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/upscale-conservative/code.mdx b/es/development/comfy-router/models/stability/upscale-conservative/code.mdx new file mode 100644 index 0000000000..a9666f49d9 --- /dev/null +++ b/es/development/comfy-router/models/stability/upscale-conservative/code.mdx @@ -0,0 +1,237 @@ +--- +title: "Usa Upscale Conservative con Comfy Router" +description: "Llama a stability/upscale-conservative con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Upscale Conservative" +translationSourceHash: fc3a2797 +translationFrom: development/comfy-router/models/stability/upscale-conservative/code.mdx +translationBlockHashes: + "_intro": ec086134 + "Quick start": 2e00f3e5 + "Schema": e249f28c + "Examples": 1ff6910b +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/stability/upscale-conservative.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API de `stability/upscale-conservative`, servido por Comfy Router desde Stability. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `stability/upscale-conservative` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/upscale-conservative` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/upscale-conservative", + { + "creativity": 0.35, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a detailed photo of a cat", + "seed": 12345, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/upscale-conservative", { + creativity: 0.35, + image: "https://storage.googleapis.com/example-bucket/source.png", + prompt: "a detailed photo of a cat", + seed: 12345, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/upscale-conservative \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"creativity\": 0.35, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"prompt\": \"a detailed photo of a cat\", \"seed\": 12345}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/upscale-conservative/requests`. Router responde `201` con un `request_id` en cuanto acepta la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) describe el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/upscale-conservative", + { + "creativity": 0.35, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a detailed photo of a cat", + "seed": 12345, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/upscale-conservative", { + creativity: 0.35, + image: "https://storage.googleapis.com/example-bucket/source.png", + prompt: "a detailed photo of a cat", + seed: 12345, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// Devuelve el mismo resultado que models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/upscale-conservative/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"creativity\": 0.35, \"image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"prompt\": \"a detailed photo of a cat\", \"seed\": 12345}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/upscale-conservative/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/stability/upscale-conservative/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Cuánto detalle inventar. Valor predeterminado 0.35. + + Alcance: `0.2` a `0.5` + + + + Una URL de recurso firmada por Comfy de la imagen de origen. + + Formato: `uri` + + + + Lo que se debe mantener fuera de la imagen con upscale. + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + + + Lo que muestra la imagen con upscale. + + + + 0, u omitir el campo, elige una semilla aleatoria. + + Alcance: `0` a `4294967294` + + +Se genera a partir del esquema que Router sirve en `GET /v2/models/stability/upscale-conservative/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL de la imagen PNG (la primera) firmada por Comfy, válida hasta 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, y cada una válida hasta 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "creativity": 0.35, + "image": "https://storage.googleapis.com/example-bucket/source.png", + "prompt": "a detailed photo of a cat", + "seed": 12345 +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + diff --git a/es/development/comfy-router/models/stability/upscale-fast/code.mdx b/es/development/comfy-router/models/stability/upscale-fast/code.mdx new file mode 100644 index 0000000000..105563f312 --- /dev/null +++ b/es/development/comfy-router/models/stability/upscale-fast/code.mdx @@ -0,0 +1,203 @@ +--- +title: "Usar Upscale Fast con Comfy Router" +description: "Llama a stability/upscale-fast a través de Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Upscale Fast" +translationSourceHash: d22457f3 +translationFrom: development/comfy-router/models/stability/upscale-fast/code.mdx +translationBlockHashes: + "_intro": 95e1f652 + "Quick start": d646684c + "Schema": 73f9b53d + "Examples": 83ee045c +--- + +{/* GENERATED FILE. Generated from router-schemas/stability/upscale-fast.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `stability/upscale-fast`, servida por Comfy Router de Stability. + +**Entrada:** Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar. + +**ID del modelo:** `stability/upscale-fast` + +**Endpoint:** `POST https://api.comfy.org/v2/models/stability/upscale-fast` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "stability/upscale-fast", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("stability/upscale-fast", { + image: "https://storage.googleapis.com/example-bucket/source.png", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/stability/upscale-fast \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/upscale-fast/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "stability/upscale-fast", + { + "image": "https://storage.googleapis.com/example-bucket/source.png", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("stability/upscale-fast", { + image: "https://storage.googleapis.com/example-bucket/source.png", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Enviar. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/stability/upscale-fast/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"image\": \"https://storage.googleapis.com/example-bucket/source.png\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/stability/upscale-fast/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoger. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se está ejecutando. +curl https://api.comfy.org/v2/models/stability/upscale-fast/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + URL del recurso de la imagen de origen, firmada por Comfy. + + Formato: `uri` + + + + Solo se devuelve `png`. + + Valores posibles: `png` + + +Generado a partir del esquema que Router publica en `GET /v2/models/stability/upscale-fast/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Siempre SUCCESS en una respuesta 200. + + + + URL firmada por Comfy de la imagen PNG (la primera), válida por un máximo de 24 horas. + + Formato: `uri` + + + + Solo SDXL, cuando se devolvió más de una imagen. Todas las URL de imagen firmadas por Comfy, en el orden de salida, cada una válida por un máximo de 24 horas. + + + + La semilla con la que se generó la imagen. + + +## Ejemplos + +### Entrada + +```json +{ + "image": "https://storage.googleapis.com/example-bucket/source.png" +} +``` + +### Salida + +```json +{ + "finish_reason": "SUCCESS", + "image": "https://example.invalid/stability/image.png", + "seed": 12345 +} +``` + + From 2894a373ef7f1e3414f93f1dce1aaf105e817870 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:11:52 +0800 Subject: [PATCH 08/36] i18n(es): sync router model pages with upstream/main (2026-11-10) --- .../models/wan/happyhorse-1-0-i2v/code.mdx | 77 ++++++++-------- .../models/wan/happyhorse-1-0-r2v/code.mdx | 65 +++++++------- .../models/wan/happyhorse-1-1-i2v/code.mdx | 73 ++++++++-------- .../models/wan/happyhorse-1-1-r2v/code.mdx | 87 +++++++++---------- .../models/wan/wan2-5-i2i-preview/code.mdx | 11 +-- .../models/wan/wan2-5-i2v-preview/code.mdx | 64 ++++++++------ .../models/wan/wan2-6-t2v/code.mdx | 71 +++++++-------- .../models/wan/wan2-7-t2v/code.mdx | 67 +++++++------- .../models/wan/wan2-7-videoedit/code.mdx | 80 ++++++++--------- .../models/wan/wan3-0-video/code.mdx | 74 ++++++++-------- 10 files changed, 335 insertions(+), 334 deletions(-) diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index 98098cb6b6..6cf0615efb 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa HappyHorse 1.0 I2V con Comfy Router" description: "Snippets de Python, TypeScript y cURL para llamar a wan/happyhorse-1.0-i2v por HTTP con Comfy Router, más los campos de la solicitud y la forma del resultado" sidebarTitle: "HappyHorse 1.0 I2V" -translationSourceHash: fd06ba6e +translationSourceHash: da380385 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx translationBlockHashes: "_intro": 7d98975f "Quick start": c7e0bda8 - "Schema": 8445191f + "Schema": 229263d1 "Examples": 5ffd46d7 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -204,7 +205,7 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-i2v/requests/$REQUEST_ID - URL de descarga del archivo de audio. Formatos compatibles: mp3 y wav. No es compatible con reference_video_urls. + URL de descarga del archivo de audio. Formatos compatibles: mp3 y wav. No se puede usar con reference_video_urls. @@ -218,8 +219,7 @@ Resolución: 360-2000 píxeles. Tamaño del archivo: máx. 10MB. - Lista de recursos multimedia. Especifica materiales de referencia (imagen, audio, -video) para la generación de video. Cada elemento contiene un campo type y un campo url. + Lista de recursos multimedia. Especifica materiales de referencia (imagen, audio, video) para la generación de video. Cada elemento contiene un campo type y un campo url. Este campo lo comparten todos los modelos servidos desde este componente, y qué valores de type acepta un modelo dado (y si lleva su entrada de imagen o video aquí en lugar de en img_url o reference_video_urls) varía según el modelo. Valores de type admitidos, por @@ -269,28 +269,25 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de + medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo del socio sobre el recurso que acaba recibiendo, y se aplican tal como +están escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por +Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se +enfrenta a un límite de transporte: el cuerpo de una solicitud POST de Comfy Router tiene +un límite total de 100 MiB y se responde con 413 si se supera, y base64 infla la carga +útil en aproximadamente 4/3, así que un solo recurso en línea de más de aproximadamente +75 MB se rechaza antes de que se aplique cualquiera de las reglas del socio que aparecen +aquí. Con ese tamaño, un solo recurso con el propioEl techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -304,12 +301,12 @@ medios, así que deja este campo sin definir. - Las palabras del prompt inverso se usan para describir contenido que no quieres ver en la trama del video + Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video. Después de 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud que no exceda los 800 caracteres (hasta 20,000 caracteres para wan3.0-video; el contenido que supere el límite se trunca). -Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta al borde de la carretera y Character2 baila a su lado" + Palabras del prompt de texto. Admite chino e inglés. Si supera su propia longitud documentada, un modelo wan2.x trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6, y 5,000 para wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud en la que el prompt y negative_prompt juntos superen aproximadamente 60,850 bytes de texto UTF-8 (unos 20,000 caracteres chinos), respondiendo InvalidParameter `Range of input length should be [1, 61440]`. +Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta al borde de la carretera y Character2 baila a su lado". Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia en el orden correspondiente dentro del array de media. @@ -326,7 +323,7 @@ Facturación: según la duración de referencia real utilizada. - Nombre de la plantilla de efecto de video. Opcional. Actualmente compatible con: squish, flying, carousel. Cuando se usa, se ignora el parámetro prompt. + Nombre de la plantilla de efecto de video. Opcional. Actualmente se admiten: squish, flying, carousel. Cuando lo uses, el parámetro prompt se ignora. @@ -356,20 +353,20 @@ Facturación: según la duración de referencia real utilizada. - wan2.6-r2v: solo 5 o 10 segundos (sin soporte para 15s) - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] -- wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita el modo de duración inteligente, en el que el modelo elige una duración adecuada +- wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Indica si está habilitada la reescritura inteligente del prompt. El valor predeterminado es true + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero. Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. -En los modelos wan2.7, se usa un valor predeterminado según el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +Para modelos wan2.7, toma un valor predeterminado según el nivel de resolución si no se proporciona. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una adecuadarelación de aspecto según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -432,7 +429,7 @@ Generado a partir del esquema que Router publica en `GET /v2/models/wan/happyhor - Código de error de la solicitud fallida (no se devuelve si la solicitud es exitosa) + Código de error de la solicitud fallida (no aparece si la solicitud es exitosa) @@ -440,7 +437,7 @@ Generado a partir del esquema que Router publica en `GET /v2/models/wan/happyhor - Información detallada sobre la solicitud fallida (no se devuelve si la solicitud es exitosa) + Información detallada sobre la solicitud fallida (no aparece si la solicitud es exitosa) @@ -456,11 +453,11 @@ Generado a partir del esquema que Router publica en `GET /v2/models/wan/happyhor - Código de error de la imagen (se devuelve cuando algunas tareas fallan) + Código de error de la imagen (aparece cuando fallan algunas tareas) - Información de error de la imagen (se devuelve cuando algunas tareas fallan) + Información de error de la imagen (aparece cuando fallan algunas tareas) @@ -514,7 +511,7 @@ Generado a partir del esquema que Router publica en `GET /v2/models/wan/happyhor - Estadísticas de información de salida. Solo se cuentan los resultados exitosos + Estadísticas de información de salida. Solo cuentan los resultados exitosos @@ -562,11 +559,11 @@ Generado a partir del esquema que Router publica en `GET /v2/models/wan/happyhor - Código de error de una solicitud fallida, informado en la RAÍZ del envelope en lugar de bajo `output` (no se devuelve si la solicitud fue exitosa). + Código de error de una solicitud fallida, informado en la RAÍZ del envelope en lugar de bajo `output` (no aparece si la solicitud fue exitosa). - Información detallada sobre una solicitud fallida, informada en la RAÍZ del envelope en lugar de bajo `output` (no se devuelve si la solicitud fue exitosa). Lee esto antes de recurrir a `output.message`. + Información detallada sobre una solicitud fallida, informada en la RAÍZ del envelope en lugar de bajo `output` (no aparece si la solicitud fue exitosa). Lee esto antes de recurrir a `output.message`. ## Ejemplos diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index 768dc1748a..ea5c24ec00 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa HappyHorse 1.0 R2V con Comfy Router" description: "Snippets de Python, TypeScript y cURL para llamar a wan/happyhorse-1.0-r2v por HTTP con Comfy Router, más los campos de la solicitud y la forma del resultado" sidebarTitle: "HappyHorse 1.0 R2V" -translationSourceHash: d2eee702 +translationSourceHash: 93ba1a2d translationFrom: development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx translationBlockHashes: "_intro": 39853fc0 "Quick start": eafea158 - "Schema": 5a777640 + "Schema": 3deb0e2f "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -269,28 +270,26 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada + de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. + +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo del socio sobre el recurso con el que termina, y se aplican tal como están +escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. +Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con un +techo de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 MiB en +total y se responde 413 por encima de eso, y base64 infla una carga útil en +aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza +antes de llegar a cualquiera de las reglas del socio descritas aquí. Con ese tamaño, un +solo recurso con el propioCon ese tamaño, un solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -300,20 +299,17 @@ medios, así que deja este campo sin definir. - URL del archivo multimedia: una URL HTTP/HTTPS pública o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo (first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit), una URL inline `data:{MIME_type};base64,...`. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: inline. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que tal valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para conocer los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota en conjunto un payload inline. + URL del archivo multimedia: una URL HTTP/HTTPS pública o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo (first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit), una URL en línea `data:{MIME_type};base64,...`. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que tal valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para conocer los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota en conjunto una carga útil en línea. - Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video. + Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admiten chino e inglés, con una longitud que no supere los 800 caracteres -(hasta 20,000 caracteres en wan3.0-video; el contenido que excede el límite se trunca). -En wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos -en el orden de los videos de referencia. Ejemplo: "Character1 canta junto al camino, Character2 baila a su lado" -En el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia -en el orden correspondiente dentro del arreglo media. + Palabras del prompt de texto. Admiten chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6, y 5,000 para wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos 20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. +En wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta junto al camino, Character2 baila a su lado" +En el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia en el orden correspondiente dentro del arreglo media. @@ -362,17 +358,19 @@ Facturación: según la duración de referencia realmente utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. +Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero - Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. + Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. +Para los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unaRelación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. En los modelos wan2.7, se toma un valor predeterminado según el nivel de resolución si no se proporciona. En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. @@ -385,7 +383,6 @@ relación de aspecto adecuada según las proporciones y la intención de los rec - wan2.5-i2v-preview: 480P, 720P, 1080P - modelos wan2.6 (t2v, i2v, r2v): solo 720P, 1080P (sin soporte de 480P) - modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (1080P predeterminado) - - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (1080P por defecto en el upstream) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index f2ac199649..57a9c8cc54 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -2,14 +2,16 @@ title: "Usa HappyHorse 1.1 I2V con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/happyhorse-1.1-i2v por HTTP con Comfy Router, más los campos de la solicitud y la forma del resultado." sidebarTitle: "HappyHorse 1.1 I2V" -translationSourceHash: ee562b54 +translationSourceHash: 8d29660e translationFrom: development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx translationBlockHashes: "_intro": 2419a89f "Quick start": c705001d - "Schema": 54511f6f + "Schema": bb6bb958 "Examples": 5ffd46d7 --- + + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -275,23 +277,23 @@ medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo del socio sobre el recurso con el que se queda, y se aplican tal como están +escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. +Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y además se topa con un +límite de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 MiB en +total y se responde 413 si se supera, y base64 infla la carga útil alrededor de 4/3, así +que un único recurso en línea de más de unos 75 MB se rechaza antes de llegar a +cualquiera de las reglas del socio que aparecen aquí. Con ese tamaño, un único recurso en +el propio 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; +el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota +TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque +a estos techos. @@ -305,12 +307,15 @@ medios, así que deja este campo sin definir. - Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video + Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video. A partir de los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20 000 caracteres para wan3.0-video; el contenido que supera el límite se trunca). + Palabras del prompt de texto. Admite chino e inglés. Por encima de su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6 y 5,000 para +wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos +20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 sings on the roadside, Character2 dances beside it" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -363,20 +368,19 @@ Facturación: según la duración de referencia real utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 cuando la duración queda fuera de [-1, 30]. +Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Indica si está habilitada la reescritura inteligente del prompt. El valor predeterminado es true + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -En los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. -En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente -una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. +En los modelos wan2.7, si no se proporciona, se toma un valor predeterminado según el nivel de resolución. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unrelación de aspecto según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -384,13 +388,12 @@ una relación de aspecto adecuada según las proporciones y la intención de los Nivel de resolución. Los valores admitidos varían según el modelo: - wan2.5-i2v-preview: 480P, 720P, 1080P -- modelos wan2.6 (t2v, i2v, r2v): solo 720P, 1080P (sin soporte para 480P) -- modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (predeterminado 1080P) +- modelos wan2.6 (t2v, i2v, r2v): solo 720P y 1080P (sin soporte para 480P) +- modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P y 1080P (predeterminado 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P y 1080P (1080P predeterminado del proveedor) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P y 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P y 1080P - -Este proxy rechaza las solicitudes de generación de video que no proporcionen ni resolución ni tamaño, porque el nivel de resolución selecciona la tarifa de facturación. Convierte la resolución a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas; devuelve 400 para un valor fuera de esta enumeración y devuelve 400 para 480P (ya sea enviado como resolución o como un tamaño de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 listados arriba como sin 480P. +Este proxy rechaza las solicitudes de generación de video que no proporcionen ni resolución ni tamaño, porque el nivel de resolución selecciona la tarifa de facturación. Convierte la resolución a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas, devuelve 400 para un valor fuera de esta enumeración y devuelve 400 para 480P (ya sea enviado como resolución o como un tamaño de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 listados arriba como modelos sin 480P. Valores posibles: `480P`, `720P`, `1080P` @@ -398,7 +401,7 @@ Este proxy rechaza las solicitudes de generación de video que no proporcionen n Semilla de número aleatorio, usada para controlar la aleatoriedad del contenido generado por el modelo - Rango: `0` a `2147483647` + Alcance: `0` a `2147483647` @@ -416,7 +419,7 @@ Para wan2.5 T2V: tamaños 480P (480*832, 832*480, 624*624), 720P y 1080P Para wan2.6 T2V/R2V (sin 480P): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -Cuando se envían tanto el tamaño como la resolución, el tamaño selecciona el nivel facturado y la resolución aún debe ser un valor que este proxy acepte para el modelo. Un tamaño de 480P devuelve 400 en todos los modelos que la descripción de la resolución enumera como sin 480P. +Cuando se envían tanto el tamaño como la resolución, el tamaño selecciona el nivel facturado y la resolución aún debe ser un valor que este proxy acepte para el modelo. Un tamaño de 480P devuelve 400 en todos los modelos que la descripción de la resolución enumera como modelos sin 480P. @@ -440,7 +443,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/wan/happyhors - El código de error de la solicitud fallida (no se devuelve si la solicitud se completa correctamente) + Código de error de la solicitud fallida (no se devuelve si la solicitud se completa correctamente) diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx index 359d53ff3e..344f8c827d 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx @@ -2,14 +2,16 @@ title: "Usa HappyHorse 1.1 R2V con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/happyhorse-1.1-r2v por HTTP con Comfy Router, con los campos de la solicitud y la forma del resultado." sidebarTitle: "HappyHorse 1.1 R2V" -translationSourceHash: afb02787 +translationSourceHash: 53cf60f2 translationFrom: development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx translationBlockHashes: "_intro": 320590bd "Quick start": 8eb3cc23 - "Schema": b9d2c334 + "Schema": 57b62b59 "Examples": a91cb6b1 --- + + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -213,10 +215,11 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-r2v/requests/$REQUEST_ID URL de la imagen del primer fotograma o datos codificados en Base64. Requerido para los modelos wan2.5-i2v-preview y wan2.6-i2v. Las variantes i2v de happyhorse-1.x NO reciben aquí su primer fotograma: lo reciben como un recurso multimedia de tipo first_frame -(consulta media más abajo), y un cuerpo img_url que funciona en wan2.6-i2v el proveedor -lo rechaza en happyhorse-1.0-i2v y happyhorse-1.1-i2v; además, las variantes -wan2.7/wan3.0 también reciben sus recursos de referencia en media. Formatos de imagen: -JPEG, JPG, PNG, BMP, WEBP. Resolución: 360-2000 píxeles. Tamaño del archivo: máx 10MB. +(consulta media más abajo), y el proveedor rechaza un cuerpo img_url que funciona en +wan2.6-i2v cuando se usa en happyhorse-1.0-i2v y happyhorse-1.1-i2v; además, las +variantes wan2.7/wan3.0 también reciben sus recursos de referencia en media. Formatos de +imagen: JPEG, JPG, PNG, BMP, WEBP. Resolución: 360-2000 píxeles. Tamaño del archivo: máx +10MB. @@ -229,7 +232,7 @@ modelo: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame y last_frame: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... driving_audio (WAV/MP3, de 2 a 30 segundos, como máximo + data:\{MIME_type};base64,.... driving_audio (WAV/MP3, de 2 a 30 segundos, como máximo 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-r2v: first_frame (opcional, máx. 1), reference_image, reference_video. Se @@ -237,7 +240,7 @@ modelo: referencia y videos de referencia es como máximo 5. first_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... reference_video: una URL pública HTTP/HTTPS; no se acepta + data:\{MIME_type};base64,.... reference_video: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-videoedit: video (exactamente 1, el clip que se edita: MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB, una URL pública HTTP/HTTPS; no @@ -252,17 +255,17 @@ modelo: solicitud. El orden del array define el orden de referencia de los recursos en el prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, - como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... + como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,.... reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - happyhorse-1.0-i2v, happyhorse-1.1-i2v: solo first_frame, exactamente 1. Estas variantes toman su primer fotograma AQUÍ y no en img_url. Al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL - pública o una URL data:\{MIME_type};base64,... + pública o una URL data:\{MIME_type};base64,.... - happyhorse-1.0-r2v, happyhorse-1.1-r2v: solo reference_image, de 1 a 9. Esta es la única entrada de referencia del modelo. El lado más corto debe medir al menos 400 píxeles, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... reference_video no es un tipo de entrada para esta + data:\{MIME_type};base64,.... reference_video no es un tipo de entrada para esta operación. - happyhorse-1.0-video-edit: video (exactamente 1, el clip que se edita: MP4/MOV, de 3 a 60 segundos, lado más largo como máximo 4096 píxeles, lado más corto al menos 360 @@ -272,7 +275,7 @@ modelo: y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. +medios, así que deja este campo sin establecer. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en @@ -282,17 +285,13 @@ medios, así que deja este campo sin definir. implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + termina recibiendo, y se aplican tal cual cuando el recurso es una URL pública, porque + esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa + por Comfy y también se enfrenta a un techo de transporte: el cuerpo de una solicitud + POST de Comfy Router tiene un límite total de 100 MiB y se responde con 413 si se + supera, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso + en línea de más de unos 75 MB se rechaza antes de que se aplique cualquiera de las + reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propioEl techo de 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -302,20 +301,17 @@ medios, así que deja este campo sin definir. - URL del archivo multimedia: una URL HTTP/HTTPS pública o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo (first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit), una URL inline `data:{MIME_type};base64,...`. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: inline. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que tal valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para conocer los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota en conjunto un payload inline. + URL del archivo multimedia: una URL HTTP/HTTPS pública o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo (first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit), una URL `data:{MIME_type};base64,...` en línea. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que tal valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para conocer los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota en conjunto una carga útil en línea. - Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video. + Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que prompt. - Palabras del prompt de texto. Admiten chino e inglés, con una longitud que no supere los 800 caracteres -(hasta 20,000 caracteres en wan3.0-video; el contenido que excede el límite se trunca). -En wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos -en el orden de los videos de referencia. Ejemplo: "Character1 canta junto al camino, Character2 baila a su lado" -En el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia -en el orden correspondiente dentro del arreglo media. + Palabras del prompt de texto. Admiten chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6 y 5,000 para wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos 20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. +Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta junto al camino, Character2 baila a su lado" +Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia en el orden correspondiente dentro del arreglo media. @@ -323,11 +319,11 @@ en el orden correspondiente dentro del arreglo media. Restricciones de entrada: - Formato: mp4, mov - Cantidad: 1-3 videos -- Longitud de cada video: 2-30 segundos +- Duración de cada video: 2-30 segundos - Tamaño de cada archivo: máx 30MB - No se puede usar con audio_url -Duración de referencia: un video máx 5s, dos videos máx 2.5s cada uno, tres videos proporcionalmente menos. -Facturación: según la duración de referencia realmente utilizada. +Duración de referencia: un solo video máx 5s, dos videos máx 2.5s cada uno, tres videos proporcionalmente menos. +Facturación: según la duración de referencia real utilizada. @@ -364,20 +360,19 @@ Facturación: según la duración de referencia realmente utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. +Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero. - Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. -En los modelos wan2.7, se toma un valor predeterminado según el nivel de resolución si no se proporciona. -En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una -relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. + Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. +Para los modelos wan2.7, se usa un valor predeterminado según el nivel de resolución si no se proporciona. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una adecuadarelación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -387,7 +382,6 @@ relación de aspecto adecuada según las proporciones y la intención de los rec - wan2.5-i2v-preview: 480P, 720P, 1080P - modelos wan2.6 (t2v, i2v, r2v): solo 720P, 1080P (sin soporte de 480P) - modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (1080P predeterminado) - - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (1080P por defecto en el upstream) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P @@ -403,7 +397,8 @@ Este proxy rechaza las solicitudes de generación de video que no incluyen ni re - Control inteligente de múltiples lentes. Solo está activo cuando prompt_extend está habilitado. Para los modelos wan2.6 y wan2.7-r2v. + Control inteligente de múltiples lentes. Solo está activo cuando prompt_extend está habilitado. +Para los modelos wan2.6 y wan2.7-r2v. - single: video de toma única (predeterminado) - multi: video de varias tomas @@ -416,7 +411,7 @@ Para wan2.5 T2V: tamaños 480P (480*832, 832*480, 624*624), 720P, 1080P Para wan2.6 T2V/R2V (sin 480P): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -Cuando se envían tanto el tamaño como la resolución, el tamaño determina el nivel que se factura y la resolución debe seguir siendo un valor que este proxy acepte para el modelo. Un tamaño 480P devuelve 400 en todos los modelos que la descripción de la resolución indica como sin 480P. +Cuando se envían tanto el tamaño como la resolución, el tamaño determina el nivel de facturación y la resolución debe seguir siendo un valor que este proxy acepte para el modelo. Un tamaño 480P devuelve 400 en todos los modelos que la descripción de la resolución indica como sin 480P. @@ -456,7 +451,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/happyhorse - Lista de resultados de la tarea para tareas de generación de imágenes + Lista de resultados de las tareas de generación de imágenes @@ -492,7 +487,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/happyhorse - Estadísticas de resultados de la tarea para tareas de generación de imágenes + Estadísticas de resultados de las tareas de generación de imágenes diff --git a/es/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx index f07b3ba864..70293f7cf0 100644 --- a/es/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.5 I2I Preview con Comfy Router" description: "Llama a wan/wan2.5-i2i-preview mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Wan 2.5 I2I Preview" -translationSourceHash: c19a12c9 +translationSourceHash: 11080daf translationFrom: development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx translationBlockHashes: "_intro": d8f59ebb "Quick start": a98c2f62 - "Schema": 8bff936f + "Schema": c4c53620 "Examples": 3d10fc60 --- + {/* ARCHIVO GENERADO. Se genera a partir de router-schemas/wan/wan2.5-i2i-preview.json con `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -178,15 +179,15 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - Arreglo de URLs de imágenes para la generación de imagen a imagen + Arreglo de 1 a 3 URLs de imágenes para la generación de imagen a imagen - Palabras del prompt inverso para describir el contenido que no quieres ver en la imagen + Palabras del prompt inverso para describir el contenido que no quieres ver en la imagen. Cuenta para el mismo límite de entrada que el prompt. - Palabras del prompt positivo para describir los elementos esperados de la imagen y sus características visuales. Admite chino e inglés, con una longitud no mayor a 2000 caracteres + Palabras del prompt positivo para describir los elementos esperados de la imagen y sus características visuales. Admite chino e inglés. Un prompt más largo de lo que lee el modelo se trunca en lugar de rechazarse. El proveedor rechaza una solicitud cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos 20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. diff --git a/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index c88a4613be..b2def20f8d 100644 --- a/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.5 I2V Preview con Comfy Router" description: "Snippets de Python, TypeScript y cURL para llamar a wan/wan2.5-i2v-preview por HTTP con Comfy Router, más los campos de la solicitud y la forma del resultado" sidebarTitle: "Wan 2.5 I2V Preview" -translationSourceHash: 76630e35 +translationSourceHash: cf342bd4 translationFrom: development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx translationBlockHashes: "_intro": 630a0d10 "Quick start": 8713537b - "Schema": 8ddb2e5e + "Schema": 483bc30d "Examples": 2b581e5f --- + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -249,18 +250,25 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada + de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo del socio sobre el recurso con el que se queda, y se aplican tal cual +cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL +data:\{MIME_type};base64,... en línea sí pasa por Comfy y además se topa con un límite +de transporte: el cuerpo de una solicitud POST de Comfy Router tiene un tope de 100 MiB +en total y se responde 413 por encima de eso, y base64 infla la carga útil alrededor de +4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar a +cualquiera de las reglas del socio que se describen aquí. Con ese tamaño, un solo +recurso en el propio acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima @@ -284,12 +292,15 @@ medios, así que deja este campo sin definir. - Las palabras del prompt negativo se usan para describir el contenido que no quieres ver en la trama del video + Las palabras del prompt negativo se usan para describir el contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que supera el límite se trunca). + Palabras del prompt de texto. Admite chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6, y 5,000 para +wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos +20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta junto a la carretera y Character2 baila a su lado" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -340,22 +351,21 @@ Facturación: se basa en la duración de referencia real utilizada. - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total - del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita + del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 para una duración fuera de [-1, 30]. +Este proxy devuelve 400 si la duración está fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Indica si está habilitada la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si está habilitada la reescritura inteligente del prompt. El valor predeterminado es true Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -En los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. -En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una -relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +Para los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto adecuada según las proporciones y la intención del contenido multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -363,7 +373,7 @@ relación de aspecto adecuada según las proporciones y la intención de los rec Nivel de resolución. Los valores admitidos varían según el modelo: - wan2.5-i2v-preview: 480P, 720P, 1080P -- modelos wan2.6 (t2v, i2v, r2v): solo 720P y 1080P (no admiten 480P) +- modelos wan2.6 (t2v, i2v, r2v): solo 720P y 1080P (sin soporte para 480P) - modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (predeterminado 1080P) - wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (el valor predeterminado del proveedor es 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P @@ -376,7 +386,7 @@ Este proxy rechaza las solicitudes de generación de video que no incluyan ni re Semilla de número aleatorio, se usa para controlar la aleatoriedad del contenido generado por el modelo - Rango: `0` a `2147483647` + Alcance: `0` a `2147483647` @@ -412,7 +422,7 @@ Generado a partir del esquema que el router sirve en `GET /v2/models/wan/wan2.5- - prompt real después de la reescritura inteligente (para tareas de video) + Prompt real después de la reescritura inteligente (para tareas de video) @@ -432,7 +442,7 @@ Generado a partir del esquema que el router sirve en `GET /v2/models/wan/wan2.5- - prompt de entrada original (para tareas de video) + Prompt de entrada original (para tareas de video) @@ -440,7 +450,7 @@ Generado a partir del esquema que el router sirve en `GET /v2/models/wan/wan2.5- - prompt real después de la reescritura inteligente (si está habilitada) + Prompt real después de la reescritura inteligente (si está habilitada) @@ -452,7 +462,7 @@ Generado a partir del esquema que el router sirve en `GET /v2/models/wan/wan2.5- - prompt de entrada original + Prompt de entrada original diff --git a/es/development/comfy-router/models/wan/wan2-6-t2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-t2v/code.mdx index c939ef4261..fc0cf9a10d 100644 --- a/es/development/comfy-router/models/wan/wan2-6-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-t2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.6 T2V con Comfy Router" description: "Ejemplos en Python, TypeScript y cURL para llamar a wan/wan2.6-t2v por HTTP con Comfy Router, más los campos de la solicitud y la forma del resultado." sidebarTitle: "Wan 2.6 T2V" -translationSourceHash: af081f28 +translationSourceHash: 00873331 translationFrom: development/comfy-router/models/wan/wan2-6-t2v/code.mdx translationBlockHashes: "_intro": 93b4f6f5 "Quick start": b919757c - "Schema": dd8ddc51 + "Schema": 35961ffb "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -247,28 +248,27 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de + medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites difieren +según el modelo. Que el esquema acepte un valor no implica que el proveedor lo acepte; y, +en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el techo de +las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el techo del +socio sobre el recurso con el que se queda, y se aplican tal cual cuando el recurso es una +URL pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... +en línea sí pasa por Comfy y también se enfrenta a un techo de transporte: el cuerpo de un +POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima de eso, +y base64 infla una carga útil en aproximadamente 4/3, así que un único recurso en línea de +más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio descritas +aquí. Con ese tamaño, un único recurso con el propioEl techo de 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es +la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de +100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública +cualquier cosa que se acerque a estos techos. @@ -278,16 +278,19 @@ medios, así que deja este campo sin definir. - URL del archivo multimedia: una URL HTTP/HTTPS pública o, para exactamente las entradas IMAGE que la descripción de `media` anterior enumera para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit, una URL `data:{MIME_type};base64,...` en línea. Ninguna entrada de tipo video, audio, file o link de ninguno de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que realizó la carga; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, por lo que una URL oss:// o un asset_id que pertenezcan a quien llama no son una entrada compatible. Este campo no valida el esquema de la URL, así que el proxy reenvía ese valor al socio tal cual en lugar de rechazarlo aquí. Consulta la descripción de `media` para ver los límites de tamaño y píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que limita en conjunto una carga útil en línea. + URL del archivo multimedia: una URL HTTP/HTTPS pública o, para exactamente las entradas IMAGE que la descripción de `media` anterior enumera para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit, una URL `data:{MIME_type};base64,...` en línea. Ninguna entrada de tipo video, audio, file o link de ninguno de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que realizó la carga; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, por lo que una URL oss:// o un asset_id que pertenezcan a quien llama no son una entrada compatible. Este campo no valida el esquema de la URL, así que se envía ese valor al socio tal cual en lugar de rechazarlo aquí. Consulta la descripción de `media` para ver los límites de tamaño y píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que limita en conjunto una carga útil en línea. - Las palabras de prompt inverso describen el contenido que no quieres ver en la trama del video + Las palabras de prompt inverso se usan para describir el contenido que no quieres ver en la trama del video. A partir de 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras de prompt de texto. Admiten chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que supere el límite se trunca). + Palabras de prompt de texto. Admite chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6 y 5,000 para +wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos +20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta junto al camino, Character2 baila a su lado" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -337,23 +340,22 @@ Facturación: según la duración de referencia real utilizada. - wan2.6-r2v: solo 5 o 10 segundos (sin soporte para 15 s) - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] -- wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total - del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita +- wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración + total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 cuando la duración está fuera de [-1, 30]. +Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si se activa la reescritura inteligente del prompt. El valor predeterminado es true Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -En los modelos wan2.7, el valor predeterminado se basa en el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una -relación de aspecto adecuada según las proporciones y la intención del recurso multimedia de entrada. +En los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. +En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto adecuada según las proporciones y la intención del recurso multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -378,7 +380,8 @@ Este proxy rechaza las solicitudes de generación de video que no incluyan ni re - Control inteligente de múltiples lentes. Solo se activa cuando prompt_extend está habilitado. Para los modelos wan2.6 y wan2.7-r2v. + Control inteligente de múltiples lentes. Solo se activa cuando prompt_extend está habilitado. +Para los modelos wan2.6 y wan2.7-r2v. - single: video de una sola toma (predeterminado) - multi: video de múltiples tomas diff --git a/es/development/comfy-router/models/wan/wan2-7-t2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-t2v/code.mdx index 1299948a7a..bfc50ff578 100644 --- a/es/development/comfy-router/models/wan/wan2-7-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-t2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.7 T2V con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/wan2.7-t2v por HTTP con Comfy Router, además de los campos de la solicitud y la forma del resultado" sidebarTitle: "Wan 2.7 T2V" -translationSourceHash: ff10f4b6 +translationSourceHash: 700c3a5c translationFrom: development/comfy-router/models/wan/wan2-7-t2v/code.mdx translationBlockHashes: "_intro": 89db521b "Quick start": d9034773 - "Schema": 6e6cd92f + "Schema": ffbd0afd "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -205,7 +206,7 @@ modelo: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame y last_frame: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... driving_audio (WAV/MP3, de 2 a 30 segundos, como máximo + data:\{MIME_type};base64,..., driving_audio (WAV/MP3, de 2 a 30 segundos, como máximo 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-r2v: first_frame (opcional, máx. 1), reference_image, reference_video. Se @@ -213,7 +214,7 @@ modelo: referencia y videos de referencia es como máximo 5. first_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... reference_video: una URL pública HTTP/HTTPS; no se acepta + data:\{MIME_type};base64,..., reference_video: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-videoedit: video (exactamente 1, el clip que se edita: MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB, una URL pública HTTP/HTTPS; no @@ -228,7 +229,7 @@ modelo: solicitud. El orden del array define el orden de referencia de los recursos en el prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, - como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... + como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - happyhorse-1.0-i2v, happyhorse-1.1-i2v: solo first_frame, exactamente 1. Estas @@ -252,23 +253,19 @@ medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites difieren +según el modelo. Que el esquema acepte un valor no implica que el proveedor lo acepte; y, +en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el techo +de las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el techo +del socio sobre el recurso que este acaba recibiendo, y se aplican tal cual cuando el +recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL +data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se enfrenta a un techo +de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 MiB en total y se +responde 413 por encima de eso, y base64 infla la carga útil alrededor de 4/3, así que un +único recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de +las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso con el propioEl techo de 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -278,16 +275,19 @@ medios, así que deja este campo sin definir. - URL del archivo multimedia: una URL HTTP/HTTPS pública o una URL inline `data:{MIME_type};base64,...` únicamente para las entradas IMAGE que la descripción de `media` de arriba enumera para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit. Ninguna entrada de video, audio, archivo o enlace de ninguno de estos modelos acepta una URL data: inline. Una URL temporal `oss://dashscope-instant` del propio servicio de carga del socio, o (en wan2.7-videoedit) un `asset_id` de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy hace la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que la URL `oss://` o el `asset_id` propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para ver los límites de tamaño y píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota la carga inline en conjunto. + URL del archivo multimedia: una URL HTTP/HTTPS pública o, únicamente para las entradas IMAGE que la descripción de `media` de arriba enumera para cada modelo, una URL en línea `data:{MIME_type};base64,...`: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit. Ninguna entrada de video, audio, archivo o enlace de ninguno de estos modelos acepta una URL data: en línea. Una URL temporal `oss://dashscope-instant` del propio servicio de carga del socio, o (en wan2.7-videoedit) un `asset_id` de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy hace la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que la URL `oss://` o el `asset_id` propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para ver los límites de tamaño y píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota la carga en línea en conjunto. - Las palabras del prompt inverso se usan para describir el contenido que no quieres ver en la trama del video + Las palabras del prompt inverso se usan para describir el contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud que no supere los 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que excede el límite se trunca). + Palabras del prompt de texto. Admite chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6 y 5,000 para +wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos +20,000 caracteres chinos), respondiendo InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 sings on the roadside, Character2 dances beside it" Para el modo reference de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -338,7 +338,7 @@ Facturación: según la duración de referencia real utilizada. - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total - del video de entrada más la duración del video de salida no debe superar los 30 segundos; -1 activa + del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. @@ -346,14 +346,13 @@ Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. - Si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si está habilitada la reescritura inteligente del prompt. El valor predeterminado es true - Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. + Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. En los modelos wan2.7, si no se proporciona, se toma un valor predeterminado según el nivel de resolución. -En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto -adecuada según las proporciones de los recursos de entrada y la intención. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unla relación de aspecto adecuada según las proporciones y la intención de los medios de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -367,13 +366,13 @@ adecuada según las proporciones de los recursos de entrada y la intención. - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -Este proxy rechaza las solicitudes de generación de video que no incluyan ni resolution ni size, porque el nivel de resolución determina la tarifa de facturación. Convierte resolution a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas, devuelve 400 cuando el valor está fuera de esta enumeración y devuelve 400 para 480P (ya se envíe como resolution o como un size de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 indicados arriba como modelos sin 480P. +Este proxy rechaza las solicitudes de generación de video que no incluyan ni resolution ni size, porque el nivel de resolución determina la tarifa de facturación. Convierte resolution a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas, devuelve 400 para un valor fuera de esta enumeración y devuelve 400 para 480P (ya se envíe como resolution o como un size de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 indicados arriba como modelos sin 480P. Valores posibles: `480P`, `720P`, `1080P` - Semilla de número aleatorio que controla la aleatoriedad del contenido generado por el modelo + Semilla de número aleatorio, usada para controlar la aleatoriedad del contenido generado por el modelo Rango: `0` a `2147483647` @@ -416,7 +415,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/wan/wan2.7- - El código de error de la solicitud fallida (no se devuelve si la solicitud tiene éxito) + Código de error de la solicitud fallida (no se devuelve si la solicitud tiene éxito) diff --git a/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx b/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx index 97f547868a..adb42c9642 100644 --- a/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.7 Video Edit con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/wan2.7-videoedit por HTTP con Comfy Router, más los campos de la solicitud y la forma del resultado" sidebarTitle: "Wan 2.7 Video Edit" -translationSourceHash: 11c6064b +translationSourceHash: b970d117 translationFrom: development/comfy-router/models/wan/wan2-7-videoedit/code.mdx translationBlockHashes: "_intro": 164c9f6a "Quick start": ec8ca64c - "Schema": b7895256 + "Schema": cff0bda0 "Examples": 622d1416 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -263,28 +264,25 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada + de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo del socio sobre el recurso que finalmente recibe, y se aplican tal cual +cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL +data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se enfrenta a un techo +de transporte: el cuerpo de un POST de Comfy Router tiene un límite total de 100 MiB y +se responde 413 si lo supera, y base64 infla una carga útil en aproximadamente 4/3, así +que un único recurso en línea de más de unos 75 MB se rechaza antes de llegar a +cualquiera de las reglas del socio que aparecen aquí. Con ese tamaño, un único recurso +con el propio techo del socio Un recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -294,24 +292,21 @@ medios, así que deja este campo sin definir. - URL del archivo multimedia: una URL HTTP/HTTPS pública o, para exactamente las entradas IMAGE que la descripción de `media` anterior enumera para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit, una URL `data:{MIME_type};base64,...` en línea. Ninguna entrada de video, audio, archivo o enlace de ninguno de estos modelos acepta una URL data: en línea. Una URL temporal `oss://dashscope-instant` del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que lo subió; Comfy hace la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL `oss://` o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, por lo que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para los límites de tamaño y píxeles por modelo y para el tope de 100 MiB del cuerpo de la solicitud del Router que acota una carga en línea en conjunto. + URL del archivo multimedia: una URL HTTP/HTTPS pública o, para exactamente las entradas IMAGE que la descripción de `media` anterior enumera para cada modelo (first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit), una URL `data:{MIME_type};base64,...` en línea. Ninguna entrada de video, audio, archivo o enlace de ninguno de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, por lo que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para los límites de tamaño y píxeles por modelo y para el tope de 100 MiB del cuerpo de la solicitud del Router que acota en conjunto una carga útil en línea. - Las palabras del prompt inverso se usan para describir el contenido que no quieres ver en la trama del video + Las palabras del prompt inverso se usan para describir el contenido que no quieres ver en la trama del video. Si supera los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20 000 caracteres para wan3.0-video; el contenido que supera el límite se trunca). -Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos -en el orden de los videos de referencia. Ejemplo: "Character1 canta en la orilla de la carretera, Character2 baila a su lado" -Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia -en el orden correspondiente dentro del arreglo media. + Palabras del prompt de texto. Admite chino e inglés. Si supera su propia longitud documentada, un modelo wan2.x trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6, y 5,000 para wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud cuyo prompt y negative_prompt juntos superen aproximadamente 60,850 bytes de texto UTF-8 (unos 20,000 caracteres chinos), respondiendo InvalidParameter `Range of input length should be [1, 61440]`. +Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta en la orilla de la carretera, Character2 baila a su lado" +Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia en el orden correspondiente dentro del arreglo media. - URL de video de referencia solo para el modelo wan2.6-r2v. Arreglo de 1 a 3 URL de video. + URLs de video de referencia solo para el modelo wan2.6-r2v. Arreglo de 1 a 3 URL de video. Restricciones de entrada: - Formato: mp4, mov - Cantidad: 1 a 3 videos @@ -353,12 +348,10 @@ Facturación: según la duración de referencia real utilizada. - wan2.6-r2v: solo 5 o 10 segundos (sin soporte para 15s) - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] -- wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total - del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa - el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 si la duración está fuera de [-1, 30]. +- wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total de entrada de video + la duración del video de salida no debe superar los 30 segundos; -1 habilita el modo de duración inteligente, en el que el modelo elige una duración adecuada +Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Rango: de `-1` a `30` + Alcance: `-1` a `30` @@ -367,9 +360,8 @@ Este proxy devuelve 400 si la duración está fuera de [-1, 30]. Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. -En los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una -relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +Para los modelos wan2.7, se establece de forma predeterminada según el nivel de resolución si no se proporciona. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuadarelación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -385,8 +377,8 @@ relación de aspecto adecuada según las proporciones y la intención de los rec Este proxy rechaza las solicitudes de generación de video que no incluyan ni resolution ni size, porque el nivel de resolución determina la tarifa de facturación. Convierte -resolution a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas, devuelve 400 -para un valor fuera de esta enumeración, y devuelve 400 para 480P (ya se envíe como +resolution a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas; devuelve 400 +para un valor fuera de esta enumeración y devuelve 400 para 480P (ya se envíe como resolution o como un size de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 enumerados arriba como modelos sin 480P. @@ -432,7 +424,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/wan/wan2.7- - prompt real después de la reescritura inteligente (para tareas de video) + Prompt real después de la reescritura inteligente (para tareas de video) @@ -452,7 +444,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/wan/wan2.7- - prompt de entrada original (para tareas de video) + Prompt de entrada original (para tareas de video) @@ -460,7 +452,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/wan/wan2.7- - prompt real después de la reescritura inteligente (si está habilitada) + Prompt real después de la reescritura inteligente (si está habilitada) @@ -472,7 +464,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/wan/wan2.7- - prompt de entrada original + Prompt de entrada original diff --git a/es/development/comfy-router/models/wan/wan3-0-video/code.mdx b/es/development/comfy-router/models/wan/wan3-0-video/code.mdx index 4c50a0de0a..9385433bd2 100644 --- a/es/development/comfy-router/models/wan/wan3-0-video/code.mdx +++ b/es/development/comfy-router/models/wan/wan3-0-video/code.mdx @@ -2,15 +2,16 @@ title: "Usa Wan 3.0 Video con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/wan3.0-video por HTTP con Comfy Router, además de los campos de solicitud y la forma del resultado" sidebarTitle: "Wan 3.0 Video" -translationSourceHash: 75a2a69d +translationSourceHash: b17ea6e7 translationFrom: development/comfy-router/models/wan/wan3-0-video/code.mdx translationBlockHashes: "_intro": 352f7edf "Quick start": a6cbe623 "Serving providers": 1e291df8 - "Schema": 133669ca + "Schema": 44f84073 "Examples": 5ffd46d7 --- + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -273,18 +274,25 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada + de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL + reference_video_urls. +Los recuentos por modelo indicados arriba son restricciones del socio, no de este +esquema: no se declara minItems/maxItems en media, porque los tipos admisibles y sus +límites difieren según el modelo. Que el esquema acepte un valor no implica que el +proveedor lo acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por +recurso anteriores (el techo de las entradas de imagen, las únicas entradas que pueden +enviarse en línea) son el techo del socio sobre el recurso con el que termina, y se +aplican tal cual cuando el recurso es una URL pública, porque esos bytes nunca pasan por +Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa +con un límite de transporte: el cuerpo de una solicitud POST de Comfy Router está +limitado a 100 MiB en total y se responde con 413 si se supera, y base64 infla una carga +útil en aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se +rechaza antes de llegar a cualquiera de las reglas del socio descritas aquí. Con ese +tamaño, un único recurso en el propioacaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima @@ -304,20 +312,17 @@ medios, así que deja este campo sin definir. - URL del archivo multimedia: una URL pública HTTP/HTTPS o, exactamente para las entradas de IMAGEN que la descripción de `media` anterior indica para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit, una URL `data:{MIME_type};base64,...` en línea. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo funciona con la cuenta de Alibaba Cloud que la subió; Comfy hace la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, por lo que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para conocer los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota un payload en línea en conjunto. + URL del archivo multimedia: una URL pública HTTP/HTTPS o, exactamente para las entradas de IMAGEN que la descripción de `media` anterior indica para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit, una URL `data:{MIME_type};base64,...` en línea. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo funciona con la cuenta de Alibaba Cloud que la subió; Comfy hace la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, por lo que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para conocer los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota una carga útil en línea en conjunto. - Las palabras del prompt inverso se usan para describir contenido que no quieres ver en la trama del video + Las palabras del prompt inverso se usan para describir contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres en wan3.0-video; el contenido que supere el límite se trunca). -Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos -en el orden de los videos de referencia. Ejemplo: "Character1 sings on the roadside, Character2 dances beside it" -Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia -en el orden correspondiente dentro del arreglo media. + Palabras del prompt de texto. Admite chino e inglés. wan3.0-video y wan3.0-video-prime aceptan como máximo +20,000 caracteres. Usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia en el +orden correspondiente dentro del arreglo media. @@ -337,7 +342,7 @@ Facturación: según la duración de referencia real utilizada. - El ID del modelo que se va a llamar. NO está restringido en este componente: Comfy Router lo rellena desde el segmento de ruta `{model}` de `POST /v2/models/wan/{model}`, así que quien llama al Router lo omite. Una llamada directa a la v1 de `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` DEBE proporcionarlo, y la lista de valores aceptados vive en el componente propio de esa operación, `WanVideoGenerationRequest`. + El ID del modelo que se va a llamar. NO está restringido en este componente: Comfy Router lo rellena desde el segmento de ruta `{model}` de `POST /v2/models/wan/{model}`, así que quien llama al Router lo omite. @@ -366,20 +371,20 @@ Facturación: según la duración de referencia real utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. +Este proxy devuelve 400 si la duración está fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si se activa la reescritura inteligente del prompt. El valor predeterminado es verdadero Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -En los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. -En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación -de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +En los modelos wan2.7, si no se indica, se toma un valor predeterminado según el nivel de resolución. +En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto +adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -389,15 +394,14 @@ de aspecto adecuada según las proporciones y la intención de los recursos mult - wan2.5-i2v-preview: 480P, 720P, 1080P - modelos wan2.6 (t2v, i2v, r2v): solo 720P, 1080P (sin soporte de 480P) - modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (predeterminado 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (valor predeterminado del origen 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (predeterminado del proveedor 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P -Este proxy rechaza las solicitudes de generación de video que no incluyan ni resolución -ni tamaño, porque el nivel de resolución selecciona la tarifa de facturación. Convierte -la resolución a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas; devuelve 400 -para un valor fuera de esta enumeración y devuelve 400 para 480P (ya sea enviado como +Este proxy rechaza las solicitudes de generación de video que no indican ni resolución +ni tamaño, porque el nivel de resolución determina la tarifa de facturación. Convierte +la resolución a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas; devuelve 400para un valor fuera de esta enumeración y devuelve 400 para 480P (ya sea enviado como resolución o como un tamaño 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 -enumerados arriba como sin 480P. +que se enumeran arriba como modelos sin 480P. Valores posibles: `480P`, `720P`, `1080P` @@ -425,7 +429,7 @@ Para wan2.6 T2V/R2V (sin 480P): 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 Cuando se envían tanto el tamaño como la resolución, el tamaño selecciona el nivel facturado y la resolución aún debe ser un valor que este proxy acepte para el modelo. Un tamaño 480P -devuelve 400 en todos los modelos que la descripción de la resolución enumera como sin 480P. +devuelve 400 en todos los modelos que la descripción de la resolución enumera como modelos sin 480P. @@ -465,7 +469,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/wan/wan3.0-vi - Lista de resultados de la tarea para tareas de generación de imágenes + Lista de resultados de las tareas de generación de imágenes @@ -501,7 +505,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/wan/wan3.0-vi - Estadísticas de resultados de la tarea para tareas de generación de imágenes + Estadísticas de los resultados de tareas de generación de imágenes From 4b05a0ceb2509410f643872f26f55696cd0c08c0 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:16:58 +0800 Subject: [PATCH 09/36] i18n(es): sync router model pages with upstream/main (2026-11-10) --- .../models/wan/happyhorse-1-0-t2v/code.mdx | 128 +++++------------- .../wan/happyhorse-1-0-video-edit/code.mdx | 90 ++++++------ .../models/wan/happyhorse-1-1-t2v/code.mdx | 77 ++++++----- .../models/wan/wan2-5-t2i-preview/code.mdx | 19 +-- .../models/wan/wan2-5-t2v-preview/code.mdx | 62 ++++----- .../models/wan/wan2-6-i2v/code.mdx | 115 +++++----------- .../models/wan/wan2-6-r2v/code.mdx | 87 ++++++------ .../models/wan/wan2-7-i2v/code.mdx | 67 +++++---- .../models/wan/wan2-7-r2v/code.mdx | 61 +++++---- .../models/wan/wan3-0-video-prime/code.mdx | 93 +++++++------ 10 files changed, 367 insertions(+), 432 deletions(-) diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index f295603692..c8b4ac346f 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa HappyHorse 1.0 T2V con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/happyhorse-1.0-t2v por HTTP con Comfy Router, con los campos y la forma del resultado" sidebarTitle: "HappyHorse 1.0 T2V" -translationSourceHash: f4e2958a +translationSourceHash: a87b2e81 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx translationBlockHashes: "_intro": b98773c2 "Quick start": b4282abb - "Schema": 83267e64 + "Schema": e48d60d6 "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -182,93 +183,32 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID - URL de descarga del archivo de audio. Formatos compatibles: mp3 y wav. No se puede combinar con reference_video_urls. + URL de descarga del archivo de audio. Formatos compatibles: mp3 y wav. No se puede usar con reference_video_urls. - URL de la imagen del primer fotograma o datos codificados en Base64. Requerido para los modelos wan2.5-i2v-preview y -wan2.6-i2v. Las variantes i2v de happyhorse-1.x NO reciben aquí su primer fotograma: -lo reciben como un recurso multimedia de tipo first_frame (ver media más abajo). Un -cuerpo img_url que funciona en wan2.6-i2v es rechazado por el proveedor en -happyhorse-1.0-i2v y happyhorse-1.1-i2v. Y las variantes wan2.7/wan3.0 también reciben sus -recursos de referencia en media. Formatos de imagen: JPEG, JPG, PNG, BMP, WEBP. -Resolución: 360-2000 píxeles. Tamaño del archivo: máx. 10MB. + URL de la imagen del primer fotograma o datos codificados en Base64. Requerido para los modelos wan2.5-i2v-preview y wan2.6-i2v. Las variantes i2v de happyhorse-1.x NO reciben aquí su primer fotograma: lo reciben como un recurso multimedia de tipo first_frame (ver media más abajo). Además, un cuerpo img_url que funciona en wan2.6-i2v es rechazado por el proveedor en happyhorse-1.0-i2v y happyhorse-1.1-i2v, y las variantes wan2.7/wan3.0 también reciben sus recursos de referencia en media. Formatos de imagen: JPEG, JPG, PNG, BMP, WEBP. Resolución: 360-2000 píxeles. Tamaño del archivo: máx. 10MB. - Lista de recursos multimedia. Especifica materiales de referencia (imagen, audio, -video) para la generación de video. Cada elemento contiene un campo type y un campo url. -Este campo lo comparten todos los modelos servidos desde este componente, y qué valores -de type acepta un modelo dado (y si lleva su entrada de imagen o video aquí en lugar de -en img_url o reference_video_urls) varía según el modelo. Valores de type admitidos, por -modelo: -- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame y - last_frame: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto - entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... driving_audio (WAV/MP3, de 2 a 30 segundos, como máximo - 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como - máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. -- wan2.7-r2v: first_frame (opcional, máx. 1), reference_image, reference_video. Se - requiere al menos un reference_image o un reference_video, y la suma de imágenes de - referencia y videos de referencia es como máximo 5. first_frame y reference_image: - JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, relación de aspecto - entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... reference_video: una URL pública HTTP/HTTPS; no se acepta - una URL data: en línea. -- wan2.7-videoedit: video (exactamente 1, el clip que se edita: MP4/MOV, de 2 a 10 - segundos, 240-4096 píxeles por lado, como máximo 100MB, una URL pública HTTP/HTTPS; no - se acepta una URL data: en línea) más un reference_image opcional, de 0 a 4 - (JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y - 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). -- wan3.0-video, wan3.0-video-prime: first_frame (máx. 1), last_frame (máx. 1), - reference_image (máx. 10), reference_video (máx. 5 clips, duración total \<= 15s), - reference_audio (máx. 5 clips, duración total \<= 15s), file (máx. 1, no se puede usar - con link), link (máx. 1, no se puede usar con file). Los tipos reference_*/file/link y - los tipos first_frame/last_frame son mutuamente excluyentes dentro de una misma - solicitud. El orden del array define el orden de referencia de los recursos en el - prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: - JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, - como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... - reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se - acepta una URL data: en línea. -- happyhorse-1.0-i2v, happyhorse-1.1-i2v: solo first_frame, exactamente 1. Estas - variantes toman su primer fotograma AQUÍ y no en img_url. Al menos 300x300 píxeles, - relación de aspecto entre 1:2.5 y 2.5:1, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL - pública o una URL data:\{MIME_type};base64,... -- happyhorse-1.0-r2v, happyhorse-1.1-r2v: solo reference_image, de 1 a 9. Esta es la - única entrada de referencia del modelo. El lado más corto debe medir al menos 400 - píxeles, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... reference_video no es un tipo de entrada para esta - operación. -- happyhorse-1.0-video-edit: video (exactamente 1, el clip que se edita: MP4/MOV, de 3 a - 60 segundos, lado más largo como máximo 4096 píxeles, lado más corto al menos 360 - píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 100MB, una URL pública - HTTP/HTTPS; no se acepta una URL data: en línea) más un reference_image opcional, de 0 - a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 - y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). -- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. -- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún - vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su - primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + Lista de recursos multimedia. Especifica materiales de referencia (imagen, audio, video) para la generación de video. Cada elemento contiene un campo type y un campo url. Este campo lo comparten todos los modelos servidos desde este componente, y qué valores de type acepta un modelo dado (y si lleva su entrada de imagen o video aquí en lugar de en img_url o reference_video_urls) varía según el modelo. Valores de type admitidos, por modelo: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame y last_frame: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; driving_audio (WAV/MP3, de 2 a 30 segundos, como máximo 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. +- wan2.7-r2v: first_frame (opcional, máx. 1), reference_image, reference_video. Se requiere al menos un reference_image o un reference_video, y el total de imágenes de referencia y videos de referencia es como máximo 5. first_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; reference_video: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. +- wan2.7-videoedit: video (exactamente 1, el clip que se edita: MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB, una URL pública HTTP/HTTPS; no se acepta una URL data: en línea) más un reference_image opcional, de 0 a 4 (JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). +- wan3.0-video, wan3.0-video-prime: first_frame (máx. 1), last_frame (máx. 1), reference_image (máx. 10), reference_video (máx. 5 clips, duración total \<= 15s), reference_audio (máx. 5 clips, duración total \<= 15s), file (máx. 1, no se puede usar con link), link (máx. 1, no se puede usar con file). Los tipos reference_*/file/link y los tipos first_frame/last_frame son mutuamente excluyentes dentro de una misma solicitud. El orden del array define el orden de referencia de los recursos en el prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: solo first_frame, exactamente 1. Estas variantes toman su primer fotograma AQUÍ y no en img_url. Al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: solo reference_image, de 1 a 9. Esta es la única entrada de referencia del modelo. El lado más corto debe medir al menos 400 píxeles, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; reference_video no es un tipo de entrada para esta operación. +- happyhorse-1.0-video-edit: video (exactamente 1, el clip que se edita: MP4/MOV, de 3 a 60 segundos, lado más largo como máximo 4096 píxeles, lado más corto al menos 360 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 100MB, una URL pública HTTP/HTTPS; no se acepta una URL data: en línea) más un reference_image opcional, de 0 a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). +- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de medios, así que deja este campo sin definir. +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en reference_video_urls. + +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no se declara minItems/maxItems en media, porque los tipos admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el límite máximo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el límite máximo del socio para el recurso que finalmente recibe, y se aplican tal como están escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se enfrenta a un límite de transporte: el cuerpo de un POST de Comfy Router tiene un tope de 100 MiB en total y se responde con 413 si se supera, y base64 infla la carga útil en aproximadamente 4/3, así que un solo recurso en línea de más de aproximadamente 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio del socio + + +20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; +el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota +TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos +techos. @@ -282,12 +222,15 @@ medios, así que deja este campo sin definir. - Las palabras de prompt inverso se usan para describir contenido que no quieres ver en la trama del video + Las palabras de prompt inverso se usan para describir contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que prompt. - Palabras de prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20 000 caracteres para wan3.0-video; el contenido que supera el límite se trunca). + Palabras de prompt de texto. Admite chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1500 caracteres para wan2.5 y wan2.6, y 5000 para +wan2.7. wan3.0-video y wan3.0-video-prime admiten como máximo 20 000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60 850 bytes de texto UTF-8 (unos +20 000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 sings on the roadside, Character2 dances beside it" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -346,14 +289,13 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si está habilitada la reescritura inteligente del prompt. El valor predeterminado es verdadero Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -Para los modelos wan2.7, se usa un valor predeterminado según el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación -de aspecto adecuada según las proporciones y la intención de los recursos de entrada. +En los modelos wan2.7, si no se proporciona, se toma un valor predeterminado según el nivel de resolución. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -363,7 +305,7 @@ de aspecto adecuada según las proporciones y la intención de los recursos de e - wan2.5-i2v-preview: 480P, 720P, 1080P - modelos wan2.6 (t2v, i2v, r2v): solo 720P, 1080P (sin soporte para 480P) - modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (1080P predeterminado) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (valor predeterminado ascendente 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (el servicio ascendente usa 1080P de forma predeterminada) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P Este proxy rechaza las solicitudes de generación de video que no incluyen ni resolution ni size, porque el nivel de resolución determina la tarifa de facturación. Convierte resolution a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas, devuelve 400 cuando el valor queda fuera de esta enumeración y devuelve 400 para 480P (ya se envíe como resolution o como un size de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 indicados arriba como modelos sin 480P. @@ -432,7 +374,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/happyhorse - Lista de resultados de la tarea para tareas de generación de imágenes + Lista de resultados de las tareas de generación de imágenes @@ -468,7 +410,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/happyhorse - Estadísticas de resultados de la tarea para tareas de generación de imágenes + Estadísticas de resultados de las tareas de generación de imágenes diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index cf6e426766..6bf9c07970 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -2,14 +2,15 @@ title: "Usa HappyHorse 1.0 Video Edit con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/happyhorse-1.0-video-edit con Comfy Router, además de campos de solicitud y forma del resultado" sidebarTitle: "HappyHorse 1.0 Video Edit" -translationSourceHash: 138e4d49 +translationSourceHash: b9922c80 translationFrom: development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx translationBlockHashes: "_intro": 3a4cf59c "Quick start": 140976d2 - "Schema": bd0494a3 + "Schema": a762284e "Examples": a41df668 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -210,7 +211,7 @@ modelos wan2.5-i2v-preview y wan2.6-i2v. Las variantes i2v de happyhorse-1.x NO primer fotograma aquí: lo toman como un recurso multimedia de tipo first_frame (consulta media más abajo), y un cuerpo con img_url que funciona en wan2.6-i2v es rechazado por el proveedor en happyhorse-1.0-i2v y happyhorse-1.1-i2v; además, las variantes wan2.7/wan3.0 -toman también sus recursos de referencia en media. Formatos de imagen: JPEG, JPG, PNG, BMP, +también toman sus recursos de referencia en media. Formatos de imagen: JPEG, JPG, PNG, BMP, WEBP. Resolución: 360-2000 píxeles. Tamaño del archivo: máx. 10MB. @@ -218,9 +219,9 @@ WEBP. Resolución: 360-2000 píxeles. Tamaño del archivo: máx. 10MB. Lista de recursos multimedia. Especifica materiales de referencia (imagen, audio, video) para la generación de video. Cada elemento contiene un campo type y un campo url. Este campo lo comparten todos los modelos servidos desde este componente, y qué valores -de type acepta un modelo dado (y si lleva su entrada de imagen o video aquí en lugar de -en img_url o reference_video_urls) varía según el modelo. Valores de type admitidos, por -modelo: +de type acepta un modelo dado (y si siquiera lleva aquí su entrada de imagen o video, en +lugar de en img_url o reference_video_urls) varía según el modelo. Valores de type +admitidos, por modelo: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame y last_frame: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL @@ -228,10 +229,10 @@ modelo: 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-r2v: first_frame (opcional, máx. 1), reference_image, reference_video. Se - requiere al menos un reference_image o un reference_video, y la suma de imágenes de - referencia y videos de referencia es como máximo 5. first_frame y reference_image: - JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, relación de aspecto - entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL + requiere al menos un reference_image o un reference_video, y las imágenes de + referencia más los videos de referencia suman como máximo 5. first_frame y + reference_image: JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, + relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... reference_video: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-videoedit: video (exactamente 1, el clip que se edita: MP4/MOV, de 2 a 10 @@ -263,31 +264,28 @@ modelo: 60 segundos, lado más largo como máximo 4096 píxeles, lado más corto al menos 360 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 100MB, una URL pública HTTP/HTTPS; no se acepta una URL data: en línea) más un reference_image opcional, de 0 - a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 - y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). + a 5 (JPEG/JPG/PNG/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y + 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada + de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. + +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites difieren +según el modelo. Que el esquema acepte algo no implica que el proveedor lo acepte; y, en +la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el techo de +las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el techo +del socio sobre el recurso con el que se queda, y se aplican tal cual cuando el recurso +es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL +data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con un techo de +transporte: un cuerpo POST de Comfy Router está limitado a 100 MiB en total y se responde +con 413 si se supera, y base64 infla una carga útil en aproximadamente 4/3, así que un +solo recurso en línea de más de unos 75 MB se rechaza antes de que se alcance cualquiera +de las reglas del socio aquí. A ese tamaño, un solo recurso en el propio con ese tamaño, un recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -297,16 +295,19 @@ medios, así que deja este campo sin definir. - URL del archivo multimedia: una URL pública HTTP/HTTPS o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit: una URL en línea `data:{MIME_type};base64,...`. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del servicio de carga del propio socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy hace la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, por lo que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para ver los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de solicitud del Router que acota un payload en línea en conjunto. + URL del archivo multimedia: una URL pública HTTP/HTTPS o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit: una URL en línea `data:{MIME_type};base64,...`. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del servicio de carga del propio socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que la subió; Comfy hace la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, por lo que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para ver los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de solicitud del Router que acota una carga útil en línea en conjunto. - Las palabras de prompt inverso se usan para describir el contenido que no quieres ver en la trama del video + Las palabras de prompt inverso se usan para describir el contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admiten chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que supere el límite se trunca). + Palabras del prompt de texto. Admiten chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6, y 5,000 para +wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos +20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta junto a la carretera, Character2 baila a su lado" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -357,24 +358,23 @@ Facturación: según la duración de referencia real utilizada. - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total - del video de entrada más la duración del video de salida no debe superar los 30 segundos; -1 habilita + de la entrada de video + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es true + Indica si está habilitada la reescritura inteligente del prompt. El valor predeterminado es verdadero Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -Para los modelos wan2.7, se toma un valor predeterminado según el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una -relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. +Para los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación adecuadarelación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. - Posibles valores: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -417,7 +417,7 @@ devuelve 400 en todos los modelos que la descripción de resolution indica como - Si se debe agregar un logotipo de marca de agua; la marca de agua se ubica en la esquina inferior derecha + Indica si se agrega un logotipo de marca de agua; la marca de agua se ubica en la esquina inferior derecha Generado a partir del esquema que Router sirve en `GET /v2/models/wan/happyhorse-1.0-video-edit/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -453,7 +453,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/happyhorse - Lista de resultados de la tarea para tareas de generación de imágenes + Lista de resultados de las tareas de generación de imágenes @@ -489,7 +489,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/happyhorse - Estadísticas de resultados de la tarea para tareas de generación de imágenes + Estadísticas de resultados de las tareas de generación de imágenes diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index 01a9f7a7d1..2462c403f2 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa HappyHorse 1.1 T2V con Comfy Router" description: "Snippets de Python, TypeScript y cURL para llamar a wan/happyhorse-1.1-t2v por HTTP con Comfy Router, con los campos de la solicitud y la forma del resultado" sidebarTitle: "HappyHorse 1.1 T2V" -translationSourceHash: e16717b0 +translationSourceHash: e1f68a5b translationFrom: development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx translationBlockHashes: "_intro": f001b07c "Quick start": 125cfd7d - "Schema": 88f94657 + "Schema": 0aa39fbc "Examples": 12f77722 --- + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -182,16 +183,16 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-t2v/requests/$REQUEST_ID - URL de descarga del archivo de audio. Formatos compatibles: mp3 y wav. No se puede combinar con reference_video_urls. + URL de descarga del archivo de audio. Formatos compatibles: mp3 y wav. No se puede usar junto con reference_video_urls. URL de la imagen del primer fotograma o datos codificados en Base64. Requerido para los modelos wan2.5-i2v-preview y wan2.6-i2v. Las variantes i2v de happyhorse-1.x NO reciben aquí su primer fotograma: -lo reciben como un recurso multimedia de tipo first_frame (ver media más abajo). Un +lo reciben como un recurso multimedia de tipo first_frame (ver media más abajo), y un cuerpo img_url que funciona en wan2.6-i2v es rechazado por el proveedor en -happyhorse-1.0-i2v y happyhorse-1.1-i2v. Y las variantes wan2.7/wan3.0 también reciben sus -recursos de referencia en media. Formatos de imagen: JPEG, JPG, PNG, BMP, WEBP. +happyhorse-1.0-i2v y happyhorse-1.1-i2v; además, las variantes wan2.7/wan3.0 también +reciben sus recursos de referencia en media. Formatos de imagen: JPEG, JPG, PNG, BMP, WEBP. Resolución: 360-2000 píxeles. Tamaño del archivo: máx. 10MB. @@ -209,10 +210,10 @@ modelo: 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-r2v: first_frame (opcional, máx. 1), reference_image, reference_video. Se - requiere al menos un reference_image o un reference_video, y la suma de imágenes de - referencia y videos de referencia es como máximo 5. first_frame y reference_image: - JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, relación de aspecto - entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL + requiere al menos un reference_image o un reference_video, y las imágenes de + referencia más los videos de referencia suman como máximo 5. first_frame y + reference_image: JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, + relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... reference_video: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-videoedit: video (exactamente 1, el clip que se edita: MP4/MOV, de 2 a 10 @@ -247,28 +248,28 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Las referencias de sus socios no documentan ninguna + entrada de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema lo acepte no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo que el socio aplica al recurso que acaba recibiendo, y se aplican tal como +están escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por +Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y además se +enfrenta a un techo de transporte: el cuerpo de un POST de Comfy Router está limitado a +100 MiB en total y se responde 413 si lo supera, y base64 infla la carga útil alrededor +de 4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar +a cualquiera de las reglas del socio que aparecen aquí. A ese tamaño, un solo recurso en +el propio20MB del socio cabe en línea sin problema, así que con un solo recurso lo que obliga es la +regla del socio: el techo de transporte obliga cuando hay varios, ya que el límite de +100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública +cualquier cosa que se acerque a estos techos. @@ -282,12 +283,11 @@ medios, así que deja este campo sin definir. - Las palabras de prompt inverso se usan para describir contenido que no quieres ver en la trama del video + Las palabras de prompt inverso describen el contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras de prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20 000 caracteres para wan3.0-video; el contenido que supera el límite se trunca). + Palabras de prompt de texto. Admite chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x trunca el prompt en lugar de rechazarlo: 1.500 caracteres para wan2.5 y wan2.6, y 5.000 para wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20.000 caracteres. El proveedor rechaza una solicitud cuyo prompt y negative_prompt juntos superen unos 60.850 bytes de texto UTF-8 (unos 20.000 caracteres chinos), respondiendo InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 sings on the roadside, Character2 dances beside it" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -340,17 +340,20 @@ Facturación: según la duración de referencia real utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total de video de entrada + duración de video de salida no debe superar los 30 segundos; -1 habilita el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 para una duración fuera de [-1, 30]. +Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: de `-1` a `30` - Si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es true Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. +En los modelos wan2.7, se toma un valor predeterminado según el nivel de resolución si no se proporciona. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una + Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, se usa un valor predeterminado según el nivel de resolución si no se proporciona. Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. @@ -363,7 +366,7 @@ de aspecto adecuada según las proporciones y la intención de los recursos de e - wan2.5-i2v-preview: 480P, 720P, 1080P - modelos wan2.6 (t2v, i2v, r2v): solo 720P, 1080P (sin soporte para 480P) - modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (1080P predeterminado) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (valor predeterminado ascendente 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (valor predeterminado del proveedor: 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P Este proxy rechaza las solicitudes de generación de video que no incluyen ni resolution ni size, porque el nivel de resolución determina la tarifa de facturación. Convierte resolution a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas, devuelve 400 cuando el valor queda fuera de esta enumeración y devuelve 400 para 480P (ya se envíe como resolution o como un size de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 indicados arriba como modelos sin 480P. @@ -416,7 +419,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/happyhorse - El código de error de la solicitud fallida (no se devuelve si la solicitud es exitosa) + Código de error de la solicitud fallida (no se devuelve si la solicitud es exitosa) diff --git a/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx index 19c3b1d350..42505f0ff0 100644 --- a/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.5 T2I Preview con Comfy Router" description: "Llama a wan/wan2.5-t2i-preview mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Wan 2.5 T2I Preview" -translationSourceHash: 9d519a07 +translationSourceHash: 1b62e07d translationFrom: development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx translationBlockHashes: "_intro": 975ad7fc "Quick start": 9cc4b789 - "Schema": 579649db + "Schema": 77ffea28 "Examples": e420aca1 --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/wan/wan2.5-t2i-preview.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -174,11 +175,11 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - Palabras del prompt inverso para describir el contenido que no quieres ver en la imagen + Palabras del prompt negativo para describir el contenido que no quieres ver en la imagen. A partir de 500 caracteres, el modelo lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt positivo para describir los elementos de la imagen y las características visuales esperadas. Admite chino e inglés, con una longitud no superior a 800 caracteres + Palabras del prompt positivo para describir los elementos de la imagen y las características visuales esperadas. Admite chino e inglés. A partir de 2,000 caracteres, el modelo trunca el prompt en lugar de rechazarlo. El proveedor rechaza una solicitud cuyo prompt y negative_prompt juntos superen aproximadamente 60,850 bytes de texto UTF-8 (unos 20,000 caracteres chinos), respondiendo InvalidParameter `Range of input length should be [1, 61440]`. @@ -210,7 +211,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - Indica si se debe agregar el logotipo de marca de agua en la esquina inferior derecha + Indica si agregar el logotipo de marca de agua en la esquina inferior derecha Generado a partir del esquema que Router expone en `GET /v2/models/wan/wan2.5-t2i-preview/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -230,7 +231,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/wan/wan2.5-t2 - Código de error de la solicitud fallida (no viene en la respuesta si la solicitud es exitosa) + Código de error de la solicitud fallida (no se devuelve si la solicitud es exitosa) @@ -238,7 +239,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/wan/wan2.5-t2 - Información detallada sobre la solicitud fallida (no viene en la respuesta si la solicitud es exitosa) + Información detallada sobre la solicitud fallida (no se devuelve si la solicitud es exitosa) @@ -360,11 +361,11 @@ Generado a partir del esquema que Router expone en `GET /v2/models/wan/wan2.5-t2 - Código de error de una solicitud fallida, reportado en la RAÍZ del envelope en lugar de bajo `output` (no se devuelve si la solicitud tuvo éxito). + Código de error de una solicitud fallida, reportado en la RAÍZ del envoltorio de la respuesta en lugar de bajo `output` (no se devuelve si la solicitud tuvo éxito). - Información detallada sobre una solicitud fallida, reportada en la RAÍZ del envelope en lugar de bajo `output` (no se devuelve si la solicitud tuvo éxito). Léela antes de recurrir a `output.message`. + Información detallada sobre una solicitud fallida, reportada en la RAÍZ del envoltorio de la respuesta en lugar de bajo `output` (no se devuelve si la solicitud tuvo éxito). Léela antes de recurrir a `output.message`. ## Ejemplos diff --git a/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx index a384bdd3e0..a49444c50e 100644 --- a/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.5 T2V Preview con Comfy Router" description: "Snippets de Python, TypeScript y cURL para llamar a wan/wan2.5-t2v-preview por HTTP con Comfy Router, los campos de solicitud y la forma del resultado." sidebarTitle: "Wan 2.5 T2V Preview" -translationSourceHash: 51e7ac3c +translationSourceHash: e7df4aa3 translationFrom: development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx translationBlockHashes: "_intro": 111ed2f7 "Quick start": d4fb170b - "Schema": 73f1810d + "Schema": 62b9e06a "Examples": 12f77722 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -247,28 +248,25 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada + de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo del socio sobre el recurso que este acaba recibiendo, y se aplican tal cual +cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL +data:\{MIME_type};base64,... en línea sí pasa por Comfy y además se topa con un techo de +transporte: el cuerpo de un POST a Comfy Router está limitado a 100 MiB en total y se +responde con 413 si se supera, y base64 infla una carga útil en aproximadamente 4/3, así +que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar a +cualquiera de las reglas del socio que figuran aquí. Con ese tamaño, un solo recurso con +el propioun solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -282,12 +280,15 @@ medios, así que deja este campo sin definir. - Las palabras del prompt negativo se usan para describir el contenido que no quieres ver en la trama del video + Las palabras del prompt negativo se usan para describir el contenido que no quieres ver en la trama del video. Pasados 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que supera el límite se trunca). + Palabras del prompt de texto. Admite chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6 y 5,000 para +wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos +20,000 caracteres chinos), respondiendo InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta junto a la carretera y Character2 baila a su lado" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -338,22 +339,21 @@ Facturación: se basa en la duración de referencia real utilizada. - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total - del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita + de video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 para una duración fuera de [-1, 30]. +Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Indica si está habilitada la reescritura inteligente del prompt. El valor predeterminado es verdadero + Indica si se activa la reescritura inteligente del prompt. El valor predeterminado es true Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -En los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. -En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una -relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +Para los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index 3e3da59e26..d2a39d1a62 100644 --- a/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.6 I2V con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/wan2.6-i2v por HTTP mediante Comfy Router, más los campos de la solicitud y la forma del resultado" sidebarTitle: "Wan 2.6 I2V" -translationSourceHash: 2d86680e +translationSourceHash: 6912559c translationFrom: development/comfy-router/models/wan/wan2-6-i2v/code.mdx translationBlockHashes: "_intro": 53ec6bcb "Quick start": 0163076e - "Schema": 4b1f17d6 + "Schema": a13e6673 "Examples": 2b581e5f --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -193,7 +194,7 @@ usar junto con reference_video_urls. los modelos wan2.5-i2v-preview y wan2.6-i2v. Las variantes i2v de happyhorse-1.x NO reciben aquí su primer fotograma: lo reciben como un recurso multimedia de tipo first_frame (consulta media más abajo), y un cuerpo img_url que funciona en wan2.6-i2v -el proveedor lo rechaza en happyhorse-1.0-i2v y happyhorse-1.1-i2v; además, las +es rechazado por el proveedor en happyhorse-1.0-i2v y happyhorse-1.1-i2v; además, las variantes wan2.7/wan3.0 también reciben sus recursos de referencia en media. Formatos de imagen: JPEG, JPG, PNG, BMP, WEBP. Resolución: 360-2000 píxeles. Tamaño del archivo: máx 10MB. @@ -262,87 +263,51 @@ medios, así que deja este campo sin definir. implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + finalmente recibe, y se aplican tal cual cuando el recurso es una URL pública, porque + esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... en línea sí + pasa por Comfy y también se enfrenta a un techo de transporte: el cuerpo de un POST de + Comfy Router está limitado a 100 MiB en total y se responde 413 si lo supera, y base64 + infla la carga en aproximadamente 4/3, así que un solo recurso en línea de más de unos + 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio aquí descritas. + Con ese tamaño, un solo recurso con los propiosEl techo de 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. Tipo de recurso multimedia - Valores posibles: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, -`reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + Valores posibles: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` - URL del archivo multimedia: una URL HTTP/HTTPS pública o, únicamente para las entradas -de IMAGEN que la descripción de `media` anterior enumera para cada modelo (first_frame y -last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image -en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y -wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; -reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en -happyhorse-1.0-video-edit), una URL `data:{MIME_type};base64,...` en línea. Ninguna -entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: en -línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, -o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta -de Alibaba Cloud que la subió; Comfy realiza la llamada al modelo con su propia clave y -no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien -llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que -tal valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la -descripción de `media` para conocer los límites de tamaño y de píxeles por modelo y el -tope de 100 MiB del cuerpo de la solicitud del Router que acota en conjunto una carga -útil en línea. + URL del archivo multimedia: una URL HTTP/HTTPS pública o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo (first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit), una URL `data:{MIME_type};base64,...` en línea. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: en línea. Una URL temporal oss://dashscope-instant del propio servicio de carga del socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelven contra la cuenta de Alibaba Cloud que los subió; Comfy hace la llamada al modelo con su propia clave y no expone ninguna ruta de carga, así que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que tal valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para conocer los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota en conjunto una carga útil en línea. - Las palabras del prompt inverso se usan para describir contenido que no quieres ver en -la trama del video + Las palabras del prompt inverso se usan para describir contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admiten chino e inglés, con una longitud que no supere -los 800 caracteres (hasta 20,000 caracteres en wan3.0-video; el contenido que excede el -límite se trunca). En wan2.6-r2v con varios videos de referencia, usa 'character1', -'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. -Ejemplo: "Character1 canta junto al camino, Character2 baila a su lado" En el modo de -referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a -los recursos multimedia en el orden correspondiente dentro del arreglo media. + Palabras del prompt de texto. Se admiten chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6, y 5,000 para wan2.7. wan3.0-video y wan3.0-video-prime admiten como máximo 20,000 caracteres. El proveedor rechaza una solicitud cuya combinación de prompt y negative_prompt supere aproximadamente 60,850 bytes de texto UTF-8 (unos 20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta junto al camino, Character2 baila a su lado" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia en el orden correspondiente dentro del arreglo media. - URLs de video de referencia solo para el modelo wan2.6-r2v. Arreglo de 1-3 URLs de -video. + URLs de video de referencia solo para el modelo wan2.6-r2v. Arreglo de 1-3 URLs de video. Restricciones de entrada: - Formato: mp4, mov - Cantidad: 1-3 videos - Longitud de cada video: 2-30 segundos - Tamaño de cada archivo: máx 30MB - No se puede usar con audio_url -Duración de referencia: un video máx 5s, dos videos máx 2.5s cada uno, tres videos -proporcionalmente menos. +Duración de referencia: un video máx 5s, dos videos máx 2.5s cada uno, tres videos proporcionalmente menos. Facturación: según la duración de referencia realmente utilizada. - Nombre de la plantilla de efecto de video. Opcional. Actualmente compatible con: -squish, flying, carousel. Cuando se usa, el parámetro prompt se ignora. + Nombre de la plantilla de efecto de video. Opcional. Actualmente compatible con: squish, flying, carousel. Cuando se usa, el parámetro prompt se ignora. - El ID del modelo que se va a llamar. NO está restringido en este componente: Comfy -Router lo rellena a partir del segmento de ruta `{model}` de -`POST /v2/models/wan/{model}`, así que quien llama al Router lo omite. Una llamada -directa de v1 a `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` -DEBE proporcionarlo, y el enum de grafías aceptadas vive en el componente propio de esa -operación, `WanVideoGenerationRequest`. + El ID del modelo que se va a llamar. NO está restringido en este componente: Comfy Router lo rellena a partir del segmento de ruta `{model}` de `POST /v2/models/wan/{model}`, así que quien llama al Router lo omite. Una llamada directa de v1 a `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` DEBE proporcionarlo, y el enum de grafías aceptadas vive en el componente propio de esa operación, `WanVideoGenerationRequest`. @@ -350,14 +315,12 @@ operación, `WanVideoGenerationRequest`. - Indica si se agrega audio al video. Solo es compatible con wan3.0-video y -wan3.0-video-prime; el proveedor no documenta tal opción para los demás modelos wan. + Indica si se agrega audio al video. Solo es compatible con wan3.0-video y wan3.0-video-prime; el proveedor no documenta tal opción para los demás modelos wan. Configuración de audio del video para el modelo wan2.7-videoedit. -- auto (predeterminado): el modelo decide de forma inteligente según el contenido del - prompt +- auto (predeterminado): el modelo decide de forma inteligente según el contenido del prompt - origin: conserva de forma forzada el audio original del video de entrada Valores posibles: `auto`, `origin` @@ -370,25 +333,21 @@ wan3.0-video-prime; el proveedor no documenta tal opción para los demás modelo - wan2.6-r2v: solo 5 o 10 segundos (sin soporte de 15s) - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] -- wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la - duración total del video de entrada + la duración del video de salida no debe superar - los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige - una duración adecuada Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. +- wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita el modo de duración inteligente, en el que el modelo elige una duración adecuada +Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Si se habilita la reescritura inteligente del prompt. El valor predeterminado es -verdadero + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es true. - Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. En los -modelos wan2.7, se toma un valor predeterminado según el nivel de resolución si no se -proporciona. En wan3.0-video, adaptive (el valor predeterminado) recomienda -automáticamente una relación de aspecto adecuada según las proporciones y la intención -de los recursos de entrada. + Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. +En los modelos wan2.7, si no se proporciona, toma un valor predeterminado según el nivel de resolución. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto adecuada según las proporciones y la intención de los recursos de +entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -470,8 +429,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/wan2.6-i2v - Información detallada sobre la solicitud fallida (no se devuelve si la solicitud es -exitosa) + Información detallada sobre la solicitud fallida (no se devuelve si la solicitud es exitosa) @@ -537,8 +495,7 @@ exitosa) - URL del video para las tareas de generación de video completadas. El enlace es válido -durante 24 horas + URL del video para las tareas de generación de video completadas. El enlace es válido durante 24 horas @@ -566,8 +523,7 @@ durante 24 horas - Duración del video de entrada en segundos, 0.0 cuando no hay video de entrada (tareas -wan3.0-video) + Duración del video de entrada en segundos, 0.0 cuando no hay video de entrada (tareas wan3.0-video) @@ -595,14 +551,11 @@ wan3.0-video) - Código de error de una solicitud fallida, informado en la RAÍZ del envelope en lugar -de en `output` (no se devuelve si la solicitud fue exitosa). + Código de error de una solicitud fallida, informado en la RAÍZ del envelope y no dentro de `output` (no se devuelve si la solicitud fue exitosa). - Información detallada sobre una solicitud fallida, informada en la RAÍZ del envelope -en lugar de en `output` (no se devuelve si la solicitud fue exitosa). Lee esto antes de -recurrir a `output.message`. + Información detallada sobre una solicitud fallida, informada en la RAÍZ del envelope y no dentro de `output` (no se devuelve si la solicitud fue exitosa). Lee esto antes de recurrir a `output.message`. ## Ejemplos diff --git a/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index e3a7db304a..dfd8202e55 100644 --- a/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.6 R2V con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/wan2.6-r2v por HTTP con Comfy Router, además de los campos de solicitud y la forma del resultado" sidebarTitle: "Wan 2.6 R2V" -translationSourceHash: 2a7dc724 +translationSourceHash: f2cccfce translationFrom: development/comfy-router/models/wan/wan2-6-r2v/code.mdx translationBlockHashes: "_intro": dc2fc376 "Quick start": 066eb9ee - "Schema": 104ab356 + "Schema": 789f5781 "Examples": dd88ebee --- + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -207,21 +208,21 @@ modelo: - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame y last_frame: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... driving_audio (WAV/MP3, de 2 a 30 segundos, como máximo - 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como - máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. + data:\{MIME_type};base64,... URL. driving_audio (WAV/MP3, de 2 a 30 segundos, como + máximo 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, + como máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-r2v: first_frame (opcional, máx. 1), reference_image, reference_video. Se - requiere al menos un reference_image o un reference_video, y la suma de imágenes de - referencia y videos de referencia es como máximo 5. first_frame y reference_image: - JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, relación de aspecto - entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... reference_video: una URL pública HTTP/HTTPS; no se acepta - una URL data: en línea. + requiere al menos un reference_image o un reference_video, y las imágenes de + referencia más los videos de referencia suman como máximo 5. first_frame y + reference_image: JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, + relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL + data:\{MIME_type};base64,... URL. reference_video: una URL pública HTTP/HTTPS; no se + acepta una URL data: en línea. - wan2.7-videoedit: video (exactamente 1, el clip que se edita: MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB, una URL pública HTTP/HTTPS; no se acepta una URL data: en línea) más un reference_image opcional, de 0 a 4 (JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y - 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). + 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... URL). - wan3.0-video, wan3.0-video-prime: first_frame (máx. 1), last_frame (máx. 1), reference_image (máx. 10), reference_video (máx. 5 clips, duración total \<= 15s), reference_audio (máx. 5 clips, duración total \<= 15s), file (máx. 1, no se puede usar @@ -230,43 +231,43 @@ modelo: solicitud. El orden del array define el orden de referencia de los recursos en el prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, - como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... + como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... URL. reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - happyhorse-1.0-i2v, happyhorse-1.1-i2v: solo first_frame, exactamente 1. Estas variantes toman su primer fotograma AQUÍ y no en img_url. Al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL - pública o una URL data:\{MIME_type};base64,... + pública o una URL data:\{MIME_type};base64,... URL. - happyhorse-1.0-r2v, happyhorse-1.1-r2v: solo reference_image, de 1 a 9. Esta es la única entrada de referencia del modelo. El lado más corto debe medir al menos 400 píxeles, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL pública o una URL - data:\{MIME_type};base64,... reference_video no es un tipo de entrada para esta + data:\{MIME_type};base64,... URL. reference_video no es un tipo de entrada para esta operación. - happyhorse-1.0-video-edit: video (exactamente 1, el clip que se edita: MP4/MOV, de 3 a 60 segundos, lado más largo como máximo 4096 píxeles, lado más corto al menos 360 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 100MB, una URL pública HTTP/HTTPS; no se acepta una URL data: en línea) más un reference_image opcional, de 0 a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 - y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). + y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... URL). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de + medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus topes difieren +según el modelo. Que el esquema acepte un valor no implica que el proveedor lo acepte; y, +en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el techo +de las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el techo +del socio sobre el recurso que acaba recibiendo, y se aplican tal como están escritas +cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL +data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con un límite +de transporte: el cuerpo de una solicitud POST de Comfy Router está limitado a 100 MiB en +total y se responde 413 si se supera, y base64 infla una carga útil alrededor de 4/3, así +que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera +de las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propiopública, porque esos bytes nunca pasan por Comfy. Con ese tamaño, un solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como @@ -280,16 +281,19 @@ medios, así que deja este campo sin definir. - URL del archivo de medios: una URL pública HTTP/HTTPS o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit, una URL inline `data:{MIME_type};base64,...`. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: inline. Una URL temporal oss://dashscope-instant del servicio de carga del propio socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que lo subió; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, por lo que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para ver los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota el payload inline en conjunto. + URL del archivo de medios: una URL pública HTTP/HTTPS o, únicamente para las entradas de IMAGEN que la descripción de `media` anterior enumera para cada modelo: first_frame y last_frame en wan2.7-i2v; first_frame y reference_image en wan2.7-r2v; reference_image en wan2.7-videoedit; first_frame, last_frame y reference_image en wan3.0-video y wan3.0-video-prime; first_frame en happyhorse-1.0-i2v y happyhorse-1.1-i2v; reference_image en happyhorse-1.0-r2v y happyhorse-1.1-r2v; y reference_image en happyhorse-1.0-video-edit, una URL inline `data:{MIME_type};base64,...`. Ninguna entrada de video, audio, archivo o enlace de estos modelos acepta una URL data: inline. Una URL temporal oss://dashscope-instant del servicio de carga del propio socio, o (en wan2.7-videoedit) un asset_id de Asset Center, solo se resuelve contra la cuenta de Alibaba Cloud que lo subió; Comfy realiza la llamada al modelo con su propia clave y no expone ninguna ruta de carga, por lo que una URL oss:// o un asset_id propios de quien llama no son una entrada admitida. Este campo no valida el esquema de la URL, así que ese valor se reenvía al socio tal cual en lugar de rechazarse aquí. Consulta la descripción de `media` para ver los límites de tamaño y de píxeles por modelo y el tope de 100 MiB del cuerpo de la solicitud del Router que acota la carga útil inline en conjunto. - Las palabras del prompt inverso describen contenido que no quieres ver en la trama del video + Las palabras del prompt inverso describen contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que excede el límite se trunca). + Palabras del prompt de texto. Admite chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6, y 5,000 para +wan2.7. wan3.0-video y wan3.0-video-prime admiten como máximo 20,000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos +20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 sings on the roadside, Character2 dances beside it" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -342,20 +346,19 @@ Facturación: según la duración de referencia real utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 si la duración está fuera de [-1, 30]. +Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - ¿Está habilitada la reescritura inteligente del prompt? El valor predeterminado es verdadero + Indica si se activa la reescritura inteligente del prompt. El valor predeterminado es true - Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. -Para los modelos wan2.7, el valor predeterminado se basa en el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto -adecuada según las proporciones de los recursos de entrada y la intención. + Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. +Para los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una adecuadarelación de aspecto adecuada según las proporciones de los medios de entrada y la intención. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 9da52c1d0c..5551f6cae3 100644 --- a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -2,14 +2,16 @@ title: "Usa Wan 2.7 I2V con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/wan2.7-i2v por HTTP con Comfy Router, con los campos de la solicitud y la forma del resultado" sidebarTitle: "Wan 2.7 I2V" -translationSourceHash: 6c8ca8c8 +translationSourceHash: 5c0685e4 translationFrom: development/comfy-router/models/wan/wan2-7-i2v/code.mdx translationBlockHashes: "_intro": d49c4d30 "Quick start": 167fa44a - "Schema": ac50dc1f + "Schema": 5e5f0bca "Examples": 5ffd46d7 --- + + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -274,23 +276,23 @@ medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo del socio sobre el recurso con el que finalmente se queda, y se aplican tal +cual cuando el recurso es una URL pública, porque esos bytes nunca viajan por Comfy. Una +URL data:\{MIME_type};base64,... en línea sí viaja por Comfy y también se topa con un +techo de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 MiB en +total y se responde 413 cuando se supera, y base64 infla la carga útil en +aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza +antes de que se aplique cualquiera de las reglas del socio que aparecen aquí. Con ese +tamaño, un único recurso en el propio límite del socio20MB ceiling fits inline comfortably, so the partner rule is what binds for one asset -- +the transport ceiling binds across several of them, since the 100 MiB Router cap bounds +the WHOLE request rather than each element. Send anything near these ceilings as a +public URL. @@ -304,12 +306,11 @@ medios, así que deja este campo sin definir. - Las palabras del prompt inverso se usan para describir contenido que no quieres ver en la trama del video + Las palabras del prompt inverso se usan para describir contenido que no quieres ver en la trama del video. A partir de 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras del prompt de texto. Admite chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que supere el límite se trunca). + Palabras del prompt de texto. Admite chino e inglés. Cuando se supera su propia longitud documentada, un modelo wan2.x trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6 y 5,000 para wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos 20,000 caracteres chinos) y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 sings on the roadside, Character2 dances beside it" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -360,7 +361,21 @@ Facturación: según la duración de referencia real utilizada. - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración - total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita + total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa + el modo de duración inteligente, en el que el modelo elige una duración adecuada +Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. + + Alcance: `-1` a `30` + + + + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + + + + Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. +En los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente untotal del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. @@ -394,7 +409,7 @@ Este proxy rechaza las solicitudes de generación de video que no incluyen ni re - Semilla de número aleatorio, se usa para controlar la aleatoriedad del contenido generado por el modelo + Semilla de número aleatorio que se usa para controlar la aleatoriedad del contenido generado por el modelo Rango: `0` a `2147483647` @@ -418,7 +433,7 @@ Cuando se envían size y resolution juntos, size determina el nivel facturado y - Indica si se añade un logotipo de marca de agua; la marca de agua se ubica en la esquina inferior derecha + Indica si se añade un logotipo de marca de agua. La marca de agua se ubica en la esquina inferior derecha Generado a partir del esquema que Router sirve en `GET /v2/models/wan/wan2.7-i2v/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -512,7 +527,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/wan/wan2.7-i2v - URL del video para las tareas de generación de video completadas. El enlace es válido por 24 horas + URL del video para las tareas de generación de video completadas. El enlace es válido durante 24 horas diff --git a/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index 741cb1b89d..79d176504a 100644 --- a/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -2,14 +2,15 @@ title: "Usa Wan 2.7 R2V con Comfy Router" description: "Snippets de Python, TypeScript y cURL para llamar a wan/wan2.7-r2v por HTTP con Comfy Router, además de los campos de la solicitud y la forma del resultado" sidebarTitle: "Wan 2.7 R2V" -translationSourceHash: f1b372da +translationSourceHash: fc3b1068 translationFrom: development/comfy-router/models/wan/wan2-7-r2v/code.mdx translationBlockHashes: "_intro": 5428b08c "Quick start": 204ef296 - "Schema": 18b98be3 + "Schema": 7d82934a "Examples": a91cb6b1 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -202,7 +203,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-r2v/requests/$REQUEST_ID \ ### Entrada - Introduce la información básica, como los prompt, etc. + Introduce la información básica, como los prompts, etc. @@ -216,7 +217,7 @@ fotograma: lo toman como un elemento de media de tipo first_frame (consulta medi cuerpo img_url que funciona en wan2.6-i2v es rechazado por el proveedor en happyhorse-1.0-i2v y happyhorse-1.1-i2v; además, las variantes wan2.7/wan3.0 también toman sus recursos de referencia en media. Formatos de imagen: JPEG, JPG, PNG, BMP, WEBP. -Resolución: 360-2000 píxeles. Tamaño del archivo: máx 10MB. +Resolución: 360-2000 píxeles. Tamaño del archivo: máx. 10MB. @@ -271,18 +272,29 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada + de medios, así que deja este campo sin establecer. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL + reference_video_urls. + +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores +(el techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) +son el techo del socio sobre el recurso con el que finalmente se queda, y se aplican tal +cual cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una +URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con un +techo de transporte: el cuerpo de una solicitud POST de Comfy Router está limitado a +100 MiB en total y se responde 413 al superarlo, y base64 infla una carga útil en +aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza +antes de alcanzar cualquiera de las reglas del socio que aquí se indican. A ese tamaño, +un único recurso en el propio + + +acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima @@ -306,12 +318,15 @@ medios, así que deja este campo sin definir. - Las palabras de prompt inverso se usan para describir contenido que no quieres ver en la trama del video + Las palabras de prompt inverso se usan para describir contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que el prompt. - Palabras de prompt de texto. Admiten chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que supera el límite se trunca). + Palabras de prompt de texto. Admite chino e inglés. Pasada su propia longitud documentada, un modelo wan2.x +trunca el prompt en lugar de rechazarlo: 1,500 caracteres para wan2.5 y wan2.6, y 5,000 para +wan2.7. wan3.0-video y wan3.0-video-prime aceptan como máximo 20,000 caracteres. El proveedor rechaza una solicitud +cuyo prompt y negative_prompt juntos superen unos 60,850 bytes de texto UTF-8 (unos +20,000 caracteres chinos), y responde InvalidParameter `Range of input length should be [1, 61440]`. Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos en el orden de los videos de referencia. Ejemplo: "Character1 canta al borde del camino, Character2 baila a su lado" Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia @@ -362,22 +377,21 @@ Facturación: según la duración de referencia real utilizada. - wan2.7-i2v, wan2.7-t2v: entero en [2, 15] - wan2.7-r2v, wan2.7-videoedit: entero en [2, 10] - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total - del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa + del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 para una duración fuera de [-1, 30]. +Este proxy devuelve 400 si la duración está fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` - Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es true + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -En los modelos wan2.7, si no se proporciona, el valor predeterminado depende del nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una -relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +Para los modelos wan2.7, si no se proporciona, se toma un valor predeterminado según el nivel de resolución. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente un valor adecuadorelación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -431,7 +445,6 @@ devuelve 400 en todos los modelos que la descripción de la resolución enumera Generado a partir del esquema que Router expone en `GET /v2/models/wan/wan2.7-r2v/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. - ### Salida diff --git a/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index a7ce1b3eff..091d586601 100644 --- a/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -2,14 +2,16 @@ title: "Usa Wan 3.0 Video Prime con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a wan/wan3.0-video-prime por HTTP con Comfy Router, más los campos y la forma del resultado" sidebarTitle: "Wan 3.0 Video Prime" -translationSourceHash: 63c2c33a +translationSourceHash: 1fc83550 translationFrom: development/comfy-router/models/wan/wan3-0-video-prime/code.mdx translationBlockHashes: "_intro": 812fcd16 "Quick start": 1ae93564 - "Schema": 8f9dbbd5 + "Schema": d589709d "Examples": 12f77722 --- + + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -247,28 +249,31 @@ modelo: a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: -operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de -medios, así que deja este campo sin definir. + operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada + de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en - reference_video_urls. Los recuentos por modelo anteriores son restricciones del socio, - no de este esquema: no se declara minItems/maxItems en media, porque los tipos - admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no - implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como - máximo 20MB" por recurso anteriores (el techo de las entradas de imagen, las únicas - entradas que pueden enviarse en línea) son el techo del socio sobre el recurso que - acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. + reference_video_urls. +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no +se declara minItems/maxItems en media, porque los tipos admisibles y sus límites +difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo +acepte; y, a la inversa, las cifras anteriores de "como máximo 20MB" por recurso (el +techo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) son +el techo del socio sobre el recurso que acaba recibiendo, y se aplican tal como están +escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. +Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se enfrenta a +un límite de transporte: el cuerpo de una solicitud POST de Comfy Router tiene un límite +total de 100 MiB y se responde con 413 si se supera, y base64 infla una carga útil en +aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza +antes de llegar a cualquiera de las reglas del socio que aparecen aquí. Con ese tamaño, +un único recurso en el propio del socio + + +20MB ceiling fits inline comfortably, so the partner rule is what binds for one asset; +the transport ceiling binds across several of them, since the 100 MiB Router cap bounds +the WHOLE request rather than each element. Envía como URL pública cualquier cosa que se +acerque a estos techos. @@ -282,16 +287,13 @@ medios, así que deja este campo sin definir. - Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video + Las palabras del prompt inverso describen el contenido que no quieres ver en la trama del video. Pasados los 500 caracteres, un modelo wan lo trunca en lugar de rechazarlo. Cuenta para el mismo presupuesto de entrada que prompt. - Palabras del prompt de texto. Admiten chino e inglés, con una longitud no superior a 800 caracteres -(hasta 20,000 caracteres para wan3.0-video; el contenido que supera el límite se trunca). -Para wan2.6-r2v con varios videos de referencia, usa 'character1', 'character2', etc. para referirte a los sujetos -en el orden de los videos de referencia. Ejemplo: "Character1 canta al borde del camino, Character2 baila a su lado" -Para el modo de referencia de wan3.0-video, usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia -en el orden correspondiente dentro del arreglo media. + Palabras del prompt de texto. Admiten chino e inglés. wan3.0-video y wan3.0-video-prime aceptan como máximo +20,000 caracteres. Usa 'Image 1', 'Video 1', 'Audio 1', etc. para referirte a los recursos multimedia en el +orden correspondiente dentro del arreglo media. @@ -307,11 +309,11 @@ Facturación: según la duración de referencia real utilizada. - Nombre de la plantilla de efecto de video. Opcional. Actualmente compatible: squish, flying, carousel. Cuando se usa, el parámetro prompt se ignora. + Nombre de la plantilla de efecto de video. Opcional. Actualmente compatibles: squish, flying, carousel. Cuando se usa, el parámetro prompt se ignora. - El ID del modelo que se va a llamar. NO está restringido en este componente: Comfy Router lo toma del segmento de ruta `{model}` de `POST /v2/models/wan/{model}`, así que quien llama al Router lo omite. Una llamada directa v1 a `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` DEBE proporcionarlo, y la enumeración de las grafías aceptadas se encuentra en el componente propio de esa operación, `WanVideoGenerationRequest`. + El ID del modelo que se va a llamar. NO está restringido en este componente: Comfy Router lo toma del segmento de ruta `{model}` de `POST /v2/models/wan/{model}`, así que quien llama al Router lo omite. @@ -340,9 +342,9 @@ Facturación: según la duración de referencia real utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 para una duración fuera de [-1, 30]. +Este proxy devuelve 400 si la duración está fuera de [-1, 30]. - Rango: `-1` a `30` + Alcance: `-1` a `30` @@ -350,10 +352,10 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -Para los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. + Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. +En los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto -adecuada según las proporciones y la intención de los recursos de entrada. +adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -362,27 +364,30 @@ adecuada según las proporciones y la intención de los recursos de entrada. Nivel de resolución. Los valores admitidos varían según el modelo: - wan2.5-i2v-preview: 480P, 720P, 1080P - modelos wan2.6 (t2v, i2v, r2v): solo 720P, 1080P (sin soporte para 480P) -- modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (predeterminada 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (el predeterminado upstream es 1080P) +- modelos wan2.7 (i2v, t2v, r2v, videoedit): 720P, 1080P (predeterminado 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (predeterminado del proveedor 1080P) - happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P - -Este proxy rechaza las solicitudes de generación de video que no incluyen ni resolution ni size, porque el nivel de resolución determina la tarifa de facturación. Convierte resolution a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas, devuelve 400 cuando el valor queda fuera de esta enumeración y devuelve 400 para 480P (ya sea enviado como resolution o como un size de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 indicados arriba como modelos sin 480P. +Este proxy rechaza las solicitudes de generación de video que no indican ni resolution +ni size, porque el nivel de resolución determina la tarifa de facturación. Convierte +resolution a mayúsculas antes de validarla y reenvía el valor en mayúsculas; devuelve 400 fuera de esta enumeración, y devuelve 400 para 480P (ya sea enviado como +resolution o como un size de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 +indicados arriba como modelos sin 480P. Valores posibles: `480P`, `720P`, `1080P` - Semilla de número aleatorio, se usa para controlar la aleatoriedad del contenido generado por el modelo + Semilla aleatoria que controla la aleatoriedad del contenido generado por el modelo Rango: `0` a `2147483647` - Control multiobjetivo inteligente. Solo está activo cuando prompt_extend está habilitado. + Control inteligente de múltiples lentes. Solo está activo cuando prompt_extend está habilitado. Para los modelos wan2.6 y wan2.7-r2v. -- single: Video de una sola toma (predeterminado) -- multi: Video de varias tomas +- single: video de una sola toma (predeterminado) +- multi: video de varias tomas Valores posibles: `multi`, `single` @@ -397,7 +402,7 @@ Cuando se envían size y resolution, size selecciona el nivel facturado y resolu - Si se agrega un logotipo de marca de agua; la marca de agua se ubica en la esquina inferior derecha + Indica si se añade un logotipo de marca de agua; la marca de agua se ubica en la esquina inferior derecha Generado a partir del esquema que Router sirve en `GET /v2/models/wan/wan3.0-video-prime/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. From 1f37d71c9380c95bfd51416e99ef7c4a517773f3 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:20:22 +0800 Subject: [PATCH 10/36] i18n(es): sync router model pages with upstream/main (2026-11-10) --- es/development/comfy-router/limitations.mdx | 8 +- .../gemini-omni-1-1-flash/code.mdx | 7 +- .../gemini-omni-1-2-flash/code.mdx | 318 ++++++++++++++++ .../gemini-omni-flash-preview/code.mdx | 7 +- .../openai/gpt-image-2-6-flare/code.mdx | 355 +++++++++++++++++ .../openai/gpt-image-2-6-sunburst/code.mdx | 357 ++++++++++++++++++ .../models/openai/gpt-image-2/code.mdx | 8 +- es/development/comfy-router/providers.mdx | 30 +- es/tutorials/basic/text-to-image.mdx | 3 + es/tutorials/video/ltx/ltx-2-3.mdx | 43 ++- 10 files changed, 1099 insertions(+), 37 deletions(-) create mode 100644 es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx create mode 100644 es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx create mode 100644 es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx diff --git a/es/development/comfy-router/limitations.mdx b/es/development/comfy-router/limitations.mdx index 36e4d94fb2..d8e717eaba 100644 --- a/es/development/comfy-router/limitations.mdx +++ b/es/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Capacidades y límites de Comfy Router" sidebarTitle: "Capacidades y límites" description: "Elige Router o un proxy socio, planifica llamadas largas y entiende la recuperación, los límites de tasa y el almacenamiento de recursos." -translationSourceHash: 691c2e79 +translationSourceHash: fbb54868 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,13 +14,14 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": 2b25596f + "Models without a pre-flight estimate": cca3ca82 "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- + Router ejecuta un modelo socio a través de una llamada HTTP síncrona o mediante una solicitud en cola que envías y recoges más tarde. Úsalo cuando tu aplicación pueda esperar un resultado finalizado o recogerlo más tarde, y pueda manejar los campos de entrada y salida propios del modelo. ## Qué admite Router @@ -102,7 +103,7 @@ Para consultar un precio antes de una ejecución, llama a `POST /v2/models/{prov ## Modelos sin estimación previa -Router todavía no puede calcular de forma fiable el precio de una llamada a los modelos siguientes antes de ejecutarla, así que es posible que `/estimate` y el campo `estimate` de un envío en cola respondan `source: unknown` para ellos, aunque algunos pueden devolver una cifra para un cuerpo concreto. `unknown` significa que no se dio ninguna cifra, no que la ejecución sea gratis. Las reglas de [Cargos y uso de Comfy](#cargos-y-uso-de-comfy) siguen aplicándose: una ejecución con tu propia clave de proveedor no se factura a través de Comfy, y `X-Comfy-Credits-Used` es opcional, así que un encabezado faltante significa que no se informó del costo. Un modelo que no aparezca en esta lista puede responder igualmente `unknown` para un cuerpo concreto, así que revisa `source` en cada estimación. +Router todavía no puede calcular de forma fiable el precio de una llamada a los modelos siguientes antes de ejecutarla, así que espera que `/estimate` y el campo `estimate` de un envío en cola respondan `source: unknown` para ellos, aunque algunos pueden devolver una cifra para un cuerpo concreto. `unknown` significa que no se dio ninguna cifra, no que la ejecución sea gratis. Las reglas de [Cargos y uso de Comfy](#cargos-y-uso-de-comfy) siguen aplicándose: una ejecución con tu propia clave de proveedor no se factura a través de Comfy, y `X-Comfy-Credits-Used` es opcional, así que un encabezado faltante significa que no se informó del costo. Un modelo que no aparezca en esta lista puede responder igualmente `unknown` para un cuerpo concreto, así que revisa `source` en cada estimación. Esta lista se reduce a medida que crece la cobertura de estimaciones. Se genera a partir del propio código de precios de Router, y los modelos que no están disponibles públicamente nunca aparecen en ella. @@ -114,6 +115,7 @@ Esta lista se reduce a medida que crece la cobertura de estimaciones. Se genera - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` +- **minimax**: `minimax/minimax-gpt-image-2` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx b/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx index 6e141b21b7..389960eaff 100644 --- a/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx +++ b/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx @@ -2,14 +2,15 @@ title: "Usa Gemini Omni 1.1 Flash con Comfy Router" description: "Llama a gemini-interactions/gemini-omni-1.1-flash desde Comfy Router: endpoint, solicitud y respuesta." sidebarTitle: "Gemini Omni 1.1 Flash" -translationSourceHash: dffe4803 +translationSourceHash: ec7c74a1 translationFrom: development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx translationBlockHashes: "_intro": dcd3378f "Quick start": 3d2932d9 - "Schema": e342e0fc + "Schema": bb75398e "Examples": 02c0f0cf --- + {/* GENERATED FILE. Generated from router-schemas/gemini-interactions/gemini-omni-1.1-flash.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/gemini-interactions/gemini-omni-1.1-flash/r - Identificador del modelo Gemini: `gemini-omni-1.1-flash` (disponible de forma general) o el obsoleto `gemini-omni-flash-preview`. En la ruta `POST /v2/models/gemini-interactions/{model}` de Comfy Router se toma de la ruta y puedes omitirlo. Esas dos grafías (el conjunto al que Comfy Router se dirige como `gemini-interactions/`) son las que atiende esta operación (supportedGeminiInteractionModels); se escriben aquí en lugar de restringirse a un enum, porque el proxy valida el modelo por sí mismo y responde con su propio 400 a una grafía que no atiende. + Identificador del modelo Gemini: `gemini-omni-1.2-flash` o `gemini-omni-1.1-flash` (disponibles de forma general), o el obsoleto `gemini-omni-flash-preview`. En la ruta `POST /v2/models/gemini-interactions/{model}` de Comfy Router se toma de la ruta y puedes omitirlo. Esas tres grafías, el conjunto al que Comfy Router se dirige como `gemini-interactions/`, son las que atiende esta operación (supportedGeminiInteractionModels); se escriben aquí en lugar de restringirlas a un enum, porque el proxy valida el modelo por sí mismo y responde con su propio 400 a una grafía que no atiende. diff --git a/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx b/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx new file mode 100644 index 0000000000..8b64308386 --- /dev/null +++ b/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx @@ -0,0 +1,318 @@ +--- +title: "Usa Gemini Omni 1.2 Flash con Comfy Router" +description: "Llama a gemini-interactions/gemini-omni-1.2-flash con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Gemini Omni 1.2 Flash" +translationSourceHash: 686f287f +translationFrom: development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx +translationBlockHashes: + "_intro": 9d54919a + "Quick start": 596d24c7 + "Schema": 6e7adcfd + "Examples": 02c0f0cf +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/gemini-interactions/gemini-omni-1.2-flash.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API de `gemini-interactions/gemini-omni-1.2-flash`, que Comfy Router sirve desde Gemini Interactions. + +**Entrada:** Texto, Imagen, Audio, Video · **Salida:** Texto + Video + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. + +**ID del modelo:** `gemini-interactions/gemini-omni-1.2-flash` + +**Endpoint:** `POST https://api.comfy.org/v2/models/gemini-interactions/gemini-omni-1.2-flash` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "gemini-interactions/gemini-omni-1.2-flash", + { + "input": "Reply with the single word: ok", + "stream": False, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("gemini-interactions/gemini-omni-1.2-flash", { + input: "Reply with the single word: ok", + stream: false, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/gemini-interactions/gemini-omni-1.2-flash \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"input\": \"Reply with the single word: ok\", \"stream\": false}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/gemini-interactions/gemini-omni-1.2-flash/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "gemini-interactions/gemini-omni-1.2-flash", + { + "input": "Reply with the single word: ok", + "stream": False, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("gemini-interactions/gemini-omni-1.2-flash", { + input: "Reply with the single word: ok", + stream: false, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/gemini-interactions/gemini-omni-1.2-flash/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"input\": \"Reply with the single word: ok\", \"stream\": false}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/gemini-interactions/gemini-omni-1.2-flash/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se está ejecutando. +curl https://api.comfy.org/v2/models/gemini-interactions/gemini-omni-1.2-flash/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Una cadena de prompt o un arreglo de partes de contenido tipadas (texto, imagen, audio, video, documento). + + + + Identificador del modelo Gemini: `gemini-omni-1.2-flash` o `gemini-omni-1.1-flash` (disponibles de forma general), o el obsoleto `gemini-omni-flash-preview`. En la ruta de Comfy Router `POST /v2/models/gemini-interactions/{model}` se toma de la ruta y puede omitirse. Esas tres grafías, el conjunto que Comfy Router direcciona como `gemini-interactions/`, son las que sirve esta operación (supportedGeminiInteractionModels); se escriben aquí en lugar de restringirse a un enum, porque el proxy valida el modelo por su cuenta y responde con su propio 400 ante una grafía que no sirve. + + + + ID de una interacción almacenada previamente, que permite la edición de video con estado en varios turnos. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/gemini-interactions/gemini-omni-1.2-flash/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + + + + + + + + + + + + + Siempre `completed` en una respuesta de Router. Los demás estados del proveedor (`in_progress`, `requires_action`, `failed`, `cancelled`, `incomplete`, `budget_exceeded`) no llegan a quien llama a través de Router como un 200; se devuelven como un error de Comfy Router que incluye el cuerpo del proveedor. + + Valores posibles: `completed` + + + + La línea de tiempo de la interacción, en orden. Aquí se acota desde el `steps` sin tipar de `GeminiInteraction` para que la hoja de salida sea direccionable; el proveedor sigue agregando tipos de paso, así que un elemento es `additionalProperties: true` y solo se declaran los campos que lee quien llama a Router. + + + + Los bloques de contenido tipados de este paso. + + + + Medios en línea codificados en Base64, en un bloque de medios entregado en línea. Google limita los medios en línea a 4 MB y exige `delivery: uri` por encima de ese tamaño. + + + + Tipo de medio de `data` o `uri`, en un bloque de medios. + + + + El texto generado. Está presente en un bloque `text`, y esta es la hoja que verifica el caso nocturno del SDK de Router, concretamente en un paso `model_output` (`steps[type=model_output].content[].text`). + + + + Tipo de bloque: `text`, `image`, `audio`, `video` o `document`. + + + + Referencia a medios entregados por otra vía, que quien llama obtiene desde el URI que se indica. + + + + Tipo de paso. `model_output` es la respuesta generada; `user_input` es el turno de quien llama devuelto por la ruta de recuperación; `thought` es razonamiento interno. Los pasos de herramientas (`function_call`, `function_result`, `code_execution_call`, `google_search_call`, ...) son abiertos y Google los amplía. + + + + Uso de tokens de una interacción de Gemini. + + + + Conteo de tokens de una modalidad. + + + + Uno de `text`, `image`, `audio`, `video`, `document`. + + + + + + + + Conteo de tokens de una modalidad. + + + + Uno de `text`, `image`, `audio`, `video`, `document`. + + + + + + + + + + + + + + + + + + + + + + + + + + +## Ejemplos + +### Entrada + +```json +{ + "input": "Reply with the single word: ok", + "stream": false +} +``` + +### Salida + +```json +{ + "id": "interactions/3f6c1a90-2b47-4d18-9a55-7c0e8b21d4f3", + "object": "interaction", + "status": "completed", + "steps": [ + { + "content": [ + { + "text": "ok", + "type": "text" + } + ], + "type": "model_output" + } + ], + "usage": { + "input_tokens_by_modality": [ + { + "modality": "text", + "tokens": 9 + } + ], + "output_tokens_by_modality": [ + { + "modality": "text", + "tokens": 2 + } + ], + "total_cached_tokens": 0, + "total_input_tokens": 9, + "total_output_tokens": 2, + "total_thought_tokens": 0, + "total_tokens": 11 + } +} +``` + + + diff --git a/es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx b/es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx index 408aca38bb..997c88b8c6 100644 --- a/es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx +++ b/es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx @@ -2,14 +2,15 @@ title: "Usa Gemini Omni Flash Preview con Comfy Router" description: "Llama a gemini-interactions/gemini-omni-flash-preview mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Gemini Omni Flash Preview" -translationSourceHash: 5eba95d7 +translationSourceHash: 8f3097b3 translationFrom: development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx translationBlockHashes: "_intro": d6b56472 "Quick start": 8086eb99 - "Schema": 26cfad2e + "Schema": 5a4db106 "Examples": 02c0f0cf --- + {/* GENERATED FILE. Generated from router-schemas/gemini-interactions/gemini-omni-flash-preview.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/gemini-interactions/gemini-omni-flash-previ - Identificador del modelo Gemini: `gemini-omni-1.1-flash` (disponible de forma general), o el obsoleto `gemini-omni-flash-preview`. En la ruta de Comfy Router `POST /v2/models/gemini-interactions/{model}` se toma de la ruta y puede omitirse. Esas dos grafías, el conjunto al que Comfy Router se dirige como `gemini-interactions/`, son las que atiende esta operación (supportedGeminiInteractionModels); se escriben aquí en lugar de restringirlas a un enum, porque el proxy valida el modelo por sí mismo y responde con su propio 400 ante una grafía que no atiende. + Identificador del modelo Gemini: `gemini-omni-1.2-flash` o `gemini-omni-1.1-flash` (disponibles de forma general), o el obsoleto `gemini-omni-flash-preview`. En la ruta de Comfy Router `POST /v2/models/gemini-interactions/{model}` se toma de la ruta y puede omitirse. Esas tres grafías, el conjunto al que Comfy Router se dirige como `gemini-interactions/`, son las que atiende esta operación (supportedGeminiInteractionModels); se escriben aquí en lugar de restringirlas a un enum, porque el proxy valida el modelo por sí mismo y responde con su propio 400 ante una grafía que no atiende. diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx new file mode 100644 index 0000000000..394a344196 --- /dev/null +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -0,0 +1,355 @@ +--- +title: "Usa GPT Image 2.6 Flare con Comfy Router" +description: "Llama a openai/gpt-image-2.6-flare mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "GPT Image 2.6 Flare" +translationSourceHash: 9f6b894f +translationFrom: development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +translationBlockHashes: + "_intro": 1693e80a + "Quick start": 8222d9f4 + "Schema": 78f788c9 + "Examples": c73859ec +--- + +{/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.6-flare.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API de `openai/gpt-image-2.6-flare`, servido por Comfy Router desde OpenAI. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. + +**Model ID:** `openai/gpt-image-2.6-flare` + +**Endpoint:** `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "openai/gpt-image-2.6-flare", + { + "prompt": "a rocketship on a launchpad", + "quality": "low", + "size": "1024x1024", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("openai/gpt-image-2.6-flare", { + prompt: "a rocketship on a launchpad", + quality: "low", + size: "1024x1024", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"a rocketship on a launchpad\", \"quality\": \"low\", \"size\": \"1024x1024\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, ya sea desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica paso a paso el estado, la cancelación y la recogida del resultado. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "openai/gpt-image-2.6-flare", + { + "prompt": "a rocketship on a launchpad", + "quality": "low", + "size": "1024x1024", + }, + ) + print("request_id:", handle.request_id) # junto con el model ID, es todo lo que necesita otro proceso + + # Consulta el estado hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga nativa del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("openai/gpt-image-2.6-flare", { + prompt: "a rocketship on a launchpad", + quality: "low", + size: "1024x1024", +}); +console.log("requestId:", handle.requestId); // junto con el model ID, es todo lo que necesita otro proceso + +// Consulta el estado hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Enviar. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"a rocketship on a launchpad\", \"quality\": \"low\", \"size\": \"1024x1024\"}" + +# 2. Consultar el estado hasta que sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoger. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Transparencia del fondo. `auto` permite que el modelo elija. + + Valores posibles: `transparent`, `opaque`, `auto` + + + + La imagen o imágenes de origen que se van a editar. LA PRESENCIA DE ESTE CAMPO SELECCIONA LA OPERACIÓN DE EDICIÓN: omítelo por completo para la generación de texto a imagen. +El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` constituye toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), excepto que un prompt de edición describe el CAMBIO que deseas en lugar de la escena, así que el cuerpo de edición de abajo se lee distinto del ejemplo de generación aunque solo este campo sea estructuralmente nuevo. +Se puede copiar exactamente tal como está impreso: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`: la carga útil es un PNG de 1x1 completo, no una abreviatura, y este cuerpo está fijado como un caso aceptado en las pruebas de validación de solicitudes de Router. Sustituye los bytes por los de tu propia imagen. +Acepta una imagen o un array de ellas; gpt-image-1 y posteriores admiten hasta 16, y Router lo aplica desde este esquema antes de despachar. + + + + Una imagen, ya sea como una URL https que Router obtiene en nombre de quien llama o como un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto se APLICA en el momento de la resolución en lugar de dejarse al proveedor: un svg, gif, avif o tiff se rechaza aquí, nombrando la imagen que enviaste, en vez de convertirse en un error del socio a dos saltos de la causa. +Prefiere la forma con URL. Una carga útil base64 se infla aproximadamente 4/3 y el cuerpo completo de la solicitud está limitado a 100 MiB, así que la forma en línea se topa con cerca de una imagen de origen de 75 MB; una URL evita eso por completo. Los límites de medios por imagen y por solicitud indicados al final de esta descripción son más estrictos que el límite del cuerpo, así que para una imagen de cualquier tamaño real son los que encontrarás primero. +LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la obtiene del lado del servidor y no envía ninguna credencial de quien llama con la solicitud, así que una URL prefirmada (aquella cuya firma está en la cadena de consulta) es la forma admitida. Un endpoint autenticado como `/api/assets/{id}/content` responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. +LA OBTENCIÓN ESTÁ CONFINADA A UN CONJUNTO NOMBRADO DE HOSTS en lugar de a la internet abierta, y la misma lista se vuelve a aplicar a cada salto de redirección además de a la URL que envías: por eso una URL en cualquier otro host, o una que redirige fuera de la lista, se rechaza antes de contactar a cualquier proveedor. Hoy esa lista es únicamente el servicio de entrega de recursos de Comfy: una URL firmada de `storage.googleapis.com` dentro de un bucket de recursos de Comfy, que es la forma a la que `/api/assets/{id}/content` te redirige. Un CDN de un socio o un host https simple NO está en la lista. +DOS AMPLIACIONES SE ESTÁN DESPLEGANDO Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se lanzan detrás de UN solo interruptor y se habilitan juntas, así que considera todo lo que sigue como algo próximo y no como algo sobre lo que construir todavía: pregunta antes de depender de cualquiera de las dos. +La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que el despliegue llegue a tu entorno, una URL de carga de ese endpoint se rechaza aquí, aunque el bucket sea de Comfy y el host sea el mismo: por eso "sube a Comfy y luego pasa la URL" NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. +La SEGUNDA SE HABILITA POR CUENTA y no para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta a la que no se le han habilitado los medios entrantes de terceros se rechaza, y se le dice con esas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que la habilite para tu cuenta. Además admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama ninguna propiedad sobre él: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, tanto en la forma de estilo de ruta como en la prefijada con `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. +LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR: por eso nombrar un proveedor arriba NO significa que toda URL que ese proveedor pueda emitir se acepte, y vale la pena enunciar directamente tres casos que casi coinciden porque quien llama puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas.Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los que aparecen en la lista. +El ejemplo de abajo muestra solo la forma: un valor real también lleva los parámetros de consulta de firma, que aquí se omiten a propósito porque un ejemplo publicado vive en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. +Cada imagen está limitada a 25 MiB y el conjunto de imágenes de una petición a 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: ahí cada imagen puede ser de hasta 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y el conjunto de imágenes de una petición de hasta 128 MiB en total. + + + + El modelo gpt-image que se va a ejecutar. Router inserta el id del modelo direccionado, así que un llamador que apunta a /v2/models/openai/gpt-image-2 no envía esto. + + + + Ajuste de moderación de contenido + + Valores posibles: `low`, `auto` + + + + El número de imágenes a generar (1-10). + + Alcance: `1` a `10` + + + + Nivel de compresión para JPEG o WebP (0-100) + + Alcance: `0` a `100` + + + + Formato de la imagen de salida + + Valores posibles: `png`, `webp`, `jpeg` + + + + Solo tiene sentido junto con un stream en vivo, que esta superficie no puede servir: `stream` se fija a `false` incluso cuando lo envías. En una generación, cualquier valor distinto de `0` o `null` se rechaza con un 400, independientemente de que la petición también envíe `stream: true`; en una petición que lleva `image`, el campo se descarta en lugar de reenviarse. Omítelo. + + Alcance: `0` a `3` + + + + Una descripción de texto de la imagen a generar, o de la edición que se debe hacer a `image`. + + + + La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se añadieron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la era dall-e que ningún modelo admitido lee. + + Valores posibles: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` + + + + Tamaño de la imagen (p. ej., 1024x1024, 1536x1024, auto) + + + + Se declara para que un llamador que lo envíe no sea rechazado, pero es INERTE en esta superficie: Router lo FIJA a `false` antes del despacho, porque captura la respuesta del proveedor en lugar de retransmitir un `text/event-stream` (una petición que lleva `image` descarta el campo, ya que la edición se recodifica sin él). Ninguna superficie de Comfy sirve el streaming de imágenes parciales de gpt-image: la entrada v1 `POST /proxy/openai/images/generations` rechaza `stream: true` con un 400 y nunca reenvía la petición al proveedor, así que omite el campo y lee la respuesta completada como un único cuerpo JSON. Como el stream nunca se abre, la restricción de OpenAI sobre combinar `stream: true` con `n` mayor que 1 no aplica aquí; `n` se reenvía tal como se envía. + + + + Un identificador único para la monitorización de usuarios finales + + +Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-image-2.6-flare/openapi.json`, el mismo documento con el que valida una llamada antes de que la petición llegue al proveedor. + +### Salida + + + + + + + Datos de imagen codificados en Base64 + + + + prompt revisado + + + + URL de la imagen + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Indica si el fondo de la imagen generada es `opaque` o `transparent`, tal como OpenAI lo resolvió para esta generación. El parámetro de la solicitud tiene como valor predeterminado `auto`, así que aquí es donde quien llama sin fijarlo se entera de cuál se produjo. + + + + Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara como REQUIRED en una respuesta de generación de imágenes, así que está presente siempre que OpenAI es el productor; una respuesta servida por fal, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativas lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara como `int64` porque un valor de epoch actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. + + Formato: `int64` + + + + La codificación de los bytes en `data[].b64_json`: `png`, `webp` o `jpeg`. Es el formato que OpenAI codificó realmente, que es el `output_format` de la solicitud cuando se envió uno y `png` cuando no se envió ninguno, de modo que un decodificador puede basarse en él en lugar de volver a derivar el formato a partir de la solicitud. + + + + El nivel de calidad al que realmente se ejecutó la generación: OpenAI informa uno de `low`, `medium`, `high`, `xhigh` o `max`. Es el nivel RESUELTO, no un eco de la solicitud, cuyo propio `quality` tiene como valor predeterminado `auto`. + + + + Las dimensiones en píxeles a las que realmente se ejecutó la generación, como `x`. Es el tamaño RESUELTO: el `size` de la solicitud tiene como valor predeterminado `auto` y admite explícitamente `auto`, así que este es el único lugar donde se informan las dimensiones que realmente se usaron. + + +## Ejemplos + +### Entrada + +```json +{ + "prompt": "a rocketship on a launchpad", + "quality": "low", + "size": "1024x1024" +} +``` + +### Salida + +```json +{ + "created": 1767225600, + "data": [ + { + "b64_json": "PGJhc2U2ND4=" + } + ], + "usage": { + "input_tokens": 12, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 12 + }, + "output_tokens": 1056, + "total_tokens": 1068 + } +} +``` + + diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx new file mode 100644 index 0000000000..afeb5ccf72 --- /dev/null +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -0,0 +1,357 @@ +--- +title: "Usa GPT Image 2.6 Sunburst con Comfy Router" +description: "Llama a openai/gpt-image-2.6-sunburst con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "GPT Image 2.6 Sunburst" +translationSourceHash: e71f1905 +translationFrom: development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +translationBlockHashes: + "_intro": 280b9c93 + "Quick start": 2d3cb42c + "Schema": 2a71e1a8 + "Examples": c73859ec +--- +{/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.6-sunburst.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `openai/gpt-image-2.6-sunburst`, servido por Comfy Router desde OpenAI. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. + +**ID del modelo:** `openai/gpt-image-2.6-sunburst` + +**Endpoint:** `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "openai/gpt-image-2.6-sunburst", + { + "prompt": "a rocketship on a launchpad", + "quality": "low", + "size": "1024x1024", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("openai/gpt-image-2.6-sunburst", { + prompt: "a rocketship on a launchpad", + quality: "low", + size: "1024x1024", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"a rocketship on a launchpad\", \"quality\": \"low\", \"size\": \"1024x1024\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "openai/gpt-image-2.6-sunburst", + { + "prompt": "a rocketship on a launchpad", + "quality": "low", + "size": "1024x1024", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita + + # Sondea hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga del propio proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("openai/gpt-image-2.6-sunburst", { + prompt: "a rocketship on a launchpad", + quality: "low", + size: "1024x1024", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita + +// Sondea hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"a rocketship on a launchpad\", \"quality\": \"low\", \"size\": \"1024x1024\"}" + +# 2. Sondea hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se ejecuta. +curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Transparencia del fondo. `auto` permite que el modelo elija. + + Valores posibles: `transparent`, `opaque`, `auto` + + + + La o las imágenes de origen que se van a editar. LA PRESENCIA DE ESTE CAMPO SELECCIONA LA OPERACIÓN DE EDICIÓN: omítelo por completo para la generación de texto a imagen. +El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` es toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), salvo que un prompt de edición describe el CAMBIO que quieres en lugar de la escena, así que el cuerpo de edición de abajo se lee de forma distinta al ejemplo de generación, aunque solo este campo sea estructuralmente nuevo. +Se puede copiar exactamente como se muestra: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`; la carga útil es un PNG completo de 1x1, no una abreviatura, y este cuerpo está fijado como un caso aceptado en las propias pruebas de validación de solicitudes de Router. Sustituye los bytes por los de tu propia imagen. +Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta 16, y Router lo aplica desde este esquema antes de despachar. + + + + Una imagen, ya sea como una URL https que Router obtiene en nombre de quien llama, o como un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto se APLICA en el momento de resolución en lugar de dejarlo al proveedor: un svg, gif, avif o tiff se rechaza aquí, indicando la imagen que enviaste, en lugar de convertirse en un error del socio a dos saltos de la causa. +Prefiere la forma de URL. Una carga útil base64 se infla aproximadamente 4/3 y el cuerpo completo de la solicitud tiene un límite de 100 MiB, así que la forma en línea llega a su límite cerca de una imagen de origen de 75 MB; una URL evita eso por completo. Los límites de medios por imagen y por solicitud indicados al final de esta descripción son más estrictos que el límite del cuerpo, así que, para una imagen de cualquier tamaño real, son los que encuentras primero. +LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la obtiene del lado del servidor y no envía ninguna credencial de quien llama con la solicitud, así que una URL prefirmada (una cuya firma está en la cadena de consulta) es la forma admitida. Un endpoint autenticado como `/api/assets/{id}/content` responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. +LA OBTENCIÓN ESTÁ LIMITADA A UN CONJUNTO NOMBRADO DE HOSTS, no a la internet abierta, y la misma lista se vuelve a aplicar a cada salto de redirección y también a la URL que envías; por eso, una URL en cualquier otro host, o una que redirija fuera de la lista, se rechaza antes de contactar a cualquier proveedor. Hoy esa lista es solo la entrega de recursos propia de Comfy: una URL firmada de `storage.googleapis.com` dentro de un bucket de recursos de Comfy, que es la forma a la que te redirige `/api/assets/{id}/content`. Un CDN de un socio o un host https simple NO están en la lista. +DOS AMPLIACIONES SE ESTÁN DESPLEGANDO Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se entregan detrás de UN interruptor y se habilitan juntas, así que trata todo lo siguiente como algo próximo y no como algo sobre lo que construir todavía: pregunta antes de confiar en cualquiera de las dos. +La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que el despliegue llegue a tu entorno, una URL de carga de ese endpoint se rechaza aquí, aunque el bucket sea propio de Comfy y el host sea el mismo; por lo tanto, «subir a Comfy y luego pasar la URL» NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. +La SEGUNDA se HABILITA POR CUENTA, no para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso una vez que el interruptor anterior está activado, una cuenta a la que no se le han habilitado los medios entrantes de terceros se rechaza, y se le dice exactamente eso, en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que la habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, ya sea en la forma de estilo de ruta o con el prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de uso general en el mismo dominio del proveedor, como un disparador de Alibaba Function Compute, no está en la lista y se rechaza. +LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR; por lo tanto, nombrar un proveedor arriba NO significa que se acepte toda URL que ese proveedor pueda emitir, y vale la pena indicar directamente tres casos casi válidos, porque quien llama puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza. Firma previamente el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. + + +Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los que aparecen en la lista. +El ejemplo de abajo muestra solo la forma: un valor real también lleva los parámetros de consulta de firma, que aquí se omiten a propósito porque un ejemplo publicado vive en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. +Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: ahí cada imagen puede llegar hasta 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud hasta 128 MiB en total. + + + + El modelo gpt-image que se ejecutará. Router inserta el id del modelo direccionado, así que un llamador que apunta a /v2/models/openai/gpt-image-2 no envía esto. + + + + Ajuste de moderación de contenido + + Valores posibles: `low`, `auto` + + + + El número de imágenes a generar (1-10). + + Alcance: `1` a `10` + + + + Nivel de compresión para JPEG o WebP (0-100) + + Alcance: `0` a `100` + + + + Formato de la imagen de salida + + Valores posibles: `png`, `webp`, `jpeg` + + + + Significativo solo junto con un flujo en vivo, que esta superficie no puede servir: `stream` se fija en `false` incluso cuando lo envías. En una generación, cualquier valor distinto de `0` o `null` se rechaza con un 400, tanto si la solicitud también envía `stream: true` como si no; en una solicitud que lleva `image` el campo se descarta en lugar de reenviarse. Omítelo. + + Alcance: `0` a `3` + + + + Una descripción de texto de la imagen a generar, o de la edición que se hará a `image`. + + + + La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se añadieron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la era dall-e que ningún modelo admitido lee. + + Valores posibles: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` + + + + Tamaño de la imagen (p. ej., 1024x1024, 1536x1024, auto) + + + + Declarado para que un llamador que lo envía no sea rechazado, pero INERTE en esta superficie: Router lo FIJA en `false` antes del despacho, porque captura la respuesta del proveedor en lugar de retransmitir un `text/event-stream` (una solicitud que lleva `image` descarta el campo, ya que la edición se recodifica sin él). Ninguna superficie de Comfy sirve el streaming de imágenes parciales de gpt-image: la entrada v1 `POST /proxy/openai/images/generations` rechaza `stream: true` con un 400 y nunca reenvía la solicitud al proveedor, así que omite el campo y lee la respuesta completada como un solo cuerpo JSON. Como el flujo nunca se abre, la restricción de OpenAI de combinar `stream: true` con un `n` mayor que 1 no aplica aquí; `n` se reenvía tal como se envía. + + + + Un identificador único para el monitoreo de usuarios finales + + +Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + + + + + Datos de imagen codificados en Base64 + + + + Prompt revisado + + + + URL de la imagen + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Indica si el fondo de la imagen generada es `opaque` o `transparent`, tal como OpenAI lo resolvió para esta generación. El parámetro de la solicitud usa `auto` de forma predeterminada, así que aquí es donde quien no lo ancló descubre cuál se produjo. + + + + Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara como REQUERIDO en una respuesta de generación de imágenes, así que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativas lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. + + Formato: `int64` + + + + La codificación de los bytes en `data[].b64_json`: `png`, `webp` o `jpeg`. Es el formato que OpenAI realmente codificó, que es el `output_format` de la solicitud cuando se envió uno y `png` cuando no se envió ninguno, así que un decodificador puede basarse en él en lugar de volver a derivar el formato desde la solicitud. + + + + El nivel de calidad con el que realmente se ejecutó la generación: OpenAI informa uno de `low`, `medium`, `high`, `xhigh` o `max`. Es el nivel RESUELTO, no un eco de la solicitud, cuyo propio `quality` usa `auto` por defecto. + + + + Las dimensiones en píxeles con las que realmente se ejecutó la generación, como `x`. Es el tamaño RESUELTO: el `size` de la solicitud usa `auto` por defecto y admite `auto` explícitamente, así que este es el único lugar donde se informan las dimensiones realmente usadas. + + +## Ejemplos + +### Entrada + +```json +{ + "prompt": "a rocketship on a launchpad", + "quality": "low", + "size": "1024x1024" +} +``` + +### Salida + +```json +{ + "created": 1767225600, + "data": [ + { + "b64_json": "PGJhc2U2ND4=" + } + ], + "usage": { + "input_tokens": 12, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 12 + }, + "output_tokens": 1056, + "total_tokens": 1068 + } +} +``` + + diff --git a/es/development/comfy-router/models/openai/gpt-image-2/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2/code.mdx index 3a8a8651fc..26cb0c2f73 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,15 +2,16 @@ title: "Usa GPT Image 2 con Comfy Router" description: "Llama a openai/gpt-image-2 a través de Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "GPT Image 2" -translationSourceHash: b9cb8af5 +translationSourceHash: 2fe15764 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 - "Serving providers": 56df172f + "Serving providers": f3930e40 "Schema": 4e6e5e53 "Examples": c73859ec --- + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -156,11 +157,12 @@ Comfy Router sirve este modelo directamente a menos que la solicitud indique otr - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/openai/gpt-image-2` - **fal**, como `fal/fal-gpt-image-2`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=fal` +- **MiniMax**, como `minimax/minimax-gpt-image-2`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=minimax` - **Pika**, como `pika/pika-gpt-image-2`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=pika` - **Runware**, como `runware/runware-gpt-image-2`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=runware` - **WaveSpeed**, como `wavespeed/wavespeed-gpt-image-2`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=wavespeed` -`strict_mode` tiene como valor predeterminado false, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para ver todos los modelos enrutados de esta forma. +`strict_mode` es falso de forma predeterminada, así que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para ver todos los modelos enrutados de esta forma. ## Esquema diff --git a/es/development/comfy-router/providers.mdx b/es/development/comfy-router/providers.mdx index 076b93bc30..cf708e4347 100644 --- a/es/development/comfy-router/providers.mdx +++ b/es/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Proveedores de servicio de Comfy Router" sidebarTitle: "Proveedores de servicio" description: "Consulta qué proveedores pueden servir cada modelo de Comfy Router y cómo seleccionar otro proveedor." -translationSourceHash: 58636da1 +translationSourceHash: 2e5f5f1e translationFrom: development/comfy-router/providers.mdx --- @@ -14,17 +14,21 @@ Todos los modelos usan `POST /v2/models/{provider}/{model}`. Comfy es el proveed ## Cobertura de proveedores -| Modelo / proveedor | **Comfy (predeterminado)** | **fal** | **Higgsfield** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | -| --- | --- | --- | --- | --- | --- | --- | --- | -| [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | ✓ | ✓ | - | ✓ | -| [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | - | ✓ | - | ✓ | -| [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | -| [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | -| [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | -| [Kling 3.0 Turbo](/es/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | -| [Kling V3](/es/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | ✓ | - | -| [Nano Banana 2](/es/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | -| [Nano Banana Pro](/es/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | -| [Wan 3.0 Video](/es/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | +| Modelo / proveedor | **Comfy (predeterminado)** | **fal** | **Higgsfield** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | +| [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | +| [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | +| [Gemini 2.5 Flash Image](/es/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | ✓ | - | - | - | - | +| [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | ✓ | - | - | - | - | +| [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | +| [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | +| [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | +| [Kling 3.0 Turbo](/es/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | +| [Kling V3](/es/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | ✓* | - | +| [Nano Banana 2](/es/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | +| [Nano Banana Pro](/es/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | +| [Wan 3.0 Video](/es/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | + +\* Este proveedor sirve el modelo con límites más restringidos que el predeterminado; consulta la página del modelo. `strict_mode=false` (el valor predeterminado) traduce la solicitud y la respuesta nativas del proveedor seleccionado. Los campos que no se pueden traducir se enumeran en el encabezado de respuesta `X-Comfy-Router-Dropped-Params`. \ No newline at end of file diff --git a/es/tutorials/basic/text-to-image.mdx b/es/tutorials/basic/text-to-image.mdx index 56189f835e..8e56b43d13 100644 --- a/es/tutorials/basic/text-to-image.mdx +++ b/es/tutorials/basic/text-to-image.mdx @@ -13,6 +13,8 @@ translationBlockHashes: "Introduction to SD1.5 Model": cd91e138 --- + + Esta guía tiene como objetivo presentarte el flujo de trabajo de texto a imagen de ComfyUI y ayudarte a comprender la funcionalidad y el uso de los distintos nodos de ComfyUI. En este documento, vamos a: @@ -127,6 +129,7 @@ Prompts negativos: ``` blurry, low detail, cartoonish, unrealistic anatomy, out of focus, cluttered, flat lighting ``` + ## ¿Cómo funciona el texto a imagen? {#text-to-image-working-principles} Todo el proceso de texto a imagen se puede entender como un **proceso de difusión inversa**. El [v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors) que descargamos es un modelo preentrenado que puede **generar imágenes objetivo a partir de ruido gaussiano puro**. Solo tenemos que introducir nuestros prompts y puede generar imágenes objetivo eliminando el ruido aleatorio. diff --git a/es/tutorials/video/ltx/ltx-2-3.mdx b/es/tutorials/video/ltx/ltx-2-3.mdx index 3af9dd7211..6830d04147 100644 --- a/es/tutorials/video/ltx/ltx-2-3.mdx +++ b/es/tutorials/video/ltx/ltx-2-3.mdx @@ -2,20 +2,22 @@ title: "LTX-2.3 en ComfyUI: flujos de video y audio" description: "Usa LTX-2.3 en ComfyUI con flujos nativos para texto a video, imagen a video, FLF2V, video controlado por audio, control IC-LoRA y personalización ID-LoRA." sidebarTitle: "LTX-2.3" -translationSourceHash: 2e21405a +translationSourceHash: 38dec879 translationFrom: tutorials/video/ltx/ltx-2-3.mdx translationBlockHashes: "_intro": 2afce33d "Key features": 3ddea9bd "Getting started": 8bd36b77 + "Choosing a template workflow": b1568fc8 "ComfyUI Native Workflows": fb09a224 "Prompting tips": f92227b7 "Resources": 3f045765 --- + import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; -[LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3) es la última evolución del modelo de generación de audio y video de código abierto de Lightricks, ahora compatible de forma nativa con ComfyUI. Tomando como base LTX-2, esta versión ofrece mejoras importantes de calidad en los detalles finos, el video de retrato, la calidad de audio, la consistencia de imagen a video, la comprensión de prompts y el renderizado de texto. +[LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3) es la última evolución del modelo de generación de audio y video de código abierto de Lightricks, ahora compatible de forma nativa con ComfyUI. Sobre la base de LTX-2, esta versión ofrece mejoras importantes en la calidad de los detalles finos, el video de retrato, la calidad de audio, la consistencia de imagen a video, la comprensión de prompts y el renderizado de texto. ComfyUI incluye seis flujos de trabajo nativos para LTX-2.3, cada uno diseñado para un modo de generación específico: @@ -45,6 +47,31 @@ LTX-2.3 es compatible de forma nativa con ComfyUI. Para empezar: 2. Ve a **Biblioteca de plantillas** > **Video** > elige cualquier flujo de trabajo de LTX-2.3 3. Sigue las indicaciones de la ventana emergente para descargar los modelos y ejecutar el flujo de trabajo +## Elegir un flujo de trabajo de plantilla + +En **Template Library** > **Video** se incluyen seis plantillas nativas de LTX-2.3 (ejemplos, no una lista exhaustiva). + + + + Prompts de texto con mejor comprensión del prompt y renderizado de texto. + + + Anima una imagen fija con un movimiento más fluido. + + + Interpola entre una imagen inicial y una imagen final. + + + Video con sincronización labial a partir de una imagen y un clip de audio. + + + Orientación mediante video de control de profundidad, pose, bordes u otros. + + + Video personalizado con audio sincronizado a partir de una imagen de referencia y una voz. + + + ## Elegir una plantilla de flujo de trabajo ComfyUI incluye seis plantillas nativas de LTX-2.3 en **Biblioteca de plantillas** > **Video** (ejemplos, no una lista exhaustiva). @@ -609,17 +636,9 @@ ComfyUI/ │ └── ltx-2.3-spatial-upscaler-x2-1.1.safetensors ``` -## Consejos para los prompts - -Cuando escribas prompts para LTX-2.3, enfócate en descripciones detalladas y cronológicas de las acciones y las escenas: - -1. **Acciones principales**: Describe los eventos y las acciones tal como ocurren a lo largo del tiempo -2. **Detalles visuales**: Describe todos los detalles visuales que quieras que aparezcan en el video -3. **Audio**: Describe los sonidos y el diálogo que necesita la escena - ## Recursos -- [Modelo de Hugging Face](https://huggingface.co/Lightricks/LTX-2.3) -- [Repositorio de GitHub](https://github.com/Lightricks/LTX-2) +- [Modelo en Hugging Face](https://huggingface.co/Lightricks/LTX-2.3) +- [Repositorio en GitHub](https://github.com/Lightricks/LTX-2) - [ComfyUI-LTXVideo](https://github.com/Lightricks/ComfyUI-LTXVideo/) - [Modelo IC-LoRA](https://huggingface.co/Lightricks/LTX-2.3-22b-IC-LoRA-Union-Control) From 006df63b6fae9c0bab0e06734f966ad84cc35365 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:25:07 +0800 Subject: [PATCH 11/36] i18n(es): repair duplicated schema fields and stale sections; sync text-to-image link --- .../openai/gpt-image-2-6-sunburst/code.mdx | 2 - .../models/wan/happyhorse-1-0-t2v/code.mdx | 2 - .../models/wan/happyhorse-1-1-t2v/code.mdx | 3 - .../models/wan/wan2-7-i2v/code.mdx | 14 ---- .../models/wan/wan2-7-r2v/code.mdx | 2 - .../models/wan/wan3-0-video-prime/code.mdx | 2 - es/tutorials/basic/text-to-image.mdx | 6 +- es/tutorials/video/ltx/ltx-2-3.mdx | 67 +++---------------- ja/tutorials/basic/text-to-image.mdx | 2 +- ko/tutorials/basic/text-to-image.mdx | 2 +- 10 files changed, 15 insertions(+), 87 deletions(-) diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index afeb5ccf72..80819a3310 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -180,8 +180,6 @@ LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR; por lo tanto, Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los que aparecen en la lista. El ejemplo de abajo muestra solo la forma: un valor real también lleva los parámetros de consulta de firma, que aquí se omiten a propósito porque un ejemplo publicado vive en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: ahí cada imagen puede llegar hasta 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud hasta 128 MiB en total. - - El modelo gpt-image que se ejecutará. Router inserta el id del modelo direccionado, así que un llamador que apunta a /v2/models/openai/gpt-image-2 no envía esto. diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index c8b4ac346f..4b5c6791fc 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -209,8 +209,6 @@ Los recuentos por modelo anteriores son restricciones del socio, no de este esqu el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. - - Tipo de recurso multimedia diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index 2462c403f2..94c52a8345 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -351,9 +351,6 @@ Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -En los modelos wan2.7, se toma un valor predeterminado según el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una - Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, se usa un valor predeterminado según el nivel de resolución si no se proporciona. Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. diff --git a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 5551f6cae3..f1d1ef472e 100644 --- a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -368,20 +368,6 @@ Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. Alcance: `-1` a `30` - - Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero - - - - Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. -En los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente untotal del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita - el modo de duración inteligente, en el que el modelo elige una duración adecuada -Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. - - Rango: de `-1` a `30` - - Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es true diff --git a/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index 79d176504a..ff6f6350e1 100644 --- a/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -305,8 +305,6 @@ acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. - - Tipo de recurso multimedia diff --git a/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index 091d586601..74a0027202 100644 --- a/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -274,8 +274,6 @@ un único recurso en el propio del socio the transport ceiling binds across several of them, since the 100 MiB Router cap bounds the WHOLE request rather than each element. Envía como URL pública cualquier cosa que se acerque a estos techos. - - Tipo de recurso multimedia diff --git a/es/tutorials/basic/text-to-image.mdx b/es/tutorials/basic/text-to-image.mdx index 8e56b43d13..6613a16b3a 100644 --- a/es/tutorials/basic/text-to-image.mdx +++ b/es/tutorials/basic/text-to-image.mdx @@ -2,12 +2,12 @@ title: "Flujo de trabajo de texto a imagen en ComfyUI" description: "Crea un flujo de trabajo de texto a imagen en ComfyUI: carga el flujo predeterminado, instala un checkpoint SD1.5, escribe prompts y aprende qué hace cada nodo." sidebarTitle: "Texto a imagen" -translationSourceHash: af5280d9 +translationSourceHash: 08606cb0 translationFrom: tutorials/basic/text-to-image.mdx translationBlockHashes: "_intro": 7f6b5c90 "What is text-to-image in ComfyUI? {#about-text-to-image}": 4bc00444 - "ComfyUI Text to Image Workflow Example Guide": d5496194 + "ComfyUI Text to Image Workflow Example Guide": 3532b705 "How does text-to-image work? {#text-to-image-working-principles}": 827d5189 "ComfyUI Text to Image Workflow Node Explanation": 1978408d "Introduction to SD1.5 Model": cd91e138 @@ -42,7 +42,7 @@ Puedes entender este proceso de generación de texto a imagen simplemente como d Asegúrate de tener al menos un archivo de modelo SD1.5 en tu carpeta `ComfyUI/models/checkpoints`, por ejemplo [v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors) -Si aún no lo has instalado, consulta la sección de instalación de modelos en [Primeros pasos con la generación de arte con IA de ComfyUI](/es/get_started/first_generation). +Si aún no lo has instalado, sigue [Descargar el modelo](/es/get_started/first_generation#descargar-el-modelo). ### 2. Cargar el flujo de trabajo Texto a imagen diff --git a/es/tutorials/video/ltx/ltx-2-3.mdx b/es/tutorials/video/ltx/ltx-2-3.mdx index 6830d04147..30de5d969b 100644 --- a/es/tutorials/video/ltx/ltx-2-3.mdx +++ b/es/tutorials/video/ltx/ltx-2-3.mdx @@ -2,14 +2,14 @@ title: "LTX-2.3 en ComfyUI: flujos de video y audio" description: "Usa LTX-2.3 en ComfyUI con flujos nativos para texto a video, imagen a video, FLF2V, video controlado por audio, control IC-LoRA y personalización ID-LoRA." sidebarTitle: "LTX-2.3" -translationSourceHash: 38dec879 +translationSourceHash: a1ba82c9 translationFrom: tutorials/video/ltx/ltx-2-3.mdx translationBlockHashes: "_intro": 2afce33d "Key features": 3ddea9bd "Getting started": 8bd36b77 "Choosing a template workflow": b1568fc8 - "ComfyUI Native Workflows": fb09a224 + "ComfyUI Native Workflows": 0a450aa5 "Prompting tips": f92227b7 "Resources": 3f045765 --- @@ -47,31 +47,6 @@ LTX-2.3 es compatible de forma nativa con ComfyUI. Para empezar: 2. Ve a **Biblioteca de plantillas** > **Video** > elige cualquier flujo de trabajo de LTX-2.3 3. Sigue las indicaciones de la ventana emergente para descargar los modelos y ejecutar el flujo de trabajo -## Elegir un flujo de trabajo de plantilla - -En **Template Library** > **Video** se incluyen seis plantillas nativas de LTX-2.3 (ejemplos, no una lista exhaustiva). - - - - Prompts de texto con mejor comprensión del prompt y renderizado de texto. - - - Anima una imagen fija con un movimiento más fluido. - - - Interpola entre una imagen inicial y una imagen final. - - - Video con sincronización labial a partir de una imagen y un clip de audio. - - - Orientación mediante video de control de profundidad, pose, bordes u otros. - - - Video personalizado con audio sincronizado a partir de una imagen de referencia y una voz. - - - ## Elegir una plantilla de flujo de trabajo ComfyUI incluye seis plantillas nativas de LTX-2.3 en **Biblioteca de plantillas** > **Video** (ejemplos, no una lista exhaustiva). @@ -99,12 +74,6 @@ ComfyUI incluye seis plantillas nativas de LTX-2.3 en **Biblioteca de plantillas ## Flujos de trabajo nativos de ComfyUI -### LTX-2.3 Texto a video (T2V) - -Genera videos a partir de prompts de texto con una mejor comprensión de los prompts y renderizado de texto. - - - ### LTX-2.3 Texto a video {#video_ltx2_3_t2v} Genera videos a partir de prompts de texto con mejor comprensión de prompts y renderizado de texto. @@ -164,12 +133,6 @@ ComfyUI/ --- -### LTX-2.3 Imagen a video (I2V) - -Genera videos a partir de una imagen de entrada con un movimiento más consistente y animaciones más fluidas. - - - ### LTX-2.3 Imagen a video {#video_ltx2_3_i2v} Genera videos a partir de una imagen de entrada con una consistencia de movimiento mejorada. @@ -231,12 +194,6 @@ ComfyUI/ --- -### LTX-2.3 FLF2V - -Interpola entre una imagen inicial y una imagen final para generar una transición de video suave. - - - ### LTX-2.3: convertir de primer y último fotograma a video {#video_ltx2_3_flf2v} Interpola entre una imagen inicial y una final. @@ -285,12 +242,6 @@ ComfyUI/ │ └── gemma_3_12B_it_fp4_mixed.safetensors ``` -### LTX-2.3 Imagen y audio a video (IA2V) - -Sube una imagen y un archivo de audio para generar un video de alta calidad con movimientos de labios sincronizados. - - - ### LTX-2.3 Imagen y audio a video {#video_ltx2_3_ia2v} Genera videos con sincronización de labios a partir de una imagen y un audio. @@ -570,12 +521,6 @@ Remove subtitles, captions, and related text occlusions from the video, restorin --- -### LTX-2.3 ID-LoRA - -Genera videos personalizados con audio sincronizado a partir de un prompt de texto, una imagen de referencia y un clip de audio corto. Usa ID-LoRA para adaptar la apariencia y la voz de una persona en un solo modelo generativo. - - - ### LTX-2.3 ID LoRA {#video_ltx2_3_id_lora} Genera videos personalizados con audio sincronizado a partir de una imagen de referencia y un clip de audio. @@ -636,6 +581,14 @@ ComfyUI/ │ └── ltx-2.3-spatial-upscaler-x2-1.1.safetensors ``` +## Sugerencias de prompts + +Al escribir prompts para LTX-2.3, describe las acciones y las escenas con detalle y en orden cronológico: + +1. **Acciones principales**: describe los eventos y las acciones tal como ocurren a lo largo del tiempo +2. **Detalles visuales**: describe todos los detalles visuales que quieres que aparezcan en el video +3. **Audio**: describe los sonidos y el diálogo que necesita la escena + ## Recursos - [Modelo en Hugging Face](https://huggingface.co/Lightricks/LTX-2.3) diff --git a/ja/tutorials/basic/text-to-image.mdx b/ja/tutorials/basic/text-to-image.mdx index b86aa9dd1a..740199b103 100644 --- a/ja/tutorials/basic/text-to-image.mdx +++ b/ja/tutorials/basic/text-to-image.mdx @@ -41,7 +41,7 @@ translationBlockHashes: `ComfyUI/models/checkpoints` フォルダ内に、少なくとも1つのSD1.5モデルファイル(例:[v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors))が存在することを確認してください。 -まだインストールしていない場合は、[ComfyUIによるAIアート生成の始め方](/ja/get_started/first_generation#download-the-model) の「モデルのインストール」セクションをご参照ください。 +まだインストールしていない場合は、[モデルをダウンロード](/ja/get_started/first_generation#download-the-model) をご参照ください。 ### 2. テキストから画像へワークフローの読み込み diff --git a/ko/tutorials/basic/text-to-image.mdx b/ko/tutorials/basic/text-to-image.mdx index 34fa60652a..d46a70859a 100644 --- a/ko/tutorials/basic/text-to-image.mdx +++ b/ko/tutorials/basic/text-to-image.mdx @@ -41,7 +41,7 @@ translationBlockHashes: `ComfyUI/models/checkpoints` 폴더에 최소 한 개의 SD1.5 모델 파일이 있는지 확인하세요. 예를 들어 [v1-5-pruned-emaonly-fp16.safetensors](https://huggingface.co/Comfy-Org/stable-diffusion-v1-5-archive/blob/main/v1-5-pruned-emaonly-fp16.safetensors)가 있습니다. -아직 설치하지 않았다면, [ComfyUI AI 아트 생성 시작하기](/ko/get_started/first_generation#download-the-model)의 모델 설치 섹션을 참고해 주세요. +아직 설치하지 않았다면 [모델 다운로드](/ko/get_started/first_generation#download-the-model)를 참고하세요. ### 2. 텍스트 기반 이미지 생성 워크플로우 로드하기 From 26f7c8c76c0349964c118fd0a5c0b6026e5ecb4a Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Tue, 10 Nov 2026 12:25:21 +0800 Subject: [PATCH 12/36] i18n(es): regenerate router pricing page for the newly localized code pages --- es/development/comfy-router/pricing.mdx | 176 ++++++++++++------------ 1 file changed, 88 insertions(+), 88 deletions(-) diff --git a/es/development/comfy-router/pricing.mdx b/es/development/comfy-router/pricing.mdx index a7b2250360..0fc2b784d5 100644 --- a/es/development/comfy-router/pricing.mdx +++ b/es/development/comfy-router/pricing.mdx @@ -29,8 +29,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | --- | --- | ---: | ---: | | [Gemini 2.5 Flash Image](/es/development/comfy-router/models/google/gemini-2-5-flash-image/code) | `vertexai/gemini-2.5-flash-image` | Imagen / Texto / Video: 63.3
Audio: 211 | Texto: 527.5
Imagen: 6330 | | [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | `vertexai/gemini-nano-banana-2.1` | Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2262.975
Imagen: 9051.9 | -| [GPT Image 2.6 Flare](/es/development/comfy-router/models) | `openai/gpt-image-2.6-flare` | Texto: 1508.65
Imagen: 2413.84 | Imagen: 9051.9 | -| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models) | `openai/gpt-image-2.6-sunburst` | Texto: 1508.65
Imagen: 2413.84 | Imagen: 9051.9 | +| [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | `openai/gpt-image-2.6-flare` | Texto: 1508.65
Imagen: 2413.84 | Imagen: 9051.9 | +| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | `openai/gpt-image-2.6-sunburst` | Texto: 1508.65
Imagen: 2413.84 | Imagen: 9051.9 | | [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | Texto: 1508.65
Imagen: 2413.84 | Texto: 3017.3
Imagen: 9051.9 | | [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | Texto: 1508.65
Imagen: 2413.84 | Texto: 3017.3
Imagen: 9051.9 | | [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | Texto: 1055
Imagen: 1688 | Texto: 2110
Imagen: 6752 | @@ -88,20 +88,20 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Seedream 4.5](/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code) | `byteplus/seedream-4-5-251128` | 8.44 | | [Seedream 5.0](/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | 7.385 | | [Seedream 5.0 Flash](/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code) | `byteplus/seedream-5-0-flash-260915` | 5.4311 | -| [Control Sketch](/es/development/comfy-router/models) | `stability/control-sketch` | 10.55 | -| [Control Structure](/es/development/comfy-router/models) | `stability/control-structure` | 10.55 | -| [Control Style](/es/development/comfy-router/models) | `stability/control-style` | 10.55 | -| [Control Style Transfer](/es/development/comfy-router/models) | `stability/control-style-transfer` | 16.88 | -| [Edit Erase](/es/development/comfy-router/models) | `stability/edit-erase` | 10.55 | -| [Edit Inpaint](/es/development/comfy-router/models) | `stability/edit-inpaint` | 10.55 | -| [Edit Outpaint](/es/development/comfy-router/models) | `stability/edit-outpaint` | 8.44 | -| [Edit Remove Background](/es/development/comfy-router/models) | `stability/edit-remove-background` | 10.55 | -| [Edit Replace Background And Relight](/es/development/comfy-router/models) | `stability/edit-replace-background-and-relight` | 16.88 | -| [Edit Search And Recolor](/es/development/comfy-router/models) | `stability/edit-search-and-recolor` | 10.55 | -| [Edit Search And Replace](/es/development/comfy-router/models) | `stability/edit-search-and-replace` | 10.55 | +| [Control Sketch](/es/development/comfy-router/models/stability/control-sketch/code) | `stability/control-sketch` | 10.55 | +| [Control Structure](/es/development/comfy-router/models/stability/control-structure/code) | `stability/control-structure` | 10.55 | +| [Control Style](/es/development/comfy-router/models/stability/control-style/code) | `stability/control-style` | 10.55 | +| [Control Style Transfer](/es/development/comfy-router/models/stability/control-style-transfer/code) | `stability/control-style-transfer` | 16.88 | +| [Edit Erase](/es/development/comfy-router/models/stability/edit-erase/code) | `stability/edit-erase` | 10.55 | +| [Edit Inpaint](/es/development/comfy-router/models/stability/edit-inpaint/code) | `stability/edit-inpaint` | 10.55 | +| [Edit Outpaint](/es/development/comfy-router/models/stability/edit-outpaint/code) | `stability/edit-outpaint` | 8.44 | +| [Edit Remove Background](/es/development/comfy-router/models/stability/edit-remove-background/code) | `stability/edit-remove-background` | 10.55 | +| [Edit Replace Background And Relight](/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code) | `stability/edit-replace-background-and-relight` | 16.88 | +| [Edit Search And Recolor](/es/development/comfy-router/models/stability/edit-search-and-recolor/code) | `stability/edit-search-and-recolor` | 10.55 | +| [Edit Search And Replace](/es/development/comfy-router/models/stability/edit-search-and-replace/code) | `stability/edit-search-and-replace` | 10.55 | | [Fibo](/es/development/comfy-router/models/bria/fibo/code) | `bria/fibo` | 8.44 | -| [Generate Core](/es/development/comfy-router/models) | `stability/generate-core` | 6.33 | -| [Generate Ultra](/es/development/comfy-router/models) | `stability/generate-ultra` | 16.88 | +| [Generate Core](/es/development/comfy-router/models/stability/generate-core/code) | `stability/generate-core` | 6.33 | +| [Generate Ultra](/es/development/comfy-router/models/stability/generate-ultra/code) | `stability/generate-ultra` | 16.88 | | [Image](/es/development/comfy-router/models/bria/image/code) | `bria/image` | 12.0692 | | [Add Object By Text](/es/development/comfy-router/models/bria/image-edit-add-object-by-text/code) | `bria/image-edit-add-object-by-text` | 12.0692 | | [Erase](/es/development/comfy-router/models/bria/image-edit-erase/code) | `bria/image-edit-erase` | 6.0346 | @@ -119,17 +119,17 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Replace Object By Text](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code) | `bria/image-edit-replace-object-by-text` | 12.0692 | | [Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code) | `bria/image-edit-reseason` | 12.0692 | | [Restore](/es/development/comfy-router/models/bria/image-edit-restore/code) | `bria/image-edit-restore` | 12.0692 | -| [Sd3.5 Flash](/es/development/comfy-router/models) | `stability/sd3.5-flash` | 5.275 | -| [Sd3.5 Large](/es/development/comfy-router/models) | `stability/sd3.5-large` | 13.715 | -| [Sd3.5 Large Turbo](/es/development/comfy-router/models) | `stability/sd3.5-large-turbo` | 8.44 | -| [Sd3.5 Medium](/es/development/comfy-router/models) | `stability/sd3.5-medium` | 7.385 | -| [Upscale Conservative](/es/development/comfy-router/models) | `stability/upscale-conservative` | 84.4 | -| [Upscale Creative](/es/development/comfy-router/models) | `stability/upscale-creative` | 126.6 | -| [Upscale Fast](/es/development/comfy-router/models) | `stability/upscale-fast` | 4.22 | +| [Sd3.5 Flash](/es/development/comfy-router/models/stability/sd3-5-flash/code) | `stability/sd3.5-flash` | 5.275 | +| [Sd3.5 Large](/es/development/comfy-router/models/stability/sd3-5-large/code) | `stability/sd3.5-large` | 13.715 | +| [Sd3.5 Large Turbo](/es/development/comfy-router/models/stability/sd3-5-large-turbo/code) | `stability/sd3.5-large-turbo` | 8.44 | +| [Sd3.5 Medium](/es/development/comfy-router/models/stability/sd3-5-medium/code) | `stability/sd3.5-medium` | 7.385 | +| [Upscale Conservative](/es/development/comfy-router/models/stability/upscale-conservative/code) | `stability/upscale-conservative` | 84.4 | +| [Upscale Creative](/es/development/comfy-router/models/stability/upscale-creative/code) | `stability/upscale-creative` | 126.6 | +| [Upscale Fast](/es/development/comfy-router/models/stability/upscale-fast/code) | `stability/upscale-fast` | 4.22 | | [Kling Image O1](/es/development/comfy-router/models/kling/kling-image-o1/code) | `kling/kling-image-o1` | 5.908 | -| [Sdxl 1.0 Image To Image](/es/development/comfy-router/models) | `stability/sdxl-1.0-image-to-image` | 1.899 | -| [Sdxl 1.0 Masking](/es/development/comfy-router/models) | `stability/sdxl-1.0-masking` | 1.899 | -| [Sdxl 1.0 Text To Image](/es/development/comfy-router/models) | `stability/sdxl-1.0-text-to-image` | 1.899 | +| [Sdxl 1.0 Image To Image](/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code) | `stability/sdxl-1.0-image-to-image` | 1.899 | +| [Sdxl 1.0 Masking](/es/development/comfy-router/models/stability/sdxl-1-0-masking/code) | `stability/sdxl-1.0-masking` | 1.899 | +| [Sdxl 1.0 Text To Image](/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code) | `stability/sdxl-1.0-text-to-image` | 1.899 | | [Wan 2.5 I2I Preview](/es/development/comfy-router/models/wan/wan2-5-i2i-preview/code) | `wan/wan2.5-i2i-preview` | 6.33 | | [Wan 2.5 T2I Preview](/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code) | `wan/wan2.5-t2i-preview` | 6.33 | @@ -361,7 +361,7 @@ La exportación EXR de Ray 3.2 todavía no está disponible. Deja `exr_export` d | [HappyHorse 1.1 I2V](/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code) | `wan/happyhorse-1.1-i2v` | - | 42.2422 / s | 54.3114 / s | - | - | | [HappyHorse 1.1 R2V](/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code) | `wan/happyhorse-1.1-r2v` | - | 42.2422 / s | 54.3114 / s | - | - | | [HappyHorse 1.1 T2V](/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code) | `wan/happyhorse-1.1-t2v` | - | 42.2422 / s | 54.3114 / s | - | - | -| [Kling 4.0](/es/development/comfy-router/models) | `kling/kling-4.0` | - | 47.37161 / s | 70.90655 / s | - | - | +| [Kling 4.0](/es/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | - | 47.37161 / s | 70.90655 / s | - | - | | [LTX 2.5 Fast](/es/development/comfy-router/models/ltx/ltx-2-5-fast/code) | `ltx/ltx-2-5-fast` | - | 27.1557 / s | 39.2249 / s | 57.3287 / s | 90.519 / s | | [LTX 2.5 Pro](/es/development/comfy-router/models/ltx/ltx-2-5-pro/code) | `ltx/ltx-2-5-pro` | - | 36.2076 / s | 51.2941 / s | - | - | | [P Video 2 Estándar](/es/development/comfy-router/models/pruna/p-video-2/code) | `pruna/p-video-2` | - | 7.5432 / s | 15.0865 / s | - | - | @@ -427,21 +427,21 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | --- | --- | --- | ---: | | [Aleph 2](/es/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | 84.4844 / s | | [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | 15.0865 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 480p | 3.0173 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 768p | 6.0346 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 1080p | 10.56055 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 2K | 12.0692 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 4K | 24.1384 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 480p | 9.0519 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 768p | 18.1038 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 1080p | 22.62975 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 2K | 24.1384 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 4K | 30.173 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 480p | 3.0173 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 768p | 6.0346 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 1080p | 10.56055 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 2K | 12.0692 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 4K | 24.1384 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | 3.0173 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | 6.0346 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | 10.56055 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 2K | 12.0692 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 4K | 24.1384 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 480p | 9.0519 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 768p | 18.1038 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 1080p | 22.62975 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 2K | 24.1384 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 4K | 30.173 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 480p | 3.0173 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 768p | 6.0346 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 1080p | 10.56055 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 2K | 12.0692 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 4K | 24.1384 / s | | [Pika Soundtrack](/es/development/comfy-router/models/pika/pika-soundtrack/code) | `pika/pika-soundtrack` | Input video | 1.50865 / s | | [Sync 3](/es/development/comfy-router/models/synclabs/sync-3/code) | `synclabs/sync-3` | - | 40.1301 / s | | [Erase](/es/development/comfy-router/models/bria/video-edit-erase/code) | `bria/video-edit-erase` | - | 13.5778 / s | @@ -637,7 +637,7 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [Gemini 3.8 Flash](/es/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2262.975 | | [Gemini 3.7 Flash](/es/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2262.975 | | [Gemini 3.1 Flash Lite](/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | Imagen / Texto / Video: 52.75
Audio: 105.5 | Texto / Razonamiento: 316.5 | -| [Gemini Omni 1.2 Flash](/es/development/comfy-router/models) | `gemini-interactions/gemini-omni-1.2-flash` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2715.57
Video: 3620.76 | +| [Gemini Omni 1.2 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code) | `gemini-interactions/gemini-omni-1.2-flash` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2715.57
Video: 3620.76 | | [Gemini Omni 1.1 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code) | `gemini-interactions/gemini-omni-1.1-flash` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2715.57
Video: 5280.275 | | [Gemini Omni Flash Preview](/es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code) | `gemini-interactions/gemini-omni-flash-preview` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2715.57
Video: 5280.275 | | [Google Gemini](/es/development/comfy-router/models/google/gemini/code) | `vertexai/gemini-2.5-flash` | - | Imagen / Texto / Video: 63.3
Audio: 211 | Texto: 527.5 | @@ -748,8 +748,8 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | Nombre | ID del modelo | Créditos / solicitud | | --- | --- | ---: | -| [Stable Fast 3D](/es/development/comfy-router/models) | `stability/stable-fast-3d` | 21.1 | -| [Stable Point Aware 3D](/es/development/comfy-router/models) | `stability/stable-point-aware-3d` | 8.44 | +| [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code) | `stability/stable-fast-3d` | 21.1 | +| [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code) | `stability/stable-point-aware-3d` | 8.44 | @@ -769,8 +769,8 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | --- | --- | ---: | ---: | | [Gemini 2.5 Flash Image](/es/development/comfy-router/models/google/gemini-2-5-flash-image/code) | `vertexai/gemini-2.5-flash-image` | Imagen / Texto / Video: $0.30
Audio: $1.00 | Texto: $2.50
Imagen: $30.00 | | [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | `vertexai/gemini-nano-banana-2.1` | Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $10.725
Imagen: $42.90 | -| [GPT Image 2.6 Flare](/es/development/comfy-router/models) | `openai/gpt-image-2.6-flare` | Texto: $7.15
Imagen: $11.44 | Imagen: $42.90 | -| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models) | `openai/gpt-image-2.6-sunburst` | Texto: $7.15
Imagen: $11.44 | Imagen: $42.90 | +| [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | `openai/gpt-image-2.6-flare` | Texto: $7.15
Imagen: $11.44 | Imagen: $42.90 | +| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | `openai/gpt-image-2.6-sunburst` | Texto: $7.15
Imagen: $11.44 | Imagen: $42.90 | | [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | Texto: $7.15
Imagen: $11.44 | Texto: $14.30
Imagen: $42.90 | | [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | Texto: $7.15
Imagen: $11.44 | Texto: $14.30
Imagen: $42.90 | | [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | Texto: $5.00
Imagen: $8.00 | Texto: $10.00
Imagen: $32.00 | @@ -828,20 +828,20 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [Seedream 4.5](/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code) | `byteplus/seedream-4-5-251128` | $0.04 | | [Seedream 5.0](/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | $0.035 | | [Seedream 5.0 Flash](/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code) | `byteplus/seedream-5-0-flash-260915` | $0.02574 | -| [Control Sketch](/es/development/comfy-router/models) | `stability/control-sketch` | $0.05 | -| [Control Structure](/es/development/comfy-router/models) | `stability/control-structure` | $0.05 | -| [Control Style](/es/development/comfy-router/models) | `stability/control-style` | $0.05 | -| [Control Style Transfer](/es/development/comfy-router/models) | `stability/control-style-transfer` | $0.08 | -| [Edit Erase](/es/development/comfy-router/models) | `stability/edit-erase` | $0.05 | -| [Edit Inpaint](/es/development/comfy-router/models) | `stability/edit-inpaint` | $0.05 | -| [Edit Outpaint](/es/development/comfy-router/models) | `stability/edit-outpaint` | $0.04 | -| [Edit Remove Background](/es/development/comfy-router/models) | `stability/edit-remove-background` | $0.05 | -| [Edit Replace Background And Relight](/es/development/comfy-router/models) | `stability/edit-replace-background-and-relight` | $0.08 | -| [Edit Search And Recolor](/es/development/comfy-router/models) | `stability/edit-search-and-recolor` | $0.05 | -| [Edit Search And Replace](/es/development/comfy-router/models) | `stability/edit-search-and-replace` | $0.05 | +| [Control Sketch](/es/development/comfy-router/models/stability/control-sketch/code) | `stability/control-sketch` | $0.05 | +| [Control Structure](/es/development/comfy-router/models/stability/control-structure/code) | `stability/control-structure` | $0.05 | +| [Control Style](/es/development/comfy-router/models/stability/control-style/code) | `stability/control-style` | $0.05 | +| [Control Style Transfer](/es/development/comfy-router/models/stability/control-style-transfer/code) | `stability/control-style-transfer` | $0.08 | +| [Edit Erase](/es/development/comfy-router/models/stability/edit-erase/code) | `stability/edit-erase` | $0.05 | +| [Edit Inpaint](/es/development/comfy-router/models/stability/edit-inpaint/code) | `stability/edit-inpaint` | $0.05 | +| [Edit Outpaint](/es/development/comfy-router/models/stability/edit-outpaint/code) | `stability/edit-outpaint` | $0.04 | +| [Edit Remove Background](/es/development/comfy-router/models/stability/edit-remove-background/code) | `stability/edit-remove-background` | $0.05 | +| [Edit Replace Background And Relight](/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code) | `stability/edit-replace-background-and-relight` | $0.08 | +| [Edit Search And Recolor](/es/development/comfy-router/models/stability/edit-search-and-recolor/code) | `stability/edit-search-and-recolor` | $0.05 | +| [Edit Search And Replace](/es/development/comfy-router/models/stability/edit-search-and-replace/code) | `stability/edit-search-and-replace` | $0.05 | | [Fibo](/es/development/comfy-router/models/bria/fibo/code) | `bria/fibo` | $0.04 | -| [Generate Core](/es/development/comfy-router/models) | `stability/generate-core` | $0.03 | -| [Generate Ultra](/es/development/comfy-router/models) | `stability/generate-ultra` | $0.08 | +| [Generate Core](/es/development/comfy-router/models/stability/generate-core/code) | `stability/generate-core` | $0.03 | +| [Generate Ultra](/es/development/comfy-router/models/stability/generate-ultra/code) | `stability/generate-ultra` | $0.08 | | [Image](/es/development/comfy-router/models/bria/image/code) | `bria/image` | $0.0572 | | [Add Object By Text](/es/development/comfy-router/models/bria/image-edit-add-object-by-text/code) | `bria/image-edit-add-object-by-text` | $0.0572 | | [Erase](/es/development/comfy-router/models/bria/image-edit-erase/code) | `bria/image-edit-erase` | $0.0286 | @@ -859,17 +859,17 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [Replace Object By Text](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code) | `bria/image-edit-replace-object-by-text` | $0.0572 | | [Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code) | `bria/image-edit-reseason` | $0.0572 | | [Restore](/es/development/comfy-router/models/bria/image-edit-restore/code) | `bria/image-edit-restore` | $0.0572 | -| [Sd3.5 Flash](/es/development/comfy-router/models) | `stability/sd3.5-flash` | $0.025 | -| [Sd3.5 Large](/es/development/comfy-router/models) | `stability/sd3.5-large` | $0.065 | -| [Sd3.5 Large Turbo](/es/development/comfy-router/models) | `stability/sd3.5-large-turbo` | $0.04 | -| [Sd3.5 Medium](/es/development/comfy-router/models) | `stability/sd3.5-medium` | $0.035 | -| [Upscale Conservative](/es/development/comfy-router/models) | `stability/upscale-conservative` | $0.40 | -| [Upscale Creative](/es/development/comfy-router/models) | `stability/upscale-creative` | $0.60 | -| [Upscale Fast](/es/development/comfy-router/models) | `stability/upscale-fast` | $0.02 | +| [Sd3.5 Flash](/es/development/comfy-router/models/stability/sd3-5-flash/code) | `stability/sd3.5-flash` | $0.025 | +| [Sd3.5 Large](/es/development/comfy-router/models/stability/sd3-5-large/code) | `stability/sd3.5-large` | $0.065 | +| [Sd3.5 Large Turbo](/es/development/comfy-router/models/stability/sd3-5-large-turbo/code) | `stability/sd3.5-large-turbo` | $0.04 | +| [Sd3.5 Medium](/es/development/comfy-router/models/stability/sd3-5-medium/code) | `stability/sd3.5-medium` | $0.035 | +| [Upscale Conservative](/es/development/comfy-router/models/stability/upscale-conservative/code) | `stability/upscale-conservative` | $0.40 | +| [Upscale Creative](/es/development/comfy-router/models/stability/upscale-creative/code) | `stability/upscale-creative` | $0.60 | +| [Upscale Fast](/es/development/comfy-router/models/stability/upscale-fast/code) | `stability/upscale-fast` | $0.02 | | [Kling Image O1](/es/development/comfy-router/models/kling/kling-image-o1/code) | `kling/kling-image-o1` | $0.028 | -| [Sdxl 1.0 Image To Image](/es/development/comfy-router/models) | `stability/sdxl-1.0-image-to-image` | $0.009 | -| [Sdxl 1.0 Masking](/es/development/comfy-router/models) | `stability/sdxl-1.0-masking` | $0.009 | -| [Sdxl 1.0 Text To Image](/es/development/comfy-router/models) | `stability/sdxl-1.0-text-to-image` | $0.009 | +| [Sdxl 1.0 Image To Image](/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code) | `stability/sdxl-1.0-image-to-image` | $0.009 | +| [Sdxl 1.0 Masking](/es/development/comfy-router/models/stability/sdxl-1-0-masking/code) | `stability/sdxl-1.0-masking` | $0.009 | +| [Sdxl 1.0 Text To Image](/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code) | `stability/sdxl-1.0-text-to-image` | $0.009 | | [Wan 2.5 I2I Preview](/es/development/comfy-router/models/wan/wan2-5-i2i-preview/code) | `wan/wan2.5-i2i-preview` | $0.03 | | [Wan 2.5 T2I Preview](/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code) | `wan/wan2.5-t2i-preview` | $0.03 | @@ -1101,7 +1101,7 @@ La exportación EXR de Ray 3.2 todavía no está disponible. Deja `exr_export` d | [HappyHorse 1.1 I2V](/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code) | `wan/happyhorse-1.1-i2v` | - | $0.2002 / s | $0.2574 / s | - | - | | [HappyHorse 1.1 R2V](/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code) | `wan/happyhorse-1.1-r2v` | - | $0.2002 / s | $0.2574 / s | - | - | | [HappyHorse 1.1 T2V](/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code) | `wan/happyhorse-1.1-t2v` | - | $0.2002 / s | $0.2574 / s | - | - | -| [Kling 4.0](/es/development/comfy-router/models) | `kling/kling-4.0` | - | $0.22451 / s | $0.33605 / s | - | - | +| [Kling 4.0](/es/development/comfy-router/models/kling/kling-4-0/code) | `kling/kling-4.0` | - | $0.22451 / s | $0.33605 / s | - | - | | [LTX 2.5 Fast](/es/development/comfy-router/models/ltx/ltx-2-5-fast/code) | `ltx/ltx-2-5-fast` | - | $0.1287 / s | $0.1859 / s | $0.2717 / s | $0.429 / s | | [LTX 2.5 Pro](/es/development/comfy-router/models/ltx/ltx-2-5-pro/code) | `ltx/ltx-2-5-pro` | - | $0.1716 / s | $0.2431 / s | - | - | | [P Video 2 Estándar](/es/development/comfy-router/models/pruna/p-video-2/code) | `pruna/p-video-2` | - | $0.03575 / s | $0.0715 / s | - | - | @@ -1167,21 +1167,21 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | --- | --- | --- | ---: | | [Aleph 2](/es/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | $0.4004 / s | | [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | $0.0715 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 480p | $0.0143 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 768p | $0.0286 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 1080p | $0.05005 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 2K | $0.0572 / s | -| [Pika H3 Flex Image To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-image-to-video` | 4K | $0.1144 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 480p | $0.0429 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 768p | $0.0858 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 1080p | $0.10725 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 2K | $0.1144 / s | -| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-reference-to-video` | 4K | $0.143 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 480p | $0.0143 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 768p | $0.0286 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 1080p | $0.05005 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 2K | $0.0572 / s | -| [Pika H3 Flex Text To Video](/es/development/comfy-router/models) | `pika/pika-h3-flex-text-to-video` | 4K | $0.1144 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | $0.0143 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | $0.0286 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | $0.05005 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 2K | $0.0572 / s | +| [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 4K | $0.1144 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 480p | $0.0429 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 768p | $0.0858 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 1080p | $0.10725 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 2K | $0.1144 / s | +| [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code) | `pika/pika-h3-flex-reference-to-video` | 4K | $0.143 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 480p | $0.0143 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 768p | $0.0286 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 1080p | $0.05005 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 2K | $0.0572 / s | +| [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code) | `pika/pika-h3-flex-text-to-video` | 4K | $0.1144 / s | | [Pika Soundtrack](/es/development/comfy-router/models/pika/pika-soundtrack/code) | `pika/pika-soundtrack` | Input video | $0.00715 / s | | [Sync 3](/es/development/comfy-router/models/synclabs/sync-3/code) | `synclabs/sync-3` | - | $0.19019 / s | | [Erase](/es/development/comfy-router/models/bria/video-edit-erase/code) | `bria/video-edit-erase` | - | $0.06435 / s | @@ -1377,7 +1377,7 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [Gemini 3.8 Flash](/es/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $10.725 | | [Gemini 3.7 Flash](/es/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $10.725 | | [Gemini 3.1 Flash Lite](/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | Imagen / Texto / Video: $0.25
Audio: $0.50 | Texto / Razonamiento: $1.50 | -| [Gemini Omni 1.2 Flash](/es/development/comfy-router/models) | `gemini-interactions/gemini-omni-1.2-flash` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $12.87
Video: $17.16 | +| [Gemini Omni 1.2 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code) | `gemini-interactions/gemini-omni-1.2-flash` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $12.87
Video: $17.16 | | [Gemini Omni 1.1 Flash](/es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code) | `gemini-interactions/gemini-omni-1.1-flash` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $12.87
Video: $25.025 | | [Gemini Omni Flash Preview](/es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code) | `gemini-interactions/gemini-omni-flash-preview` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $12.87
Video: $25.025 | | [Google Gemini](/es/development/comfy-router/models/google/gemini/code) | `vertexai/gemini-2.5-flash` | - | Imagen / Texto / Video: $0.30
Audio: $1.00 | Texto: $2.50 | @@ -1488,8 +1488,8 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | Nombre | ID del modelo | USD / solicitud | | --- | --- | ---: | -| [Stable Fast 3D](/es/development/comfy-router/models) | `stability/stable-fast-3d` | $0.10 | -| [Stable Point Aware 3D](/es/development/comfy-router/models) | `stability/stable-point-aware-3d` | $0.04 | +| [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code) | `stability/stable-fast-3d` | $0.10 | +| [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code) | `stability/stable-point-aware-3d` | $0.04 | From cfddad5c92c29201ade8db8db796799369033ab4 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Wed, 11 Nov 2026 11:18:48 +0800 Subject: [PATCH 13/36] i18n: sync zh/ja/ko/es for the serverless library-models page and the Seedream code pages --- es/development/comfy-router/models.mdx | 37 +- .../byteplus/seedream-4-0-250828/code.mdx | 67 ++- .../byteplus/seedream-4-5-251128/code.mdx | 68 ++- .../byteplus/seedream-5-0-260128/code.mdx | 75 +++- .../seedream-5-0-flash-260915/code.mdx | 78 ++-- .../byteplus/seedream-5-0-pro-260628/code.mdx | 69 ++- .../byteplus/seedream-5-5-261028/code.mdx | 408 +++++++++++++++++ .../models/meshy/rigging/code.mdx | 15 +- es/development/serverless/library-models.mdx | 171 ++++++++ es/development/serverless/overview.mdx | 14 +- ja/development/comfy-router/models.mdx | 26 +- .../byteplus/seedream-4-0-250828/code.mdx | 101 +++-- .../byteplus/seedream-4-5-251128/code.mdx | 97 +++-- .../byteplus/seedream-5-0-260128/code.mdx | 103 +++-- .../seedream-5-0-flash-260915/code.mdx | 144 +++--- .../byteplus/seedream-5-0-pro-260628/code.mdx | 141 +++--- .../byteplus/seedream-5-5-261028/code.mdx | 412 ++++++++++++++++++ .../models/meshy/rigging/code.mdx | 15 +- ja/development/serverless/library-models.mdx | 171 ++++++++ ja/development/serverless/overview.mdx | 19 +- ko/development/comfy-router/models.mdx | 84 ++-- .../byteplus/seedream-4-0-250828/code.mdx | 188 ++++---- .../byteplus/seedream-4-5-251128/code.mdx | 96 ++-- .../byteplus/seedream-5-0-260128/code.mdx | 90 ++-- .../seedream-5-0-flash-260915/code.mdx | 118 +++-- .../byteplus/seedream-5-0-pro-260628/code.mdx | 119 +++-- .../byteplus/seedream-5-5-261028/code.mdx | 409 +++++++++++++++++ .../models/meshy/rigging/code.mdx | 15 +- ko/development/serverless/library-models.mdx | 171 ++++++++ ko/development/serverless/overview.mdx | 23 +- zh/development/comfy-router/models.mdx | 58 ++- .../byteplus/seedream-4-0-250828/code.mdx | 157 ++++--- .../byteplus/seedream-4-5-251128/code.mdx | 169 ++++--- .../byteplus/seedream-5-0-260128/code.mdx | 162 ++++--- .../seedream-5-0-flash-260915/code.mdx | 151 ++++--- .../byteplus/seedream-5-0-pro-260628/code.mdx | 129 +++--- .../byteplus/seedream-5-5-261028/code.mdx | 409 +++++++++++++++++ .../models/meshy/rigging/code.mdx | 15 +- zh/development/serverless/library-models.mdx | 171 ++++++++ zh/development/serverless/overview.mdx | 17 +- 40 files changed, 3966 insertions(+), 1016 deletions(-) create mode 100644 es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx create mode 100644 es/development/serverless/library-models.mdx create mode 100644 ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx create mode 100644 ja/development/serverless/library-models.mdx create mode 100644 ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx create mode 100644 ko/development/serverless/library-models.mdx create mode 100644 zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx create mode 100644 zh/development/serverless/library-models.mdx diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 196e518a2e..92189392ae 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -2,16 +2,16 @@ title: "Modelos de Comfy Router" sidebarTitle: "Todos los modelos" description: "Todos los modelos disponibles en Comfy Router, agrupados por proveedor, con su modalidad de entrada y salida." -translationSourceHash: 947ab0cb +translationSourceHash: 04ecf050 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 47e9d047 + "Find by output": 2dfd8d42 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 - "BytePlus": 0ff87da0 + "BytePlus": 0767a672 "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 @@ -47,6 +47,7 @@ translationBlockHashes: + {/* ARCHIVO GENERADO. Generado a partir del catálogo del Router por `pnpm code-pages:gen`. */} Todos los modelos que aparecen a continuación se sirven por la misma ruta, `POST /v2/models/{provider}/{model}`, con el cuerpo JSON propio del modelo. Cada página muestra una solicitud funcional en Python, TypeScript y cURL. Para descubrimiento, esquemas, errores, reintentos y facturación, consulta [Usar la API de Comfy Router](/es/development/comfy-router/api). @@ -140,7 +141,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Grok Imagine Video](/es/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/es/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -162,18 +163,19 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/es/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` -- [Image Edit Remove Background](/es/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` -- [Image Edit Replace Background](/es/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Image Edit Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` -- [Image Edit Restore](/es/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` -- [Image](/es/development/comfy-router/models/bria/image/code): `bria/image` +- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Editar imagen: eliminar fondo guiado](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Editar imagen: eliminar fondo](/es/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` +- [Editar imagen: reemplazar fondo](/es/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` +- [Editar imagen: reemplazar objeto por texto](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` +- [Editar imagen: Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Editar imagen: restaurar](/es/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` +- [Imagen](/es/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` - [Seedream 4.5 251128](/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code): `byteplus/seedream-4-5-251128` - [Seedream 5.0 260128](/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code): `byteplus/seedream-5-0-260128` - [Seedream 5.0 Flash 260915](/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code): `byteplus/seedream-5-0-flash-260915` - [Seedream 5.0 Pro 260628](/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code): `byteplus/seedream-5-0-pro-260628` +- [Seedream 5.5 261028](/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code): `byteplus/seedream-5-5-261028` - [Crystal Upscaler](/es/development/comfy-router/models/fal/crystal-upscaler/code): `fal/crystal-upscaler` - [Patina](/es/development/comfy-router/models/fal/patina/code): `fal/patina` - [AI Image Upscaler Precision V2](/es/development/comfy-router/models/freepik/ai-image-upscaler-precision-v2/code): `freepik/ai-image-upscaler-precision-v2` @@ -211,8 +213,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Qwen Image 3.0](/es/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/es/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` - [Recraft V3](/es/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` -- [Recraft V4.1 Pro](/es/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro`- [Recraft V4.1 Utility Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` +- [Recraft V4.1 Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector`- [Recraft V4.1 Pro](/es/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` +- [Recraft V4.1 Utility Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code): `recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code): `recraft/recraftv4_1_utility_vector` - [Recraft V4.1 Utility](/es/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` @@ -262,8 +264,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [FLUX 3 Video](/es/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` -- [Dreamina Seedance 2.0 Mini](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini`- [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` +- [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128`- [Dreamina Seedance 2.0 Mini](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/es/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/es/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` - [Seedance 1.5 Pro 251215](/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` @@ -319,8 +321,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` - [Hunyuan 3D Part](/es/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` -- [Hunyuan 3D Texture Edit](/es/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit`- [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` +- [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology`- [Hunyuan 3D Texture Edit](/es/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` +- [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` @@ -462,6 +464,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [Seedream 5.0 260128](/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | Texto, Imagen | Imagen | | [Seedream 5.0 Flash 260915](/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code) | `byteplus/seedream-5-0-flash-260915` | Texto, Imagen | Imagen | | [Seedream 5.0 Pro 260628](/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | Texto, Imagen | Imagen | +| [Seedream 5.5 261028](/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | Texto, Imagen | Imagen | ## Elevenlabs diff --git a/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index 0d1bb234f4..eb9c3f24e5 100644 --- a/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedream 4.0 250828 con Comfy Router" description: "Llama a byteplus/seedream-4-0-250828 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedream 4.0 250828" -translationSourceHash: a0e25650 +translationSourceHash: 0e2de27d translationFrom: development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx translationBlockHashes: "_intro": 3d37b29e "Quick start": 38e0a75b - "Schema": b45c3a02 + "Schema": 66ccdc55 "Examples": ac35d592 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-4-0-250828.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -153,6 +154,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQU ### Entrada + + Controla si la imagen generada tiene un fondo transparente (canal alfa). Compatible con seedream-5.0-pro, 5.0-flash y los modelos Seedream más recientes cuyo propio esquema lo documenta. +auto: El modelo decide a partir del prompt y de output_format. Con output_format jpeg, la salida siempre es opaca. +transparent: Genera una imagen RGBA con fondo transparente. Con output_format jpeg devuelve un error. +opaque: Genera una imagen RGB con fondo opaco. Es el valor predeterminado de seedream-5.0-pro. +seedream-5.0-pro solo admite la salida transparente en imagen a imagen, con una única imagen png de entrada que tenga canal alfa. +No se admite en el escenario de separación de capas: pasarlo con layer_decomposition habilitado devuelve un error. + + Valores posibles: `auto`, `transparent`, `opaque` + + Controla qué tan fielmente se alinea la imagen de salida con el prompt de entrada. Rango [1, 10]. Los valores más altos producen una mayor adherencia al prompt. No es compatible con seedream-5.0-pro, 5.0-lite, 4.5 ni 4.0. @@ -177,41 +189,51 @@ Una imagen de entrada debe cumplir los siguientes requisitos: • Ancho y alto (px): > 14 • Tamaño: no más de 10 MB (30 MB para seedream-5.0-pro) • Píxeles totales: no más de 6000x6000 (36,000,000 px) para seedream-5.0-pro -• Máximo de 14 imágenes de referencia (10 para seedream-5.0-pro y 5.0-flash) +• Máximo de 14 imágenes de referencia (10 para seedream-5.0-pro, 5.0-flash y 5.5) En el escenario de separación de capas (con layer_decomposition habilitado), image es requerido y solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error). Las imágenes de entrada deben ser png, jpeg, webp, bmp, tiff o gif (no se admiten heic ni heif), de hasta 30 MB, con un total de píxeles en el rango [512x512, 6000x6000] y una relación de aspecto en [1/16, 16]. - Controla si la separación de capas está habilitada. Solo seedream-5.0-pro y 5.0-flash admiten este parámetro. -true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). + Controla si la separación de capas está habilitada. Solo seedream-5.0-pro, 5.0-flash y 5.5 admiten este parámetro. +true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16; hasta 99 en seedream-5.5) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). false: Modo estándar de generación de imágenes; no se realiza separación de capas. -Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error); si alguna capa individual no se genera, toda la solicitud falla: no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si se pasan. +Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error); si alguna capa individual no se genera, toda la solicitud falla: no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). seedream-5.5 devuelve como máximo layer_decomposition_options.max_images imágenes (1 imagen base + hasta 99 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si se pasan. + + + + Opciones para el modo de separación de capas. Solo seedream-5.5 admite este parámetro, y solo se aplica cuando layer_decomposition es true. + + + + El número total máximo de imágenes que devuelve esta solicitud, la imagen base y las capas juntas. Rango: [2, 100]. Cuando el prompt no indica cómo dividir la imagen, el modelo planifica las capas a partir de max_images y de la complejidad de la imagen de entrada; un valor mayor suele dar capas más finas. + + Rango: `2` a `100` - Identificador del modelo. Modelos compatibles: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 y seedream-5-0-flash-260915. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a Router lo omite. + Identificador del modelo. Modelos compatibles: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 y seedream-5-5-261028. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a Router lo omite. - Configuración de la función de optimización de prompt. Solo seedream-5.0-pro/5.0-lite/4.5 (solo admiten el modo standard) y seedream-4.0 admiten este parámetro. + Configuración de la función de optimización de prompt. Solo seedream-5.0-pro/5.0-lite/4.5/5.5 (solo admiten el modo standard; seedream-5.5 devuelve un error para fast) y seedream-4.0 admiten este parámetro. Establece el modo de la función de optimización de prompt. standard = mayor calidad, mayor tiempo de generación. fast = más rápido, pero con una calidad más media. - Posibles valores: `standard`, `fast` + Valores posibles: `standard`, `fast` - Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash y 5.0-lite admiten este parámetro. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; cada capa siempre se emite como png. + Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash, 5.0-lite y 5.5 admiten este parámetro. seedream-5.5 usa png de forma predeterminada. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; cada capa siempre se genera como png. - Posibles valores: `png`, `jpeg` + Valores posibles: `png`, `jpeg` Descripción de texto para la generación o transformación de imágenes. -Opcional en el escenario de separación de capas (seedream-5.0-pro o 5.0-flash con layer_decomposition habilitado): si se proporciona un prompt, el modelo reconoce y separa los elementos que especifiques según la intención del prompt; si no se proporciona ningún prompt, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. +Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o 5.5 con layer_decomposition habilitado): si se proporciona un prompt, el modelo reconoce y separa los elementos que especifiques según la intención del prompt; si no se proporciona ningún prompt, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. @@ -227,7 +249,7 @@ Opcional en el escenario de separación de capas (seedream-5.0-pro o 5.0-flash c - Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro ni 5.0-flash). Valores válidos: + Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos: auto: En modo automático, el modelo determina automáticamente si devolver varias imágenes y cuántas imágenes incluirá según el prompt del usuario. disabled: Deshabilita la función de generación por lotes. El modelo solo generará una imagen. @@ -235,7 +257,7 @@ disabled: Deshabilita la función de generación por lotes. El modelo solo gener - Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no lo admiten seedream-5.0-pro ni 5.0-flash). + Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no lo admiten seedream-5.0-pro, 5.0-flash ni 5.5). Configuración de la función de generación de imágenes por lotes. Este parámetro solo tiene efecto cuando sequential_image_generation se establece en auto. @@ -261,13 +283,16 @@ Configuración de la función de generación de imágenes por lotes. Este parám "seedream-5-0-flash-260915": Dos métodos disponibles (no se pueden usar juntos). Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] -"seedream-5-0-pro-260628" y "seedream-5-0-flash-260915" con layer_decomposition habilitado: Solo se admite el método basado en la resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. +"seedream-5-5-261028": Dos métodos disponibles (no se pueden usar juntos). + Método 1 | Especifica la resolución. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K + Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915" y "seedream-5-5-261028" con layer_decomposition habilitado: Solo se admite el método basado en la resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. La imagen base se genera con la resolución especificada y la relación de aspecto de la imagen de entrada original; cada capa se genera con una resolución cercana a la especificada, manteniendo la relación de aspecto que tenía en la imagen original. auto: La salida se basa en el tamaño y la relación de aspecto de la imagen de entrada. Las entradas dentro de [1280x720, ~2048x2048] se generan con el tamaño original de entrada; las entradas menores que 1K se generan a 1K; las entradas mayores que 2K se generan a 2K.
- Comfy Router establece en false un flag stream proporcionado explícitamente porque captura un resultado JSON completo. En el proxy v1, este campo controla si se habilita el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no lo admiten seedream-5.0-pro ni 5.0-flash). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. + Comfy Router establece en false un flag stream proporcionado explícitamente porque captura un resultado JSON completo. En el proxy v1, este campo controla si se habilita el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no lo admiten seedream-5.0-pro, 5.0-flash ni 5.5). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. @@ -291,6 +316,10 @@ En el escenario de separación por capas, el primer elemento del arreglo es la i Datos de imagen codificados en Base64 (si response_format es "b64_json")
+ + El tipo de fondo que realmente tiene la imagen: transparent u opaque. En el escenario de separación por capas, la imagen base siempre es opaque y cada capa es transparent. Solo seedream-5.5 devuelve este campo. + + La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve solo cuando layer_decomposition es verdadero. @@ -312,11 +341,11 @@ En el escenario de separación por capas, el primer elemento del arreglo es la i
- El formato de archivo de la imagen de salida. Solo seedream-5.0-pro admite este campo. + El formato de archivo de la imagen de salida. Solo seedream-5.0-pro y 5.5 admiten este campo. - El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 4.5 y 4.0 admiten este parámetro. + El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 5.5, 4.5 y 4.0 admiten este parámetro. @@ -354,7 +383,7 @@ En el escenario de separación por capas, el primer elemento del arreglo es la i - El número de imágenes de entrada al modelo. Solo seedream-5.0-pro admite este campo. + El número de imágenes de entrada al modelo. Solo seedream-5.0-pro y 5.5 admiten este campo. diff --git a/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx b/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx index 9c1c09cf44..2c37b0b871 100644 --- a/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedream 4.5 251128 con Comfy Router" description: "Llama a byteplus/seedream-4-5-251128 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedream 4.5 251128" -translationSourceHash: af20f4b5 +translationSourceHash: e47962e3 translationFrom: development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx translationBlockHashes: "_intro": 1d32bb5d "Quick start": 5ffebfad - "Schema": 23ff89f5 + "Schema": d11a7253 "Examples": 7bc7fa59 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-4-5-251128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -153,6 +154,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-5-251128/requests/$REQU ### Entrada + + Controla si la imagen generada tiene un fondo transparente (canal alfa). Es compatible con seedream-5.0-pro, 5.0-flash y los modelos Seedream más recientes cuyo propio esquema lo documenta. +auto: El modelo decide a partir del prompt y output_format. Con output_format jpeg, la salida siempre es opaca. +transparent: Genera una imagen RGBA con un fondo transparente. output_format jpeg devuelve un error. +opaque: Genera una imagen RGB con un fondo opaco. El valor predeterminado de seedream-5.0-pro. +seedream-5.0-pro solo admite salida transparente para imagen a imagen, con una única imagen png de entrada que tenga un canal alfa. +No se admite en el escenario de separación de capas: si lo pasas con layer_decomposition habilitado, devuelve un error. + + Valores posibles: `auto`, `transparent`, `opaque` + + Controla cuánto se ajusta la imagen de salida al prompt de entrada. Rango [1, 10]. Los valores más altos dan como resultado una mayor adherencia al prompt. No es compatible con seedream-5.0-pro, 5.0-lite, 4.5 ni 4.0. @@ -177,24 +189,34 @@ Una imagen de entrada debe cumplir los siguientes requisitos: • Ancho y alto (px): > 14 • Tamaño: no más de 10 MB (30 MB para seedream-5.0-pro) • Píxeles totales: no más de 6000x6000 (36,000,000 px) para seedream-5.0-pro -• Máximo de 14 imágenes de referencia (10 para seedream-5.0-pro y 5.0-flash) +• Máximo de 14 imágenes de referencia (10 para seedream-5.0-pro, 5.0-flash y 5.5) En el escenario de separación de capas (con layer_decomposition habilitado), image es obligatorio y solo se admite una única imagen de entrada (si pasas varias imágenes, obtienes un error). Las imágenes de entrada deben ser png, jpeg, webp, bmp, tiff o gif (no se admiten heic ni heif), de hasta 30 MB, con píxeles totales en el rango [512x512, 6000x6000] y relación de aspecto en [1/16, 16]. - Controla si se habilita la separación de capas. Solo seedream-5.0-pro y 5.0-flash admiten este parámetro. -true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16) y devuelve la información de posición y contenido de cada capa producida, incluyendo el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). + Controla si se habilita la separación de capas. Solo seedream-5.0-pro, 5.0-flash y 5.5 admiten este parámetro. +true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16; hasta 99 en seedream-5.5) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). false: Modo de generación de imágenes estándar; no se realiza la separación de capas. -Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (si pasas varias imágenes, obtienes un error); si alguna capa individual no se genera, toda la solicitud falla: no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si los pasas. +Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (si pasas varias imágenes, obtienes un error); si alguna capa individual no se genera, toda la solicitud falla: no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). seedream-5.5 devuelve como máximo layer_decomposition_options.max_images imágenes (1 imagen base + hasta 99 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si los pasas. + + + + Opciones para el modo de separación de capas. Solo seedream-5.5 admite este parámetro y solo se aplica cuando layer_decomposition es true. + + + + El número total máximo de imágenes que devuelve esta solicitud, contando la imagen base y las capas. Rango: [2, 100]. Cuando el prompt no indica cómo dividir la imagen, el modelo planifica las capas a partir de max_images y de la complejidad de la imagen de entrada; un valor mayor suele dar capas más finas. + + Rango: `2` a `100` - Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 y seedream-5-0-flash-260915. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE incluirlo: el proxy rechaza con un 400 cualquier otro valor, y también su omisión. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde Router lo omite. + Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 y seedream-5-5-261028. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo: el proxy rechaza con un 400 cualquier otro valor, y también su omisión. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde Router lo omite. - Configuración de la función de optimización de prompts. Solo seedream-5.0-pro/5.0-lite/4.5 (que solo admiten el modo standard) y seedream-4.0 admiten este parámetro. + Configuración de la función de optimización de prompts. Solo seedream-5.0-pro/5.0-lite/4.5/5.5 (solo admiten el modo standard; seedream-5.5 devuelve un error para fast) y seedream-4.0 admiten este parámetro. @@ -204,18 +226,17 @@ Notas sobre el modo de separación de capas: solo se admite una única imagen de - Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash y 5.0-lite admiten este parámetro. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; todas las capas siempre se generan como png. - + Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash, 5.0-lite y 5.5 admiten este parámetro. seedream-5.5 usa png de forma predeterminada. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; todas las capas siempre se generan como png. Valores posibles: `png`, `jpeg` - Descripción de texto para generar o transformar imágenes. -Opcional en el escenario de separación de capas (seedream-5.0-pro o 5.0-flash con layer_decomposition habilitado): si proporcionas un prompt, el modelo reconoce y separa los elementos que especifiques según la intención del prompt; si no proporcionas ninguno, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. + Descripción de texto para la generación o transformación de imágenes. +Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o 5.5 con layer_decomposition habilitado): si se proporciona un prompt, el modelo reconoce y separa los elementos que especifiques según la intención del prompt; si no se proporciona un prompt, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. - Especifica el formato de la imagen generada que se devuelve en la respuesta. + Especifica el formato de la imagen generada que se devuelve en la respuesta Valores posibles: `url`, `b64_json` @@ -227,7 +248,7 @@ Opcional en el escenario de separación de capas (seedream-5.0-pro o 5.0-flash c - Controla si se deshabilita la función de generación por lotes. Este parámetro solo está disponible en seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro ni 5.0-flash). Valores válidos: + Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos: auto: En modo automático, el modelo determina automáticamente si debe devolver varias imágenes y cuántas imágenes contendrá según el prompt del usuario. disabled: Deshabilita la función de generación por lotes. El modelo solo generará una imagen. @@ -235,7 +256,7 @@ disabled: Deshabilita la función de generación por lotes. El modelo solo gener - Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro y 5.0-flash no lo admiten). + Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro, 5.0-flash y 5.5 no lo admiten). Configuración de la función de generación de imágenes por lote. Este parámetro solo tiene efecto cuando sequential_image_generation está establecido en auto. @@ -261,13 +282,16 @@ Configuración de la función de generación de imágenes por lote. Este paráme "seedream-5-0-flash-260915": Dos métodos disponibles (no se pueden usar juntos). Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] -"seedream-5-0-pro-260628" y "seedream-5-0-flash-260915" con layer_decomposition habilitado: solo se admite el método basado en resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. +"seedream-5-5-261028": Dos métodos disponibles (no se pueden usar juntos). + Método 1 | Especifica la resolución. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K + Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915" y "seedream-5-5-261028" con layer_decomposition habilitado: solo se admite el método basado en resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. La imagen base se genera en la resolución especificada con la relación de aspecto de la imagen de entrada original; cada capa se genera cerca de la resolución especificada, manteniendo la relación de aspecto que tenía en la imagen original. auto: la salida se basa en el tamaño y la relación de aspecto de la imagen de entrada. Las entradas dentro de [1280x720, ~2048x2048] se generan con el tamaño original de entrada; las entradas menores que 1K se generan a 1K; las entradas mayores que 2K se generan a 2K. - Comfy Router fija en false un indicador stream proporcionado explícitamente, porque captura un resultado JSON completo. En el proxy v1, este campo controla si se habilita el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro y 5.0-flash no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve en cuanto se genera. + Comfy Router fija en false un indicador stream proporcionado explícitamente, porque captura un resultado JSON completo. En el proxy v1, este campo controla si se habilita el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro, 5.0-flash y 5.5 no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve en cuanto se genera. @@ -291,6 +315,10 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im Datos de la imagen codificados en Base64 (si response_format es "b64_json") + + El tipo de fondo que tiene realmente la imagen: transparente u opaco. En el escenario de separación de capas, la imagen base siempre es opaca y cada capa es transparente. Solo seedream-5.5 devuelve este campo. + + La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve únicamente cuando layer_decomposition es true. @@ -312,11 +340,11 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im - El formato de archivo de la imagen de salida. Solo seedream-5.0-pro admite este campo. + El formato de archivo de la imagen de salida. Solo seedream-5.0-pro y 5.5 admiten este campo. - El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 4.5 y 4.0 admiten este parámetro. + El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 5.5, 4.5 y 4.0 admiten este parámetro. @@ -354,7 +382,7 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im - El número de imágenes de entrada al modelo. Solo seedream-5.0-pro admite este campo. + El número de imágenes de entrada al modelo. Solo seedream-5.0-pro y 5.5 admiten este campo. diff --git a/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx b/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx index ef1fe3fb4a..eec487f18e 100644 --- a/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedream 5.0 260128 con Comfy Router" description: "Llama a byteplus/seedream-5-0-260128 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedream 5.0 260128" -translationSourceHash: 732cb981 +translationSourceHash: 48855510 translationFrom: development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx translationBlockHashes: "_intro": 38b28b26 "Quick start": c2f3039d - "Schema": 9f3bcfd2 + "Schema": be3a6de7 "Examples": b387e011 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -153,6 +154,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-260128/requests/$REQU ### Entrada + + Controla si la imagen generada tiene un fondo transparente (canal alfa). Es compatible con seedream-5.0-pro, 5.0-flash y los modelos Seedream más recientes cuyo propio esquema lo documente. +auto: El modelo decide a partir del prompt y de output_format. Con output_format jpeg, la salida siempre es opaca. +transparent: Genera una imagen RGBA con fondo transparente. Con output_format jpeg devuelve un error. +opaque: Genera una imagen RGB con fondo opaco. Es el valor predeterminado de seedream-5.0-pro. +seedream-5.0-pro solo admite la salida transparente en imagen a imagen, con una única imagen png de entrada que tenga canal alfa. +No se admite en el escenario de separación de capas: si lo pasas con layer_decomposition habilitado, devuelve un error. + + Valores posibles: `auto`, `transparent`, `opaque` + + Controla qué tan fielmente se alinea la imagen de salida con el prompt de entrada. Rango [1, 10]. Los valores más altos producen una mayor adherencia al prompt. No es compatible con seedream-5.0-pro, 5.0-lite, 4.5 y 4.0. @@ -177,24 +189,34 @@ Una imagen de entrada debe cumplir los siguientes requisitos: • Ancho y alto (px): > 14 • Tamaño: no más de 10 MB (30 MB para seedream-5.0-pro) • Píxeles totales: no más de 6000x6000 (36,000,000 px) para seedream-5.0-pro -• Máximo de 14 imágenes de referencia (10 para seedream-5.0-pro y 5.0-flash) +• Máximo de 14 imágenes de referencia (10 para seedream-5.0-pro, 5.0-flash y 5.5) -En el escenario de separación de capas (layer_decomposition habilitado), se requiere image y solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error). Las imágenes de entrada deben ser png, jpeg, webp, bmp, tiff o gif (no se admiten heic ni heif), de hasta 30 MB, con píxeles totales en el rango [512x512, 6000x6000] y relación de aspecto en [1/16, 16]. +En el escenario de separación de capas (layer_decomposition habilitado), image es requerido y solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error). Las imágenes de entrada deben ser png, jpeg, webp, bmp, tiff o gif (no se admiten heic ni heif), de hasta 30 MB, con píxeles totales en el rango [512x512, 6000x6000] y relación de aspecto en [1/16, 16]. - Controla si se habilita la separación de capas. Solo seedream-5.0-pro y 5.0-flash admiten este parámetro. -true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16) y devuelve la información de posición y contenido de cada capa generada, e incluye el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). + Controla si se habilita la separación de capas. Solo seedream-5.0-pro, 5.0-flash y 5.5 admiten este parámetro. +true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16; hasta 99 en seedream-5.5) y devuelve la información de posición y contenido de cada capa generada, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). false: Modo estándar de generación de imágenes; no se realiza separación de capas. -Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error); si alguna capa individual falla al generarse, toda la solicitud falla; no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si se pasan. +Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error); si alguna capa individual falla al generarse, toda la solicitud falla; no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). seedream-5.5 devuelve como máximo layer_decomposition_options.max_images imágenes (1 imagen base + hasta 99 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si se pasan. + + + + Opciones del modo de separación de capas. Solo seedream-5.5 admite este parámetro, y solo se aplica cuando layer_decomposition es true. + + + + El número total máximo de imágenes que devuelve esta solicitud, contando la imagen base y las capas. Rango: [2, 100]. Cuando el prompt no indica cómo dividir la imagen, el modelo planifica las capas a partir de max_images y de la complejidad de la imagen de entrada; un valor mayor suele dar capas más finas. + + Rango: `2` a `100` - Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 y seedream-5-0-flash-260915. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo; el proxy rechaza con un 400 cualquier otro valor, así como su omisión. NO está en la lista `required` de este esquema porque Comfy Router lo completa desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, por lo que quien llama a Router lo omite. + Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 y seedream-5-5-261028. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo; el proxy rechaza con un 400 cualquier otro valor, así como su omisión. NO está en la lista `required` de este esquema porque Comfy Router lo completa desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, por lo que quien llama a Router lo omite. - Configuración de la función de optimización de prompt. Solo seedream-5.0-pro/5.0-lite/4.5 (que solo admiten el modo standard) y seedream-4.0 admiten este parámetro. + Configuración de la función de optimización de prompt. Solo seedream-5.0-pro/5.0-lite/4.5/5.5 (que solo admiten el modo standard; seedream-5.5 devuelve un error con fast) y seedream-4.0 admiten este parámetro. @@ -204,30 +226,29 @@ Notas sobre el modo de separación de capas: solo se admite una única imagen de - Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash y 5.0-lite admiten este parámetro. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; cada capa siempre se genera como png. - + Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash, 5.0-lite y 5.5 admiten este parámetro. seedream-5.5 usa png de forma predeterminada. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; cada capa siempre se genera como png. Valores posibles: `png`, `jpeg` Descripción de texto para la generación o transformación de imágenes. -Opcional en el escenario de separación de capas (seedream-5.0-pro o 5.0-flash con layer_decomposition habilitado): si se proporciona un prompt, el modelo reconoce y separa los elementos que especificas según la intención del prompt; si no se proporciona ningún prompt, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. +Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o 5.5 con layer_decomposition habilitado): si se proporciona un prompt, el modelo reconoce y separa los elementos que especifiques según la intención del prompt; si no se proporciona un prompt, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. - Especifica el formato de la imagen generada que se devuelve en la respuesta. + Especifica el formato de la imagen generada que se devuelve en la respuesta Valores posibles: `url`, `b64_json` - Semilla aleatoria para controlar la estocasticidad de la generación de imágenes. Rango: [-1, 2147483647]. Si no se especifica, se generará automáticamente una semilla. Para reproducir la misma salida, usa el mismo valor de semilla. + Semilla aleatoria para controlar la estocasticidad de la generación de imágenes. Alcance: [-1, 2147483647]. Si no se especifica, se generará una semilla automáticamente. Para reproducir la misma salida, usa el mismo valor de semilla. - Rango: `-1` a `2147483647` + Alcance: `-1` a `2147483647` - Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro ni 5.0-flash). Valores válidos: + Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (seedream-5.0-pro, 5.0-flash o 5.5 no lo admiten). Valores válidos: auto: En modo automático, el modelo determina automáticamente si devolver varias imágenes y cuántas imágenes contendrá, según el prompt del usuario. disabled: Deshabilita la función de generación por lotes. El modelo solo generará una imagen. @@ -235,15 +256,14 @@ disabled: Deshabilita la función de generación por lotes. El modelo solo gener - -Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro y 5.0-flash no lo admiten). + Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro, 5.0-flash o 5.5 no lo admiten). Configuración de la función de generación de imágenes por lotes. Este parámetro solo tiene efecto cuando sequential_image_generation está establecido en auto. Especifica el número máximo de imágenes a generar en esta solicitud. Número de imágenes de referencia de entrada + Número de imágenes generadas ≤ 15. - Rango: `1` a `15` + Alcance: `1` a `15` @@ -262,13 +282,16 @@ Configuración de la función de generación de imágenes por lotes. Este parám "seedream-5-0-flash-260915": Hay dos métodos disponibles (no puedes usarlos juntos). Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] -"seedream-5-0-pro-260628" y "seedream-5-0-flash-260915" con layer_decomposition habilitado: Solo se admite el método basado en resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. +"seedream-5-5-261028": Hay dos métodos disponibles (no puedes usarlos juntos). + Método 1 | Especifica la resolución. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K + Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915" y "seedream-5-5-261028" con layer_decomposition habilitado: Solo se admite el método basado en resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. La imagen base se entrega con la resolución especificada y la relación de aspecto de la imagen de entrada original; cada capa se entrega con una resolución cercana a la especificada, conservando la relación de aspecto que tenía en la imagen original. auto: La salida se basa en el tamaño y la relación de aspecto de la imagen de entrada. Las entradas dentro de [1280x720, ~2048x2048] se entregan con el tamaño original de la entrada; las entradas menores que 1K se entregan con 1K; las entradas mayores que 2K se entregan con 2K. - Comfy Router establece en false un indicador de stream proporcionado explícitamente porque captura un resultado JSON completo. En el proxy v1, este campo controla si habilitar el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro y 5.0-flash no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. + Comfy Router establece en false un indicador de stream proporcionado explícitamente porque captura un resultado JSON completo. En el proxy v1, este campo controla si habilitar el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro, 5.0-flash o 5.5 no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. @@ -292,6 +315,10 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im Datos de imagen codificados en Base64 (si response_format es "b64_json") + + El tipo de fondo que realmente tiene la imagen: transparent u opaque. En el escenario de separación de capas, la imagen base siempre es opaca y cada capa es transparente. Solo seedream-5.5 devuelve este campo. + + La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve solo cuando layer_decomposition es verdadero. @@ -313,11 +340,11 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im - El formato de archivo de la imagen de salida. Solo seedream-5.0-pro admite este campo. + El formato de archivo de la imagen de salida. Solo seedream-5.0-pro y 5.5 admiten este campo. - El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 4.5 y 4.0 admiten este parámetro. + El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 5.5, 4.5 y 4.0 admiten este parámetro. @@ -355,7 +382,7 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im - El número de imágenes que se ingresan al modelo. Solo seedream-5.0-pro admite este campo. + El número de imágenes que se ingresan al modelo. Solo seedream-5.0-pro y 5.5 admiten este campo. diff --git a/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx b/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx index 6910b72787..af78389e36 100644 --- a/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedream 5.0 Flash 260915 con Comfy Router" description: "Llama a byteplus/seedream-5-0-flash-260915 con Comfy Router: endpoint, forma de la solicitud y respuesta." sidebarTitle: "Seedream 5.0 Flash 260915" -translationSourceHash: 7d74243a +translationSourceHash: 114a5dd9 translationFrom: development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx translationBlockHashes: "_intro": a1b4c447 "Quick start": 4f86c636 - "Schema": dab50eaf + "Schema": c220d381 "Examples": 36f49088 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-0-flash-260915.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -153,6 +154,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-flash-260915/requests ### Entrada + + Controla si la imagen generada tiene un fondo transparente (canal alfa). Es compatible con seedream-5.0-pro, 5.0-flash y los modelos Seedream más recientes cuyo propio esquema lo documenta. +auto: El modelo decide según el prompt y output_format. Con output_format jpeg, la salida siempre es opaca. +transparent: Genera una imagen RGBA con fondo transparente. Con output_format jpeg se devuelve un error. +opaque: Genera una imagen RGB con fondo opaco. Es el valor predeterminado de seedream-5.0-pro. +seedream-5.0-pro solo admite la salida transparente en imagen a imagen, con una única imagen png de entrada que tenga canal alfa. +No se admite en el escenario de separación por capas: si lo pasas con layer_decomposition habilitado, se devuelve un error. + + Valores posibles: `auto`, `transparent`, `opaque` + + Controla qué tan fielmente se alinea la imagen de salida con el prompt de entrada. Rango [1, 10]. Los valores más altos producen una mayor adherencia al prompt. No es compatible con seedream-5.0-pro, 5.0-lite, 4.5 y 4.0. @@ -166,18 +178,28 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-flash-260915/requests - Controla si la separación por capas está habilitada. Solo seedream-5.0-pro y 5.0-flash admiten este parámetro. -true: Modo de separación por capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). + Controla si la separación por capas está habilitada. Solo seedream-5.0-pro, 5.0-flash y 5.5 admiten este parámetro. +true: Modo de separación por capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16; hasta 99 en seedream-5.5) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). false: Modo estándar de generación de imágenes; no se realiza separación por capas. -Notas sobre el modo de separación por capas: solo se admite una única imagen de entrada (si pasas varias imágenes, se devuelve un error); si alguna capa individual no se genera, toda la solicitud falla, no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si se pasan. +Notas sobre el modo de separación por capas: solo se admite una única imagen de entrada (si pasas varias imágenes, se devuelve un error); si alguna capa individual no se genera, toda la solicitud falla, no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). seedream-5.5 devuelve como máximo layer_decomposition_options.max_images imágenes (1 imagen base + hasta 99 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si se pasan. + + + + Opciones para el modo de separación por capas. Solo seedream-5.5 admite este parámetro y se aplica únicamente cuando layer_decomposition es true. + + + + El número total máximo de imágenes que devuelve esta solicitud, contando la imagen base y las capas. Rango: [2, 100]. Cuando el prompt no indica cómo dividir la imagen, el modelo planifica las capas a partir de max_images y de la complejidad de la imagen de entrada; un valor mayor suele dar capas más finas. + + Rango: `2` a `100` - Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 y seedream-5-0-flash-260915. Una llamada v1 directa a POST /proxy/byteplus/api/v3/images/generations DEBE incluirlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` del esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama al Router lo omite. + Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 y seedream-5-5-261028. Una llamada v1 directa a POST /proxy/byteplus/api/v3/images/generations DEBE incluirlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` del esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama al Router lo omite. - Configuración de la función de optimización de prompt. Solo seedream-5.0-pro/5.0-lite/4.5 (que solo admiten el modo standard) y seedream-4.0 admiten este parámetro. + Configuración de la función de optimización de prompt. Solo seedream-5.0-pro/5.0-lite/4.5/5.5 (que solo admiten el modo standard; seedream-5.5 devuelve un error con fast) y seedream-4.0 admiten este parámetro. @@ -187,14 +209,14 @@ Notas sobre el modo de separación por capas: solo se admite una única imagen d - Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash y 5.0-lite admiten este parámetro. En el escenario de separación por capas, output_format solo controla el formato de la imagen base; todas las capas se emiten siempre como png. + Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash, 5.0-lite y 5.5 admiten este parámetro. seedream-5.5 usa png de forma predeterminada. En el escenario de separación por capas, output_format solo controla el formato de la imagen base; todas las capas se emiten siempre como png. Valores posibles: `png`, `jpeg` Descripción de texto para la generación o transformación de imágenes. -Opcional en el escenario de separación por capas (seedream-5.0-pro o 5.0-flash con layer_decomposition habilitado): si se proporciona un prompt, el modelo reconoce y separa los elementos que indiques según la intención del prompt; si no se proporciona ningún prompt, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. +Opcional en el escenario de separación por capas (seedream-5.0-pro, 5.0-flash o 5.5 con layer_decomposition habilitado): si se proporciona un prompt, el modelo reconoce y separa los elementos que indiques según la intención del prompt; si no se proporciona ningún prompt, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. @@ -210,26 +232,25 @@ Opcional en el escenario de separación por capas (seedream-5.0-pro o 5.0-flash - Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro ni 5.0-flash). Valores válidos: -auto: En el modo automático, el modelo determina por sí mismo si devuelve varias imágenes y cuántas contendrá, según el prompt del usuario. -disabled: Deshabilita la función de generación por lotes. El modelo solo generará una imagen. + Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos:auto: En modo automático, el modelo determina automáticamente, según el prompt del usuario, si debe devolver varias imágenes y cuántas imágenes incluirá. +disabled: Desactiva la función de generación por lote. El modelo solo generará una imagen. Valores posibles: `auto`, `disabled` - Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no es compatible con seedream-5.0-pro ni 5.0-flash). -Configuración de la función de generación de imágenes por lotes. Este parámetro solo tiene efecto cuando sequential_image_generation se establece en auto. + Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro, 5.0-flash y 5.5 no lo admiten). +Configuración de la función de generación de imágenes por lote. Este parámetro solo tiene efecto cuando sequential_image_generation se establece en auto. Especifica el número máximo de imágenes a generar en esta solicitud. Número de imágenes de referencia de entrada + Número de imágenes generadas ≤ 15. - Rango: `1` a `15` + Alcance: `1` a `15` - "seedream-4-0-250828": Establece la especificación de la imagen generada. Hay dos métodos disponibles, pero no se pueden usar juntos. + "seedream-4-0-250828": Define la especificación de la imagen generada. Hay dos métodos disponibles, pero no se pueden usar juntos. Método 1 | Especificar la resolución. Valores opcionales: 1K, 2K, 4K Método 2 | Especificar el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [1024x1024, 4096x4096], relación de aspecto: [1/16, 16] "seedream-4-5-251128": Hay dos métodos disponibles. @@ -239,18 +260,21 @@ Configuración de la función de generación de imágenes por lotes. Este parám Método 1 | Especificar la resolución. Valores opcionales: 2K, 3K Método 2 | Especificar el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [2560x1440, ~3072x3072], relación de aspecto: [1/16, 16] "seedream-5-0-pro-260628": Dos métodos disponibles (no se pueden usar juntos). - Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 2K - Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 1024x1024, total de píxeles: [1024x1024 (1048576), 2048x2048 (4194304)], relación de aspecto: [1/16, 16] + Método 1 | Especificar la resolución y describir en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 2K + Método 2 | Especificar el ancho y el alto en píxeles. Predeterminado: 1024x1024, píxeles totales: [1024x1024 (1048576), 2048x2048 (4194304)], relación de aspecto: [1/16, 16] "seedream-5-0-flash-260915": Dos métodos disponibles (no se pueden usar juntos). - Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K - Método 2 | Especifica el ancho y el alto en píxeles. Total de píxeles: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] -"seedream-5-0-pro-260628" y "seedream-5-0-flash-260915" con layer_decomposition habilitado: solo se admite el método basado en la resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. + Método 1 | Especificar la resolución y describir en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K + Método 2 | Especificar el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-5-261028": Dos métodos disponibles (no se pueden usar juntos). + Método 1 | Especificar la resolución. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K + Método 2 | Especificar el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915" y "seedream-5-5-261028" con layer_decomposition habilitado: solo se admite el método basado en la resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. La imagen base se genera con la resolución especificada y la relación de aspecto de la imagen de entrada original; cada capa se genera cerca de la resolución especificada, conservando la relación de aspecto que tenía en la imagen original. auto: la salida se basa en el tamaño y la relación de aspecto de la imagen de entrada. Las entradas dentro de [1280x720, ~2048x2048] se generan con el tamaño original de la entrada; las entradas menores que 1K se generan en 1K; las entradas mayores que 2K se generan en 2K. - Comfy Router fija en false un flag stream proporcionado explícitamente porque captura un resultado JSON completo. En el proxy v1, este campo controla si se habilita el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro y 5.0-flash no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. + Comfy Router establece en false el flag stream cuando se proporciona explícitamente, porque captura un resultado JSON completo. En el proxy v1, este campo controla si se habilita el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro, 5.0-flash y 5.5 no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. @@ -274,6 +298,10 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im Datos de imagen codificados en Base64 (si response_format es "b64_json") + + El tipo de fondo que tiene realmente la imagen: transparent u opaque. En el escenario de separación de capas, la imagen base siempre es opaque y cada capa es transparent. Solo seedream-5.5 devuelve este campo. + + La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve únicamente cuando layer_decomposition es true. @@ -295,11 +323,11 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im - El formato de archivo de la imagen de salida. Solo seedream-5.0-pro admite este campo. + El formato de archivo de la imagen de salida. Solo seedream-5.0-pro y 5.5 admiten este campo. - El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 4.5 y 4.0 admiten este parámetro. + El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 5.5, 4.5 y 4.0 admiten este parámetro. @@ -337,7 +365,7 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im - El número de imágenes de entrada al modelo. Solo seedream-5.0-pro admite este campo. + El número de imágenes de entrada al modelo. Solo seedream-5.0-pro y 5.5 admiten este campo. diff --git a/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx b/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx index 3d8283edd1..9a1cdcbc5c 100644 --- a/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedream 5.0 Pro 260628 con Comfy Router" description: "Llama a byteplus/seedream-5-0-pro-260628 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedream 5.0 Pro 260628" -translationSourceHash: a37309ff +translationSourceHash: f5270d3a translationFrom: development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx translationBlockHashes: "_intro": b9a1b857 "Quick start": 5b012c86 - "Schema": c3a86bb4 + "Schema": b6886a5f "Examples": 40c4bb92 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-0-pro-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -153,6 +154,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests/$ ### Entrada + + Controla si la imagen generada tiene un fondo transparente (canal alfa). Es compatible con seedream-5.0-pro, 5.0-flash y los modelos Seedream más recientes cuyo propio esquema lo documenta. +auto: El modelo decide a partir del prompt y de output_format. Con output_format jpeg, la salida siempre es opaca. +transparent: Devuelve una imagen RGBA con un fondo transparente. Con output_format jpeg se devuelve un error. +opaque: Devuelve una imagen RGB con un fondo opaco. Es el valor predeterminado de seedream-5.0-pro. +seedream-5.0-pro solo admite salida transparente para imagen a imagen, con una única imagen de entrada png que tenga canal alfa. +No se admite en el escenario de separación de capas: pasarlo con layer_decomposition habilitado devuelve un error. + + Posibles valores: `auto`, `transparent`, `opaque` + + Controla qué tan fielmente se alinea la imagen de salida con el prompt de entrada. Rango [1, 10]. Los valores más altos producen una mayor adherencia al prompt. No es compatible con seedream-5.0-pro, 5.0-lite, 4.5 y 4.0. @@ -166,18 +178,28 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests/$ - Controla si se habilita la separación de capas. Solo seedream-5.0-pro y 5.0-flash admiten este parámetro. -true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). + Controla si se habilita la separación de capas. Solo seedream-5.0-pro, 5.0-flash y 5.5 admiten este parámetro. +true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16; hasta 99 en seedream-5.5) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (z_index), la caja delimitadora (bounding_box), el nombre (name) y la descripción (description). false: Modo estándar de generación de imágenes; no se realiza separación de capas. -Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error); si alguna capa individual no se genera, toda la solicitud falla, no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si los pasas. +Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (pasar varias imágenes devuelve un error); si alguna capa individual no se genera, toda la solicitud falla, no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). seedream-5.5 devuelve como máximo layer_decomposition_options.max_images imágenes (1 imagen base + hasta 99 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si los pasas. + + + + Opciones para el modo de separación de capas. Solo seedream-5.5 admite este parámetro, y solo se aplica cuando layer_decomposition es true. + + + + El número total máximo de imágenes que devuelve esta solicitud, la imagen base y las capas juntas. Rango: [2, 100]. Cuando el prompt no indica cómo dividir la imagen, el modelo planifica las capas a partir de max_images y de la complejidad de la imagen de entrada; un valor mayor suele dar capas más finas. + + Rango: `2` a `100` - Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 y seedream-5-0-flash-260915. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo: el proxy rechaza cualquier otro valor y rechaza uno omitido con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde Router lo omite. + Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 y seedream-5-5-261028. Una llamada directa v1 a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo: el proxy rechaza cualquier otro valor y rechaza uno omitido con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde Router lo omite. - Configuración para la función de optimización del prompt. Solo seedream-5.0-pro/5.0-lite/4.5 (que solo admiten el modo standard) y seedream-4.0 admiten este parámetro. + Configuración para la función de optimización del prompt. Solo seedream-5.0-pro/5.0-lite/4.5/5.5 (que solo admiten el modo standard; seedream-5.5 devuelve un error con fast) y seedream-4.0 admiten este parámetro. @@ -187,14 +209,14 @@ Notas sobre el modo de separación de capas: solo se admite una única imagen de - Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash y 5.0-lite admiten este parámetro. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; cada capa siempre se genera como png. + Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash, 5.0-lite y 5.5 admiten este parámetro. seedream-5.5 usa png de forma predeterminada. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; cada capa siempre se genera como png. Posibles valores: `png`, `jpeg` Descripción de texto para la generación o transformación de imágenes. -Opcional en el escenario de separación de capas (seedream-5.0-pro o 5.0-flash con layer_decomposition habilitado): si incluyes un prompt, el modelo reconoce y separa los elementos que especifiques según la intención del prompt; si no incluyes ninguno, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. +Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o 5.5 con layer_decomposition habilitado): si proporcionas un prompt, el modelo reconoce y separa los elementos que especifiques según la intención del prompt; si no proporcionas ninguno, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. @@ -210,7 +232,7 @@ Opcional en el escenario de separación de capas (seedream-5.0-pro o 5.0-flash c - Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro ni 5.0-flash). Valores válidos: + Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos: auto: En el modo automático, el modelo determina automáticamente si devolver varias imágenes y cuántas imágenes contendrá según el prompt del usuario. disabled: Deshabilita la función de generación por lotes. El modelo solo generará una imagen. @@ -218,14 +240,14 @@ disabled: Deshabilita la función de generación por lotes. El modelo solo gener - Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no es compatible con seedream-5.0-pro ni 5.0-flash). -Configuración para la función de generación de imágenes por lotes. Este parámetro solo tiene efecto cuando sequential_image_generation se establece en auto. + Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro, 5.0-flash y 5.5 no lo admiten). +Configuración de la función de generación de imágenes por lotes. Este parámetro solo tiene efecto cuando sequential_image_generation está definido como auto. Especifica el número máximo de imágenes a generar en esta solicitud. Número de imágenes de referencia de entrada + Número de imágenes generadas ≤ 15. - Rango: `1` a `15` + Alcance: `1` a `15` @@ -240,17 +262,20 @@ Configuración para la función de generación de imágenes por lotes. Este par Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [2560x1440, ~3072x3072], relación de aspecto: [1/16, 16] "seedream-5-0-pro-260628": Dos métodos disponibles (no se pueden usar juntos). Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 2K - Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 1024x1024, total de píxeles: [1024x1024 (1048576), 2048x2048 (4194304)], relación de aspecto: [1/16, 16] + Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 1024x1024, píxeles totales: [1024x1024 (1048576), 2048x2048 (4194304)], relación de aspecto: [1/16, 16] "seedream-5-0-flash-260915": Dos métodos disponibles (no se pueden usar juntos). Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K - Método 2 | Especifica el ancho y el alto en píxeles. Total de píxeles: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] -"seedream-5-0-pro-260628" y "seedream-5-0-flash-260915" con layer_decomposition habilitado: Solo se admite el método basado en la resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. + Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-5-261028": Dos métodos disponibles (no se pueden usar juntos). + Método 1 | Especifica la resolución. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K + Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915" y "seedream-5-5-261028" con layer_decomposition habilitado: Solo se admite el método basado en la resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. La imagen base se genera en la resolución especificada con la relación de aspecto de la imagen de entrada original; cada capa se genera cerca de la resolución especificada, manteniendo la relación de aspecto que tenía en la imagen original. auto: La salida se basa en el tamaño y la relación de aspecto de la imagen de entrada. Las entradas dentro de [1280x720, ~2048x2048] se generan con el tamaño original de la entrada; las entradas menores que 1K se generan en 1K; las entradas mayores que 2K se generan en 2K. - Comfy Router fija en false un flag stream proporcionado explícitamente, ya que captura un resultado JSON completo. En el proxy v1, este campo controla si habilitar el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro y 5.0-flash no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. + Comfy Router fija en false un flag stream proporcionado explícitamente, ya que captura un resultado JSON completo. En el proxy v1, este campo controla si se habilita el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (seedream-5.0-pro, 5.0-flash y 5.5 no lo admiten). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. @@ -274,6 +299,10 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im Datos de imagen codificados en Base64 (si response_format es "b64_json") + + El tipo de fondo que realmente tiene la imagen: transparent u opaque. En el escenario de separación de capas, la imagen base siempre es opaque y cada capa es transparent. Solo seedream-5.5 devuelve este campo. + + La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve solo cuando layer_decomposition es true. @@ -295,11 +324,11 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im - El formato de archivo de la imagen de salida. Solo seedream-5.0-pro admite este campo. + El formato de archivo de la imagen de salida. Solo seedream-5.0-pro y 5.5 admiten este campo. - El ancho y el alto de la imagen en píxeles, con el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 4.5 y 4.0 admiten este parámetro. + El ancho y el alto de la imagen en píxeles, con el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 5.5, 4.5 y 4.0 admiten este parámetro. @@ -337,7 +366,7 @@ En el escenario de separación de capas, el primer elemento del arreglo es la im - El número de imágenes de entrada al modelo. Solo seedream-5.0-pro admite este campo. + El número de imágenes de entrada al modelo. Solo seedream-5.0-pro y 5.5 admiten este campo. diff --git a/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx b/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx new file mode 100644 index 0000000000..b683dd31d0 --- /dev/null +++ b/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx @@ -0,0 +1,408 @@ +--- +title: "Usa Seedream 5.5 261028 con Comfy Router" +description: "Llama a byteplus/seedream-5-5-261028 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Seedream 5.5 261028" +translationSourceHash: e2bff0d7 +translationFrom: development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx +translationBlockHashes: + "_intro": 5d72228c + "Quick start": 0a48e3d8 + "Schema": c4ff843e + "Examples": 2d76f48c +--- +{/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-5-261028.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API para `byteplus/seedream-5-5-261028`, servido por Comfy Router desde BytePlus. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. + +**ID del modelo:** `byteplus/seedream-5-5-261028` + +**Endpoint:** `POST https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "byteplus/seedream-5-5-261028", + { + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": False, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("byteplus/seedream-5-5-261028", { + prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", + response_format: "url", + watermark: false, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "byteplus/seedream-5-5-261028", + { + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": False, + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud fallida o cancelada lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("byteplus/seedream-5-5-261028", { + prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", + response_format: "url", + watermark: false, +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud fallida o cancelada se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Controla si la imagen generada tiene un fondo transparente (canal alfa). Es compatible con seedream-5.0-pro, 5.0-flash y los modelos Seedream más recientes cuyo propio esquema lo documenta. +auto: El modelo decide a partir del prompt y de output_format. Con output_format jpeg, la salida siempre es opaca. +transparent: Devuelve una imagen RGBA con fondo transparente. Con output_format jpeg la llamada devuelve un error. +opaque: Devuelve una imagen RGB con fondo opaco. Es el valor predeterminado de seedream-5.0-pro. +seedream-5.0-pro solo admite salida transparente en imagen a imagen, con una única imagen de entrada png que tenga canal alfa. +No se admite en el escenario de separación de capas: si lo envías con layer_decomposition habilitado, la llamada devuelve un error. + + Valores posibles: `auto`, `transparent`, `opaque` + + + + Controla cuánto se ajusta la imagen de salida al prompt de entrada. Alcance [1, 10]. Los valores más altos producen un mayor apego al prompt. No es compatible con seedream-5.0-pro, 5.0-lite, 4.5 ni 4.0. + + Alcance: `1` a `10` + + Formato: `float` + + + + La imagen o las imágenes que se van a editar, como una URL accesible o una carga útil Base64 con prefijo data-URI. Idéntico al campo compartido de Seedream salvo por el límite de imágenes de referencia, que en este modelo es 10 en lugar de 14. + + + + Controla si la separación de capas está habilitada. Solo seedream-5.0-pro, 5.0-flash y 5.5 admiten este parámetro. +true: Modo de separación de capas. El modelo descompone la única imagen de entrada en una imagen base más varias capas (hasta 16; hasta 99 en seedream-5.5) y devuelve la información de posición y contenido de cada capa producida, incluidos el orden de apilamiento (`z_index`), la caja delimitadora (`bounding_box`), el nombre (`name`) y la descripción (`description`). +false: Modo estándar de generación de imágenes; no se realiza separación de capas. +Notas sobre el modo de separación de capas: solo se admite una única imagen de entrada (si pasas varias imágenes, la llamada devuelve un error); si alguna capa individual no se genera, falla toda la solicitud, ya que no se admite el éxito parcial; se devuelven como máximo 17 imágenes (1 imagen base + 16 capas). seedream-5.5 devuelve como máximo layer_decomposition_options.max_images imágenes (1 imagen base + hasta 99 capas). sequential_image_generation, sequential_image_generation_options, tools y stream devuelven un error si se pasan. + + + + Opciones del modo de separación de capas. Solo seedream-5.5 admite este parámetro y solo se aplica cuando layer_decomposition es true. + + + + El número total máximo de imágenes que devuelve esta solicitud, contando la imagen base y las capas. Alcance: [2, 100]. Cuando el prompt no indica cómo dividir la imagen, el modelo planifica las capas a partir de max_images y de la complejidad de la imagen de entrada; un valor mayor suele dar capas más finas. + + Alcance: `2` a `100` + + + + Identificador del modelo. Modelos admitidos: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 y seedream-5-5-261028. Una llamada v1 directa a POST /proxy/byteplus/api/v3/images/generations DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO aparece en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a Router lo omite. + + + + Configuración de la función de optimización de prompt. Solo seedream-5.0-pro/5.0-lite/4.5/5.5 (solo admiten el modo estándar; seedream-5.5 devuelve un error con fast) y seedream-4.0 admiten este parámetro. + + + + Define el modo de la función de optimización de prompt. standard = Mayor calidad y más tiempo de generación. fast = Más rápido, pero con una calidad más promedio. + + Valores posibles: `standard`, `fast` + + + + Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash, 5.0-lite y 5.5 admiten este parámetro. seedream-5.5 usa png de forma predeterminada. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; todas las capas se devuelven siempre como png. + + Valores posibles: `png`, `jpeg` + + + + Descripción de texto para la generación o transformación de la imagen. +Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o 5.5 con layer_decomposition habilitado): si proporcionas un prompt, el modelo reconoce y separa los elementos que indiques según la intención del prompt; si no proporcionas ninguno, el modelo detecta automáticamente todos los elementos principales de la imagen y los separa en capas independientes. + + + + Especifica el formato de la imagen generada que se devuelve en la respuesta + + Valores posibles: `url`, `b64_json` + + + + Semilla aleatoria para controlar la estocasticidad de la generación de imágenes. Alcance: [-1, 2147483647]. Si no se especifica, se genera una semilla automáticamente. Para reproducir la misma salida, usa el mismo valor de semilla. + + Alcance: `-1` a `2147483647` + + + + Controla si se deshabilita la función de generación por lote. Este parámetro solo se admite en seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos:auto: En modo automático, el modelo determina automáticamente si devuelve varias imágenes y cuántas imágenes contendrá cada una, según el prompt del usuario. +disabled: Desactiva la función de generación por lote. El modelo solo generará una imagen. + + Valores posibles: `auto`, `disabled` + + + + Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no lo admiten seedream-5.0-pro, 5.0-flash ni 5.5). +Configuración de la función de generación de imágenes por lote. Este parámetro solo tiene efecto cuando sequential_image_generation está establecido en auto. + + + + Especifica el número máximo de imágenes a generar en esta solicitud. Número de imágenes de referencia de entrada + Número de imágenes generadas ≤ 15. + + Alcance: `1` a `15` + + + + "seedream-4-0-250828": Establece la especificación de la imagen generada. Hay dos métodos disponibles, pero no se pueden usar juntos. + Método 1 | Especifica la resolución. Valores opcionales: 1K, 2K, 4K + Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [1024x1024, 4096x4096], relación de aspecto: [1/16, 16] +"seedream-4-5-251128": Dos métodos disponibles. + Método 1 | Especifica la resolución. Valores opcionales: 2K, 4K + Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [2560x1440, 4096x4096], relación de aspecto: [1/16, 16] +"seedream-5-0-260128": Dos métodos disponibles. + Método 1 | Especifica la resolución. Valores opcionales: 2K, 3K + Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 2048x2048, píxeles totales: [2560x1440, ~3072x3072], relación de aspecto: [1/16, 16] +"seedream-5-0-pro-260628": Dos métodos disponibles (no se pueden usar juntos). + Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 2K + Método 2 | Especifica el ancho y el alto en píxeles. Predeterminado: 1024x1024, píxeles totales: [1024x1024 (1048576), 2048x2048 (4194304)], relación de aspecto: [1/16, 16] +"seedream-5-0-flash-260915": Dos métodos disponibles (no se pueden usar juntos). + Método 1 | Especifica la resolución y describe en el prompt la relación de aspecto, la forma o el propósito de la imagen; el modelo decide el tamaño final. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K + Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-5-261028": Dos métodos disponibles (no se pueden usar juntos). + Método 1 | Especifica la resolución. Valores opcionales: 1K, 1.5K, 2K. Predeterminado: 2K + Método 2 | Especifica el ancho y el alto en píxeles. Píxeles totales: [1280x720 (921600), 2048x2048x1.1025 (4624220)], relación de aspecto: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915" y "seedream-5-5-261028" con layer_decomposition habilitado: Solo se admite el método basado en la resolución. Valores opcionales: 1K, 1.5K, 2K, auto. Predeterminado: auto. + La imagen base se genera a la resolución especificada con la relación de aspecto de la imagen de entrada original; cada capa se genera cerca de la resolución especificada, manteniendo la relación de aspecto que tenía en la imagen original. + auto: La salida se basa en el tamaño y la relación de aspecto de la imagen de entrada. Las entradas dentro de [1280x720, ~2048x2048] se generan con el tamaño original de entrada; las entradas menores de 1K se generan a 1K; las entradas mayores de 2K se generan a 2K. + + + + Comfy Router fija en false un flag stream proporcionado explícitamente porque captura un resultado JSON completo. En el proxy v1, este campo controla si se habilita el modo de salida en streaming. Solo seedream-5.0-lite, 4.5 y 4.0 admiten este parámetro (no lo admiten seedream-5.0-pro, 5.0-flash ni 5.5). false = Todas las imágenes de salida se devuelven a la vez. true = Cada imagen de salida se devuelve inmediatamente después de generarse. + + + + Especifica si se agrega una marca de agua a la imagen generada. false = Sin marca de agua, true = Agrega una marca de agua con la etiqueta 'AI generated' + + +Generado a partir del esquema que Router publica en `GET /v2/models/byteplus/seedream-5-5-261028/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Marca de tiempo Unix (en segundos) que indica la hora en que se creó la solicitud + + + + Contiene información sobre las imágenes generadas. +En el escenario de separación de capas, el primer elemento del arreglo es la imagen base (z_index=0) y los elementos siguientes son las capas, ordenadas por z_index creciente. + + + + Datos de la imagen codificados en Base64 (si response_format es "b64_json") + + + + El tipo de fondo que realmente tiene la imagen: transparent u opaque. En el escenario de separación de capas, la imagen base siempre es opaca y cada capa es transparente. Solo seedream-5.5 devuelve este campo. + + + + La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve solo cuando layer_decomposition es true. + + + + Las coordenadas absolutas en píxeles de la caja delimitadora de la capa, en el sistema de coordenadas de la imagen base de salida, con la esquina superior izquierda en (0, 0). Formato de coordenadas: [left, top, right, bottom]. + + + + Las coordenadas cuantizadas por mil (normalizadas) de la caja delimitadora de la capa, asignadas proporcionalmente a un rango entero discreto de [0, 1000] según el tamaño de la imagen base y truncadas a un máximo de 1000. Formato de coordenadas: [left, top, right, bottom]. + + + + Una descripción detallada del elemento separado actual, que ofrece características de capa más ricas (como color, estado y material) que name. Solo las capas devuelven este campo; la imagen base no lo hace. Se devuelve solo cuando layer_decomposition es true. + + + + El nombre o etiqueta del elemento separado actual, generado automáticamente por el modelo a partir de las características del sujeto separado. Solo las capas devuelven este campo; la imagen base no lo hace. Se devuelve solo cuando layer_decomposition es true. + + + + El formato de archivo de la imagen de salida. Solo seedream-5.0-pro y 5.5 admiten este campo. + + + + El ancho y el alto de la imagen en píxeles, en el formato \x\. Solo seedream-5.0-pro, 5.0-lite, 5.5, 4.5 y 4.0 admiten este parámetro. + + + + URL para descargar la imagen (si response_format es "url") + + Formato: `uri` + + + + El orden de apilamiento de la capa, que aumenta de abajo hacia arriba: 0 es la capa más baja (la imagen base) y los valores mayores quedan más arriba. Úsalo para recomponer las capas en la imagen completa con el orden de apilamiento correcto. Se devuelve solo cuando layer_decomposition es true. + + + + Información de error (si existe) + + + + Código de error del ModelArk de origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por punto, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Es una cadena abierta, no una enumeración: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas HTTP 200 de tareas fallidas, sin sobrescribir los fallos de transporte. + + + + Mensaje de error + + + + El ID del modelo usado para la solicitud + + + + + + + + Número de imágenes generadas por el modelo + + + + El número de imágenes de entrada al modelo. Solo seedream-5.0-pro y 5.5 admiten este campo. + + + + El número de tokens usados para la imagen generada por el modelo. + + + + El número total de tokens consumidos por esta solicitud. + + +## Ejemplos + +### Entrada + +```json +{ + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": false +} +``` + +### Salida + +```json +{ + "created": 1767225600, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/byteplus/seedream-4-0-250828/generated.png" + } + ], + "model": "seedream-5-5-261028", + "usage": { + "generated_images": 1 + } +} +``` + + diff --git a/es/development/comfy-router/models/meshy/rigging/code.mdx b/es/development/comfy-router/models/meshy/rigging/code.mdx index 086b6e6d25..0b9be595f9 100644 --- a/es/development/comfy-router/models/meshy/rigging/code.mdx +++ b/es/development/comfy-router/models/meshy/rigging/code.mdx @@ -2,14 +2,15 @@ title: "Usa Rigging con Comfy Router" description: "Llama a meshy/rigging con Comfy Router: endpoint, forma de la solicitud y respuesta del Router." sidebarTitle: "Rigging" -translationSourceHash: d7eb966f +translationSourceHash: e8dbb3d3 translationFrom: development/comfy-router/models/meshy/rigging/code.mdx translationBlockHashes: "_intro": 2ec24f71 "Quick start": 08a075b7 - "Schema": 2d8d7dbb + "Schema": 66703709 "Examples": 8e91e01b --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/meshy/rigging.json mediante `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -155,6 +156,10 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ Rango: `0` a `…` + + Si se añaden huesos de dedos a las manos del personaje. Solo para rig bípedo; con texture_image_url, un rig cuadrúpedo o un input_task_id de topología quad, Meshy rechaza la solicitud con 400, y con un modelo que solo puede riggear sin dedos, con 422 (sin cargo). Los huesos de dedos no cambian el costo en créditos. El valor predeterminado es falso. + + La tarea de entrada que necesita rigging. Requerido si no se proporciona `model_url`. @@ -163,6 +168,12 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ Una URL o Data URI de acceso público a un archivo GLB humanoide con textura. Requerido si no se proporciona `input_task_id`. + + El esqueleto para el personaje con rigging, que define los nombres de sus huesos y su jerarquía. Solo para rig bípedo. Con un valor distinto de meshyrig (o con include_fingers en true), los archivos de salida están en metros y usan los huesos de ese esqueleto en lugar de los archivos meshyrig predeterminados de 24 huesos en centímetros; una tarea de animación creada a partir de este rig usa el mismo esqueleto. Cualquier otro valor se rechaza. El valor predeterminado es meshyrig. + + Valores posibles: `meshyrig`, `mixamo`, `ue5_mannequin`, `max_biped`, `unity_humanoid`, `maya_human_ik`, `blender_rigify_basic_human`, `cc5_hd_neutral_base`, `daz_genesis9` + + La imagen de textura de color base del modelo con UV desplegado. URL o Data URI de acceso público. Admite formato .png. diff --git a/es/development/serverless/library-models.mdx b/es/development/serverless/library-models.mdx new file mode 100644 index 0000000000..93cb5f1719 --- /dev/null +++ b/es/development/serverless/library-models.mdx @@ -0,0 +1,171 @@ +--- +title: "Modelos de la biblioteca del espacio de trabajo en un despliegue de Comfy API" +sidebarTitle: "Modelos de la biblioteca" +description: "Sube un LoRA u otro modelo .safetensors a la biblioteca de tu espacio de trabajo y ejecútalo en un despliegue de Comfy API sin nuevo Build, Release ni redeploy." +icon: "folder-open" +translationSourceHash: ece5d691 +translationFrom: development/serverless/library-models.mdx +translationBlockHashes: + "_intro": 6a0b3555 + "Before you start": c7b9ddf9 + "Upload a model to the workspace library": 693a12a3 + "Run the model on your deployment": 8b7df85e + "Follow the limits and naming rules": 5b0d3461 + "Change or delete a library model": dda1b7bd +--- +Comfy API ejecuta modelos desde la biblioteca de tu espacio de trabajo, incluso cuando el Release del despliegue no los incluye. Sube un LoRA u otro modelo `.safetensors` a la biblioteca y ejecútalo en tu despliegue sin crear un nuevo Build o Release ni volver a desplegar. + +Usa la biblioteca del espacio de trabajo para probar un LoRA que entrenaste en tu despliegue, o para elegir un LoRA distinto para cada solicitud a la API cambiando un nombre de archivo en el flujo de trabajo. + +## Antes de empezar + +Antes de subir un modelo a la biblioteca del espacio de trabajo, asegúrate de cumplir estos requisitos: + +- **Plan**: tu espacio de trabajo necesita un plan Pro, Creator, Team o Enterprise activo. +- **Archivo del modelo**: el archivo debe ser un `.safetensors` de 2 GB o menos. Los modelos base más grandes, como SDXL o Flux, aún van en el Build. +- **Una implementación activa**: la implementación debe estar en el mismo espacio de trabajo que la biblioteca. + + + Algunas implementaciones creadas antes de que los modelos de la biblioteca del espacio de trabajo estuvieran disponibles no pueden cargarlos. Para usar los modelos de la biblioteca del espacio de trabajo, crea una nueva implementación. En una implementación más antigua, una tarea puede fallar con `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` + + +## Subir un modelo a la biblioteca del espacio de trabajo + +Puedes subir un modelo con cualquiera de estas tres herramientas: + +- **Editor de Cloud**: sube un archivo o importa desde un enlace de Civitai o Hugging Face. +- **comfy-cli**: sube desde una terminal o un script. +- **Developer Platform**: sube desde el paso de modelos de un Build. + +Elige la pestaña de la herramienta que uses. + + + + 1. En el menú de despliegue a la izquierda de **Run**, asegúrate de que **Comfy Cloud** esté seleccionado en **Run on**. + 2. En la **barra lateral izquierda**, haz clic en **Model Library** y luego en **Import**. + 3. Haz clic en **Choose a file** o arrastra un archivo `.safetensors` al cuadro de diálogo. + 4. En **What type of model is this?**, deja **LoRA** si es una LoRA o selecciona el tipo que coincida con el archivo. + 5. Haz clic en **Upload**. Cuando termine la subida, haz clic en **Finish**. + + ![Diálogo Import a model con my_style_lora_9e2417.safetensors (97.37 MB) seleccionado, What type of model is this? establecido en LoRA, y los botones Back y Upload](/images/development/serverless/library-models-editor-import.png) + + Para importar un modelo desde un enlace de Civitai o Hugging Face: + + 1. En el diálogo **Import**, pega el enlace del modelo en **Paste link here**. + 2. Haz clic en **Continue**. + 3. En **What type of model is this?**, selecciona el tipo de modelo. + 4. Haz clic en **Import**. + + Solo los archivos `.safetensors` se ejecutan en un despliegue. Si importas un enlace en otro formato, como `.ckpt`, el modelo entra en la biblioteca pero no se ejecuta en un despliegue. + + + Sube el archivo y define su tipo de modelo con `--type`: + + ```bash + comfy assets library upload my_style.safetensors --type loras + ``` + + Verifica que el archivo esté en la biblioteca: + + ```bash + comfy assets library ls --tags models,loras + ``` + + + 1. En la Developer Platform, abre el paso de modelos de un Build y haz clic en **Upload Models**. + 2. Selecciona **Workspace library**. + 3. Arrastra un archivo `.safetensors` al área de carga o haz clic en el área para explorar. + 4. En **Model type**, deja **LoRA** si es una LoRA o selecciona el tipo que coincida con el archivo. + 5. Haz clic en **Upload**. + + ![Diálogo Upload Models en el paso Which models ship inside the build? de un Build, con las pestañas Public, Private y Workspace library, Workspace library seleccionado, la zona para soltar archivos, Model type establecido en LoRA, una línea que indica que el archivo está en tu biblioteca del espacio de trabajo, y los botones Cancel y Upload](/images/development/serverless/library-models-platform-upload.png) + + + +Todos los miembros del espacio de trabajo pueden usar el modelo una vez que está en la biblioteca. La biblioteca acepta cualquier tipo de modelo, no solo LoRAs. Elige el tipo que coincida con la carpeta que lee tu nodo de carga, como `loras` para una LoRA o `vae` para un VAE. + +## Ejecutar el modelo en tu implementación + +Una vez que el modelo está en la biblioteca, puedes ejecutarlo en tu implementación desde el editor de Cloud o a través de la API. Elige la pestaña según cómo envíes las tareas. + + + + 1. Haz clic en el menú de implementación a la izquierda de **Run**. En **Run on**, selecciona tu implementación. El editor se recarga y tus pestañas permanecen abiertas. + 2. Agrega un nodo `Load LoRA (Model and CLIP)` o abre un flujo de trabajo que contenga uno. + 3. En la lista `lora_name` del nodo, selecciona tu archivo. La lista muestra los modelos de tu biblioteca junto a los modelos de la Release. + 4. Haz clic en **Run**. + + En la primera ejecución, la fila de la tarea en la cola muestra `Downloading my_style.safetensors` mientras el worker descarga el archivo. Cuando la tarea descarga varios modelos, la fila muestra `Downloading ( of )`. + + ![Flujo de trabajo con los nodos Load Checkpoint y Load LoRA (Model and CLIP), el LoRA subido seleccionado en lora_name, y la fila superior del panel de cola mostrando Downloading my_style_lora_9e2417.safetensors 0 B of 97.37 MB](/images/development/serverless/library-models-editor-downloading.png) + + + En el [flujo de trabajo en formato API](/es/development/api-development/workflow-api-format), establece la entrada `lora_name` del nodo `LoraLoader` con el nombre del archivo de la biblioteca, incluida la extensión `.safetensors`: + + ```json + "10": { + "class_type": "LoraLoader", + "inputs": { + "lora_name": "my_style.safetensors", + "strength_model": 1.0, + "strength_clip": 1.0, + "model": ["4", 0], + "clip": ["4", 1] + } + } + ``` + + Envía el flujo de trabajo con `comfy deploy run`, los [SDK de Comfy](/es/development/api-development/sdks) o la [Comfy API v2](/es/api-reference/v2/overview): + + ```bash + comfy deploy run --deployment --workflow workflow_api.json + ``` + + Para usar un LoRA diferente, cambia `lora_name` por otro nombre de archivo de tu biblioteca en la siguiente solicitud. No necesitas un nuevo Build, Release ni volver a implementar. + + + + + La primera tarea en un worker que usa un modelo de la biblioteca tarda más, porque el worker descarga el modelo primero. Las tareas posteriores en el mismo worker usan la copia en caché. Un worker nuevo descarga el modelo otra vez, y también lo hace un worker que eliminó el modelo de su caché para hacer espacio a otros modelos. Para saltar la descarga, agrega el modelo al Build. + + +## Cumplir los límites y las reglas de nomenclatura + +Además de los límites de tamaño de archivo y formato en [Antes de empezar](#antes-de-empezar), se aplican estos límites: + +| Límite | Valor | +| --- | --- | +| Almacenamiento del espacio de trabajo | 1 TB de modelos por espacio de trabajo, incluidas las importaciones por enlace | +| Nombres de modelos de la biblioteca por flujo de trabajo | 100 | + +Un cargador que nombra un modelo de biblioteca número 101 falla como si el archivo no estuviera en la biblioteca. + +Sigue estas reglas para que una tarea encuentre el archivo correcto: + +- **Usa la carpeta que lee el cargador.** Un cargador solo encuentra archivos de biblioteca de su propio tipo de modelo. Un nodo `Load LoRA` encuentra archivos subidos como `loras`, no como `checkpoints`. +- **Usa el nombre del archivo sin ruta.** Establece la entrada del cargador solo en el nombre del archivo, como `my_style.safetensors`, sin ninguna carpeta delante. +- **No reutilices el nombre de un modelo de una Release.** Si la Release ya tiene un archivo con ese nombre, el worker usa el archivo de la Release, no tu archivo de biblioteca. +- **Mantén los nombres únicos entre carpetas.** Si la biblioteca tiene el mismo nombre de archivo en dos carpetas que lee un solo cargador, una tarea enviada a través de la API no carga ninguno de los dos archivos. +- **Espera que gane el archivo más reciente.** Si la biblioteca tiene dos archivos con el mismo nombre en una carpeta, las tareas usan el que se agregó al final. +- **Haz coincidir el modelo base.** Un LoRA debe coincidir con el modelo base que carga el flujo de trabajo. +- **Usa un cargador disponible en el despliegue.** El nodo de carga debe estar disponible en el despliegue. Los modelos de biblioteca solo se cargan mediante nodos de carga que Comfy Cloud tenga. Si tu cargador viene de un nodo personalizado que Comfy Cloud no tiene, agrega sus modelos al Build. + +## Cambiar o eliminar un modelo de la biblioteca + +Cuando hay una implementación seleccionada en **Run on**, la **Biblioteca de modelos** muestra solo los modelos de la Release. Para cambiar o eliminar un modelo de la biblioteca, primero vuelve a Comfy Cloud: + +1. Haz clic en el menú de implementación a la izquierda de **Run**. En **Run on**, selecciona **Comfy Cloud**. +2. En la **barra lateral izquierda**, haz clic en **Biblioteca de modelos**. + +Para cambiar el tipo de modelo: + +- Pasa el cursor sobre la tarjeta del modelo, haz clic en **Información del modelo** y selecciona un nuevo **Tipo de modelo**. + + + Eliminar un modelo lo quita de la biblioteca del espacio de trabajo para todos los miembros. Una tarea o solicitud de API que todavía nombre el archivo falla con un error `Value not in list` en la entrada del loader. + + +Para eliminar el modelo: + +1. Pasa el cursor sobre la tarjeta del modelo, haz clic en **Más** y luego en **Eliminar**. +2. En **¿Eliminar este modelo?**, haz clic en **Eliminar**. diff --git a/es/development/serverless/overview.mdx b/es/development/serverless/overview.mdx index 22b7902bb9..41577f9ba0 100644 --- a/es/development/serverless/overview.mdx +++ b/es/development/serverless/overview.mdx @@ -3,11 +3,11 @@ title: "Guía de despliegue de Comfy API" sidebarTitle: "Guía de despliegue" description: "Despliega flujos de ComfyUI en endpoints GPU: Builds, versiones, regiones, escalado de workers, límites del espacio de trabajo y monitorización del despliegue." icon: "cloud-arrow-up" -translationSourceHash: 2184a3a5 +translationSourceHash: 4df17332 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 - "Platform concepts": 97134dfe + "Platform concepts": cd4243ce "The Build file": 70f351b1 "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f @@ -15,10 +15,11 @@ translationBlockHashes: "Monitor and call a deployment": ff860dab "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b - "FAQ": 54896279 + "FAQ": 08ef9084 "Next steps": 0045baa9 --- + Comfy API permite que tu aplicación ejecute flujos de trabajo de ComfyUI a través de un endpoint gestionado. Empaquetas la versión de ComfyUI, los modelos, los nodos personalizados y las dependencias que necesita el flujo de trabajo, y luego Comfy lo ejecuta en GPUs gestionadas. Úsalo cuando necesites un entorno repetible y un endpoint al que tu aplicación pueda llamar. ## Conceptos de la plataforma @@ -32,6 +33,8 @@ Comfy API permite que tu aplicación ejecute flujos de trabajo de ComfyUI a trav Los flujos de trabajo compatibles con [Comfy Cloud](/es/development/deploy/cloud) pueden ejecutarse allí sin crear un Build ni un despliegue. +Para agregar un modelo a un despliegue sin crear un Build nuevo, súbelo a la biblioteca de tu espacio de trabajo. Consulta [Modelos de la biblioteca del espacio de trabajo](/es/development/serverless/library-models). + Comienza con un agente o elige otra forma de proporcionar tu entorno o flujo de trabajo. @@ -47,6 +50,7 @@ Comprueba cómo se compara el Build local con la instalación y la versión remo ```bash comfy build status ``` + ## Actualizar y publicar una versión Después de cambiar la instalación local, actualiza la definición de Build: @@ -67,6 +71,7 @@ Sigue el registro de compilación de una versión con: ```bash comfy build release logs rel_123456 --target linux/nvidia --follow ``` + ## Regiones y disponibilidad de GPU La capacidad de las regiones cambia, así que consulta el catálogo de la plataforma cuando elijas un objetivo de despliegue. Filtra los resultados con `--region `: @@ -97,6 +102,7 @@ comfy deploy scale --deployment dep_123456 --min 2 --max 5 comfy deploy stop --deployment dep_123456 comfy deploy start --deployment dep_123456 ``` + ## Inspeccionar y limpiar ```bash @@ -130,7 +136,7 @@ comfy deploy events --deployment dep_123456 La facturación de almacenamiento comienza con un despliegue: - - Cuando despliegas un release, sus modelos se preparan en el almacenamiento en red que comparten los workers del despliegue. Ese almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con `comfy deploy stop`. + - Cuando despliegas un release, sus modelos se preparan en el almacenamiento en red que comparten los workers del despliegue. Ese almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con `comfy deploy stop`. Los modelos que una tarea usa de tu [biblioteca del espacio de trabajo](/es/development/serverless/library-models) no se preparan allí. El worker los descarga para la tarea. - Cada worker también recibe un disco de contenedor fijo de 50 GB. Es efímero y solo se factura mientras el worker está en ejecución, como parte del costo de cómputo del worker. - Eliminar un despliegue libera su cómputo. El almacenamiento en red preparado se limpia poco después de eliminar el último despliegue que lo usa en esa región, y la facturación correspondiente termina. diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index 8dcb7e4ba9..76bed33d95 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -2,16 +2,16 @@ title: "Comfy Router モデル" sidebarTitle: "すべてのモデル" description: "Comfy Router で利用できるすべてのモデルを、各モデルの入力と出力のモダリティとあわせて、プロバイダー別にまとめています。" -translationSourceHash: 947ab0cb +translationSourceHash: 04ecf050 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 47e9d047 + "Find by output": 2dfd8d42 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 - "BytePlus": 0ff87da0 + "BytePlus": 0767a672 "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 @@ -48,6 +48,7 @@ translationBlockHashes: + {/* 生成済みファイル。Router カタログから `pnpm code-pages:gen` によって生成されます。 */} 以下に挙げるすべてのモデルは、同じルート `POST /v2/models/{provider}/{model}` で提供され、それぞれのモデル固有の JSON ボディを使用します。各ページには、Python、TypeScript、cURL で動作するリクエスト例を掲載しています。ディスカバリー、スキーマ、エラー、リトライ、課金については、[Comfy Router API の使用](/ja/development/comfy-router/api) を参照してください。 @@ -109,8 +110,7 @@ translationBlockHashes: - [Gen 4 Turbo](/ja/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ja/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [Clean Audio Video](/ja/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`- [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ja/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ja/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` - [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` @@ -142,7 +142,7 @@ translationBlockHashes: - [Grok Imagine Video](/ja/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/ja/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -164,8 +164,7 @@ translationBlockHashes: - [Image Edit Increase Resolution](/ja/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/ja/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/ja/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` -- [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ja/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ja/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -177,6 +176,7 @@ translationBlockHashes: - [Seedream 5.0 260128](/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code): `byteplus/seedream-5-0-260128` - [Seedream 5.0 Flash 260915](/ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code): `byteplus/seedream-5-0-flash-260915` - [Seedream 5.0 Pro 260628](/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code): `byteplus/seedream-5-0-pro-260628` +- [Seedream 5.5 261028](/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code): `byteplus/seedream-5-5-261028` - [Crystal Upscaler](/ja/development/comfy-router/models/fal/crystal-upscaler/code): `fal/crystal-upscaler` - [Patina](/ja/development/comfy-router/models/fal/patina/code): `fal/patina` - [AI Image Upscaler Precision V2](/ja/development/comfy-router/models/freepik/ai-image-upscaler-precision-v2/code): `freepik/ai-image-upscaler-precision-v2` @@ -214,8 +214,7 @@ translationBlockHashes: - [Qwen Image 3.0](/ja/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/ja/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` - [Recraft V3](/ja/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` -- [Recraft V4.1 Pro](/ja/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` +- [Recraft V4.1 Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector`- [Recraft V4.1 Pro](/ja/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/ja/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code): `recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code): `recraft/recraftv4_1_utility_vector` @@ -266,8 +265,7 @@ translationBlockHashes: - [FLUX 3 Video](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` -- [Dreamina Seedance 2.0 Mini](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128`- [Dreamina Seedance 2.0 Mini](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/ja/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/ja/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` @@ -324,8 +322,7 @@ translationBlockHashes: - [Stable Fast 3D](/ja/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ja/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` - [Hunyuan 3D Part](/ja/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/ja/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` -- [Hunyuan 3D Texture Edit](/ja/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` +- [Hunyuan 3D Smart Topology](/ja/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology`- [Hunyuan 3D Texture Edit](/ja/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/ja/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` @@ -468,6 +465,7 @@ translationBlockHashes: | [Seedream 5.0 260128](/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | テキスト, 画像 | 画像 | | [Seedream 5.0 Flash 260915](/ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code) | `byteplus/seedream-5-0-flash-260915` | テキスト, 画像 | 画像 | | [Seedream 5.0 Pro 260628](/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | テキスト, 画像 | 画像 | +| [Seedream 5.5 261028](/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | テキスト, 画像 | 画像 | ## Elevenlabs diff --git a/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index eb4dfb1e49..93bca7f92f 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Seedream 4.0 250828 を使う" description: "Comfy Router 経由で byteplus/seedream-4-0-250828 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンス。" sidebarTitle: "Seedream 4.0 250828" -translationSourceHash: a0e25650 +translationSourceHash: 0e2de27d translationFrom: development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx translationBlockHashes: "_intro": 3d37b29e "Quick start": 38e0a75b - "Schema": b45c3a02 + "Schema": 66ccdc55 "Examples": ac35d592 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-4-0-250828.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -156,6 +157,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQU ### 入力 + + 生成済み画像の背景を透明(アルファチャンネル)にするかどうかを制御します。seedream-5.0-pro、5.0-flash、および自身のスキーマでこのパラメータが記載されている新しい Seedream モデルでサポートされています。 +auto: モデルがプロンプトと output_format から判断します。output_format が jpeg の場合、出力は常に不透明になります。 +transparent: 背景が透明な RGBA 画像を出力します。output_format が jpeg の場合はエラーが返ります。 +opaque: 背景が不透明な RGB 画像を出力します。seedream-5.0-pro のデフォルトです。 +seedream-5.0-pro は、アルファチャンネルを持つ png 入力画像 1 枚を用いた画像から画像への変換でのみ、透明出力をサポートしています。 +レイヤー分離シナリオではサポートされません: layer_decomposition を有効にした状態で渡すとエラーが返ります。 + + 取り得る値: `auto`, `transparent`, `opaque` + + 出力画像が入力プロンプトにどれだけ忠実に沿うかを制御します。範囲 [1, 10]。値が大きいほどプロンプトへの追従性が強くなります。seedream-5.0-pro、5.0-lite、4.5、4.0 ではサポートされていません。 @@ -180,24 +192,34 @@ Comfy Router は、base64 展開およびすべての参照画像を含め、JSO • 幅と高さ(px): > 14 • サイズ: 10 MB 以下(seedream-5.0-pro は 30 MB) • 総ピクセル数: seedream-5.0-pro では 6000x6000(36,000,000 px)以下 -• 参照画像は最大 14 枚(seedream-5.0-pro と 5.0-flash は 10 枚) +• 参照画像は最大 14 枚(seedream-5.0-pro、5.0-flash、5.5 は 10 枚) レイヤー分離シナリオ(layer_decomposition 有効)では、image は必須であり、単一の入力画像のみがサポートされます(複数の画像を渡すとエラーが返ります)。入力画像は png、jpeg、webp、bmp、tiff、gif のいずれかである必要があり(heic と heif はサポートされません)、最大 30 MB、総ピクセル数は [512x512, 6000x6000] の範囲、アスペクト比は [1/16, 16] の範囲である必要があります。 - レイヤー分離を有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-pro と 5.0-flash のみです。 -true: レイヤー分離モード。モデルは単一の入力画像を 1 つのベース画像と複数のレイヤー(最大 16)に分解し、生成された各レイヤーの位置とコンテンツ情報を返します。これにはスタッキング順序(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 + レイヤー分離を有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.5 のみです。 +true: レイヤー分離モード。モデルは単一の入力画像を 1 つのベース画像と複数のレイヤー(最大 16、seedream-5.5 では最大 99)に分解し、生成された各レイヤーの位置とコンテンツ情報を返します。これにはスタッキング順序(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 false: 標準の画像生成モード。レイヤー分離は実行されません。 -レイヤー分離モードに関する注意: 単一の入力画像のみがサポートされます(複数の画像を渡すとエラーが返ります)。いずれか 1 つのレイヤーの生成に失敗すると、リクエスト全体が失敗します。部分的な成功はサポートされません。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーが返ります。 +レイヤー分離モードに関する注意: 単一の入力画像のみがサポートされます(複数の画像を渡すとエラーが返ります)。いずれか 1 つのレイヤーの生成に失敗すると、リクエスト全体が失敗します。部分的な成功はサポートされません。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。seedream-5.5 は最大で layer_decomposition_options.max_images 枚の画像を返します(ベース画像 1 枚 + 最大 99 レイヤー)。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーが返ります。 + + + + レイヤー分離モードのオプション。このパラメータをサポートするのは seedream-5.5 のみで、layer_decomposition が true の場合にのみ適用されます。 + + + + このリクエストが返す画像の合計最大枚数で、ベース画像とレイヤーを合わせた数です。範囲: [2, 100]。プロンプトで画像の分割方法が指定されていない場合、モデルは max_images と入力画像の複雑さに基づいてレイヤーを計画します。値が大きいほど、通常はより細かいレイヤーになります。 + + 範囲: `2` ~ `100` - モデル識別子。サポートされているモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915。POST /proxy/byteplus/api/v3/images/generations への直接 v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値、および省略された場合は 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元はこれを省略します。 + モデル識別子。サポートされているモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915、seedream-5-5-261028。POST /proxy/byteplus/api/v3/images/generations への直接 v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値、および省略された場合は 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元はこれを省略します。 - プロンプト最適化機能の設定。seedream-5.0-pro/5.0-lite/4.5(スタンダードモードのみ対応)および seedream-4.0 がこのパラメータをサポートしています。 + プロンプト最適化機能の設定。seedream-5.0-pro/5.0-lite/4.5/5.5(スタンダードモードのみ対応。seedream-5.5 は fast の場合エラーを返します)および seedream-4.0 がこのパラメータをサポートしています。 @@ -207,70 +229,75 @@ false: 標準の画像生成モード。レイヤー分離は実行されませ - 出力画像のフォーマットを指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite のみです。レイヤー分離シナリオでは、output_format はベース画像のフォーマットのみを制御し、各レイヤーは常に png で出力されます。 + 出力画像のフォーマットを指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像のフォーマットのみを制御し、各レイヤーは常に png で出力されます。 + + - 取り得る値: `png`, `jpeg` + Possible values: `png`、`jpeg` 画像生成または変換のためのテキスト記述。 -レイヤー分離シナリオ(layer_decomposition を有効にした seedream-5.0-pro または 5.0-flash)では任意です。prompt を指定した場合、モデルはプロンプトの意図に従って指定された要素を認識して分離します。prompt を指定しない場合、モデルは画像内のすべての主要な要素を自動的に検出し、それらを独立したレイヤーに分離します。 +レイヤー分離シナリオ(seedream-5.0-pro、5.0-flash、または layer_decomposition が有効な 5.5)では省略可能です。プロンプトを指定した場合、モデルはプロンプトの意図に従って指定された要素を認識して分離します。プロンプトを指定しない場合、モデルは画像内の主要な要素をすべて自動的に検出し、独立したレイヤーに分離します。 - レスポンスで返される生成画像のフォーマットを指定します + レスポンスで返される生成済み画像の形式を指定します - 取り得る値: `url`, `b64_json` + 指定可能な値: `url`、`b64_json` - 画像生成の確率性を制御するランダムシード。範囲: [-1, 2147483647]。指定しない場合は、シードが自動的に生成されます。同じ出力を再現するには、同じシード値を使用してください。 + 画像生成の確率性を制御するランダムシード。範囲: [-1, 2147483647]。指定しない場合は、シードが自動的に生成されます。同じ出力を再現するには、同じシード値を使用します。 - 範囲: `-1` ~ `2147483647` + 範囲: `-1` から `2147483647` - バッチ生成機能を無効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro と 5.0-flash はサポートしていません)。有効な値: -auto: 自動モードでは、モデルがユーザーのプロンプトに基づいて複数の画像を返すかどうか、および何枚の画像を含めるかを自動的に判断します。 + バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされます(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。有効な値: +auto: 自動モードでは、モデルはユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および何枚の画像を含めるかを自動的に決定します。 disabled: バッチ生成機能を無効にします。モデルは 1 枚の画像のみを生成します。 - 取り得る値: `auto`, `disabled` + 指定可能な値: `auto`、`disabled` - seedream-5.0-lite、4.5、4.0 のみがこのパラメータをサポートします(seedream-5.0-pro および 5.0-flash ではサポートされません)。 - バッチ画像生成機能の設定。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 + このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。 +バッチ画像生成機能の設定。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 - このリクエストで生成する画像の最大数を指定します。入力参照画像の数 + 生成される画像の数 ≤ 15。 + このリクエストで生成する画像の最大数を指定します。入力参照画像の数 + 生成画像の数 ≤ 15。 範囲: `1` から `15` - "seedream-4-0-250828": 生成する画像の仕様を設定します。2 つの方法が利用できますが、併用はできません。 + "seedream-4-0-250828": 生成画像の仕様を設定します。2 つの方法がありますが、同時に使用することはできません。 方法 1 | 解像度を指定します。指定可能な値: 1K、2K、4K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [1024x1024, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-4-5-251128": 2 つの方法が利用できます。 +"seedream-4-5-251128": 2 つの方法があります。 方法 1 | 解像度を指定します。指定可能な値: 2K、4K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-5-0-260128": 2 つの方法が利用できます。 +"seedream-5-0-260128": 2 つの方法があります。 方法 1 | 解像度を指定します。指定可能な値: 2K、3K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, ~3072x3072]、アスペクト比: [1/16, 16] -"seedream-5-0-pro-260628": 2 つの方法が利用できます(併用はできません)。 - 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、2K +"seedream-5-0-pro-260628": 2 つの方法があります(同時に使用することはできません)。 + 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、または用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、2K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 1024x1024、総ピクセル数: [1024x1024 (1048576), 2048x2048 (4194304)]、アスペクト比: [1/16, 16] -"seedream-5-0-flash-260915": 2 つの方法が利用できます(併用はできません)。 - 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K +"seedream-5-0-flash-260915": 2 つの方法があります(同時に使用することはできません)。 + 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、または用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] -"seedream-5-0-pro-260628" および "seedream-5-0-flash-260915" で layer_decomposition を有効にした場合: 解像度レベルの方法のみをサポートします。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 - ベース画像は、元の入力画像のアスペクト比で、指定した解像度で出力されます。各レイヤーは指定した解像度に近いサイズで出力され、元の画像でのアスペクト比を維持します。 - auto: 入力画像のサイズとアスペクト比に基づいて出力されます。[1280x720, ~2048x2048] の範囲内の入力は元の入力サイズで出力され、1K より小さい入力は 1K で出力され、2K より大きい入力は 2K で出力されます。 +"seedream-5-5-261028": 2 つの方法があります(同時に使用することはできません)。 + 方法 1 | 解像度を指定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K + 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915"、および "seedream-5-5-261028" で layer_decomposition が有効な場合: 解像度レベルの方法のみがサポートされます。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 + ベース画像は、オリジナルの入力画像のアスペクト比で、指定された解像度で出力されます。各レイヤーは、オリジナル画像内でのアスペクト比を維持したまま、指定された解像度に近いサイズで出力されます。 + auto: 出力は入力画像のサイズとアスペクト比に基づきます。[1280x720, ~2048x2048] の範囲内の入力は、オリジナルの入力サイズで出力されます。1K より小さい入力は 1K で出力され、2K より大きい入力は 2K で出力されます。 - Comfy Router は完全な JSON 結果をキャプチャするため、明示的に指定された stream フラグを false に確定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。seedream-5.0-lite、4.5、4.0 のみがこのパラメータをサポートします(seedream-5.0-pro および 5.0-flash ではサポートされません)。false = すべての出力画像が一度に返されます。true = 各出力画像が生成され次第、直ちに返されます。 + Comfy Router は完全な JSON 結果をキャプチャするため、明示的に指定された stream フラグを false に確定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。false = すべての出力画像が一度に返されます。true = 各出力画像が生成され次第、直ちに返されます。 @@ -294,6 +321,10 @@ Router が `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json` で提供 Base64 エンコードされた画像データ(response_format が "b64_json" の場合) + + 画像が実際に持つ背景の種類:transparent または opaque。レイヤー分離のシナリオでは、ベース画像は常に opaque で、各レイヤーは transparent です。このフィールドを返すのは seedream-5.5 のみです。 + + 現在のレイヤーがベース画像内で占める領域のバウンディングボックス情報。このフィールドを返すのはレイヤーのみで、ベース画像はキャンバス全体を覆うため bounding_box を返しません。layer_decomposition が true の場合にのみ返されます。 @@ -315,11 +346,11 @@ Router が `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json` で提供 - 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro のみです。 + 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 - 画像の幅と高さ(ピクセル単位)。形式は \x\。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、4.5、4.0 のみです。 + 画像の幅と高さ(ピクセル単位)。形式は \x\。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、5.5、4.5、4.0 のみです。 @@ -357,7 +388,7 @@ Router が `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json` で提供 - モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro のみです。 + モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 diff --git a/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx index b7264352b8..9d8c7690db 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Seedream 4.5 251128 を使用する" description: "Comfy Router 経由で byteplus/seedream-4-5-251128 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedream 4.5 251128" -translationSourceHash: af20f4b5 +translationSourceHash: e47962e3 translationFrom: development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx translationBlockHashes: "_intro": 1d32bb5d "Quick start": 5ffebfad - "Schema": 23ff89f5 + "Schema": d11a7253 "Examples": 7bc7fa59 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-4-5-251128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -156,6 +157,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-5-251128/requests/$REQU ### 入力 + + 生成される画像に透明な背景(アルファチャンネル)があるかどうかを制御します。seedream-5.0-pro、5.0-flash、および自身のスキーマにこのパラメータが記載されている新しい Seedream モデルでサポートされます。 +auto: モデルがプロンプトと output_format から判断します。output_format が jpeg の場合、出力は常に不透明になります。 +transparent: 透明な背景を持つ RGBA 画像を出力します。output_format が jpeg の場合はエラーを返します。 +opaque: 不透明な背景を持つ RGB 画像を出力します。seedream-5.0-pro のデフォルトです。 +seedream-5.0-pro は、アルファチャンネルを持つ 1 枚の png 入力画像による画像から画像への変換でのみ、透明な出力をサポートします。 +レイヤー分離シナリオではサポートされません。layer_decomposition を有効にして渡すとエラーが返ります。 + + 指定可能な値: `auto`、`transparent`、`opaque` + + 出力画像が入力プロンプトにどれだけ忠実に一致するかを制御します。範囲 [1, 10]。値が大きいほどプロンプトへの追従性が高くなります。seedream-5.0-pro、5.0-lite、4.5、4.0 ではサポートされていません。 @@ -180,24 +192,34 @@ Comfy Router は、base64 の展開とすべての参照画像を含め、JSON • 幅と高さ(px): 14 より大きい • サイズ: 10 MB 以下(seedream-5.0-pro は 30 MB) • 総ピクセル数: seedream-5.0-pro では 6000x6000(36,000,000 px)以下 -• 参照画像は最大 14 枚(seedream-5.0-pro と 5.0-flash は 10 枚) +• 参照画像は最大 14 枚(seedream-5.0-pro、5.0-flash、5.5 は 10 枚) レイヤー分離シナリオ(layer_decomposition が有効)では、image は必須で、単一の入力画像のみがサポートされます(複数の画像を渡すとエラーが返ります)。入力画像は png、jpeg、webp、bmp、tiff、gif のいずれかである必要があり(heic と heif はサポートされません)、最大 30 MB、総ピクセル数が [512x512, 6000x6000] の範囲、アスペクト比が [1/16, 16] の範囲である必要があります。 - レイヤー分離を有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-pro と 5.0-flash のみです。 -true: レイヤー分離モード。モデルは単一の入力画像を 1 つのベース画像と複数のレイヤー(最大 16)に分解し、生成された各レイヤーの位置とコンテンツ情報を返します。これには重なり順(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 + レイヤー分離を有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.5 のみです。 +true: レイヤー分離モード。モデルは単一の入力画像を 1 つのベース画像と複数のレイヤー(最大 16。seedream-5.5 では最大 99)に分解し、生成された各レイヤーの位置とコンテンツ情報を返します。これには重なり順(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 false: スタンダードな画像生成モード。レイヤー分離は行われません。 -レイヤー分離モードに関する注意: 単一の入力画像のみがサポートされます(複数の画像を渡すとエラーが返ります)。いずれか 1 つのレイヤーの生成に失敗すると、リクエスト全体が失敗します(部分的な成功はサポートされません)。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーが返ります。 +レイヤー分離モードに関する注意: 単一の入力画像のみがサポートされます(複数の画像を渡すとエラーが返ります)。いずれか 1 つのレイヤーの生成に失敗すると、リクエスト全体が失敗します。部分的な成功はサポートされません。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。seedream-5.5 は最大 layer_decomposition_options.max_images 枚の画像を返します(ベース画像 1 枚 + 最大 99 レイヤー)。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーが返ります。 + + + + レイヤー分離モードのオプション。このパラメータをサポートするのは seedream-5.5 のみで、layer_decomposition が true の場合にのみ適用されます。 + + + + このリクエストが返す画像の最大総数(ベース画像とレイヤーを合わせた数)。範囲: [2, 100]。プロンプトで画像の分割方法が指定されていない場合、モデルは max_images と入力画像の複雑さに基づいてレイヤーを計画します。値が大きいほど、通常はより細かいレイヤーになります。 + + 範囲: `2` から `100` - モデル識別子。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915。POST /proxy/byteplus/api/v3/images/generations への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値を拒否し、省略された場合も 400 で拒否します。このスキーマの `required` リストには含まれていません。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するため、Router の呼び出し側は省略します。 + モデル識別子。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915、seedream-5-5-261028。POST /proxy/byteplus/api/v3/images/generations への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。このスキーマの `required` リストには含まれていません。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するため、Router の呼び出し側は省略します。 - プロンプト最適化機能の設定。seedream-5.0-pro/5.0-lite/4.5(スタンダードモードのみをサポート)と seedream-4.0 のみがこのパラメータをサポートします。 + プロンプト最適化機能の設定。seedream-5.0-pro/5.0-lite/4.5/5.5(スタンダードモードのみをサポート。seedream-5.5 では fast を指定するとエラーが返ります)と seedream-4.0 のみがこのパラメータをサポートします。 @@ -207,76 +229,81 @@ false: スタンダードな画像生成モード。レイヤー分離は行わ - 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite のみです。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御します。各レイヤーは常に png として出力されます。 + 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御します。各レイヤーは常に png として出力されます。 + - 指定可能な値: `png`、`jpeg` + Possible values: `png`, `jpeg` - 画像の生成または変換のためのテキスト記述。 -レイヤー分離シナリオ(layer_decomposition を有効にした seedream-5.0-pro または 5.0-flash)では任意です。プロンプトを指定した場合、モデルはプロンプトの意図に従って指定された要素を認識して分離します。プロンプトを指定しない場合、モデルは画像内の主要な要素をすべて自動検出し、独立したレイヤーに分離します。 + 画像の生成または変換のためのテキスト説明。 +レイヤー分離シナリオ(layer_decomposition を有効にした seedream-5.0-pro、5.0-flash、5.5)では任意です。プロンプトが提供された場合、モデルはプロンプトの意図に従って指定した要素を認識して分離します。プロンプトが提供されない場合、モデルは画像内の主要な要素をすべて自動検出し、独立したレイヤーに分離します。 - レスポンスで返される生成済み画像の形式を指定します + 応答で返される生成画像の形式を指定します 指定可能な値: `url`、`b64_json` - 画像生成のランダム性を制御するシード。範囲: [-1, 2147483647]。指定しない場合、シードは自動的に生成されます。同じ出力を再現するには、同じシード値を使用してください。 + 画像生成のランダム性を制御するシード。範囲: [-1, 2147483647]。指定しない場合は、シードが自動生成されます。同じ出力を再現するには、同じシード値を使用します。 範囲: `-1` から `2147483647` - バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro と 5.0-flash ではサポートされません)。有効な値: -auto: 自動モードでは、ユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および含まれる画像数をモデルが自動的に判断します。 + バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされていません)。有効な値: +auto: 自動モードでは、モデルはユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および含まれる画像数を自動的に決定します。 disabled: バッチ生成機能を無効にします。モデルは 1 枚の画像のみを生成します。 指定可能な値: `auto`、`disabled` - このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro と 5.0-flash ではサポートされません)。バッチ画像生成機能の設定です。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 + seedream-5.0-lite、4.5、4.0 のみがこのパラメータをサポートしています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされていません)。 +バッチ画像生成機能の設定。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 - このリクエストで生成する画像の最大数を指定します。入力参照画像の数 + 生成する画像の数 ≤ 15。 + このリクエストで生成する画像の最大数を指定します。入力参照画像数 + 生成画像数 ≤ 15。 範囲: `1` から `15` - "seedream-4-0-250828": 生成する画像の仕様を設定します。2 つの方法が利用できますが、併用はできません。 + "seedream-4-0-250828": 生成画像の仕様を設定します。2 つの方法がありますが、同時に使用できません。 方法 1 | 解像度を指定します。指定可能な値: 1K、2K、4K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [1024x1024, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-4-5-251128": 2 つの方法が利用できます。 +"seedream-4-5-251128": 2 つの方法があります。 方法 1 | 解像度を指定します。指定可能な値: 2K、4K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-5-0-260128": 2 つの方法が利用できます。 +"seedream-5-0-260128": 2 つの方法があります。 方法 1 | 解像度を指定します。指定可能な値: 2K、3K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, ~3072x3072]、アスペクト比: [1/16, 16] -"seedream-5-0-pro-260628": 2 つの方法が利用できます(併用はできません)。 - 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、2K +"seedream-5-0-pro-260628": 2 つの方法があります(同時に使用できません)。 + 方法 1 | 解像度を指定し、画像のアスペクト比、形状、用途をプロンプトで説明します。最終サイズはモデルが決定します。指定可能な値: 1K、2K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 1024x1024、総ピクセル数: [1024x1024 (1048576), 2048x2048 (4194304)]、アスペクト比: [1/16, 16] -"seedream-5-0-flash-260915": 2 つの方法が利用できます(併用はできません)。 - 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K +"seedream-5-0-flash-260915": 2 つの方法があります(同時に使用できません)。 + 方法 1 | 解像度を指定し、画像のアスペクト比、形状、用途をプロンプトで説明します。最終サイズはモデルが決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] -"seedream-5-0-pro-260628" と "seedream-5-0-flash-260915" で layer_decomposition を有効にした場合: 解像度レベルの方法のみをサポートします。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 - ベース画像は、オリジナルの入力画像のアスペクト比で、指定した解像度で出力されます。各レイヤーは、オリジナル画像内でのアスペクト比を維持したまま、指定した解像度に近いサイズで出力されます。 - auto: 入力画像のサイズとアスペクト比に基づいて出力されます。[1280x720, ~2048x2048] の範囲内の入力は元の入力サイズで出力され、1K より小さい入力は 1K で出力され、2K より大きい入力は 2K で出力されます。 +"seedream-5-5-261028": 2 つの方法があります(同時に使用できません)。 + 方法 1 | 解像度を指定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K + 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915"、"seedream-5-5-261028" で layer_decomposition が有効な場合: 解像度レベルの方法のみがサポートされています。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 + ベース画像は、オリジナルの入力画像のアスペクト比で指定された解像度で出力されます。各レイヤーは、オリジナル画像内で持っていたアスペクト比を維持しながら、指定された解像度に近いサイズで出力されます。 + auto: 入力画像のサイズとアスペクト比に基づいて出力されます。[1280x720, ~2048x2048] 内の入力はオリジナルの入力サイズで出力され、1K より小さい入力は 1K で出力され、2K より大きい入力は 2K で出力されます。 - Comfy Router は完全な JSON 結果を取得するため、明示的に指定された stream フラグを false に固定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro と 5.0-flash は非対応)。false = すべての出力画像が一度に返されます。true = 生成された各出力画像が生成され次第すぐに返されます。 + Comfy Router は完全な JSON 結果を取得するため、明示的に指定された stream フラグを false に固定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 ではサポートされていません)。false = すべての出力画像が一度に返されます。true = 各出力画像は生成後すぐに返されます。 生成される画像にウォーターマークを追加するかどうかを指定します。false = ウォーターマークなし、true = 'AI generated' ラベル付きのウォーターマークを追加 -Router が `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json` で提供する schema から生成されています。これはリクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 +Router が `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 ### 出力 @@ -293,6 +320,10 @@ Router が `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json` で提供 Base64 エンコードされた画像データ(response_format が "b64_json" の場合) + + 画像が実際に持つ背景の種類(transparent または opaque)。レイヤー分離のシナリオでは、ベース画像は常に opaque で、すべてのレイヤーは transparent です。このフィールドを返すのは seedream-5.5 のみです。 + + 現在のレイヤーがベース画像内で占める領域のバウンディングボックス情報。このフィールドを返すのはレイヤーのみで、ベース画像はキャンバス全体を覆うため bounding_box を返しません。layer_decomposition が true の場合にのみ返されます。 @@ -314,11 +345,11 @@ Router が `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json` で提供 - 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro のみです。 + 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 - 画像の幅と高さ(ピクセル単位)。形式は \x\。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、4.5、4.0 のみです。 + 画像の幅と高さ(ピクセル単位)。形式は \x\。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、5.5、4.5、4.0 のみです。 @@ -356,7 +387,7 @@ Router が `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json` で提供 - モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro のみです。 + モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 diff --git a/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx index e121af7e62..ffd2e636b7 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Seedream 5.0 260128 を使用する" description: "Comfy Router 経由で byteplus/seedream-5-0-260128 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedream 5.0 260128" -translationSourceHash: 732cb981 +translationSourceHash: 48855510 translationFrom: development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx translationBlockHashes: "_intro": 38b28b26 "Quick start": c2f3039d - "Schema": 9f3bcfd2 + "Schema": be3a6de7 "Examples": b387e011 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -156,6 +157,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-260128/requests/$REQU ### 入力 + + 生成画像の背景を透明(アルファチャンネル)にするかどうかを制御します。seedream-5.0-pro、5.0-flash、および自身のスキーマでこのパラメータを定義している新しい Seedream モデルでサポートされます。 +auto: モデルがプロンプトと output_format から判断します。output_format が jpeg の場合、出力は常に不透明になります。 +transparent: 背景が透明な RGBA 画像を出力します。output_format が jpeg の場合はエラーを返します。 +opaque: 背景が不透明な RGB 画像を出力します。seedream-5.0-pro のデフォルトです。 +seedream-5.0-pro は、アルファチャンネルを持つ png 入力画像 1 枚を使用する画像から画像への変換でのみ、透明出力をサポートします。 +レイヤー分離シナリオではサポートされません: layer_decomposition を有効にした状態で渡すとエラーが返ります。 + + 可能な値: `auto`, `transparent`, `opaque` + + 出力画像が入力プロンプトにどれだけ忠実に一致するかを制御します。範囲は [1, 10] です。値が大きいほどプロンプトへの追従性が高くなります。seedream-5.0-pro、5.0-lite、4.5、4.0 ではサポートされていません。 @@ -180,24 +192,34 @@ Comfy Router は、base64 の展開やすべての参照画像を含め、JSON • 幅と高さ(px): 14 より大きい • サイズ: 10 MB 以下(seedream-5.0-pro は 30 MB) • 総ピクセル数: seedream-5.0-pro では 6000x6000(36,000,000 px)以下 -• 参照画像は最大 14 枚(seedream-5.0-pro と 5.0-flash は 10 枚) +• 参照画像は最大 14 枚(seedream-5.0-pro、5.0-flash、5.5 は 10 枚) レイヤー分離シナリオ(layer_decomposition 有効)では、image は必須であり、単一の入力画像のみがサポートされます(複数画像を渡すとエラーが返ります)。入力画像は png、jpeg、webp、bmp、tiff、gif のいずれかである必要があり(heic と heif はサポートされません)、最大 30 MB、総ピクセル数は [512x512, 6000x6000] の範囲、アスペクト比は [1/16, 16] の範囲である必要があります。 - レイヤー分離を有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-pro と 5.0-flash のみです。 -true: レイヤー分離モード。モデルは単一の入力画像を 1 つのベース画像と複数のレイヤー(最大 16)に分解し、生成された各レイヤーの位置とコンテンツ情報を返します。これにはスタッキング順序(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 + レイヤー分離を有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.5 のみです。 +true: レイヤー分離モード。モデルは単一の入力画像を 1 つのベース画像と複数のレイヤー(最大 16、seedream-5.5 では最大 99)に分解し、生成された各レイヤーの位置とコンテンツ情報を返します。これにはスタッキング順序(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 false: スタンダードな画像生成モード。レイヤー分離は行われません。 -レイヤー分離モードに関する注意: 単一の入力画像のみがサポートされます(複数画像を渡すとエラーが返ります)。いずれか 1 つのレイヤーの生成に失敗すると、リクエスト全体が失敗します(部分的な成功はサポートされません)。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーが返ります。 +レイヤー分離モードに関する注意: 単一の入力画像のみがサポートされます(複数画像を渡すとエラーが返ります)。いずれか 1 つのレイヤーの生成に失敗すると、リクエスト全体が失敗します(部分的な成功はサポートされません)。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。seedream-5.5 は最大で layer_decomposition_options.max_images 枚の画像を返します(ベース画像 1 枚 + 最大 99 レイヤー)。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーが返ります。 + + + + レイヤー分離モードのオプション。このパラメータをサポートするのは seedream-5.5 のみで、layer_decomposition が true の場合にのみ適用されます。 + + + + このリクエストが返す画像の最大総数で、ベース画像とレイヤーを合わせた数です。範囲: [2, 100]。プロンプトで画像の分割方法が指定されていない場合、モデルは max_images と入力画像の複雑さからレイヤーを計画します。値が大きいほど、通常はより細かいレイヤーになります。 + + 範囲: `2` ~ `100` - モデル識別子。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915。POST /proxy/byteplus/api/v3/images/generations への直接の v1 呼び出しでは必ずこれを指定する必要があります。プロキシはそれ以外の値、および省略された場合を 400 で拒否します。このスキーマの `required` リストには含まれていません。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。 + モデル識別子。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915、seedream-5-5-261028。POST /proxy/byteplus/api/v3/images/generations への直接の v1 呼び出しでは必ずこれを指定する必要があります。プロキシはそれ以外の値、および省略された場合を 400 で拒否します。このスキーマの `required` リストには含まれていません。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。 - プロンプト最適化機能の設定。このパラメータは seedream-5.0-pro/5.0-lite/4.5(スタンダードモードのみサポート)と seedream-4.0 のみがサポートします。 + プロンプト最適化機能の設定。このパラメータをサポートするのは seedream-5.0-pro/5.0-lite/4.5/5.5(スタンダードモードのみサポート。seedream-5.5 は fast を指定するとエラーを返します)と seedream-4.0 のみです。 @@ -207,70 +229,71 @@ false: スタンダードな画像生成モード。レイヤー分離は行わ - 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite のみです。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御します。各レイヤーは常に png で出力されます。 - - 可能な値: `png`, `jpeg` + 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御し、各レイヤーは常に png で出力されます。Possible values: `png`、`jpeg` - 画像の生成または変換のためのテキスト記述。 -レイヤー分離シナリオ(seedream-5.0-pro または 5.0-flash で layer_decomposition を有効にした場合)では省略可能です。prompt を指定した場合、モデルはプロンプトの意図に従って指定された要素を認識して分離します。prompt を指定しない場合、モデルは画像内の主要な要素をすべて自動的に検出し、独立したレイヤーに分離します。 + 画像生成または変換のためのテキスト記述。 +レイヤー分離シナリオ(seedream-5.0-pro、5.0-flash、または layer_decomposition が有効な 5.5)ではオプションです。プロンプトが提供された場合、モデルはプロンプトの意図に従って、指定した要素を認識して分離します。プロンプトが提供されない場合、モデルは画像内のすべての主要な要素を自動的に検出し、それらを独立したレイヤーに分離します。 レスポンスで返される生成画像の形式を指定します - 可能な値: `url`, `b64_json` + 可能な値: `url`、`b64_json` 画像生成の確率性を制御するランダムシード。範囲: [-1, 2147483647]。指定しない場合、シードは自動的に生成されます。同じ出力を再現するには、同じシード値を使用します。 - 範囲: `-1` ~ `2147483647` + 範囲: `-1` から `2147483647` - バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 のみでサポートされています(seedream-5.0-pro と 5.0-flash ではサポートされません)。有効な値: -auto: 自動モードでは、モデルはユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および含まれる画像数を自動的に判断します。 + バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。有効な値: +auto: 自動モードでは、モデルはユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および含まれる画像数を自動的に決定します。 disabled: バッチ生成機能を無効にします。モデルは 1 枚の画像のみを生成します。 - 可能な値: `auto`, `disabled` + 可能な値: `auto`、`disabled` - seedream-5.0-lite、4.5、4.0 がこのパラメータをサポートしています(seedream-5.0-pro および 5.0-flash ではサポートされません)。 -バッチ画像生成機能の設定です。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 + このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。 +バッチ画像生成機能の設定。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 - このリクエストで生成する画像の最大数を指定します。入力参照画像の数 + 生成される画像の数 ≤ 15。 + このリクエストで生成する画像の最大数を指定します。入力参照画像数 + 生成画像数 ≤ 15。 範囲: `1` から `15` - "seedream-4-0-250828": 生成画像の仕様を設定します。2 つの方法がありますが、同時に使用することはできません。 - 方法 1 | 解像度を指定します。指定可能な値: 1K、2K、4K + "seedream-4-0-250828": 生成画像の仕様を設定します。2 つの方法が利用できますが、併用はできません。 + 方法 1 | 解像度を指定します。オプションの値: 1K、2K、4K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [1024x1024, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-4-5-251128": 2 つの方法があります。 - 方法 1 | 解像度を指定します。指定可能な値: 2K、4K +"seedream-4-5-251128": 2 つの方法が利用できます。 + 方法 1 | 解像度を指定します。オプションの値: 2K、4K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-5-0-260128": 2 つの方法があります。 - 方法 1 | 解像度を指定します。指定可能な値: 2K、3K +"seedream-5-0-260128": 2 つの方法が利用できます。 + 方法 1 | 解像度を指定します。オプションの値: 2K、3K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, ~3072x3072]、アスペクト比: [1/16, 16] -"seedream-5-0-pro-260628": 2 つの方法があります(同時に使用することはできません)。 - 方法 1 | 解像度を指定し、プロンプトに画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、2K +"seedream-5-0-pro-260628": 2 つの方法が利用できます(併用はできません)。 + 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、または用途を記述します。最終的なサイズはモデルが決定します。オプションの値: 1K、2K 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 1024x1024、総ピクセル数: [1024x1024 (1048576), 2048x2048 (4194304)]、アスペクト比: [1/16, 16] -"seedream-5-0-flash-260915": 2 つの方法があります(同時に使用することはできません)。 - 方法 1 | 解像度を指定し、プロンプトに画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K +"seedream-5-0-flash-260915": 2 つの方法が利用できます(併用はできません)。 + 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、または用途を記述します。最終的なサイズはモデルが決定します。オプションの値: 1K、1.5K、2K。デフォルト: 2K 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] -"seedream-5-0-pro-260628" および "seedream-5-0-flash-260915" で layer_decomposition を有効にした場合: 解像度レベルの方法のみがサポートされます。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 - ベース画像は、元の入力画像のアスペクト比で指定された解像度で出力されます。各レイヤーは、元の画像でのアスペクト比を維持しつつ、指定された解像度に近いサイズで出力されます。 - auto: 入力画像のサイズとアスペクト比に基づいて出力されます。[1280x720, ~2048x2048] の範囲内の入力は元の入力サイズで出力され、1K より小さい入力は 1K で、2K より大きい入力は 2K で出力されます。 +"seedream-5-5-261028": 2 つの方法が利用できます(併用はできません)。 + 方法 1 | 解像度を指定します。オプションの値: 1K、1.5K、2K。デフォルト: 2K + 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915"、および "seedream-5-5-261028" で layer_decomposition が有効な場合: 解像度レベルの方法のみがサポートされます。オプションの値: 1K、1.5K、2K、auto。デフォルト: auto。 + ベース画像は、元の入力画像のアスペクト比で指定された解像度で出力されます。各レイヤーは、元の画像でのアスペクト比を維持しながら、指定された解像度に近いサイズで出力されます。 + auto: 出力は入力画像のサイズとアスペクト比に基づきます。[1280x720, ~2048x2048] 内の入力は元の入力サイズで出力されます。1K より小さい入力は 1K で出力されます。2K より大きい入力は 2K で出力されます。 - Comfy Router は完全な JSON 結果を取得するため、明示的に指定された stream フラグを false に確定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro および 5.0-flash ではサポートされません)。false = すべての出力画像が一度に返されます。true = 各出力画像が生成後すぐに返されます。 + Comfy Router は完全な JSON 結果を取得するため、明示的に指定された stream フラグを false に確定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。false = すべての出力画像が一度に返されます。true = 各出力画像が生成後すぐに返されます。 @@ -294,6 +317,10 @@ disabled: バッチ生成機能を無効にします。モデルは 1 枚の画 Base64 エンコードされた画像データ (response_format が "b64_json" の場合) + + 画像が実際に持つ背景タイプ: transparent または opaque。レイヤー分離のシナリオでは、ベース画像は常に opaque で、すべてのレイヤーは transparent です。このフィールドを返すのは seedream-5.5 のみです。 + + 現在のレイヤーがベース画像内で占める領域のバウンディングボックス情報。このフィールドを返すのはレイヤーのみで、ベース画像はキャンバス全体を覆うため bounding_box を返しません。layer_decomposition が true の場合にのみ返されます。 @@ -315,11 +342,11 @@ disabled: バッチ生成機能を無効にします。モデルは 1 枚の画 - 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro のみです。 + 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 - 画像の幅と高さ (ピクセル単位)。形式は \x\ です。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、4.5、4.0 のみです。 + 画像の幅と高さ (ピクセル単位)。形式は \x\ です。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、5.5、4.5、4.0 のみです。 @@ -357,7 +384,7 @@ disabled: バッチ生成機能を無効にします。モデルは 1 枚の画 - モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro のみです。 + モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 diff --git a/ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx index 3e04944bcb..dd1bdfb3f8 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx @@ -2,15 +2,17 @@ title: "Comfy Router で Seedream 5.0 Flash 260915 を使う" description: "Comfy Router 経由で byteplus/seedream-5-0-flash-260915 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedream 5.0 Flash 260915" -translationSourceHash: 7d74243a +translationSourceHash: 114a5dd9 translationFrom: development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx translationBlockHashes: "_intro": a1b4c447 "Quick start": 4f86c636 - "Schema": dab50eaf + "Schema": c220d381 "Examples": 36f49088 --- + + {/* 生成済みファイル。router-schemas/byteplus/seedream-5-0-flash-260915.json から `pnpm code-pages:gen` によって生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -154,8 +156,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-flash-260915/requests ### 入力 + + 生成される画像の背景を透明にするか(アルファチャンネル)を制御します。seedream-5.0-pro、5.0-flash、および自身のスキーマでこの項目が文書化されている新しい Seedream モデルでサポートされます。 +auto: モデルがプロンプトと output_format から判断します。output_format が jpeg の場合、出力は常に不透明になります。 +transparent: 背景が透明な RGBA 画像を出力します。output_format が jpeg の場合はエラーを返します。 +opaque: 背景が不透明な RGB 画像を出力します。seedream-5.0-pro のデフォルトです。 +seedream-5.0-pro は画像から画像への変換のみで透明出力をサポートし、アルファチャンネルを持つ png 入力画像を 1 枚だけ受け付けます。 +レイヤー分離シナリオではサポートされません。layer_decomposition を有効にした状態で渡すとエラーを返します。 + + 指定可能な値: `auto`、`transparent`、`opaque` + + - 出力画像が入力プロンプトにどれだけ忠実に従うかを制御します。範囲は [1, 10] です。値が大きいほどプロンプトへの追従性が強くなります。seedream-5.0-pro、5.0-lite、4.5、4.0 ではサポートされていません。 + 出力画像が入力プロンプトにどの程度忠実に従うかを制御します。範囲は [1, 10] です。値が大きいほどプロンプトへの追従性が高くなります。seedream-5.0-pro、5.0-lite、4.5、4.0 ではサポートされません。 範囲: `1` から `10` @@ -163,103 +176,114 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-flash-260915/requests - 編集する画像(1 枚または複数)。アクセス可能な URL、または data-URI プレフィックス付きの Base64 ペイロードとして指定します。参照画像の上限がこのモデルでは 14 ではなく 10 である点を除き、共通の Seedream フィールドと同一です。 + 編集対象の画像(1 枚または複数枚)。アクセス可能な URL、または data URI プレフィックス付きの Base64 ペイロードとして指定します。共有 Seedream フィールドと同一ですが、参照画像の上限がこのモデルでは 14 ではなく 10 です。 - レイヤー分離を有効にするかどうかを制御します。このパラメータは seedream-5.0-pro と 5.0-flash のみがサポートしています。 -true: レイヤー分離モード。モデルは単一の入力画像を 1 枚のベース画像と複数のレイヤー(最大 16)に分解し、生成された各レイヤーの位置とコンテンツ情報を返します。これには重ね順(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 -false: 標準の画像生成モード。レイヤー分離は行われません。 -レイヤー分離モードに関する注意: 単一の入力画像のみがサポートされます(複数の画像を渡すとエラーが返されます)。いずれかのレイヤーの生成に失敗した場合、リクエスト全体が失敗します。部分的な成功はサポートされません。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーが返されます。 + レイヤー分離を有効にするかを制御します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.5 のみです。 +true: レイヤー分離モード。モデルは単一の入力画像を 1 枚のベース画像と複数のレイヤー(最大 16、seedream-5.5 では最大 99)に分解し、生成された各レイヤーの位置とコンテンツ情報を返します。これには重なり順(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 +false: 標準の画像生成モード。レイヤー分離は行いません。 +レイヤー分離モードに関する注意: 入力画像は 1 枚のみサポートされます(複数の画像を渡すとエラーを返します)。いずれかのレイヤーの生成に失敗した場合、リクエスト全体が失敗します。部分的な成功はサポートされません。返される画像は最大 17 枚(ベース画像 1 枚 + レイヤー 16 枚)です。seedream-5.5 は最大で layer_decomposition_options.max_images 枚(ベース画像 1 枚 + 最大 99 レイヤー)を返します。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーを返します。 + + + + レイヤー分離モードのオプション。このパラメータをサポートするのは seedream-5.5 のみで、layer_decomposition が true の場合にのみ適用されます。 + + + + このリクエストが返す画像の合計最大枚数(ベース画像とレイヤーを合わせた枚数)。範囲は [2, 100] です。プロンプトで画像の分割方法が指定されていない場合、モデルは max_images と入力画像の複雑さからレイヤーを計画します。値が大きいほど、通常はより細かいレイヤーになります。 + + 範囲: `2` から `100` - モデル識別子。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915。POST /proxy/byteplus/api/v3/images/generations への直接の v1 呼び出しでは必ずこれを指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。これがこのスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元は省略します。 + モデル識別子。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915、seedream-5-5-261028。POST /proxy/byteplus/api/v3/images/generations への v1 の直接呼び出しでは、これを必ず指定する必要があります。プロキシは他の値や省略された場合は 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元は省略します。 - プロンプト最適化機能の設定。このパラメータは seedream-5.0-pro/5.0-lite/4.5(スタンダードモードのみをサポート)と seedream-4.0 のみがサポートしています。 + プロンプト最適化機能の設定。このパラメータをサポートするのは seedream-5.0-pro/5.0-lite/4.5/5.5(standard モードのみをサポートし、seedream-5.5 では fast を指定するとエラーを返します)と seedream-4.0 です。 - プロンプト最適化機能のモードを設定します。standard = 品質は高いが生成時間が長くなります。fast = 高速ですが品質は平均的です。 + プロンプト最適化機能のモードを設定します。standard = より高品質ですが生成時間が長くなります。fast = より高速ですが品質は平均的になります。 - 取り得る値: `standard`、`fast` + 指定可能な値: `standard`、`fast` - 出力画像の形式を指定します。このパラメータは seedream-5.0-pro、5.0-flash、5.0-lite のみがサポートしています。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御します。各レイヤーは常に png で出力されます。 + 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御し、各レイヤーは常に png で出力されます。 - 取り得る値: `png`、`jpeg` + 指定可能な値: `png`、`jpeg` - 画像生成または変換のためのテキスト記述。 -レイヤー分離シナリオ(layer_decomposition が有効な seedream-5.0-pro または 5.0-flash)では省略可能です。prompt を指定した場合、モデルはプロンプトの意図に従って指定された要素を認識して分離します。prompt を指定しない場合、モデルは画像内の主要な要素をすべて自動検出し、独立したレイヤーに分離します。 + 画像の生成または変換のためのテキスト記述。 +レイヤー分離シナリオ(layer_decomposition を有効にした seedream-5.0-pro、5.0-flash、5.5)では省略可能です。プロンプトを指定した場合、モデルはプロンプトの意図に従って指定された要素を認識して分離します。プロンプトを指定しない場合、モデルは画像内の主要な要素をすべて自動的に検出し、独立したレイヤーに分離します。 レスポンスで返される生成画像の形式を指定します - 取り得る値: `url`、`b64_json` + 指定可能な値: `url`、`b64_json` - 画像生成のランダム性を制御するシード。範囲: [-1, 2147483647]。指定しない場合、シードは自動的に生成されます。同じ出力を再現するには、同じシード値を使用してください。 + 画像生成の確率性を制御するランダムシード。範囲は [-1, 2147483647] です。指定しない場合はシードが自動的に生成されます。同じ出力を再現するには、同じシード値を使用してください。 範囲: `-1` から `2147483647` - バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 のみでサポートされています(seedream-5.0-pro と 5.0-flash ではサポートされません)。有効な値: -auto: 自動モードでは、ユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および含まれる画像数をモデルが自動的に判断します。 -disabled: バッチ生成機能を無効にします。モデルは 1 枚の画像のみを生成します。 + バッチ生成機能を無効にするかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされます(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。有効な値:auto: 自動モードでは、モデルがユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および含まれる画像数を自動的に決定します。 +disabled: バッチ生成機能を無効にします。モデルは1枚の画像のみを生成します。 - 取り得る値: `auto`、`disabled` + 指定可能な値: `auto`, `disabled` - seedream-5.0-lite、4.5、4.0 のみがこのパラメータをサポートしています(seedream-5.0-pro および 5.0-flash ではサポートされていません)。 -バッチ画像生成機能の設定です。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 + このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 はサポートしません)。 +バッチ画像生成機能の設定。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 - このリクエストで生成する画像の最大数を指定します。入力参照画像数 + 生成画像数 ≤ 15。 + このリクエストで生成する画像の最大数を指定します。入力参照画像の数 + 生成される画像の数 ≤ 15。 範囲: `1` から `15` - "seedream-4-0-250828": 生成画像の仕様を設定します。2つの方法がありますが、併用はできません。 - 方法1 | 解像度を指定します。指定可能な値: 1K、2K、4K - 方法2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [1024x1024, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-4-5-251128": 2つの方法があります。 - 方法1 | 解像度を指定します。指定可能な値: 2K、4K - 方法2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-5-0-260128": 2つの方法があります。 - 方法1 | 解像度を指定します。指定可能な値: 2K、3K - 方法2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, ~3072x3072]、アスペクト比: [1/16, 16] - -`"seedream-5-0-pro-260628"`: 2 つの方法が利用可能です(併用できません)。 - 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、2K - 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 1024x1024、総ピクセル数: [1024x1024 (1048576), 2048x2048 (4194304)]、アスペクト比: [1/16, 16] -`"seedream-5-0-flash-260915"`: 2 つの方法が利用可能です(併用できません)。 - 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K - 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] -layer_decomposition を有効にした `"seedream-5-0-pro-260628"` および `"seedream-5-0-flash-260915"`: 解像度レベルの方法のみをサポートします。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 - ベース画像は、オリジナルの入力画像のアスペクト比で、指定された解像度で出力されます。各レイヤーは、オリジナル画像でのアスペクト比を維持したまま、指定された解像度に近いサイズで出力されます。 - auto: 出力は入力画像のサイズとアスペクト比に基づきます。[1280x720, ~2048x2048] の範囲内の入力はオリジナルの入力サイズで出力され、1K 未満の入力は 1K で出力され、2K より大きい入力は 2K で出力されます。 + "seedream-4-0-250828": 生成画像の仕様を設定します。2つの方法が利用可能ですが、併用はできません。 + 方法 1 | 解像度を指定します。指定可能な値: 1K、2K、4K + 方法 2 | 幅と高さをピクセルで指定します。デフォルト: 2048x2048、総ピクセル数: [1024x1024, 4096x4096]、アスペクト比: [1/16, 16] +"seedream-4-5-251128": 2つの方法が利用可能です。 + 方法 1 | 解像度を指定します。指定可能な値: 2K、4K + 方法 2 | 幅と高さをピクセルで指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, 4096x4096]、アスペクト比: [1/16, 16] +"seedream-5-0-260128": 2つの方法が利用可能です。 + 方法 1 | 解像度を指定します。指定可能な値: 2K、3K + 方法 2 | 幅と高さをピクセルで指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, ~3072x3072]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628": 2つの方法が利用可能です(併用はできません)。 + 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を説明します。最終的なサイズはモデルが決定します。指定可能な値: 1K、2K + 方法 2 | 幅と高さをピクセルで指定します。デフォルト: 1024x1024、総ピクセル数: [1024x1024 (1048576), 2048x2048 (4194304)]、アスペクト比: [1/16, 16] +"seedream-5-0-flash-260915": 2つの方法が利用可能です(併用はできません)。 + 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を説明します。最終的なサイズはモデルが決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K + 方法 2 | 幅と高さをピクセルで指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-5-261028": 2つの方法が利用可能です(併用はできません)。 + 方法 1 | 解像度を指定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K + 方法 2 | 幅と高さをピクセルで指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915"、"seedream-5-5-261028" で layer_decomposition が有効な場合: 解像度レベルの方法のみをサポートします。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 + ベース画像は、元の入力画像のアスペクト比で指定された解像度で出力されます。各レイヤーは、元の画像でのアスペクト比を保ちながら、指定された解像度に近いサイズで出力されます。 + auto: 入力画像のサイズとアスペクト比に基づいて出力されます。[1280x720, ~2048x2048] の範囲内の入力は元の入力サイズで出力され、1K より小さい入力は 1K で出力され、2K より大きい入力は 2K で出力されます。 - Comfy Router は完全な JSON 結果を取得するため、明示的に指定された stream フラグを false に固定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。seedream-5.0-lite、4.5、4.0 のみがこのパラメータをサポートしています(seedream-5.0-pro および 5.0-flash ではサポートされていません)。false = すべての出力画像が一度に返されます。true = 各出力画像は生成され次第、即座に返されます。 + Comfy Router は完全な JSON 結果を取得するため、明示的に指定された stream フラグを false に固定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 はサポートしません)。false = すべての出力画像が一度に返されます。true = 各出力画像が生成され次第すぐに返されます。 - 生成画像にウォーターマークを追加するかどうかを指定します。false = ウォーターマークなし、true = 'AI generated' ラベル付きのウォーターマークを追加します + 生成画像にウォーターマークを追加するかどうかを指定します。false = ウォーターマークなし、true = 「AI generated」ラベル付きのウォーターマークを追加 -Router が `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 +`GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同一のドキュメントです。 ### 出力 @@ -276,32 +300,36 @@ Router が `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` で Base64 エンコードされた画像データ(response_format が "b64_json" の場合) + + 画像が実際に持つ背景タイプ(transparent または opaque)。レイヤー分離シナリオでは、ベース画像は常に opaque で、各レイヤーは transparent です。このフィールドを返すのは seedream-5.5 のみです。 + + 現在のレイヤーがベース画像内で占める領域のバウンディングボックス情報。このフィールドを返すのはレイヤーのみで、ベース画像はキャンバス全体を覆うため bounding_box を返しません。layer_decomposition が true の場合にのみ返されます。 - レイヤーのバウンディングボックスの絶対ピクセル座標。左上隅を (0, 0) とする出力ベース画像の座標系で表されます。座標形式: [left, top, right, bottom]。 + レイヤーのバウンディングボックスの絶対ピクセル座標。出力ベース画像の座標系で、左上隅を (0, 0) とします。座標形式: [left, top, right, bottom]。 - レイヤーのバウンディングボックスのパーミル量子化(正規化)座標。ベース画像のサイズに基づいて [0, 1000] の離散的な整数範囲に比例マッピングされ、最大 1000 で切り捨てられます。座標形式: [left, top, right, bottom]。 + レイヤーのバウンディングボックスのパーミル量子化(正規化)座標。ベース画像サイズに基づいて [0, 1000] の離散的な整数範囲に比例マッピングされ、最大 1000 で切り捨てられます。座標形式: [left, top, right, bottom]。 - 現在分離されている要素の詳細な説明。name よりも豊富なレイヤー特性(色、状態、マテリアルなど)を提供します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 + 現在分離された要素の詳細な説明。name よりも豊富なレイヤー特性(色、状態、マテリアルなど)を提供します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 - 現在分離されている要素の名前/ラベル。分離された被写体の特性からモデルが自動生成します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 + 現在分離された要素の名前/ラベル。分離された被写体の特性からモデルが自動生成します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 - 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro のみです。 + 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 - 画像の幅と高さ(ピクセル単位)。形式は \x\ です。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、4.5、4.0 のみです。 + 画像の幅と高さ(ピクセル単位)。形式は \<幅>x\<高さ> です。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、5.5、4.5、4.0 のみです。 @@ -311,7 +339,7 @@ Router が `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` で - レイヤーの重なり順で、下から上に向かって増加します。0 が最下層のレイヤー(ベース画像)で、値が大きいほど上に位置します。レイヤーを正しい重なり順で完全な画像に再構成するために使用します。layer_decomposition が true の場合にのみ返されます。 + レイヤーの重なり順。下から上へ増加します。0 が最下層(ベース画像)で、値が大きいほど上になります。正しい重なり順でレイヤーを完全な画像に再合成するために使用します。layer_decomposition が true の場合にのみ返されます。 @@ -319,7 +347,7 @@ Router が `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` で - 上流 ModelArk のエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のようにドット区切りの理由が付く場合があります。これは列挙型ではなくオープンな文字列です。その他のコードは検証およびプロバイダーの障害を表します。Router は HTTP 400 エラーエンベロープおよび HTTP 200 の失敗タスク応答に含まれるポリシーファミリーを認識しますが、トランスポート障害を上書きすることはありません。 + 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付く場合があります(例: InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake)。これは enum ではなくオープンな文字列です。その他のコードは検証とプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -335,11 +363,11 @@ Router が `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` で - モデルが生成した画像数 + モデルが生成した画像の数 - モデルに入力された画像数。このフィールドをサポートするのは seedream-5.0-pro のみです。 + モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 @@ -347,7 +375,7 @@ Router が `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` で - このリクエストで消費された合計トークン数。 + このリクエストで消費されたトークンの合計数。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx index e695c0239f..661b00115d 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx @@ -2,18 +2,20 @@ title: "Seedream 5.0 Pro 260628 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/seedream-5-0-pro-260628 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedream 5.0 Pro 260628" -translationSourceHash: a37309ff +translationSourceHash: f5270d3a translationFrom: development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx translationBlockHashes: "_intro": b9a1b857 "Quick start": 5b012c86 - "Schema": c3a86bb4 + "Schema": b6886a5f "Examples": 40c4bb92 --- + + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-0-pro-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -157,8 +159,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests/$ ### 入力 + + 生成される画像の背景を透明(アルファチャンネル)にするかどうかを制御します。seedream-5.0-pro、5.0-flash、および自身のスキーマでこの項目が文書化されている新しい Seedream モデルでサポートされています。 +auto: モデルがプロンプトと output_format に基づいて決定します。output_format が jpeg の場合、出力は常に不透明になります。 +transparent: 透明な背景を持つ RGBA 画像を出力します。output_format が jpeg の場合はエラーを返します。 +opaque: 不透明な背景を持つ RGB 画像を出力します。seedream-5.0-pro のデフォルトです。 +seedream-5.0-pro は画像から画像への変換でのみ透明出力をサポートしており、アルファチャンネルを持つ png 入力画像 1 枚を指定します。 +レイヤー分離シナリオではサポートされません。layer_decomposition を有効にした状態で渡すとエラーを返します。 + + 指定可能な値: `auto`、`transparent`、`opaque` + + - 出力画像が入力プロンプトにどれだけ忠実に従うかを制御します。範囲は [1, 10] です。値が大きいほどプロンプトへの追従性が強くなります。seedream-5.0-pro、5.0-lite、4.5、4.0 ではサポートされません。 + 出力画像が入力プロンプトにどの程度一致するかを制御します。範囲 [1, 10]。値が大きいほどプロンプトへの追従性が高くなります。seedream-5.0-pro、5.0-lite、4.5、4.0 ではサポートされていません。 範囲: `1` から `10` @@ -166,64 +179,73 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests/$ - 編集する画像。アクセス可能な URL、または data-URI プレフィックス付きの Base64 ペイロードとして指定します。共有の Seedream フィールドと同一ですが、参照画像の上限のみが異なり、このモデルでは 14 ではなく 10 です。 + 編集対象の画像(1 枚または複数)。アクセス可能な URL、または data-URI プレフィックス付きの Base64 ペイロードとして指定します。参照画像の上限がこのモデルでは 14 ではなく 10 である点を除き、共通の Seedream フィールドと同じです。 - レイヤー分離を有効にするかどうかを制御します。seedream-5.0-pro と 5.0-flash のみがこのパラメータをサポートします。 -true: レイヤー分離モード。モデルは単一の入力画像を 1 枚のベース画像と複数のレイヤー(最大 16 枚)に分解し、生成された各レイヤーの位置とコンテンツ情報(重なり順(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)を含む)を返します。 -false: 標準の画像生成モード。レイヤー分離は実行されません。 -レイヤー分離モードに関する注意: 単一の入力画像のみをサポートします(複数の画像を渡すとエラーが返されます)。いずれか 1 つのレイヤーの生成に失敗すると、リクエスト全体が失敗します。部分的な成功はサポートされません。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーが返されます。 + レイヤー分離を有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.5 のみです。 +true: レイヤー分離モード。モデルは単一の入力画像を 1 枚のベース画像と複数のレイヤー(最大 16、seedream-5.5 では最大 99)に分解し、生成された各レイヤーの位置と内容の情報を返します。これにはスタッキング順序(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 +false: 標準の画像生成モード。レイヤー分離は行われません。 +レイヤー分離モードに関する注意: 入力画像は 1 枚のみサポートされます(複数渡すとエラーを返します)。いずれかのレイヤーの生成に失敗した場合、リクエスト全体が失敗します。部分的な成功はサポートされません。返される画像は最大 17 枚(ベース画像 1 枚 + レイヤー 16 枚)です。seedream-5.5 は最大 layer_decomposition_options.max_images 枚(ベース画像 1 枚 + 最大 99 レイヤー)を返します。sequential_image_generation、sequential_image_generation_options、tools、stream は渡すとエラーを返します。 + + + + レイヤー分離モードのオプションです。このパラメータをサポートするのは seedream-5.5 のみで、layer_decomposition が true の場合にのみ適用されます。 + + + + このリクエストが返す画像の最大合計枚数(ベース画像とレイヤーを合わせた数)。範囲: [2, 100]。プロンプトで画像の分割方法が指定されていない場合、モデルは max_images と入力画像の複雑さに基づいてレイヤーを計画します。値が大きいほど、通常はより細かいレイヤーになります。 + + 範囲: `2` から `100` - モデル識別子。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915。POST /proxy/byteplus/api/v3/images/generations への直接の v1 呼び出しでは、これを必ず指定する必要があります。プロキシは他の値を拒否し、省略された場合は 400 を返します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを補完するためであり、Router の呼び出し元は省略します。 + モデル識別子。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915、seedream-5-5-261028。POST /proxy/byteplus/api/v3/images/generations への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。この項目がこのスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントから設定するためであり、Router の呼び出し元は省略します。 - プロンプト最適化機能の設定です。seedream-5.0-pro/5.0-lite/4.5(スタンダードモードのみをサポート)および seedream-4.0 のみがこのパラメータをサポートします。 + プロンプト最適化機能の設定です。このパラメータをサポートするのは seedream-5.0-pro/5.0-lite/4.5/5.5(standard モードのみをサポート。seedream-5.5 は fast を指定するとエラーを返します)と seedream-4.0 です。 - プロンプト最適化機能のモードを設定します。standard = より高品質ですが生成時間は長くなります。fast = より高速ですが品質は平均的になります。 + プロンプト最適化機能のモードを設定します。standard = 品質が高く、生成時間が長くなります。fast = 高速ですが、品質は平均的です。 - 取り得る値: `standard`、`fast` + 指定可能な値: `standard`、`fast` - 出力画像の形式を指定します。seedream-5.0-pro、5.0-flash、5.0-lite のみがこのパラメータをサポートします。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御し、各レイヤーは常に png で出力されます。 + 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御し、各レイヤーは常に png で出力されます。 - 取り得る値: `png`、`jpeg` + 指定可能な値: `png`、`jpeg` 画像の生成または変換のためのテキスト記述。 -レイヤー分離シナリオ(layer_decomposition を有効にした seedream-5.0-pro または 5.0-flash)では任意です。prompt を指定すると、モデルはプロンプトの意図に従って指定された要素を認識して分離します。prompt を指定しない場合、モデルは画像内の主要な要素をすべて自動検出し、独立したレイヤーに分離します。 +レイヤー分離シナリオ(layer_decomposition を有効にした seedream-5.0-pro、5.0-flash、5.5)では省略可能です。プロンプトを指定した場合、モデルはプロンプトの意図に従って指定された要素を認識して分離します。プロンプトを指定しない場合、モデルは画像内の主要な要素をすべて自動的に検出し、独立したレイヤーに分離します。 レスポンスで返される生成画像の形式を指定します - 取り得る値: `url`、`b64_json` + 指定可能な値: `url`、`b64_json` - 画像生成の確率性を制御するランダムシード。範囲: [-1, 2147483647]。指定しない場合は、シードが自動生成されます。同じ出力を再現するには、同じシード値を使用します。 + 画像生成の確率性を制御するためのランダムシード。範囲: [-1, 2147483647]。指定しない場合、シードは自動的に生成されます。同じ出力を再現するには、同じシード値を使用します。 範囲: `-1` から `2147483647` - バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされます(seedream-5.0-pro または 5.0-flash ではサポートされません)。有効な値: -auto: 自動モードでは、モデルはユーザーのプロンプトに基づいて、複数の画像を返すかどうか、また何枚の画像を含めるかを自動的に判断します。 -disabled: バッチ生成機能を無効にします。モデルは 1 枚の画像のみを生成します。 + バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされていません)。有効な値:auto: 自動モードでは、モデルがユーザーのプロンプトに基づいて複数の画像を返すかどうか、および含まれる画像数を自動的に決定します。 +disabled: バッチ生成機能を無効にします。モデルは1枚の画像のみを生成します。 - 取り得る値: `auto`、`disabled` + 可能な値: `auto`, `disabled` - seedream-5.0-lite、4.5、4.0 のみがこのパラメータをサポートします(seedream-5.0-pro および 5.0-flash ではサポートされません)。 -バッチ画像生成機能の設定。このパラメータは sequential_image_generation が auto に設定されている場合にのみ有効です。 + seedream-5.0-lite、4.5、4.0のみがこのパラメータをサポートします(seedream-5.0-pro、5.0-flash、5.5ではサポートされません)。 +バッチ画像生成機能の設定。このパラメータはsequential_image_generationがautoに設定されている場合にのみ有効です。 @@ -233,35 +255,38 @@ disabled: バッチ生成機能を無効にします。モデルは 1 枚の画 - "seedream-4-0-250828": 生成される画像の仕様を設定します。2 つの方法が利用できますが、併用はできません。 - 方法 1 | 解像度を指定します。指定可能な値: 1K、2K、4K - 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [1024x1024, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-4-5-251128": 2 つの方法が利用できます。 - 方法 1 | 解像度を指定します。指定可能な値: 2K、4K - 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, 4096x4096]、アスペクト比: [1/16, 16] -"seedream-5-0-260128": 2 つの方法が利用できます。 - 方法 1 | 解像度を指定します。指定可能な値: 2K、3K - 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, ~3072x3072]、アスペクト比: [1/16, 16] -"seedream-5-0-pro-260628": 2 つの方法が利用可能です(併用はできません)。 - 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K, 2K - 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 1024x1024、総ピクセル数: [1024x1024 (1048576), 2048x2048 (4194304)]、アスペクト比: [1/16, 16] -"seedream-5-0-flash-260915": 2 つの方法が利用可能です(併用はできません)。 - 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K, 1.5K, 2K。デフォルト: 2K - 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] -"seedream-5-0-pro-260628" と "seedream-5-0-flash-260915" で layer_decomposition を有効にした場合: 解像度レベルの方法のみがサポートされます。指定可能な値: 1K, 1.5K, 2K, auto。デフォルト: auto。 - ベース画像は、元の入力画像のアスペクト比で、指定した解像度で出力されます。各レイヤーは、元の画像でのアスペクト比を保ちつつ、指定した解像度に近いサイズで出力されます。 - auto: 入力画像のサイズとアスペクト比に基づいて出力されます。[1280x720, ~2048x2048] の範囲内の入力は元の入力サイズで出力され、1K より小さい入力は 1K で出力され、2K より大きい入力は 2K で出力されます。 + "seedream-4-0-250828": 生成画像の仕様を設定します。2つの方法が利用できますが、同時に使用することはできません。 + 方法1 | 解像度を指定します。指定可能な値: 1K、2K、4K + 方法2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [1024x1024, 4096x4096]、アスペクト比: [1/16, 16] +"seedream-4-5-251128": 2つの方法が利用できます。 + 方法1 | 解像度を指定します。指定可能な値: 2K、4K + 方法2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, 4096x4096]、アスペクト比: [1/16, 16] +"seedream-5-0-260128": 2つの方法が利用できます。 + 方法1 | 解像度を指定します。指定可能な値: 2K、3K + 方法2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, ~3072x3072]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628": 2つの方法が利用できます(同時に使用することはできません)。 + 方法1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、目的を記述します。モデルが最終サイズを決定します。指定可能な値: 1K、2K + 方法2 | 幅と高さをピクセル単位で指定します。デフォルト: 1024x1024、総ピクセル数: [1024x1024 (1048576), 2048x2048 (4194304)]、アスペクト比: [1/16, 16] +"seedream-5-0-flash-260915": 2つの方法が利用できます(同時に使用することはできません)。 + 方法1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、目的を記述します。モデルが最終サイズを決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K + 方法2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-5-261028": 2つの方法が利用できます(同時に使用することはできません)。 + 方法1 | 解像度を指定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K + 方法2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915"、"seedream-5-5-261028"でlayer_decompositionが有効な場合: 解像度レベルの方法のみがサポートされます。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 + ベース画像は、元の入力画像のアスペクト比で指定された解像度で出力されます。各レイヤーは、元の画像でのアスペクト比を維持しながら、指定された解像度に近いサイズで出力されます。 + auto: 入力画像のサイズとアスペクト比に基づいて出力します。[1280x720, ~2048x2048]以内の入力は元の入力サイズで出力され、1K未満の入力は1Kで出力され、2Kを超える入力は2Kで出力されます。 - Comfy Router は、完全な JSON 結果を取得するため、明示的に指定された stream フラグを false に確定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。seedream-5.0-lite、4.5、4.0 のみがこのパラメータをサポートします(seedream-5.0-pro および 5.0-flash ではサポートされません)。false = すべての出力画像が一度に返されます。true = 各出力画像が生成直後に返されます。 + Comfy Routerは、完全なJSON結果を取得するため、明示的に指定されたstreamフラグをfalseに固定します。v1プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。seedream-5.0-lite、4.5、4.0のみがこのパラメータをサポートします(seedream-5.0-pro、5.0-flash、5.5ではサポートされません)。false = すべての出力画像が一度に返されます。true = 生成後、各出力画像がすぐに返されます。 - 生成された画像にウォーターマークを追加するかどうかを指定します。false = ウォーターマークなし、true = 'AI generated' ラベル付きのウォーターマークを追加します + 生成画像にウォーターマークを追加するかどうかを指定します。false = ウォーターマークなし、true = 'AI generated'ラベル付きのウォーターマークを追加します -Router が `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同じドキュメントです。 +Routerが`GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json`で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 ### 出力 @@ -270,40 +295,44 @@ Router が `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json` で提 - 生成された画像に関する情報を含みます。 -レイヤー分離のシナリオでは、配列の最初の要素がベース画像(z_index=0)であり、以降の要素がレイヤーとなり、z_index の昇順で並びます。 + 生成された画像の情報を含みます。 +レイヤー分離のシナリオでは、配列の最初の要素がベース画像(z_index=0)で、後続の要素は z_index の昇順で並んだレイヤーです。 Base64 エンコードされた画像データ(response_format が "b64_json" の場合) + + 画像が実際に持つ背景タイプ(transparent または opaque)。レイヤー分離のシナリオでは、ベース画像は常に opaque で、各レイヤーは transparent です。このフィールドを返すのは seedream-5.5 のみです。 + + 現在のレイヤーがベース画像内で占める領域のバウンディングボックス情報。このフィールドを返すのはレイヤーのみで、ベース画像はキャンバス全体を覆うため bounding_box を返しません。layer_decomposition が true の場合にのみ返されます。 - レイヤーのバウンディングボックスの絶対ピクセル座標。出力ベース画像の座標系で、左上隅を (0, 0) とします。座標形式: [left, top, right, bottom]。 + レイヤーのバウンディングボックスの絶対ピクセル座標。出力されるベース画像の座標系で、左上隅が (0, 0) です。座標の形式: [left, top, right, bottom]。 - レイヤーのバウンディングボックスのパーミル量子化(正規化)座標。ベース画像のサイズに基づいて [0, 1000] の離散整数範囲に比例マッピングされ、最大 1000 で打ち切られます。座標形式: [left, top, right, bottom]。 + レイヤーのバウンディングボックスのパーミル量子化(正規化)座標。ベース画像のサイズを基準に [0, 1000] の離散的な整数範囲へ比例マッピングされ、最大 1000 で切り捨てられます。座標の形式: [left, top, right, bottom]。 - 現在の分離要素の詳細な説明。name よりも豊富なレイヤー特性(色、状態、マテリアルなど)を提供します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 + 現在の分離要素の詳細な説明。name よりも豊富なレイヤーの特性(色、状態、マテリアルなど)を提供します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 - 現在の分離要素の名前/ラベル。分離された被写体の特性からモデルによって自動生成されます。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 + 現在の分離要素の名前/ラベル。分離された被写体の特性からモデルが自動生成します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 - 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro のみです。 + 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 - 画像の幅と高さ(ピクセル単位)。形式は \x\ です。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、4.5、4.0 のみです。 + 画像の幅と高さ(ピクセル)。形式は \x\ です。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、5.5、4.5、4.0 のみです。 @@ -313,7 +342,7 @@ Router が `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json` で提 - レイヤーの重なり順。下から上に向かって増加します。0 が最下層のレイヤー(ベース画像)で、値が大きいほど上に位置します。レイヤーを正しい重なり順で完全な画像に再構成するために使用します。layer_decomposition が true の場合にのみ返されます。 + レイヤーの重なり順。下から上へ増加します: 0 が最下層(ベース画像)で、値が大きいほど上に位置します。この値を使って、レイヤーを正しい重なり順で完全な画像に再合成します。layer_decomposition が true の場合にのみ返されます。 @@ -321,7 +350,7 @@ Router が `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json` で提 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドット区切りの理由が付く場合があります。これは enum ではなくオープンな文字列です。その他のコードは検証およびプロバイダーの失敗を表します。Router は、トランスポートの失敗を上書きすることなく、HTTP 400 エラーエンベロープおよび HTTP 200 の失敗タスクレスポンス内のポリシーファミリーを認識します。 + 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付く場合があります。例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは enum ではなくオープンな文字列で、その他のコードは検証およびプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答の両方でポリシーファミリーを認識し、トランスポートの障害を上書きすることはありません。 @@ -341,7 +370,7 @@ Router が `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json` で提 - モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro のみです。 + モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 @@ -349,7 +378,7 @@ Router が `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json` で提 - このリクエストで消費されたトークンの総数。 + このリクエストで消費されたトークンの合計数。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx new file mode 100644 index 0000000000..53e26831bb --- /dev/null +++ b/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx @@ -0,0 +1,412 @@ +--- +title: "Seedream 5.5 261028 を Comfy Router で使用する" +description: "Comfy Router 経由で byteplus/seedream-5-5-261028 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "Seedream 5.5 261028" +translationSourceHash: e2bff0d7 +translationFrom: development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx +translationBlockHashes: + "_intro": 5d72228c + "Quick start": 0a48e3d8 + "Schema": c4ff843e + "Examples": 2d76f48c +--- +{/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-5-261028.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`byteplus/seedream-5-5-261028` のAPIリファレンスです。Comfy RouterがBytePlusから提供します。 + +**入力:** テキスト、画像 · **出力:** 画像 + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `byteplus/seedream-5-5-261028` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +with Comfy() as client: + result = client.models.run( + "byteplus/seedream-5-5-261028", + { + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": False, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +const { data } = await comfy.models.run("byteplus/seedream-5-5-261028", { + prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", + response_format: "url", + watermark: false, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests` に送信します。Router は実行が受け付けられるとすぐに `request_id` を伴う `201` を返し、結果は準備ができ次第、このプロセスまたは別のプロセスから収集されます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを順を追って説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "byteplus/seedream-5-5-261028", + { + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": False, + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせて、別プロセスが必要とするすべてです + + # リクエストが完了するまでポーリングし、サーバーが示す Retry-After だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。 + # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +const handle = await comfy.models.submit("byteplus/seedream-5-5-261028", { + prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", + response_format: "url", + watermark: false, +}); +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); +``` + +```bash cURL +# 1. 送信します。Router は request_id、status_url、response_url、cancel_url を伴う 201 を返します。 +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" + +# 2. status が COMPLETED になるまでポーリングし、各レスポンスが示す Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集します。実行中はステータスボディを伴う 202、完了後はモデルネイティブの出力を伴う 200 を返します。 +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + 生成される画像を透明な背景(アルファチャンネル)にするかどうかを制御します。seedream-5.0-pro、5.0-flash、および自身のスキーマでこの項目が文書化されている新しい Seedream モデルでサポートされています。 +auto: モデルがプロンプトと output_format から判断します。output_format が jpeg の場合、出力は常に不透明になります。 +transparent: 透明な背景を持つ RGBA 画像を出力します。output_format が jpeg の場合はエラーを返します。 +opaque: 不透明な背景を持つ RGB 画像を出力します。seedream-5.0-pro のデフォルトです。 +seedream-5.0-pro は、アルファチャンネルを持つ 1 枚の png 入力画像を用いた画像から画像への変換でのみ、透明出力をサポートします。 +レイヤー分離シナリオではサポートされません。layer_decomposition を有効にした状態で渡すとエラーを返します。 + + 指定可能な値: `auto`、`transparent`、`opaque` + + + + 出力画像が入力プロンプトにどれだけ忠実に従うかを制御します。範囲は [1, 10] です。値が大きいほどプロンプトへの追従性が高くなります。seedream-5.0-pro、5.0-lite、4.5、4.0 ではサポートされません。 + + 範囲: `1` から `10` + + 形式: `float` + + + + 編集する画像(複数可)。アクセス可能な URL、または data URI プレフィックス付きの Base64 ペイロードで指定します。参照画像の上限がこのモデルでは 14 ではなく 10 である点を除き、共有の Seedream フィールドと同じです。 + + + + レイヤー分離を有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.5 のみです。 +true: レイヤー分離モード。モデルは単一の入力画像を 1 枚のベース画像と複数のレイヤー(最大 16、seedream-5.5 では最大 99)に分解し、生成された各レイヤーの位置と内容の情報を返します。これには重なり順(z_index)、バウンディングボックス(bounding_box)、名前(name)、説明(description)が含まれます。 +false: 標準の画像生成モードです。レイヤー分離は行われません。 +レイヤー分離モードに関する注意: 入力画像は 1 枚のみサポートされます(複数の画像を渡すとエラーを返します)。いずれか 1 つのレイヤーの生成に失敗した場合、リクエスト全体が失敗します(部分的な成功はサポートされません)。返される画像は最大 17 枚です(ベース画像 1 枚 + レイヤー 16 枚)。seedream-5.5 は最大で layer_decomposition_options.max_images 枚の画像(ベース画像 1 枚 + 最大 99 レイヤー)を返します。sequential_image_generation、sequential_image_generation_options、tools、stream を渡すとエラーを返します。 + + + + レイヤー分離モードのオプションです。このパラメータをサポートするのは seedream-5.5 のみで、layer_decomposition が true の場合にのみ適用されます。 + + + + このリクエストが返す画像の最大総数で、ベース画像とレイヤーを合わせた枚数です。範囲: [2, 100]。プロンプトで画像の分割方法が指定されていない場合、モデルは max_images と入力画像の複雑さに基づいてレイヤーを計画します。値が大きいほど、通常はより細かいレイヤーになります。 + + 範囲: `2` から `100` + + + + モデル識別子です。サポートされるモデル: seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915、seedream-5-5-261028。POST /proxy/byteplus/api/v3/images/generations への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこの値を設定するためで、Router の呼び出し元は省略します。 + + + + プロンプト最適化機能の設定です。このパラメータをサポートするのは seedream-5.0-pro/5.0-lite/4.5/5.5(standard モードのみをサポートし、seedream-5.5 は fast を指定するとエラーを返します)と seedream-4.0 のみです。 + + + + プロンプト最適化機能のモードを設定します。standard = より高品質ですが、生成時間は長くなります。fast = より高速ですが、品質は平均的になります。 + + 指定可能な値: `standard`、`fast` + + + + 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御し、各レイヤーは常に png で出力されます。 + + 指定可能な値: `png`、`jpeg` + + + + 画像の生成または変換のためのテキスト記述です。 +レイヤー分離シナリオ(layer_decomposition を有効にした seedream-5.0-pro、5.0-flash、5.5)では任意です。プロンプトを指定した場合、モデルはプロンプトの意図に従って指定された要素を認識して分離します。プロンプトを指定しない場合、モデルは画像内の主要な要素をすべて自動的に検出し、独立したレイヤーに分離します。 + + + + レスポンスで返される生成画像の形式を指定します。 + + 指定可能な値: `url`、`b64_json` + + + + 画像生成の確率性を制御するランダムシードです。範囲: [-1, 2147483647]。指定しない場合は、シードが自動的に生成されます。同じ出力を再現するには、同じシード値を使用してください。 + + 範囲: `-1` から `2147483647` + + + + バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。指定可能な値:auto: 自動モードでは、モデルはユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および画像を何枚含めるかを自動的に決定します。 +disabled: バッチ生成機能を無効にします。モデルは1枚の画像のみを生成します。 + + 指定可能な値: `auto`, `disabled` + + + + このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 はサポートしていません)。 +バッチ画像生成機能の設定です。このパラメータは、sequential_image_generation が auto に設定されている場合にのみ有効です。 + + + + このリクエストで生成する画像の最大数を指定します。入力参照画像の数 + 生成される画像の数 ≤ 15。 + + 範囲: `1` から `15` + + + + "seedream-4-0-250828": 生成される画像の仕様を設定します。2つの方法を使用できますが、併用はできません。 + 方法 1 | 解像度を指定します。指定可能な値: 1K、2K、4K + 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [1024x1024, 4096x4096]、アスペクト比: [1/16, 16] +"seedream-4-5-251128": 2つの方法を使用できます。 + 方法 1 | 解像度を指定します。指定可能な値: 2K、4K + 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, 4096x4096]、アスペクト比: [1/16, 16] +"seedream-5-0-260128": 2つの方法を使用できます。 + 方法 1 | 解像度を指定します。指定可能な値: 2K、3K + 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 2048x2048、総ピクセル数: [2560x1440, ~3072x3072]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628": 2つの方法を使用できます(併用はできません)。 + 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、2K + 方法 2 | 幅と高さをピクセル単位で指定します。デフォルト: 1024x1024、総ピクセル数: [1024x1024 (1048576), 2048x2048 (4194304)]、アスペクト比: [1/16, 16] +"seedream-5-0-flash-260915": 2つの方法を使用できます(併用はできません)。 + 方法 1 | 解像度を指定し、プロンプトで画像のアスペクト比、形状、用途を記述します。最終的なサイズはモデルが決定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K + 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-5-261028": 2つの方法を使用できます(併用はできません)。 + 方法 1 | 解像度を指定します。指定可能な値: 1K、1.5K、2K。デフォルト: 2K + 方法 2 | 幅と高さをピクセル単位で指定します。総ピクセル数: [1280x720 (921600), 2048x2048x1.1025 (4624220)]、アスペクト比: [1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915"、および "seedream-5-5-261028" で layer_decomposition が有効な場合: 解像度レベルの方法のみがサポートされます。指定可能な値: 1K、1.5K、2K、auto。デフォルト: auto。 + ベース画像は、オリジナルの入力画像のアスペクト比を維持して、指定された解像度で出力されます。各レイヤーは、オリジナル画像でのアスペクト比を維持しながら、指定された解像度に近いサイズで出力されます。 + auto: 出力は入力画像のサイズとアスペクト比に基づきます。[1280x720, ~2048x2048] 内の入力はオリジナルの入力サイズで出力されます。1K より小さい入力は 1K で出力され、2K より大きい入力は 2K で出力されます。 + + + + Comfy Router は完全な JSON 結果を取得するため、明示的に指定された stream フラグを false に設定します。v1 プロキシでは、このフィールドはストリーミング出力モードを有効にするかどうかを制御します。このパラメータをサポートするのは seedream-5.0-lite、4.5、4.0 のみです(seedream-5.0-pro、5.0-flash、5.5 はサポートしていません)。 + false = すべての出力画像が一度に返されます。 + true = 生成後すぐに各出力画像が返されます。 + + + + 生成済みの画像にウォーターマークを追加するかどうかを指定します。 + false = ウォーターマークなし + true = 'AI generated' ラベル付きのウォーターマークを追加します + + +Router が `GET /v2/models/byteplus/seedream-5-5-261028/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に、Router が呼び出しを検証する対象となる同じドキュメントです。 + +### 出力 + + + リクエストが作成された時刻を示す Unix タイムスタンプ(秒単位) + + + + 生成された画像の情報を含みます。 +レイヤー分離のシナリオでは、配列の最初の要素がベース画像(z_index=0)で、それに続く要素がレイヤーとなり、z_index の昇順で並びます。 + + + + Base64 でエンコードされた画像データ(response_format が "b64_json" の場合) + + + + 画像が実際に持つ背景タイプ(transparent または opaque)。レイヤー分離のシナリオでは、ベース画像は常に opaque で、すべてのレイヤーは transparent です。このフィールドを返すのは seedream-5.5 のみです。 + + + + 現在のレイヤーがベース画像内で占める領域のバウンディングボックス情報。このフィールドを返すのはレイヤーのみで、ベース画像はキャンバス全体を覆うため bounding_box を返しません。layer_decomposition が true の場合にのみ返されます。 + + + + レイヤーのバウンディングボックスの絶対ピクセル座標。出力されるベース画像の座標系で、左上隅を (0, 0) とします。座標の形式: [left, top, right, bottom]。 + + + + レイヤーのバウンディングボックスのパーミル量子化(正規化)座標。ベース画像のサイズに基づいて [0, 1000] の離散的な整数範囲に比例マッピングされ、最大 1000 で切り捨てられます。座標の形式: [left, top, right, bottom]。 + + + + 現在分離された要素の詳細な説明。name よりも豊富なレイヤーの特徴(色、状態、マテリアルなど)を提供します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 + + + + 現在分離された要素の名前/ラベル。分離された被写体の特徴からモデルが自動的に生成します。このフィールドを返すのはレイヤーのみで、ベース画像は返しません。layer_decomposition が true の場合にのみ返されます。 + + + + 出力画像のファイル形式。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 + + + + 画像の幅と高さ(ピクセル単位)。形式は \x\ です。このパラメータをサポートするのは seedream-5.0-pro、5.0-lite、5.5、4.5、4.0 のみです。 + + + + 画像ダウンロード用の URL(response_format が "url" の場合) + + 形式: `uri` + + + + レイヤーの重なり順。下から上へ増加します。0 が最下層のレイヤー(ベース画像)で、値が大きいほど上に位置します。レイヤーを正しい重なり順で完全な画像に再合成するために使用します。layer_decomposition が true の場合にのみ返されます。 + + + + エラー情報(存在する場合) + + + + 上流の ModelArk のエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付く場合があります(例: InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake)。これは列挙型ではなくオープンな文字列で、その他のコードは検証エラーやプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープおよび HTTP 200 の失敗タスク応答においてポリシーファミリーを認識しますが、トランスポート層の失敗を上書きすることはありません。 + + + + エラーメッセージ + + + + リクエストに使用されたモデル ID + + + + + + + + モデルが生成した画像の数 + + + + モデルに入力された画像の数。このフィールドをサポートするのは seedream-5.0-pro と 5.5 のみです。 + + + + モデルが生成した画像に使用されたトークン数。 + + + + このリクエストで消費されたトークンの総数。 + + +## 例 + +### 入力 + +```json +{ + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": false +} +``` + +### 出力 + +```json +{ + "created": 1767225600, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/byteplus/seedream-4-0-250828/generated.png" + } + ], + "model": "seedream-5-5-261028", + "usage": { + "generated_images": 1 + } +} +``` + + diff --git a/ja/development/comfy-router/models/meshy/rigging/code.mdx b/ja/development/comfy-router/models/meshy/rigging/code.mdx index 1f356a7ae1..58d17b3443 100644 --- a/ja/development/comfy-router/models/meshy/rigging/code.mdx +++ b/ja/development/comfy-router/models/meshy/rigging/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Rigging を使用する" description: "Comfy Router 経由で meshy/rigging を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Rigging" -translationSourceHash: d7eb966f +translationSourceHash: e8dbb3d3 translationFrom: development/comfy-router/models/meshy/rigging/code.mdx translationBlockHashes: "_intro": 2ec24f71 "Quick start": 08a075b7 - "Schema": 2d8d7dbb + "Schema": 66703709 "Examples": 8e91e01b --- + {/* GENERATED FILE. Generated from router-schemas/meshy/rigging.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -157,6 +158,10 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ 範囲: `0` ~ `…` + + キャラクターの手に指のボーンを追加するかどうか。Biped リグのみで有効です。texture_image_url を指定した場合、quadruped リグの場合、または quad-topology の input_task_id を指定した場合、Meshy はリクエストを 400 で拒否し、指なしでのみリギングできるモデルの場合は 422 で拒否します(課金なし)。指のボーンはクレジットコストを変えません。デフォルトは false です。 + + リギングが必要な入力タスク。model_url が指定されていない場合は必須です。 @@ -165,6 +170,12 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ テクスチャ付きのヒューマノイド GLB ファイルへの公開アクセス可能な URL または Data URI。input_task_id が指定されていない場合は必須です。 + + リギング済みキャラクターのスケルトン。ボーン名と階層を設定します。Biped リグのみで有効です。meshyrig 以外の値(または include_fingers が true)を指定すると、出力ファイルはメートル単位になり、センチメートル単位のデフォルトの 24 ボーン meshyrig ファイルの代わりにそのスケルトンのボーンが使用されます。このリグから作成したアニメーションタスクも同じスケルトンを使用します。それ以外の値は拒否されます。デフォルトは meshyrig です。 + + 有効な値: `meshyrig`、`mixamo`、`ue5_mannequin`、`max_biped`、`unity_humanoid`、`maya_human_ik`、`blender_rigify_basic_human`、`cc5_hd_neutral_base`、`daz_genesis9` + + モデルの UV 展開済みベースカラーテクスチャ画像。公開アクセス可能な URL または Data URI。.png 形式に対応しています。 diff --git a/ja/development/serverless/library-models.mdx b/ja/development/serverless/library-models.mdx new file mode 100644 index 0000000000..901ddb86a0 --- /dev/null +++ b/ja/development/serverless/library-models.mdx @@ -0,0 +1,171 @@ +--- +title: "Comfy API デプロイメントでワークスペースライブラリのモデルを使用する" +sidebarTitle: "ライブラリのモデル" +description: "LoRA などの .safetensors モデルをワークスペースライブラリにアップロードし、新しいビルド、リリース、再デプロイなしで Comfy API デプロイメント上で実行できます。" +icon: "folder-open" +translationSourceHash: ece5d691 +translationFrom: development/serverless/library-models.mdx +translationBlockHashes: + "_intro": 6a0b3555 + "Before you start": c7b9ddf9 + "Upload a model to the workspace library": 693a12a3 + "Run the model on your deployment": 8b7df85e + "Follow the limits and naming rules": 5b0d3461 + "Change or delete a library model": dda1b7bd +--- +Comfy API は、デプロイメントのリリースに含まれていない場合でも、ワークスペースライブラリのモデルを実行します。LoRA または別の `.safetensors` モデルをライブラリにアップロードし、新しいビルド、リリース、再デプロイなしでデプロイメント上で実行します。 + +ワークスペースライブラリを使用して、デプロイメントでトレーニングした LoRA を試したり、ワークフロー内のファイル名を1つ変更して API リクエストごとに異なる LoRA を選択したりできます。 + +## 始める前に + +モデルをワークスペースライブラリにアップロードする前に、次の要件を満たしていることを確認してください: + +- **プラン**: ワークスペースには、有効なプロ、クリエイター、チーム、またはエンタープライズプランが必要です。 +- **モデルファイル**: ファイルは 2 GB 以下の `.safetensors` ファイルである必要があります。SDXL や Flux などのより大きなベースモデルは、引き続き Build に配置します。 +- **有効なデプロイメント**: デプロイメントはライブラリと同じワークスペースにある必要があります。 + + + ワークスペースライブラリモデルが利用可能になる前に作成された一部のデプロイメントでは、これらのモデルを読み込めません。ワークスペースライブラリモデルを使用するには、新しいデプロイメントを作成してください。古いデプロイメントでは、ジョブが `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` で失敗する可能性があります。 + + +## ワークスペースライブラリへのモデルのアップロード + +モデルは次の3つのツールのいずれかでアップロードできます。 + +- **クラウドエディタ**: ファイルをアップロードするか、Civitai または Hugging Face のリンクからインポートします。 +- **comfy-cli**: ターミナルまたはスクリプトからアップロードします。 +- **Developer Platform**: Build のモデルステップからアップロードします。 + +使用するツールのタブを選択してください。 + + + + 1. **Run** の左側にあるデプロイメントメニューで、**Run on** の下で **Comfy Cloud** が選択されていることを確認します。 + 2. **左サイドバー**で **モデルライブラリ** をクリックし、**インポート** をクリックします。 + 3. **ファイルを選択** をクリックするか、`.safetensors` ファイルをダイアログにドラッグします。 + 4. **What type of model is this?** で、LoRA の場合は **LoRA** のままにし、それ以外はファイルに一致するタイプを選択します。 + 5. **アップロード** をクリックします。アップロードが完了したら **完了** をクリックします。 + + ![my_style_lora_9e2417.safetensors (97.37 MB) が選択され、What type of model is this? が LoRA に設定されたインポートダイアログ。Back と Upload ボタンがある](/images/development/serverless/library-models-editor-import.png) + + 代わりに Civitai または Hugging Face のリンクからモデルをインポートするには: + + 1. **インポート** ダイアログの **ここにリンクを貼り付けてください** にモデルのリンクを貼り付けます。 + 2. **続ける** をクリックします。 + 3. **What type of model is this?** でモデルタイプを選択します。 + 4. **インポート** をクリックします。 + + デプロイメントで実行できるのは `.safetensors` ファイルのみです。`.ckpt` など他の形式のリンクインポートはライブラリにはインポートされますが、デプロイメントでは実行されません。 + + + ファイルをアップロードし、`--type` でモデルタイプを設定します。 + + ```bash + comfy assets library upload my_style.safetensors --type loras + ``` + + ファイルがライブラリにあることを確認します。 + + ```bash + comfy assets library ls --tags models,loras + ``` + + + 1. Developer Platform で、Build のモデルステップを開き、**モデルをアップロード** をクリックします。 + 2. **ワークスペースライブラリ** を選択します。 + 3. `.safetensors` ファイルをドロップ領域にドラッグするか、領域をクリックしてブラウズします。 + 4. **モデルタイプ** で、LoRA の場合は **LoRA** のままにし、それ以外はファイルに一致するタイプを選択します。 + 5. **アップロード** をクリックします。 + + ![Build の「Which models ship inside the build?」ステップにあるモデルをアップロードダイアログ。Public、Private、ワークスペースライブラリのタブがあり、ワークスペースライブラリが選択され、ドロップ領域、LoRA に設定されたモデルタイプ、ファイルがワークスペースライブラリにあることを示す行、Cancel と Upload ボタンがある](/images/development/serverless/library-models-platform-upload.png) + + + +モデルがライブラリに入れば、ワークスペースのすべてのメンバーがそのモデルを使用できます。ライブラリは LoRA だけでなく、あらゆるモデルタイプを受け入れます。ローダーノードが読み取るフォルダーに一致するタイプを選択してください。たとえば LoRA なら `loras`、VAE なら `vae` です。 + +## デプロイでモデルを実行する + +モデルがライブラリに入ると、CloudエディタまたはAPIからデプロイ上で実行できます。ジョブの送信方法に応じてタブを選択してください。 + + + + 1. **Run** の左にあるデプロイメントメニューをクリックします。**Run on** でデプロイメントを選択します。エディタが再読み込みされますが、タブは開いたままです。 + 2. `Load LoRA (Model and CLIP)` ノードを追加するか、それが含まれるワークフローを開きます。 + 3. ノードの `lora_name` リストでファイルを選択します。リストには、Releaseのモデルの隣にライブラリのモデルが表示されます。 + 4. **Run** をクリックします。 + + 初回実行時は、ワーカーがファイルをダウンロードしている間、キューのジョブの行に `Downloading my_style.safetensors` と表示されます。ジョブが複数のモデルをダウンロードする場合、行には `Downloading ( of )` と表示されます。 + + ![Load Checkpoint ノードと Load LoRA (Model and CLIP) ノードを含むワークフロー、lora_name で選択済みのアップロード済み LoRA、キューパネルの最上行に Downloading my_style_lora_9e2417.safetensors 0 B of 97.37 MB と表示されている様子](/images/development/serverless/library-models-editor-downloading.png) + + + [API形式のワークフロー](/ja/development/api-development/workflow-api-format)で、`LoraLoader` ノードの `lora_name` 入力に、`.safetensors` を含むライブラリのファイル名を設定します: + + ```json + "10": { + "class_type": "LoraLoader", + "inputs": { + "lora_name": "my_style.safetensors", + "strength_model": 1.0, + "strength_clip": 1.0, + "model": ["4", 0], + "clip": ["4", 1] + } + } + ``` + + ワークフローは `comfy deploy run`、[Comfy SDK](/ja/development/api-development/sdks)、または [Comfy API v2](/ja/api-reference/v2/overview) で送信します: + + ```bash + comfy deploy run --deployment --workflow workflow_api.json + ``` + + 別のLoRAを使用するには、次のリクエストで `lora_name` をライブラリ内の別のファイル名に変更します。新しいBuild、Release、再デプロイは必要ありません。 + + + + + ライブラリのモデルを使用するワーカーでは、最初のジョブに時間がかかります。ワーカーが最初にモデルをダウンロードするためです。同じワーカーでの後続のジョブは、キャッシュされたコピーを使用します。新しいワーカーはモデルを再度ダウンロードし、他のモデルのための容量を確保するためにキャッシュからモデルを削除したワーカーも同様です。ダウンロードを省略するには、モデルをBuildに追加してください。 + + +## 制限と命名ルールに従う + +[開始する前に](#始める前に) に記載されているファイルサイズと形式の制限に加えて、次の制限が適用されます。 + +| 制限 | 値 | +| --- | --- | +| ワークスペースのストレージ | ワークスペースあたり1 TBのモデル(リンクインポートを含む) | +| ワークフローあたりのライブラリモデル名 | 100 | + +101個目のライブラリモデルを指定するローダーは、そのファイルがライブラリに存在しない場合と同じように失敗します。 + +ジョブが正しいファイルを見つけられるように、次のルールに従ってください。 + +- **ローダーが読み取るフォルダーを使用する。** ローダーは、自身のモデルタイプのライブラリファイルのみを見つけます。`Load LoRA` ノードは `loras` としてアップロードされたファイルを見つけますが、`checkpoints` としてアップロードされたファイルは見つけません。 +- **ベアファイル名を使用する。** ローダーの入力には `my_style.safetensors` のようにファイル名だけを設定し、前にフォルダーを付けないでください。 +- **リリースモデルの名前を再利用しない。** リリースに同じ名前のファイルが既にある場合、ワーカーはライブラリのファイルではなくリリースのファイルを使用します。 +- **フォルダー間で名前を一意に保つ。** 1つのローダーが読み取る2つのフォルダーにライブラリが同じファイル名を持つ場合、API経由で送信されたジョブはどちらのファイルも読み込みません。 +- **最新のファイルが優先されることを想定する。** 1つのフォルダー内に同じ名前のファイルが2つある場合、ジョブは最後に追加されたものを使用します。 +- **ベースモデルを一致させる。** LoRAは、ワークフローが読み込むベースモデルと一致している必要があります。 +- **デプロイに存在するローダーを使用する。** ローダーノードはデプロイ上で利用可能である必要があります。ライブラリモデルは、Comfy Cloud が持つローダーノードを通じてのみ読み込まれます。使用するローダーが Comfy Cloud にないカスタムノード由来の場合は、そのモデルをビルドに追加してください。 + +## ライブラリモデルの変更または削除 + +**実行先**でデプロイメントが選択されている場合、**モデルライブラリ**にはそのリリースのモデルのみが表示されます。ライブラリのモデルを変更または削除するには、まず Comfy Cloud に切り替え直してください。 + +1. **実行**の左にあるデプロイメントメニューをクリックします。**実行先**で **Comfy Cloud** を選択します。 +2. **左サイドバー**で **モデルライブラリ**をクリックします。 + +モデルタイプを変更するには: + +- モデルのカードにカーソルを合わせ、**モデル情報**をクリックして、新しい**モデルタイプ**を選択します。 + + + モデルを削除すると、メンバー全員のワークスペースライブラリからそのモデルが削除されます。ファイル名を指定したままのジョブまたは API リクエストは、ローダー入力で `Value not in list` エラーが発生して失敗します。 + + +モデルを削除するには: + +1. モデルのカードにカーソルを合わせ、**その他**をクリックしてから、**削除**をクリックします。 +2. **このモデルを削除しますか?** で、**削除**をクリックします。 diff --git a/ja/development/serverless/overview.mdx b/ja/development/serverless/overview.mdx index 39265cc11d..9eac5551c9 100644 --- a/ja/development/serverless/overview.mdx +++ b/ja/development/serverless/overview.mdx @@ -2,11 +2,11 @@ title: "Comfy API:サーバーレスデプロイ" description: "Comfy API で ComfyUI ワークフローをマネージド GPU エンドポイントとしてデプロイします。Build、リリース、リージョン、ワーカーのスケーリング、ワークスペース制限、デプロイの監視を解説。" icon: "cloud-arrow-up" -translationSourceHash: 2184a3a5 +translationSourceHash: 4df17332 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 - "Platform concepts": 97134dfe + "Platform concepts": cd4243ce "The Build file": 70f351b1 "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f @@ -14,10 +14,11 @@ translationBlockHashes: "Monitor and call a deployment": ff860dab "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b - "FAQ": 54896279 + "FAQ": 08ef9084 "Next steps": 0045baa9 --- + Comfy API を使うと、アプリケーションからマネージドエンドポイント経由で ComfyUI ワークフローを実行できます。ワークフローに必要な ComfyUI のバージョン、モデル、カスタムノード、依存関係をパッケージ化すると、Comfy がマネージド GPU 上で実行します。環境を再現可能に保ち、アプリケーションから呼び出せるエンドポイントが必要な場合に使います。 ## プラットフォームの用語 @@ -26,10 +27,12 @@ Comfy API を使うと、アプリケーションからマネージドエンド | --- | --- | | **ワークスペース** | メンバー、Build、デプロイ、使用上限を管理するチームアカウントです。 | | **Build** | ComfyUI のバージョン、モデル、カスタムノード、依存関係を含む環境定義です。 | -| **Build バージョン / リリース** | `linux/nvidia` など、デプロイターゲット向けに用意された番号付きの Build です。 | -| **デプロイ** | リリースを実行するエンドポイントです。GPU、リージョン、ワーカー設定を持ちます。 | +| **Build バージョン / リリース** | `linux/nvidia` などのデプロイターゲット向けに用意された、番号付きの Build バージョンです。 | +| **デプロイ** | リリースを使用する実行中のエンドポイントです。独自の GPU、リージョン、ワーカー設定を持ちます。 | + +[Comfy Cloud](/ja/development/deploy/cloud) でサポートされるワークフローは、Build やデプロイを作成せずにそこで実行できます。 -[Comfy Cloud](/ja/development/deploy/cloud) でサポートされるワークフローは、Build やデプロイを作成せずに実行できます。 +新しい Build を作成せずにモデルをデプロイへ追加するには、ワークスペースライブラリにアップロードします。詳しくは [ワークスペースライブラリのモデル](/ja/development/serverless/library-models) を参照してください。 エージェントから始めるか、環境やワークフローを用意する別の方法を選んでください。 @@ -132,9 +135,9 @@ comfy deploy events --deployment dep_123456 ストレージの課金はデプロイメントから始まります: - - リリースをデプロイすると、そのモデルはデプロイメントのワーカー間で共有されるネットワークストレージに配置されます。このストレージはデプロイ後は読み取り専用となり、そのリージョンにその Build のデプロイメントが存在する限り、`comfy deploy stop` でデプロイメントが一時停止している間も含めて、GB 月単位で課金されます。 + - リリースをデプロイすると、そのモデルはデプロイメントのワーカーが共有するネットワークストレージに配置されます。このストレージはデプロイ後は読み取り専用となり、そのリージョンにその Build のデプロイメントが存在する限り、`comfy deploy stop` でデプロイメントが一時停止している間も含めて、GB 月単位で課金されます。ジョブが[ワークスペースライブラリ](/ja/development/serverless/library-models)から使用するモデルは、そこには配置されません。ワーカーがジョブのためにそれらをダウンロードします。 - 各ワーカーには固定 50 GB のコンテナディスクも割り当てられます。これはエフェメラルであり、ワーカーのコンピュートコストの一部として、ワーカーの実行中のみ課金されます。 - - デプロイメントを削除すると、そのコンピュートが解放されます。配置されたネットワークストレージは、そのリージョンでそれを使用している最後のデプロイメントが削除された直後にクリーンアップされ、その課金も終了します。 + - デプロイメントを削除すると、そのコンピュートが解放されます。配置されたネットワークストレージは、そのリージョンでそれを使用している最後のデプロイメントが削除された後、まもなくクリーンアップされ、その課金も終了します。 現在のストレージ料金については、[Comfy 料金ページ](https://www.comfy.org/pricing)をご覧ください。コンピュートカタログ(`comfy deploy refs compute`)とデプロイダイアログにも、デプロイメントに適用される料金が表示されます。 diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index b579bf7798..d31c071bc9 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -2,16 +2,16 @@ title: "Comfy Router 모델" sidebarTitle: "모든 모델" description: "Comfy Router에서 사용할 수 있는 모든 모델을 제공자별로 정리하고, 각 모델의 입력 및 출력 모달리티를 함께 표시합니다." -translationSourceHash: 947ab0cb +translationSourceHash: 04ecf050 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 47e9d047 + "Find by output": 2dfd8d42 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 - "BytePlus": 0ff87da0 + "BytePlus": 0767a672 "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 @@ -48,6 +48,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from the Router catalog by `pnpm code-pages:gen`. */} 아래의 모든 모델은 동일한 라우트인 `POST /v2/models/{provider}/{model}`를 통해 제공되며, 각 모델 고유의 JSON 본문을 사용합니다. 각 페이지에는 Python, TypeScript, cURL로 작성된 실제 동작하는 요청 예시가 있습니다. 검색, 스키마, 오류, 재시도, 청구에 대해서는 [Comfy Router API 사용하기](/ko/development/comfy-router/api)를 참고하세요. @@ -60,13 +61,13 @@ translationBlockHashes: - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` -- [FLUX 3 Video](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [FLUX Video Upscale](/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code): `bfl/video-upscale-v1` -- [Video Edit V1](/ko/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1` -- [Video Edit Erase](/ko/development/comfy-router/models/bria/video-edit-erase/code): `bria/video-edit-erase` -- [Video Edit Green Screen](/ko/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` -- [Video Edit Remove Background](/ko/development/comfy-router/models/bria/video-edit-remove-background/code): `bria/video-edit-remove-background` -- [Video Edit Replace Background](/ko/development/comfy-router/models/bria/video-edit-replace-background/code): `bria/video-edit-replace-background` +- [FLUX 3 비디오](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` +- [FLUX 비디오 업스케일](/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code): `bfl/video-upscale-v1` +- [비디오 편집 V1](/ko/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1` +- [비디오 편집 지우기](/ko/development/comfy-router/models/bria/video-edit-erase/code): `bria/video-edit-erase` +- [비디오 편집 초록색 스크린](/ko/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` +- [비디오 편집 배경 제거](/ko/development/comfy-router/models/bria/video-edit-remove-background/code): `bria/video-edit-remove-background` +- [비디오 편집 배경 교체](/ko/development/comfy-router/models/bria/video-edit-replace-background/code): `bria/video-edit-replace-background` - [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` - [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` @@ -74,12 +75,12 @@ translationBlockHashes: - [Seedance 1.0 Pro 250528](/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code): `byteplus/seedance-1-0-pro-250528` - [Seedance 1.0 Pro Fast 251015](/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code): `byteplus/seedance-1-0-pro-fast-251015` - [Seedance 1.5 Pro 251215](/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` -- [Crystal Video Upscaler](/ko/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` +- [Crystal 비디오 업스케일러](/ko/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` - [FLUX 3 Max](/ko/development/comfy-router/models/fal/flux-3-max/code): `fal/flux-3-max` - [H3 Max Turbo](/ko/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo` - [H3 Max](/ko/development/comfy-router/models/fal/h3-max/code): `fal/h3-max` - [Gemini Omni 1.2 Flash](/ko/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code): `gemini-interactions/gemini-omni-1.2-flash` -- [Higgsfield Genjutsu Motion Transfer V1.0](/ko/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` +- [Higgsfield Genjutsu 모션 트랜스퍼 V1.0](/ko/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` - [Higgsfield Kling 3.4k](/ko/development/comfy-router/models/higgsfield/higgsfield-kling-3-4k/code): `higgsfield/higgsfield-kling-3-4k` - [Higgsfield Kling 3 Pro](/ko/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` - [Kling 3.0 Turbo](/ko/development/comfy-router/models/kling/kling-3-0-turbo/code): `kling/kling-3.0-turbo` @@ -88,29 +89,28 @@ translationBlockHashes: - [Kling V2.6](/ko/development/comfy-router/models/kling/kling-v2-6/code): `kling/kling-v2-6` - [Kling V3 Omni](/ko/development/comfy-router/models/kling/kling-v3-omni/code): `kling/kling-v3-omni` - [Kling V3](/ko/development/comfy-router/models/kling/kling-v3/code): `kling/kling-v3` -- [Kling Video O1](/ko/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1` -- [Videos Avatar Image 2video](/ko/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` -- [Videos Lip Sync](/ko/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` +- [Kling 비디오 O1](/ko/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1` +- [비디오 아바타 이미지 2비디오](/ko/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` +- [비디오 립싱크](/ko/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` - [LTX 2.5 Fast](/ko/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ko/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/ko/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` - [MiniMax H3](/ko/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` -- [Image To Video](/ko/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` -- [Text To Video](/ko/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` -- [Video To Video](/ko/development/comfy-router/models/moonvalley/video-to-video/code): `moonvalley/video-to-video` -- [Pika 2.5 Image To Video](/ko/development/comfy-router/models/pika/pika-2-5-image-to-video/code): `pika/pika-2.5-image-to-video` -- [Pika 2.5 Text To Video](/ko/development/comfy-router/models/pika/pika-2-5-text-to-video/code): `pika/pika-2.5-text-to-video` -- [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` -- [Pika H3 Flex Reference To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` -- [Pika H3 Flex Text To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` -- [Pika Soundtrack](/ko/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` -- [P Video 2](/ko/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` +- [이미지 기반 비디오 생성](/ko/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` +- [텍스트 기반 비디오 생성](/ko/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` +- [비디오 기반 비디오 생성](/ko/development/comfy-router/models/moonvalley/video-to-video/code): `moonvalley/video-to-video` +- [Pika 2.5 이미지 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-2-5-image-to-video/code): `pika/pika-2.5-image-to-video` +- [Pika 2.5 텍스트 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-2-5-text-to-video/code): `pika/pika-2.5-text-to-video` +- [Pika H3 Flex 이미지 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` +- [Pika H3 Flex 레퍼런스 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` +- [Pika H3 Flex 텍스트 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` +- [Pika 사운드트랙](/ko/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` +- [P 비디오 2](/ko/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/ko/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/ko/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ko/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` -- [Clean Audio Video](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [클린 오디오 비디오](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` +- [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`- [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` - [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` @@ -142,7 +142,7 @@ translationBlockHashes: - [Grok Imagine Video](/ko/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/ko/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -164,19 +164,19 @@ translationBlockHashes: - [Image Edit Increase Resolution](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/ko/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/ko/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` -- [Image Edit Remove Background Guided](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` -- [Image Edit Remove Background](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` -- [Image Edit Replace Background](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` -- [Image Edit Restore](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` -- [Image](/ko/development/comfy-router/models/bria/image/code): `bria/image` +- [Image Edit Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [이미지 편집 배경 제거 가이드](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [이미지 편집 배경 제거](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` +- [이미지 편집 배경 교체](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` +- [이미지 편집 텍스트로 객체 교체](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` +- [이미지 편집 Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [이미지 편집 복원](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` +- [이미지](/ko/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` - [Seedream 4.5 251128](/ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code): `byteplus/seedream-4-5-251128` - [Seedream 5.0 260128](/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code): `byteplus/seedream-5-0-260128` - [Seedream 5.0 Flash 260915](/ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code): `byteplus/seedream-5-0-flash-260915` - [Seedream 5.0 Pro 260628](/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code): `byteplus/seedream-5-0-pro-260628` +- [Seedream 5.5 261028](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code): `byteplus/seedream-5-5-261028` - [Crystal Upscaler](/ko/development/comfy-router/models/fal/crystal-upscaler/code): `fal/crystal-upscaler` - [Patina](/ko/development/comfy-router/models/fal/patina/code): `fal/patina` - [AI Image Upscaler Precision V2](/ko/development/comfy-router/models/freepik/ai-image-upscaler-precision-v2/code): `freepik/ai-image-upscaler-precision-v2` @@ -214,8 +214,7 @@ translationBlockHashes: - [Qwen Image 3.0](/ko/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/ko/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` - [Recraft V3](/ko/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` -- [Recraft V4.1 Pro](/ko/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` +- [Recraft V4.1 Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector`- [Recraft V4.1 Pro](/ko/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/ko/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code): `recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code): `recraft/recraftv4_1_utility_vector` @@ -266,8 +265,7 @@ translationBlockHashes: - [FLUX 3 Video](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` -- [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128`- [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/ko/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/ko/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` @@ -324,8 +322,7 @@ translationBlockHashes: - [Stable Fast 3D](/ko/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ko/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` - [Hunyuan 3D Part](/ko/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/ko/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` -- [Hunyuan 3D Texture Edit](/ko/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` +- [Hunyuan 3D Smart Topology](/ko/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology`- [Hunyuan 3D Texture Edit](/ko/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/ko/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` @@ -468,6 +465,7 @@ translationBlockHashes: | [Seedream 5.0 260128](/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | 텍스트, 이미지 | 이미지 | | [Seedream 5.0 Flash 260915](/ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code) | `byteplus/seedream-5-0-flash-260915` | 텍스트, 이미지 | 이미지 | | [Seedream 5.0 Pro 260628](/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 텍스트, 이미지 | 이미지 | +| [Seedream 5.5 261028](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 텍스트, 이미지 | 이미지 | ## Elevenlabs diff --git a/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index 1dab51fef8..edf562a0e2 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -1,42 +1,43 @@ --- title: "Comfy Router에서 Seedream 4.0 250828 사용하기" -description: "Comfy Router를 통해 byteplus/seedream-4-0-250828을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답입니다." +description: "Comfy Router를 통해 byteplus/seedream-4-0-250828을 호출합니다. 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedream 4.0 250828" -translationSourceHash: a0e25650 +translationSourceHash: e47962e3 translationFrom: development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx translationBlockHashes: - "_intro": 3d37b29e - "Quick start": 38e0a75b - "Schema": b45c3a02 - "Examples": ac35d592 + "_intro": 1d32bb5d + "Quick start": 5ffebfad + "Schema": d11a7253 + "Examples": 7bc7fa59 --- -{/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/byteplus/seedream-4-0-250828.json에서 생성했습니다. */} + +{/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/byteplus/seedream-4-0-250828.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; -Comfy Router가 BytePlus에서 제공하는 `byteplus/seedream-4-0-250828`에 대한 API 레퍼런스입니다. +`byteplus/seedream-4-0-250828`에 대한 API 레퍼런스이며, Comfy Router가 BytePlus에서 제공합니다. **입력:** 텍스트, 이미지 · **출력:** 이미지 ## 빠른 시작 -[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다. +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 raw HTTP로 수행합니다. **모델 ID:** `byteplus/seedream-4-0-250828` **엔드포인트:** `POST https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828` - + ```python Python from comfy_sdk import Comfy # 환경에서 COMFY_API_KEY를 읽습니다. -# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도를 위해 재사용합니다. +# SDK는 자동으로 idempotency 키를 생성하고 자동 재시도에 재사용합니다. with Comfy() as client: result = client.models.run( "byteplus/seedream-4-0-250828", @@ -54,7 +55,7 @@ print(result) import { comfy } from "@comfyorg/sdk"; // 환경에서 COMFY_API_KEY를 읽습니다. -// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도를 위해 재사용합니다. +// SDK는 자동으로 idempotency 키를 생성하고 자동 재시도에 재사용합니다. const { data } = await comfy.models.run("byteplus/seedream-4-0-250828", { prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", response_format: "url", @@ -73,8 +74,8 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828 \ ``` - -동일한 본문을 `POST https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests` 로 보냅니다. Router는 실행이 접수되는 즉시 `201` 과 `request_id` 를 응답하며, 결과는 준비가 되면 이 프로세스나 다른 프로세스에서 수집합니다. 상태, 취소, 수집 방법은 [큐 전송](/ko/development/comfy-router/queue) 에서 살펴봅니다. + +동일한 본문을 `POST https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests`로 보냅니다. 실행이 접수되는 즉시 Router가 `request_id`와 함께 `201`을 응답하고, 결과는 준비되는 대로 이 프로세스나 다른 프로세스에서 수집합니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 자세히 다룹니다. ```python Python @@ -82,7 +83,7 @@ import asyncio from comfy_sdk import AsyncComfy # 환경에서 COMFY_API_KEY를 읽습니다. -# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도를 위해 재사용합니다. +# 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. async def main(): async with AsyncComfy() as client: handle = await client.models.submit( @@ -93,13 +94,13 @@ async def main(): "watermark": False, }, ) - print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + print("request_id:", handle.request_id) # 모델 ID와 함께면 다른 프로세스에 필요한 전부입니다 - # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After 만큼 대기합니다. + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. async for update in handle.iter_events(): print(update.status, update.queue_position) - # 공급자 자체의 페이로드이며, models.run() 이 반환하는 것과 같은 값입니다. + # 공급자의 자체 페이로드이며, models.run()이 반환하는 값과 동일합니다. # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. result = await handle.get() @@ -112,39 +113,39 @@ asyncio.run(main()) import { comfy } from "@comfyorg/sdk"; // 환경에서 COMFY_API_KEY를 읽습니다. -// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도를 위해 재사용합니다. +// 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. const handle = await comfy.models.submit("byteplus/seedream-4-0-250828", { prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", response_format: "url", watermark: false, }); -console.log("requestId:", handle.requestId); // 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 +console.log("requestId:", handle.requestId); // 모델 ID와 함께면 다른 프로세스에 필요한 전부입니다 -// 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After 만큼 대기합니다. +// 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. for await (const update of handle.events()) { console.log(update.status, update.queuePosition); } -// models.run() 이 반환하는 것과 같은 결과입니다. 실패했거나 취소된 요청은 여기에서 거부됩니다. +// models.run()이 반환하는 것과 동일한 결과입니다. 실패했거나 취소된 요청은 여기에서 거부됩니다. const result = await handle.get(); console.log(result.data); ``` ```bash cURL -# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url 과 함께 201 을 응답합니다. +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201을 응답합니다. curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" -# 2. 상태가 COMPLETED 가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. REQUEST_ID="" curl -i https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" -# 3. 수집합니다. 모델의 네이티브 출력과 함께 200, 아직 실행 중일 때는 상태 본문과 함께 202 를 반환합니다. +# 3. 수집합니다. 완료되면 모델의 네이티브 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202를 반환합니다. curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``` @@ -156,8 +157,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQU ### 입력 + + 생성된 이미지에 투명한 배경(알파 채널)이 있는지 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 자체 스키마에 이 매개변수가 문서화된 최신 Seedream 모델에서 지원됩니다. +auto: 모델이 프롬프트와 output_format을 기반으로 결정합니다. output_format이 jpeg인 경우 출력은 항상 불투명합니다. +transparent: 투명한 배경의 RGBA 이미지를 출력합니다. output_format이 jpeg이면 오류가 반환됩니다. +opaque: 불투명한 배경의 RGB 이미지를 출력합니다. seedream-5.0-pro의 기본값입니다. +seedream-5.0-pro는 알파 채널이 있는 png 입력 이미지 1개를 사용하는 이미지 기반 이미지 생성에서만 투명 출력을 지원합니다. +레이어 분리 시나리오에서는 지원되지 않습니다. layer_decomposition을 활성화한 상태로 전달하면 오류가 반환됩니다. + + 가능한 값: `auto`, `transparent`, `opaque` + + - 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지 제어합니다. 범위 [1, 10]. 값이 높을수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5, 4.0에서는 지원되지 않습니다. + 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지를 제어합니다. 범위 [1, 10]. 값이 높을수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0에서는 지원되지 않습니다. 범위: `1` ~ `10` @@ -165,9 +177,9 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQU - Seedream-5.0-pro, 5.0-lite, 4.5, 4.0이 이 매개변수를 지원합니다. + Seedream-5.0-pro, 5.0-lite, 4.5 및 4.0이 이 매개변수를 지원합니다. -편집할 이미지의 Base64 인코딩 또는 접근 가능한 URL을 입력합니다. Seedream-5.0-pro, 5.0-lite, 4.5, 4.0은 단일 이미지 또는 여러 이미지 입력을 지원합니다(멀티 이미지 블렌딩 예시 참조). +편집할 이미지의 Base64 인코딩 또는 접근 가능한 URL을 입력하세요. Seedream-5.0-pro, 5.0-lite, 4.5 및 4.0은 단일 이미지 또는 여러 이미지 입력을 지원합니다(다중 이미지 블렌딩 예제 참조). • 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. • Base64 인코딩: 형식은 data:image/\;base64,\이어야 합니다. 참고: \은 소문자여야 합니다(예: data:image/png;base64,\). @@ -175,29 +187,39 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQU Comfy Router는 base64 확장과 모든 참조 이미지를 포함하여 전체 JSON 요청을 100 MiB로 제한합니다. 이 전송 한도를 초과하는 입력에는 URL을 사용하세요. 입력 이미지는 다음 요구 사항을 충족해야 합니다: -• 이미지 형식: jpeg, png (seedream-5.0-pro, 5.0-lite, 4.5, 4.0은 webp, bmp, tiff, gif도 지원하며, seedream-5.0-pro는 heic와 heif도 지원합니다) -• 가로세로 비율(너비/높이): seedream-5.0-pro, 5.0-lite, 4.5, 4.0의 경우 [1/16, 16] 범위 +• 이미지 형식: jpeg, png (seedream-5.0-pro, 5.0-lite, 4.5 및 4.0은 webp, bmp, tiff, gif도 지원하며, seedream-5.0-pro는 heic와 heif도 지원합니다) +• 가로세로 비율(너비/높이): seedream-5.0-pro, 5.0-lite, 4.5 및 4.0의 경우 [1/16, 16] 범위 • 너비와 높이(px): > 14 -• 크기: 10 MB 이하 (seedream-5.0-pro는 30 MB) -• 총 픽셀: seedream-5.0-pro의 경우 6000x6000(36,000,000 px) 이하 -• 참조 이미지 최대 14개 (seedream-5.0-pro와 5.0-flash는 10개) +• 크기: 최대 10 MB (seedream-5.0-pro는 30 MB) +• 총 픽셀: seedream-5.0-pro의 경우 최대 6000x6000(36,000,000 px) +• 최대 14개의 참조 이미지 (seedream-5.0-pro, 5.0-flash 및 5.5는 10개) -레이어 분리 시나리오(layer_decomposition 활성화)에서는 image가 필수이며 단일 입력 이미지만 지원됩니다(여러 이미지를 전달하면 오류가 반환됩니다). 입력 이미지는 png, jpeg, webp, bmp, tiff 또는 gif여야 하며(heic와 heif는 지원되지 않음), 최대 30 MB이고 총 픽셀은 [512x512, 6000x6000] 범위, 가로세로 비율은 [1/16, 16] 범위여야 합니다. +레이어 분리 시나리오(layer_decomposition 활성화)에서는 image가 필수이며 단일 입력 이미지만 지원합니다(여러 이미지를 전달하면 오류가 반환됩니다). 입력 이미지는 png, jpeg, webp, bmp, tiff 또는 gif여야 하며(heic와 heif는 지원되지 않음), 최대 30 MB이고 총 픽셀은 [512x512, 6000x6000] 범위, 가로세로 비율은 [1/16, 16] 범위여야 합니다. - 레이어 분리 사용 여부를 제어합니다. seedream-5.0-pro와 5.0-flash만 이 매개변수를 지원합니다. -true: 레이어 분리 모드입니다. 모델은 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개)로 분해하고, 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다. 여기에는 적층 순서(z_index), 바운딩 박스(bounding_box), 이름(name), 설명(description)이 포함됩니다. -false: 표준 이미지 생성 모드이며, 레이어 분리가 수행되지 않습니다. -레이어 분리 모드 참고 사항: 단일 입력 이미지만 지원됩니다(여러 이미지를 전달하면 오류가 반환됨). 단일 레이어라도 생성에 실패하면 전체 요청이 실패하며, 부분 성공은 지원되지 않습니다. 반환되는 이미지는 최대 17개(기본 이미지 1개 + 레이어 16개)입니다. sequential_image_generation, sequential_image_generation_options, tools, stream을 전달하면 오류가 반환됩니다. + 레이어 분리 사용 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 5.5만 이 매개변수를 지원합니다. +true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개, seedream-5.5에서는 최대 99개)로 분해하고, 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다. 여기에는 적층 순서(z_index), 바운딩 박스(bounding_box), 이름(name) 및 설명(description)이 포함됩니다. +false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않습니다. +레이어 분리 모드 참고 사항: 단일 입력 이미지만 지원합니다(여러 이미지를 전달하면 오류가 반환됩니다). 개별 레이어 하나라도 생성에 실패하면 전체 요청이 실패하며, 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). seedream-5.5는 최대 layer_decomposition_options.max_images개의 이미지를 반환합니다(기본 이미지 1개 + 최대 99개 레이어). sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류가 반환됩니다. + + + + 레이어 분리 모드의 옵션입니다. seedream-5.5만 이 매개변수를 지원하며, layer_decomposition이 true일 때만 적용됩니다. + + + + 이 요청이 반환하는 최대 총 이미지 수이며, 기본 이미지와 레이어를 합한 값입니다. 범위: [2, 100]. 프롬프트에서 이미지를 분할하는 방법을 지정하지 않은 경우, 모델은 max_images와 입력 이미지의 복잡도를 기반으로 레이어를 계획합니다. 값이 클수록 일반적으로 더 세밀한 레이어가 생성됩니다. + + 범위: `2` ~ `100` - 모델 식별자입니다. 지원되는 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 값을 생략한 경우 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. + 모델 식별자입니다. 지원되는 모델: seedream-4-0-250828, seedream-4-0-250828, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 및 seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. - 프롬프트 최적화 기능에 대한 구성입니다. seedream-5.0-pro/5.0-lite/4.5(표준 모드만 지원)와 seedream-4.0만 이 매개변수를 지원합니다. + 프롬프트 최적화 기능에 대한 구성입니다. seedream-5.0-pro/5.0-lite/4.5/5.5(표준 모드만 지원하며 seedream-5.5는 fast 사용 시 오류를 반환합니다)와 seedream-4.0만 이 매개변수를 지원합니다. @@ -207,39 +229,40 @@ false: 표준 이미지 생성 모드이며, 레이어 분리가 수행되지 - 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash와 5.0-lite만 이 매개변수를 지원합니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. + 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 매개변수를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. + 가능한 값: `png`, `jpeg` 이미지 생성 또는 변환을 위한 텍스트 설명입니다. -레이어 분리 시나리오(layer_decomposition이 활성화된 seedream-5.0-pro 또는 5.0-flash)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. +레이어 분리 시나리오(seedream-5.0-pro, 5.0-flash 또는 5.5에서 layer_decomposition이 활성화된 경우)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. - 응답으로 반환되는 생성 이미지의 형식을 지정합니다 + 응답으로 반환되는 생성된 이미지의 형식을 지정합니다. 가능한 값: `url`, `b64_json` - 이미지 생성의 무작위성을 제어하는 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하세요. + 이미지 생성의 무작위성을 제어하는 무작위 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하세요. 범위: `-1` ~ `2147483647` - 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro와 5.0-flash는 지원하지 않음). 유효한 값: + 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). 유효한 값: auto: 자동 모드에서는 모델이 사용자의 프롬프트를 기반으로 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. -disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이미지만 생성합니다. +disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지를 하나만 생성합니다. 가능한 값: `auto`, `disabled` - seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다(seedream-5.0-pro 또는 5.0-flash에서는 지원되지 않음). -배치 이미지 생성 기능에 대한 설정입니다. 이 매개변수는 sequential_image_generation이 auto로 설정된 경우에만 적용됩니다. + seedream-5.0-lite, 4.5, 4.0에서만 이 파라미터를 지원합니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). +배치 이미지 생성 기능에 대한 구성입니다. 이 파라미터는 sequential_image_generation이 auto로 설정된 경우에만 유효합니다. @@ -251,93 +274,100 @@ disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이 "seedream-4-0-250828": 생성된 이미지의 사양을 설정합니다. 두 가지 방법을 사용할 수 있지만 함께 사용할 수는 없습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 2K, 4K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [1024x1024, 4096x4096], 종횡비: [1/16, 16] -"seedream-4-5-251128": 두 가지 방법을 사용할 수 있습니다. + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [1024x1024, 4096x4096], 가로세로 비율: [1/16, 16] +"seedream-4-0-250828": 두 가지 방법을 사용할 수 있습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 4K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, 4096x4096], 종횡비: [1/16, 16] + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, 4096x4096], 가로세로 비율: [1/16, 16] "seedream-5-0-260128": 두 가지 방법을 사용할 수 있습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 3K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 종횡비: [1/16, 16] + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 가로세로 비율: [1/16, 16] "seedream-5-0-pro-260628": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 종횡비, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 2K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 종횡비: [1/16, 16] + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 가로세로 비율: [1/16, 16] "seedream-5-0-flash-260915": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 종횡비, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 종횡비: [1/16, 16] -layer_decomposition이 활성화된 "seedream-5-0-pro-260628" 및 "seedream-5-0-flash-260915": 해상도 수준 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. - 베이스 이미지는 원본 입력 이미지의 종횡비로 지정된 해상도에서 출력되고, 각 레이어는 원본 이미지에서 가졌던 종횡비를 유지하면서 지정된 해상도에 가깝게 출력됩니다. - auto: 입력 이미지의 크기와 종횡비를 기준으로 출력합니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로 출력되며, 2K보다 큰 입력은 2K로 출력됩니다. + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-5-261028": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915", "seedream-5-5-261028"에서 layer_decomposition이 활성화된 경우: 해상도 수준의 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. + 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력됩니다. 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. + auto: 입력 이미지의 크기와 가로세로 비율을 기준으로 출력됩니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로 출력되며, 2K보다 큰 입력은 2K로 출력됩니다. - Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 고정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다(seedream-5.0-pro 또는 5.0-flash에서는 지원되지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후 반환됩니다. + Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 확정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후 즉시 반환됩니다. 생성된 이미지에 워터마크를 추가할지 여부를 지정합니다. false = 워터마크 없음, true = 'AI generated' 라벨이 있는 워터마크 추가 -Router가 `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 요청이 공급자에게 도달하기 전에 호출을 검증할 때 사용하는 문서와 동일합니다. +Router가 `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에게 도달하기 이전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. ### 출력 - 요청이 생성된 시간을 나타내는 Unix 타임스탬프(초 단위) + 요청이 생성된 시각을 나타내는 Unix 타임스탬프(초 단위)입니다. - 생성된 이미지에 대한 정보를 포함합니다. -레이어 분리 시나리오에서는 배열의 첫 번째 요소가 기본 이미지(z_index=0)이고, 그 뒤의 요소들은 z_index가 증가하는 순서로 정렬된 레이어입니다. + 생성된 이미지에 대한 정보를 담고 있습니다. +레이어 분리 시나리오에서는 배열의 첫 번째 요소가 베이스 이미지(z_index=0)이고, 이후 요소들은 z_index가 증가하는 순서로 정렬된 레이어입니다. - Base64로 인코딩된 이미지 데이터 (response_format이 "b64_json"인 경우) + Base64로 인코딩된 이미지 데이터입니다(response_format이 "b64_json"인 경우). + + + + 이미지가 실제로 가지는 배경 유형으로, transparent 또는 opaque입니다. 레이어 분리 시나리오에서 베이스 이미지는 항상 opaque이고 모든 레이어는 transparent입니다. seedream-5.5만 이 필드를 반환합니다. - 현재 레이어가 기본 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 이 필드는 레이어만 반환하며, 기본 이미지는 전체 캔버스를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 레이어가 베이스 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 레이어만 이 필드를 반환하며, 베이스 이미지는 전체 캔버스를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 레이어 바운딩 박스의 절대 픽셀 좌표로, 좌측 상단 모서리를 (0, 0)으로 하는 출력 기본 이미지의 좌표계를 사용합니다. 좌표 형식: [left, top, right, bottom]. + 레이어 바운딩 박스의 절대 픽셀 좌표로, 좌측 상단 모서리를 (0, 0)으로 하는 출력 베이스 이미지의 좌표계를 기준으로 합니다. 좌표 형식: [left, top, right, bottom]. - 레이어 바운딩 박스의 천분율(per-mille) 양자화(정규화) 좌표로, 기본 이미지 크기를 기준으로 [0, 1000]의 이산 정수 범위에 비례적으로 매핑되며 최대 1000에서 잘립니다. 좌표 형식: [left, top, right, bottom]. + 레이어 바운딩 박스의 천분율로 양자화된(정규화된) 좌표로, 베이스 이미지 크기를 기준으로 [0, 1000]의 이산 정수 범위에 비례적으로 매핑되며 최대 1000에서 잘립니다. 좌표 형식: [left, top, right, bottom]. - 현재 분리된 요소에 대한 상세 설명으로, name보다 풍부한 레이어 특성(색상, 상태, 재질 등)을 제공합니다. 이 필드는 레이어만 반환하며, 기본 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 분리된 요소에 대한 상세 설명으로, name보다 풍부한 레이어 특성(예: 색상, 상태, 재질)을 제공합니다. 레이어만 이 필드를 반환하며, 베이스 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 현재 분리된 요소의 이름/레이블로, 분리된 대상의 특성으로부터 모델이 자동으로 생성합니다. 이 필드는 레이어만 반환하며, 기본 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 분리된 요소의 이름/레이블로, 분리된 대상의 특성을 바탕으로 모델이 자동 생성합니다. 레이어만 이 필드를 반환하며, 베이스 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 출력 이미지의 파일 형식입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 출력 이미지의 파일 형식입니다. seedream-5.0-pro와 5.5만 이 필드를 지원합니다. - 이미지의 너비와 높이(픽셀)로, \x\ 형식입니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0만 이 파라미터를 지원합니다. + 이미지의 너비와 높이(픽셀)로, 형식은 \x\입니다. seedream-5.0-pro, 5.0-lite, 5.5, 4.5, 4.0만 이 파라미터를 지원합니다. - 이미지 다운로드 URL (response_format이 "url"인 경우) + 이미지 다운로드용 URL입니다(response_format이 "url"인 경우). 형식: `uri` - 레이어의 적층 순서로, 아래에서 위로 갈수록 증가합니다. 0은 가장 아래 레이어(기본 이미지)이며, 값이 클수록 위에 놓입니다. 이를 사용해 레이어를 올바른 적층 순서로 재구성하여 완전한 이미지로 만들 수 있습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 레이어의 적층 순서로, 아래에서 위로 갈수록 증가합니다. 0은 가장 아래의 레이어(베이스 이미지)이며, 값이 클수록 위에 놓입니다. 올바른 적층 순서로 레이어를 다시 합쳐 완전한 이미지를 만들 때 사용합니다. layer_decomposition이 true인 경우에만 반환됩니다. - 오류 정보 (있는 경우) + 오류 정보(있는 경우) - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake와 같이 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아니라 개방형 문자열입니다: 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 재정의하지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이 값은 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답 본문과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -345,7 +375,7 @@ Router가 `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json`에서 제 - 요청에 사용된 모델 ID + 요청에 사용된 모델 ID입니다. @@ -353,11 +383,11 @@ Router가 `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json`에서 제 - 모델이 생성한 이미지 수 + 모델이 생성한 이미지 수입니다. - 모델에 입력된 이미지 수입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 모델에 입력된 이미지 수입니다. seedream-5.0-pro와 5.5만 이 필드를 지원합니다. diff --git a/ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx index cd43cea955..a3d0ae4d11 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router에서 Seedream 4.5 251128 사용하기" description: "Comfy Router를 통해 byteplus/seedream-4-5-251128을 호출합니다. 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedream 4.5 251128" -translationSourceHash: af20f4b5 +translationSourceHash: e47962e3 translationFrom: development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx translationBlockHashes: "_intro": 1d32bb5d "Quick start": 5ffebfad - "Schema": 23ff89f5 + "Schema": d11a7253 "Examples": 7bc7fa59 --- + {/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/byteplus/seedream-4-5-251128.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -156,8 +157,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-5-251128/requests/$REQU ### 입력 + + 생성된 이미지에 투명한 배경(알파 채널)이 있는지 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 자체 스키마에 이 매개변수가 문서화된 최신 Seedream 모델에서 지원됩니다. +auto: 모델이 프롬프트와 output_format을 기반으로 결정합니다. output_format이 jpeg인 경우 출력은 항상 불투명합니다. +transparent: 투명한 배경의 RGBA 이미지를 출력합니다. output_format이 jpeg이면 오류가 반환됩니다. +opaque: 불투명한 배경의 RGB 이미지를 출력합니다. seedream-5.0-pro의 기본값입니다. +seedream-5.0-pro는 알파 채널이 있는 png 입력 이미지 1개를 사용하는 이미지 기반 이미지 생성에서만 투명 출력을 지원합니다. +레이어 분리 시나리오에서는 지원되지 않습니다. layer_decomposition을 활성화한 상태로 전달하면 오류가 반환됩니다. + + 가능한 값: `auto`, `transparent`, `opaque` + + - 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지를 제어합니다. 범위 [1, 10]. 값이 높을수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5, 4.0에서는 지원되지 않습니다. + 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지를 제어합니다. 범위 [1, 10]. 값이 높을수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0에서는 지원되지 않습니다. 범위: `1` ~ `10` @@ -167,7 +179,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-5-251128/requests/$REQU Seedream-5.0-pro, 5.0-lite, 4.5 및 4.0이 이 매개변수를 지원합니다. -편집할 이미지의 Base64 인코딩 또는 접근 가능한 URL을 입력하세요. Seedream-5.0-pro, 5.0-lite, 4.5, 4.0은 단일 이미지 또는 여러 이미지 입력을 지원합니다(다중 이미지 블렌딩 예제 참조). +편집할 이미지의 Base64 인코딩 또는 접근 가능한 URL을 입력하세요. Seedream-5.0-pro, 5.0-lite, 4.5 및 4.0은 단일 이미지 또는 여러 이미지 입력을 지원합니다(다중 이미지 블렌딩 예제 참조). • 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. • Base64 인코딩: 형식은 data:image/\;base64,\이어야 합니다. 참고: \은 소문자여야 합니다(예: data:image/png;base64,\). @@ -175,29 +187,39 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-5-251128/requests/$REQU Comfy Router는 base64 확장과 모든 참조 이미지를 포함하여 전체 JSON 요청을 100 MiB로 제한합니다. 이 전송 한도를 초과하는 입력에는 URL을 사용하세요. 입력 이미지는 다음 요구 사항을 충족해야 합니다: -• 이미지 형식: jpeg, png (seedream-5.0-pro, 5.0-lite, 4.5, 4.0은 webp, bmp, tiff, gif도 지원하며, seedream-5.0-pro는 heic와 heif도 지원합니다) -• 가로세로 비율(너비/높이): seedream-5.0-pro, 5.0-lite, 4.5, 4.0은 [1/16, 16] 범위 -• 너비와 높이(px): 14 초과 -• 크기: 10 MB 이하 (seedream-5.0-pro는 30 MB) -• 총 픽셀: seedream-5.0-pro의 경우 6000x6000(36,000,000 px) 이하 -• 최대 14개의 참조 이미지 (seedream-5.0-pro와 5.0-flash는 10개) +• 이미지 형식: jpeg, png (seedream-5.0-pro, 5.0-lite, 4.5 및 4.0은 webp, bmp, tiff, gif도 지원하며, seedream-5.0-pro는 heic와 heif도 지원합니다) +• 가로세로 비율(너비/높이): seedream-5.0-pro, 5.0-lite, 4.5 및 4.0의 경우 [1/16, 16] 범위 +• 너비와 높이(px): > 14 +• 크기: 최대 10 MB (seedream-5.0-pro는 30 MB) +• 총 픽셀: seedream-5.0-pro의 경우 최대 6000x6000(36,000,000 px) +• 최대 14개의 참조 이미지 (seedream-5.0-pro, 5.0-flash 및 5.5는 10개) 레이어 분리 시나리오(layer_decomposition 활성화)에서는 image가 필수이며 단일 입력 이미지만 지원합니다(여러 이미지를 전달하면 오류가 반환됩니다). 입력 이미지는 png, jpeg, webp, bmp, tiff 또는 gif여야 하며(heic와 heif는 지원되지 않음), 최대 30 MB이고 총 픽셀은 [512x512, 6000x6000] 범위, 가로세로 비율은 [1/16, 16] 범위여야 합니다. - 레이어 분리 사용 여부를 제어합니다. 이 매개변수는 seedream-5.0-pro와 5.0-flash만 지원합니다. -true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개)로 분해하고, 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다. 여기에는 적층 순서(z_index), 바운딩 박스(bounding_box), 이름(name), 설명(description)이 포함됩니다. + 레이어 분리 사용 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 5.5만 이 매개변수를 지원합니다. +true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개, seedream-5.5에서는 최대 99개)로 분해하고, 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다. 여기에는 적층 순서(z_index), 바운딩 박스(bounding_box), 이름(name) 및 설명(description)이 포함됩니다. false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않습니다. -레이어 분리 모드 참고 사항: 단일 입력 이미지만 지원합니다(여러 이미지를 전달하면 오류가 반환됩니다). 개별 레이어 하나라도 생성에 실패하면 전체 요청이 실패하며, 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류가 반환됩니다. +레이어 분리 모드 참고 사항: 단일 입력 이미지만 지원합니다(여러 이미지를 전달하면 오류가 반환됩니다). 개별 레이어 하나라도 생성에 실패하면 전체 요청이 실패하며, 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). seedream-5.5는 최대 layer_decomposition_options.max_images개의 이미지를 반환합니다(기본 이미지 1개 + 최대 99개 레이어). sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류가 반환됩니다. + + + + 레이어 분리 모드의 옵션입니다. seedream-5.5만 이 매개변수를 지원하며, layer_decomposition이 true일 때만 적용됩니다. + + + + 이 요청이 반환하는 최대 총 이미지 수이며, 기본 이미지와 레이어를 합한 값입니다. 범위: [2, 100]. 프롬프트에서 이미지를 분할하는 방법을 지정하지 않은 경우, 모델은 max_images와 입력 이미지의 복잡도를 기반으로 레이어를 계획합니다. 값이 클수록 일반적으로 더 세밀한 레이어가 생성됩니다. + + 범위: `2` ~ `100` - 모델 식별자입니다. 지원되는 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 및 seedream-5-0-flash-260915. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. + 모델 식별자입니다. 지원되는 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 및 seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. - 프롬프트 최적화 기능에 대한 구성입니다. seedream-5.0-pro/5.0-lite/4.5(표준 모드만 지원)와 seedream-4.0만 이 매개변수를 지원합니다. + 프롬프트 최적화 기능에 대한 구성입니다. seedream-5.0-pro/5.0-lite/4.5/5.5(표준 모드만 지원하며 seedream-5.5는 fast 사용 시 오류를 반환합니다)와 seedream-4.0만 이 매개변수를 지원합니다. @@ -207,43 +229,44 @@ false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않 - 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite만 이 매개변수를 지원합니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. + 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 매개변수를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. + 가능한 값: `png`, `jpeg` 이미지 생성 또는 변환을 위한 텍스트 설명입니다. -레이어 분리 시나리오(seedream-5.0-pro 또는 5.0-flash에서 layer_decomposition 활성화)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. +레이어 분리 시나리오(seedream-5.0-pro, 5.0-flash 또는 5.5에서 layer_decomposition이 활성화된 경우)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. - 응답으로 반환되는 생성된 이미지의 형식을 지정합니다 + 응답으로 반환되는 생성된 이미지의 형식을 지정합니다. 가능한 값: `url`, `b64_json` - 이미지 생성의 무작위성을 제어하는 난수 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하세요. + 이미지 생성의 무작위성을 제어하는 무작위 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하세요. 범위: `-1` ~ `2147483647` - 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro 또는 5.0-flash는 지원하지 않음). 유효한 값: -auto: 자동 모드에서는 사용자의 프롬프트에 따라 여러 이미지를 반환할지 여부와 포함될 이미지 수를 모델이 자동으로 결정합니다. -disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이미지만 생성합니다. + 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). 유효한 값: +auto: 자동 모드에서는 모델이 사용자의 프롬프트를 기반으로 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. +disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지를 하나만 생성합니다. 가능한 값: `auto`, `disabled` - 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro 또는 5.0-flash에서는 지원되지 않습니다). -배치 이미지 생성 기능에 대한 구성입니다. 이 파라미터는 sequential_image_generation이 auto로 설정된 경우에만 적용됩니다. + seedream-5.0-lite, 4.5, 4.0에서만 이 파라미터를 지원합니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). +배치 이미지 생성 기능에 대한 구성입니다. 이 파라미터는 sequential_image_generation이 auto로 설정된 경우에만 유효합니다. - 이 요청에서 생성할 이미지의 최대 개수를 지정합니다. 입력 참조 이미지 수 + 생성된 이미지 수 ≤ 15. + 이 요청에서 생성할 최대 이미지 수를 지정합니다. 입력 참조 이미지 수 + 생성된 이미지 수 ≤ 15. 범위: `1` ~ `15` @@ -259,18 +282,21 @@ disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 3K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 가로세로 비율: [1/16, 16] "seedream-5-0-pro-260628": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 2K + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 2K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 가로세로 비율: [1/16, 16] "seedream-5-0-flash-260915": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] -"seedream-5-0-pro-260628" 및 "seedream-5-0-flash-260915"에서 layer_decomposition을 활성화한 경우: 해상도 수준을 지정하는 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. - 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에 출력되며, 각 레이어는 원본 이미지에서 가지던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. +"seedream-5-5-261028": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915", "seedream-5-5-261028"에서 layer_decomposition이 활성화된 경우: 해상도 수준의 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. + 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력됩니다. 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. auto: 입력 이미지의 크기와 가로세로 비율을 기준으로 출력됩니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로 출력되며, 2K보다 큰 입력은 2K로 출력됩니다. - Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 확정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro 또는 5.0-flash에서는 지원되지 않습니다). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후 즉시 반환됩니다. + Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 확정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후 즉시 반환됩니다. @@ -294,6 +320,10 @@ Router가 `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json`에서 제 Base64로 인코딩된 이미지 데이터입니다(response_format이 "b64_json"인 경우). + + 이미지가 실제로 가지는 배경 유형으로, transparent 또는 opaque입니다. 레이어 분리 시나리오에서 베이스 이미지는 항상 opaque이고 모든 레이어는 transparent입니다. seedream-5.5만 이 필드를 반환합니다. + + 현재 레이어가 베이스 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 레이어만 이 필드를 반환하며, 베이스 이미지는 전체 캔버스를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. @@ -315,11 +345,11 @@ Router가 `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json`에서 제 - 출력 이미지의 파일 형식입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 출력 이미지의 파일 형식입니다. seedream-5.0-pro와 5.5만 이 필드를 지원합니다. - 이미지의 너비와 높이(픽셀)로, 형식은 \x\입니다. seedream-5.0-pro, 5.0-lite, 4.5, 4.0만 이 파라미터를 지원합니다. + 이미지의 너비와 높이(픽셀)로, 형식은 \x\입니다. seedream-5.0-pro, 5.0-lite, 5.5, 4.5, 4.0만 이 파라미터를 지원합니다. @@ -357,7 +387,7 @@ Router가 `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json`에서 제 - 모델에 입력된 이미지 수입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 모델에 입력된 이미지 수입니다. seedream-5.0-pro와 5.5만 이 필드를 지원합니다. diff --git a/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx index 250861e524..9c77ec8530 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx @@ -2,17 +2,19 @@ title: "Comfy Router로 Seedream 5.0 260128 사용하기" description: "Comfy Router를 통해 byteplus/seedream-5-0-260128을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Seedream 5.0 260128" -translationSourceHash: 732cb981 +translationSourceHash: 48855510 translationFrom: development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx translationBlockHashes: "_intro": 38b28b26 "Quick start": c2f3039d - "Schema": 9f3bcfd2 + "Schema": be3a6de7 "Examples": b387e011 --- + + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -156,6 +158,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-260128/requests/$REQU ### 입력 + + 생성된 이미지가 투명한 배경(알파 채널)을 갖는지 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 자체 스키마에서 이 매개변수를 문서화하는 최신 Seedream 모델에서 지원됩니다. +auto: 모델이 프롬프트와 output_format을 기반으로 결정합니다. output_format이 jpeg이면 출력은 항상 불투명합니다. +transparent: 투명한 배경의 RGBA 이미지를 출력합니다. output_format이 jpeg이면 오류가 반환됩니다. +opaque: 불투명한 배경의 RGB 이미지를 출력합니다. seedream-5.0-pro의 기본값입니다. +seedream-5.0-pro는 알파 채널이 있는 png 입력 이미지 하나를 사용하는 이미지 기반 이미지 생성에서만 투명 출력을 지원합니다. +레이어 분리 시나리오에서는 지원되지 않습니다. layer_decomposition이 활성화된 상태에서 이 값을 전달하면 오류가 반환됩니다. + + 가능한 값: `auto`, `transparent`, `opaque` + + 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지 제어합니다. 범위 [1, 10]. 값이 높을수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0에서는 지원되지 않습니다. @@ -165,9 +178,9 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-260128/requests/$REQU - Seedream-5.0-pro, 5.0-lite, 4.5, 4.0이 이 매개변수를 지원합니다. + Seedream-5.0-pro, 5.0-lite, 4.5 및 4.0이 이 매개변수를 지원합니다. -편집할 이미지의 Base64 인코딩 또는 접근 가능한 URL을 입력하세요. Seedream-5.0-pro, 5.0-lite, 4.5, 4.0은 단일 이미지 또는 여러 이미지 입력을 지원합니다(다중 이미지 블렌딩 예제 참조). +편집할 이미지의 Base64 인코딩 또는 접근 가능한 URL을 입력하세요. Seedream-5.0-pro, 5.0-lite, 4.5 및 4.0은 단일 이미지 또는 여러 이미지 입력을 지원합니다(다중 이미지 블렌딩 예제 참조). • 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. • Base64 인코딩: 형식은 data:image/\;base64,\이어야 합니다. 참고: \은 소문자여야 합니다. 예: data:image/png;base64,\. @@ -175,29 +188,39 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-260128/requests/$REQU Comfy Router는 base64 확장과 모든 참조 이미지를 포함하여 전체 JSON 요청을 100 MiB로 제한합니다. 이 전송 한도를 초과하는 입력에는 URL을 사용하세요. 입력 이미지는 다음 요구 사항을 충족해야 합니다: -• 이미지 형식: jpeg, png (seedream-5.0-pro, 5.0-lite, 4.5, 4.0은 webp, bmp, tiff, gif도 지원하며, seedream-5.0-pro는 heic와 heif도 지원합니다) -• 가로세로 비율(너비/높이): seedream-5.0-pro, 5.0-lite, 4.5, 4.0의 경우 [1/16, 16] 범위 +• 이미지 형식: jpeg, png (seedream-5.0-pro, 5.0-lite, 4.5 및 4.0은 webp, bmp, tiff, gif도 지원하며, seedream-5.0-pro는 heic와 heif도 지원합니다) +• 가로세로 비율(너비/높이): seedream-5.0-pro, 5.0-lite, 4.5 및 4.0의 경우 [1/16, 16] 범위 • 너비와 높이(px): > 14 • 크기: 10 MB 이하 (seedream-5.0-pro의 경우 30 MB) • 총 픽셀: seedream-5.0-pro의 경우 6000x6000 (36,000,000 px) 이하 -• 참조 이미지 최대 14개 (seedream-5.0-pro 및 5.0-flash의 경우 10개) +• 참조 이미지 최대 14개 (seedream-5.0-pro, 5.0-flash 및 5.5의 경우 10개) 레이어 분리 시나리오(layer_decomposition 활성화)에서는 image가 필수이며 단일 입력 이미지만 지원됩니다(여러 이미지를 전달하면 오류가 반환됩니다). 입력 이미지는 png, jpeg, webp, bmp, tiff 또는 gif여야 하며(heic와 heif는 지원되지 않음), 최대 30 MB이고 총 픽셀이 [512x512, 6000x6000] 범위, 가로세로 비율이 [1/16, 16] 범위여야 합니다. - 레이어 분리 활성화 여부를 제어합니다. seedream-5.0-pro와 5.0-flash만 이 매개변수를 지원합니다. -true: 레이어 분리 모드입니다. 모델은 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개)로 분해하고, 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다. 여기에는 쌓이는 순서(z_index), 바운딩 박스(bounding_box), 이름(name), 설명(description)이 포함됩니다. + 레이어 분리 활성화 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 5.5만 이 매개변수를 지원합니다. +true: 레이어 분리 모드입니다. 모델은 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개, seedream-5.5에서는 최대 99개)로 분해하고, 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다. 여기에는 쌓이는 순서(z_index), 바운딩 박스(bounding_box), 이름(name) 및 설명(description)이 포함됩니다. false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않습니다. -레이어 분리 모드 참고 사항: 단일 입력 이미지만 지원합니다(여러 이미지를 전달하면 오류가 반환됩니다). 단일 레이어라도 생성에 실패하면 전체 요청이 실패합니다. 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). sequential_image_generation, sequential_image_generation_options, tools, stream을 전달하면 오류가 반환됩니다. +레이어 분리 모드 참고 사항: 단일 입력 이미지만 지원합니다(여러 이미지를 전달하면 오류가 반환됩니다). 단일 레이어라도 생성에 실패하면 전체 요청이 실패하며, 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). seedream-5.5는 최대 layer_decomposition_options.max_images개의 이미지를 반환합니다(기본 이미지 1개 + 최대 99개 레이어). sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류가 반환됩니다. + + + + 레이어 분리 모드의 옵션입니다. seedream-5.5만 이 매개변수를 지원하며, layer_decomposition이 true일 때만 적용됩니다. + + + + 이 요청이 반환하는 최대 총 이미지 수입니다. 기본 이미지와 레이어를 합한 값입니다. 범위: [2, 100]. 프롬프트에서 이미지를 분할하는 방법을 명시하지 않은 경우, 모델은 max_images와 입력 이미지의 복잡도를 기반으로 레이어를 계획합니다. 일반적으로 값이 클수록 더 세밀한 레이어가 생성됩니다. + + 범위: `2` ~ `100` - 모델 식별자입니다. 지원되는 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 및 seedream-5-0-flash-260915. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. + 모델 식별자입니다. 지원되는 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 및 seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값과 누락된 값 모두를 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. - 프롬프트 최적화 기능에 대한 구성입니다. seedream-5.0-pro/5.0-lite/4.5(standard 모드만 지원)와 seedream-4.0만 이 매개변수를 지원합니다. + 프롬프트 최적화 기능에 대한 구성입니다. seedream-5.0-pro/5.0-lite/4.5/5.5(standard 모드만 지원하며, seedream-5.5는 fast에 대해 오류를 반환합니다)와 seedream-4.0만 이 매개변수를 지원합니다. @@ -207,18 +230,16 @@ false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않 - 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash 및 5.0-lite만 이 매개변수를 지원합니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. - - 가능한 값: `png`, `jpeg` + 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 매개변수를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. 가능한 값: `png`, `jpeg` 이미지 생성 또는 변환을 위한 텍스트 설명입니다. -레이어 분리 시나리오(layer_decomposition이 활성화된 seedream-5.0-pro 또는 5.0-flash)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. +레이어 분리 시나리오(seedream-5.0-pro, 5.0-flash 또는 5.5에서 layer_decomposition이 활성화된 경우)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. - 응답으로 반환되는 생성 이미지의 형식을 지정합니다 + 응답에서 반환되는 생성 이미지의 형식을 지정합니다. 가능한 값: `url`, `b64_json` @@ -226,26 +247,26 @@ false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않 이미지 생성의 무작위성을 제어하는 랜덤 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하세요. - 범위: `-1` ~ `2147483647` + 범위: `-1`~`2147483647` - 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro 또는 5.0-flash에서는 지원되지 않습니다). 유효한 값: -auto: 자동 모드에서는 모델이 사용자의 프롬프트를 기반으로 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. -disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지 하나만 생성합니다. + 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않음). 유효한 값: +auto: 자동 모드에서는 사용자의 프롬프트에 따라 모델이 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. +disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지를 하나만 생성합니다. 가능한 값: `auto`, `disabled` - seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다(seedream-5.0-pro 또는 5.0-flash는 지원하지 않음). + seedream-5.0-lite, 4.5 및 4.0에서만 이 매개변수를 지원합니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않음). 배치 이미지 생성 기능에 대한 구성입니다. 이 매개변수는 sequential_image_generation이 auto로 설정된 경우에만 적용됩니다. 이 요청에서 생성할 최대 이미지 수를 지정합니다. 입력 참조 이미지 수 + 생성된 이미지 수 ≤ 15. - 범위: `1`부터 `15`까지 + 범위: `1`~`15` @@ -259,18 +280,21 @@ disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지 하 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 3K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 가로세로 비율: [1/16, 16] "seedream-5-0-pro-260628": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 2K + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 2K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 가로세로 비율: [1/16, 16] "seedream-5-0-flash-260915": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] -layer_decomposition이 활성화된 "seedream-5-0-pro-260628" 및 "seedream-5-0-flash-260915": 해상도 수준의 방법만 지원합니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. - 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력되며, 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. +"seedream-5-5-261028": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915" 및 "seedream-5-5-261028"에서 layer_decomposition이 활성화된 경우: 해상도 수준 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. + 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력됩니다. 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. auto: 입력 이미지의 크기와 가로세로 비율을 기준으로 출력됩니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로 출력되며, 2K보다 큰 입력은 2K로 출력됩니다. - Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 확정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다(seedream-5.0-pro 또는 5.0-flash는 지원하지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 생성된 각 출력 이미지가 생성 직후 즉시 반환됩니다. + Comfy Router는 완전한 JSON 결과를 캡처하므로 명시적으로 전달된 stream 플래그를 false로 설정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. seedream-5.0-lite, 4.5 및 4.0에서만 이 매개변수를 지원합니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지는 생성된 직후 즉시 반환됩니다. @@ -294,6 +318,10 @@ Router가 `GET /v2/models/byteplus/seedream-5-0-260128/openapi.json`에서 제 Base64로 인코딩된 이미지 데이터(response_format이 "b64_json"인 경우) + + 이미지가 실제로 가지는 배경 유형으로, transparent 또는 opaque입니다. 레이어 분리 시나리오에서 기본 이미지는 항상 opaque이고 모든 레이어는 transparent입니다. seedream-5.5만 이 필드를 반환합니다. + + 현재 레이어가 기본 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 레이어만 이 필드를 반환하며, 기본 이미지는 전체 캔버스를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. @@ -315,11 +343,11 @@ Router가 `GET /v2/models/byteplus/seedream-5-0-260128/openapi.json`에서 제 - 출력 이미지의 파일 형식입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 출력 이미지의 파일 형식입니다. seedream-5.0-pro와 5.5만 이 필드를 지원합니다. - 이미지의 너비와 높이(픽셀)이며, \x\ 형식입니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0만 이 매개변수를 지원합니다. + 이미지의 너비와 높이(픽셀)이며, \x\ 형식입니다. seedream-5.0-pro, 5.0-lite, 5.5, 4.5 및 4.0만 이 매개변수를 지원합니다. @@ -357,7 +385,7 @@ Router가 `GET /v2/models/byteplus/seedream-5-0-260128/openapi.json`에서 제 - 모델에 입력된 이미지 수입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 모델에 입력된 이미지 수입니다. seedream-5.0-pro와 5.5만 이 필드를 지원합니다. diff --git a/ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx index 20776aa58b..233b766094 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router로 Seedream 5.0 Flash 260915 사용하기" description: "Comfy Router를 통해 byteplus/seedream-5-0-flash-260915를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Seedream 5.0 Flash 260915" -translationSourceHash: 7d74243a +translationSourceHash: 114a5dd9 translationFrom: development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx translationBlockHashes: "_intro": a1b4c447 "Quick start": 4f86c636 - "Schema": dab50eaf + "Schema": c220d381 "Examples": 36f49088 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/byteplus/seedream-5-0-flash-260915.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -154,8 +155,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-flash-260915/requests ### 입력 + + 생성된 이미지에 투명 배경(알파 채널)이 있는지 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 자체 스키마에 이 항목이 문서화된 최신 Seedream 모델에서 지원됩니다. +auto: 모델이 프롬프트와 output_format을 기반으로 결정합니다. output_format이 jpeg이면 출력은 항상 불투명합니다. +transparent: 투명 배경을 가진 RGBA 이미지를 출력합니다. output_format이 jpeg이면 오류를 반환합니다. +opaque: 불투명 배경의 RGB 이미지를 출력합니다. seedream-5.0-pro의 기본값입니다. +seedream-5.0-pro는 알파 채널이 있는 png 입력 이미지 하나를 사용하는 이미지 기반 이미지 생성에서만 투명 출력을 지원합니다. +레이어 분리 시나리오에서는 지원되지 않습니다: layer_decomposition을 활성화한 상태로 전달하면 오류를 반환합니다. + + 가능한 값: `auto`, `transparent`, `opaque` + + - 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지를 제어합니다. 범위 [1, 10]. 값이 높을수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5, 4.0에서는 지원되지 않습니다. + 출력 이미지가 입력 프롬프트와 얼마나 밀접하게 일치하는지 제어합니다. 범위 [1, 10]. 값이 클수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0에서는 지원되지 않습니다. 범위: `1` ~ `10` @@ -163,43 +175,53 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-flash-260915/requests - 편집할 이미지 또는 이미지들로, 접근 가능한 URL 또는 data-URI 접두사가 붙은 Base64 페이로드로 전달합니다. 참조 이미지 상한이 이 모델에서는 14가 아니라 10이라는 점을 제외하면 공유 Seedream 필드와 동일합니다. + 편집할 이미지로, 접근 가능한 URL 또는 data-URI 접두사가 붙은 Base64 페이로드입니다. 참조 이미지 상한이 이 모델에서는 14가 아닌 10이라는 점을 제외하면 공유 Seedream 필드와 동일합니다. - 레이어 분리 활성화 여부를 제어합니다. seedream-5.0-pro와 5.0-flash만 이 매개변수를 지원합니다. -true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개)로 분해하고, 생성된 각 레이어의 위치와 콘텐츠 정보를 반환합니다. 여기에는 스태킹 순서(z_index), 바운딩 박스(bounding_box), 이름(name), 설명(description)이 포함됩니다. -false: 표준 이미지 생성 모드이며 레이어 분리는 수행되지 않습니다. -레이어 분리 모드 참고 사항: 단일 입력 이미지만 지원합니다(여러 이미지를 전달하면 오류가 반환됨). 단일 레이어라도 생성에 실패하면 전체 요청이 실패하며, 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). sequential_image_generation, sequential_image_generation_options, tools, stream을 전달하면 오류가 반환됩니다. + 레이어 분리 활성화 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 5.5만 이 매개변수를 지원합니다. +true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개, seedream-5.5에서는 최대 99개)로 분해하고, 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다. 여기에는 스태킹 순서(z_index), 바운딩 박스(bounding_box), 이름(name) 및 설명(description)이 포함됩니다. +false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않습니다. +레이어 분리 모드 참고 사항: 단일 입력 이미지만 지원됩니다(여러 이미지를 전달하면 오류를 반환). 단일 레이어라도 생성에 실패하면 전체 요청이 실패하며, 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). seedream-5.5는 최대 layer_decomposition_options.max_images개의 이미지(기본 이미지 1개 + 최대 99개 레이어)를 반환합니다. sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류를 반환합니다. + + + + 레이어 분리 모드의 옵션입니다. seedream-5.5만 이 매개변수를 지원하며, layer_decomposition이 true일 때만 적용됩니다. + + + + 이 요청이 반환하는 총 이미지 수(기본 이미지와 레이어 포함)의 최댓값입니다. 범위: [2, 100]. 프롬프트에 이미지 분할 방법이 명시되지 않은 경우 모델은 max_images와 입력 이미지의 복잡도를 기반으로 레이어를 계획하며, 값이 클수록 보통 더 세밀한 레이어를 만듭니다. + + 범위: `2` ~ `100` - 모델 식별자입니다. 지원 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 생략된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 모델 식별자입니다. 지원 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 및 seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출에서는 반드시 제공해야 합니다. 프록시는 다른 값이나 누락된 값에 대해 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문에 Router 호출자는 이를 생략하기 때문입니다. - 프롬프트 최적화 기능 구성입니다. seedream-5.0-pro/5.0-lite/4.5(표준 모드만 지원)와 seedream-4.0만 이 매개변수를 지원합니다. + 프롬프트 최적화 기능의 설정입니다. seedream-5.0-pro/5.0-lite/4.5/5.5(standard 모드만 지원하며 seedream-5.5는 fast에 대해 오류를 반환)와 seedream-4.0만 이 매개변수를 지원합니다. - 프롬프트 최적화 기능의 모드를 설정합니다. standard = 더 높은 품질, 더 긴 생성 시간. fast = 더 빠르지만 품질은 평균 수준. + 프롬프트 최적화 기능의 모드를 설정합니다. standard = 더 높은 품질, 더 긴 생성 시간. fast = 더 빠르지만 평균 수준의 품질. 가능한 값: `standard`, `fast` - 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite만 이 매개변수를 지원합니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. + 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 매개변수를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. 가능한 값: `png`, `jpeg` 이미지 생성 또는 변환을 위한 텍스트 설명입니다. -레이어 분리 시나리오(seedream-5.0-pro 또는 5.0-flash에서 layer_decomposition 활성화)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. +레이어 분리 시나리오(seedream-5.0-pro, 5.0-flash 또는 layer_decomposition이 활성화된 5.5)에서는 선택 사항입니다. 프롬프트가 제공되면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트가 제공되지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. - 응답으로 반환되는 생성 이미지의 형식을 지정합니다 + 응답으로 반환되는 생성된 이미지의 형식을 지정합니다 가능한 값: `url`, `b64_json` @@ -211,96 +233,102 @@ false: 표준 이미지 생성 모드이며 레이어 분리는 수행되지 않 - 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro 또는 5.0-flash는 지원하지 않음). 유효한 값: -auto: 자동 모드에서 모델이 사용자의 프롬프트에 따라 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. + 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않음). 유효한 값:auto: 자동 모드에서는 사용자의 프롬프트를 기반으로 모델이 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지를 하나만 생성합니다. 가능한 값: `auto`, `disabled` - seedream-5.0-lite, 4.5, 4.0만 이 파라미터를 지원합니다(seedream-5.0-pro와 5.0-flash는 지원하지 않음). -배치 이미지 생성 기능에 대한 설정입니다. 이 파라미터는 sequential_image_generation이 auto로 설정된 경우에만 적용됩니다. + seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다(seedream-5.0-pro, 5.0-flash, 5.5에서는 지원되지 않음). +배치 이미지 생성 기능에 대한 설정입니다. 이 매개변수는 sequential_image_generation이 auto로 설정된 경우에만 적용됩니다. - 이 요청에서 생성할 최대 이미지 수를 지정합니다. 입력 참조 이미지 수 + 생성 이미지 수 ≤ 15. + 이 요청에서 생성할 최대 이미지 수를 지정합니다. 입력 참조 이미지 수 + 생성된 이미지 수 ≤ 15. 범위: `1` ~ `15` - "seedream-4-0-250828": 생성할 이미지의 사양을 설정합니다. 두 가지 방법을 사용할 수 있지만 함께 사용할 수는 없습니다. + "seedream-4-0-250828": 생성되는 이미지의 사양을 설정합니다. 두 가지 방법을 사용할 수 있지만 함께 사용할 수는 없습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 2K, 4K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [1024x1024, 4096x4096], 종횡비: [1/16, 16] + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [1024x1024, 4096x4096], 가로세로 비율: [1/16, 16] "seedream-4-5-251128": 두 가지 방법을 사용할 수 있습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 4K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, 4096x4096], 종횡비: [1/16, 16] + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, 4096x4096], 가로세로 비율: [1/16, 16] "seedream-5-0-260128": 두 가지 방법을 사용할 수 있습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 3K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 종횡비: [1/16, 16] + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 가로세로 비율: [1/16, 16] "seedream-5-0-pro-260628": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 종횡비, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 2K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 종횡비: [1/16, 16] + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 가로세로 비율: [1/16, 16] "seedream-5-0-flash-260915": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 종횡비, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 종횡비: [1/16, 16] -"seedream-5-0-pro-260628" 및 "seedream-5-0-flash-260915"에서 layer_decomposition을 활성화한 경우: 해상도 수준의 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. - 기본 이미지는 원본 입력 이미지의 종횡비로 지정된 해상도에서 출력되며, 각 레이어는 원본 이미지에서 가졌던 종횡비를 유지하면서 지정된 해상도에 가깝게 출력됩니다. - auto: 입력 이미지의 크기와 종횡비를 기준으로 출력합니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로 출력되며, 2K보다 큰 입력은 2K로 출력됩니다. + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-5-261028": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915", "seedream-5-5-261028"에서 layer_decomposition을 활성화한 경우: 해상도 지정 방식만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. + 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력되며, 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. + auto: 입력 이미지의 크기와 가로세로 비율을 기준으로 출력됩니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로, 2K보다 큰 입력은 2K로 출력됩니다. - Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 고정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. seedream-5.0-lite, 4.5, 4.0만 이 파라미터를 지원합니다(seedream-5.0-pro와 5.0-flash는 지원하지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성되는 즉시 반환됩니다. + Comfy Router는 완전한 JSON 결과를 캡처하므로 명시적으로 전달된 stream 플래그를 false로 확정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다(seedream-5.0-pro, 5.0-flash, 5.5에서는 지원되지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후 즉시 반환됩니다. 생성된 이미지에 워터마크를 추가할지 여부를 지정합니다. false = 워터마크 없음, true = 'AI generated' 라벨이 있는 워터마크 추가 -Router가 `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 요청이 생성된 시간을 나타내는 Unix 타임스탬프(초 단위) + 요청이 생성된 시각을 나타내는 Unix 타임스탬프(초 단위) - 생성된 이미지에 대한 정보를 포함합니다. -레이어 분리 시나리오에서는 배열의 첫 번째 요소가 베이스 이미지(z_index=0)이고, 이후 요소들은 z_index가 커지는 순서로 정렬된 레이어입니다. + 생성된 이미지에 대한 정보를 담고 있습니다. +레이어 분리 시나리오에서는 배열의 첫 번째 요소가 기본 이미지(z_index=0)이고, 이후 요소들은 z_index가 증가하는 순서로 정렬된 레이어입니다. Base64로 인코딩된 이미지 데이터(response_format이 "b64_json"인 경우) + + 이미지가 실제로 가지는 배경 유형으로, transparent 또는 opaque입니다. 레이어 분리 시나리오에서 기본 이미지는 항상 opaque이고 모든 레이어는 transparent입니다. 이 필드는 seedream-5.5만 반환합니다. + + - 현재 레이어가 베이스 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 레이어만 이 필드를 반환하며, 베이스 이미지는 전체 캔버스를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 레이어가 기본 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 레이어만 이 필드를 반환하며, 기본 이미지는 전체 캔버스를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 레이어 바운딩 박스의 절대 픽셀 좌표로, 왼쪽 위 모서리를 (0, 0)으로 하는 출력 베이스 이미지의 좌표계를 기준으로 합니다. 좌표 형식: [left, top, right, bottom]. + 레이어 바운딩 박스의 절대 픽셀 좌표로, 왼쪽 위 모서리를 (0, 0)으로 하는 출력 기본 이미지의 좌표계를 사용합니다. 좌표 형식: [left, top, right, bottom]. - 레이어 바운딩 박스의 천분율로 양자화된(정규화된) 좌표로, 베이스 이미지 크기를 기준으로 [0, 1000]의 이산 정수 범위에 비례적으로 매핑되며 최대 1000에서 절삭됩니다. 좌표 형식: [left, top, right, bottom]. + 레이어 바운딩 박스의 천분율 양자화(정규화) 좌표로, 기본 이미지 크기를 기준으로 [0, 1000] 범위의 이산 정수 값에 비례적으로 매핑되며 최대 1000에서 잘립니다. 좌표 형식: [left, top, right, bottom]. - 현재 분리된 요소에 대한 상세 설명으로, name보다 풍부한 레이어 특성(색상, 상태, 재질 등)을 제공합니다. 레이어만 이 필드를 반환하며 베이스 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 분리된 요소에 대한 상세 설명으로, name보다 풍부한 레이어 특성(색상, 상태, 재질 등)을 제공합니다. 레이어만 이 필드를 반환하며 기본 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 현재 분리된 요소의 이름/레이블로, 분리된 대상의 특성으로부터 모델이 자동으로 생성합니다. 레이어만 이 필드를 반환하며 베이스 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 분리된 요소의 이름/레이블로, 분리된 피사체의 특성을 바탕으로 모델이 자동 생성합니다. 레이어만 이 필드를 반환하며 기본 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 출력 이미지의 파일 형식입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 출력 이미지의 파일 형식입니다. 이 필드는 seedream-5.0-pro와 5.5만 지원합니다. - 이미지의 너비와 높이(픽셀)로, 형식은 \x\입니다. seedream-5.0-pro, 5.0-lite, 4.5, 4.0만 이 파라미터를 지원합니다. + 이미지의 너비와 높이(픽셀)로, \x\ 형식입니다. 이 매개변수는 seedream-5.0-pro, 5.0-lite, 5.5, 4.5, 4.0만 지원합니다. @@ -310,7 +338,7 @@ Router가 `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json`에서 - 레이어의 적층 순서로, 아래에서 위로 갈수록 커집니다. 0은 가장 아래 레이어(베이스 이미지)이고 값이 클수록 위에 위치합니다. 이 값을 사용해 레이어를 올바른 적층 순서로 다시 구성하여 완전한 이미지로 만들 수 있습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 레이어의 쌓임 순서로, 아래에서 위로 갈수록 증가합니다. 0은 가장 아래 레이어(기본 이미지)이고 값이 클수록 위에 위치합니다. 레이어를 올바른 쌓임 순서로 재구성해 완전한 이미지를 만들 때 사용합니다. layer_decomposition이 true인 경우에만 반환됩니다. @@ -318,7 +346,7 @@ Router가 `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json`에서 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책에 따른 거부를 나타냅니다. 패밀리에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아닌 개방형 문자열이며, 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 envelope과 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake와 같이 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아닌 개방형 문자열이며, 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -338,7 +366,7 @@ Router가 `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json`에서 - 모델에 입력된 이미지 수입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 모델에 입력된 이미지 수입니다. 이 필드는 seedream-5.0-pro와 5.5만 지원합니다. diff --git a/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx index 20e53925a4..1ffb5664f7 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Seedream 5.0 Pro 260628 사용하기" description: "Comfy Router를 통해 byteplus/seedream-5-0-pro-260628을 호출합니다. 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedream 5.0 Pro 260628" -translationSourceHash: a37309ff +translationSourceHash: f5270d3a translationFrom: development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx translationBlockHashes: "_intro": b9a1b857 "Quick start": 5b012c86 - "Schema": c3a86bb4 + "Schema": b6886a5f "Examples": 40c4bb92 --- + {/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/byteplus/seedream-5-0-pro-260628.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -157,8 +158,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests/$ ### 입력 + + 생성된 이미지에 투명 배경(알파 채널)이 있는지 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 자체 스키마에 이 항목이 문서화된 최신 Seedream 모델에서 지원됩니다. +auto: 모델이 프롬프트와 output_format을 기반으로 결정합니다. output_format이 jpeg이면 출력은 항상 불투명합니다. +transparent: 투명 배경을 가진 RGBA 이미지를 출력합니다. output_format이 jpeg이면 오류를 반환합니다. +opaque: 불투명 배경을 가진 RGB 이미지를 출력합니다. seedream-5.0-pro의 기본값입니다. +seedream-5.0-pro는 알파 채널이 있는 png 입력 이미지 한 장을 사용하는 이미지 기반 이미지 생성에서만 투명 출력을 지원합니다. +레이어 분리 시나리오에서는 지원되지 않습니다. layer_decomposition을 활성화한 상태로 전달하면 오류를 반환합니다. + + 가능한 값: `auto`, `transparent`, `opaque` + + - 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지를 제어합니다. 범위 [1, 10]. 값이 높을수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0에서는 지원되지 않습니다. + 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지 제어합니다. 범위는 [1, 10]입니다. 값이 클수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0에서는 지원되지 않습니다. 범위: `1` ~ `10` @@ -166,64 +178,73 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests/$ - 편집할 이미지로, 접근 가능한 URL 또는 data-URI 접두사가 붙은 Base64 페이로드로 전달합니다. 이 모델의 참조 이미지 상한이 14가 아니라 10이라는 점을 제외하면 공용 Seedream 필드와 동일합니다. + 편집할 이미지 또는 이미지들로, 접근 가능한 URL 또는 data-URI 접두사가 붙은 Base64 페이로드입니다. 참조 이미지 상한이 이 모델에서는 14가 아니라 10이라는 점을 제외하면 공유 Seedream 필드와 동일합니다. - 레이어 분리 활성화 여부를 제어합니다. seedream-5.0-pro와 5.0-flash만 이 매개변수를 지원합니다. -true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 베이스 이미지와 여러 레이어(최대 16개)로 분해하고, 생성된 각 레이어의 위치와 콘텐츠 정보를 반환합니다. 여기에는 스태킹 순서(z_index), 바운딩 박스(bounding_box), 이름(name) 및 설명(description)이 포함됩니다. + 레이어 분리 활성화 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 5.5만 이 매개변수를 지원합니다. +true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 기본 이미지와 여러 레이어(최대 16개, seedream-5.5에서는 최대 99개)로 분해하고, 적재 순서(z_index), 바운딩 박스(bounding_box), 이름(name), 설명(description)을 포함하여 생성된 각 레이어의 위치 및 콘텐츠 정보를 반환합니다. false: 표준 이미지 생성 모드이며, 레이어 분리를 수행하지 않습니다. -레이어 분리 모드 관련 참고 사항: 단일 입력 이미지만 지원됩니다(여러 이미지를 전달하면 오류가 반환됨). 단일 레이어라도 생성에 실패하면 전체 요청이 실패하며, 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(베이스 이미지 1개 + 레이어 16개). sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류가 반환됩니다. +레이어 분리 모드 관련 참고 사항: 단일 입력 이미지만 지원됩니다(여러 이미지를 전달하면 오류 반환). 어느 한 레이어라도 생성에 실패하면 요청 전체가 실패합니다. 부분 성공은 지원되지 않습니다. 최대 17개의 이미지가 반환됩니다(기본 이미지 1개 + 레이어 16개). seedream-5.5는 최대 layer_decomposition_options.max_images 개의 이미지를 반환합니다(기본 이미지 1개 + 최대 99개 레이어). sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류를 반환합니다. + + + + 레이어 분리 모드의 옵션입니다. seedream-5.5만 이 매개변수를 지원하며, layer_decomposition이 true일 때만 적용됩니다. + + + + 이 요청이 반환하는 최대 총 이미지 수로, 기본 이미지와 레이어를 합한 값입니다. 범위: [2, 100]. 프롬프트에서 이미지를 어떻게 분할할지 지정하지 않은 경우, 모델은 max_images와 입력 이미지의 복잡도를 바탕으로 레이어를 계획하며, 값이 클수록 보통 더 세밀한 레이어가 만들어집니다. + + 범위: `2` ~ `100` - 모델 식별자입니다. 지원 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628 및 seedream-5-0-flash-260915. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400과 함께 거부합니다. 이 스키마의 `required` 목록에 포함되지 않은 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우기 때문에 Router 호출자는 이를 생략하기 때문입니다. + 모델 식별자입니다. 지원 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915, seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우기 때문에 Router 호출자는 이를 생략하기 때문입니다. - 프롬프트 최적화 기능의 구성입니다. seedream-5.0-pro/5.0-lite/4.5(표준 모드만 지원)와 seedream-4.0만 이 매개변수를 지원합니다. + 프롬프트 최적화 기능의 설정입니다. seedream-5.0-pro/5.0-lite/4.5/5.5(standard 모드만 지원하며, seedream-5.5는 fast에 대해 오류를 반환)와 seedream-4.0만 이 매개변수를 지원합니다. - 프롬프트 최적화 기능의 모드를 설정합니다. standard = 더 높은 품질, 더 긴 생성 시간. fast = 더 빠르지만 다소 평균적인 품질. + 프롬프트 최적화 기능의 모드를 설정합니다. standard = 더 높은 품질, 더 긴 생성 시간. fast = 더 빠르지만 평균 수준의 품질. 가능한 값: `standard`, `fast` - 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash와 5.0-lite만 이 매개변수를 지원합니다. 레이어 분리 시나리오에서 output_format은 베이스 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. + 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 매개변수를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. 가능한 값: `png`, `jpeg` 이미지 생성 또는 변환을 위한 텍스트 설명입니다. -레이어 분리 시나리오(seedream-5.0-pro 또는 5.0-flash에서 layer_decomposition 활성화)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리합니다. 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. +레이어 분리 시나리오(seedream-5.0-pro, 5.0-flash 또는 layer_decomposition이 활성화된 5.5)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트 의도에 따라 지정한 요소를 인식하고 분리하며, 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. - 응답으로 반환되는 생성 이미지의 형식을 지정합니다 + 응답에서 반환되는 생성된 이미지의 형식을 지정합니다. 가능한 값: `url`, `b64_json` - 이미지 생성의 무작위성을 제어하는 랜덤 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하세요. + 이미지 생성의 무작위성을 제어하는 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하세요. 범위: `-1` ~ `2147483647` - 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro 또는 5.0-flash는 지원하지 않음). 유효한 값: -auto: 자동 모드에서는 사용자의 프롬프트를 기반으로 모델이 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. -disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이미지만 생성합니다. + 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않음). 유효한 값:auto: 자동 모드에서는 모델이 사용자의 프롬프트를 기반으로 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. +disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지를 하나만 생성합니다. 가능한 값: `auto`, `disabled` - seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다(seedream-5.0-pro 또는 5.0-flash에서는 지원되지 않음). -배치 이미지 생성 기능에 대한 구성입니다. 이 매개변수는 sequential_image_generation이 auto로 설정된 경우에만 적용됩니다. + 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash, 5.5에서는 지원되지 않음). +배치 이미지 생성 기능에 대한 설정입니다. 이 파라미터는 sequential_image_generation이 auto로 설정된 경우에만 적용됩니다. @@ -233,7 +254,7 @@ disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이 - "seedream-4-0-250828": 생성된 이미지의 사양을 설정합니다. 두 가지 방법을 사용할 수 있지만 함께 사용할 수는 없습니다. + "seedream-4-0-250828": 생성할 이미지의 사양을 설정합니다. 두 가지 방법을 사용할 수 있지만 함께 사용할 수는 없습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 2K, 4K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [1024x1024, 4096x4096], 가로세로 비율: [1/16, 16] "seedream-4-5-251128": 두 가지 방법을 사용할 수 있습니다. @@ -242,79 +263,85 @@ disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이 "seedream-5-0-260128": 두 가지 방법을 사용할 수 있습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 3K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 가로세로 비율: [1/16, 16] - "seedream-5-0-pro-260628": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 2K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 전체 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 가로세로 비율: [1/16, 16] + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 가로세로 비율: [1/16, 16] "seedream-5-0-flash-260915": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). - 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 최종 크기는 모델이 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K - 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 전체 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] -"seedream-5-0-pro-260628" 및 "seedream-5-0-flash-260915"에서 layer_decomposition이 활성화된 경우: 해상도 수준 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. - 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력되고, 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. - auto: 입력 이미지의 크기와 가로세로 비율을 기준으로 출력합니다. [1280x720, ~2048x2048] 범위 내의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로 출력되며, 2K보다 큰 입력은 2K로 출력됩니다. + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-5-261028": 두 가지 방법을 사용할 수 있습니다(함께 사용할 수 없음). + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915", "seedream-5-5-261028"에서 layer_decomposition이 활성화된 경우: 해상도 수준 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. + 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력되며, 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. + auto: 입력 이미지의 크기와 가로세로 비율을 기준으로 출력합니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력되고, 1K보다 작은 입력은 1K로, 2K보다 큰 입력은 2K로 출력됩니다. - Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 고정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다(seedream-5.0-pro 또는 5.0-flash에서는 지원되지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후 즉시 반환됩니다. + Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 전달된 stream 플래그를 false로 확정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5, 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash, 5.5에서는 지원되지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후 즉시 반환됩니다. - 생성된 이미지에 워터마크를 추가할지 여부를 지정합니다. false = 워터마크 없음, true = 'AI generated' 레이블이 포함된 워터마크 추가 + 생성된 이미지에 워터마크를 추가할지 여부를 지정합니다. false = 워터마크 없음, true = 'AI generated' 라벨이 있는 워터마크 추가 -Router가 `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json`에서 제공하는 스키마, 즉 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서에서 생성되었습니다. +`GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json`에서 Router가 제공하는 스키마를 바탕으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 요청이 생성된 시각을 나타내는 Unix 타임스탬프(초 단위)입니다. + 요청이 생성된 시간을 나타내는 Unix 타임스탬프(초 단위) - 생성된 이미지에 대한 정보를 담고 있습니다. -레이어 분리 시나리오에서 배열의 첫 번째 요소는 베이스 이미지(z_index=0)이고, 그다음 요소들은 z_index가 증가하는 순서로 정렬된 레이어입니다. + 생성된 이미지에 대한 정보를 포함합니다. +레이어 분리 시나리오에서 배열의 첫 번째 요소는 기본 이미지(z_index=0)이며, 이후 요소는 z_index가 증가하는 순서로 정렬된 레이어입니다. - Base64로 인코딩된 이미지 데이터입니다(response_format이 "b64_json"인 경우). + Base64로 인코딩된 이미지 데이터(response_format이 "b64_json"인 경우) + + + + 이미지가 실제로 가지는 배경 유형으로, transparent 또는 opaque입니다. 레이어 분리 시나리오에서 기본 이미지는 항상 opaque이고 모든 레이어는 transparent입니다. 이 필드는 seedream-5.5만 반환합니다. - 현재 레이어가 베이스 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 레이어만 이 필드를 반환하며, 베이스 이미지는 전체 캔버스를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 레이어가 기본 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 이 필드는 레이어만 반환하며, 기본 이미지는 캔버스 전체를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 레이어 바운딩 박스의 절대 픽셀 좌표로, 왼쪽 위 모서리를 (0, 0)으로 하는 출력 베이스 이미지의 좌표계를 기준으로 합니다. 좌표 형식: [left, top, right, bottom]. + 레이어 바운딩 박스의 절대 픽셀 좌표로, 왼쪽 위 모서리가 (0, 0)인 출력 기본 이미지의 좌표계를 기준으로 합니다. 좌표 형식: [left, top, right, bottom]. - 레이어 바운딩 박스의 천분율로 양자화된(정규화된) 좌표로, 베이스 이미지 크기를 기준으로 [0, 1000]의 이산 정수 범위에 비례적으로 매핑되며 최대 1000에서 잘립니다. 좌표 형식: [left, top, right, bottom]. + 레이어 바운딩 박스의 천분율(per-mille) 양자화(정규화) 좌표로, 기본 이미지 크기를 기준으로 [0, 1000]의 이산 정수 범위에 비례적으로 매핑되며 최대 1000에서 잘립니다. 좌표 형식: [left, top, right, bottom]. - 현재 분리된 요소에 대한 상세 설명으로, name보다 풍부한 레이어 특성(예: 색상, 상태, 재질)을 제공합니다. 레이어만 이 필드를 반환하며 베이스 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 분리된 요소에 대한 상세 설명으로, name보다 풍부한 레이어 특성(색상, 상태, 재질 등)을 제공합니다. 이 필드는 레이어만 반환하며 기본 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 현재 분리된 요소의 이름/레이블로, 분리된 대상의 특성으로부터 모델이 자동으로 생성합니다. 레이어만 이 필드를 반환하며 베이스 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 현재 분리된 요소의 이름/레이블로, 분리된 피사체의 특성에 따라 모델이 자동으로 생성합니다. 이 필드는 레이어만 반환하며 기본 이미지는 반환하지 않습니다. layer_decomposition이 true인 경우에만 반환됩니다. - 출력 이미지의 파일 형식입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 출력 이미지의 파일 형식입니다. 이 필드는 seedream-5.0-pro와 5.5만 지원합니다. - 이미지의 너비와 높이(픽셀)로, \x\ 형식입니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0만 이 파라미터를 지원합니다. + 이미지의 너비와 높이(픽셀)로, 형식은 \x\입니다. 이 파라미터는 seedream-5.0-pro, 5.0-lite, 5.5, 4.5, 4.0만 지원합니다. - 이미지 다운로드 URL입니다(response_format이 "url"인 경우). + 이미지 다운로드 URL(response_format이 "url"인 경우) 형식: `uri` - 레이어의 적층 순서로, 아래에서 위로 갈수록 증가합니다. 0은 가장 아래 레이어(베이스 이미지)이며, 값이 클수록 위에 위치합니다. 이 값을 사용해 레이어를 올바른 적층 순서로 다시 합성하여 완전한 이미지로 만들 수 있습니다. layer_decomposition이 true인 경우에만 반환됩니다. + 레이어의 적층 순서로, 아래에서 위로 갈수록 증가합니다. 0은 가장 아래 레이어(기본 이미지)이며 값이 클수록 위에 위치합니다. 레이어를 올바른 적층 순서로 다시 합쳐 완전한 이미지로 재구성할 때 사용합니다. layer_decomposition이 true인 경우에만 반환됩니다. @@ -322,7 +349,7 @@ Router가 `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json`에서 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected 및 OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열은 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유를 가질 수 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 그 밖의 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패한 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에는 점으로 구분된 사유가 붙을 수 있습니다. 예: InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake. 이 값은 열거형이 아닌 개방형 문자열이며, 그 밖의 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 계층 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -342,7 +369,7 @@ Router가 `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json`에서 - 모델에 입력된 이미지 수입니다. seedream-5.0-pro만 이 필드를 지원합니다. + 모델에 입력된 이미지 수입니다. 이 필드는 seedream-5.0-pro와 5.5만 지원합니다. diff --git a/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx new file mode 100644 index 0000000000..a8fa079b54 --- /dev/null +++ b/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx @@ -0,0 +1,409 @@ +--- +title: "Comfy Router로 Seedream 5.5 261028 사용하기" +description: "Comfy Router를 통해 byteplus/seedream-5-5-261028을 호출합니다: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." +sidebarTitle: "Seedream 5.5 261028" +translationSourceHash: e2bff0d7 +translationFrom: development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx +translationBlockHashes: + "_intro": 5d72228c + "Quick start": 0a48e3d8 + "Schema": c4ff843e + "Examples": 2d76f48c +--- +{/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-5-261028.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`byteplus/seedream-5-5-261028`에 대한 API 레퍼런스이며, Comfy Router가 BytePlus에서 제공합니다. + +**입력:** Text, Image · **출력:** 이미지 + +## 빠른 시작 + +[내 Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다. + +**모델 ID:** `byteplus/seedream-5-5-261028` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "byteplus/seedream-5-5-261028", + { + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": False, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("byteplus/seedream-5-5-261028", { + prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", + response_format: "url", + watermark: false, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests`로 보냅니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비가 되면 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [실행 대기열 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "byteplus/seedream-5-5-261028", + { + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": False, + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자의 자체 페이로드이며, models.run()이 반환하는 것과 같은 값입니다. + # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("byteplus/seedream-5-5-261028", { + prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", + response_format: "url", + watermark: false, +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 모델의 기본 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202. +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 생성된 이미지의 배경을 투명하게(알파 채널) 할지 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 자체 스키마에 이 필드가 문서화된 최신 Seedream 모델에서 지원됩니다. +auto: 모델이 프롬프트와 output_format을 기반으로 결정합니다. output_format이 jpeg인 경우 출력은 항상 불투명합니다. +transparent: 배경이 투명한 RGBA 이미지를 출력합니다. output_format이 jpeg이면 오류를 반환합니다. +opaque: 배경이 불투명한 RGB 이미지를 출력합니다. seedream-5.0-pro의 기본값입니다. +seedream-5.0-pro는 알파 채널이 있는 png 입력 이미지 한 장을 사용하는 이미지 기반 이미지 생성에서만 투명 출력을 지원합니다. +레이어 분리 시나리오에서는 지원되지 않습니다. layer_decomposition을 활성화한 상태에서 이 필드를 전달하면 오류를 반환합니다. + + 가능한 값: `auto`, `transparent`, `opaque` + + + + 출력 이미지가 입력 프롬프트에 얼마나 밀접하게 부합하는지 제어합니다. 범위는 [1, 10]입니다. 값이 클수록 프롬프트 준수가 강해집니다. seedream-5.0-pro, 5.0-lite, 4.5 및 4.0에서는 지원되지 않습니다. + + 범위: `1` ~ `10` + + 형식: `float` + + + + 편집할 이미지로, 접근 가능한 URL 또는 data-URI 접두사가 붙은 Base64 페이로드로 전달합니다. 참조 이미지 상한이 이 모델에서는 14가 아닌 10이라는 점을 제외하면 공통 Seedream 필드와 동일합니다. + + + + 레이어 분리 사용 여부를 제어합니다. seedream-5.0-pro, 5.0-flash 및 5.5만 이 파라미터를 지원합니다. +true: 레이어 분리 모드입니다. 모델이 단일 입력 이미지를 하나의 베이스 이미지와 여러 레이어(최대 16개, seedream-5.5에서는 최대 99개)로 분해하고, 생성된 각 레이어의 위치와 콘텐츠 정보를 반환합니다. 여기에는 쌓임 순서(z_index), 바운딩 박스(bounding_box), 이름(name) 및 설명(description)이 포함됩니다. +false: 표준 이미지 생성 모드이며, 레이어 분리를 수행하지 않습니다. +레이어 분리 모드 관련 참고 사항: 단일 입력 이미지만 지원됩니다(여러 이미지를 전달하면 오류를 반환합니다). 어느 한 레이어라도 생성에 실패하면 요청 전체가 실패하며, 부분 성공은 지원되지 않습니다. 최대 17개의 이미지(베이스 이미지 1개 + 레이어 16개)가 반환됩니다. seedream-5.5는 최대 layer_decomposition_options.max_images개의 이미지(베이스 이미지 1개 + 최대 99개 레이어)를 반환합니다. sequential_image_generation, sequential_image_generation_options, tools 및 stream을 전달하면 오류를 반환합니다. + + + + 레이어 분리 모드의 옵션입니다. seedream-5.5만 이 파라미터를 지원하며, layer_decomposition이 true일 때만 적용됩니다. + + + + 이 요청이 반환하는 이미지의 최대 총 개수로, 베이스 이미지와 레이어를 합한 값입니다. 범위: [2, 100]. 프롬프트에서 이미지 분할 방법을 명시하지 않은 경우, 모델은 max_images와 입력 이미지의 복잡도를 바탕으로 레이어를 계획합니다. 값이 클수록 보통 더 세밀한 레이어가 생성됩니다. + + 범위: `2` ~ `100` + + + + 모델 식별자입니다. 지원 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 및 seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이 값을 제공해야 하며, 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문에 Router 호출자는 이를 생략하기 때문입니다. + + + + 프롬프트 최적화 기능의 설정입니다. seedream-5.0-pro/5.0-lite/4.5/5.5(standard 모드만 지원하며, seedream-5.5는 fast에 대해 오류를 반환합니다) 및 seedream-4.0만 이 파라미터를 지원합니다. + + + + 프롬프트 최적화 기능의 모드를 설정합니다. standard = 더 높은 품질, 더 긴 생성 시간. fast = 더 빠르지만 평균 수준의 품질. + + 가능한 값: `standard`, `fast` + + + + 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 파라미터를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 베이스 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. + + 가능한 값: `png`, `jpeg` + + + + 이미지 생성 또는 변환을 위한 텍스트 설명입니다. +레이어 분리 시나리오(seedream-5.0-pro, 5.0-flash 또는 layer_decomposition이 활성화된 5.5)에서는 선택 사항입니다. 프롬프트를 제공하면 모델이 프롬프트의 의도에 따라 지정한 요소를 인식하고 분리하며, 프롬프트를 제공하지 않으면 모델이 이미지의 모든 주요 요소를 자동으로 감지하여 독립적인 레이어로 분리합니다. + + + + 응답으로 반환되는 생성 이미지의 형식을 지정합니다 + + 가능한 값: `url`, `b64_json` + + + + 이미지 생성의 무작위성을 제어하는 시드입니다. 범위: [-1, 2147483647]. 지정하지 않으면 시드가 자동으로 생성됩니다. 동일한 출력을 재현하려면 동일한 시드 값을 사용하십시오. + + 범위: `-1` ~ `2147483647` + + + + 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). 유효한 값:auto: 자동 모드에서 모델은 사용자의 프롬프트에 따라 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. +disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이미지만 생성합니다. + + 가능한 값: `auto`, `disabled` + + + + seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다 (seedream-5.0-pro, 5.0-flash, 5.5에서는 지원되지 않음). +배치 이미지 생성 기능 구성입니다. 이 매개변수는 sequential_image_generation이 auto로 설정된 경우에만 유효합니다. + + + + 이 요청에서 생성할 최대 이미지 수를 지정합니다. 입력 참조 이미지 수 + 생성된 이미지 수 ≤ 15. + + 범위: `1` ~ `15` + + + + "seedream-4-0-250828": 생성된 이미지의 사양을 설정합니다. 두 가지 방법을 사용할 수 있지만 함께 사용할 수는 없습니다. + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 2K, 4K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [1024x1024, 4096x4096], 가로세로 비율: [1/16, 16] +"seedream-4-5-251128": 두 가지 방법을 사용할 수 있습니다. + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 4K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, 4096x4096], 가로세로 비율: [1/16, 16] +"seedream-5-0-260128": 두 가지 방법을 사용할 수 있습니다. + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 3K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, ~3072x3072], 가로세로 비율: [1/16, 16] +"seedream-5-0-pro-260628": 두 가지 방법을 사용할 수 있습니다 (함께 사용할 수 없음). + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 1024x1024, 총 픽셀: [1024x1024 (1048576), 2048x2048 (4194304)], 가로세로 비율: [1/16, 16] +"seedream-5-0-flash-260915": 두 가지 방법을 사용할 수 있습니다 (함께 사용할 수 없음). + 방법 1 | 해상도를 지정하고 프롬프트에 이미지의 가로세로 비율, 형태 또는 용도를 설명합니다. 모델이 최종 크기를 결정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-5-261028": 두 가지 방법을 사용할 수 있습니다 (함께 사용할 수 없음). + 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 1.5K, 2K. 기본값: 2K + 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 총 픽셀: [1280x720 (921600), 2048x2048x1.1025 (4624220)], 가로세로 비율: [1/16, 16] +"seedream-5-0-pro-260628", "seedream-5-0-flash-260915" 및 "seedream-5-5-261028"에서 layer_decomposition이 활성화된 경우: 해상도 수준 방법만 지원됩니다. 선택 가능한 값: 1K, 1.5K, 2K, auto. 기본값: auto. + 기본 이미지는 원본 입력 이미지의 가로세로 비율로 지정된 해상도에서 출력됩니다. 각 레이어는 원본 이미지에서 가졌던 가로세로 비율을 유지하면서 지정된 해상도에 가깝게 출력됩니다. + auto: 입력 이미지의 크기와 가로세로 비율을 기반으로 출력합니다. [1280x720, ~2048x2048] 범위의 입력은 원본 입력 크기로 출력됩니다. 1K보다 작은 입력은 1K로 출력되고, 2K보다 큰 입력은 2K로 출력됩니다. + + + + Comfy Router는 완전한 JSON 결과를 캡처하기 때문에 명시적으로 제공된 stream 플래그를 false로 설정합니다. v1 프록시에서 이 필드는 스트리밍 출력 모드를 활성화할지 여부를 제어합니다. seedream-5.0-lite, 4.5, 4.0만 이 매개변수를 지원합니다 (seedream-5.0-pro, 5.0-flash, 5.5에서는 지원되지 않음). false = 모든 출력 이미지가 한 번에 반환됩니다. true = 각 출력 이미지가 생성된 직후에 반환됩니다. + + + + 생성된 이미지에 워터마크를 추가할지 여부를 지정합니다. false = 워터마크 없음, true = 'AI generated' 라벨이 있는 워터마크 추가 + + +Router가 `GET /v2/models/byteplus/seedream-5-5-261028/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용되는 동일한 문서입니다. + +### 출력 + + + 요청이 생성된 시간을 나타내는 Unix 타임스탬프(초)입니다. + + + + 생성된 이미지에 대한 정보를 포함합니다. +레이어 분리 시나리오에서 배열의 첫 번째 요소는 기본 이미지(z_index=0)이고, 다음 요소는 레이어이며 z_index가 증가하는 순서로 정렬됩니다. + + + + Base64로 인코딩된 이미지 데이터(response_format이 "b64_json"인 경우) + + + + 이미지가 실제로 가지는 배경 유형입니다: transparent 또는 opaque. 레이어 분리 시나리오에서 기본 이미지는 항상 opaque이고 모든 레이어는 transparent입니다. seedream-5.5만 이 필드를 반환합니다. + + + + 현재 레이어가 기본 이미지 내에서 차지하는 영역의 바운딩 박스 정보입니다. 레이어만 이 필드를 반환하며, 기본 이미지는 전체 캔버스를 차지하므로 bounding_box를 반환하지 않습니다. layer_decomposition이 true일 때만 반환됩니다. + + + + 레이어 바운딩 박스의 절대 픽셀 좌표입니다. 출력 기본 이미지의 좌표계를 기준으로 하며 왼쪽 위 모서리가 (0, 0)입니다. 좌표 형식: [left, top, right, bottom]. + + + + 레이어 바운딩 박스의 천분율로 양자화된(정규화된) 좌표입니다. 기본 이미지 크기를 기준으로 [0, 1000]의 이산 정수 범위에 비례적으로 매핑되며, 최대 1000에서 잘립니다. 좌표 형식: [left, top, right, bottom]. + + + + 현재 분리된 요소에 대한 상세 설명으로, name보다 더 풍부한 레이어 특성(색상, 상태, 재질 등)을 제공합니다. 레이어만 이 필드를 반환하며 기본 이미지는 반환하지 않습니다. layer_decomposition이 true일 때만 반환됩니다. + + + + 현재 분리된 요소의 이름/레이블로, 분리된 대상의 특성으로부터 모델이 자동으로 생성합니다. 레이어만 이 필드를 반환하며 기본 이미지는 반환하지 않습니다. layer_decomposition이 true일 때만 반환됩니다. + + + + 출력 이미지의 파일 형식입니다. seedream-5.0-pro와 5.5만 이 필드를 지원합니다. + + + + 이미지의 너비와 높이(픽셀)이며 형식은 \x\입니다. seedream-5.0-pro, 5.0-lite, 5.5, 4.5, 4.0만 이 매개변수를 지원합니다. + + + + 이미지 다운로드용 URL(response_format이 "url"인 경우) + + 형식: `uri` + + + + 레이어의 쌓임 순서로, 아래에서 위로 갈수록 증가합니다: 0은 가장 아래 레이어(기본 이미지)이고 값이 클수록 더 위에 있습니다. 올바른 쌓임 순서로 레이어를 완전한 이미지로 다시 합성할 때 사용하세요. layer_decomposition이 true일 때만 반환됩니다. + + + + 오류 정보(있는 경우) + + + + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake와 같이 점으로 구분된 사유가 있을 수 있습니다. 이것은 열거형이 아니라 개방형 문자열입니다: 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패한 작업 응답에서 정책 계열을 인식합니다. + + + + 오류 메시지 + + + + 요청에 사용된 모델 ID입니다. + + + + + + + + 모델이 생성한 이미지 수 + + + + 모델에 입력된 이미지 수입니다. seedream-5.0-pro와 5.5만 이 필드를 지원합니다. + + + + 모델이 생성한 이미지에 사용된 토큰 수입니다. + + + + 이 요청에서 소비된 총 토큰 수입니다. + + +## 예시 + +### 입력 + +```json +{ + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": false +} +``` + +### 출력 + +```json +{ + "created": 1767225600, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/byteplus/seedream-4-0-250828/generated.png" + } + ], + "model": "seedream-5-5-261028", + "usage": { + "generated_images": 1 + } +} +``` + + + diff --git a/ko/development/comfy-router/models/meshy/rigging/code.mdx b/ko/development/comfy-router/models/meshy/rigging/code.mdx index de155a6731..a1280ca5f0 100644 --- a/ko/development/comfy-router/models/meshy/rigging/code.mdx +++ b/ko/development/comfy-router/models/meshy/rigging/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Rigging 사용하기" description: "Comfy Router를 통해 meshy/rigging을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Rigging" -translationSourceHash: d7eb966f +translationSourceHash: e8dbb3d3 translationFrom: development/comfy-router/models/meshy/rigging/code.mdx translationBlockHashes: "_intro": 2ec24f71 "Quick start": 08a075b7 - "Schema": 2d8d7dbb + "Schema": 66703709 "Examples": 8e91e01b --- + {/* 생성된 파일. router-schemas/meshy/rigging.json에서 `pnpm code-pages:gen`으로 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -157,6 +158,10 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ 범위: `0` ~ `…` + + 캐릭터 손에 손가락 본을 추가할지 여부입니다. Biped 리그에만 적용됩니다. texture_image_url, 사족보행 리그 또는 quad 토폴로지 input_task_id와 함께 사용하면 Meshy가 400으로 요청을 거부하며, 손가락 없이만 리깅할 수 있는 모델의 경우 422로 거부합니다(과금되지 않음). 손가락 본은 크레딧 비용을 변경하지 않습니다. 기본값은 거짓입니다. + + 리깅해야 하는 입력 작업입니다. model_url이 제공되지 않은 경우 필수입니다. @@ -165,6 +170,12 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ 텍스처가 있는 휴머노이드 GLB 파일에 대한 공개적으로 접근 가능한 URL 또는 Data URI입니다. input_task_id가 제공되지 않은 경우 필수입니다. + + 리깅된 캐릭터의 스켈레톤으로, 본 이름과 계층 구조를 설정합니다. Biped 리그에만 적용됩니다. meshyrig 이외의 값(또는 include_fingers 참)을 사용하면 출력 파일은 미터 단위가 되고, 기본값인 센티미터 단위의 24개 본 meshyrig 파일 대신 해당 스켈레톤의 본을 사용합니다. 이 리그로 만든 애니메이션 작업도 같은 스켈레톤을 사용합니다. 그 밖의 값은 거부됩니다. 기본값은 meshyrig입니다. + + 가능한 값: `meshyrig`, `mixamo`, `ue5_mannequin`, `max_biped`, `unity_humanoid`, `maya_human_ik`, `blender_rigify_basic_human`, `cc5_hd_neutral_base`, `daz_genesis9` + + 모델의 UV 언랩된 기본 색상 텍스처 이미지입니다. 공개적으로 접근 가능한 URL 또는 Data URI입니다. .png 형식을 지원합니다. diff --git a/ko/development/serverless/library-models.mdx b/ko/development/serverless/library-models.mdx new file mode 100644 index 0000000000..6dcecf3fd3 --- /dev/null +++ b/ko/development/serverless/library-models.mdx @@ -0,0 +1,171 @@ +--- +title: "Comfy API 배포에서 워크스페이스 라이브러리 모델 사용" +sidebarTitle: "라이브러리 모델" +description: "LoRA 또는 기타 .safetensors 모델을 워크스페이스 라이브러리에 업로드하고 새로운 Build, Release 또는 재배포 없이 Comfy API 배포에서 실행하세요." +icon: "folder-open" +translationSourceHash: ece5d691 +translationFrom: development/serverless/library-models.mdx +translationBlockHashes: + "_intro": 6a0b3555 + "Before you start": c7b9ddf9 + "Upload a model to the workspace library": 693a12a3 + "Run the model on your deployment": 8b7df85e + "Follow the limits and naming rules": 5b0d3461 + "Change or delete a library model": dda1b7bd +--- +Comfy API는 배포의 Release에 포함되어 있지 않더라도 워크스페이스 라이브러리의 모델을 실행합니다. LoRA 또는 다른 `.safetensors` 모델을 라이브러리에 업로드하고, 새 Build, Release, 재배포 없이 배포에서 실행하세요. + +워크스페이스 라이브러리를 사용하면 배포에서 직접 학습한 LoRA를 사용해 보거나, 워크플로에서 파일 이름 하나만 변경하여 API 요청마다 다른 LoRA를 선택할 수 있습니다. + +## 시작하기 전에 + +모델을 워크스페이스 라이브러리에 업로드하기 전에 다음 요구 사항을 충족해야 합니다: + +- **플랜**: 워크스페이스에 활성 Pro, Creator, Team, Enterprise 플랜이 필요합니다. +- **모델 파일**: 파일은 2 GB 이하의 `.safetensors` 파일이어야 합니다. SDXL 또는 FLUX와 같은 더 큰 베이스 모델은 여전히 Build에 포함됩니다. +- **활성 배포**: 배포는 라이브러리와 동일한 워크스페이스에 있어야 합니다. + + + 워크스페이스 라이브러리 모델을 사용할 수 있게 되기 전에 생성된 일부 배포에서는 해당 모델을 로드할 수 없습니다. 워크스페이스 라이브러리 모델을 사용하려면 새 배포를 생성하세요. 이전 배포에서는 작업이 다음 메시지와 함께 실패할 수 있습니다: `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` + + +## 워크스페이스 라이브러리에 모델 업로드 + +세 가지 도구 중 하나로 모델을 업로드할 수 있습니다: + +- **클라우드 편집기**: 파일을 업로드하거나 Civitai 또는 Hugging Face 링크에서 가져옵니다. +- **comfy-cli**: 터미널이나 스크립트에서 업로드합니다. +- **Developer Platform**: Build의 모델 단계에서 업로드합니다. + +사용하는 도구의 탭을 선택하세요. + + + + 1. **Run** 왼쪽의 배포 메뉴에서 **Run on** 아래에 **Comfy Cloud**가 선택되어 있는지 확인합니다. + 2. **왼쪽 사이드바**에서 **모델 라이브러리**를 클릭한 다음 **가져오기**를 클릭합니다. + 3. **파일 선택**을 클릭하거나 `.safetensors` 파일을 대화상자로 끌어다 놓습니다. + 4. **이 모델의 유형은 무엇인가요?** 에서 LoRA의 경우 **LoRA**를 그대로 두고, 파일에 맞는 유형을 선택합니다. + 5. **업로드**를 클릭합니다. 업로드가 끝나면 **완료**를 클릭합니다. + + ![my_style_lora_9e2417.safetensors(97.37 MB)가 선택되어 있고, 이 모델의 유형은 무엇인가요?가 LoRA로 설정되어 있으며, 뒤로 및 업로드 버튼이 있는 모델 가져오기 대화상자](/images/development/serverless/library-models-editor-import.png) + + 대신 Civitai 또는 Hugging Face 링크에서 모델을 가져오려면: + + 1. **가져오기** 대화상자에서 **여기에 링크를 붙여넣으세요**에 모델 링크를 붙여넣습니다. + 2. **계속**을 클릭합니다. + 3. **이 모델의 유형은 무엇인가요?** 에서 모델 유형을 선택합니다. + 4. **가져오기**를 클릭합니다. + + 배포에서 실행되는 것은 `.safetensors` 파일뿐입니다. `.ckpt` 같은 다른 형식의 링크 가져오기는 라이브러리에는 가져와지지만 배포에서는 실행되지 않습니다. + + + 파일을 업로드하고 `--type`으로 모델 유형을 설정합니다: + + ```bash + comfy assets library upload my_style.safetensors --type loras + ``` + + 파일이 라이브러리에 있는지 확인합니다: + + ```bash + comfy assets library ls --tags models,loras + ``` + + + 1. Developer Platform에서 Build의 모델 단계를 열고 **모델 업로드**를 클릭합니다. + 2. **워크스페이스 라이브러리**를 선택합니다. + 3. `.safetensors` 파일을 드롭 영역으로 끌어다 놓거나, 영역을 클릭해 찾아봅니다. + 4. **모델 유형**에서 LoRA의 경우 **LoRA**를 그대로 두고, 파일에 맞는 유형을 선택합니다. + 5. **업로드**를 클릭합니다. + + ![Build의 어떤 모델이 빌드에 포함되나요? 단계에 있는 모델 업로드 대화상자로, 공개, 비공개, 워크스페이스 라이브러리 탭, 선택된 워크스페이스 라이브러리, 드롭 영역, LoRA로 설정된 모델 유형, 파일이 워크스페이스 라이브러리에 있다는 문구, 취소 및 업로드 버튼이 표시됩니다](/images/development/serverless/library-models-platform-upload.png) + + + +모델이 라이브러리에 있으면 워크스페이스의 모든 멤버가 사용할 수 있습니다. 라이브러리는 LoRA뿐 아니라 모든 모델 유형을 받습니다. 로더 노드가 읽는 폴더에 맞는 유형을 선택하세요. 예를 들어 LoRA는 `loras`, VAE는 `vae`입니다. + +## 배포에서 모델 실행 + +모델이 라이브러리에 있으면 클라우드 에디터에서 또는 API를 통해 배포에서 실행할 수 있습니다. 작업을 보내는 방식에 해당하는 탭을 선택하세요. + + + + 1. **Run** 왼쪽의 배포 메뉴를 클릭합니다. **Run on**에서 배포를 선택합니다. 에디터가 다시 로드되며, 열려 있던 탭은 그대로 유지됩니다. + 2. `Load LoRA (Model and CLIP)` 노드를 추가하거나, 해당 노드가 포함된 워크플로를 엽니다. + 3. 노드의 `lora_name` 목록에서 파일을 선택합니다. 목록에는 릴리스의 모델과 함께 라이브러리 모델이 표시됩니다. + 4. **Run**을 클릭합니다. + + 첫 실행에서는 워커가 파일을 다운로드하는 동안 실행 대기열에서 해당 작업의 행에 `Downloading my_style.safetensors`가 표시됩니다. 작업이 여러 모델을 다운로드하면 행에 `Downloading ( of )`이 표시됩니다. + + ![체크포인트 로드 노드와 LoRA 로드 (모델 및 CLIP) 노드가 있는 워크플로, lora_name에 업로드한 LoRA가 선택됨, 큐 패널의 맨 위 행에 Downloading my_style_lora_9e2417.safetensors 0 B of 97.37 MB 표시](/images/development/serverless/library-models-editor-downloading.png) + + + [API 형식 워크플로](/ko/development/api-development/workflow-api-format)에서 `LoraLoader` 노드의 `lora_name` 입력을 `.safetensors`를 포함한 라이브러리 파일 이름으로 설정합니다: + + ```json + "10": { + "class_type": "LoraLoader", + "inputs": { + "lora_name": "my_style.safetensors", + "strength_model": 1.0, + "strength_clip": 1.0, + "model": ["4", 0], + "clip": ["4", 1] + } + } + ``` + + `comfy deploy run`, [Comfy SDK](/ko/development/api-development/sdks) 또는 [Comfy API v2](/ko/api-reference/v2/overview)로 워크플로를 전송합니다: + + ```bash + comfy deploy run --deployment --workflow workflow_api.json + ``` + + 다른 LoRA를 사용하려면 다음 요청에서 `lora_name`을 라이브러리의 다른 파일 이름으로 변경하면 됩니다. 새 빌드, 릴리스 또는 재배포는 필요하지 않습니다. + + + + + 라이브러리 모델을 사용하는 워커의 첫 작업은 시간이 더 오래 걸립니다. 워커가 먼저 모델을 다운로드하기 때문입니다. 같은 워커의 이후 작업은 캐시된 사본을 사용합니다. 새 워커는 모델을 다시 다운로드하며, 다른 모델을 위한 공간을 확보하기 위해 캐시에서 모델을 제거한 워커도 마찬가지입니다. 다운로드를 건너뛰려면 모델을 빌드에 추가하세요. + + +## 제한 및 이름 규칙 준수 + +[시작하기 전](#시작하기-전에)에 설명된 파일 크기 및 형식 제한 외에도 다음 제한이 적용됩니다. + +| 제한 | 값 | +| --- | --- | +| 워크스페이스 저장소 | 워크스페이스당 모델 1 TB (링크 가져오기 포함) | +| 워크플로당 라이브러리 모델 이름 | 100 | + +101번째 라이브러리 모델을 지정하는 로더는 해당 파일이 라이브러리에 없는 것처럼 실패합니다. + +작업이 올바른 파일을 찾도록 다음 규칙을 따르세요. + +- **로더가 읽는 폴더를 사용하세요.** 로더는 자신의 모델 유형에 해당하는 라이브러리 파일만 찾습니다. `Load LoRA` 노드는 `checkpoints`가 아닌 `loras`로 업로드된 파일을 찾습니다. +- **순수 파일 이름을 사용하세요.** 로더 입력에는 `my_style.safetensors`처럼 앞에 폴더가 붙지 않은 파일 이름만 설정하세요. +- **Release 모델의 이름을 재사용하지 마세요.** Release에 해당 이름의 파일이 이미 있으면 워커는 라이브러리 파일이 아닌 Release의 파일을 사용합니다. +- **폴더 간에 이름을 고유하게 유지하세요.** 하나의 로더가 읽는 두 폴더에 라이브러리에 같은 파일 이름이 있으면 API를 통해 전송된 작업은 두 파일 모두 로드하지 않습니다. +- **최신 파일이 우선한다는 점을 염두에 두세요.** 한 폴더에 라이브러리에 같은 이름의 파일이 두 개 있으면 작업은 마지막에 추가된 파일을 사용합니다. +- **베이스 모델을 일치시키세요.** LoRA는 워크플로가 로드하는 베이스 모델과 일치해야 합니다. +- **배포에 있는 로더를 사용하세요.** 로더 노드는 배포에서 사용할 수 있어야 합니다. 라이브러리 모델은 Comfy Cloud에 있는 로더 노드를 통해서만 로드됩니다. 사용하는 로더가 Comfy Cloud에 없는 커스텀 노드에서 제공되는 경우 해당 모델을 Build에 추가하세요. + +## 라이브러리 모델 변경 또는 삭제 + +**Run on**에서 배포가 선택된 경우, **Model Library**에는 해당 Release의 모델만 표시됩니다. 라이브러리 모델을 변경하거나 삭제하려면 먼저 Comfy Cloud로 다시 전환하세요: + +1. **Run** 왼쪽의 배포 메뉴를 클릭합니다. **Run on**에서 **Comfy Cloud**를 선택합니다. +2. **Left sidebar**에서 **Model Library**를 클릭합니다. + +모델 유형을 변경하려면: + +- 모델 카드 위에 마우스를 올리고 **Model Info**를 클릭한 다음 새 **Model Type**을 선택합니다. + + + 모델을 삭제하면 모든 멤버의 워크스페이스 라이브러리에서 해당 모델이 제거됩니다. 여전히 해당 파일을 지정하는 작업이나 API 요청은 로더 입력에서 `Value not in list` 오류와 함께 실패합니다. + + +모델을 삭제하려면: + +1. 모델 카드 위에 마우스를 올리고 **More**를 클릭한 다음 **Delete**를 클릭합니다. +2. **Delete this model?**에서 **Delete**를 클릭합니다. diff --git a/ko/development/serverless/overview.mdx b/ko/development/serverless/overview.mdx index ebf74e4689..8c786d8dfc 100644 --- a/ko/development/serverless/overview.mdx +++ b/ko/development/serverless/overview.mdx @@ -2,11 +2,11 @@ title: "Comfy API: 서버리스 배포" description: "Comfy API로 ComfyUI 워크플로우를 관리형 GPU 엔드포인트로 배포합니다. Build, 릴리스, 리전, 워커 스케일링, 워크스페이스 한도, 배포 모니터링을 다룹니다." icon: "cloud-arrow-up" -translationSourceHash: 2184a3a5 +translationSourceHash: 4df17332 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 - "Platform concepts": 97134dfe + "Platform concepts": cd4243ce "The Build file": 70f351b1 "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f @@ -14,10 +14,11 @@ translationBlockHashes: "Monitor and call a deployment": ff860dab "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b - "FAQ": 54896279 + "FAQ": 08ef9084 "Next steps": 0045baa9 --- + Comfy API를 사용하면 앱에서 관리형 엔드포인트를 통해 ComfyUI 워크플로를 실행할 수 있습니다. 워크플로에 필요한 ComfyUI 버전, 모델, 커스텀 노드, 종속성을 패키징하면 Comfy가 관리형 GPU에서 실행합니다. 반복 가능한 환경과 앱에서 호출할 엔드포인트가 필요할 때 사용하세요. ## 플랫폼 개념 @@ -25,11 +26,13 @@ Comfy API를 사용하면 앱에서 관리형 엔드포인트를 통해 ComfyUI | 개념 | 의미 | | --- | --- | | **워크스페이스** | 멤버, Build, 배포, 사용량 한도를 관리하는 팀 계정입니다. | -| **Build** | ComfyUI 버전, 모델, 커스텀 노드, 종속성을 포함하는 환경 정의입니다. | -| **Build 버전 / 릴리스** | `linux/nvidia`와 같은 배포 대상을 위해 준비된 번호가 지정된 Build입니다. | -| **배포** | 릴리스를 실행하는 엔드포인트로, 자체 GPU, 리전, 워커 설정이 있습니다. | +| **Build** | ComfyUI 환경 정의: 버전, 모델, 커스텀 노드, 의존성입니다. | +| **Build 버전 / 릴리스** | `linux/nvidia`와 같은 배포 대상을 위해 준비된, 번호가 매겨진 Build 버전입니다. | +| **배포** | 릴리스를 사용하는 실행 중인 엔드포인트로, 자체 GPU, 리전, 워커 설정이 있습니다. | + +[Comfy Cloud](/ko/development/deploy/cloud)에서 지원하는 워크플로는 Build나 배포를 만들지 않고도 실행할 수 있습니다. -[Comfy Cloud](/ko/development/deploy/cloud)에서 지원하는 워크플로는 Build나 배포 없이 실행할 수 있습니다. +새로운 Build 없이 배포에 모델을 추가하려면 워크스페이스 라이브러리에 업로드하세요. [워크스페이스 라이브러리 모델](/ko/development/serverless/library-models)을 참조하세요. 에이전트로 시작하거나 환경 또는 워크플로를 제공하는 다른 방법을 선택하세요. @@ -121,7 +124,7 @@ comfy deploy events --deployment dep_123456 ## FAQ - + 네. 빌더에서 하나 이상의 워크플로를 업로드하면 해당 모델과 커스텀 노드가 미리 선택됩니다. 실행할 모든 워크플로에 필요한 의존성을 포함한 다음, 각 API 형식 워크플로를 배포된 엔드포인트에 제출하세요. 각 배포는 하나의 GPU 유형을 사용합니다. 서로 다른 GPU 유형에서 워크플로를 실행하려면 동일한 빌드로 별도의 배포를 생성하세요. @@ -132,7 +135,7 @@ comfy deploy events --deployment dep_123456 저장 비용 청구는 배포와 함께 시작됩니다: - - 릴리스를 배포하면 해당 모델이 배포의 워커가 공유하는 네트워크 스토리지에 스테이징됩니다. 이 스토리지는 배포 후 읽기 전용이며, 해당 리전에 빌드의 배포가 하나라도 존재하는 동안에는 GB-월 단위로 청구됩니다. `comfy deploy stop`으로 배포를 일시 중지한 상태도 포함됩니다. + - 릴리스를 배포하면 해당 모델이 배포의 워커가 공유하는 네트워크 스토리지에 스테이징됩니다. 이 스토리지는 배포 후 읽기 전용이며, 해당 리전에 빌드의 배포가 하나라도 존재하는 동안에는 GB-월 단위로 청구됩니다. `comfy deploy stop`으로 배포를 일시 중지한 상태도 포함됩니다. 작업이 [워크스페이스 라이브러리](/ko/development/serverless/library-models)에서 사용하는 모델은 이곳에 스테이징되지 않습니다. 워커가 해당 작업을 위해 모델을 다운로드합니다. - 각 워커는 고정된 50 GB 컨테이너 디스크도 함께 받습니다. 이 디스크는 임시이며 워커가 실행 중일 때만 워커의 컴퓨팅 비용의 일부로 청구됩니다. - 배포를 삭제하면 해당 컴퓨팅이 해제됩니다. 스테이징된 네트워크 스토리지는 해당 리전에서 이를 사용하는 마지막 배포가 삭제된 직후 정리되고, 그에 대한 청구도 종료됩니다. @@ -150,7 +153,7 @@ comfy deploy events --deployment dep_123456 - 배포는 요청을 워커 전체에 자동으로 분산하고, 설정된 `--min` 및 `--max` 범위 내에서 확장합니다. 즉시 실행할 수 없는 요청은 대기 중으로 들어가 워커 용량이 확보되는 대로 처리됩니다. + 배포는 요청을 워커 전체에 자동으로 분산하고, 설정된 `--min` 및 `--max` 범위 내에서 확장합니다. 즉시 실행할 수 없는 요청은 대기열에 들어가 워커 용량이 확보되는 대로 처리됩니다. diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index e8baf76a28..4c382131b0 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -2,16 +2,16 @@ title: "Comfy Router 模型" sidebarTitle: "所有模型" description: "Comfy Router 提供的全部模型,按提供方分组,并列出每个模型的输入和输出模态。" -translationSourceHash: 947ab0cb +translationSourceHash: 04ecf050 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 47e9d047 + "Find by output": 2dfd8d42 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 - "BytePlus": 0ff87da0 + "BytePlus": 0767a672 "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 @@ -48,6 +48,7 @@ translationBlockHashes: + {/* 已生成文件。由 `pnpm code-pages:gen` 从 Router 目录生成。 */} 以下每个模型都由同一条路由提供服务:`POST /v2/models/{provider}/{model}`,并使用该模型自身的 JSON 请求体。每个页面都会展示在 Python、TypeScript 和 cURL 中可用的请求示例。关于模型发现、schema、错误、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api)。 @@ -109,8 +110,7 @@ translationBlockHashes: - [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code):`runway/gen4_turbo` - [Sync 3](/zh/development/comfy-router/models/synclabs/sync-3/code):`synclabs/sync-3` - [Clean Audio Video](/zh/development/comfy-router/models/veed/clean-audio-video/code):`veed/clean-audio-video` -- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0` -- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` +- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0`- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` - [Video Background Removal Fast](/zh/development/comfy-router/models/veed/video-background-removal-fast/code):`veed/video-background-removal-fast` - [Video Background Removal Green Screen](/zh/development/comfy-router/models/veed/video-background-removal-green-screen/code):`veed/video-background-removal-green-screen` - [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal` @@ -142,7 +142,7 @@ translationBlockHashes: - [Grok Imagine Video](/zh/development/comfy-router/models/xai/grok-imagine-video/code):`xai/grok-imagine-video` - + - [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code):`beeble/switchx` - [Erase V1](/zh/development/comfy-router/models/black-forest-labs/erase-v1/code):`bfl/erase-v1` @@ -164,8 +164,7 @@ translationBlockHashes: - [图像编辑:提升分辨率](/zh/development/comfy-router/models/bria/image-edit-increase-resolution/code):`bria/image-edit-increase-resolution` - [图像编辑:产品手持](/zh/development/comfy-router/models/bria/image-edit-product-holding/code):`bria/image-edit-product-holding` - [图像编辑:产品虚拟试穿](/zh/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code):`bria/image-edit-product-virtual-tryon` -- [图像编辑:重新打光](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight` -- [图像编辑:移除背景(引导)](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` +- [图像编辑:重新打光](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight`- [图像编辑:移除背景(引导)](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` - [图像编辑:移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background/code):`bria/image-edit-remove-background` - [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background` - [图像编辑:按文本替换对象](/zh/development/comfy-router/models/bria/image-edit-replace-object-by-text/code):`bria/image-edit-replace-object-by-text` @@ -177,6 +176,7 @@ translationBlockHashes: - [Seedream 5.0 260128](/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code):`byteplus/seedream-5-0-260128` - [Seedream 5.0 Flash 260915](/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code):`byteplus/seedream-5-0-flash-260915` - [Seedream 5.0 Pro 260628](/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code):`byteplus/seedream-5-0-pro-260628` +- [Seedream 5.5 261028](/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code):`byteplus/seedream-5-5-261028` - [Crystal Upscaler](/zh/development/comfy-router/models/fal/crystal-upscaler/code):`fal/crystal-upscaler` - [Patina](/zh/development/comfy-router/models/fal/patina/code):`fal/patina` - [AI Image Upscaler Precision V2](/zh/development/comfy-router/models/freepik/ai-image-upscaler-precision-v2/code):`freepik/ai-image-upscaler-precision-v2` @@ -184,7 +184,7 @@ translationBlockHashes: - [AI Skin Enhancer Faithful](/zh/development/comfy-router/models/freepik/ai-skin-enhancer-faithful/code):`freepik/ai-skin-enhancer-faithful` - [AI Skin Enhancer Flexible](/zh/development/comfy-router/models/freepik/ai-skin-enhancer-flexible/code):`freepik/ai-skin-enhancer-flexible` - [Gemini Omni 1.1 Flash](/zh/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code):`gemini-interactions/gemini-omni-1.1-flash` -- [Gemini Omni Flash Preview](/zh/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code):`gemini-interactions/gemini-omni-flash-preview` +- [Gemini Omni Flash 预览](/zh/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code):`gemini-interactions/gemini-omni-flash-preview` - [Gemini 2.5 Flash Image](/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code):`vertexai/gemini-2.5-flash-image` - [Gemini Nano Banana 2.1](/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code):`vertexai/gemini-nano-banana-2.1` - [Nano Banana 2 Lite](/zh/development/comfy-router/models/google/nano-banana-2-lite/code):`vertexai/gemini-3.1-flash-lite-image` @@ -214,8 +214,7 @@ translationBlockHashes: - [Qwen Image 3.0](/zh/development/comfy-router/models/qwen/qwen-image-3-0/code):`qwen/qwen-image-3.0` - [Recraft V2](/zh/development/comfy-router/models/recraft/recraftv2/code):`recraft/recraftv2` - [Recraft V3](/zh/development/comfy-router/models/recraft/recraftv3/code):`recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code):`recraft/recraftv4_1_pro_vector` -- [Recraft V4.1 Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-pro/code):`recraft/recraftv4_1_pro` +- [Recraft V4.1 Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code):`recraft/recraftv4_1_pro_vector`- [Recraft V4.1 Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-pro/code):`recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code):`recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code):`recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code):`recraft/recraftv4_1_utility_vector` @@ -266,8 +265,7 @@ translationBlockHashes: - [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code):`bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code):`byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128` -- [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code):`byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128`- [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code):`byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code):`byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/zh/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code):`byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/zh/development/comfy-router/models/byteplus/seed-audio-1-0/code):`byteplus/seed-audio-1.0` @@ -324,8 +322,7 @@ translationBlockHashes: - [Stable Fast 3D](/zh/development/comfy-router/models/stability/stable-fast-3d/code):`stability/stable-fast-3d` - [Stable Point Aware 3D](/zh/development/comfy-router/models/stability/stable-point-aware-3d/code):`stability/stable-point-aware-3d` - [Hunyuan 3D Part](/zh/development/comfy-router/models/tencent/hunyuan-3d-part/code):`tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology` -- [Hunyuan 3D Texture Edit](/zh/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code):`tencent/hunyuan-3d-texture-edit` +- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology`- [Hunyuan 3D Texture Edit](/zh/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code):`tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/zh/development/comfy-router/models/tencent/hunyuan-3d-uv/code):`tencent/hunyuan-3d-uv` @@ -451,23 +448,24 @@ translationBlockHashes: | 模型 | ID | 输入 | 输出 | | --- | --- | --- | --- | -| [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | `byteplus/dreamina-seedance-2-0-260128` | 文本, 图像, 视频, 音频 | 视频 + 音频 | -| [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code) | `byteplus/dreamina-seedance-2-0-fast-260128` | 文本, 图像, 视频, 音频 | 视频 + 音频 | -| [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code) | `byteplus/dreamina-seedance-2-0-mini` | 文本, 图像, 视频, 音频 | 视频 + 音频 | -| [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | `byteplus/dreamina-seedance-2-5-260628` | 文本, 图像, 视频, 音频 | 视频 + 音频 | -| [Seed 2.0 Lite 260228](/zh/development/comfy-router/models/byteplus/seed-2-0-lite-260228/code) | `byteplus/seed-2-0-lite-260228` | 文本, 图像 | 文本 | -| [Seed 2.0 Mini 260215](/zh/development/comfy-router/models/byteplus/seed-2-0-mini-260215/code) | `byteplus/seed-2-0-mini-260215` | 文本, 图像 | 文本 | -| [Seed 2.0 Pro 260328](/zh/development/comfy-router/models/byteplus/seed-2-0-pro-260328/code) | `byteplus/seed-2-0-pro-260328` | 文本, 图像 | 文本 | +| [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | `byteplus/dreamina-seedance-2-0-260128` | 文本、图像、视频、音频 | 视频 + 音频 | +| [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code) | `byteplus/dreamina-seedance-2-0-fast-260128` | 文本、图像、视频、音频 | 视频 + 音频 | +| [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code) | `byteplus/dreamina-seedance-2-0-mini` | 文本、图像、视频、音频 | 视频 + 音频 | +| [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | `byteplus/dreamina-seedance-2-5-260628` | 文本、图像、视频、音频 | 视频 + 音频 | +| [Seed 2.0 Lite 260228](/zh/development/comfy-router/models/byteplus/seed-2-0-lite-260228/code) | `byteplus/seed-2-0-lite-260228` | 文本、图像 | 文本 | +| [Seed 2.0 Mini 260215](/zh/development/comfy-router/models/byteplus/seed-2-0-mini-260215/code) | `byteplus/seed-2-0-mini-260215` | 文本、图像 | 文本 | +| [Seed 2.0 Pro 260328](/zh/development/comfy-router/models/byteplus/seed-2-0-pro-260328/code) | `byteplus/seed-2-0-pro-260328` | 文本、图像 | 文本 | | [Seed Audio 1.0 Multilingual](/zh/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code) | `byteplus/seed-audio-1.0-multilingual` | 文本 | 音频 | | [Seed Audio 1.0](/zh/development/comfy-router/models/byteplus/seed-audio-1-0/code) | `byteplus/seed-audio-1.0` | 文本 | 音频 | -| [Seedance 1.0 Pro 250528](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code) | `byteplus/seedance-1-0-pro-250528` | 文本, 图像 | 视频 | -| [Seedance 1.0 Pro Fast 251015](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code) | `byteplus/seedance-1-0-pro-fast-251015` | 文本, 图像 | 视频 | -| [Seedance 1.5 Pro 251215](/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code) | `byteplus/seedance-1-5-pro-251215` | 文本, 图像 | 视频 + 音频 | -| [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code) | `byteplus/seedream-4-0-250828` | 文本, 图像 | 图像 | -| [Seedream 4.5 251128](/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code) | `byteplus/seedream-4-5-251128` | 文本, 图像 | 图像 | -| [Seedream 5.0 260128](/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | 文本, 图像 | 图像 | -| [Seedream 5.0 Flash 260915](/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code) | `byteplus/seedream-5-0-flash-260915` | 文本, 图像 | 图像 | -| [Seedream 5.0 Pro 260628](/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 文本, 图像 | 图像 | +| [Seedance 1.0 Pro 250528](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code) | `byteplus/seedance-1-0-pro-250528` | 文本、图像 | 视频 | +| [Seedance 1.0 Pro Fast 251015](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code) | `byteplus/seedance-1-0-pro-fast-251015` | 文本、图像 | 视频 | +| [Seedance 1.5 Pro 251215](/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code) | `byteplus/seedance-1-5-pro-251215` | 文本、图像 | 视频 + 音频 | +| [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code) | `byteplus/seedream-4-0-250828` | 文本、图像 | 图像 | +| [Seedream 4.5 251128](/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code) | `byteplus/seedream-4-5-251128` | 文本、图像 | 图像 | +| [Seedream 5.0 260128](/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | 文本、图像 | 图像 | +| [Seedream 5.0 Flash 260915](/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code) | `byteplus/seedream-5-0-flash-260915` | 文本、图像 | 图像 | +| [Seedream 5.0 Pro 260628](/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 文本、图像 | 图像 | +| [Seedream 5.5 261028](/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 文本、图像 | 图像 | ## Elevenlabs diff --git a/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index 7749cc4473..00da72539f 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -2,17 +2,18 @@ title: "将 Seedream 4.0 250828 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedream-4-0-250828:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedream 4.0 250828" -translationSourceHash: a0e25650 +translationSourceHash: 0e2de27d translationFrom: development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx translationBlockHashes: "_intro": 3d37b29e "Quick start": 38e0a75b - "Schema": b45c3a02 + "Schema": 66ccdc55 "Examples": ac35d592 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-4-0-250828.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -156,8 +157,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQU ### 输入 + + 控制生成图像是否具有透明背景(alpha 通道)。seedream-5.0-pro、5.0-flash 以及自身 schema 记录了该参数的新版 Seedream 模型支持此功能。 +auto: 模型根据提示词和 output_format 决定。当 output_format 为 jpeg 时,输出始终不透明。 +transparent: 输出具有透明背景的 RGBA 图像。output_format 为 jpeg 时返回错误。 +opaque: 输出具有不透明背景的 RGB 图像。seedream-5.0-pro 的默认值。 +seedream-5.0-pro 仅在图生图场景支持透明输出,且需要一张带 alpha 通道的 png 输入图像。 +图层分离场景不支持该参数:在启用 layer_decomposition 的情况下传入该参数会返回错误。 + + 可能的值:`auto`、`transparent`、`opaque` + + - 控制输出图像与输入提示词的贴合程度。范围 [1, 10]。数值越高,对提示词的遵循越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持该参数。 + 控制输出图像与输入提示词的贴合程度。范围 [1, 10]。值越大,对提示词的遵循越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持该参数。 范围:`1` 到 `10` @@ -165,137 +177,154 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-0-250828/requests/$REQU - Seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持此参数。 + Seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持该参数。 -输入要编辑图像的 Base64 编码或可访问的 URL。seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持输入单张图像或多张图像(参见多图融合示例)。 +输入要编辑图像的 Base64 编码或可访问的 URL。Seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持输入单张图像或多张图像(参见多图融合示例)。 -• 图片网址:请确保该图片网址可访问。 +• 图片网址:确保图片网址可访问。 • Base64 编码:格式必须为 data:image/\;base64,\。注意:\ 必须为小写,例如 data:image/png;base64,\。 -Comfy Router 将整个 JSON 请求限制为 100 MiB,其中包括 base64 膨胀后的数据和所有参考图像。对于会超出此传输限制的输入,请使用 URL。 +Comfy Router 将整个 JSON 请求限制为 100 MiB,包括 base64 展开和所有参考图像。对于会超过此传输限制的输入,请使用 URL。 输入图像必须满足以下要求: • 图像格式:jpeg、png(seedream-5.0-pro、5.0-lite、4.5 和 4.0 还支持 webp、bmp、tiff 和 gif;seedream-5.0-pro 还支持 heic 和 heif) -• 宽高比(宽度/高度):对于 seedream-5.0-pro、5.0-lite、4.5 和 4.0,需在 [1/16, 16] 范围内 +• 宽高比(宽度/高度):对于 seedream-5.0-pro、5.0-lite、4.5 和 4.0,范围为 [1/16, 16] • 宽度和高度(px):> 14 • 大小:不超过 10 MB(seedream-5.0-pro 为 30 MB) -• 总像素数:对于 seedream-5.0-pro,不超过 6000x6000(36,000,000 px) -• 最多 14 张参考图像(seedream-5.0-pro 和 5.0-flash 为 10 张) +• 总像素:对于 seedream-5.0-pro,不超过 6000x6000(36,000,000 px) +• 最多 14 张参考图像(seedream-5.0-pro、5.0-flash 和 5.5 为 10 张) -在图层分离场景中(启用 layer_decomposition),image 为必填项,且仅支持单张输入图像(传入多张图像会返回错误)。输入图像必须为 png、jpeg、webp、bmp、tiff 或 gif(不支持 heic 和 heif),大小不超过 30 MB,总像素数在 [512x512, 6000x6000] 范围内,宽高比在 [1/16, 16] 范围内。 +在图层分离场景中(启用 layer_decomposition),image 为必填项,并且仅支持单张输入图像(传入多张图像会返回错误)。输入图像必须为 png、jpeg、webp、bmp、tiff 或 gif(不支持 heic 和 heif),最大 30 MB,总像素在 [512x512, 6000x6000] 范围内,宽高比在 [1/16, 16] 范围内。 - 控制是否启用图层分离。仅 seedream-5.0-pro 和 5.0-flash 支持此参数。 -true:图层分离模式。模型会将单张输入图像分解为一张基础图像加多个图层(最多 16 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 -false:标准图像生成模式;不执行图层分离。 -图层分离模式的注意事项:仅支持单张输入图像(传入多张图像会返回错误);如果任一单个图层生成失败,整个请求都会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream 会返回错误。 + 控制是否启用图层分离。仅 seedream-5.0-pro、5.0-flash 和 5.5 支持该参数。 +true: 图层分离模式。模型将单张输入图像分解为一张基础图像和多个图层(最多 16 个;在 seedream-5.5 上最多 99 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 +false: 标准图像生成模式;不执行图层分离。 +图层分离模式的注意事项:仅支持单张输入图像(传入多张图像会返回错误);如果任意单个图层生成失败,整个请求都会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。seedream-5.5 最多返回 layer_decomposition_options.max_images 张图像(1 张基础图像 + 最多 99 个图层)。如果传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream,会返回错误。 + + + + 图层分离模式的选项。仅 seedream-5.5 支持该参数,且仅在 layer_decomposition 为 true 时适用。 + + + + 此请求返回的图像总数上限,包括基础图像和所有图层。范围:[2, 100]。当提示词未说明如何拆分图像时,模型会根据 max_images 和输入图像的复杂程度规划图层;通常值越大,图层划分越精细。 + + 范围:`2` 到 `100` - 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628 和 seedream-5-0-flash-260915。直接以 v1 调用 POST /proxy/byteplus/api/v3/images/generations 时 MUST 提供该参数:代理会以 400 拒绝任何其他值,以及省略该参数的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径片段中填充它,所以 Router 调用方会省略它。 + 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915 和 seedream-5-5-261028。直接向 POST /proxy/byteplus/api/v3/images/generations 发起 v1 调用时必须提供该参数;代理会拒绝任何其他值,若省略该参数也会返回 400 错误。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略该参数。 - 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5(仅支持 standard 模式)和 seedream-4.0 支持此参数。 + 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5/5.5(仅支持 standard 模式;seedream-5.5 对 fast 返回错误)和 seedream-4.0 支持该参数。 - 设置提示词优化功能的模式。standard = 质量更高,生成时间更长。fast = 速度更快,但质量较为一般。 + 设置提示词优化功能的模式。 +standard = 质量更高,生成时间更长。 +fast = 速度更快,但质量较为一般。 - 可选值:`standard`、`fast` + 可能的值:`standard`、`fast` - 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash 和 5.0-lite 支持此参数。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 格式输出。 - - 可选值:`png`、`jpeg` + 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持该参数。seedream-5.5 默认为 png。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。 用于图像生成或转换的文本描述。 -在图层分离场景中为可选(seedream-5.0-pro 或 5.0-flash 且启用 layer_decomposition 时):如果提供了提示词,模型会根据提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将其分离为独立图层。 +在图层分离场景中为可选项(seedream-5.0-pro、5.0-flash 或启用了 layer_decomposition 的 5.5):如果提供了提示词,模型会按提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将其分离为独立图层。 指定响应中返回的已生成图像的格式 - 可选值:`url`、`b64_json` + 可能的值:`url`、`b64_json` - 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。 + 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成种子。若要复现相同的输出,请使用相同的种子值。 范围:`-1` 到 `2147483647` - 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro 和 5.0-flash 不支持)。有效值: -auto:在自动模式下,模型会根据用户提示词自动决定是否返回多张图像以及包含多少张图像。 -disabled:禁用批处理生成功能。模型将只生成一张图像。 + 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。有效值: +auto:在自动模式下,模型根据用户的提示词自动决定是否返回多张图像以及包含多少张图像。 +disabled:禁用批处理生成功能。模型将仅生成一张图像。 - 可选值:`auto`、`disabled` + 可能的值:`auto`、`disabled` - seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro 和 5.0-flash 不支持)。 -批处理图像生成功能的配置。仅当 sequential_image_generation 设置为 auto 时,此参数才会生效。 + 仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。 +批处理图像生成功能的配置。此参数仅在 sequential_image_generation 设置为 auto 时生效。 - 指定本次请求中最多生成的图像数量。输入参考图像数量 + 生成图像数量 ≤ 15。 + 指定本次请求中最多生成的图像数量。输入参考图像数量 + 生成的图像数量 ≤ 15。 范围:`1` 到 `15` - "seedream-4-0-250828":设置生成图像的规格。有两种方法可用,但不能同时使用。 + "seedream-4-0-250828":设置已生成图像的规格。有两种方法可用,但不能同时使用。 方法 1 | 指定分辨率。可选值:1K、2K、4K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素数:[1024x1024, 4096x4096],宽高比:[1/16, 16] + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] "seedream-4-5-251128":有两种方法可用。 方法 1 | 指定分辨率。可选值:2K、4K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素数:[2560x1440, 4096x4096],宽高比:[1/16, 16] + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] "seedream-5-0-260128":有两种方法可用。 方法 1 | 指定分辨率。可选值:2K、3K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素数:[2560x1440, ~3072x3072],宽高比:[1/16, 16] + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] "seedream-5-0-pro-260628":有两种方法可用(不能同时使用)。 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、2K - 方法 2 | 以像素为单位指定宽度和高度。默认值:1024x1024,总像素数:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] + 方法 2 | 以像素为单位指定宽度和高度。默认:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] "seedream-5-0-flash-260915":有两种方法可用(不能同时使用)。 - 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认值:2K - 方法 2 | 以像素为单位指定宽度和高度。总像素数:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] -启用 layer_decomposition 时的 "seedream-5-0-pro-260628" 和 "seedream-5-0-flash-260915":仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认值:auto。 - 基础图像按指定分辨率输出,并采用原始输入图像的宽高比;每个图层以接近指定分辨率输出,并保持其在原始图像中的宽高比。 - auto:根据输入图像的尺寸和宽高比进行输出。在 [1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认:2K + 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-5-261028":有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率。可选值:1K、1.5K、2K。默认:2K + 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915" 和 "seedream-5-5-261028" 在启用 layer_decomposition 时:仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认:auto。 + 基础图像按指定分辨率输出,宽高比与原始输入图像一致;每个图层按接近指定分辨率输出,并保持其在原始图像中的宽高比。 + auto:根据输入图像的尺寸和宽高比输出。在 [1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 - Comfy Router 会将显式提供的 stream 标志固定为 false,因为它捕获的是完整的 JSON 结果。在 v1 代理上,此字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro 和 5.0-flash 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像在生成后立即返回。 + Comfy Router 会将显式指定的 stream 标志固定为 false,因为它捕获的是完整的 JSON 结果。在 v1 代理上,此字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像生成后立即返回。 - 指定是否为生成的图像添加水印。false = 不添加水印,true = 添加带有 'AI generated' 标记的水印 + 指定是否为已生成的图像添加水印。false = 不添加水印,true = 添加带有“AI generated”标签的水印 -根据 Router 在 `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/byteplus/seedream-4-0-250828/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前校验调用所用的文档相同。 ### 输出 - Unix 时间戳(单位为秒),表示该请求的创建时间 + Unix 时间戳(单位:秒),表示该请求的创建时间 - 包含生成图像的相关信息。 -在图层分离场景中,数组的第一个元素是基础图像(z_index=0),后续元素是各个图层,按 z_index 递增排序。 + 包含已生成图像的信息。 +在图层分离场景中,数组的第一个元素是基础图像(z_index=0),后续元素是各个图层,按 z_index 递增的顺序排列。 - Base64 编码的图像数据(当 response_format 为 "b64_json" 时) + Base64 编码的图像数据(当 response_format 为 "b64_json" 时返回) + + + + 图像实际具有的背景类型:transparent 或 opaque。在图层分离场景中,基础图像始终为 opaque,每个图层均为 transparent。仅 seedream-5.5 返回该字段。 - 当前图层在基础图像中所占区域的边界框信息。仅图层会返回该字段;基础图像覆盖整个画布,不返回 bounding_box。仅在 layer_decomposition 为 true 时返回。 + 当前图层在基础图像中所占区域的边界框信息。仅图层返回该字段;基础图像覆盖整个画布,不返回 bounding_box。仅当 layer_decomposition 为 true 时返回。 @@ -303,33 +332,33 @@ disabled:禁用批处理生成功能。模型将只生成一张图像。 - 图层边界框的千分比量化(归一化)坐标,基于基础图像尺寸按比例映射到 [0, 1000] 的离散整数范围,最大截断至 1000。坐标格式:[left, top, right, bottom]。 + 图层边界框的千分位量化(归一化)坐标,基于基础图像尺寸按比例映射到 [0, 1000] 的离散整数区间,最大截断为 1000。坐标格式:[left, top, right, bottom]。 - 对当前分离元素的详细描述,提供比 name 更丰富的图层特征(如颜色、状态、材质)。仅图层会返回该字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + 对当前分离元素的详细描述,相比 name 提供更丰富的图层特征(如颜色、状态、材质)。仅图层返回该字段,基础图像不返回。仅当 layer_decomposition 为 true 时返回。 - 当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。仅图层会返回该字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + 当前分离元素的名称/标签,由模型根据被分离主体的特征自动生成。仅图层返回该字段,基础图像不返回。仅当 layer_decomposition 为 true 时返回。 - 输出图像的文件格式。仅 seedream-5.0-pro 支持该字段。 + 输出图像的文件格式。仅 seedream-5.0-pro 和 5.5 支持该字段。 - 图像的宽度和高度,单位为像素,格式为 \x\。仅 seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持该参数。 + 图像的宽度和高度(单位为像素),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、5.5、4.5 和 4.0 支持该参数。 - 用于下载图像的 URL(当 response_format 为 "url" 时) + 用于下载图像的 URL(当 response_format 为 "url" 时返回) - 格式: `uri` + 格式:`uri` - 图层的堆叠顺序,从下到上递增:0 是最底层的图层(基础图像),数值越大位置越高。可用它按正确的堆叠顺序将各图层重新合成为完整图像。仅在 layer_decomposition 为 true 时返回。 + 图层的堆叠顺序,自下而上递增:0 为最底层(基础图像);数值越大位置越高。可使用它按正确的堆叠顺序将各图层重新合成为完整图像。仅当 layer_decomposition 为 true 时返回。 @@ -337,15 +366,15 @@ disabled:禁用批处理生成功能。模型将只生成一张图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证与提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略系列,且不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示因内容策略而被拒绝。同一族错误码可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码用于描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应和 HTTP 200 失败任务响应中识别内容策略族错误,但不会覆盖传输层故障。 - 错误消息 + 报错信息 - 用于该请求的模型 ID + 请求所使用的模型 ID @@ -353,15 +382,15 @@ disabled:禁用批处理生成功能。模型将只生成一张图像。 - 模型生成的图像数量 + 模型已生成的图像数量 - 输入到模型的图像数量。仅 seedream-5.0-pro 支持该字段。 + 输入到模型的图像数量。仅 seedream-5.0-pro 和 5.5 支持该字段。 - 模型生成图片所消耗的 token 数量。 + 模型生成图片所使用的 token 数量。 diff --git a/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx index 4c32ad2928..683d55f04d 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx @@ -2,17 +2,18 @@ title: "将 Seedream 4.5 251128 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedream-4-5-251128:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Seedream 4.5 251128" -translationSourceHash: af20f4b5 +translationSourceHash: e47962e3 translationFrom: development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx translationBlockHashes: "_intro": 1d32bb5d "Quick start": 5ffebfad - "Schema": 23ff89f5 + "Schema": d11a7253 "Examples": 7bc7fa59 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-4-5-251128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -156,180 +157,206 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-4-5-251128/requests/$REQU ### 输入 + + 控制生成的图像是否具有透明背景(alpha 通道)。由 seedream-5.0-pro、5.0-flash 以及自身 schema 中记录了该参数的较新 Seedream 模型支持。 +auto: 模型根据提示词和 output_format 决定。当 output_format 为 jpeg 时,输出始终为不透明。 +transparent: 输出带透明背景的 RGBA 图像。output_format 为 jpeg 会返回错误。 +opaque: 输出带不透明背景的 RGB 图像。这是 seedream-5.0-pro 的默认值。 +seedream-5.0-pro 仅在图像到图像(图生图)时支持透明输出,且需要一张带 alpha 通道的 png 输入图像。 +在图层分离场景中不支持:在启用 layer_decomposition 的情况下传递该参数会返回错误。 + + 可能的值:`auto`、`transparent`、`opaque` + + - 控制输出图像与输入提示词的贴合程度。取值范围 [1, 10]。值越高,对提示词的遵循越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持此参数。 + 控制输出图像与输入提示词的对齐程度。范围为 [1, 10]。值越高,对提示词的遵循越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持此参数。 - 范围: `1` 到 `10` + 范围:`1` 到 `10` - 格式: `float` + 格式:`float` - Seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持此参数。 + seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持此参数。 -输入要编辑图像的 Base64 编码或可访问的图片网址。seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持输入单张图像或多张图像(参见多图像混合示例)。 +输入要编辑图像的 Base64 编码或可访问的 URL。seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持输入单张图像或多张图像(参见多图融合示例)。 -• 图片网址:请确保该图片网址可访问。 +• 图片网址:请确保图片网址可访问。 • Base64 编码:格式必须为 data:image/\;base64,\。注意:\ 必须为小写,例如 data:image/png;base64,\。 -Comfy Router 将整个 JSON 请求限制为 100 MiB,包括 base64 膨胀和所有参考图像。对于会超出此传输限制的输入,请使用 URL。 +Comfy Router 将整个 JSON 请求限制为 100 MiB,包括 base64 扩展和所有参考图像。对于会超过此传输限制的输入,请使用 URL。 输入图像必须满足以下要求: • 图像格式:jpeg、png(seedream-5.0-pro、5.0-lite、4.5 和 4.0 还支持 webp、bmp、tiff 和 gif;seedream-5.0-pro 还支持 heic 和 heif) -• 宽高比(宽/高):对于 seedream-5.0-pro、5.0-lite、4.5 和 4.0,取值范围为 [1/16, 16] +• 宽高比(宽度/高度):对于 seedream-5.0-pro、5.0-lite、4.5 和 4.0,范围为 [1/16, 16] • 宽度和高度(px):> 14 • 大小:不超过 10 MB(seedream-5.0-pro 为 30 MB) • 总像素:对于 seedream-5.0-pro,不超过 6000x6000(36,000,000 px) -• 最多 14 张参考图像(seedream-5.0-pro 和 5.0-flash 为 10 张) +• 最多 14 张参考图像(seedream-5.0-pro、5.0-flash 和 5.5 为 10 张) -在图层分离场景中(启用 layer_decomposition 时),image 为必填项,且仅支持单张输入图像(传入多张图像会返回错误)。输入图像必须为 png、jpeg、webp、bmp、tiff 或 gif(不支持 heic 和 heif),最大 30 MB,总像素在 [512x512, 6000x6000] 范围内,宽高比在 [1/16, 16] 范围内。 +在图层分离场景中(启用 layer_decomposition),image 为必填项,且仅支持单张输入图像(传递多张图像会返回错误)。输入图像必须为 png、jpeg、webp、bmp、tiff 或 gif(不支持 heic 和 heif),最大 30 MB,总像素在 [512x512, 6000x6000] 范围内,宽高比在 [1/16, 16] 范围内。 - 控制是否启用图层分离。仅 seedream-5.0-pro 和 5.0-flash 支持此参数。 -true:图层分离模式。模型将单张输入图像分解为一张基础图像加上多个图层(最多 16 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 -false:标准图像生成模式;不执行图层分离。 -关于图层分离模式的说明:仅支持单张输入图像(传入多张图像会返回错误);如果任意单个图层生成失败,整个请求就会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。如果传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream,会返回错误。 + 控制是否启用图层分离。仅 seedream-5.0-pro、5.0-flash 和 5.5 支持此参数。 +true: 图层分离模式。模型将单张输入图像分解为一张基础图像加上多个图层(最多 16 个;在 seedream-5.5 上最多 99 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 +false: 标准图像生成模式;不执行图层分离。 +图层分离模式说明:仅支持单张输入图像(传递多张图像会返回错误);如果任一单个图层生成失败,整个请求都会失败;不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。seedream-5.5 最多返回 layer_decomposition_options.max_images 张图像(1 张基础图像 + 最多 99 个图层)。如果传递 sequential_image_generation、sequential_image_generation_options、tools 和 stream,会返回错误。 + + + + 图层分离模式的选项。仅 seedream-5.5 支持此参数,并且仅在 layer_decomposition 为 true 时适用。 + + + + 此请求返回的图像总数上限,即基础图像和图层合计。范围:[2, 100]。当提示词未说明如何拆分图像时,模型会根据 max_images 和输入图像的复杂程度规划图层;值越大,通常图层越细。 + + 范围:`2` 到 `100` - 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628 和 seedream-5-0-flash-260915。直接向 POST /proxy/byteplus/api/v3/images/generations 发起 v1 调用时必须提供该参数:代理会拒绝任何其他值,若省略该参数则返回 400。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 + 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915 和 seedream-5-5-261028。直接向 POST /proxy/byteplus/api/v3/images/generations 发起 v1 调用时,必须提供该参数;代理会以 400 拒绝任何其他值以及省略该参数的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 - 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5(仅支持 standard 模式)和 seedream-4.0 支持此参数。 + 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5/5.5(仅支持 standard 模式;seedream-5.5 对 fast 返回错误)和 seedream-4.0 支持此参数。 - 设置提示词优化功能的模式。standard = 更高质量、更长的生成时间。fast = 更快,但质量更普通。 + 设置提示词优化功能的模式。standard = 质量更高,生成时间更长。fast = 速度更快,但质量更平均。 - 可选值:`standard`、`fast` + 可能的值:`standard`、`fast` - 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash 和 5.0-lite 支持此参数。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。 - - 可选值:`png`、`jpeg` + 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持此参数。seedream-5.5 默认为 png。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。Possible values: `png`、`jpeg` - 用于图像生成或变换的文本描述。 -在图层分离场景中为可选项(seedream-5.0-pro 或 5.0-flash 并启用 layer_decomposition 时):如果提供了 prompt,模型会按照提示词意图识别并分离你指定的元素;如果未提供 prompt,模型会自动检测图像中的所有主要元素,并将它们分离为独立的图层。 + 用于图像生成或转换的文本描述。 +在图层分离场景中为可选(seedream-5.0-pro、5.0-flash 或启用 layer_decomposition 的 5.5):如果提供了提示词,模型会根据提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将其分离为独立图层。 - 指定响应中返回的已生成图像的格式 + 指定响应中返回的已生成图像的格式。 - 可选值:`url`、`b64_json` + Possible values: `url`、`b64_json` - 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。 + 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。若要复现相同输出,请使用相同的种子值。 范围:`-1` 到 `2147483647` - 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro 或 5.0-flash 不支持)。有效值: + 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。有效值: auto:在自动模式下,模型会根据用户的提示词自动决定是否返回多张图像以及包含多少张图像。 disabled:禁用批处理生成功能。模型将只生成一张图像。 - 可选值:`auto`、`disabled` + Possible values: `auto`、`disabled` - 仅 seedream-5.0-lite、4.5 和 4.0 支持该参数(seedream-5.0-pro 或 5.0-flash 不支持)。 -批量图像生成功能的配置。仅当 sequential_image_generation 设置为 auto 时,该参数才会生效。 + 仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。 +批处理图像生成功能的配置。此参数仅在 sequential_image_generation 设置为 auto 时生效。 - 指定本次请求最多生成的图像数量。输入参考图像数量 + 生成图像数量 ≤ 15。 + 指定本次请求中生成图像的最大数量。输入参考图像数量 + 生成图像数量 ≤ 15。 - 范围:`1` 至 `15` + 范围:`1` 到 `15` - "seedream-4-0-250828":设置生成图像的规格。有两种方式可用,但不能同时使用。 - 方式 1 | 指定分辨率。可选值:1K、2K、4K - 方式 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] -"seedream-4-5-251128":有两种方式可用。 - 方式 1 | 指定分辨率。可选值:2K、4K - 方式 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] -"seedream-5-0-260128":有两种方式可用。 - 方式 1 | 指定分辨率。可选值:2K、3K - 方式 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] -"seedream-5-0-pro-260628":有两种方式可用(不能同时使用)。 - 方式 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、2K - 方式 2 | 以像素为单位指定宽度和高度。默认值:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] -"seedream-5-0-flash-260915":有两种方式可用(不能同时使用)。 - 方式 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认值:2K - 方式 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] -启用 layer_decomposition 的 "seedream-5-0-pro-260628" 和 "seedream-5-0-flash-260915":仅支持分辨率级别的方式。可选值:1K、1.5K、2K、auto。默认值:auto。 - 基础图像按指定分辨率输出,并保持原始输入图像的宽高比;每个图层则按接近指定分辨率的大小输出,同时保持其在原始图像中的宽高比。 - auto:根据输入图像的尺寸和宽高比进行输出。[1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 + "seedream-4-0-250828":设置已生成图像的规格。有两种方法可用,但不能同时使用。 + 方法 1 | 指定分辨率。可选值:1K、2K、4K + 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] +"seedream-4-5-251128":有两种方法可用。 + 方法 1 | 指定分辨率。可选值:2K、4K + 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] +"seedream-5-0-260128":有两种方法可用。 + 方法 1 | 指定分辨率。可选值:2K、3K + 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] +"seedream-5-0-pro-260628":有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、2K + 方法 2 | 以像素为单位指定宽度和高度。默认值:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] +"seedream-5-0-flash-260915":有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认值:2K + 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-5-261028":有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率。可选值:1K、1.5K、2K。默认值:2K + 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915" 和 "seedream-5-5-261028" 在启用 layer_decomposition 时:仅支持分辨率级方法。可选值:1K、1.5K、2K、auto。默认值:auto。 + 基础图像按指定分辨率输出,并保持原始输入图像的宽高比;每个图层输出时接近指定分辨率,并保持其在原始图像中的宽高比。 + auto:根据输入图像的尺寸和宽高比进行输出。在 [1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 - Comfy Router 会将显式传入的 stream 标志确定为 false,因为它捕获的是完整的 JSON 结果。在 v1 代理上,该字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持该参数(seedream-5.0-pro 或 5.0-flash 不支持)。false = 一次性返回所有输出图像。true = 每个输出图像在生成后立即返回。 + Comfy Router 会将显式提供的 stream 标志固定为 false,因为它会捕获完整的 JSON 结果。在 v1 代理上,此字段控制是否启用流式输出模式。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像在生成后立即返回。 - 指定是否为生成图像添加水印。false = 不添加水印,true = 添加带有"AI generated"标记的水印 + 指定是否为已生成图像添加水印。false = 不添加水印,true = 添加带“AI generated”标识的水印 -根据 schema 生成,Router 在 `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json` 提供该 schema,并在请求到达提供商之前用它来校验调用。 +根据 Router 在 `GET /v2/models/byteplus/seedream-4-5-251128/openapi.json` 提供的 schema 生成,这与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 - Unix 时间戳(以秒为单位),表示请求的创建时间 + Unix 时间戳(单位:秒),表示请求创建的时间 包含已生成图像的信息。 -在图层分离场景中,数组的第一个元素是基础图像(z_index=0),后续元素是各图层,按 z_index 递增顺序排列。 +在图层分离场景中,数组的第一个元素是基础图像(z_index=0),后续元素是图层,按 z_index 递增排序。 Base64 编码的图像数据(当 response_format 为 "b64_json" 时) + + 图像实际具有的背景类型:transparent 或 opaque。在图层分离场景中,基础图像始终为 opaque,每个图层均为 transparent。仅 seedream-5.5 返回此字段。 + + - 当前图层在基础图像中所占区域的边界框信息。只有图层会返回此字段;基础图像覆盖整个画布,不返回 bounding_box。仅在 layer_decomposition 为 true 时返回。 + 当前图层在基础图像中所占据区域的边界框信息。仅图层返回此字段;基础图像覆盖整个画布,不返回 bounding_box。仅在 layer_decomposition 为 true 时返回。 - 图层边界框的绝对像素坐标,位于输出基础图像的坐标系中,以左上角为 (0, 0)。坐标格式:[left, top, right, bottom]。 + 图层边界框的绝对像素坐标,位于输出基础图像的坐标系中,左上角为 (0, 0)。坐标格式:[left, top, right, bottom]。 - 图层边界框的千分位量化(归一化)坐标,根据基础图像尺寸按比例映射到 [0, 1000] 的离散整数范围,最大截断为 1000。坐标格式:[left, top, right, bottom]。 + 图层边界框的千分位量化(归一化)坐标,根据基础图像尺寸按比例映射到 [0, 1000] 的离散整数范围,最大值截断为 1000。坐标格式:[left, top, right, bottom]。 - 当前分离元素的详细描述,相比 name 提供更丰富的图层特征(如颜色、状态、材质)。只有图层会返回此字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + 当前分离元素的详细描述,相比 name 提供更丰富的图层特征(例如颜色、状态、材质)。仅图层返回此字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 - 当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。只有图层会返回此字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + 当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。仅图层返回此字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 - 输出图像的文件格式。仅 seedream-5.0-pro 支持此字段。 + 输出图像的文件格式。仅 seedream-5.0-pro 和 5.5 支持此字段。 - 图像的宽度和高度,单位为像素,格式为 \x\。仅 seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持此参数。 + 图像的宽度和高度(像素),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、5.5、4.5 和 4.0 支持此参数。 - 图像下载 URL(当 response_format 为 "url" 时) + 用于下载图像的 URL(当 response_format 为 "url" 时) 格式:`uri` - 图层的堆叠顺序,自下而上递增:0 是最底层(基础图像);值越大位置越高。可按正确的堆叠顺序将各图层重新合成为完整图像。仅在 layer_decomposition 为 true 时返回。 + 图层的堆叠顺序,自下而上递增:0 为最底层(基础图像);数值越大位置越高。使用它按正确的堆叠顺序将图层重新合成为完整图像。仅在 layer_decomposition 为 true 时返回。 @@ -337,7 +364,7 @@ disabled:禁用批处理生成功能。模型将只生成一张图像。 - 上游 ModelArk 错误代码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他代码描述验证和提供商故障。Router 会识别 HTTP 400 错误响应和 HTTP 200 失败任务响应中的策略系列,且不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个错误码系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证和提供商失败。Router 会在 HTTP 400 错误响应包和 HTTP 200 失败任务响应中识别策略错误码系列,而不会覆盖传输失败。 @@ -345,7 +372,7 @@ disabled:禁用批处理生成功能。模型将只生成一张图像。 - 用于该请求的模型 ID + 用于请求的模型 ID @@ -353,15 +380,15 @@ disabled:禁用批处理生成功能。模型将只生成一张图像。 - 模型已生成的图像数量 + 模型生成的图像数量 - 输入到模型的图像数量。仅 seedream-5.0-pro 支持此字段。 + 输入到模型的图像数量。仅 seedream-5.0-pro 和 5.5 支持此字段。 - 模型生成图片所使用的 token 数量。 + 模型生成图像所使用的 token 数量。 diff --git a/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx index f4d57bc6b7..7611badeee 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx @@ -2,17 +2,18 @@ title: "结合 Comfy Router 使用 Seedream 5.0 260128" description: "通过 Comfy Router 调用 byteplus/seedream-5-0-260128:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedream 5.0 260128" -translationSourceHash: 732cb981 +translationSourceHash: 48855510 translationFrom: development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx translationBlockHashes: "_intro": 38b28b26 "Quick start": c2f3039d - "Schema": 9f3bcfd2 + "Schema": be3a6de7 "Examples": b387e011 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -156,8 +157,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-260128/requests/$REQU ### 输入 + + 控制生成的图像是否具有透明背景(alpha 通道)。支持该参数的有 seedream-5.0-pro、5.0-flash 以及自身 schema 中记录了该参数的较新 Seedream 模型。 +auto: 模型根据提示词和 output_format 决定。使用 output_format jpeg 时,输出始终为不透明。 +transparent: 输出具有透明背景的 RGBA 图像。output_format jpeg 会返回错误。 +opaque: 输出具有不透明背景的 RGB 图像。为 seedream-5.0-pro 的默认值。 +seedream-5.0-pro 仅支持图生图的透明输出,且需要一张带 alpha 通道的 png 输入图像。 +在图层分离场景中不支持:启用 layer_decomposition 时传入该参数会返回错误。 + + 可能的值:`auto`、`transparent`、`opaque` + + - 控制输出图像与输入提示词的对齐程度。范围 [1, 10]。数值越高,提示词遵循度越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持该参数。 + 控制输出图像与输入提示词的对齐程度。范围为 [1, 10]。值越高,对提示词的遵循程度越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持该参数。 范围:`1` 到 `10` @@ -165,14 +177,14 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-260128/requests/$REQU - seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持该参数。 + Seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持该参数。 -输入要编辑图像的 Base64 编码或可访问的 URL。seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持输入单张图像或多张图像(参见多图融合示例)。 +输入要编辑图像的 Base64 编码或可访问的 URL。Seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持输入单张或多张图像(参见多图混合示例)。 -• 图像 URL:确保该图像 URL 可以访问。 +• 图片网址:确保图片网址可访问。 • Base64 编码:格式必须为 data:image/\;base64,\。注意:\ 必须为小写,例如 data:image/png;base64,\。 -Comfy Router 将整个 JSON 请求限制为 100 MiB,包括 base64 膨胀后的体积以及所有参考图像。对于会超出该传输限制的输入,请使用 URL。 +Comfy Router 将整个 JSON 请求限制为 100 MiB,包括 base64 膨胀和所有参考图像。对于会超出此传输限制的输入,请使用 URL。 输入图像必须满足以下要求: • 图像格式:jpeg、png(seedream-5.0-pro、5.0-lite、4.5 和 4.0 还支持 webp、bmp、tiff 和 gif;seedream-5.0-pro 还支持 heic 和 heif) @@ -180,164 +192,182 @@ Comfy Router 将整个 JSON 请求限制为 100 MiB,包括 base64 膨胀后的 • 宽度和高度(px):> 14 • 大小:不超过 10 MB(seedream-5.0-pro 为 30 MB) • 总像素:对于 seedream-5.0-pro,不超过 6000x6000(36,000,000 px) -• 最多 14 张参考图像(seedream-5.0-pro 和 5.0-flash 为 10 张) +• 参考图像最多 14 张(seedream-5.0-pro、5.0-flash 和 5.5 为 10 张) 在图层分离场景中(启用 layer_decomposition),image 为必填项,且仅支持单张输入图像(传入多张图像会返回错误)。输入图像必须为 png、jpeg、webp、bmp、tiff 或 gif(不支持 heic 和 heif),最大 30 MB,总像素在 [512x512, 6000x6000] 范围内,宽高比在 [1/16, 16] 范围内。 - 控制是否启用图层分离。仅 seedream-5.0-pro 和 5.0-flash 支持该参数。 -true:图层分离模式。模型将单张输入图像分解为一张基础图像加多个图层(最多 16 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 -false:标准图像生成模式;不执行图层分离。 -关于图层分离模式的说明:仅支持单张输入图像(传入多张图像会返回错误);如果任何一个图层生成失败,整个请求都会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。如果传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream,会返回错误。 + 控制是否启用图层分离。仅 seedream-5.0-pro、5.0-flash 和 5.5 支持该参数。 +true: 图层分离模式。模型将单张输入图像分解为一张基础图像加多个图层(最多 16 个;在 seedream-5.5 上最多 99 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 +false: 标准图像生成模式;不执行图层分离。 +图层分离模式说明:仅支持单张输入图像(传入多张图像会返回错误);只要有任何单个图层生成失败,整个请求就会失败:不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。seedream-5.5 最多返回 layer_decomposition_options.max_images 张图像(1 张基础图像 + 最多 99 个图层)。如果传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream,会返回错误。 + + + + 图层分离模式的选项。仅 seedream-5.5 支持该参数,且仅在 layer_decomposition 为 true 时生效。 + + + + 此请求返回的图像总数上限,即基础图像和图层加在一起的总数。范围:[2, 100]。当提示词未说明如何拆分图像时,模型会根据 max_images 和输入图像的复杂程度规划图层;值越大,通常图层划分越细。 + + 范围:`2` 到 `100` - 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628 和 seedream-5-0-flash-260915。直接以 v1 方式调用 POST /proxy/byteplus/api/v3/images/generations 时必须提供该参数,代理会拒绝任何其他值,省略该参数也会以 400 拒绝。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方可以省略。 + 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915 和 seedream-5-5-261028。直接向 POST /proxy/byteplus/api/v3/images/generations 发起 v1 调用时必须提供它:代理会拒绝任何其他值以及省略该值的情况,并返回 400。它并不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5(仅支持 standard 模式)和 seedream-4.0 支持该参数。 + 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5/5.5(仅支持 standard 模式;seedream-5.5 在 fast 模式下会返回错误)以及 seedream-4.0 支持该参数。 - 设置提示词优化功能的模式。standard = 质量更高,生成时间更长。fast = 速度更快,但质量较为一般。 + 设置提示词优化功能的模式。standard = 更高质量、更长的生成时间。fast = 更快,但质量更一般。 - 可选值:`standard`、`fast` + 可能的值:`standard`、`fast` - 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash 和 5.0-lite 支持该参数。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 格式输出。 + 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持该参数。seedream-5.5 默认使用 png。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。 + - 可选值:`png`、`jpeg` + Possible values: `png`, `jpeg` - 用于图像生成或变换的文本描述。 -在图层分离场景中为可选(seedream-5.0-pro 或 5.0-flash 且启用 layer_decomposition 时):如果提供了提示词,模型会按照提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将它们分离为独立图层。 + 用于图像生成或图像变换的文本描述。 +在图层分离场景中为可选参数(启用 layer_decomposition 的 seedream-5.0-pro、5.0-flash 或 5.5):如果提供了提示词,模型会根据提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将其分离为独立图层。 指定响应中返回的已生成图像的格式 - 可选值:`url`、`b64_json` + 可能的值:`url`、`b64_json` - 用于控制图像生成随机性的种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。 + 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。 - 范围:`-1` 到 `2147483647` + 范围:`-1` 至 `2147483647` - 控制是否禁用批处理生成功能。该参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro 或 5.0-flash 不支持)。有效值: -auto:在自动模式下,模型会根据用户的提示词自动判断是否返回多张图像以及包含多少张图像。 -disabled:禁用批处理生成功能。模型将只生成一张图像。 + 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。有效值: +auto: 在自动模式下,模型会根据用户的提示词自动判断是否返回多张图像以及包含多少张图像。 +disabled: 禁用批处理生成功能。模型只会生成一张图像。 - 可选值:`auto`、`disabled` + 可能的值:`auto`、`disabled` - seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro 和 5.0-flash 不支持)。 -批处理图像生成功能的配置。仅当 sequential_image_generation 设为 auto 时,此参数才生效。 + 仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。 +批处理图像生成功能的配置。此参数仅在 sequential_image_generation 设置为 auto 时生效。 - 指定本次请求中最多可生成的图像数量。输入参考图像数量 + 已生成图像数量 ≤ 15。 + 指定本次请求中最多生成的图像数量。输入参考图像数量 + 已生成图像数量 ≤ 15。 - 范围:`1` 到 `15` + 范围:`1` 至 `15` - "seedream-4-0-250828":设置已生成图像的规格。有两种方法可用,但不能同时使用。 + "seedream-4-0-250828":设置已生成图像的规格。有两种可用方法,但不能同时使用。 方法 1 | 指定分辨率。可选值:1K、2K、4K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] -"seedream-4-5-251128":有两种方法可用。 + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] +"seedream-4-5-251128":有两种可用方法。 方法 1 | 指定分辨率。可选值:2K、4K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] -"seedream-5-0-260128":有两种方法可用。 + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] +"seedream-5-0-260128":有两种可用方法。 方法 1 | 指定分辨率。可选值:2K、3K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] -"seedream-5-0-pro-260628":有两种方法可用(不能同时使用)。 + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] +"seedream-5-0-pro-260628":有两种可用方法(不能同时使用)。 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、2K - 方法 2 | 以像素为单位指定宽度和高度。默认值:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] -"seedream-5-0-flash-260915":有两种方法可用(不能同时使用)。 - 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认值:2K + 方法 2 | 以像素为单位指定宽度和高度。默认:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] +"seedream-5-0-flash-260915":有两种可用方法(不能同时使用)。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认:2K 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] -启用 layer_decomposition 时的 "seedream-5-0-pro-260628" 和 "seedream-5-0-flash-260915":仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认值:auto。 - 基础图像按指定分辨率输出,并保持原始输入图像的宽高比;每个图层输出的分辨率接近指定分辨率,并保持其在原始图像中的宽高比。 - auto:根据输入图像的尺寸和宽高比进行输出。[1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 +"seedream-5-5-261028":有两种可用方法(不能同时使用)。 + 方法 1 | 指定分辨率。可选值:1K、1.5K、2K。默认:2K + 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915" 和 "seedream-5-5-261028" 启用 layer_decomposition 时:仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认:auto。 + 基础图像以指定分辨率输出,并保持原始输入图像的宽高比;每个图层以接近指定分辨率输出,并保持其在原始图像中的宽高比。 + auto: 输出基于输入图像的尺寸和宽高比。位于 [1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 - Comfy Router 会将显式提供的 stream 标志固定为 false,因为它捕获的是完整的 JSON 结果。在 v1 代理上,此字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro 和 5.0-flash 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像在生成后立即返回。 + Comfy Router 会将显式传入的 stream 标志固定为 false,因为它捕获的是完整的 JSON 结果。在 v1 代理上,此字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像在生成后立即返回。 - 指定是否为已生成图像添加水印。false = 无水印,true = 添加带有 'AI generated' 标签的水印 + 指定是否在已生成的图像上添加水印。false = 不添加水印,true = 添加带有 'AI generated' 标记的水印 -根据 Router 在 `GET /v2/models/byteplus/seedream-5-0-260128/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。 +本页内容由 Router 在 `GET /v2/models/byteplus/seedream-5-0-260128/openapi.json` 处提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 - Unix 时间戳(以秒为单位),表示请求创建的时间 + 用于表示请求创建时间的 Unix 时间戳(单位为秒) 包含已生成图像的相关信息。 -在图层分离场景中,数组的第一个元素是基础图像(z_index=0),后续元素是按 z_index 递增排序的图层。 +在图层分离场景下,数组的第一个元素是底图(z_index=0),随后的元素是各个图层,按 z_index 递增的顺序排列。 - Base64 编码的图像数据(当 response_format 为 "b64_json" 时) + Base64 编码的图像数据(当 response_format 为 "b64_json" 时返回) + + + + 图像实际具有的背景类型:transparent 或 opaque。在图层分离场景下,底图始终为 opaque,每个图层均为 transparent。仅 seedream-5.5 返回该字段。 - 当前图层在基础图像中所占据区域的边界框信息。仅图层会返回此字段;基础图像覆盖整个画布,因此不返回 bounding_box。仅在 layer_decomposition 为 true 时返回。 + 当前图层在底图中所占区域的边界框信息。仅图层返回该字段;底图覆盖整个画布,不返回 bounding_box。仅在 layer_decomposition 为 true 时返回。 - 图层边界框的绝对像素坐标,采用输出基础图像的坐标系,左上角为 (0, 0)。坐标格式:[left, top, right, bottom]。 + 图层边界框的绝对像素坐标,采用输出底图的坐标系,左上角为 (0, 0)。坐标格式为:[left, top, right, bottom]。 - 图层边界框的千分位量化(归一化)坐标,依据基础图像尺寸按比例映射到 [0, 1000] 的离散整数区间,最大截断值为 1000。坐标格式:[left, top, right, bottom]。 + 图层边界框的千分位量化(归一化)坐标,以底图尺寸为基础按比例映射到 [0, 1000] 的离散整数区间,最大截断为 1000。坐标格式为:[left, top, right, bottom]。 - 当前分离元素的详细描述,相比 name 提供更丰富的图层特征信息(如颜色、状态、材质)。仅图层会返回此字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + 对当前分离元素的详细描述,相比 name 提供更丰富的图层特征(如颜色、状态、材质)。仅图层返回该字段;底图不返回。仅在 layer_decomposition 为 true 时返回。 - 当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。仅图层会返回此字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + 当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。仅图层返回该字段;底图不返回。仅在 layer_decomposition 为 true 时返回。 - 输出图像的文件格式。仅 seedream-5.0-pro 支持此字段。 + 输出图像的文件格式。仅 seedream-5.0-pro 和 5.5 支持该字段。 - 图像的宽度和高度(以像素为单位),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持此参数。 + 图像的宽度和高度(单位:像素),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、5.5、4.5 和 4.0 支持该参数。 - 用于下载图像的 URL(当 response_format 为 "url" 时) + 用于图像下载的 URL(当 response_format 为 "url" 时返回) - 格式:`uri` + Format: `uri` - 图层的堆叠顺序,从下到上递增:0 是最底层(基础图像);数值越大位置越高。可使用它按正确的堆叠顺序将各图层重新合成为完整图像。仅在 layer_decomposition 为 true 时返回。 + 图层的堆叠顺序,自下而上递增:0 为最底层(底图);数值越大层级越高。可用它按正确的堆叠顺序将图层重新合成为完整图像。仅在 layer_decomposition 为 true 时返回。 - 错误信息(如有) + 错误信息(若有) - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,并非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应体和 HTTP 200 失败任务响应中识别内容策略错误族,同时不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某一家族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应体和 HTTP 200 失败任务响应中识别策略家族,但不会覆盖传输层故障。 @@ -345,7 +375,7 @@ disabled:禁用批处理生成功能。模型将只生成一张图像。 - 用于请求的模型 ID + 用于本次请求的模型 ID @@ -353,15 +383,15 @@ disabled:禁用批处理生成功能。模型将只生成一张图像。 - 模型已生成图像的数量 + 模型已生成的图像数量 - 输入到模型的图像数量。仅 seedream-5.0-pro 支持此字段。 + 输入模型的图像数量。仅 seedream-5.0-pro 和 5.5 支持该字段。 - 模型已生成图片所使用的 token 数量。 + 模型生成图片所使用的 token 数量。 diff --git a/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx index 3edabb9f7c..104585e46e 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx @@ -2,15 +2,16 @@ title: "将 Seedream 5.0 Flash 260915 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedream-5-0-flash-260915:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedream 5.0 Flash 260915" -translationSourceHash: 7d74243a +translationSourceHash: 114a5dd9 translationFrom: development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx translationBlockHashes: "_intro": a1b4c447 "Quick start": 4f86c636 - "Schema": dab50eaf + "Schema": c220d381 "Examples": 36f49088 --- + {/* 已生成的文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedream-5-0-flash-260915.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -152,130 +153,158 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-flash-260915/requests ## Schema -### 输入 +### Input + + + 控制生成的图像是否具有透明背景(alpha 通道)。seedream-5.0-pro、5.0-flash 以及自身 schema 中记录了该参数的较新 Seedream 模型支持此参数。 +auto: 由模型根据提示词和 output_format 决定。当 output_format 为 jpeg 时,输出始终为不透明。 +transparent: 输出背景透明的 RGBA 图像。output_format 为 jpeg 时会返回错误。 +opaque: 输出背景不透明的 RGB 图像。这是 seedream-5.0-pro 的默认值。 +seedream-5.0-pro 仅在图生图场景下支持透明输出,且需要一张带 alpha 通道的 png 输入图像。 +图层分离场景不支持该参数:在启用 layer_decomposition 的情况下传入它会返回错误。 + + 可能的值:`auto`、`transparent`、`opaque` + - 控制输出图像与输入提示词的贴合程度。范围 [1, 10]。数值越高,提示词遵循度越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持该参数。 + 控制输出图像与输入提示词的对齐程度。范围为 [1, 10]。取值越大,对提示词的遵循程度越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持此参数。 - Range: `1` to `10` + 范围:`1` 到 `10` - Format: `float` + 格式:`float` - 要编辑的一张或多张图像,可以是可访问的 URL,也可以是带 data-URI 前缀的 Base64 数据。除参考图像上限外,与共享的 Seedream 字段完全相同:该模型的上限为 10,而不是 14。 + 要编辑的一张或多张图像,可以是可访问的 URL,也可以是带 data-URI 前缀的 Base64 数据。除参考图数量上限外,与 Seedream 的共享字段完全一致:本模型的上限为 10,而非 14。 - 控制是否启用图层分离。仅 seedream-5.0-pro 和 5.0-flash 支持该参数。 -true:图层分离模式。模型将单张输入图像分解为一张基础图像加多个图层(最多 16 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 -false:标准图像生成模式,不执行图层分离。 -关于图层分离模式的说明:仅支持单张输入图像(传入多张图像会返回错误);只要有任何单个图层生成失败,整个请求就会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream 会返回错误。 + 控制是否启用图层分离。仅 seedream-5.0-pro、5.0-flash 和 5.5 支持此参数。 +true: 图层分离模式。模型会把单张输入图像分解为一张基础图像加多个图层(最多 16 个;seedream-5.5 上最多 99 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 +false: 标准图像生成模式,不执行图层分离。 +关于图层分离模式的说明:仅支持单张输入图像(传入多张图像会返回错误);只要有任一图层生成失败,整个请求就会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。seedream-5.5 最多返回 layer_decomposition_options.max_images 张图像(1 张基础图像 + 最多 99 个图层)。如果传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream,会返回错误。 + + + + 图层分离模式的选项。仅 seedream-5.5 支持此参数,且仅在 layer_decomposition 为 true 时生效。 + + + + 本次请求返回的图像总数量上限,即基础图像与图层之和。范围:[2, 100]。当提示词未说明如何拆分图像时,模型会根据 max_images 和输入图像的复杂程度来规划图层;取值越大,通常图层划分越精细。 + + 范围:`2` 到 `100` - 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628 和 seedream-5-0-flash-260915。直接对 POST /proxy/byteplus/api/v3/images/generations 发起 v1 调用时必须提供该参数:代理会拒绝任何其他值,省略该参数也会返回 400。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915 和 seedream-5-5-261028。直接向 POST /proxy/byteplus/api/v3/images/generations 发起 v1 调用时必须提供它,代理会以 400 拒绝任何其他取值以及缺省的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方无需传入。 - 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5(仅支持 standard 模式)和 seedream-4.0 支持该参数。 + 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5/5.5(仅支持 standard 模式;seedream-5.5 传入 fast 会返回错误)和 seedream-4.0 支持此参数。 设置提示词优化功能的模式。standard = 质量更高,生成时间更长。fast = 速度更快,但质量较为一般。 - Possible values: `standard`, `fast` + 可能的值:`standard`、`fast` - 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash 和 5.0-lite 支持该参数。在图层分离场景中,output_format 只控制基础图像的格式;每个图层始终以 png 格式输出。 + 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持此参数。seedream-5.5 默认为 png。在图层分离场景下,output_format 只控制基础图像的格式;每个图层始终以 png 输出。 - Possible values: `png`, `jpeg` + 可能的值:`png`、`jpeg` 用于图像生成或变换的文本描述。 -在图层分离场景(启用 layer_decomposition 的 seedream-5.0-pro 或 5.0-flash)中为可选:如果提供了提示词,模型会按照提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将它们分离为独立图层。 +在图层分离场景下为可选项(seedream-5.0-pro、5.0-flash 或 5.5 且启用 layer_decomposition 时):如果提供了提示词,模型会按照提示词意图识别并分离你指定的元素;如果没有提供提示词,模型会自动检测图像中的所有主要元素并将其分离为独立图层。 指定响应中返回的已生成图像的格式 - Possible values: `url`, `b64_json` + 可能的值:`url`、`b64_json` 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。 - Range: `-1` to `2147483647` + 范围:`-1` 到 `2147483647` - 控制是否禁用批处理生成功能。该参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro 和 5.0-flash 不支持)。有效值: -auto:在自动模式下,模型会根据用户的提示词自动判断是否返回多张图像以及包含多少张图像。 -disabled:禁用批处理生成功能。模型只会生成一张图像。 + 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。有效取值:auto: 在自动模式下,模型会根据用户的提示词自动判断是否返回多张图像以及包含几张图像。 +disabled: 禁用批处理生成功能。模型只会生成一张图像。 - Possible values: `auto`, `disabled` + 可能的值:`auto`、`disabled` - 仅 seedream-5.0-lite、4.5 和 4.0 支持该参数(seedream-5.0-pro 和 5.0-flash 不支持)。 -批处理图像生成功能的配置。该参数仅在 sequential_image_generation 设置为 auto 时生效。 + 仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。 +批处理图像生成功能的配置。仅当 sequential_image_generation 设为 auto 时此参数才生效。 - 指定本次请求中要生成的最大图像数量。输入参考图像数量 + 生成图像数量 ≤ 15。 + 指定本次请求中最多生成的图像数量。输入参考图像数量 + 已生成图像数量 ≤ 15。 - Range: `1` to `15` + 范围:`1` 至 `15` - "seedream-4-0-250828":设置生成图像的规格。有两种方法可用,但不能同时使用。 + "seedream-4-0-250828":设置生成图像的规格。提供两种方法,但不能同时使用。 方法 1 | 指定分辨率。可选值:1K、2K、4K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] -"seedream-4-5-251128":有两种方法可用。 + 方法 2 | 以像素指定宽度和高度。默认:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] +"seedream-4-5-251128":提供两种方法。 方法 1 | 指定分辨率。可选值:2K、4K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] -"seedream-5-0-260128":有两种方法可用。 + 方法 2 | 以像素指定宽度和高度。默认:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] +"seedream-5-0-260128":提供两种方法。 方法 1 | 指定分辨率。可选值:2K、3K - 方法 2 | 以像素为单位指定宽度和高度。默认值:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16]"seedream-5-0-pro-260628":有两种方法可用(不能同时使用)。 + 方法 2 | 以像素指定宽度和高度。默认:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] +"seedream-5-0-pro-260628":提供两种方法(不能同时使用)。 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、2K - 方法 2 | 以像素为单位指定宽度和高度。默认值:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] -"seedream-5-0-flash-260915":有两种方法可用(不能同时使用)。 - 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认值:2K - 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] -"seedream-5-0-pro-260628" 和 "seedream-5-0-flash-260915" 在启用 layer_decomposition 时:仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认值:auto。 - 基础图像按指定分辨率输出,并保持原始输入图像的宽高比;每个图层则以接近指定分辨率的大小输出,并保持它在原始图像中的宽高比。 - auto:输出基于输入图像的尺寸和宽高比。[1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 + 方法 2 | 以像素指定宽度和高度。默认:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] +"seedream-5-0-flash-260915":提供两种方法(不能同时使用)。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认:2K + 方法 2 | 以像素指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-5-261028":提供两种方法(不能同时使用)。 + 方法 1 | 指定分辨率。可选值:1K、1.5K、2K。默认:2K + 方法 2 | 以像素指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915" 和 "seedream-5-5-261028" 在启用 layer_decomposition 时:仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认:auto。 + 基础图像按指定分辨率输出,并保持原始输入图像的宽高比;每个图层输出的尺寸接近指定分辨率,并保持其在原始图像中的宽高比。 + auto:根据输入图像的尺寸和宽高比输出。处于 [1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 - Comfy Router 会将显式提供的 stream 标志判定为 false,因为它捕获的是完整的 JSON 结果。在 v1 代理上,该字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro 或 5.0-flash 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像在生成之后立即返回。 + 由于 Comfy Router 会获取完整的 JSON 结果,因此会将显式传入的 stream 标志固定为 false。在 v1 代理上,此字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像生成后立即返回。 - 指定是否为已生成的图像添加水印。false = 不添加水印,true = 添加带有 “AI generated” 标签的水印 + 指定是否在生成的图像上添加水印。false = 不添加水印,true = 添加带有“AI generated”标签的水印 -根据 Router 在 `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` 处提供的 schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 +由 Router 在 `GET /v2/models/byteplus/seedream-5-0-flash-260915/openapi.json` 提供的 schema 生成,这也是在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 表示请求创建时间的 Unix 时间戳(以秒为单位) + 表示请求创建时间的 Unix 时间戳(单位:秒) - 包含已生成图像的相关信息。 -在图层分离场景中,数组的第一个元素是基础图像(z_index=0),其后各元素为图层,按 z_index 递增排序。 + 包含已生成图像的信息。 +在图层分离场景中,数组的第一个元素是基础图像(z_index=0),后续元素是图层,按 z_index 递增顺序排列。 - Base64 编码的图像数据(如果 response_format 为 "b64_json") + Base64 编码的图像数据(当 response_format 为 "b64_json" 时) + + + + 图像实际具有的背景类型:transparent 或 opaque。在图层分离场景中,基础图像始终为 opaque,每个图层均为 transparent。仅 seedream-5.5 返回此字段。 - 当前图层在基础图像中所占区域的边界框信息。仅图层会返回此字段;基础图像覆盖整个画布,不返回 bounding_box。仅当 layer_decomposition 为 true 时返回。 + 当前图层在基础图像中所占区域的边界框信息。仅图层返回此字段;基础图像覆盖整个画布,不返回 bounding_box。仅当 layer_decomposition 为 true 时返回。 @@ -283,33 +312,33 @@ disabled:禁用批处理生成功能。模型只会生成一张图像。 - 图层边界框的千分比量化(归一化)坐标,根据基础图像尺寸按比例映射到 [0, 1000] 的离散整数范围,最大截断为 1000。坐标格式:[left, top, right, bottom]。 + 图层边界框的千分位量化(归一化)坐标,根据基础图像尺寸按比例映射到 [0, 1000] 的离散整数范围,最大截断为 1000。坐标格式:[left, top, right, bottom]。 - 当前分离元素的详细描述,相比 name 提供更丰富的图层特征(例如颜色、状态、材质)。仅图层会返回此字段;基础图像不返回。仅当 layer_decomposition 为 true 时返回。 + 当前分离元素的详细描述,提供比 name 更丰富的图层特征(如颜色、状态、材质)。仅图层返回此字段;基础图像不返回。仅当 layer_decomposition 为 true 时返回。 - 当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。仅图层会返回此字段;基础图像不返回。仅当 layer_decomposition 为 true 时返回。 + 当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。仅图层返回此字段;基础图像不返回。仅当 layer_decomposition 为 true 时返回。 - 输出图像的文件格式。仅 seedream-5.0-pro 支持此字段。 + 输出图像的文件格式。仅 seedream-5.0-pro 和 5.5 支持此字段。 - 图像的宽度和高度(像素),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持此参数。 + 图像的宽度和高度(像素),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、5.5、4.5 和 4.0 支持此参数。 - 用于下载图像的 URL(如果 response_format 为 "url") + 用于下载图像的 URL(当 response_format 为 "url" 时) - Format: `uri` + 格式:`uri` - 图层的堆叠顺序,自下而上递增:0 是最底层的图层(基础图像);数值越大,位置越高。可用它按正确的堆叠顺序将各图层重新合成为完整图像。仅当 layer_decomposition 为 true 时返回。 + 图层的堆叠顺序,从下到上递增:0 是最底层(基础图像);值越大位置越高。用于按正确的堆叠顺序将图层重新合成为完整图像。仅当 layer_decomposition 为 true 时返回。 @@ -317,7 +346,7 @@ disabled:禁用批处理生成功能。模型只会生成一张图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一类别可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略类别,且不会覆盖传输故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一错误码族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略错误码族,但不会覆盖传输层故障。 @@ -325,11 +354,11 @@ disabled:禁用批处理生成功能。模型只会生成一张图像。 - 用于该请求的模型 ID + 用于请求的模型 ID - + @@ -337,11 +366,11 @@ disabled:禁用批处理生成功能。模型只会生成一张图像。 - 输入到模型的图像数量。仅 seedream-5.0-pro 支持此字段。 + 输入到模型的图像数量。仅 seedream-5.0-pro 和 5.5 支持此字段。 - 模型生成图像所消耗的 token 数量。 + 模型生成图片所消耗的 token 数量。 diff --git a/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx index 563a02eb51..44578cb368 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 Seedream 5.0 Pro 260628" description: "通过 Comfy Router 调用 byteplus/seedream-5-0-pro-260628:端点、请求格式以及 Router 返回的响应。" sidebarTitle: "Seedream 5.0 Pro 260628" -translationSourceHash: a37309ff +translationSourceHash: f5270d3a translationFrom: development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx translationBlockHashes: "_intro": b9a1b857 "Quick start": 5b012c86 - "Schema": c3a86bb4 + "Schema": b6886a5f "Examples": 40c4bb92 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedream-5-0-pro-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -157,8 +158,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests/$ ### 输入 + + 控制已生成图像是否具有透明背景(alpha 通道)。seedream-5.0-pro、5.0-flash 以及自身 schema 中有相关说明的较新 Seedream 模型支持此参数。 +auto:模型根据提示词和 output_format 决定。当 output_format 为 jpeg 时,输出始终不透明。 +transparent:输出带透明背景的 RGBA 图像。output_format 为 jpeg 时会返回错误。 +opaque:输出背景不透明的 RGB 图像。seedream-5.0-pro 的默认值。 +seedream-5.0-pro 仅在输入为单张带 alpha 通道的 png 图像的图生图场景下支持透明输出。 +图层分离场景不支持此参数:在启用 layer_decomposition 时传入该参数会返回错误。 + + 可能的取值:`auto`、`transparent`、`opaque` + + - 控制输出图像与输入提示词的贴合程度。范围 [1, 10]。值越高,提示词遵循度越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持。 + 控制输出图像与输入提示词的贴合程度。范围 [1, 10]。数值越大,对提示词的遵循越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持此参数。 范围:`1` 到 `10` @@ -166,108 +178,119 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-pro-260628/requests/$ - 要编辑的图像,可为可访问的 URL,或带 data-URI 前缀的 Base64 载荷。除参考图上限不同外,与共享的 Seedream 字段完全一致:本模型的上限为 10,而非 14。 + 要编辑的一张或多张图像,可以是可访问的 URL,也可以是带 data-URI 前缀的 Base64 数据。除参考图像上限不同外,该字段与共享的 Seedream 字段完全一致:此模型的上限为 10,而不是 14。 - 控制是否启用图层分离。仅 seedream-5.0-pro 和 5.0-flash 支持该参数。 -true: 图层分离模式。模型会将单张输入图像分解为一张基础图像加多个图层(最多 16 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 -false: 标准图像生成模式,不执行图层分离。 -关于图层分离模式的说明:仅支持单张输入图像(传入多张图像会返回错误);如果任何一个图层生成失败,整个请求都会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。如果传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream,会返回错误。 + 控制是否启用图层分离。仅 seedream-5.0-pro、5.0-flash 和 5.5 支持此参数。 +true:图层分离模式。模型将单张输入图像分解为一张基础图像加多个图层(最多 16 个;在 seedream-5.5 上最多 99 个),并返回每个产出图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 +false:标准图像生成模式;不执行图层分离。 +图层分离模式的注意事项:仅支持单张输入图像(传入多张图像会返回错误);如果任一单个图层生成失败,整个请求就会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。seedream-5.5 最多返回 layer_decomposition_options.max_images 张图像(1 张基础图像 + 最多 99 个图层)。若传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream 会返回错误。 + + + + 图层分离模式的选项。仅 seedream-5.5 支持此参数,且仅在 layer_decomposition 为 true 时生效。 + + + + 本次请求返回的图像总数上限,即基础图像与图层合计。范围:[2, 100]。当提示词未说明如何拆分图像时,模型会根据 max_images 和输入图像的复杂程度来规划图层;数值越大,通常得到的图层越细。 + + 范围:`2` 到 `100` - 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628 和 seedream-5-0-flash-260915。直接对 POST /proxy/byteplus/api/v3/images/generations 发起的 v1 调用必须提供该参数:代理会拒绝任何其他值,如果省略该参数,同样会以 400 拒绝。该参数不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段中填充它,所以 Router 调用方会省略它。 + 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915 和 seedream-5-5-261028。直接向 POST /proxy/byteplus/api/v3/images/generations 发起 v1 调用时必须提供该字段:proxy 会以 400 拒绝任何其他值以及省略该字段的请求。该字段不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5(仅支持 standard 模式)和 seedream-4.0 支持该参数。 + 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5/5.5(仅支持 standard 模式;seedream-5.5 传入 fast 会返回错误)和 seedream-4.0 支持此参数。 设置提示词优化功能的模式。standard = 质量更高,生成时间更长。fast = 速度更快,但质量较为一般。 - 可选值:`standard`、`fast` + 可能的取值:`standard`、`fast` - 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash 和 5.0-lite 支持该参数。在图层分离场景中,output_format 只控制基础图像的格式;每个图层始终以 png 输出。 + 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持此参数。seedream-5.5 默认为 png。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。 - 可选值:`png`、`jpeg` + 可能的取值:`png`、`jpeg` 用于图像生成或变换的文本描述。 -在图层分离场景(启用 layer_decomposition 的 seedream-5.0-pro 或 5.0-flash)中为可选参数:如果提供了提示词,模型会根据提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将它们分离为独立的图层。 +在图层分离场景中为可选(seedream-5.0-pro、5.0-flash 或启用 layer_decomposition 的 5.5):如果提供了提示词,模型会按照提示词的意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将其分离为独立图层。 指定响应中返回的已生成图像的格式 - 可选值:`url`、`b64_json` + 可能的取值:`url`、`b64_json` - 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。 + 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。若未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。 范围:`-1` 到 `2147483647` - 控制是否禁用批处理生成功能。该参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro 和 5.0-flash 不支持)。有效值: -auto: 在自动模式下,模型根据用户的提示词自动判断是否返回多张图像以及其中包含多少张图像。 -disabled: 禁用批处理生成功能。模型只会生成一张图像。 + 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。有效取值:auto: 在自动模式下,模型根据用户的提示词自动决定是否返回多张图像,以及返回的图像中包含几张图像。 +disabled: 禁用批处理生成功能。模型将只生成一张图像。 可选值:`auto`、`disabled` - 仅 seedream-5.0-lite、4.5 和 4.0 支持该参数(seedream-5.0-pro 和 5.0-flash 不支持)。 -批处理图像生成功能的配置。该参数仅在 sequential_image_generation 设为 auto 时生效。 + 仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。 +批处理图像生成功能的配置。仅当 sequential_image_generation 设为 auto 时,此参数才生效。 - 指定本次请求中最多生成多少张图像。输入参考图数量 + 生成图像数量 ≤ 15。 + 指定本次请求中最多生成的图像数量。输入参考图像数量 + 生成图像数量 ≤ 15。 范围:`1` 到 `15` - "seedream-4-0-250828":设置生成图像的规格。有两种方法可用,但不能同时使用。 + "seedream-4-0-250828": 设置生成图像的规格。有两种方法可用,但不能同时使用。 方法 1 | 指定分辨率。可选值:1K、2K、4K 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] -"seedream-4-5-251128":有两种方法可用。 +"seedream-4-5-251128": 有两种方法可用。 方法 1 | 指定分辨率。可选值:2K、4K 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] -"seedream-5-0-260128":有两种方法可用。 +"seedream-5-0-260128": 有两种方法可用。 方法 1 | 指定分辨率。可选值:2K、3K 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] - -"seedream-5-0-pro-260628":有两种可用方法(不能同时使用)。 - 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;最终尺寸由模型决定。可选值:1K、2K - 方法 2 | 以像素为单位指定宽度和高度。默认值:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] -"seedream-5-0-flash-260915":有两种可用方法(不能同时使用)。 - 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;最终尺寸由模型决定。可选值:1K、1.5K、2K。默认值:2K +"seedream-5-0-pro-260628": 有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、2K + 方法 2 | 以像素为单位指定宽度和高度。默认:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] +"seedream-5-0-flash-260915": 有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认:2K 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] -"seedream-5-0-pro-260628" 和 "seedream-5-0-flash-260915" 在启用 layer_decomposition 时:仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认值:auto。 - 基础图像按指定分辨率输出,并保持原始输入图像的宽高比;每个图层输出的尺寸接近指定分辨率,同时保持其在原始图像中的宽高比。 - auto:根据输入图像的尺寸和宽高比进行输出。[1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 +"seedream-5-5-261028": 有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率。可选值:1K、1.5K、2K。默认:2K + 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915" 和 "seedream-5-5-261028" 启用 layer_decomposition 时:仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认:auto。 + 基础图像按指定分辨率输出,并保持原始输入图像的宽高比;每个图层输出的分辨率接近指定分辨率,并保持其在原始图像中的宽高比。 + auto: 输出基于输入图像的尺寸和宽高比。[1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 - Comfy Router 会将显式提供的 stream 标志设为 false,因为它捕获的是完整的 JSON 结果。在 v1 代理上,该字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro 或 5.0-flash 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像在生成后立即返回。 + Comfy Router 会将显式传入的 stream 标志固定为 false,因为它要捕获完整的 JSON 结果。在 v1 代理上,此字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像在生成后立即返回。 - 指定是否为已生成的图像添加水印。false = 不添加水印,true = 添加带 'AI generated' 标签的水印 + 指定是否为生成的图像添加水印。false = 不添加水印,true = 添加带有“AI generated”标签的水印 -本文档由 Router 在 `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json` 提供的 schema 生成,与它在请求到达提供商之前用于校验调用的文档为同一份。 +由 Router 在 `GET /v2/models/byteplus/seedream-5-0-pro-260628/openapi.json` 处提供的 schema 生成,该文档与它在请求到达提供商之前校验调用所用的文档相同。 ### 输出 - 指示请求创建时间的 Unix 时间戳(以秒为单位) + Unix 时间戳(以秒为单位),表示请求的创建时间 @@ -279,32 +302,36 @@ disabled: 禁用批处理生成功能。模型只会生成一张图像。 Base64 编码的图像数据(如果 response_format 为 "b64_json") + + 图像实际具有的背景类型:transparent 或 opaque。在图层分离场景中,基础图像始终为 opaque,每个图层均为 transparent。仅 seedream-5.5 返回此字段。 + + - 当前图层在基础图像中所占区域的边界框信息。仅图层返回该字段;基础图像覆盖整个画布,不返回 bounding_box。仅在 layer_decomposition 为 true 时返回。 + 当前图层在基础图像中所占区域的边界框信息。仅图层返回此字段;基础图像覆盖整个画布,不返回 bounding_box。仅在 layer_decomposition 为 true 时返回。 - 图层边界框的绝对像素坐标,位于输出基础图像的坐标系中,左上角为 (0, 0)。坐标格式:[left, top, right, bottom]。 + 图层边界框的绝对像素坐标,采用输出基础图像的坐标系,左上角为 (0, 0)。坐标格式:[left, top, right, bottom]。 - 图层边界框的千分位量化(归一化)坐标,根据基础图像尺寸按比例映射到 [0, 1000] 的离散整数范围,最大截断为 1000。坐标格式:[left, top, right, bottom]。 + 图层边界框的千分比量化(归一化)坐标,根据基础图像尺寸按比例映射到 [0, 1000] 的离散整数范围,最大值截断为 1000。坐标格式:[left, top, right, bottom]。 - 当前分离元素的详细描述,相比 name 提供更丰富的图层特征(如颜色、状态、材质)。仅图层返回该字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + 当前分离元素的详细描述,比 name 提供更丰富的图层特征(例如颜色、状态、材质)。仅图层返回此字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 - 当前分离元素的名称/标签,由模型根据分离主体的特征自动生成。仅图层返回该字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + 当前分离元素的名称/标签,由模型根据被分离主体的特征自动生成。仅图层返回此字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 - 输出图像的文件格式。仅 seedream-5.0-pro 支持该字段。 + 输出图像的文件格式。仅 seedream-5.0-pro 和 5.5 支持此字段。 - 图像的宽度和高度(以像素为单位),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、4.5 和 4.0 支持该参数。 + 图像的宽度和高度(像素),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、5.5、4.5 和 4.0 支持此参数。 @@ -314,15 +341,15 @@ disabled: 禁用批处理生成功能。模型只会生成一张图像。 - 图层的堆叠顺序,从下到上递增:0 是最底部的图层(基础图像);数值越大位置越高。使用它可按正确的堆叠顺序将图层重新合成为完整图像。仅在 layer_decomposition 为 true 时返回。 + 图层的堆叠顺序,从下到上递增:0 是最底部的图层(基础图像);值越大,位置越高。用它按正确的堆叠顺序将图层重新合成为完整图像。仅在 layer_decomposition 为 true 时返回。 - 错误信息(如果有) + 错误信息(如有) - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略错误族,而不会覆盖传输故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个错误码族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证和提供商失败。Router 在 HTTP 400 错误响应信封和 HTTP 200 失败任务响应中识别策略族,但不会覆盖传输失败。 @@ -342,15 +369,15 @@ disabled: 禁用批处理生成功能。模型只会生成一张图像。 - 输入到模型的图像数量。仅 seedream-5.0-pro 支持该字段。 + 输入到模型的图像数量。仅 seedream-5.0-pro 和 5.5 支持此字段。 - 模型生成图片所使用的 token 数量。 + 模型已生成图片所使用的 token 数量。 - 本次请求消耗的 token 总数。 + 此请求消耗的 token 总数。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx new file mode 100644 index 0000000000..6104eecdf9 --- /dev/null +++ b/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx @@ -0,0 +1,409 @@ +--- +title: "通过 Comfy Router 使用 Seedream 5.5 261028" +description: "通过 Comfy Router 调用 byteplus/seedream-5-5-261028:端点、请求结构以及 Router 返回的响应。" +sidebarTitle: "Seedream 5.5 261028" +translationSourceHash: e2bff0d7 +translationFrom: development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx +translationBlockHashes: + "_intro": 5d72228c + "Quick start": 0a48e3d8 + "Schema": c4ff843e + "Examples": 2d76f48c +--- +{/* 已生成的文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedream-5-5-261028.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`byteplus/seedream-5-5-261028` 的 API 参考,由 Comfy Router 从 BytePlus 提供。 + +**输入:** 文本、图像 · **输出:** 图像 + +## 快速开始 + +在 [你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router) 中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段则通过原始 HTTP 进行相同的调用。 + +**模型 ID:** `byteplus/seedream-5-5-261028` + +**端点:** `POST https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境中读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "byteplus/seedream-5-5-261028", + { + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": False, + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境中读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("byteplus/seedream-5-5-261028", { + prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", + response_format: "url", + watermark: false, +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests`。只要运行被接纳,Router 就会立即返回 `201` 和 `request_id`,结果准备就绪后即可收集,无论来自当前进程还是另一个进程。[队列投递](/zh/development/comfy-router/queue) 会介绍状态、取消和收集的完整流程。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境中读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "byteplus/seedream-5-5-261028", + { + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": False, + }, + ) + print("request_id:", handle.request_id) # 有了模型 ID,另一个进程所需的信息就齐了 + + # 轮询直到请求完成,并等待服务器指定的 Retry-After 时间。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自己的载荷,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在此处抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境中读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("byteplus/seedream-5-5-261028", { + prompt: "A red fox trotting through a snowy pine forest, cinematic lighting", + response_format: "url", + watermark: false, +}); +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); +``` + +```bash cURL +# 1. 提交。Router 会返回 201,并附带 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"prompt\": \"A red fox trotting through a snowy pine forest, cinematic lighting\", \"response_format\": \"url\", \"watermark\": false}" + +# 2. 轮询直到状态为 COMPLETED,并等待每次响应指定的 Retry-After 秒数。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。返回 200 及模型原生输出;仍在运行时返回 202 及状态响应体。 +curl https://api.comfy.org/v2/models/byteplus/seedream-5-5-261028/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 控制生成的图像是否具有透明背景(alpha 通道)。由 seedream-5.0-pro、5.0-flash 以及自身 schema 中记录该参数的较新 Seedream 模型支持。 +auto: 模型根据提示词和 output_format 决定。当 output_format 为 jpeg 时,输出始终为不透明。 +transparent: 输出带透明背景的 RGBA 图像。output_format 为 jpeg 时返回错误。 +opaque: 输出带不透明背景的 RGB 图像。seedream-5.0-pro 的默认值。 +seedream-5.0-pro 仅在图生图时支持透明输出,且需要一张带 alpha 通道的 png 输入图像。 +图层分离场景不支持该参数:在启用 layer_decomposition 时传入它会返回错误。 + + 可选值:`auto`、`transparent`、`opaque` + + + + 控制输出图像与输入提示词的对齐程度。范围 [1, 10]。数值越高,对提示词的遵循越强。seedream-5.0-pro、5.0-lite、4.5 和 4.0 不支持该参数。 + + 范围:`1` 到 `10` + + 格式:`float` + + + + 要编辑的一张或多张图像,以可访问的 URL 或带 data-URI 前缀的 Base64 数据形式提供。除参考图上限不同外,与共享的 Seedream 字段完全一致:本模型的上限为 10,而不是 14。 + + + + 控制是否启用图层分离。仅 seedream-5.0-pro、5.0-flash 和 5.5 支持该参数。 +true: 图层分离模式。模型将单张输入图像分解为一张基础图像和多个图层(最多 16 个;在 seedream-5.5 上最多 99 个),并返回每个生成图层的位置和内容信息,包括堆叠顺序(z_index)、边界框(bounding_box)、名称(name)和描述(description)。 +false: 标准图像生成模式;不执行图层分离。 +关于图层分离模式的说明:仅支持单张输入图像(传入多张图像会返回错误);只要任一图层生成失败,整个请求就会失败,不支持部分成功;最多返回 17 张图像(1 张基础图像 + 16 个图层)。seedream-5.5 最多返回 layer_decomposition_options.max_images 张图像(1 张基础图像 + 最多 99 个图层)。传入 sequential_image_generation、sequential_image_generation_options、tools 和 stream 会返回错误。 + + + + 图层分离模式的选项。仅 seedream-5.5 支持该参数,且仅在 layer_decomposition 为 true 时生效。 + + + + 本次请求返回的图像总数上限,即基础图像与各图层之和。范围:[2, 100]。当提示词未说明如何拆分图像时,模型会根据 max_images 和输入图像的复杂度来规划图层;数值越大,通常图层划分越精细。 + + 范围:`2` 到 `100` + + + + 模型标识符。支持的模型:seedream-4-0-250828、seedream-4-5-251128、seedream-5-0-260128、seedream-5-0-pro-260628、seedream-5-0-flash-260915 和 seedream-5-5-261028。以 v1 直接调用 POST /proxy/byteplus/api/v3/images/generations 时必须提供它:代理会拒绝任何其他值,也会拒绝省略它的请求,并返回 400。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + + + + 提示词优化功能的配置。仅 seedream-5.0-pro/5.0-lite/4.5/5.5(仅支持 standard 模式;seedream-5.5 在 fast 模式下会返回错误)和 seedream-4.0 支持该参数。 + + + + 设置提示词优化功能的模式。standard = 质量更高,生成时间更长。fast = 速度更快,但质量较为一般。 + + 可选值:`standard`、`fast` + + + + 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持该参数。seedream-5.5 默认为 png。在图层分离场景中,output_format 只控制基础图像的格式;每个图层始终以 png 输出。 + + 可选值:`png`、`jpeg` + + + + 用于图像生成或变换的文本描述。 +在图层分离场景中为可选(即在启用 layer_decomposition 的 seedream-5.0-pro、5.0-flash 或 5.5 上):如果提供了提示词,模型会按照提示词意图识别并分离你指定的元素;如果未提供提示词,模型会自动检测图像中的所有主要元素,并将它们分离为独立图层。 + + + + 指定响应中返回的已生成图像的格式 + + 可选值:`url`、`b64_json` + + + + 用于控制图像生成随机性的随机种子。范围:[-1, 2147483647]。如果未指定,将自动生成一个种子。要复现相同的输出,请使用相同的种子值。 + + 范围:`-1` 到 `2147483647` + + + + 控制是否禁用批处理生成功能。该参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。有效值:auto: 在自动模式下,模型会根据用户提示词自动决定是否返回多张图像以及其中包含多少张图像。 +disabled: 禁用批处理生成功能。模型将只生成一张图像。 + + 可选值:`auto`、`disabled` + + + + 仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。 +批处理图像生成功能的配置。仅当 sequential_image_generation 设置为 auto 时,此参数才生效。 + + + + 指定本次请求中要生成的最大图像数量。输入参考图像数量 + 生成图像数量 ≤ 15。 + + 范围:`1` 至 `15` + + + + "seedream-4-0-250828":设置生成图像的规格。有两种方法可用,但不能同时使用。 + 方法 1 | 指定分辨率。可选值:1K、2K、4K + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[1024x1024, 4096x4096],宽高比:[1/16, 16] +"seedream-4-5-251128":有两种方法可用。 + 方法 1 | 指定分辨率。可选值:2K、4K + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[2560x1440, 4096x4096],宽高比:[1/16, 16] +"seedream-5-0-260128":有两种方法可用。 + 方法 1 | 指定分辨率。可选值:2K、3K + 方法 2 | 以像素为单位指定宽度和高度。默认:2048x2048,总像素:[2560x1440, ~3072x3072],宽高比:[1/16, 16] +"seedream-5-0-pro-260628":有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、2K + 方法 2 | 以像素为单位指定宽度和高度。默认:1024x1024,总像素:[1024x1024 (1048576), 2048x2048 (4194304)],宽高比:[1/16, 16] +"seedream-5-0-flash-260915":有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率,并在提示词中描述图像的宽高比、形状或用途;由模型决定最终尺寸。可选值:1K、1.5K、2K。默认:2K + 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-5-261028":有两种方法可用(不能同时使用)。 + 方法 1 | 指定分辨率。可选值:1K、1.5K、2K。默认:2K + 方法 2 | 以像素为单位指定宽度和高度。总像素:[1280x720 (921600), 2048x2048x1.1025 (4624220)],宽高比:[1/16, 16] +"seedream-5-0-pro-260628"、"seedream-5-0-flash-260915" 和 "seedream-5-5-261028" 启用 layer_decomposition 时:仅支持分辨率级别的方法。可选值:1K、1.5K、2K、auto。默认:auto。 + 基础图像按指定分辨率输出,并采用原始输入图像的宽高比;每个图层输出时接近指定分辨率,并保持其在原始图像中的宽高比。 + auto: 输出基于输入图像的尺寸和宽高比。[1280x720, ~2048x2048] 范围内的输入按原始输入尺寸输出;小于 1K 的输入按 1K 输出;大于 2K 的输入按 2K 输出。 + + + + Comfy Router 会将显式提供的 stream 标志置为 false,因为它会捕获完整的 JSON 结果。在 v1 代理上,此字段控制是否启用流式输出模式。仅 seedream-5.0-lite、4.5 和 4.0 支持此参数(seedream-5.0-pro、5.0-flash 或 5.5 不支持)。false = 所有输出图像一次性返回。true = 每张输出图像在生成后立即返回。 + + + + 指定是否为生成图像添加水印。false = 不添加水印,true = 添加带有 'AI generated' 标签的水印 + + +根据 Router 在 `GET /v2/models/byteplus/seedream-5-5-261028/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 + +### 输出 + + + Unix 时间戳(单位为秒),表示该请求的创建时间 + + + + 包含生成的图像的相关信息。 +在图层分离场景中,数组的第一个元素是基础图像(z_index=0),其后的元素是各图层,按 z_index 递增的顺序排列。 + + + + Base64 编码的图像数据(当 response_format 为 "b64_json" 时) + + + + 图像实际具有的背景类型:transparent 或 opaque。在图层分离场景中,基础图像始终为 opaque,每个图层均为 transparent。仅 seedream-5.5 返回该字段。 + + + + 当前图层在基础图像中所占区域的边界框信息。仅图层返回该字段;基础图像覆盖整个画布,不返回 bounding_box。仅在 layer_decomposition 为 true 时返回。 + + + + 图层边界框的绝对像素坐标,位于输出基础图像的坐标系中,左上角为 (0, 0)。坐标格式:[left, top, right, bottom]。 + + + + 图层边界框按千分位量化(归一化)后的坐标,基于基础图像尺寸按比例映射到 [0, 1000] 的离散整数区间,最大截断为 1000。坐标格式:[left, top, right, bottom]。 + + + + 当前分离元素的详细描述,相比 name 提供更丰富的图层特征(如颜色、状态、材质)。仅图层返回该字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + + + + 当前分离元素的名称/标签,由模型根据所分离主体的特征自动生成。仅图层返回该字段;基础图像不返回。仅在 layer_decomposition 为 true 时返回。 + + + + 输出图像的文件格式。仅 seedream-5.0-pro 和 5.5 支持该字段。 + + + + 图像的宽度和高度(单位为像素),格式为 \x\。仅 seedream-5.0-pro、5.0-lite、5.5、4.5 和 4.0 支持该参数。 + + + + 用于下载图像的 URL(当 response_format 为 "url" 时) + + 格式:`uri` + + + + 图层的堆叠顺序,从下到上递增:0 为最底部的图层(基础图像);数值越大层级越高。可使用它按正确的堆叠顺序将各图层重新合成为完整图像。仅在 layer_decomposition 为 true 时返回。 + + + + 错误信息(如有) + + + + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示因内容策略而拒绝。同一错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应和 HTTP 200 失败任务响应中识别策略错误族,但不会覆盖传输层故障。 + + + + 报错信息 + + + + 用于该请求的模型 ID + + + + + + + + 模型生成的图像数量 + + + + 输入到模型的图像数量。仅 seedream-5.0-pro 和 5.5 支持该字段。 + + + + 模型生成图片所消耗的 token 数量。 + + + + 该请求消耗的 token 总数。 + + +## 示例 + +### 输入 + +```json +{ + "prompt": "A red fox trotting through a snowy pine forest, cinematic lighting", + "response_format": "url", + "watermark": false +} +``` + +### 输出 + +```json +{ + "created": 1767225600, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/byteplus/seedream-4-0-250828/generated.png" + } + ], + "model": "seedream-5-5-261028", + "usage": { + "generated_images": 1 + } +} +``` + + + diff --git a/zh/development/comfy-router/models/meshy/rigging/code.mdx b/zh/development/comfy-router/models/meshy/rigging/code.mdx index 576956d5e2..3dbbc91952 100644 --- a/zh/development/comfy-router/models/meshy/rigging/code.mdx +++ b/zh/development/comfy-router/models/meshy/rigging/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用 Rigging" description: "通过 Comfy Router 调用 meshy/rigging:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Rigging" -translationSourceHash: d7eb966f +translationSourceHash: e8dbb3d3 translationFrom: development/comfy-router/models/meshy/rigging/code.mdx translationBlockHashes: "_intro": 2ec24f71 "Quick start": 08a075b7 - "Schema": 2d8d7dbb + "Schema": 66703709 "Examples": 8e91e01b --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/meshy/rigging.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -157,6 +158,10 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ 范围:`0` 到 `…` + + 是否给角色的手部添加手指骨骼。仅适用于双足绑定;与 texture_image_url、四足绑定,或四足拓扑的 input_task_id 一起使用时,Meshy 会以 400 拒绝该请求,对于只能在不含手指的情况下绑定的模型,则返回 422(不计费)。手指骨骼不会改变积分消耗。默认为 false。 + + 需要进行绑定的输入任务。如果未提供 model_url,则此项必填。 @@ -165,6 +170,12 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ 可公开访问的 URL 或 Data URI,指向带纹理的人形 GLB 文件。如果未提供 input_task_id,则此项必填。 + + 用于绑定后角色的骨骼,设置其骨骼名称和层级。仅适用于双足绑定。当值不是 meshyrig(或 include_fingers 为 true)时,输出文件以米为单位,并使用该骨骼模板中的骨骼,而不是以厘米为单位的默认 24 骨骼 meshyrig 文件;基于此绑定创建的动画任务会使用相同的骨骼。其他任何值都会被拒绝。默认为 meshyrig。 + + 可能的值:`meshyrig`、`mixamo`、`ue5_mannequin`、`max_biped`、`unity_humanoid`、`maya_human_ik`、`blender_rigify_basic_human`、`cc5_hd_neutral_base`、`daz_genesis9` + + 模型的 UV 展开基础颜色纹理图像。可公开访问的 URL 或 Data URI。支持 .png 格式。 diff --git a/zh/development/serverless/library-models.mdx b/zh/development/serverless/library-models.mdx new file mode 100644 index 0000000000..d663ff6d05 --- /dev/null +++ b/zh/development/serverless/library-models.mdx @@ -0,0 +1,171 @@ +--- +title: "在 Comfy API 部署上使用工作区模型库" +sidebarTitle: "模型库" +description: "将 LoRA 或其他 .safetensors 模型上传到你的工作区模型库,无需新的构建、发布或重新部署,即可在 Comfy API 部署上运行它。" +icon: "folder-open" +translationSourceHash: ece5d691 +translationFrom: development/serverless/library-models.mdx +translationBlockHashes: + "_intro": 6a0b3555 + "Before you start": c7b9ddf9 + "Upload a model to the workspace library": 693a12a3 + "Run the model on your deployment": 8b7df85e + "Follow the limits and naming rules": 5b0d3461 + "Change or delete a library model": dda1b7bd +--- +Comfy API 会运行来自你工作区库中的模型,即使部署的 Release 不包含这些模型。将 LoRA 或其他 `.safetensors` 模型上传到库中,即可在部署上运行它,而无需新的 Build、Release 或重新部署。 + +使用工作区库,可以在部署上试用你训练好的 LoRA,或者通过修改工作流中的一个文件名,为每个 API 请求选用不同的 LoRA。 + +## 开始之前 + +在上传模型到工作区库之前,请确保满足以下要求: + +- **套餐**:你的工作区需要有效的 Pro、Creator、Team 或企业版套餐。 +- **模型文件**:文件必须是大小不超过 2 GB 的 `.safetensors` 文件。较大的基础模型(例如 SDXL 或 Flux)仍应放在 Build 中。 +- **有效部署**:该部署必须与库位于同一工作区。 + + + 部分在工作区库模型可用之前创建的部署无法加载这些模型。要使用工作区库模型,请创建新部署。在较旧的部署上,任务可能会失败,并显示 `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` + + +## 将模型上传到工作区模型库 + +你可以使用以下任意三种工具上传模型: + +- **云端编辑器**:上传文件,或从 Civitai 或 Hugging Face 链接导入。 +- **comfy-cli**:从终端或脚本上传。 +- **开发者平台**:从 Build 的模型步骤上传。 + +选择你所使用工具对应的标签页。 + + + + 1. 在 **运行** 左侧的部署菜单中,确保 **运行于** 下已选择 **Comfy Cloud**。 + 2. 在**左侧边栏**中,点击 **模型库**,然后点击 **导入**。 + 3. 点击 **选择文件**,或将 `.safetensors` 文件拖入对话框。 + 4. 在 **这是什么类型的模型?** 下,如果文件是 LoRA,请保留 **LoRA**,或选择与该文件匹配的类型。 + 5. 点击 **上传**。上传完成后,点击 **完成**。 + + ![导入模型对话框,已选择 my_style_lora_9e2417.safetensors(97.37 MB),这是什么类型的模型?设为 LoRA,并显示返回和上传按钮](/images/development/serverless/library-models-editor-import.png) + + 若要改为从 Civitai 或 Hugging Face 链接导入模型: + + 1. 在 **导入** 对话框中,将模型的链接粘贴到 **粘贴链接到此** 中。 + 2. 点击 **继续**。 + 3. 在 **这是什么类型的模型?** 下,选择模型类型。 + 4. 点击 **导入**。 + + 只有 `.safetensors` 文件才能在部署上运行。以其他格式(例如 `.ckpt`)通过链接导入的模型会导入到模型库中,但无法在部署上运行。 + + + 上传文件,并使用 `--type` 设置其模型类型: + + ```bash + comfy assets library upload my_style.safetensors --type loras + ``` + + 检查文件是否已在模型库中: + + ```bash + comfy assets library ls --tags models,loras + ``` + + + 1. 在开发者平台上,打开某个 Build 的模型步骤,然后点击 **上传模型**。 + 2. 选择 **工作区模型库**。 + 3. 将 `.safetensors` 文件拖到拖放区域,或点击该区域进行浏览。 + 4. 在 **模型类型** 下,如果文件是 LoRA,请保留 **LoRA**,或选择与该文件匹配的类型。 + 5. 点击 **上传**。 + + ![Build 的“哪些模型随构建发布?”步骤上的上传模型对话框,包含公开、私有和工作区模型库标签页,已选择工作区模型库,显示拖放区域,模型类型设为 LoRA,一行文字说明文件已在你的工作区模型库中,以及取消和上传按钮](/images/development/serverless/library-models-platform-upload.png) + + + +模型进入模型库后,工作区的每位成员都可以使用它。模型库接受任何模型类型,不仅限于 LoRA。选择与加载器节点所读取的文件夹相匹配的类型,例如 LoRA 使用 `loras`,VAE 使用 `vae`。 + +## 在您的部署上运行模型 + +模型进入模型库后,您可以从云端编辑器或通过 API 在您的部署上运行它。请根据您提交任务的方式选择对应的选项卡。 + + + + 1. 点击 **Run** 左侧的部署菜单。在 **Run on** 下,选择您的部署。编辑器会重新加载,选项卡会保持打开。 + 2. 添加 `Load LoRA (Model and CLIP)` 节点,或打开包含该节点的工作流。 + 3. 在该节点的 `lora_name` 列表中,选择您的文件。列表会将模型库中的模型与 Release 的模型并列显示。 + 4. 点击 **Run**。 + + 首次运行时,队列中该任务所在的行会显示 `Downloading my_style.safetensors`,同时 worker 正在下载该文件。当任务下载多个模型时,该行会显示 `Downloading ( of )`。 + + ![包含 Load Checkpoint 和 Load LoRA (Model and CLIP) 节点的工作流,在 lora_name 中已选择上传的 LoRA,且队列面板的顶行显示 Downloading my_style_lora_9e2417.safetensors 0 B of 97.37 MB](/images/development/serverless/library-models-editor-downloading.png) + + + 在 [API 格式的工作流](/zh/development/api-development/workflow-api-format) 中,将 `LoraLoader` 节点的 `lora_name` 输入设置为模型库中的文件名,包括 `.safetensors`: + + ```json + "10": { + "class_type": "LoraLoader", + "inputs": { + "lora_name": "my_style.safetensors", + "strength_model": 1.0, + "strength_clip": 1.0, + "model": ["4", 0], + "clip": ["4", 1] + } + } + ``` + + 使用 `comfy deploy run`、[Comfy SDKs](/zh/development/api-development/sdks) 或 [Comfy API v2](/zh/api-reference/v2/overview) 发送工作流: + + ```bash + comfy deploy run --deployment --workflow workflow_api.json + ``` + + 要使用其他 LoRA,请在下一个请求中将 `lora_name` 更改为模型库中的另一个文件名。您无需创建新的 Build 或 Release,也无需重新部署。 + + + + + 使用模型库中的模型时,worker 上的首个任务会耗时更长,因为 worker 会先下载该模型。同一 worker 上的后续任务会使用缓存副本。新的 worker 会再次下载该模型;已将模型从缓存中移除以为其他模型腾出空间的 worker 也会如此。要跳过下载,请将模型添加到 Build。 + + +## 遵守限制和命名规则 + +除了 [开始之前](#开始之前) 中的文件大小和格式限制外,以下限制同样适用: + +| 限制 | 值 | +| --- | --- | +| 工作区存储 | 每个工作区 1 TB 模型,包括通过链接导入的模型 | +| 每个工作流的库模型名称数 | 100 | + +如果加载器引用第 101 个库模型,就会像该文件不在库中一样失败。 + +遵循以下规则,以便任务找到正确的文件: + +- **使用加载器读取的文件夹。** 加载器只会找到其自身模型类型的库文件。`Load LoRA` 节点会找到以 `loras` 上传的文件,而不是以 `checkpoints` 上传的文件。 +- **使用纯文件名。** 将加载器输入仅设置为文件名,例如 `my_style.safetensors`,且文件名前面不带文件夹。 +- **不要复用发布版本中的模型名称。** 如果发布版本已有同名文件,工作进程会使用发布版本的文件,而不是你的库文件。 +- **确保名称在不同文件夹中保持唯一。** 如果库在两个文件夹中有同名文件,而同一个加载器会读取这两个文件夹,那么通过 API 发送的任务不会加载其中任何一个文件。 +- **预期最新文件会胜出。** 如果库在一个文件夹中有两个同名文件,任务会使用最后添加的那个文件。 +- **匹配基础模型。** LoRA 必须与工作流加载的基础模型匹配。 +- **使用部署中提供的加载器。** 加载器节点必须在部署中可用。库模型只能通过 Comfy Cloud 提供的加载器节点加载。如果你的加载器来自 Comfy Cloud 没有的自定义节点,请将其模型添加到 Build 中。 + +## 更改或删除模型库中的模型 + +当在 **运行于** 下选择了部署时,**模型库**只列出该 Release 的模型。要更改或删除模型库中的模型,请先切换回 Comfy Cloud: + +1. 点击 **运行** 左侧的部署菜单。在 **运行于** 下,选择 **Comfy Cloud**。 +2. 在**左侧边栏**中,点击**模型库**。 + +要更改模型类型: + +- 将鼠标悬停在模型卡片上,点击**模型信息**,然后选择新的**模型类型**。 + + + 删除模型会将其从所有成员的工作区模型库中移除。仍引用该文件的任务或 API 请求会在加载器输入处失败,并报 `Value not in list` 错误。 + + +要删除模型: + +1. 将鼠标悬停在模型卡片上,点击**更多**,然后点击**删除**。 +2. 在**删除此模型?**中,点击**删除**。 diff --git a/zh/development/serverless/overview.mdx b/zh/development/serverless/overview.mdx index 906c31d113..9669da91d2 100644 --- a/zh/development/serverless/overview.mdx +++ b/zh/development/serverless/overview.mdx @@ -2,11 +2,11 @@ title: "Comfy API:Serverless 部署" description: "使用 Comfy API 将 ComfyUI 工作流部署为托管 GPU 端点:Build、版本、区域、Worker 扩缩容、工作区限额与部署监控。" icon: "cloud-arrow-up" -translationSourceHash: 2184a3a5 +translationSourceHash: 4df17332 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 - "Platform concepts": 97134dfe + "Platform concepts": cd4243ce "The Build file": 70f351b1 "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f @@ -14,10 +14,11 @@ translationBlockHashes: "Monitor and call a deployment": ff860dab "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b - "FAQ": 54896279 + "FAQ": 08ef9084 "Next steps": 0045baa9 --- + Comfy API 可让你的应用通过托管端点运行 ComfyUI 工作流。你需要打包工作流所需的 ComfyUI 版本、模型、自定义节点和依赖项,然后由 Comfy 在托管 GPU 上运行。适合需要可重复的运行环境,以及供应用调用的端点的场景。 ## 平台概念 @@ -25,11 +26,13 @@ Comfy API 可让你的应用通过托管端点运行 ComfyUI 工作流。你需 | 概念 | 含义 | | --- | --- | | **工作区** | 管理成员、Build、部署和使用限额的团队账户。 | -| **Build** | ComfyUI 环境定义,包括 ComfyUI 版本、模型、自定义节点和依赖项。 | -| **Build 版本 / 发布版本** | 为特定部署目标(例如 `linux/nvidia`)准备的编号 Build 版本。 | +| **Build** | ComfyUI 环境定义,包含其版本、模型、自定义节点和依赖关系。 | +| **Build 版本 / 发布版本** | 为某个部署目标(例如 `linux/nvidia`)准备的带编号的 Build 版本。 | | **部署** | 使用某个发布版本运行的端点,拥有自己的 GPU、区域和 worker 设置。 | -受 [Comfy Cloud](/zh/development/deploy/cloud) 支持的工作流可以直接在那里运行,无需创建 Build 或部署。 +受 [Comfy Cloud](/zh/development/deploy/cloud) 支持的工作流可以直接在云端运行,无需创建 Build 或部署。 + +如果要为部署添加模型而不创建新的 Build,请将其上传到你的工作区库。请参阅 [工作区库模型](/zh/development/serverless/library-models)。 从 agent 开始,或选择其他方式来提供你的环境或工作流。 @@ -132,7 +135,7 @@ comfy deploy events --deployment dep_123456 存储计费从部署开始: - - 部署某个发布版本时,其模型会被暂存到该部署的 worker 共享的网络存储上。部署完成后该存储为只读,只要该区域内还存在该 Build 的任何部署,就会按 GB-月 计费,包括使用 `comfy deploy stop` 暂停部署期间。 + - 部署某个发布版本时,其模型会被暂存到该部署的 worker 共享的网络存储上。部署完成后该存储为只读,只要该区域内还存在该 Build 的任何部署,就会按 GB-月 计费,包括使用 `comfy deploy stop` 暂停部署期间。任务从你的[工作区库](/zh/development/serverless/library-models)中使用的模型不会暂存到那里,而是由 worker 为该任务下载。 - 每个 worker 还会获得一块固定的 50 GB 容器磁盘。它是临时的,仅在 worker 运行期间计费,并计入该 worker 的计算费用。 - 删除部署会释放其计算资源。当该区域内最后一个使用该暂存网络存储的部署被删除后,存储会很快被清理,其计费也随之结束。 From caa88fa0b41a908d1d385b6e1a8fd68002afcc52 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Wed, 11 Nov 2026 11:24:14 +0800 Subject: [PATCH 14/36] i18n: sync the Wan router code pages, the model index and the router pricing links --- docs.json | 12 +- es/development/comfy-router/models.mdx | 15 +- es/development/comfy-router/pricing.mdx | 12 +- ja/development/comfy-router/models.mdx | 15 +- .../models/wan/wan2-6-i2v/code.mdx | 217 ++++++---------- .../models/wan/wan2-6-r2v/code.mdx | 238 +++++++++++------- ja/development/comfy-router/pricing.mdx | 12 +- ko/development/comfy-router/models.mdx | 15 +- .../byteplus/seedream-4-0-250828/code.mdx | 10 +- ko/development/comfy-router/pricing.mdx | 12 +- zh/development/comfy-router/models.mdx | 15 +- .../models/wan/wan2-6-r2v/code.mdx | 193 ++++++-------- .../models/wan/wan2-7-r2v/code.mdx | 193 ++++++-------- zh/development/comfy-router/pricing.mdx | 12 +- 14 files changed, 449 insertions(+), 522 deletions(-) diff --git a/docs.json b/docs.json index be7fd8ddde..49f753cec2 100644 --- a/docs.json +++ b/docs.json @@ -7783,7 +7783,8 @@ "zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code", "zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code", "zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code", - "zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code" + "zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code", + "zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code" ] }, { @@ -11967,7 +11968,8 @@ "ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code", "ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code", "ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code", - "ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code" + "ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code", + "ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code" ] }, { @@ -16081,7 +16083,8 @@ "ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code", "ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code", "ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code", - "ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code" + "ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code", + "ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code" ] }, { @@ -17912,7 +17915,8 @@ "es/development/comfy-router/models/byteplus/seedream-4-5-251128/code", "es/development/comfy-router/models/byteplus/seedream-5-0-260128/code", "es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code", - "es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code" + "es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code", + "es/development/comfy-router/models/byteplus/seedream-5-5-261028/code" ] }, { diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 92189392ae..1fd2cc28c7 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -109,7 +109,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/es/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [Clean Audio Video](/es/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/es/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`- [Lipsync 2.0](/es/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Fabric 1.0](/es/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` +- [Lipsync 2.0](/es/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/es/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/es/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` - [Video Background Removal](/es/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` @@ -163,7 +164,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/es/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Editar imagen: eliminar fondo guiado](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` +- [Editar imagen: eliminar fondo guiado](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Editar imagen: eliminar fondo](/es/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Editar imagen: reemplazar fondo](/es/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [Editar imagen: reemplazar objeto por texto](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -213,7 +215,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Qwen Image 3.0](/es/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/es/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` - [Recraft V3](/es/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector`- [Recraft V4.1 Pro](/es/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` +- [Recraft V4.1 Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` +- [Recraft V4.1 Pro](/es/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code): `recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code): `recraft/recraftv4_1_utility_vector` @@ -264,7 +267,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [FLUX 3 Video](/es/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128`- [Dreamina Seedance 2.0 Mini](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 Mini](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/es/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/es/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` @@ -321,7 +325,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` - [Hunyuan 3D Part](/es/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology`- [Hunyuan 3D Texture Edit](/es/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` +- [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Texture Edit](/es/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` diff --git a/es/development/comfy-router/pricing.mdx b/es/development/comfy-router/pricing.mdx index d3fe12e8b8..a4e43f9442 100644 --- a/es/development/comfy-router/pricing.mdx +++ b/es/development/comfy-router/pricing.mdx @@ -139,8 +139,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Ideogram 4.5](/es/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | Baja | 9.0519 | | [Ideogram 4.5](/es/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | Media | 18.1038 | | [Ideogram 4.5](/es/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | Alta | 60.346 | -| [Seedream 5.5](/es/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | Separación de capas · 1.5K
Imagen de salida · 1.5K | 6.0346 | -| [Seedream 5.5](/es/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | Separación de capas · 2K
Imagen de salida · 2K | 10.56055 | +| [Seedream 5.5](/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | Separación de capas · 1.5K
Imagen de salida · 1.5K | 6.0346 | +| [Seedream 5.5](/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | Separación de capas · 2K
Imagen de salida · 2K | 10.56055 | #### No publicado @@ -155,7 +155,7 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Qwen Image 3.0](/es/development/comfy-router/models/qwen/qwen-image-3-0/code) | `qwen/qwen-image-3.0` | Imagen de entrada · 1K / 2K | 0.9052 / imagen de entrada | | [Qwen Image 3.0 Pro](/es/development/comfy-router/models/qwen/qwen-image-3-0-pro/code) | `qwen/qwen-image-3.0-pro` | Imagen de entrada · 1K / 2K | 0.9052 / imagen de entrada | | [Seedream 5.0 Pro](/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | Imágenes de entrada después de la primera | 0.633 / imagen de entrada | -| [Seedream 5.5](/es/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | Imagen de entrada | 2.41384 / imagen de entrada | +| [Seedream 5.5](/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | Imagen de entrada | 2.41384 / imagen de entrada | #### Tarifas por crédito de Recraft @@ -882,8 +882,8 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [Ideogram 4.5](/es/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | Baja | $0.0429 | | [Ideogram 4.5](/es/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | Media | $0.0858 | | [Ideogram 4.5](/es/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | Alta | $0.286 | -| [Seedream 5.5](/es/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | Separación de capas · 1.5K
Imagen de salida · 1.5K | $0.0286 | -| [Seedream 5.5](/es/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | Separación de capas · 2K
Imagen de salida · 2K | $0.05005 | +| [Seedream 5.5](/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | Separación de capas · 1.5K
Imagen de salida · 1.5K | $0.0286 | +| [Seedream 5.5](/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | Separación de capas · 2K
Imagen de salida · 2K | $0.05005 | #### No publicado @@ -898,7 +898,7 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [Qwen Image 3.0](/es/development/comfy-router/models/qwen/qwen-image-3-0/code) | `qwen/qwen-image-3.0` | Imagen de entrada · 1K / 2K | $0.00429 / imagen de entrada | | [Qwen Image 3.0 Pro](/es/development/comfy-router/models/qwen/qwen-image-3-0-pro/code) | `qwen/qwen-image-3.0-pro` | Imagen de entrada · 1K / 2K | $0.00429 / imagen de entrada | | [Seedream 5.0 Pro](/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | Imágenes de entrada después de la primera | $0.003 / imagen de entrada | -| [Seedream 5.5](/es/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | Imagen de entrada | $0.01144 / imagen de entrada | +| [Seedream 5.5](/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | Imagen de entrada | $0.01144 / imagen de entrada | #### Tarifas por crédito de Recraft diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index 76bed33d95..9359c37075 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -110,7 +110,8 @@ translationBlockHashes: - [Gen 4 Turbo](/ja/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ja/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [Clean Audio Video](/ja/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`- [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` +- [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ja/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ja/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` - [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` @@ -164,7 +165,8 @@ translationBlockHashes: - [Image Edit Increase Resolution](/ja/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/ja/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/ja/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` +- [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ja/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ja/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -214,7 +216,8 @@ translationBlockHashes: - [Qwen Image 3.0](/ja/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/ja/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` - [Recraft V3](/ja/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector`- [Recraft V4.1 Pro](/ja/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` +- [Recraft V4.1 Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` +- [Recraft V4.1 Pro](/ja/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/ja/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code): `recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code): `recraft/recraftv4_1_utility_vector` @@ -265,7 +268,8 @@ translationBlockHashes: - [FLUX 3 Video](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128`- [Dreamina Seedance 2.0 Mini](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 Mini](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/ja/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/ja/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` @@ -322,7 +326,8 @@ translationBlockHashes: - [Stable Fast 3D](/ja/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ja/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` - [Hunyuan 3D Part](/ja/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/ja/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology`- [Hunyuan 3D Texture Edit](/ja/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` +- [Hunyuan 3D Smart Topology](/ja/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Texture Edit](/ja/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/ja/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv`
diff --git a/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index 3ccf4f9b66..0953c1cfef 100644 --- a/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Wan 2.6 I2V を使う" description: "Comfy Router を通じて HTTP 経由で wan/wan2.6-i2v を呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Wan 2.6 I2V" -translationSourceHash: 2d86680e +translationSourceHash: 6912559c translationFrom: development/comfy-router/models/wan/wan2-6-i2v/code.mdx translationBlockHashes: "_intro": 53ec6bcb "Quick start": 0163076e - "Schema": 4b1f17d6 + "Schema": a13e6673 "Examples": 2b581e5f --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -187,131 +188,70 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ ### 入力 - プロンプト語句などの基本情報を入力します。 + プロンプトワードなどの基本情報を入力します。 - オーディオファイルのダウンロードURL。対応形式: mp3 および wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロード URL。対応形式: mp3 および wav。reference_video_urls と併用できません。 - 最初フレームの画像URLまたはBase64エンコードデータ。wan2.5-i2v-preview および -wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 表記では、最初フレームをここで渡しません。 -type が first_frame の media 要素として渡します(後述の media を参照)。 -また、wan2.6-i2v では成功する img_url のボディも、happyhorse-1.0-i2v および -happyhorse-1.1-i2v ではプロバイダーに拒否されます。wan2.7/wan3.0 の表記でも、 -参照アセットは同様に media で渡します。画像形式: JPEG、JPG、PNG、BMP、WEBP。 -解像度: 360~2000ピクセル。ファイルサイズ: 最大10MB。 + 先頭フレーム画像の URL または Base64 エンコードされたデータ。wan2.5-i2v-preview および wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の表記は先頭フレームをここでは受け取りません。first_frame タイプの media 要素として受け取ります(下記の media を参照)。また、wan2.6-i2v で成功する img_url のボディは、happyhorse-1.0-i2v および happyhorse-1.1-i2v ではプロバイダーによって拒否されます。さらに wan2.7/wan3.0 系の表記も参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360-2000 ピクセル。ファイルサイズ: 最大 10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を -指定します。各要素は type フィールドと url フィールドを持ちます。このフィールドは -このコンポーネントから提供されるすべてのモデルで共通ですが、どの type 値をその -モデルが受け付けるか、また画像やビデオの入力を img_url や reference_video_urls -ではなくここで渡すかどうかは、モデルによって異なります。モデルごとの対応 type 値は -次のとおりです: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と - last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺あたり240~8000ピクセル、アスペクト比1:8 - ~8:1、最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3、2~30秒、最大15MB)と first_clip(MP4/MOV、2~10 - 秒、1辺あたり240~4096ピクセル、最大100MB): パブリックな HTTP/HTTPS URL。 - インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。 - reference_image または reference_video のうち少なくとも1つが必須で、reference - 画像と reference ビデオの合計は最大5です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP - (アルファチャンネルなし)、1辺あたり240~8000ピクセル、アスペクト比1:8~8:1、最大 - 20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。reference_video: パブリックな - HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、2~10秒、 - 1辺あたり240~4096ピクセル、最大100MB、パブリックな HTTP/HTTPS URL。インラインの data: URL - は受け付けられません)と、任意で0~4つの reference_image(JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり240~8000ピクセル、アスペクト比1:8~8:1、最大20MB、パブリックURL - または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 - reference_image(最大10)、reference_video(最大5クリップ、合計再生時間 \<= 15秒)、 - reference_audio(最大5クリップ、合計再生時間 \<= 15秒)、file(最大1、link とは併用 - 不可)、link(最大1、file とは併用不可)。reference_*/file/link の各 type - と first_frame/last_frame の各 type は、同じリクエスト内では相互排他です。 - 配列の順序が、プロンプト内でのアセットの参照順序を定義します(Image 1、Video 1、 - Audio 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、 - 1辺あたり240~8000ピクセル、アスペクト比最大8:1、最大20MB、パブリックURLまたは - data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: パブリックな - HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど1つ。これらの表記 - では最初フレームをここで渡し、img_url では渡しません。少なくとも300x300ピクセル、アスペクト比 - 1:2.5~2.5:1、JPEG/JPG/PNG/WEBP、最大20MB、パブリックURLまたは - data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1~9個。これが - このモデル唯一の参照入力です。最短辺が少なくとも400ピクセル、JPEG/JPG/PNG/WEBP、 - 最大20MB、パブリックURLまたは data:\{MIME_type};base64,... URL。reference_video は - この操作の入力 type ではありません。 -- happyhorse-1.0-video-edit: video(ちょうど1つ、編集対象のクリップ: MP4/MOV、3~60 - 秒、長辺が最大4096ピクセル、短辺が少なくとも360ピクセル、アスペクト - 比1:2.5~2.5:1、最大100MB、パブリックな HTTP/HTTPS URL。インラインの data: - URL は受け付けられません)と、任意で0~5つの reference_image(JPEG/JPG/PNG/WEBP、 - 少なくとも300x300ピクセル、アスペクト比1:2.5~2.5:1、最大20MB、パブリックURL - または data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - テキストから動画への操作です。これらのパートナー参照ドキュメントには media 入力の記載がないため、このフィールドは - 未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: これらの表記について、このコンポーネントは - media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初 - フレームを img_url で渡し、wan2.6-r2v は参照クリップを reference_video_urls で渡します。 -上記のモデルごとの個数は、このスキーマの制約ではなくパートナーの制約です。media には -minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに -異なるためです。スキーマが受け付けることは、プロバイダーが受け付けることを意味しません。逆に、 -上記のアセットごとの「最大20MB」という数値(画像入力の上限であり、インラインで送信できる -唯一の入力です)は、パートナーが最終的に受け取るアセットに対するパートナーの上限であり、 -アセットがパブリックURLの場合は記載どおりに適用されます。そのバイト列が Comfy を -経由しないためです。インラインの data:\{MIME_type};base64,... -URL は Comfy を経由するため、転送上の上限にも直面します。Comfy Router -の POST ボディは合計100MiBに制限され、それを超えると 413 が返されます。また base64 は -ペイロードを約4/3に膨らませるため、およそ75MBを超える単一のインラインアセットは、ここに -記されたパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限ならインラインで問題なく収まるため、アセット 1 つの場合はパートナーのルールが制約となります。複数のアセットにまたがる場合は転送の上限が制約となります。これは 100 MiB の Router 上限が各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、パブリック URL として送信してください。 + メディアアセットのリスト。動画生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type と url フィールドを持ちます。このフィールドはこのコンポーネントから提供されるすべてのモデルで共有されており、あるモデルがどの type 値を受け付けるか、また画像やビデオの入力を img_url や reference_video_urls ではなくここで受け取るかどうかは、モデルによって異なります。モデルごとの対応 type 値: +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、各辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2-30 秒、最大 15MB)と first_clip(MP4/MOV、2-10 秒、各辺 240-4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。少なくとも 1 つの reference_image または reference_video が必要で、reference_image と reference_video の合計は最大 5 です。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、各辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- wan2.7-videoedit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、2-10 秒、各辺 240-4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0 から 4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、各辺 240-8000 ピクセル、アスペクト比 1:8 から 8:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15 秒)、reference_audio(最大 5 クリップ、合計再生時間 \<= 15 秒)、file(最大 1、link と併用不可)、link(最大 1、file と併用不可)。reference_*/file/link タイプと first_frame/last_frame タイプは、同一リクエスト内で相互に排他的です。配列の順序がプロンプト内のアセットの参照順序を定義します(Image 1、Video 1、Audio 1、...)。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、各辺 240-8000 ピクセル、アスペクト比最大 8:1、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの表記は先頭フレームをここで受け取り、img_url では受け取りません。少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1 から 9 個。これはこのモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 +- happyhorse-1.0-video-edit: video(ちょうど 1 つ、編集対象のクリップ: MP4/MOV、3-60 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0 から 5 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、少なくとも 300x300 ピクセル、アスペクト比 1:2.5 から 2.5:1 の間、最大 20MB、公開 URL または data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作。これらのパートナー参照ドキュメントにはメディア入力が記載されていないため、このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対してメディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 +上記のモデルごとの個数はこのスキーマの制約ではなくパートナーの制約です。許可されるタイプとその上限がモデルごとに異なるため、media には minItems/maxItems が宣言されていません。スキーマが受け付けることはプロバイダーが受け付けることを意味しません。逆方向についても、上記のアセットごとの「最大 20MB」という数値(画像入力に対する上限であり、インラインで送信できる唯一の入力です)は、最終的に受け取るアセットに対するパートナーの上限であり、アセットが公開 URL の場合はそのまま適用されます。そのバイト列は Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。また base64 はペイロードを約 4/3 に膨張させるため、およそ 75 MB を超える単一のインラインアセットは、ここに記載されたパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の +20MB の上限ならインラインでも余裕で収まるため、1つのアセットについてはパートナーのルールが制約となります。一方、複数のアセットにまたがる場合は転送の上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 - メディアアセットのタイプ + メディアアセットの種類 - 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` - メディアファイルの URL。パブリックな HTTP/HTTPS URL、または(まさに上記の `media` の説明でモデルごとに挙げられている IMAGE 入力、すなわち wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame と reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、および happyhorse-1.0-video-edit の reference_image に限ります)インラインの `data:{MIME_type};base64,...` URL です。これらのモデルのいずれでも、video、audio、file、link の入力がインラインの data: URL を受け付けることはありません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインペイロード全体を制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明でモデルごとに列挙されている IMAGE 入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)に限り、インラインの `data:{MIME_type};base64,...` URL。これらのモデルのビデオ、オーディオ、ファイル、リンクの入力はいずれも、インラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する `oss://dashscope-instant` の一時 URL、または (wan2.7-videoedit では) Asset Center の `asset_id` は、それをアップロードした Alibaba Cloud アカウントでのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード経路を公開していないため、呼び出し元自身の `oss://` URL や `asset_id` はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されず、そのままパートナーへ転送されます。モデルごとのサイズとピクセルの上限、およびインラインのペイロードを全体として制限する 100 MiB の Router リクエストボディ上限については、`media` の説明を参照してください。 - ネガティブプロンプトは、ビデオ画面に表示したくないコンテンツを記述するために使用します + ネガティブプロンプトは、動画に映ってほしくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これは prompt と同じ入力予算にカウントされます。 - テキストプロンプト。中国語と英語に対応し、長さは 800 文字以内です -(wan3.0-video では最大 20,000 文字。上限を超えたコンテンツは切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順に被写体を参照するために -'character1'、'character2' などを使用します。例: 「Character1 が道端で歌い、Character2 がそのそばで踊る」 -wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを -参照するために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 + テキストプロンプト。中国語と英語をサポートします。ドキュメントに記載された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 中国語文字)を超えるリクエストはプロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +参照ビデオが複数ある wan2.6-r2v では、参照ビデオの順序に従って被写体を 'character1'、'character2' などで指定します。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを 'Image 1'、'Video 1'、'Audio 1' などで指定します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 本のビデオ URL の配列です。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列です。 入力の制限: -- 形式: mp4、mov -- 本数: 1~3 本 -- 1 本のビデオの長さ: 2~30 秒 -- 1 ファイルのサイズ: 最大 30MB -- audio_url とは併用できません -参照時間: ビデオ 1 本の場合は最大 5 秒、2 本の場合はそれぞれ最大 2.5 秒、3 本の場合はそれに比例して短くなります。 +- 形式: mp4, mov +- 数量: 1〜3 本 +- 1 本あたりの長さ: 2〜30 秒 +- 1 ファイルあたりのサイズ: 最大 30MB +- audio_url と併用できません +参照時間: 1 本の場合は最大 5 秒、2 本の場合は各最大 2.5 秒、3 本の場合はそれに応じて短くなります。 課金: 実際に使用した参照時間に基づきます。 - ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用すると、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意です。現在サポートされているのは squish、flying、carousel です。使用すると prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元はこれを省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router が `POST /v2/models/wan/{model}` の `{model}` パスセグメントから設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -319,30 +259,30 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。他の wan モデルについて、プロバイダーはこのような切り替えをドキュメント化していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルについては、プロバイダーはそのような切り替えをドキュメント化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します +- auto (デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 指定可能な値: `auto`、`origin` + 指定可能な値: `auto`, `origin` 生成されるビデオの再生時間(秒): -- wan2.5 モデル: 5 または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、または 15 秒 -- wan2.6-r2v: 5 または 10 秒のみ(15 秒は非サポート) +- wan2.5 モデル: 5 秒または 10 秒 +- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 +- wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、 - 入力ビデオの再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、 - モデルが適切な再生時間を選ぶスマート再生時間モードが有効になります -このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力がある場合は、 + 入力ビデオの再生時間と出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると + スマート再生時間モードが有効になり、モデルが適切な再生時間を選択します +このプロキシは [-1, 30] の範囲外の duration に対して 400 を返します。 - 範囲: `-1` から `30` + 範囲: `-1` 〜 `30` @@ -350,23 +290,22 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて -適切なアスペクト比を自動的に推奨します。 + 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデル専用です。 +wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 +wan3.0-video の場合、adaptive(デフォルト)は適切なものを自動的に推奨しますaspect ratio は入力メディアの比率と意図に基づいて決まります。 - 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` 解像度レベル。サポートされる値はモデルによって異なります: -- wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P は非サポート) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(アップストリームのデフォルトは 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P -- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、解像度も size も指定していないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決めるためです。このプロキシは、確認する前に解像度を大文字に変換し、大文字に変換した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P を持たないと記載されている wan2.6、wan2.7、happyhorse-1.0 の各モデルに対する 480P(解像度として送信された場合も、480P の size として送信された場合も)には 400 を返します。 +- wan2.5-i2v-preview: 480P, 720P, 1080P +- wan2.6 モデル(t2v、i2v、r2v): 720P, 1080P のみ(480P 非対応) +- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P, 1080P(デフォルト 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上流のデフォルトは 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P, 1080P +- happyhorse-1.1-*(t2v、i2v、r2v): 480P, 720P, 1080P +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。解像度のティアが課金レートを決めるためです。解像度はチェックの前に大文字化し、大文字化した値をそのまま転送します。この enum に含まれない値には 400 を返し、上記で 480P 非対応とされている wan2.6、wan2.7、happyhorse-1.0 のモデルでは、480P(resolution として送られた場合も、480P の size として送られた場合も)に対して 400 を返します。 指定可能な値: `480P`, `720P`, `1080P` @@ -374,32 +313,34 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 - 範囲: `0` ~ `2147483647` + 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 -wan2.6 および wan2.7-r2v モデルで使用します。 -- single: 単一ショットビデオ(デフォルト) -- multi: マルチショットビデオ + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ動作します。 +wan2.6 および wan2.7-r2v モデル向けです。 +- single: 単一ショットのビデオ(デフォルト) +- multi: マルチショットのビデオ 指定可能な値: `multi`, `single` - width*height 形式のビデオ解像度。対応する解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ + width*height 形式のビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P(480*832, 832*480, 624*624)、720P、1080P の各サイズ wan2.6 T2V/R2V の場合(480P なし): - 720P: 1280*720、720*1280、960*960、1088*832、832*1088 - 1080P: 1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -size と解像度の両方を送信した場合、課金対象の階層を選択するのは size であり、解像度はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、解像度の説明で 480P を持たないと記載されているすべてのモデルで 400 を返します。 + 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 + 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 +size と resolution の両方が送信された場合、課金ティアを選択するのは size であり、 +resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、 +解像度の説明で 480P 非対応とされているすべてのモデルで 400 を返します。 - 透かしロゴを追加するかどうか。透かしは右下隅に配置されます。 + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -このドキュメントは、Router が `GET /v2/models/wan/wan2.6-i2v/openapi.json` で提供するスキーマから生成されたものです。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じです。 +Router が `GET /v2/models/wan/wan2.6-i2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 ### 出力 @@ -424,7 +365,7 @@ size と解像度の両方を送信した場合、課金対象の階層を選択
- 失敗したリクエストに関する詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) @@ -472,11 +413,11 @@ size と解像度の両方を送信した場合、課金対象の階層を選択 - 失敗したタスクの数 + 失敗したタスク数 - 成功したタスクの数 + 成功したタスク数 @@ -484,13 +425,13 @@ size と解像度の両方を送信した場合、課金対象の階層を選択 - タスクのステータス + タスクステータス 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です + 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間 @@ -514,7 +455,7 @@ size と解像度の両方を送信した場合、課金対象の階層を選択 - 生成された画像の数(T2IおよびI2Iタスク) + 生成された画像数(T2IおよびI2Iタスク) @@ -534,7 +475,7 @@ size と解像度の両方を送信した場合、課金対象の階層を選択 - 生成されたビデオの数(T2Vタスク) + 生成されたビデオ数(T2Vタスク) @@ -546,11 +487,11 @@ size と解像度の両方を送信した場合、課金対象の階層を選択 - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのROOTで報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルート(ROOT)で報告されます(リクエストが成功した場合は返されません)。 - 失敗したリクエストに関する詳細情報。`output` の下ではなく、エンベロープのROOTで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、これを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルート(ROOT)で報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前に、こちらを確認してください。 ## 例 diff --git a/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index 04268f12c4..f41180f52b 100644 --- a/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Wan 2.6 R2V を使う" description: "Comfy Router 経由で HTTP から wan/wan2.6-r2v を呼び出すための Python、TypeScript、cURL スニペットと、リクエストフィールドおよび結果の形状" sidebarTitle: "Wan 2.6 R2V" -translationSourceHash: 2a7dc724 +translationSourceHash: f2cccfce translationFrom: development/comfy-router/models/wan/wan2-6-r2v/code.mdx translationBlockHashes: "_intro": dc2fc376 "Quick start": 066eb9ee - "Schema": 104ab356 + "Schema": 789f5781 "Examples": dd88ebee --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* 生成済みファイル。このディレクトリの code.yaml を編集し、`pnpm code-pages:gen` を実行してください。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -191,66 +192,122 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-r2v/requests/$REQUEST_ID \ - オーディオファイルのダウンロードURL。対応形式: mp3、wav。reference_video_urls とは併用できません。 + オーディオファイルのダウンロードURL。対応形式はmp3とwavです。reference_video_urlsとは併用できません。 - 先頭フレームの画像URL、または Base64 エンコードされたデータ。wan2.5-i2v-preview と wan2.6-i2v モデルでは必須です。happyhorse-1.x の i2v 系の綴りでは、先頭フレームをここで受け取るのではなく、type が first_frame のメディア要素として受け取ります(後述の media を参照)。wan2.6-i2v では成功する img_url ボディも、happyhorse-1.0-i2v と happyhorse-1.1-i2v ではプロバイダーに拒否されます。また、wan2.7/wan3.0 系の綴りも参照アセットを media で受け取ります。画像形式: JPEG、JPG、PNG、BMP、WEBP。解像度: 360〜2000 ピクセル。ファイルサイズ: 最大 10MB。 + 先頭フレームの画像URL、またはBase64エンコードされたデータ。wan2.5-i2v-previewモデルと +wan2.6-i2vモデルでは必須です。happyhorse-1.xのi2v系の表記はここで先頭フレームを受け取りません。 +先頭フレームはtypeがfirst_frameのメディア要素として受け取ります(下記のmediaを参照)。 +また、wan2.6-i2vで成功するimg_urlのボディは、happyhorse-1.0-i2vとhappyhorse-1.1-i2vでは +プロバイダーに拒否されます。さらにwan2.7/wan3.0系の表記も参照アセットをmediaで受け取ります。 +画像形式:JPEG、JPG、PNG、BMP、WEBP。 +解像度:360-2000ピクセル。ファイルサイズ:最大10MB。 - メディアアセットのリスト。ビデオ生成用の参照素材(画像、オーディオ、ビデオ)を指定します。各要素は type と url フィールドを持ちます。このフィールドは、このコンポーネントが提供するすべてのモデルで共有されていますが、あるモデルがどの type 値を受け付けるか(また、画像やビデオの入力を img_url や reference_video_urls ではなくそもそもここで受け取るかどうか)は、モデルによって異なります。モデルごとの対応 type 値: -- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frame と last_frame: JPEG/JPG/PNG/BMP/WEBP、1辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3、2〜30 秒、最大 15MB)と first_clip(MP4/MOV、2〜10 秒、1辺 240〜4096 ピクセル、最大 100MB): 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-r2v: first_frame(任意、最大 1)、reference_image、reference_video。reference_image または reference_video が少なくとも 1 つ必要で、reference_image と reference_video を合計して最大 5 つです。first_frame と reference_image: JPEG/JPG/PNG/BMP/WEBP(アルファチャンネルなし)、1辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- wan2.7-videoedit: video(ちょうど 1 つ。編集対象のクリップ: MP4/MOV、2〜10 秒、1辺 240〜4096 ピクセル、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0〜4 個の reference_image(JPEG/JPG/PNG/BMP/WEBP、1辺 240〜8000 ピクセル、アスペクト比 1:8〜8:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime: first_frame(最大 1)、last_frame(最大 1)、reference_image(最大 10)、reference_video(最大 5 クリップ、合計再生時間 \<= 15s)、reference_audio(最大 5 クリップ、合計再生時間 \<= 15s)、file(最大 1、link とは併用不可)、link(最大 1、file とは併用不可)。reference_*/file/link の type と first_frame/last_frame の type は、同じリクエスト内では同時に使用できません。配列の順序が、プロンプト内でのアセットの参照順(Image 1、Video 1、Audio 1、…)を定義します。first_frame、last_frame、reference_image: JPEG/JPG/PNG/BMP/WEBP、1辺 240〜8000 ピクセル、アスペクト比は最大 8:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link: 公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frame のみ、ちょうど 1 つ。これらの綴りでは、先頭フレームを img_url ではなくここで受け取ります。少なくとも 300x300 ピクセル、アスペクト比 1:2.5〜2.5:1、JPEG/JPG/PNG/WEBP、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_image のみ、1〜9 個。これがこのモデル唯一の参照入力です。最短辺が少なくとも 400 ピクセル、JPEG/JPG/PNG/WEBP、最大 20MB、公開URL または data:\{MIME_type};base64,... URL。reference_video はこの操作の入力タイプではありません。 -- happyhorse-1.0-video-edit: video(ちょうど 1 つ。編集対象のクリップ: MP4/MOV、3〜60 秒、長辺が最大 4096 ピクセル、短辺が少なくとも 360 ピクセル、アスペクト比 1:2.5〜2.5:1、最大 100MB、公開 HTTP/HTTPS URL。インラインの data: URL は受け付けられません)に加えて、任意で 0〜5 個の reference_image(JPEG/JPG/PNG/WEBP、少なくとも 300x300 ピクセル、アスペクト比 1:2.5〜2.5:1、最大 20MB、公開URL または data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作です。これらのパートナーのリファレンスにはメディア入力の記載がないため、このフィールドは未設定のままにしてください。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントは、これらの綴りに対してメディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 - -上記のモデルごとの個数は、このスキーマの制約ではなくパートナーの制約です。許容される type とその上限がモデルごとに異なるため、media には minItems/maxItems が宣言されていません。スキーマが受け付けることは、プロバイダーが受け付けることを意味しません。逆に言えば、上記のアセットごとの「最大 20MB」という数値(画像入力に課された上限であり、インラインで送信できる唯一の入力です)は、パートナーが最終的に受け取るアセットに対する上限であり、アセットが公開URL の場合は書かれているとおりに適用されます。そのバイト列が Comfy を経由しないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。また base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに挙げたパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットがパートナー自身の20MB の上限はインラインでも余裕をもって収まるため、アセット 1 つの場合はパートナーのルールが制約となります。複数のアセットにまたがる場合は転送の上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 + メディアアセットのリスト。動画生成に使用する参照素材(画像、オーディオ、ビデオ)を指定します。 +各要素はtypeフィールドとurlフィールドを持ちます。このフィールドはこのコンポーネントから提供される +すべてのモデルで共通ですが、どのtype値が受け入れられるか、また画像やビデオの入力を +img_urlやreference_video_urlsではなくここで渡すかどうかはモデルによって異なります。 +モデルごとの対応type値は次のとおりです。 +- wan2.7-i2v: first_frame、last_frame、driving_audio、first_clip。first_frameと + last_frame:JPEG/JPG/PNG/BMP/WEBP、1辺240-8000ピクセル、アスペクト比率1:8から + 8:1の間、最大20MB、パブリックURLまたはdata:\{MIME_type};base64,... URL。 + driving_audio(WAV/MP3、2-30秒、最大15MB)とfirst_clip(MP4/MOV、2-10 + 秒、1辺240-4096ピクセル、最大100MB):パブリックなHTTP/HTTPS URL。インラインの + data: URLは受け付けられません。 +- wan2.7-r2v: first_frame(任意、最大1)、reference_image、reference_video。少なくとも + reference_imageまたはreference_videoが1つ必要で、reference_imageと + reference_videoの合計は最大5つです。first_frameとreference_image:JPEG/JPG/PNG/BMP/WEBP + (アルファチャンネルなし)、1辺240-8000ピクセル、アスペクト比率1:8から8:1の間、最大 + 20MB、パブリックURLまたはdata:\{MIME_type};base64,... URL。reference_video:パブリックな + HTTP/HTTPS URL。インラインのdata: URLは受け付けられません。 +- wan2.7-videoedit: video(ちょうど1つ。編集対象のクリップ:MP4/MOV、2-10秒、 + 1辺240-4096ピクセル、最大100MB、パブリックなHTTP/HTTPS URL。インラインのdata: URL + は受け付けられません)に加えて、任意で0から4つのreference_image(JPEG/JPG/PNG/BMP/WEBP、 + 1辺240-8000ピクセル、アスペクト比率1:8から8:1の間、最大20MB、パブリックURL + またはdata:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime: first_frame(最大1)、last_frame(最大1)、 + reference_image(最大10)、reference_video(最大5クリップ、合計再生時間\<=15秒)、 + reference_audio(最大5クリップ、合計再生時間\<=15秒)、file(最大1、linkとは併用不可)、 + link(最大1、fileとは併用不可)。reference_*/file/linkタイプと + first_frame/last_frameタイプは同じリクエスト内で同時に使用できません。 + 配列の順序がプロンプト内でのアセットの参照順序を定義します(Image 1、Video 1、 + Audio 1、...)。first_frame、last_frame、reference_image:JPEG/JPG/PNG/BMP/WEBP、 + 1辺240-8000ピクセル、アスペクト比率最大8:1、最大20MB、パブリックURLまたは + data:\{MIME_type};base64,... URL。reference_video、reference_audio、file、link:パブリックな + HTTP/HTTPS URL。インラインのdata: URLは受け付けられません。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v: first_frameのみ、ちょうど1つ。これらの表記は + 先頭フレームをここで受け取り、img_urlでは受け取りません。最小300x300ピクセル、アスペクト比率 + 1:2.5から2.5:1の間、JPEG/JPG/PNG/WEBP、最大20MB、パブリックURLまたは + data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v: reference_imageのみ、1から9つ。これは + このモデル唯一の参照入力です。短辺が最小400ピクセル、JPEG/JPG/PNG/WEBP、 + 最大20MB、パブリックURLまたはdata:\{MIME_type};base64,... URL。この操作ではreference_videoは + 入力タイプではありません。 +- happyhorse-1.0-video-edit: video(ちょうど1つ。編集対象のクリップ:MP4/MOV、3-60 + 秒、長辺が最大4096ピクセル、短辺が最小360ピクセル、アスペクト + 比率1:2.5から2.5:1の間、最大100MB、パブリックなHTTP/HTTPS URL。インラインのdata: + URLは受け付けられません)に加えて、任意で0から5つのreference_image(JPEG/JPG/PNG/WEBP、 + 最小300x300ピクセル、アスペクト比率1:2.5から2.5:1の間、最大20MB、パブリックURL + またはdata:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: + テキストから動画への操作。これらの対応するリファレンスにはメディア入力の記載がないため、 + このフィールドは未設定のままにしてください。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらの表記に対して + メディアの語彙を定義していません。wan2.5-i2v-previewとwan2.6-i2vは先頭 + フレームをimg_urlで受け取り、wan2.6-r2vは参照クリップをreference_video_urlsで受け取ります。 +上記のモデルごとの個数はパートナーの制約であり、このスキーマの制約ではありません。mediaには +minItems/maxItemsが宣言されていません。許容されるtypeとその上限はモデルごとに異なるためです。 +スキーマが受け付けることはプロバイダーが受け付けることを意味しません。また逆に、上記の +アセットごとの「最大20MB」という値(画像入力の上限であり、インラインで送信できる唯一の入力) +は、パートナーが最終的に受け取るアセットに対するパートナーの上限であり、アセットがパブリック +URLである場合はそのまま適用されます。そのバイト列はComfyを経由しないためです。インラインの +data:\{MIME_type};base64,... URLはComfyを経由するため、転送上の上限にも直面します。Comfy Router +のPOSTボディは合計100 MiBに制限され、超えると413が返されます。またbase64はペイロードを +約4/3に膨らませるため、およそ75 MBを超える単一のインラインアセットは、ここに記載された +パートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の20MB の上限はインラインで問題なく収まるため、1 つのアセットについてはパートナーのルールが制約となります。複数のアセットにまたがる場合は転送の上限が制約となります。これは、100 MiB の Router の上限が各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、パブリック URL として送信してください。 メディアアセットの種類 - 指定可能な値: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - メディアファイルの URL。パブリックな HTTP/HTTPS URL、または、上記の `media` の説明で各モデルごとに列挙されているまさにその画像入力(wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image)の場合は、インラインの `data:{MIME_type};base64,...` URL。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスによる oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデル呼び出しを行い、アップロード経路を公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されるのではなく、そのままパートナーに転送されます。モデルごとのサイズとピクセルの制限、およびインラインのペイロードを全体として制限する Router の 100 MiB リクエストボディ上限については、`media` の説明を参照してください。 + メディアファイルの URL: パブリックな HTTP/HTTPS URL、または、上記の `media` の説明でモデルごとに列挙されている画像入力に限り、インラインの `data:{MIME_type};base64,...` URL です。対象となる画像入力は、wan2.7-i2v の first_frame と last_frame、wan2.7-r2v の first_frame と reference_image、wan2.7-videoedit の reference_image、wan3.0-video と wan3.0-video-prime の first_frame、last_frame、reference_image、happyhorse-1.0-i2v と happyhorse-1.1-i2v の first_frame、happyhorse-1.0-r2v と happyhorse-1.1-r2v の reference_image、happyhorse-1.0-video-edit の reference_image です。これらのモデルのいずれにおいても、ビデオ、オーディオ、ファイル、リンクの入力はインラインの data: URL を受け付けません。パートナー自身のアップロードサービスが発行する oss://dashscope-instant の一時 URL、または(wan2.7-videoedit では)Asset Center の asset_id は、それをアップロードした Alibaba Cloud アカウントに対してのみ解決されます。Comfy は自身のキーでモデルを呼び出し、アップロード用のルートを公開していないため、呼び出し元自身の oss:// URL や asset_id はサポートされる入力ではありません。このフィールドは URL スキームを検証しないため、そのような値はここで拒否されることなく、そのままパートナーに転送されます。モデルごとのサイズとピクセルの上限、およびインラインペイロードを全体として制限する 100 MiB の Router リクエストボディの上限については、`media` の説明を参照してください。 - 逆プロンプトの語句は、ビデオ画面に表示したくないコンテンツを記述するために使用します + ネガティブプロンプトの語句は、動画内に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルはそれを拒否せずに切り捨てます。これは prompt と同じ入力予算に算入されます。 - テキストプロンプトの語句。中国語と英語に対応し、長さは 800 文字を超えないこと(wan3.0-video では最大 20,000 文字。制限を超えたコンテンツは切り捨てられます)。 -複数の参照ビデオを使う wan2.6-r2v では、参照ビデオの順序に従って被写体を指すために「character1」「character2」などを使用します。例:「Character1 sings on the roadside, Character2 dances beside it」 -wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを指すために「Image 1」「Video 1」「Audio 1」などを使用します。 + テキストプロンプトの語句。中国語と英語をサポートします。文書化されたそれぞれの長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 文字の中国語)を超えるリクエストは、プロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 +wan2.6-r2v で複数の参照ビデオを使用する場合は、参照ビデオの順序に従って被写体を 'character1'、'character2' などで参照します。例: "Character1 sings on the roadside, Character2 dances beside it" +wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを参照するために 'Image 1'、'Video 1'、'Audio 1' などを使用します。 - wan2.6-r2v モデル専用の参照ビデオ URL。1~3 本のビデオ URL の配列。 + wan2.6-r2v モデル専用の参照ビデオ URL。1〜3 本のビデオ URL の配列。 入力の制限: -- 形式: mp4、mov -- 本数: 1~3 本 -- 単一ビデオの長さ: 2~30 秒 -- 単一ファイルサイズ: 最大 30MB -- audio_url と併用不可 -参照時間: 単一ビデオは最大 5 秒、2 本の場合は各最大 2.5 秒、3 本の場合は比例して短くなります。 -課金: 実際に使用した参照時間に基づきます。 +- 形式: mp4, mov +- 本数: ビデオ 1〜3 本 +- 1 本あたりのビデオの長さ: 2〜30 秒 +- 1 ファイルあたりのファイルサイズ: 最大 30MB +- audio_url と併用できません +参照の再生時間: ビデオ 1 本で最大 5 秒、2 本で各最大 2.5 秒、3 本では比例して短くなります。 +課金: 実際に使用した参照の再生時間に基づきます。 - ビデオエフェクトテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用した場合、prompt パラメータは無視されます。 + ビデオエフェクトのテンプレート名。任意。現在サポートされているのは squish、flying、carousel です。使用すると、prompt パラメータは無視されます。 - 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる綴りの enum はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 + 呼び出すモデルの ID。このコンポーネントでは制約されません。Comfy Router は `POST /v2/models/wan/{model}` の `{model}` パスセグメントからこれを設定するため、Router の呼び出し元は省略します。`POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` への直接の v1 呼び出しでは必ず指定する必要があり、受け付けられる表記の列挙はそのオペレーション自身のコンポーネント `WanVideoGenerationRequest` にあります。 @@ -258,83 +315,84 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime のみでサポートされます。他の wan モデルでは、プロバイダーはそのような切り替えを記載していません。 + ビデオにオーディオを追加するかどうか。wan3.0-video と wan3.0-video-prime でのみサポートされます。他の wan モデルについては、プロバイダーはそのような切り替えを文書化していません。 wan2.7-videoedit モデルのビデオオーディオ設定。 -- auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します +- auto(デフォルト): モデルがプロンプトのコンテンツに基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 指定可能な値: `auto`, `origin` + 指定可能な値: `auto`、`origin` 生成されるビデオの再生時間(秒): - wan2.5 モデル: 5 秒または 10 秒 -- wan2.6-t2v、wan2.6-i2v: 5、10、15 秒 +- wan2.6-t2v、wan2.6-i2v: 5 秒、10 秒、または 15 秒 - wan2.6-r2v: 5 秒または 10 秒のみ(15 秒は非サポート) - wan2.7-i2v、wan2.7-t2v: [2, 15] の整数 - wan2.7-r2v、wan2.7-videoedit: [2, 10] の整数 -- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は入力ビデオの再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 はモデルが適切な再生時間を選ぶスマート再生時間モードを有効にします -このプロキシは [-1, 30] の範囲外の再生時間に対して 400 を返します。 +- wan3.0-video: ビデオ入力なしの場合は [2, 30] の整数。ビデオ入力ありの場合は、入力ビデオの再生時間 + 出力ビデオの再生時間の合計が 30 秒を超えてはなりません。-1 を指定すると、モデルが適切な再生時間を選択するスマート再生時間モードになります。 +このプロキシは、[-1, 30] の範囲外の再生時間に対して 400 を返します。 - 範囲: `-1` ~ `30` + 範囲: `-1` から `30` - プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true + プロンプトのインテリジェントな書き換えを有効にするかどうか。デフォルトは true です。 - 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 -wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 + 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデル専用です。 +wan2.7 モデルでは、指定しない場合、解像度の階層に基づいてデフォルトが決まります。 +wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` 解像度レベル。サポートされる値はモデルによって異なります: -- wan2.5-i2v-preview: 480P、720P、1080P -- wan2.6 モデル(t2v、i2v、r2v): 720P、1080P のみ(480P 非サポート) -- wan2.7 モデル(i2v、t2v、r2v、videoedit): 720P、1080P(デフォルト 1080P) -- wan3.0-video、wan3.0-video-prime: 480P、720P、1080P(アップストリームのデフォルトは 1080P) -- happyhorse-1.0-*(t2v、i2v、r2v、video-edit): 720P、1080P -- happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P -このプロキシは、解像度もサイズも指定されていないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決定するためです。チェックの前に解像度を大文字に変換し、大文字化した値を転送します。この列挙型に含まれない値には 400 を返し、上記で 480P がないと記載されている wan2.6、wan2.7、happyhorse-1.0 モデルでは、480P(解像度として送信された場合も、480P のサイズとして送信された場合も)に対して 400 を返します。 +- wan2.5-i2v-preview: 480P, 720P, 1080P +- wan2.6 モデル (t2v, i2v, r2v): 720P, 1080P のみ (480P はサポートなし) +- wan2.7 モデル (i2v, t2v, r2v, videoedit): 720P, 1080P (デフォルト 1080P) +- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P (上流のデフォルト 1080P) +- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P, 1080P +- happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P +このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。解像度の階層が課金レートを決定するためです。チェックの前に resolution を大文字化し、大文字化した値を転送します。この enum に含まれない値には 400 を返し、上記で 480P 非対応として挙げた wan2.6、wan2.7、happyhorse-1.0 のモデルでは 480P (resolution として送信された場合も、480P の size として送信された場合も) に対して 400 を返します。 指定可能な値: `480P`, `720P`, `1080P` - 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します + 乱数シード。モデルが生成するコンテンツのランダム性を制御するために使用します。 範囲: `0` から `2147483647` - インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ動作します。wan2.6 および wan2.7-r2v モデル用です。 -- single: シングルショットビデオ(デフォルト) -- multi: マルチショットビデオ + インテリジェントなマルチレンズ制御。prompt_extend が有効な場合にのみ機能します。 +wan2.6 および wan2.7-r2v モデル用です。 +- single: 単一ショットのビデオ (デフォルト) +- multi: マルチショットのビデオ 指定可能な値: `multi`, `single` - ビデオの解像度を 幅*高さ の形式で指定します。サポートされる解像度はモデルによって異なります: -wan2.5 T2V の場合: 480P(480*832、832*480、624*624)、720P、1080P の各サイズ -wan2.6 T2V/R2V の場合(480P なし): + 幅*高さ形式で指定するビデオ解像度。サポートされる解像度はモデルによって異なります: +wan2.5 T2V の場合: 480P (480*832, 832*480, 624*624), 720P, 1080P の各サイズ +wan2.6 T2V/R2V の場合 (480P なし): 720P: 1280*720, 720*1280, 960*960, 1088*832, 832*1088 1080P: 1920*1080, 1080*1920, 1440*1440, 1632*1248, 1248*1632 -サイズと解像度の両方を送信した場合、課金される階層を選択するのはサイズであり、解像度は依然としてそのモデルに対してこのプロキシが受け付ける値である必要があります。480P のサイズは、解像度の説明で 480P がないと記載されているすべてのモデルで 400 を返します。 +size と resolution の両方が送信された場合、課金階層を選択するのは size であり、resolution はそのモデルに対してこのプロキシが受け付ける値である必要があります。480P の size は、解像度の説明で 480P 非対応として挙げられているすべてのモデルで 400 を返します。 - ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます + ウォーターマークロゴを追加するかどうか。ウォーターマークは右下隅に配置されます。 -`GET /v2/models/wan/wan2.6-r2v/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 +Router が `GET /v2/models/wan/wan2.6-r2v/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同一のドキュメントです。 ### 出力 @@ -343,27 +401,27 @@ wan2.6 T2V/R2V の場合(480P なし):
- インテリジェントな書き換え後の実際のプロンプト(ビデオタスク用) + インテリジェントな書き換え後の実際のプロンプト (ビデオタスク用) - 音声生成を伴うI2VタスクのオーディオURL + 音声生成を伴う I2V タスク用のオーディオ URL - 失敗したリクエストのエラーコード(リクエストが成功した場合は返されません) + 失敗したリクエストのエラーコード (リクエストが成功した場合は返されません) - タスクの完了時間 + タスク完了時間 - 失敗したリクエストの詳細情報(リクエストが成功した場合は返されません) + 失敗したリクエストの詳細情報 (リクエストが成功した場合は返されません) - オリジナルの入力プロンプト(ビデオタスク用) + オリジナルの入力プロンプト (ビデオタスク用) @@ -371,15 +429,15 @@ wan2.6 T2V/R2V の場合(480P なし): - インテリジェントな書き換え後の実際のプロンプト(有効な場合) + インテリジェントな書き換え後の実際のプロンプト (有効な場合) - 画像のエラーコード(一部のタスクが失敗した場合に返されます) + 画像エラーコード (一部のタスクが失敗した場合に返されます) - 画像のエラー情報(一部のタスクが失敗した場合に返されます) + 画像エラー情報 (一部のタスクが失敗した場合に返されます) @@ -387,19 +445,19 @@ wan2.6 T2V/R2V の場合(480P なし): - 生成された画像のURLアドレス + 生成済み画像の URL アドレス - タスクの実行時間 + タスク実行時間 - タスクの送信時間 + タスク送信時間 - タスクID + タスク ID @@ -415,17 +473,17 @@ wan2.6 T2V/R2V の場合(480P なし): - タスクの合計数 + タスクの総数 - タスクのステータス + タスクステータス - 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 取り得る値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 完了したビデオ生成タスクのビデオURL。リンクの有効期間は24時間です + 完了したビデオ生成タスクのビデオ URL。リンクの有効期間は 24 時間です @@ -437,55 +495,55 @@ wan2.6 T2V/R2V の場合(480P なし): - ビデオ解像度レベル(I2Vおよびwan3.0-videoタスク) + ビデオ解像度レベル (I2V および wan3.0-video タスク) - 生成されたビデオの再生時間(秒)(I2Vおよびwan3.0-videoタスク) + 生成されたビデオの再生時間 (秒単位、I2V および wan3.0-video タスク) - 生成されたビデオのフレームレート(wan3.0-videoタスク) + 生成されたビデオのフレームレート (wan3.0-video タスク) - 生成された画像の数(T2IおよびI2Iタスク) + 生成された画像の数 (T2I および I2I タスク) - 入力ビデオの再生時間(秒)。ビデオ入力がない場合は0.0(wan3.0-videoタスク) + 入力ビデオの再生時間 (秒単位、ビデオ入力がない場合は 0.0、wan3.0-video タスク) - 出力ビデオの再生時間(秒)(wan3.0-videoタスク) + 出力ビデオの再生時間 (秒単位、wan3.0-video タスク) - 生成されたビデオのアスペクト比。例: 16:9(wan3.0-videoタスク) + 生成されたビデオのアスペクト比 (例: 16:9、wan3.0-video タスク) - 画像の解像度(T2IおよびI2Iタスク) + 画像の解像度 (T2I および I2I タスク) - 生成されたビデオの数(T2Vタスク) + 生成されたビデオの数 (T2V タスク) - 生成されたビデオの再生時間(秒)(T2Vタスク) + 生成されたビデオの再生時間 (秒単位、T2V タスク) - ビデオの解像度比率(T2Vタスク) + ビデオの解像度比率 (T2V タスク) - 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。 + 失敗したリクエストのエラーコード。`output` の下ではなく、エンベロープのルートで報告されます (リクエストが成功した場合は返されません)。 - 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます(リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこれを確認してください。 + 失敗したリクエストの詳細情報。`output` の下ではなく、エンベロープのルートで報告されます (リクエストが成功した場合は返されません)。`output.message` にフォールバックする前にこちらを確認してください。 ## 使用例 diff --git a/ja/development/comfy-router/pricing.mdx b/ja/development/comfy-router/pricing.mdx index 20aad65ff9..bebaab861a 100644 --- a/ja/development/comfy-router/pricing.mdx +++ b/ja/development/comfy-router/pricing.mdx @@ -139,8 +139,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Ideogram 4.5](/ja/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 低 | 9.0519 | | [Ideogram 4.5](/ja/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 中 | 18.1038 | | [Ideogram 4.5](/ja/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 高 | 60.346 | -| [Seedream 5.5](/ja/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | レイヤー分離 · 1.5K
出力画像 · 1.5K | 6.0346 | -| [Seedream 5.5](/ja/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | レイヤー分離 · 2K
出力画像 · 2K | 10.56055 | +| [Seedream 5.5](/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | レイヤー分離 · 1.5K
出力画像 · 1.5K | 6.0346 | +| [Seedream 5.5](/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | レイヤー分離 · 2K
出力画像 · 2K | 10.56055 | #### 未公開 @@ -155,7 +155,7 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Qwen Image 3.0](/ja/development/comfy-router/models/qwen/qwen-image-3-0/code) | `qwen/qwen-image-3.0` | 入力画像 · 1K / 2K | 0.9052 / 入力画像 | | [Qwen Image 3.0 Pro](/ja/development/comfy-router/models/qwen/qwen-image-3-0-pro/code) | `qwen/qwen-image-3.0-pro` | 入力画像 · 1K / 2K | 0.9052 / 入力画像 | | [Seedream 5.0 Pro](/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 2 枚目以降の入力画像 | 0.633 / 入力画像 | -| [Seedream 5.5](/ja/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 入力画像 | 2.41384 / 入力画像 | +| [Seedream 5.5](/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 入力画像 | 2.41384 / 入力画像 | #### Recraft クレジットあたりの料金 @@ -882,8 +882,8 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | [Ideogram 4.5](/ja/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 低 | $0.0429 | | [Ideogram 4.5](/ja/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 中 | $0.0858 | | [Ideogram 4.5](/ja/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 高 | $0.286 | -| [Seedream 5.5](/ja/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | レイヤー分離 · 1.5K
出力画像 · 1.5K | $0.0286 | -| [Seedream 5.5](/ja/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | レイヤー分離 · 2K
出力画像 · 2K | $0.05005 | +| [Seedream 5.5](/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | レイヤー分離 · 1.5K
出力画像 · 1.5K | $0.0286 | +| [Seedream 5.5](/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | レイヤー分離 · 2K
出力画像 · 2K | $0.05005 | #### 未公開 @@ -898,7 +898,7 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | [Qwen Image 3.0](/ja/development/comfy-router/models/qwen/qwen-image-3-0/code) | `qwen/qwen-image-3.0` | 入力画像 · 1K / 2K | $0.00429 / 入力画像 | | [Qwen Image 3.0 Pro](/ja/development/comfy-router/models/qwen/qwen-image-3-0-pro/code) | `qwen/qwen-image-3.0-pro` | 入力画像 · 1K / 2K | $0.00429 / 入力画像 | | [Seedream 5.0 Pro](/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 2 枚目以降の入力画像 | $0.003 / 入力画像 | -| [Seedream 5.5](/ja/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 入力画像 | $0.01144 / 入力画像 | +| [Seedream 5.5](/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 入力画像 | $0.01144 / 入力画像 | #### Recraft クレジットあたりの料金 diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index d31c071bc9..78ca91f08c 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -110,7 +110,8 @@ translationBlockHashes: - [Gen 4 Turbo](/ko/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ko/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [클린 오디오 비디오](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`- [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` +- [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` - [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` @@ -164,7 +165,8 @@ translationBlockHashes: - [Image Edit Increase Resolution](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/ko/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/ko/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [이미지 편집 배경 제거 가이드](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` +- [이미지 편집 배경 제거 가이드](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [이미지 편집 배경 제거](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [이미지 편집 배경 교체](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [이미지 편집 텍스트로 객체 교체](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -214,7 +216,8 @@ translationBlockHashes: - [Qwen Image 3.0](/ko/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/ko/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` - [Recraft V3](/ko/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector`- [Recraft V4.1 Pro](/ko/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` +- [Recraft V4.1 Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` +- [Recraft V4.1 Pro](/ko/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/ko/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code): `recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code): `recraft/recraftv4_1_utility_vector` @@ -265,7 +268,8 @@ translationBlockHashes: - [FLUX 3 Video](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128`- [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/ko/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/ko/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` @@ -322,7 +326,8 @@ translationBlockHashes: - [Stable Fast 3D](/ko/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ko/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` - [Hunyuan 3D Part](/ko/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/ko/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology`- [Hunyuan 3D Texture Edit](/ko/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` +- [Hunyuan 3D Smart Topology](/ko/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Texture Edit](/ko/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/ko/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv`
diff --git a/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index edf562a0e2..e5061e60f6 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router에서 Seedream 4.0 250828 사용하기" description: "Comfy Router를 통해 byteplus/seedream-4-0-250828을 호출합니다. 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedream 4.0 250828" -translationSourceHash: e47962e3 +translationSourceHash: 0e2de27d translationFrom: development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx translationBlockHashes: - "_intro": 1d32bb5d - "Quick start": 5ffebfad - "Schema": d11a7253 - "Examples": 7bc7fa59 + "_intro": 3d37b29e + "Quick start": 38e0a75b + "Schema": 66ccdc55 + "Examples": ac35d592 --- diff --git a/ko/development/comfy-router/pricing.mdx b/ko/development/comfy-router/pricing.mdx index f39864a3ee..dc3c884846 100644 --- a/ko/development/comfy-router/pricing.mdx +++ b/ko/development/comfy-router/pricing.mdx @@ -139,8 +139,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Ideogram 4.5](/ko/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 낮음 | 9.0519 | | [Ideogram 4.5](/ko/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 중간 | 18.1038 | | [Ideogram 4.5](/ko/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 높음 | 60.346 | -| [Seedream 5.5](/ko/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 레이어 분리 · 1.5K
출력 이미지 · 1.5K | 6.0346 | -| [Seedream 5.5](/ko/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 레이어 분리 · 2K
출력 이미지 · 2K | 10.56055 | +| [Seedream 5.5](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 레이어 분리 · 1.5K
출력 이미지 · 1.5K | 6.0346 | +| [Seedream 5.5](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 레이어 분리 · 2K
출력 이미지 · 2K | 10.56055 | #### 게시되지 않음 @@ -155,7 +155,7 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Qwen Image 3.0](/ko/development/comfy-router/models/qwen/qwen-image-3-0/code) | `qwen/qwen-image-3.0` | 입력 이미지 · 1K / 2K | 0.9052 / 입력 이미지 | | [Qwen Image 3.0 Pro](/ko/development/comfy-router/models/qwen/qwen-image-3-0-pro/code) | `qwen/qwen-image-3.0-pro` | 입력 이미지 · 1K / 2K | 0.9052 / 입력 이미지 | | [Seedream 5.0 Pro](/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 두 번째부터의 입력 이미지 | 0.633 / 입력 이미지 | -| [Seedream 5.5](/ko/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 입력 이미지 | 2.41384 / 입력 이미지 | +| [Seedream 5.5](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 입력 이미지 | 2.41384 / 입력 이미지 | #### Recraft 크레딧당 요금 @@ -882,8 +882,8 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | [Ideogram 4.5](/ko/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 낮음 | $0.0429 | | [Ideogram 4.5](/ko/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 중간 | $0.0858 | | [Ideogram 4.5](/ko/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 높음 | $0.286 | -| [Seedream 5.5](/ko/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 레이어 분리 · 1.5K
출력 이미지 · 1.5K | $0.0286 | -| [Seedream 5.5](/ko/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 레이어 분리 · 2K
출력 이미지 · 2K | $0.05005 | +| [Seedream 5.5](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 레이어 분리 · 1.5K
출력 이미지 · 1.5K | $0.0286 | +| [Seedream 5.5](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 레이어 분리 · 2K
출력 이미지 · 2K | $0.05005 | #### 게시되지 않음 @@ -898,7 +898,7 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | [Qwen Image 3.0](/ko/development/comfy-router/models/qwen/qwen-image-3-0/code) | `qwen/qwen-image-3.0` | 입력 이미지 · 1K / 2K | $0.00429 / 입력 이미지 | | [Qwen Image 3.0 Pro](/ko/development/comfy-router/models/qwen/qwen-image-3-0-pro/code) | `qwen/qwen-image-3.0-pro` | 입력 이미지 · 1K / 2K | $0.00429 / 입력 이미지 | | [Seedream 5.0 Pro](/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 두 번째부터의 입력 이미지 | $0.003 / 입력 이미지 | -| [Seedream 5.5](/ko/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 입력 이미지 | $0.01144 / 입력 이미지 | +| [Seedream 5.5](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 입력 이미지 | $0.01144 / 입력 이미지 | #### Recraft 크레딧당 요금 diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index 4c382131b0..542ef95afe 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -110,7 +110,8 @@ translationBlockHashes: - [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code):`runway/gen4_turbo` - [Sync 3](/zh/development/comfy-router/models/synclabs/sync-3/code):`synclabs/sync-3` - [Clean Audio Video](/zh/development/comfy-router/models/veed/clean-audio-video/code):`veed/clean-audio-video` -- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0`- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` +- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0` +- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` - [Video Background Removal Fast](/zh/development/comfy-router/models/veed/video-background-removal-fast/code):`veed/video-background-removal-fast` - [Video Background Removal Green Screen](/zh/development/comfy-router/models/veed/video-background-removal-green-screen/code):`veed/video-background-removal-green-screen` - [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal` @@ -164,7 +165,8 @@ translationBlockHashes: - [图像编辑:提升分辨率](/zh/development/comfy-router/models/bria/image-edit-increase-resolution/code):`bria/image-edit-increase-resolution` - [图像编辑:产品手持](/zh/development/comfy-router/models/bria/image-edit-product-holding/code):`bria/image-edit-product-holding` - [图像编辑:产品虚拟试穿](/zh/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code):`bria/image-edit-product-virtual-tryon` -- [图像编辑:重新打光](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight`- [图像编辑:移除背景(引导)](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` +- [图像编辑:重新打光](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight` +- [图像编辑:移除背景(引导)](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` - [图像编辑:移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background/code):`bria/image-edit-remove-background` - [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background` - [图像编辑:按文本替换对象](/zh/development/comfy-router/models/bria/image-edit-replace-object-by-text/code):`bria/image-edit-replace-object-by-text` @@ -214,7 +216,8 @@ translationBlockHashes: - [Qwen Image 3.0](/zh/development/comfy-router/models/qwen/qwen-image-3-0/code):`qwen/qwen-image-3.0` - [Recraft V2](/zh/development/comfy-router/models/recraft/recraftv2/code):`recraft/recraftv2` - [Recraft V3](/zh/development/comfy-router/models/recraft/recraftv3/code):`recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code):`recraft/recraftv4_1_pro_vector`- [Recraft V4.1 Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-pro/code):`recraft/recraftv4_1_pro` +- [Recraft V4.1 Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code):`recraft/recraftv4_1_pro_vector` +- [Recraft V4.1 Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-pro/code):`recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code):`recraft/recraftv4_1_utility_pro_vector` - [Recraft V4.1 Utility Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code):`recraft/recraftv4_1_utility_pro` - [Recraft V4.1 Utility Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code):`recraft/recraftv4_1_utility_vector` @@ -265,7 +268,8 @@ translationBlockHashes: - [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code):`bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code):`byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128`- [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code):`byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code):`byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code):`byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/zh/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code):`byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/zh/development/comfy-router/models/byteplus/seed-audio-1-0/code):`byteplus/seed-audio-1.0` @@ -322,7 +326,8 @@ translationBlockHashes: - [Stable Fast 3D](/zh/development/comfy-router/models/stability/stable-fast-3d/code):`stability/stable-fast-3d` - [Stable Point Aware 3D](/zh/development/comfy-router/models/stability/stable-point-aware-3d/code):`stability/stable-point-aware-3d` - [Hunyuan 3D Part](/zh/development/comfy-router/models/tencent/hunyuan-3d-part/code):`tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology`- [Hunyuan 3D Texture Edit](/zh/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code):`tencent/hunyuan-3d-texture-edit` +- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Texture Edit](/zh/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code):`tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/zh/development/comfy-router/models/tencent/hunyuan-3d-uv/code):`tencent/hunyuan-3d-uv` diff --git a/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index e709f80e45..ab3654e9e0 100644 --- a/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Wan 2.6 R2V" description: "通过 Comfy Router 以 HTTP 方式调用 wan/wan2.6-r2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果结构" sidebarTitle: "Wan 2.6 R2V" -translationSourceHash: 2a7dc724 +translationSourceHash: f2cccfce translationFrom: development/comfy-router/models/wan/wan2-6-r2v/code.mdx translationBlockHashes: "_intro": dc2fc376 "Quick start": 066eb9ee - "Schema": 104ab356 + "Schema": 789f5781 "Examples": dd88ebee --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -191,122 +192,67 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-r2v/requests/$REQUEST_ID \ - 音频文件下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载网址。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 - 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型为必填。happyhorse-1.x 的 i2v 写法并不在此处接收其首帧, - 它们将首帧作为类型为 first_frame 的媒体元素传入(见下文 media),而一个在 - wan2.6-i2v 上能够成功通过的 img_url 请求体,会被提供商在 - happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;而 wan2.7/wan3.0 的写法同样在 - media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 - 分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像网址或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。happyhorse-1.x 的 i2v 拼写不在此处接收首帧:它们将首帧作为 type 为 first_frame 的 media 元素传入(参见下文 media);并且在 wan2.6-i2v 上能够成功的 img_url 请求体,在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上会被提供商拒绝;wan2.7/wan3.0 的拼写同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。用于为视频生成指定参考素材(图像、音频、视频)。 - 每个元素包含一个 type 字段和一个 url 字段。该字段由本组件提供的所有 - 模型共用,而给定模型接受哪些 type 值(以及它究竟是这里携带其图像或视频输入, - 而不是放在 img_url 或 reference_video_urls 中)会因模型而异。各模型支持的 type - 值如下: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 - 到 8:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 - 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS 网址;不接受内联 - data: 网址。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要 1 个 reference_image 或 reference_video,且参考图像加 - 参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP - (不含透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 - 20MB,公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开的 - HTTP/HTTPS 网址;不接受内联 data: 网址。 -- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址) - 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公开网址 - 或 data:\{MIME_type};base64,... 网址)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、 - reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15s)、 - reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能 - 与 link 一起使用)、link(最多 1 个,不能与 file 一起使用)。reference_*/file/link - 类型与 first_frame/last_frame 类型在同一请求中互斥。 - 数组顺序决定了提示词中资产的参考顺序(Image 1、Video 1、 - Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公开网址或 - data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link: - 公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,且恰好 1 个。这些写法 - 在此处接收其首帧,而不是在 img_url 中。至少 300x300 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公开网址或 - data:\{MIME_type};base64,... 网址。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是 - 该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP, - 最大 20MB,公开网址或 data:\{MIME_type};base64,... 网址。reference_video - 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 - 秒,最长边最大 4096 像素,最短边至少 360 像素,宽高比 - 在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: - 网址)外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 - 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公开网址 - 或 data:\{MIME_type};base64,... 网址)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: - 文生视频操作。其对应的合作伙伴参考文档未记载任何媒体输入,因此请 - 保持该字段未设置。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件没有为这些写法列举任何 media - 取值。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入其首 - 帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 -上面各模型的计数是合作伙伴的限制,而不是本 schema 的限制:media 上 -没有声明 minItems/maxItems,因为可接受的类型及其上限 -因模型而异。schema 接受并不意味着提供商接受;反过来说,上面每一项资产 -“最大 20MB”的数值(即图像输入的上限,图像输入是唯一可能以内联方式发送的输入) -是合作伙伴对其最终接收资产的限制,当资产是公开网址时它们按原文适用, -因为这些字节从不经过 Comfy。内联 data:\{MIME_type};base64,... -网址则会经过 Comfy,同时还要受到传输上限的限制:Comfy Router -的 POST 请求体总计上限为 100 MiB,超出则返回 413,而 base64 会使 -负载增大约 4/3,因此单个内联资产若超过大约 75 MB,会在触达此处任何 -合作伙伴规则之前就被拒绝。在该大小下,单个资产即使处于合作伙伴自身的20MB 上限可轻松容纳内联数据,因此对于单个资产而言,真正起作用的是合作伙伴规则;而当涉及多个资产时,起作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。任何接近这些上限的内容,请以公开 URL 的形式发送。 + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由此组件提供的所有模型共用,而给定模型接受哪些 type 值,以及它究竟是把图像或视频输入放在这里而非 img_url 或 reference_video_urls 中,都因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- wan2.7-r2v: first_frame(可选,最大 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,且参考图像加参考视频总计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(不含透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址。reference_video:公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- wan2.7-videoedit: video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址)。 +- wan3.0-video, wan3.0-video-prime: first_frame(最大 1 个)、last_frame(最大 1 个)、reference_image(最大 10 个)、reference_video(最大 5 个片段,总时长 \<= 15s)、reference_audio(最大 5 个片段,总时长 \<= 15s)、file(最大 1 个,不能与 link 同时使用)、link(最大 1 个,不能与 file 同时使用)。reference_*/file/link 类型与 first_frame/last_frame 类型在同一请求内互斥。数组顺序决定资产在提示词中的参考顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址。reference_video、reference_audio、file 和 link:公开的 HTTP/HTTPS 网址;不接受内联 data: 网址。 +- happyhorse-1.0-i2v, happyhorse-1.1-i2v: 仅 first_frame,恰好 1 个。这些拼写在此处接收首帧,而不是在 img_url 中。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址。 +- happyhorse-1.0-r2v, happyhorse-1.1-r2v: 仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址。reference_video 不是此操作的输入类型。 +- happyhorse-1.0-video-edit: video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可使用公开网址或 data:\{MIME_type};base64,... 网址)。 +- happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: 文生视频操作。其对应的参考文档未记载任何 media 输入,因此请保持此字段不设置。 +- wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 本组件未为这些拼写枚举任何 media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 + +上述各模型的计数是合作伙伴的限制,而不是本 Schema 的限制:media 上没有声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受;反过来说,上文每个资产的“最多 20MB”数值,也就是图像输入(唯一可以内联发送的输入)的上限,是合作伙伴对其最终接收到的资产所设的上限,当资产是公开网址时,这些数值按原文生效,因为这些字节从不经过 Comfy。而内联的 data:\{MIME_type};base64,... 网址确实会经过 Comfy,并同样要面对一个传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过就返回 413,而 base64 会使负载膨胀约 4/3,因此单个内联资产一旦超过大约 75 MB,就会在触及这里的任何合作伙伴规则之前被拒绝。在这样的体积下,单个资产按合作伙伴自身的 +20MB 上限可轻松容纳内联内容,因此对于单个资产,起约束作用的是合作伙伴规则;而涉及多个资产时则受传输上限约束,因为 Router 的 100 MiB 上限约束的是整个请求,而非每个元素。任何接近这些上限的内容,请以公共 URL 形式发送。 媒体资产类型 - 可能的值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 可选值:`first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` - 媒体文件的 URL:公开的 HTTP/HTTPS URL,或者(仅针对上文 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)内联的 `data:{MIME_type};base64,...` URL。这些模型上没有任何视频、音频、文件或链接输入接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不提供任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 并不是受支持的输入。此字段不校验 URL scheme,因此这类值会被原样转发给合作伙伴,而不会在这里被拒绝。有关各模型的尺寸和像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参阅 `media` 描述。 + 媒体文件的 URL:一个公共 HTTP/HTTPS URL;或者,仅对上方 `media` 描述中为各模型列出的 IMAGE 输入(wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image),可以是内联的 `data:{MIME_type};base64,...` URL。这些模型上任何视频、音频、文件或 link 输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能对上传它的那个阿里云账户生效;Comfy 使用自己的密钥发起模型调用,且不提供上传通道,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。此字段不校验 URL 的协议,因此这类值会原样转发给合作伙伴,而不会在此处被拒绝。各模型的大小与像素限制,以及约束内联载荷总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中出现的内容 + 反向提示词用于描述你不希望在视频画面中看到的内容。超过 500 个字符时,wan 模型会截断它,而不是拒绝它。它与 prompt 计入同一输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符(wan3.0-video 最多可到 20,000 个字符;超出限制的内容会被截断)。 -对于带多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。 -示例:“Character1 在路边唱歌,Character2 在一旁跳舞” -对于 wan3.0-video 的参考模式,请按 media 数组中的对应顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 + 文本提示词。支持中文和英文。超过各自文档规定的长度时,wan2.x 模型会截断提示词,而不是拒绝它:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。如果 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个汉字),提供商将拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对于带有多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。示例:"Character1 在路边唱歌,Character2 在旁边跳舞" +对于 wan3.0-video 的参考模式,请使用 'Image 1'、'Video 1'、'Audio 1' 等,按媒体数组中对应的顺序指代媒体资产。 - 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。1-3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 - 单个视频时长:2-30 秒 - 单个文件大小:最大 30MB - 不能与 audio_url 一起使用 -参考时长:单个视频最大 5 秒,两个视频各最大 2.5 秒,三个视频按比例更短。 -计费:按实际使用的参考时长计费。 +参考时长:单个视频最长 5s,两个视频每个最长 2.5s,三个视频按比例更短。 +计费:按实际使用的参考时长计算。 - 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。在此组件上不受约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填充它,因此 Router 调用方会省略该字段。直接以 v1 方式调用 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 时必须提供它,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。此组件上不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段中填入它,因此 Router 调用方可以省略。直接对 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 发起 v1 调用时则必须提供它,可接受的拼写枚举位于该操作自己的组件 `WanVideoGenerationRequest` 上。 @@ -314,52 +260,53 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-r2v/requests/$REQUEST_ID \ - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 Wan 模型记录此类切换。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 wan 模型记录此类开关。 wan2.7-videoedit 模型的视频音频设置。 - auto(默认):模型根据提示词内容智能判断 -- origin:强制保留输入视频中的原始音频 +- origin:强制保留输入视频的原始音频 - 可能的值:`auto`、`origin` + 可选值:`auto`、`origin` - 已生成视频的时长,单位为秒: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 -- wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:没有视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -该代理对超出 [-1, 30] 的时长返回 400。 +- wan2.6-r2v:仅 5 或 10 秒(不支持 15s) +- wan2.7-i2v、wan2.7-t2v:[2, 15] 区间内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 区间内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 区间内的整数;有视频输入时, + 输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式, + 由模型选择合适的时长 +此代理对超出 [-1, 30] 的 duration 返回 400。 范围:`-1` 到 `30` - 是否启用提示词智能改写。默认值为 true + 是否启用提示词智能改写。默认为 true - 已生成视频的宽高比例。仅适用于 wan2.7 和 wan3.0 模型。 + 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比例。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` - 分辨率档位。支持的值因模型而异: + 分辨率等级。支持的值因模型而异: - wan2.5-i2v-preview:480P、720P、1080P -- wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) +- wan2.6 模型(t2v、i2v、r2v):仅支持 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video, wan3.0-video-prime: 480P, 720P, 1080P(上游默认 1080P) -- happyhorse-1.0-*(t2v, i2v, r2v, video-edit): 720P, 1080P -- happyhorse-1.1-*(t2v, i2v, r2v): 480P, 720P, 1080P - -该代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。代理在校验之前先将 resolution 转为大写,并转发大写后的值;对于不在此枚举范围内的值返回 400;对于上文列出的不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,无论以 resolution 还是以 480P 的 size 形式传入 480P,都会返回 400。 +- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +本代理会拒绝既不提供 resolution 也不提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查前先将 resolution 转为大写并转发大写后的值,对于不在该枚举范围内的值返回 400,对于上文列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,返回 400(无论该 480P 是以 resolution 还是以 480P 的 size 形式发送)。 可能的值:`480P`、`720P`、`1080P` @@ -367,32 +314,32 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-r2v/requests/$REQUEST_ID \ 随机数种子,用于控制模型生成内容的随机性 - 范围:`0` 到 `2147483647` + 取值范围:`0` 到 `2147483647` - 智能多镜头控制。仅在启用 prompt_extend 时生效。 + 智能多镜头控制。仅在 prompt_extend 启用时生效。 适用于 wan2.6 和 wan2.7-r2v 模型。 -- single: 单镜头视频(默认) -- multi: 多镜头视频 +- single:单镜头视频(默认) +- multi:多镜头视频 可能的值:`multi`、`single` - 视频分辨率,格式为 width*height。支持的分辨率因模型而异: -wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -wan2.6 T2V/R2V(无 480P): + 视频分辨率,格式为 width*height。支持的尺寸因模型而异: +对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 +对于 wan2.6 T2V/R2V(不支持 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时传入 size 和 resolution 时,由 size 决定计费的档位,而 resolution 仍必须是该代理对此模型接受的值。对于分辨率描述中列出不支持 480P 的每个模型,传入 480P 的 size 都会返回 400。 +当同时发送 size 和 resolution 时,由 size 选择计费档位,而 resolution 仍必须是本代理针对该模型接受的值。对于分辨率描述中列为不支持 480P 的所有模型,发送 480P 的 size 都会返回 400。 - 是否添加水印标识,水印位于右下角 + 是否添加水印 logo,水印位于右下角 -本文档根据 Router 在 `GET /v2/models/wan/wan2.6-r2v/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前 Router 用于校验调用的同一份文档。 +本文档由 Router 在 `GET /v2/models/wan/wan2.6-r2v/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用所依据的同一份文档。 ### 输出 @@ -405,7 +352,7 @@ wan2.6 T2V/R2V(无 480P): - 带音频生成的 I2V 任务的音频 URL + 带音频生成的 I2V 任务的音频网址 @@ -429,7 +376,7 @@ wan2.6 T2V/R2V(无 480P): - 智能改写后的实际提示词(如已启用) + 智能改写后的实际提示词(若启用) @@ -445,7 +392,7 @@ wan2.6 T2V/R2V(无 480P): - 已生成图像的 URL 地址 + 已生成图像的网址 @@ -479,11 +426,11 @@ wan2.6 T2V/R2V(无 480P): 任务状态 - 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可能值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频 URL。链接有效期为 24 小时 + 已完成视频生成任务的视频网址。链接有效期为 24 小时 @@ -495,11 +442,11 @@ wan2.6 T2V/R2V(无 480P): - 视频分辨率等级(I2V 和 wan3.0-video 任务) + 视频分辨率等级(I2V 与 wan3.0-video 任务) - 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) + 已生成视频的时长,单位为秒(I2V 与 wan3.0-video 任务) @@ -507,7 +454,7 @@ wan2.6 T2V/R2V(无 480P): - 已生成图像的数量(T2I 和 I2I 任务) + 已生成图像的数量(T2I 与 I2I 任务) @@ -523,7 +470,7 @@ wan2.6 T2V/R2V(无 480P): - 图像分辨率(T2I 和 I2I 任务) + 图像分辨率(T2I 与 I2I 任务) @@ -539,11 +486,11 @@ wan2.6 T2V/R2V(无 480P): - 失败请求的错误码,在响应信封的根层级返回,而不是在 `output` 下(请求成功时不返回)。 + 失败请求的错误码,报告在响应包络的根层级而不是 `output` 下(请求成功时不返回)。 - 失败请求的详细信息,在响应信封的根层级返回,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 + 失败请求的详细信息,报告在响应包络的根层级而不是 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先阅读此项。 ## 示例 diff --git a/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index 55ac85956b..62e949215a 100644 --- a/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -2,12 +2,12 @@ title: "使用 Comfy Router 调用 Wan 2.7 R2V" description: "通过 Comfy Router 以 HTTP 方式调用 wan/wan2.7-r2v 的 Python、TypeScript 和 cURL 代码片段,以及请求字段和结果形状" sidebarTitle: "Wan 2.7 R2V" -translationSourceHash: f1b372da +translationSourceHash: fc3b1068 translationFrom: development/comfy-router/models/wan/wan2-7-r2v/code.mdx translationBlockHashes: "_intro": 5428b08c "Quick start": 204ef296 - "Schema": 18b98be3 + "Schema": 7d82934a "Examples": a91cb6b1 --- @@ -15,6 +15,8 @@ translationBlockHashes: + + {/* 生成文件。请编辑本目录下的 code.yaml 并运行 `pnpm code-pages:gen`。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -211,74 +213,26 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-r2v/requests/$REQUEST_ID \ - 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 一起使用。 + 音频文件下载 URL。支持的格式:mp3 和 wav。不能与 reference_video_urls 同时使用。 - 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型必填。 -happyhorse-1.x 的 i2v 型号并不在此处传入首帧,它们将其作为类型为 first_frame 的 -media 元素传入(参见下方的 media),而且在 wan2.6-i2v 上能通过的 img_url 请求体, -会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;wan2.7/wan3.0 这些 -型号同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 -分辨率:360-2000 像素。文件大小:最大 10MB。 + 首帧图像 URL 或 Base64 编码数据。wan2.5-i2v-preview 和 wan2.6-i2v 模型为必填。happyhorse-1.x i2v 这些写法不在此处接收首帧:它们将首帧作为 type 为 first_frame 的 media 元素传入(见下方 media);在 wan2.6-i2v 上成功的 img_url 请求正文会被提供商在 happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上拒绝;而 wan2.7/wan3.0 这些写法同样在 media 中传入其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。分辨率:360-2000 像素。文件大小:最大 10MB。 - 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含一个 -type 字段和一个 url 字段。此字段由此组件提供的所有模型共用,而某个模型接受哪些 -type 值,以及它是否在此处而非 img_url 或 reference_video_urls 中携带其图像或视频 -输入,都因模型而异。各模型支持的 type 值如下: -- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 - last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比介于 1:8 与 8:1 - 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。 - driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB):公共 HTTP/HTTPS URL;不接受内联 data: URL。 -- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少 - 需要 1 个 reference_image 或 reference_video,且参考图像加参考视频总数最多 - 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道), - 每边 240-8000 像素,宽高比介于 1:8 与 8:1 之间,最大 20MB,公共 URL 或 - data:\{MIME_type};base64,... URL。reference_video:公共 HTTP/HTTPS URL;不接受 - 内联 data: URL。 -- wan2.7-videoedit:video(恰好 1 个,即被编辑的片段:MP4/MOV,2-10 秒, - 每边 240-4096 像素,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL), - 外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP, - 每边 240-8000 像素,宽高比介于 1:8 与 8:1 之间,最大 20MB,公共 URL 或 - data:\{MIME_type};base64,... URL)。 -- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 - 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 - \<= 15s)、reference_audio(最多 5 个片段,总时长 \<= 15s)、file(最多 1 个,不能 - 与 link 同时使用)、link(最多 1 个,不能与 file 同时使用)。reference_*/file/link - 类型与 first_frame/last_frame 类型在同一请求中互斥。数组顺序决定提示中资产的参考 - 顺序(Image 1、Video 1、Audio 1……)。first_frame、last_frame 和 - reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1, - 最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video、 - reference_audio、file 和 link:公共 HTTP/HTTPS URL;不接受内联 data: URL。 -- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,恰好 1 个。这些型号在 - 此处传入首帧,而不是在 img_url 中传入。至少 300x300 像素,宽高比介于 1:2.5 与 - 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 - data:\{MIME_type};base64,... URL。 -- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该 - 模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,公共 - URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 -- happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒, - 最长边最大 4096 像素,最短边至少 360 像素,宽高比介于 1:2.5 与 2.5:1 之间,最大 - 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 - reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比介于 1:2.5 与 - 2.5:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 -- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、 - wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记录任何 media 输入,因此 - 请不要设置此字段。 -- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件未为这些型号列举任何 media - 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入首帧;wan2.6-r2v 在 - reference_video_urls 中传入其参考片段。 -上述按模型的计数是合作伙伴的限制,而不是本 schema 的限制:media 上未声明 -minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不意味着提供 -商接受;反过来,上面的每资产“最大 20MB”数字(图像输入的上限,也是唯一可以内联发送 -的输入)是合作伙伴对其最终所获资产的上限,当资产是公共 URL 时按字面适用,因为这些 -字节从不经过 Comfy。内联 data:\{MIME_type};base64,... URL 确实经过 Comfy,并且同样 -会遇到传输层上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过则返回 413, -而 base64 会使负载膨胀约 4/3,因此单个内联资产若超过约 75 MB,会在触及此处任何合作 -伙伴规则之前就被拒绝。在这种大小下,单个资产按合作伙伴自身的20MB 的上限以内联方式发送完全放得下,因此对于单个资产而言,起约束作用的是合作伙伴规则;而对于多个资产,起约束作用的是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中每个元素。任何接近这些上限的内容,都请以公开 URL 的形式发送。 + 媒体资产列表。指定用于视频生成的参考素材(图像、音频、视频)。每个元素包含 type 和 url 字段。此字段由该组件提供的所有模型共用,而给定模型接受哪些 type 值,以及它是否完全不在此处、而是在 img_url 或 reference_video_urls 中承载其图像或视频输入,会因模型而异。各模型支持的 type 值如下: +- wan2.7-i2v:first_frame、last_frame、driving_audio、first_clip。first_frame 和 last_frame:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。driving_audio(WAV/MP3,2-30 秒,最大 15MB)和 first_clip(MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB):公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-r2v:first_frame(可选,最多 1 个)、reference_image、reference_video。至少需要一个 reference_image 或 reference_video,并且参考图像与参考视频合计最多 5 个。first_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP(无透明度通道),每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video:公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- wan2.7-videoedit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,2-10 秒,每边 240-4096 像素,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 4 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比在 1:8 到 8:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 +- wan3.0-video、wan3.0-video-prime:first_frame(最多 1 个)、last_frame(最多 1 个)、reference_image(最多 10 个)、reference_video(最多 5 个片段,总时长 \<= 15 秒)、reference_audio(最多 5 个片段,总时长 \<= 15 秒)、file(最多 1 个,不能与 link 同时使用)、link(最多 1 个,不能与 file 同时使用)。在同一请求中,reference_*/file/link 类型与 first_frame/last_frame 类型互斥。数组顺序定义提示词中资产的参考顺序(图像 1、视频 1、音频 1、...)。first_frame、last_frame 和 reference_image:JPEG/JPG/PNG/BMP/WEBP,每边 240-8000 像素,宽高比最大 8:1,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video、reference_audio、file 和 link:公共 HTTP/HTTPS URL;不接受内联 data: URL。 +- happyhorse-1.0-i2v、happyhorse-1.1-i2v:仅 first_frame,且恰好 1 个。这些写法在此处而非 img_url 中传入首帧。至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。 +- happyhorse-1.0-r2v、happyhorse-1.1-r2v:仅 reference_image,1 到 9 个。这是该模型唯一的参考输入。最短边至少 400 像素,JPEG/JPG/PNG/WEBP,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL。reference_video 不是此操作的输入类型。 +- happyhorse-1.0-video-edit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 +- happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记录任何 media 输入,因此不要设置此字段。 +- wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些写法枚举任何 media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入其首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 +上述各模型的计数是合作伙伴的约束,不是此 schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不意味着提供商接受;另一方面,上面每个资产“最大 20MB”的数值(即图像输入的上限,也是唯一可能以内联方式发送的输入)是合作伙伴对其最终获得的资产的上限,并且当资产是公共 URL 时按原文适用,因为这些字节从不经过 Comfy。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy,并且还会遇到传输上限:Comfy Router 的 POST 正文总计上限为 100 MiB,超过即返回 413;base64 会使负载膨胀约 4/3,因此单个内联资产若超过大约 75 MB,就会在触达这里的任何合作伙伴规则之前被拒绝。在这种大小下,单个资产在合作伙伴自身的 +20MB 的上限可以轻松容纳内联数据,因此对于单个资产而言,真正起约束作用的是合作伙伴规则;而对于多个资产,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,请以公共 URL 的形式发送。 @@ -288,39 +242,37 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 媒体文件的 URL:公开的 HTTP/HTTPS URL;或者(仅针对上文 `media` 描述中为各模型列出的 IMAGE 输入:wan2.7-i2v 的 first_frame 和 last_frame;wan2.7-r2v 的 first_frame 和 reference_image;wan2.7-videoedit 的 reference_image;wan3.0-video 和 wan3.0-video-prime 的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 的 reference_image;以及 happyhorse-1.0-video-edit 的 reference_image)是内联的 `data:{MIME_type};base64,...` URL。在这些模型上,任何视频、音频、文件或链接输入都不接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,仅能在上传它的那个阿里云账号下解析;Comfy 使用自己的密钥发起模型调用,且不开放任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。该字段不校验 URL scheme,因此这类值会按原样转发给合作伙伴,而不会在这里被拒绝。各模型的大小与像素限制,以及以整体方式约束内联负载的 100 MiB Router 请求体上限,请参见 `media` 描述。 + 媒体文件的 URL:可以是公共 HTTP/HTTPS URL,或者,仅限上文 `media` 描述中为各模型列出的那些 IMAGE 输入:wan2.7-i2v 上的 first_frame 和 last_frame;wan2.7-r2v 上的 first_frame 和 reference_image;wan2.7-videoedit 上的 reference_image;wan3.0-video 和 wan3.0-video-prime 上的 first_frame、last_frame 和 reference_image;happyhorse-1.0-i2v 和 happyhorse-1.1-i2v 上的 first_frame;happyhorse-1.0-r2v 和 happyhorse-1.1-r2v 上的 reference_image;以及 happyhorse-1.0-video-edit 上的 reference_image。除此之外,也可以是内联的 `data:{MIME_type};base64,...` URL。这些模型上没有任何视频、音频、文件或连线输入接受内联 data: URL。来自合作伙伴自有上传服务的 oss://dashscope-instant 临时 URL,或(在 wan2.7-videoedit 上)Asset Center 的 asset_id,只能针对上传它的那个阿里云账号解析;Comfy 使用自己的密钥发起模型调用,并且不开放任何上传途径,因此调用方自己的 oss:// URL 或 asset_id 不是受支持的输入。本字段不校验 URL scheme,因此这类值会原样转发给合作伙伴,而不会在此处被拒绝。各模型的大小与像素限制,以及约束内联负载总量的 100 MiB Router 请求体上限,请参见 `media` 描述。 - 反向提示词用于描述你不希望在视频画面中出现的内容 + 反向提示词用于描述你不希望在视频画面中出现的内容。超过 500 个字符时,Wan 模型会对其进行截断,而不是拒绝该请求。它和 prompt 一样计入相同的输入预算。 - 文本提示词。支持中文和英文,长度不超过 800 个字符 -(wan3.0-video 最多 20,000 个字符;超出限制的内容会被截断)。 -对于使用多个参考视频的 wan2.6-r2v,请按参考视频的顺序使用 'character1'、'character2' 等来指代主体。 -示例:"Character1 sings on the roadside, Character2 dances beside it" -对于 wan3.0-video 参考模式,请按媒体数组中的对应顺序使用 'Image 1'、'Video 1'、'Audio 1' 等来指代媒体资产。 + 文本提示词。支持中文和英文。超过各自文档记载的长度时,wan2.x 模型会截断提示词而不是拒绝该请求:wan2.5 和 wan2.6 为 1,500 个字符,wan2.7 为 5,000 个字符。wan3.0-video 和 wan3.0-video-prime 最多接受 20,000 个字符。如果 prompt 与 negative_prompt 合计超过约 60,850 字节的 UTF-8 文本(约 20,000 个汉字),提供商会拒绝该请求,并返回 InvalidParameter `Range of input length should be [1, 61440]`。 +对 wan2.6-r2v 使用多个参考视频时,请用 'character1'、'character2' 等按参考视频的顺序指代主体。示例:"Character1 sings on the roadside, Character2 dances beside it" +对 wan3.0-video 的参考模式,请用 'Image 1'、'Video 1'、'Audio 1' 等按媒体数组中的相应顺序指代媒体资产。 - 仅适用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 + 仅用于 wan2.6-r2v 模型的参考视频 URL。由 1-3 个视频 URL 组成的数组。 输入限制: - 格式:mp4、mov - 数量:1-3 个视频 -- 单个视频长度:2-30 秒 +- 单个视频时长:2-30 秒 - 单个文件大小:最大 30MB -- 不能与 audio_url 一起使用 -参考时长:单个视频最长 5 秒,两个视频各最长 2.5 秒,三个视频按比例更短。 -计费:基于实际使用的参考时长。 +- 不能与 audio_url 同时使用 +参考时长:单个视频最多 5 秒,两个视频各最多 2.5 秒,三个视频按比例更短。 +计费:按实际使用的参考时长计费。 - 视频效果模板名称。可选。当前支持:squish、flying、carousel。使用时,prompt 参数会被忽略。 + 视频特效模板名称。可选。目前支持:squish、flying、carousel。使用时,prompt 参数将被忽略。 - 要调用的模型 ID。本组件不对其进行约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接以 v1 调用 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 时必须提供它,可接受的拼写枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 + 要调用的模型 ID。本组件不做约束:Comfy Router 会从 `POST /v2/models/wan/{model}` 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。直接以 v1 调用 `POST /proxy/wan/api/v1/services/aigc/video-generation/video-synthesis` 时必须提供它,可接受拼写的枚举位于该操作自身的组件 `WanVideoGenerationRequest` 上。 @@ -328,7 +280,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;对于其他 Wan 模型,提供商并未记录此类切换。 + 是否为视频添加音频。仅 wan3.0-video 和 wan3.0-video-prime 支持;提供商未为其他 Wan 模型记录此类切换项。 @@ -340,14 +292,14 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 生成视频的时长,以秒为单位: + 生成视频的时长,单位为秒: - wan2.5 模型:5 或 10 秒 - wan2.6-t2v、wan2.6-i2v:5、10 或 15 秒 - wan2.6-r2v:仅 5 或 10 秒(不支持 15 秒) -- wan2.7-i2v、wan2.7-t2v:[2, 15] 范围内的整数 -- wan2.7-r2v、wan2.7-videoedit:[2, 10] 范围内的整数 -- wan3.0-video:无视频输入时为 [2, 30] 范围内的整数;有视频输入时,输入视频总时长 + 输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型选择合适的时长 -对于超出 [-1, 30] 范围的时长,此代理会返回 400。 +- wan2.7-i2v、wan2.7-t2v:[2, 15] 区间内的整数 +- wan2.7-r2v、wan2.7-videoedit:[2, 10] 区间内的整数 +- wan3.0-video:无视频输入时为 [2, 30] 区间内的整数;有视频输入时,输入视频总时长加输出视频时长不得超过 30 秒;-1 启用智能时长模式,由模型挑选合适的时长 +本代理对 [-1, 30] 之外的时长返回 400。 范围:`-1` 到 `30` @@ -357,25 +309,28 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 生成视频的画面比例。仅适用于 wan2.7 和 wan3.0 模型。 -对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的画面比例。 + 生成视频的比例。仅适用于 wan2.7 和 wan3.0 模型。 +对于 wan2.7 模型,如果未提供,则根据分辨率档位确定默认值。 +对于 wan3.0-video,adaptive(默认值)会自动推荐合适的基于输入媒体的比例和意图确定宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` - 分辨率档位。支持的取值因模型而异: + 分辨率档位。支持的值因模型而异: - wan2.5-i2v-preview:480P、720P、1080P - wan2.6 模型(t2v、i2v、r2v):仅 720P、1080P(不支持 480P) - wan2.7 模型(i2v、t2v、r2v、videoedit):720P、1080P(默认 1080P) -- wan3.0-video, wan3.0-video-prime: 480P、720P、1080P(上游默认为 1080P) -- happyhorse-1.0-* (t2v, i2v, r2v, video-edit): 720P、1080P -- happyhorse-1.1-* (t2v, i2v, r2v): 480P、720P、1080P - -该代理会拒绝既未提供分辨率也未提供尺寸的视频生成请求,因为分辨率档位决定了计费费率。它会在检查之前将分辨率转换为大写并转发该大写值,对于不在此枚举范围内的值返回 400;对于上文列出的不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,无论是以分辨率还是以 480P 尺寸发送 480P,都会返回 400。 - - 可能的值:`480P`、`720P`、`1080P` +- wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) +- happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P +- happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P +本代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求, +因为分辨率档位决定计费费率。它会在检查之前将 resolution 转为大写, +并转发大写后的值;对于不在此枚举范围内的值返回 400;对于上文列为 +不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型,遇到 480P +(无论以 resolution 还是以 480P 的 size 传入)返回 400。 + + 可选值:`480P`、`720P`、`1080P` @@ -394,19 +349,21 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 视频分辨率,格式为 宽度*高度。支持的分辨率因模型而异: + 视频分辨率,格式为 width*height。支持的分辨率因模型而异: 对于 wan2.5 T2V:480P(480*832、832*480、624*624)、720P、1080P 尺寸 -对于 wan2.6 T2V/R2V(不支持 480P): +对于 wan2.6 T2V/R2V(无 480P): 720P:1280*720、720*1280、960*960、1088*832、832*1088 1080P:1920*1080、1080*1920、1440*1440、1632*1248、1248*1632 -当同时发送尺寸和分辨率时,尺寸决定计费档位,而分辨率仍必须是该代理对相应模型接受的值。对于分辨率描述中列为不支持 480P 的每个模型,480P 尺寸都会返回 400。 +当同时传入 size 和 resolution 时,由 size 决定计费档位, +而 resolution 仍必须是本代理为该模型接受的值。对于分辨率说明中 +列为不支持 480P 的每个模型,传入 480P 的 size 都会返回 400。 - 是否添加水印标识,水印位于右下角 + 是否添加水印标志,水印位于右下角 -由 Router 在 `GET /v2/models/wan/wan2.7-r2v/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。 +本文档由 Router 在 `GET /v2/models/wan/wan2.7-r2v/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -415,15 +372,15 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 智能改写后的实际提示词(适用于视频任务) + 智能重写后的实际提示词(用于视频任务) - 含音频生成的 I2V 任务的音频网址 + 适用于带音频生成的 I2V 任务的音频网址 - 失败请求的错误码(请求成功时不返回) + 失败请求的错误代码(请求成功时不返回) @@ -435,7 +392,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 原始输入提示词(适用于视频任务) + 原始输入提示词(用于视频任务) @@ -443,11 +400,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 智能改写后的实际提示词(若已启用) + 智能重写后的实际提示词(若启用) - 图像错误码(部分任务失败时返回) + 图像错误代码(部分任务失败时返回) @@ -479,11 +436,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 失败任务数量 + 失败任务数 - 成功任务数量 + 成功任务数 @@ -493,11 +450,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 任务状态 - 可能的值:`PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` - 已完成的视频生成任务的视频网址。链接有效期为 24 小时 + 已完成视频生成任务的视频网址。链接有效期为 24 小时 @@ -509,11 +466,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 视频分辨率等级(I2V 与 wan3.0-video 任务) + 视频分辨率等级(I2V 和 wan3.0-video 任务) - 已生成视频的时长,单位为秒(I2V 与 wan3.0-video 任务) + 已生成视频的时长,单位为秒(I2V 和 wan3.0-video 任务) @@ -521,11 +478,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 已生成的图像数量(T2I 与 I2I 任务) + 已生成图像数量(T2I 和 I2I 任务) - 输入视频的时长,单位为秒;无视频输入时为 0.0(wan3.0-video 任务) + 输入视频的时长,单位为秒,无视频输入时为 0.0(wan3.0-video 任务) @@ -537,11 +494,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 图像分辨率(T2I 与 I2I 任务) + 图像分辨率(T2I 和 I2I 任务) - 已生成的视频数量(T2V 任务) + 已生成视频数量(T2V 任务) @@ -553,11 +510,11 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema - 失败请求的错误码,在外层响应结构的根层级报告,而不是在 `output` 下(请求成功时不返回)。 + 失败请求的错误代码,在响应封装的根层级返回,而不是在 `output` 下返回(请求成功时不返回)。 - 失败请求的详细信息,在外层响应结构的根层级报告,而不是在 `output` 下(请求成功时不返回)。在回退到 `output.message` 之前请先读取此项。 + 失败请求的详细信息,在响应封装的根层级返回,而不是在 `output` 下返回(请求成功时不返回)。在回退到 `output.message` 之前,请先阅读此项。 ## 示例 diff --git a/zh/development/comfy-router/pricing.mdx b/zh/development/comfy-router/pricing.mdx index abd677418a..94f4d32ae7 100644 --- a/zh/development/comfy-router/pricing.mdx +++ b/zh/development/comfy-router/pricing.mdx @@ -139,8 +139,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Ideogram 4.5](/zh/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 低 | 9.0519 | | [Ideogram 4.5](/zh/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 中 | 18.1038 | | [Ideogram 4.5](/zh/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 高 | 60.346 | -| [Seedream 5.5](/zh/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 图层分离 · 1.5K
输出图像 · 1.5K | 6.0346 | -| [Seedream 5.5](/zh/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 图层分离 · 2K
输出图像 · 2K | 10.56055 | +| [Seedream 5.5](/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 图层分离 · 1.5K
输出图像 · 1.5K | 6.0346 | +| [Seedream 5.5](/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 图层分离 · 2K
输出图像 · 2K | 10.56055 | #### 未发布 @@ -155,7 +155,7 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [Qwen Image 3.0](/zh/development/comfy-router/models/qwen/qwen-image-3-0/code) | `qwen/qwen-image-3.0` | 输入图像 · 1K / 2K | 0.9052 / 输入图像 | | [Qwen Image 3.0 Pro](/zh/development/comfy-router/models/qwen/qwen-image-3-0-pro/code) | `qwen/qwen-image-3.0-pro` | 输入图像 · 1K / 2K | 0.9052 / 输入图像 | | [Seedream 5.0 Pro](/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 首张之后的输入图像 | 0.633 / 输入图像 | -| [Seedream 5.5](/zh/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 输入图像 | 2.41384 / 输入图像 | +| [Seedream 5.5](/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 输入图像 | 2.41384 / 输入图像 | #### 每 Recraft 积分费率 @@ -882,8 +882,8 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | [Ideogram 4.5](/zh/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 低 | $0.0429 | | [Ideogram 4.5](/zh/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 中 | $0.0858 | | [Ideogram 4.5](/zh/development/comfy-router/models/ideogram/ideogram-4-5/code) | `ideogram/ideogram-4-5` | 高 | $0.286 | -| [Seedream 5.5](/zh/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 图层分离 · 1.5K
输出图像 · 1.5K | $0.0286 | -| [Seedream 5.5](/zh/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 图层分离 · 2K
输出图像 · 2K | $0.05005 | +| [Seedream 5.5](/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 图层分离 · 1.5K
输出图像 · 1.5K | $0.0286 | +| [Seedream 5.5](/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 图层分离 · 2K
输出图像 · 2K | $0.05005 | #### 未发布 @@ -898,7 +898,7 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | [Qwen Image 3.0](/zh/development/comfy-router/models/qwen/qwen-image-3-0/code) | `qwen/qwen-image-3.0` | 输入图像 · 1K / 2K | $0.00429 / 输入图像 | | [Qwen Image 3.0 Pro](/zh/development/comfy-router/models/qwen/qwen-image-3-0-pro/code) | `qwen/qwen-image-3.0-pro` | 输入图像 · 1K / 2K | $0.00429 / 输入图像 | | [Seedream 5.0 Pro](/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code) | `byteplus/seedream-5-0-pro-260628` | 首张之后的输入图像 | $0.003 / 输入图像 | -| [Seedream 5.5](/zh/development/comfy-router/models) | `byteplus/seedream-5-5-261028` | 输入图像 | $0.01144 / 输入图像 | +| [Seedream 5.5](/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code) | `byteplus/seedream-5-5-261028` | 输入图像 | $0.01144 / 输入图像 | #### 每 Recraft 积分费率 From 95f99884f5b096ddd4e306473848391cda3e2186 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Wed, 11 Nov 2026 11:25:48 +0800 Subject: [PATCH 15/36] i18n: restore the LTX-2.3 workflow previews and the missing inline data URL note --- es/tutorials/video/ltx/ltx-2-3.mdx | 10 ++++++++++ ja/tutorials/video/ltx/ltx-2-3.mdx | 10 ++++++++++ ko/tutorials/video/ltx/ltx-2-3.mdx | 10 ++++++++++ .../models/wan/happyhorse-1-0-r2v/code.mdx | 2 +- zh/tutorials/video/ltx/ltx-2-3.mdx | 10 ++++++++++ 5 files changed, 41 insertions(+), 1 deletion(-) diff --git a/es/tutorials/video/ltx/ltx-2-3.mdx b/es/tutorials/video/ltx/ltx-2-3.mdx index 30de5d969b..214053b28b 100644 --- a/es/tutorials/video/ltx/ltx-2-3.mdx +++ b/es/tutorials/video/ltx/ltx-2-3.mdx @@ -78,6 +78,8 @@ ComfyUI incluye seis plantillas nativas de LTX-2.3 en **Biblioteca de plantillas Genera videos a partir de prompts de texto con mejor comprensión de prompts y renderizado de texto. + + LTX-2.3 Texto a video ( vista previa del flujo de trabajo @@ -137,6 +139,8 @@ ComfyUI/ Genera videos a partir de una imagen de entrada con una consistencia de movimiento mejorada. + + LTX-2.3 Imagen a video ( vista previa del flujo de trabajo @@ -198,6 +202,8 @@ ComfyUI/ Interpola entre una imagen inicial y una final. + + LTX-2.3: primer y último fotograma a video (vista previa del flujo de trabajo) @@ -246,6 +252,8 @@ ComfyUI/ Genera videos con sincronización de labios a partir de una imagen y un audio. + + LTX-2.3 Imagen y audio a video ( vista previa del flujo de trabajo @@ -525,6 +533,8 @@ Remove subtitles, captions, and related text occlusions from the video, restorin Genera videos personalizados con audio sincronizado a partir de una imagen de referencia y un clip de audio. + + LTX-2.3 ID LoRA (vista previa del flujo de trabajo diff --git a/ja/tutorials/video/ltx/ltx-2-3.mdx b/ja/tutorials/video/ltx/ltx-2-3.mdx index 4e5afd9c14..cff6f2d91e 100644 --- a/ja/tutorials/video/ltx/ltx-2-3.mdx +++ b/ja/tutorials/video/ltx/ltx-2-3.mdx @@ -78,6 +78,8 @@ LTX-2.3はComfyUIでネイティブサポートされています。開始する ### LTX-2.3 テキストから動画(`video_ltx2_3_t2v`) {#video_ltx2_3_t2v} 改善されたプロンプト理解とテキストレンダリングにより、テキストプロンプトから動画を生成します。 + + LTX-2.3 テキストから動画ワークフロープレビュー @@ -136,6 +138,8 @@ ComfyUI/ ### LTX-2.3 画像から動画(`video_ltx2_3_i2v`) {#video_ltx2_3_i2v} 改善されたモーション一貫性で、入力画像から動画を生成します。 + + LTX-2.3 画像から動画ワークフロープレビュー @@ -196,6 +200,8 @@ ComfyUI/ ### LTX-2.3 最初・最後フレームから動画(`video_ltx2_3_flf2v`) {#video_ltx2_3_flf2v} 開始画像と終了画像の間を補間します。 + + LTX-2.3 最初・最後フレームから動画ワークフロープレビュー @@ -245,6 +251,8 @@ ComfyUI/ ### LTX-2.3 画像・音声から動画(`video_ltx2_3_ia2v`) {#video_ltx2_3_ia2v} 画像と音声からリップシンク動画を生成します。 + + LTX-2.3 画像・音声から動画ワークフロープレビュー @@ -522,6 +530,8 @@ Remove subtitles, captions, and related text occlusions from the video, restorin ### LTX-2.3 ID LoRA(`video_ltx2_3_id_lora`) {#video_ltx2_3_id_lora} 参照画像と音声クリップから、同期オーディオ付きのパーソナライズ動画を生成します。 + + LTX-2.3 ID LoRA ワークフロープレビュー diff --git a/ko/tutorials/video/ltx/ltx-2-3.mdx b/ko/tutorials/video/ltx/ltx-2-3.mdx index e22459eff4..8170e6bb68 100644 --- a/ko/tutorials/video/ltx/ltx-2-3.mdx +++ b/ko/tutorials/video/ltx/ltx-2-3.mdx @@ -81,6 +81,8 @@ LTX-2.3은 ComfyUI에서 기본적으로 지원됩니다. 시작하려면: 향상된 프롬프트 이해와 텍스트 렌더링으로 텍스트 프롬프트에서 비디오를 생성합니다. + + LTX-2.3 텍스트-투-비디오 워크플로 미리보기 @@ -140,6 +142,8 @@ ComfyUI/ 향상된 움직임 일관성으로 입력 이미지에서 비디오를 생성합니다. + + LTX-2.3 이미지-투-비디오 워크플로 미리보기 @@ -201,6 +205,8 @@ ComfyUI/ 시작 이미지와 종료 이미지 사이를 보간합니다. + + LTX-2.3 처음-마지막 프레임 투 비디오 워크플로 미리보기 @@ -251,6 +257,8 @@ ComfyUI/ 이미지와 오디오에서 립싱크 비디오를 생성합니다. + + LTX-2.3 이미지-오디오-투-비디오 워크플로 미리보기 @@ -529,6 +537,8 @@ Remove subtitles, captions, and related text occlusions from the video, restorin 참조 이미지와 오디오 클립으로 동기화된 오디오가 포함된 개인화된 비디오를 생성합니다. + + LTX-2.3 ID LoRA 워크플로 미리보기 diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index d09f10db3d..fe2e7a4026 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -229,7 +229,7 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v/requests/$REQUEST_ID - happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS 网址;不接受内联 data: URL)加上可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共网址或 data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记录任何媒体输入,因此请不要设置此字段。 - wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:该组件未为这些写法枚举媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧;wan2.6-r2v 在 reference_video_urls 中接收参考片段。 -上文中按模型给出的数量是合作伙伴的限制,而不是此 schema 的限制:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不代表提供商会接受;反过来,上文中按资产给出的“最大 20MB”数值(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终获得的资产所设的上限;当资产是公共网址时,这些数值按原样适用,因为这些字节从不经过 Comfy。内联 data: URL 确实会经过 Comfy,并且也会遇到传输上限:Comfy Router POST 请求体总计限制为 100 MiB,超过后返回 413;base64 会使负载膨胀约 4/3,因此单个内联资产超过约 75 MB 时,会在触及这里的任何合作伙伴规则之前被拒绝。在这一大小下,单个资产按合作伙伴自身的…… +上文中按模型给出的数量是合作伙伴的限制,而不是此 schema 的限制:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不代表提供商会接受;反过来,上文中按资产给出的“最大 20MB”数值(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终获得的资产所设的上限;当资产是公共网址时,这些数值按原样适用,因为这些字节从不经过 Comfy。内联 `data:\{MIME_type};base64,...` URL 确实会经过 Comfy,并且也会遇到传输上限:Comfy Router POST 请求体总计限制为 100 MiB,超过后返回 413;base64 会使负载膨胀约 4/3,因此单个内联资产超过约 75 MB 时,会在触及这里的任何合作伙伴规则之前被拒绝。在这一大小下,单个资产按合作伙伴自身的 20MB 的上限可以轻松容纳内联内容,因此对单个资产而言,真正起约束作用的是合作伙伴规则;而对多个资产来说,起约束作用的是传输上限,因为 100 MiB 的 Router 上限限制的是整个请求,并非每个元素。任何接近这些上限的内容,请以公开 URL 形式发送。 diff --git a/zh/tutorials/video/ltx/ltx-2-3.mdx b/zh/tutorials/video/ltx/ltx-2-3.mdx index 8414120f2c..b8b84d471d 100644 --- a/zh/tutorials/video/ltx/ltx-2-3.mdx +++ b/zh/tutorials/video/ltx/ltx-2-3.mdx @@ -80,6 +80,8 @@ ComfyUI 自带六个原生 LTX-2.3 模板,位于 **模板库** > **视频**( ### LTX-2.3 文本转视频(`video_ltx2_3_t2v`) {#video_ltx2_3_t2v} 通过改进的提示理解和文本渲染,根据文本提示生成视频。 + + LTX-2.3 文本转视频工作流预览 @@ -138,6 +140,8 @@ ComfyUI/ ### LTX-2.3 图像转视频(`video_ltx2_3_i2v`) {#video_ltx2_3_i2v} 根据输入图像生成视频,运动一致性更佳。 + + LTX-2.3 图像转视频工作流预览 @@ -198,6 +202,8 @@ ComfyUI/ ### LTX-2.3 首尾帧转视频(`video_ltx2_3_flf2v`) {#video_ltx2_3_flf2v} 在起始图像和结束图像之间进行插值。 + + LTX-2.3 首尾帧转视频工作流预览 @@ -247,6 +253,8 @@ ComfyUI/ ### LTX-2.3 图像音频转视频(`video_ltx2_3_ia2v`) {#video_ltx2_3_ia2v} 从图像和音频生成唇形同步视频。 + + LTX-2.3 图像音频转视频工作流预览 @@ -524,6 +532,8 @@ Remove subtitles, captions, and related text occlusions from the video, restorin ### LTX-2.3 ID LoRA(`video_ltx2_3_id_lora`) {#video_ltx2_3_id_lora} 从参考图像和音频片段生成带同步音频的个性化视频。 + + LTX-2.3 ID LoRA 工作流预览 From af20f717ea51c9fa08978b9e13343cdebbdaae6d Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Wed, 11 Nov 2026 11:34:34 +0800 Subject: [PATCH 16/36] i18n(es): fix the MDX parse errors mint reported in the router reference and the Tabs blocks --- .../models/google/nano-banana-2/code.mdx | 3 ++- .../models/google/nano-banana-pro/code.mdx | 3 ++- .../pika/pika-h3-flex-reference-to-video/code.mdx | 3 ++- .../models/stability/sdxl-1-0-masking/code.mdx | 3 ++- .../models/wan/happyhorse-1-0-i2v/code.mdx | 3 ++- .../models/wan/happyhorse-1-0-r2v/code.mdx | 3 ++- .../models/wan/happyhorse-1-0-video-edit/code.mdx | 3 ++- .../models/wan/happyhorse-1-1-i2v/code.mdx | 3 ++- .../models/wan/wan2-5-i2v-preview/code.mdx | 3 ++- .../comfy-router/models/wan/wan2-6-i2v/code.mdx | 3 ++- .../comfy-router/models/wan/wan2-6-r2v/code.mdx | 3 ++- .../comfy-router/models/wan/wan2-7-i2v/code.mdx | 3 ++- .../models/wan/wan2-7-videoedit/code.mdx | 3 ++- .../comfy-router/models/wan/wan3-0-video/code.mdx | 3 ++- es/development/comfy-router/reference.mdx | 13 +++++++++---- ja/development/comfy-router/reference.mdx | 3 ++- ko/development/comfy-router/reference.mdx | 3 ++- zh/development/comfy-router/reference.mdx | 3 ++- 18 files changed, 43 insertions(+), 21 deletions(-) diff --git a/es/development/comfy-router/models/google/nano-banana-2/code.mdx b/es/development/comfy-router/models/google/nano-banana-2/code.mdx index a3d2555b69..4b51c66688 100644 --- a/es/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -29,7 +29,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx index 9ff0ac91a4..21dd209608 100644 --- a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -28,7 +28,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx b/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx index 020dcd0121..e586e1d3cb 100644 --- a/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx +++ b/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx @@ -26,7 +26,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video` - + + ```python Python from comfy_sdk import Comfy diff --git a/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx b/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx index eb6f992fec..74536f000a 100644 --- a/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx +++ b/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx @@ -26,7 +26,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-masking` - + + ```python Python from comfy_sdk import Comfy diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index 6cf0615efb..14ac8e12c2 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -27,7 +27,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/happyhorse-1.0-i2v` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index ea5c24ec00..09adfbf230 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -27,7 +27,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index 6bf9c07970..edb018eb6a 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -27,7 +27,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/happyhorse-1.0-video-edit` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index 57a9c8cc54..613cee1b47 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -28,7 +28,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index b2def20f8d..ec351dde14 100644 --- a/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -27,7 +27,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/wan2.5-i2v-preview` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index d2a39d1a62..b9b1a69a18 100644 --- a/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -27,7 +27,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/wan2.6-i2v` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index dfd8202e55..4d81e143e7 100644 --- a/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -27,7 +27,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/wan2.6-r2v` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index f1d1ef472e..27eb9bf836 100644 --- a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -28,7 +28,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/wan2.7-i2v` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx b/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx index adb42c9642..2a187b0fad 100644 --- a/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx @@ -27,7 +27,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/wan2.7-videoedit` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/models/wan/wan3-0-video/code.mdx b/es/development/comfy-router/models/wan/wan3-0-video/code.mdx index 9385433bd2..b4005167f5 100644 --- a/es/development/comfy-router/models/wan/wan3-0-video/code.mdx +++ b/es/development/comfy-router/models/wan/wan3-0-video/code.mdx @@ -28,7 +28,8 @@ Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/pr **Endpoint:** `POST https://api.comfy.org/v2/models/wan/wan3.0-video` - + + ```python Python import asyncio diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index 92de83f129..7722d0f6a0 100644 --- a/es/development/comfy-router/reference.mdx +++ b/es/development/comfy-router/reference.mdx @@ -223,7 +223,9 @@ Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejecuta el despacho nativo en el proveedor predeterminado del modelo y este cuerpo es el esquema nativo propio del modelo, reenviado sin cambios (`strict_mode` no tiene sentido ahí y no cambia nada). Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=false` (el valor predeterminado), el cuerpo se traduce al esquema real de ese proveedor antes de enviarse: cualquier campo nativo que no se pueda expresar exactamente se descarta y se divulga mediante el encabezado `X-Comfy-Router-Dropped-Params` de la respuesta, nunca de forma silenciosa. Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=true` no se ejecuta ninguna traducción: el cuerpo ya debe ser el esquema real propio de ese proveedor alternativo, no el nativo de este modelo (consulta `strict_mode`), y se reenvía sin cambios. Los campos del propio cuerpo también seleccionan qué operación ejecuta Router en un modelo que admite más de una: en un modelo de imagen editable, incluir una imagen de entrada lo cambia de texto a imagen a la operación imagen a imagen (edición), que puede facturarse con su propia tarifa; en un modelo de video Seedance, `content[].role` selecciona la operación (una imagen de primer fotograma selecciona imagen a video, una imagen o un clip de referencia selecciona referencia a video). En el despacho nativo, la facturación de Seedance sigue los tipos de medios en `content`, no los roles: una solicitud con cualquier entrada de video se factura como video a video; si no, una con cualquier imagen se factura como imagen a video; si no, como texto a video, salvo que un render final a partir de un elemento `draft_task` se factura como la operación del Draft que renderiza; algunos modelos cobran la misma tarifa por texto a video y por imagen a video. Con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. -**Respuestas** +**Respuestas** + + OK: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, que se convierte de vuelta al contrato nativo de este modelo cuando es posible, y recurre a la respuesta en bruto del proveedor alternativo si la conversión falla, algo que se registra en el log y nunca ocurre en silencio), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. En un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes con el `Content-Type` propio del socio en lugar de `application/json`; decide según el `Content-Type` de la respuesta y no asumas que se trata de un documento JSON. Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes en bruto (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` @@ -559,7 +561,8 @@ El JSON de entrada nativo del modelo del socio, idéntico al cuerpo que la ruta Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` -Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos de `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Omite `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. + + Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos de `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Omite `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando `concurrency_limit_exceeded`) @@ -988,7 +991,8 @@ Las genera el propio Router, antes de la llamada al modelo o en torno a ella. Los centavos de USD que el llamador tiene comprometidos actualmente en llamadas aún en curso. -El límite máximo, en centavos de USD, del gasto de socio que el llamador puede haber comprometido en llamadas aún en curso: dinero retenido desde el momento en que se admite una llamada y liberado cuando esa llamada termina. + + El límite máximo, en centavos de USD, del gasto de socio que el llamador puede haber comprometido en llamadas aún en curso: dinero retenido desde el momento en que se admite una llamada y liberado cuando esa llamada termina. @@ -1171,7 +1175,8 @@ Una estimación previa a la ejecución de lo que costará esta llamada, en dóla date-time -Se presenta solo cuando `source` es `unknown`: `not_quotable` (Router no puede calcular el precio de esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no limita una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no tiene precio para esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella) o `pricing_unavailable` (solo envío en cola: no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra como de costumbre). Interpreta cualquier otro valor como `not_quotable`. + + Se presenta solo cuando `source` es `unknown`: `not_quotable` (Router no puede calcular el precio de esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no limita una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no tiene precio para esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella) o `pricing_unavailable` (solo envío en cola: no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra como de costumbre). Interpreta cualquier otro valor como `not_quotable`. ### RouterErrorResponse diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index 9d49a61c07..4c6db2739e 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -1191,7 +1191,8 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 date-time -`source` が `unknown` の場合にのみ表示されます:`not_quotable`(Router は実行前にこの呼び出しの価格を算出できません。価格はプロバイダーが返す内容に依存するか、リクエストボディが課金対象の数量を制限していないためです)、`unpriced_model`(レートカードがこのリクエストの価格を定めていません)、`byok`(キュー中の送信時のみ:実行はあなた自身のプロバイダーキーを使用するため、Comfy はそれに対して何も請求しません)、または `pricing_unavailable`(キュー中の送信時のみ:リクエストが受け付けられたときにレートカードを読み取れませんでした。これは一時的なもので、実行は通常どおり課金されます)。その他の値は `not_quotable` として解釈してください。 + + `source` が `unknown` の場合にのみ表示されます:`not_quotable`(Router は実行前にこの呼び出しの価格を算出できません。価格はプロバイダーが返す内容に依存するか、リクエストボディが課金対象の数量を制限していないためです)、`unpriced_model`(レートカードがこのリクエストの価格を定めていません)、`byok`(キュー中の送信時のみ:実行はあなた自身のプロバイダーキーを使用するため、Comfy はそれに対して何も請求しません)、または `pricing_unavailable`(キュー中の送信時のみ:リクエストが受け付けられたときにレートカードを読み取れませんでした。これは一時的なもので、実行は通常どおり課金されます)。その他の値は `not_quotable` として解釈してください。 ### RouterErrorResponse diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index d2b95a789c..69fd125904 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -1191,7 +1191,8 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 date-time -`source`가 `unknown`일 때만 표시됩니다: `not_quotable`(Router는 이 호출이 실행되기 전에는 가격을 책정할 수 없습니다: 가격이 공급자가 보고하는 값에 따라 달라지거나, 요청 본문이 청구 수량을 한정하지 않는 경우입니다), `unpriced_model`(요율 카드에 이 요청의 가격이 책정되어 있지 않음), `byok`(대기 중 제출에만 해당: 실행에 자체 공급자 키를 사용하므로 Comfy는 이에 대해 아무것도 청구하지 않습니다), 또는 `pricing_unavailable`(대기 중 제출에만 해당: 요청이 접수되었을 때 요율 카드를 읽을 수 없었습니다. 이는 일시적인 상태이며, 실행에는 평소와 같이 요금이 부과됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. + + `source`가 `unknown`일 때만 표시됩니다: `not_quotable`(Router는 이 호출이 실행되기 전에는 가격을 책정할 수 없습니다: 가격이 공급자가 보고하는 값에 따라 달라지거나, 요청 본문이 청구 수량을 한정하지 않는 경우입니다), `unpriced_model`(요율 카드에 이 요청의 가격이 책정되어 있지 않음), `byok`(대기 중 제출에만 해당: 실행에 자체 공급자 키를 사용하므로 Comfy는 이에 대해 아무것도 청구하지 않습니다), 또는 `pricing_unavailable`(대기 중 제출에만 해당: 요청이 접수되었을 때 요율 카드를 읽을 수 없었습니다. 이는 일시적인 상태이며, 실행에는 평소와 같이 요금이 부과됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. ### RouterErrorResponse diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 54b8b9ebe7..7d8862956f 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -1189,7 +1189,8 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ date-time -仅在 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在运行之前为本次调用定价,因为其价格取决于提供商回传的内容,或者请求体未限定计费数量)、`unpriced_model`(费率卡片未对本次请求定价)、`byok`(仅限已执行提交:该运行使用你自己的提供商密钥,因此 Comfy 不为其计费)、或 `pricing_unavailable`(仅限已执行提交:在请求被接纳时无法读取费率卡片;这是暂时性的,该运行仍照常计费)。其他任何值均按 `not_quotable` 理解。 + + 仅在 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在运行之前为本次调用定价,因为其价格取决于提供商回传的内容,或者请求体未限定计费数量)、`unpriced_model`(费率卡片未对本次请求定价)、`byok`(仅限已执行提交:该运行使用你自己的提供商密钥,因此 Comfy 不为其计费)、或 `pricing_unavailable`(仅限已执行提交:在请求被接纳时无法读取费率卡片;这是暂时性的,该运行仍照常计费)。其他任何值均按 `not_quotable` 理解。 ### RouterErrorResponse From b37ef79d5aee32e74c78f1ebce1900f2fb4bf236 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 12 Nov 2026 11:16:25 +0800 Subject: [PATCH 17/36] i18n: sync zh/ja/ko router schema and capability docs with upstream/main (2026-11-12) --- ja/development/comfy-router/limitations.mdx | 7 +- ja/development/comfy-router/models.mdx | 80 ++--- .../dreamina-seedance-2-0-260128/code.mdx | 149 ++++---- .../code.mdx | 157 ++++----- .../dreamina-seedance-2-0-mini/code.mdx | 163 ++++----- .../dreamina-seedance-2-5-260628/code.mdx | 130 +++---- .../byteplus/seedance-1-0-pro-250528/code.mdx | 122 ++++--- .../seedance-1-0-pro-fast-251015/code.mdx | 148 ++++---- .../byteplus/seedance-1-5-pro-251215/code.mdx | 132 +++---- .../models/krea/krea-2-large/code.mdx | 21 +- .../models/krea/krea-2-medium-turbo/code.mdx | 21 +- .../models/krea/krea-2-medium/code.mdx | 21 +- .../comfy-router/models/krea/krea-2/code.mdx | 21 +- .../comfy-router/models/krea/krea-3/code.mdx | 23 +- .../minimax-h3-image-highspeed/code.mdx | 324 ++++++++++++++++++ .../models/minimax/minimax-h3-image/code.mdx | 324 ++++++++++++++++++ .../xai/grok-imagine-image-2-0/code.mdx | 51 ++- .../xai/grok-imagine-image-pro/code.mdx | 53 ++- .../xai/grok-imagine-image-quality/code.mdx | 51 ++- .../models/xai/grok-imagine-image/code.mdx | 53 ++- ja/development/comfy-router/reference.mdx | 201 +++++------ ko/development/comfy-router/limitations.mdx | 7 +- ko/development/comfy-router/models.mdx | 144 ++++---- .../dreamina-seedance-2-0-260128/code.mdx | 130 +++---- .../code.mdx | 114 +++--- .../dreamina-seedance-2-0-mini/code.mdx | 106 +++--- .../dreamina-seedance-2-5-260628/code.mdx | 104 +++--- .../byteplus/seedance-1-0-pro-250528/code.mdx | 129 +++---- .../seedance-1-0-pro-fast-251015/code.mdx | 129 +++---- .../byteplus/seedance-1-5-pro-251215/code.mdx | 116 ++++--- .../models/krea/krea-2-large/code.mdx | 21 +- .../models/krea/krea-2-medium-turbo/code.mdx | 21 +- .../models/krea/krea-2-medium/code.mdx | 23 +- .../comfy-router/models/krea/krea-2/code.mdx | 21 +- .../comfy-router/models/krea/krea-3/code.mdx | 21 +- .../minimax-h3-image-highspeed/code.mdx | 324 ++++++++++++++++++ .../models/minimax/minimax-h3-image/code.mdx | 324 ++++++++++++++++++ .../xai/grok-imagine-image-2-0/code.mdx | 51 ++- .../xai/grok-imagine-image-pro/code.mdx | 51 ++- .../xai/grok-imagine-image-quality/code.mdx | 55 ++- .../models/xai/grok-imagine-image/code.mdx | 55 ++- ko/development/comfy-router/reference.mdx | 200 +++++------ zh/development/comfy-router/limitations.mdx | 7 +- zh/development/comfy-router/models.mdx | 45 +-- .../dreamina-seedance-2-0-260128/code.mdx | 138 ++++---- .../code.mdx | 133 +++---- .../dreamina-seedance-2-0-mini/code.mdx | 139 ++++---- .../dreamina-seedance-2-5-260628/code.mdx | 170 ++++----- .../byteplus/seedance-1-0-pro-250528/code.mdx | 118 +++---- .../seedance-1-0-pro-fast-251015/code.mdx | 151 ++++---- .../byteplus/seedance-1-5-pro-251215/code.mdx | 149 ++++---- .../models/krea/krea-2-large/code.mdx | 21 +- .../models/krea/krea-2-medium-turbo/code.mdx | 21 +- .../models/krea/krea-2-medium/code.mdx | 21 +- .../comfy-router/models/krea/krea-2/code.mdx | 21 +- .../comfy-router/models/krea/krea-3/code.mdx | 21 +- .../minimax-h3-image-highspeed/code.mdx | 324 ++++++++++++++++++ .../models/minimax/minimax-h3-image/code.mdx | 324 ++++++++++++++++++ .../xai/grok-imagine-image-2-0/code.mdx | 55 ++- .../xai/grok-imagine-image-pro/code.mdx | 57 ++- .../xai/grok-imagine-image-quality/code.mdx | 53 ++- .../models/xai/grok-imagine-image/code.mdx | 53 ++- zh/development/comfy-router/reference.mdx | 207 ++++++----- 63 files changed, 4680 insertions(+), 1946 deletions(-) create mode 100644 ja/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx create mode 100644 ja/development/comfy-router/models/minimax/minimax-h3-image/code.mdx create mode 100644 ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx create mode 100644 ko/development/comfy-router/models/minimax/minimax-h3-image/code.mdx create mode 100644 zh/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx create mode 100644 zh/development/comfy-router/models/minimax/minimax-h3-image/code.mdx diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index 2b1dd7f980..5adfa761a0 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の機能と制限" sidebarTitle: "機能と制限" description: "Comfy Router とパートナープロキシのどちらを選ぶか、長時間実行される呼び出しへの備え、リカバリ・レート制限・アセット保存について説明します。" -translationSourceHash: fbb54868 +translationSourceHash: a81b3bd9 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": cca3ca82 + "Models without a pre-flight estimate": e7d7524a "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -30,6 +30,7 @@ translationBlockHashes: + Router はパートナーモデルを、1回の同期 HTTP 呼び出し、または送信して後で結果を取得するキュー中のリクエストを通じて実行します。アプリケーションが完了した結果を待つことができ、あるいは後で結果を取得でき、さらにモデル自身の入力フィールドと出力フィールドを処理できる場合に使用します。 ## Router がサポートするもの @@ -123,7 +124,7 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` -- **minimax**: `minimax/minimax-gpt-image-2` +- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index 9359c37075..5c969d4c14 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router モデル" sidebarTitle: "すべてのモデル" description: "Comfy Router で利用できるすべてのモデルを、各モデルの入力と出力のモダリティとあわせて、プロバイダー別にまとめています。" -translationSourceHash: 04ecf050 +translationSourceHash: df7e65a1 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 2dfd8d42 + "Find by output": 4d100975 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -26,7 +26,7 @@ translationBlockHashes: "Luma": 8cd2a7ce "Luma 2": 585eb637 "Meshy": 67e26a17 - "MiniMax": 87560ab7 + "MiniMax": 63f02c44 "Moonvalley": 9e63fb77 "OpenAI": 8652024f "Openrouter": a4f6806b @@ -42,13 +42,14 @@ translationBlockHashes: "Veo": 4ccdb46f "Wan": e4d5aff5 "WaveSpeed": be89e7f0 - "xAI": e1706271 + "xAI": 38a131b8 --- + {/* 生成済みファイル。Router カタログから `pnpm code-pages:gen` によって生成されます。 */} 以下に挙げるすべてのモデルは、同じルート `POST /v2/models/{provider}/{model}` で提供され、それぞれのモデル固有の JSON ボディを使用します。各ページには、Python、TypeScript、cURL で動作するリクエスト例を掲載しています。ディスカバリー、スキーマ、エラー、リトライ、課金については、[Comfy Router API の使用](/ja/development/comfy-router/api) を参照してください。 @@ -61,13 +62,13 @@ translationBlockHashes: - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` -- [FLUX 3 Video](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [FLUX Video Upscale](/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code): `bfl/video-upscale-v1` -- [Video Edit V1](/ja/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1` -- [Video Edit Erase](/ja/development/comfy-router/models/bria/video-edit-erase/code): `bria/video-edit-erase` -- [Video Edit Green Screen](/ja/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` -- [Video Edit Remove Background](/ja/development/comfy-router/models/bria/video-edit-remove-background/code): `bria/video-edit-remove-background` -- [Video Edit Replace Background](/ja/development/comfy-router/models/bria/video-edit-replace-background/code): `bria/video-edit-replace-background` +- [FLUX 3 ビデオ](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` +- [FLUX ビデオアップスケール](/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code): `bfl/video-upscale-v1` +- [ビデオ編集 V1](/ja/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1` +- [ビデオ編集 消去](/ja/development/comfy-router/models/bria/video-edit-erase/code): `bria/video-edit-erase` +- [ビデオ編集 グリーンスクリーン](/ja/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` +- [ビデオ編集 背景を除去](/ja/development/comfy-router/models/bria/video-edit-remove-background/code): `bria/video-edit-remove-background` +- [ビデオ編集 背景を置換](/ja/development/comfy-router/models/bria/video-edit-replace-background/code): `bria/video-edit-replace-background` - [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` - [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` @@ -75,12 +76,12 @@ translationBlockHashes: - [Seedance 1.0 Pro 250528](/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code): `byteplus/seedance-1-0-pro-250528` - [Seedance 1.0 Pro Fast 251015](/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code): `byteplus/seedance-1-0-pro-fast-251015` - [Seedance 1.5 Pro 251215](/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` -- [Crystal Video Upscaler](/ja/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` +- [Crystal ビデオアップスケーラー](/ja/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` - [FLUX 3 Max](/ja/development/comfy-router/models/fal/flux-3-max/code): `fal/flux-3-max` - [H3 Max Turbo](/ja/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo` - [H3 Max](/ja/development/comfy-router/models/fal/h3-max/code): `fal/h3-max` - [Gemini Omni 1.2 Flash](/ja/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code): `gemini-interactions/gemini-omni-1.2-flash` -- [Higgsfield Genjutsu Motion Transfer V1.0](/ja/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` +- [Higgsfield Genjutsu モーショントランスファー V1.0](/ja/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` - [Higgsfield Kling 3.4k](/ja/development/comfy-router/models/higgsfield/higgsfield-kling-3-4k/code): `higgsfield/higgsfield-kling-3-4k` - [Higgsfield Kling 3 Pro](/ja/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` - [Kling 3.0 Turbo](/ja/development/comfy-router/models/kling/kling-3-0-turbo/code): `kling/kling-3.0-turbo` @@ -90,28 +91,27 @@ translationBlockHashes: - [Kling V3 Omni](/ja/development/comfy-router/models/kling/kling-v3-omni/code): `kling/kling-v3-omni` - [Kling V3](/ja/development/comfy-router/models/kling/kling-v3/code): `kling/kling-v3` - [Kling Video O1](/ja/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1` -- [Videos Avatar Image 2video](/ja/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` -- [Videos Lip Sync](/ja/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` +- [ビデオ アバター 画像から動画](/ja/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` +- [ビデオ リップシンク](/ja/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` - [LTX 2.5 Fast](/ja/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ja/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/ja/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` - [MiniMax H3](/ja/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` -- [Image To Video](/ja/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` -- [Text To Video](/ja/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` -- [Video To Video](/ja/development/comfy-router/models/moonvalley/video-to-video/code): `moonvalley/video-to-video` -- [Pika 2.5 Image To Video](/ja/development/comfy-router/models/pika/pika-2-5-image-to-video/code): `pika/pika-2.5-image-to-video` -- [Pika 2.5 Text To Video](/ja/development/comfy-router/models/pika/pika-2-5-text-to-video/code): `pika/pika-2.5-text-to-video` -- [Pika H3 Flex Image To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` -- [Pika H3 Flex Reference To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` -- [Pika H3 Flex Text To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` -- [Pika Soundtrack](/ja/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` +- [画像から動画へ](/ja/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` +- [テキストから動画へ](/ja/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` +- [動画から動画へ](/ja/development/comfy-router/models/moonvalley/video-to-video/code): `moonvalley/video-to-video` +- [Pika 2.5 画像から動画へ](/ja/development/comfy-router/models/pika/pika-2-5-image-to-video/code): `pika/pika-2.5-image-to-video` +- [Pika 2.5 テキストから動画へ](/ja/development/comfy-router/models/pika/pika-2-5-text-to-video/code): `pika/pika-2.5-text-to-video` +- [Pika H3 Flex 画像から動画へ](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` +- [Pika H3 Flex 参照から動画](/ja/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` +- [Pika H3 Flex テキストから動画へ](/ja/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` +- [Pika サウンドトラック](/ja/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` - [P Video 2](/ja/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/ja/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/ja/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ja/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` -- [Clean Audio Video](/ja/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [オーディオとビデオをクリーン化](/ja/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` +- [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`- [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ja/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ja/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` - [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` @@ -143,7 +143,7 @@ translationBlockHashes: - [Grok Imagine Video](/ja/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/ja/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -165,8 +165,7 @@ translationBlockHashes: - [Image Edit Increase Resolution](/ja/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/ja/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/ja/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` -- [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ja/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ja/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -206,6 +205,8 @@ translationBlockHashes: - [Uni 1](/ja/development/comfy-router/models/luma_2/uni-1/code): `luma_2/uni-1` - [Photon 1](/ja/development/comfy-router/models/luma/photon-1/code): `luma/photon-1` - [Photon Flash 1](/ja/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1` +- [MiniMax H3 Image Highspeed](/ja/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code): `minimax/minimax-h3-image-highspeed` +- [MiniMax H3 Image](/ja/development/comfy-router/models/minimax/minimax-h3-image/code): `minimax/minimax-h3-image` - [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` @@ -214,8 +215,7 @@ translationBlockHashes: - [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Qwen Image 3.0 Pro](/ja/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/ja/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` -- [Recraft V2](/ja/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` -- [Recraft V3](/ja/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` +- [Recraft V2](/ja/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2`- [Recraft V3](/ja/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` - [Recraft V4.1 Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` - [Recraft V4.1 Pro](/ja/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` @@ -267,8 +267,7 @@ translationBlockHashes: - [FLUX 3 Video](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128`- [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/ja/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` @@ -325,8 +324,7 @@ translationBlockHashes: - [Rigging](/ja/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/ja/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ja/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/ja/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/ja/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Part](/ja/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part`- [Hunyuan 3D Smart Topology](/ja/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` - [Hunyuan 3D Texture Edit](/ja/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/ja/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` @@ -609,6 +607,8 @@ translationBlockHashes: | モデル | ID | 入力 | 出力 | | --- | --- | --- | --- | +| [MiniMax H3 Image Highspeed](/ja/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | テキスト, 画像 | 画像 | +| [MiniMax H3 Image](/ja/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | テキスト, 画像 | 画像 | | [MiniMax H3](/ja/development/comfy-router/models/minimax/minimax-h3/code) | `minimax/minimax-h3` | テキスト, 画像 | ビデオ + オーディオ | ## Moonvalley @@ -810,10 +810,10 @@ translationBlockHashes: | モデル | ID | 入力 | 出力 | | --- | --- | --- | --- | -| [Grok Imagine Image 2.0](/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code) | `xai/grok-imagine-image-2.0` | テキスト | 画像 | -| [Grok Imagine Image Pro](/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code) | `xai/grok-imagine-image-pro` | テキスト | 画像 | -| [Grok Imagine Image Quality](/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code) | `xai/grok-imagine-image-quality` | テキスト | 画像 | -| [Grok Imagine Image](/ja/development/comfy-router/models/xai/grok-imagine-image/code) | `xai/grok-imagine-image` | テキスト | 画像 | +| [Grok Imagine Image 2.0](/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code) | `xai/grok-imagine-image-2.0` | 画像, テキスト | 画像 | +| [Grok Imagine Image Pro](/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code) | `xai/grok-imagine-image-pro` | 画像, テキスト | 画像 | +| [Grok Imagine Image Quality](/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code) | `xai/grok-imagine-image-quality` | 画像, テキスト | 画像 | +| [Grok Imagine Image](/ja/development/comfy-router/models/xai/grok-imagine-image/code) | `xai/grok-imagine-image` | 画像, テキスト | 画像 | | [Grok Imagine Video 1.5 Lite](/ja/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code) | `xai/grok-imagine-video-1.5-lite` | テキスト, 画像 | ビデオ | | [Grok Imagine Video 1.5 Preview](/ja/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code) | `xai/grok-imagine-video-1.5-preview` | テキスト, 画像 | ビデオ | | [Grok Imagine Video 1.5](/ja/development/comfy-router/models/xai/grok-imagine-video-1-5/code) | `xai/grok-imagine-video-1.5` | テキスト, 画像 | ビデオ | diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index db3d238d64..25f7ca8434 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "Dreamina Seedance 2.0 260128 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-260128 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 70ec471f +translationSourceHash: a3a29c99 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 8c0478c9 + "Schema": 9c7c68b7 "Examples": 641c458b --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 生成済みファイル。router-schemas/byteplus/dreamina-seedance-2-0-260128.json から `pnpm code-pages:gen` によって生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -197,7 +198,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果を取得するには、代わりにタスクステータスのルートをポーリングしてください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりにタスクステータスのルートをポーリングして結果を取得してください。 形式: `uri` @@ -207,23 +208,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートしています。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオ(wav、mp3)の公開 URL。 +オーディオ URL: オーディオ(wav、mp3)の公開 URL。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。コンテンツ項目として唯一のものである必要があります。 -最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。解像度は既定値が 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終出力のティア(4k を含む)に合わせてこのリクエストで解像度を設定してください。省略した場合、最終出力は 1080p になります。 - `draft` を true に設定してドラフトビデオを作成したときに返されるタスク ID。 + Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 @@ -231,8 +232,8 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成のための画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセス可能であることを確認してください。 + 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) +画像 URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -240,36 +241,45 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b コンテンツ項目の役割/位置。 画像の場合: first_frame、last_frame、または reference_image。 -ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 -オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): テキストプロンプトの後に --[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` は配列であり、ドキュメント全体を制限するのはリクエストごとの body 制限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出した場合は、代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトが拒否されることはありません。呼び出し元がさらに多くを必要とする場合は引き上げてください。 +Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は +テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。これはバイト数ではなく文字数を数えるため、マルチバイトの +プロンプトでは実際に送信されるサイズがこの数倍になる場合があります。これは +この 1 つのフィールドのみを制限するもので、リクエスト全体を制限するものでは +ありません。`content` は配列であり、ドキュメント全体を制限するのはリクエスト +ごとのボディ上限です。これを適用するのは Comfy Router +(/v2/models/byteplus/\{model}) であり、v1 /proxy を直接呼び出す場合は代わりに +BytePlus 自身のバリデータが応答します。実際のトラフィックをはるかに上回る値に +設定されているため、本物のプロンプトを判定することは決してありません。呼び出し元が +より多くを必要とする場合は引き上げてください。 入力コンテンツの種類 - 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -278,129 +288,130 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ ビデオ URL またはアセット ID。 -ビデオ URL: ビデオ(mp4、mov)の公開 URL。 +ビデオ URL: ビデオ(mp4、mov)の公開 URL。 アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p のドラフトビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終ビデオがレンダリングされます。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - タスクのタイムアウトしきい値(秒)。既定値は 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` から `259200` + 範囲: `3600`〜`259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオが含まれるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対して断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオだった場合だけであり、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。 +対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式です。 mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズが小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 - 取り得る値: `mp4`, `mov` + 指定可能な値: `mp4`, `mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け入れられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け入れます。 +Seedance 2.5 のファーストフレーム / ファースト・ラストフレーム生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 - 取り得る値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p、4k をサポートしています。 - 取り得る値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`, `720p`, `1080p`, `4k` - 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、「ビデオ生成タスクの情報を照会する」を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用するため、複数の連続したビデオをすばやく生成できます。 -false: 生成されたビデオの最終フレーム画像を返しません。 + 生成されたビデオの最後のフレーム画像を返すかどうか。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメーターを true に設定した後、ビデオ生成タスクの情報を照会するを呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、連続する複数のビデオを生成できます。前に生成したビデオの最後のフレームが次のビデオタスクの最初のフレームとして使用されるため、連続する複数のビデオをすばやく生成できます。 +false: 生成されたビデオの最後のフレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 範囲: `-1` から `4294967295` - 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 - 取り得る値: `default`, `flex` + 指定可能な値: `default`, `flex` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` で Router が提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のフィールドはすべて BytePlus 自身のものです。Nullable: BytePlus はタスクの24時間後に URL をクリアするため、その後ポーリングした成功済みドキュメントでは `content` が存在しないか null である可能性があります。 + ビデオ生成タスク完了後の出力です。出力ビデオのダウンロードURLと、BytePlusが返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされており、ここにあるその他のフィールドはすべてBytePlus自身のものです。Null許容: BytePlusはタスクの24時間後にURLをクリアするため、その後でポーリングした成功済みのドキュメントでは `content` が存在しないかnullである可能性があります。 - 生成されたビデオの最終フレームのダウンロード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 を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - BytePlus が `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedance モデルでは `content` のトップレベルの兄弟として返すことがより一般的で、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + BytePlusがこれを `content` の中にネストする場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedanceモデルでは `content` のトップレベルの兄弟として返すことのほうが一般的です(トップレベルの `output_format` フィールドを参照)。Routerはどちらか存在する方を読み取ります。 - 上流の URL が機能しなくなる RFC 3339 の時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus が文書化している URL の寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ含まれ、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流URLが機能しなくなる時刻を表すRFC 3339形式の値です。URL自体が持つ最も早い署名時刻と有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusが文書化しているURLの寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ含まれ、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 形式: `date-time` - 最終フレームに対する BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣にそのままのバイト列で返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラークレデンシャルです。 + BytePlus自身の最終フレームのダウンロードURLです。再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみが対象で、BytePlusがクリアすると存在しなくなり、`upstream_expires_at` まではベアラ認証情報です。 - 出力ビデオに対する BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にそのままのバイト列で返されます。サーバー側で Comfy がオプトインしたワークスペースによってポーリングされる Seedance 2.x のタスクにのみ含まれます(リクエストパラメーターはありません)。それ以外のすべての場合、たとえばワークスペースに解決されないクレデンシャル(特定のワークスペースにスコープされていないレガシー APIキーなど)では含まれず、生成から24時間後に BytePlus が URL をクリアすると存在しなくなります。これはプレサインドのオブジェクトストレージ URL であり、したがってベアラークレデンシャルです。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットとして扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストが消費します。 + BytePlus自身の出力ビデオのダウンロードURLで、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースがポーリングするSeedance 2.xのタスクにのみ含まれます(リクエストパラメータはありません)。それ以外のすべての場合、たとえばワークスペースに解決されない認証情報(いずれのワークスペースにもスコープされていないレガシーAPIキーなど)では含まれず、また生成から24時間後にBytePlusがURLをクリアすると含まれなくなります。これは署名済みのオブジェクトストレージURLであり、したがってベアラ認証情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットとして扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストが消費します。 - 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドには代わりにBytePlus自身のURLが残りますが、BytePlusはタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限しています。いずれにせよリンクは失効するため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値は秒単位のUNIXタイムスタンプです。 - 生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す一方、BytePlus の関連サーフェスでは小数の再生時間が報告されることが観測されており、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlusがこの点で一貫していないためです。ビデオタスクは秒単位の整数を返すことが観測されており、同系列のBytePlusのサーフェスでは小数の再生時間が報告されることもあるため、クライアントは整数値を前提にしてはいけません。BytePlus自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列で、他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -408,7 +419,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - ビデオ生成タスクのID + ビデオ生成タスクの ID @@ -416,15 +427,15 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedanceのビデオタスククエリはここでこの値を返します。BytePlus独自のフィールドで、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 独自のフィールドで、そのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 形式: `int64` @@ -432,11 +443,11 @@ false: 生成されたビデオの最終フレーム画像を返しません。 タスクの状態 - 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 指定可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - タスクが最後に更新された時間。値はUNIXタイムスタンプ(秒単位)です。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -448,7 +459,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - ビデオ生成モデルでは入力トークン数は計算されず、0が既定値となります。そのため、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens です。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 660ce9f9ff..cf2e1c46f0 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Dreamina Seedance 2.0 Fast 260128 を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-fast-260128 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: 8036f4db +translationSourceHash: 506a7f86 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": 90b60b2e + "Schema": 48fe2811 "Examples": 7714eccd --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりにタスクステータスのルートをポーリングして結果を取得してください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果を取得するには、代わりにタスクステータス取得用のルートをポーリングしてください。 形式: `uri` @@ -192,23 +193,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、画像またはビデオを最低 1 つ含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - オーディオ URL、Base64 エンコーディング、またはアセット ID。 + オーディオの URL、Base64 エンコード、またはアセット ID。 オーディオ URL: オーディオの公開 URL(wav、mp3)。 -Base64: 形式 data:audio/\;base64,\ -アセット ID: 形式 asset://\ +Base64: 形式は data:audio/\;base64,\ +アセット ID: 形式は asset://\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終出力のティア(4k を含む)はこのリクエストで解像度を設定してください。省略した場合、最終出力は 1080p になります。 - `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 + Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 @@ -216,52 +217,53 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセス可能であることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ -アセット ID: 形式 asset://\ + 画像から動画を生成する際の画像コンテンツ(type が "image_url" の場合) +画像URL: 画像URLにアクセスできることを確認してください。 +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります。 +アセット ID: 形式は asset://\ コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、reference_image。 +画像の場合: first_frame、last_frame、または reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して、生成するビデオを記述します。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): テキストプロンプトの後に --[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 自身のバリデータが応答します。 -実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトがこれによって -判定されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 +テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。文字数(バイト数ではない)でカウントするため、マルチバイトの +プロンプトはワイヤ上でこのサイズの数倍になることがあります。これはこの 1 つの +フィールドを制限するものであり、リクエスト全体を制限するものではありません: +`content` は配列であり、リクエストごとのボディ上限がドキュメント全体を制限します。 +これを適用するのは Comfy Router(/v2/models/byteplus/\{model})であり、 +v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが応答します。実際の +トラフィックよりはるかに高く設定されているため、正当なプロンプトがこれによって +判定されることはありません。呼び出し元がさらに必要とする場合は引き上げてください。 入力コンテンツの種類 - 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -269,130 +271,131 @@ v1 /proxy を直接呼び出す場合は、代わりに BytePlus 自身のバリ - ビデオ URL またはアセット ID。 + ビデオの URL またはアセット ID。 ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式 asset://\ +アセット ID: 形式は asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終ビデオをレンダリングします。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` から `259200` + 範囲: `3600` ~ `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。これをサポートするモデルでは、生成されたオーディオトラックはプロバイダーによってビデオとは別にコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対して断続的に発生することがあります。そのような場合にサイレントビデオにするには `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キューのリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 +false: モデルは無音のビデオを出力します。 +対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオ用に `false` を送ってください。これが効果を発揮するのは、拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ識別されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 - 呼び出すモデルの 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 の呼び出し元はこれを省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 Seedance 2.5 のみ。出力ビデオのコンテナ形式。 mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズが小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 - 指定可能な値: `mp4`、`mov` + 指定可能な値: `mp4`, `mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の最初のフレーム / 最初と最後のフレームからの生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみ受け付けられます。具体的な比率を指定すると、送信前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 - 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - 指定可能な値: `480p`、`720p`、`1080p`、`4k` + 指定可能な値: `480p`, `720p`, `1080p`, `4k` - 生成されたビデオの最後のフレーム画像を返すかどうか。 -true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する呼び出しによって最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオを迅速に生成できます。 -false: 生成されたビデオの最後のフレーム画像を返しません。 + 生成されたビデオの最終フレーム画像を返すかどうか。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、「ビデオ生成タスクの情報の照会」を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオをすばやく生成できます。 +false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 範囲: `-1` から `4294967295` - 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`、`flex` + 指定可能な値: `default`, `flex` - 生成されたビデオにウォーターマークを含めるかどうか。 + 生成されたビデオにウォーターマークが含まれるかどうか。 -Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに届く前に呼び出しを検証する際に Router が使用するドキュメントと同じものです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージへ再ホスト(RE-HOST)されます。ここにある他のフィールドはすべて BytePlus 自身のものです。Nullable: BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になっていることがあります。 + ビデオ生成タスクの完了後の出力。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 自身のものです。Nullable。BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になっていることがあります。 - 生成済みビデオの最終フレームのダウンロード 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 を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード 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 を保存するのではなくフレームをダウンロードしてください。 - 生成済みビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く(トップレベルの `output_format` フィールドを参照)、Router は存在するほうを読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)。BytePlus が `content` の中にネストして返す場合に存在します。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在するほうを読み取ります。 - 上流 URL が機能しなくなる RFC 3339 時刻。URL 自体が持つ最も早い署名時刻と有効期間を足したもので、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間(BytePlus が文書化している URL の寿命)を足した時刻より遅くなることはなく、存在しない場合はタスクの `updated_at` に 24 時間を足した時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流 URL が機能しなくなる RFC 3339 時刻。最も早い署名時刻に URL 自体が持つ有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間を加えたもの(BytePlus がドキュメント化している URL の寿命)より後になることはなく、存在しない場合はタスクの `updated_at` に 24 時間を加えたものです。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 - Format: `date-time` + 形式: `date-time` - 最終フレームの BytePlus 自身のダウンロード URL で、再ホストされた `last_frame_url` の隣にバイト単位でそのまま返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみ、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報です。 + 最終フレームについての BytePlus 自身のダウンロード URL。再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのままのバイト列として返されます。オプトインしたワークスペースのみ、Seedance 2.x のみが対象で、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報として扱われます。 - 出力ビデオの BytePlus 自身のダウンロード URL で、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x のタスクでのみ存在します(リクエストパラメータはありません)。それ以外では存在しません。ワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシー APIキーなど)も含まれ、生成から 24 時間後に BytePlus が URL をクリアすると存在しなくなります。これは署名付きオブジェクトストレージの URL であり、したがってベアラー資格情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットとして扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストが消費します。 + 出力ビデオについての BytePlus 自身のダウンロード URL。再ホストされた `video_url` の隣に、そのままのバイト列として返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x のタスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべての場合には存在しません。たとえばワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシー APIキーなど)の場合も含みます。また、生成から 24 時間後に BytePlus が URL をクリアすると存在しなくなります。これは署名付きオブジェクトストレージの URL であり、したがってベアラー資格情報です。所持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットと同様に扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL です。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再表示されるため、後のポーリングでは残り 1 時間程度の URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルでは 100 回のダウンロードに制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロード URL。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再送されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限しています。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻。値は秒単位の UNIX タイムスタンプです。 - 生成済みビデオの再生時間(秒)。BytePlus が一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す一方、同系列の BytePlus のサーフェスは小数の再生時間を報告することが観測されており、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すこともあれば、同じ BytePlus の別のサーフェスが小数の再生時間を報告することも確認されているため、クライアントは整数値であると仮定してはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドット区切りの理由が付くことがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列であり、他のコードは検証やプロバイダーの失敗を表します。Router はポリシーファミリーを HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答で認識し、トランスポートの失敗を上書きすることはありません。 @@ -400,7 +403,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js - ビデオ生成タスクのID + 動画生成タスクの ID @@ -408,15 +411,15 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedanceのビデオタスククエリはここに返します。BytePlus独自のフィールドで、変更されずにそのまま転送されます。 + 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -424,11 +427,11 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js タスクの状態 - 指定可能な値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + 取りうる値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - タスクが最後に更新された時間。値は秒単位のUNIXタイムスタンプです。 + タスクが最後に更新された時間。この値は秒単位の UNIX タイムスタンプです。 @@ -440,7 +443,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js - ビデオ生成モデルでは、入力トークン数は計算されず、0がデフォルトです。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは入力トークン数は計算されず、0 が既定値です。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 2f8f216ebd..b75228e1db 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Dreamina Seedance 2.0 Mini を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-mini を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: a1d75c67 +translationSourceHash: 69e65942 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": ebf1fc3a + "Schema": 51a6f44e "Examples": db01067e --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/byteplus/dreamina-seedance-2-0-mini.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果を取得するには、代わりにタスクステータス取得ルートをポーリングしてください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに、結果はタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -192,23 +193,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request - 入力オーディオオブジェクト。オーディオ入力をサポートするのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単独では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力もサポートします。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - オーディオURL、Base64 エンコード、またはアセット ID。 -オーディオURL: オーディオの公開URL(wav、mp3)。 -Base64: 形式 data:audio/\;base64,\ -アセット ID: 形式 asset://\ + オーディオ URL、Base64 エンコード、またはアセット ID。 +オーディオ URL: オーディオの公開 URL(wav、mp3)。 +Base64: 形式は data:audio/\;base64,\ +アセット ID: 形式は asset://\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。解像度のデフォルトは 1080p で、1080p のみサポートします。 +最終ビデオは Draft タスクの prompt、入力アセット、duration、ratio、seed、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終出力のティア(4k を含む)に合わせてこのリクエストで resolution を設定してください。省略した場合、最終出力は 1080p になります。 - Draft ビデオを `draft` を true に設定して作成したときに返されたタスク ID。 + `draft` を true にして Draft ビデオを作成したときに返されるタスク ID。 @@ -216,185 +217,185 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) -画像URL: 画像URLにアクセス可能であることを確認してください。 + 画像から動画への生成のための画像コンテンツ(type が "image_url" の場合) +画像 URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式 asset://\ +アセット ID: 形式は asset://\ コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、または reference_image。 -ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 -オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +画像の場合: first_frame、last_frame、reference_image。 +ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 取り得る値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 +テキストプロンプト(必須): 中国語および英語の文字で生成するビデオを記述します。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): テキストプロンプトの後に --[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 自身のバリデータが代わりに -応答します。実際のトラフィックよりはるかに高く設定されているため、正規の -プロンプトがこれによって判断されることはありません。呼び出し元がより多くを -必要とする場合は引き上げてください。 +テキスト長の上限を公開しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 +バイト数ではなく文字数をカウントするため、マルチバイトのプロンプトでは通信上の +サイズがこの数倍になることがあります。これはこの 1 つのフィールドを制限するもので、 +リクエスト全体を制限するものではありません。`content` は配列であり、ドキュメント +全体を制限するのはリクエストごとのボディ上限です。これを強制するのは Comfy Router +(/v2/models/byteplus/\{model})のサーフェスです。v1 /proxy を直接呼び出す場合は、 +代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックをはるかに +上回る値に設定されているため、正当なプロンプトがこれで判定されることはありません。 +呼び出し元がさらに多くを必要とする場合は引き上げてください。 入力コンテンツのタイプ - 取り得る値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力をサポートするのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 - ビデオURLまたはアセット ID。 -ビデオURL: ビデオの公開URL(mp4、mov)。 -アセット ID: 形式 asset://\ + ビデオ URL またはアセット ID。 +ビデオ URL: ビデオの公開 URL(mp4、mov)。 +アセット ID: 形式は asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終ビデオをレンダリングします。そのリクエストで最終出力の resolution(4k を含む)を設定します。resolution を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウト閾値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 範囲: `3600` 〜 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 プロでサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外の点では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 +false: モデルは無音のビデオを出力します。 +対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオ用に `false` を送ってください。これが有効なのは、拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キューのリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 - 呼び出すモデルの 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 で拒否します。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントから設定するため、このスキーマの `required` リストには含まれていません。そのため Router の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性があり、ファイルサイズも小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適していますが、ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性がありファイルサイズも小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + Possible values: `mp4`, `mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 +Seedance 2.5 の最初のフレーム / 最初と最後のフレーム生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + Possible values: `480p`, `720p`, `1080p`, `4k` - 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークも含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 -false: 生成されたビデオの最終フレーム画像を返しません。 + 生成されたビデオの最後のフレーム画像を返すかどうか。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報をクエリすることで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。前に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオを素早く生成できます。 +false: 生成されたビデオの最後のフレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 を指定するとランダムなシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 - 範囲: `-1` から `4294967295` + Range: `-1` to `4294967295` 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + Possible values: `default`, `flex` - 生成されたビデオにウォーターマークを含めるかどうか。 + 生成されたビデオに透かしを含めるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で Router が提供するスキーマから生成されたもので、リクエストがプロバイダーに届く前に Router が呼び出しを検証する際に使用するのと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使われるのと同じドキュメントです。 ### 出力 - ビデオ生成タスク完了後の出力。出力ビデオのダウンロードURLと、BytePlusが返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyストレージに再ホストされます。ここにある他のフィールドはすべてBytePlus独自のものです。Null許容: BytePlusはタスクの24時間後にURLをクリアするため、その後でポーリングされた成功済みドキュメントは `content` が存在しないかnullである可能性があります。 + ビデオ生成タスク完了後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、それ以外のフィールドはすべて BytePlus 自身のものです。Nullable - BytePlus はタスクの24時間後にURLを消去するため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になっていることがあります。 - 生成済みビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - 生成済みビデオのコンテナ形式(mp4 または mov)。BytePlusが `content` 内にネストする場合に含まれます。Seedanceモデルはより一般的には `content` のトップレベルの兄弟としてこれを返します(トップレベルの `output_format` フィールドを参照)。Routerはいずれか存在する方を読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中に入れ子にして返す場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 - アップストリームURLが機能しなくなるRFC 3339時刻。URL自体が持つ有効性に最も早い署名時刻を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusがドキュメント化しているURLの寿命)を加えた時刻より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ含まれ、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の有効期間とは無関係です。 + 上流のURLが機能しなくなる RFC 3339 時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus が文書化しているURLの寿命)を加えた時刻より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 形式: `date-time` - 最終フレームのBytePlus独自のダウンロードURL。再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインされたワークスペースのみ、Seedance 2.x のみ、BytePlusがクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報です。 + 最終フレームに対する BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのままの形で返されます。オプトイン済みのワークスペースのみ、Seedance 2.x のみで、BytePlus が消去すると存在しなくなり、`upstream_expires_at` まではベアラー認証情報として扱われます。 - 出力ビデオのBytePlus独自のダウンロードURL。再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされるSeedance 2.xタスクにのみ含まれます(リクエストパラメーターはありません)。それ以外のすべての場合には含まれません。ワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)も同様です。また、生成から24時間後にBytePlusがURLをクリアすると存在しなくなります。これは署名済みオブジェクトストレージURLであり、したがってベアラー資格情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、秘密情報として扱ってください。`upstream_expires_at` に期限切れになり、Seedance 2.5 ではBytePlusが100ダウンロードに制限しており、そのうちの1回はRouter自身の再ホストが消費します。 + 出力ビデオに対する BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にそのままの形で返されます。Comfy がサーバー側でオプトインしたワークスペースによってポーリングされた Seedance 2.x タスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべてでは存在しません。ワークスペースに解決されない認証情報(ワークスペースにスコープされていないレガシー APIキーなど)も含まれ、BytePlus が生成の24時間後にURLを消去すると存在しなくなります。これは署名付きオブジェクトストレージのURLであるためベアラー認証情報であり、それを保持する誰もが期限切れまでビデオをダウンロードできます。したがって秘密情報として扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストで消費されます。 - 出力ビデオのダウンロードURL。RouterはビデオをComfyストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り最短1時間のものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus独自のURLを保持します。BytePlusはタスクの24時間後にそれをクリアし、一部のモデルでは100ダウンロードに制限します。いずれにしてもリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身のURLのままとなり、BytePlus はタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は秒単位のUNIXタイムスタンプです。 + タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 - 生成済みビデオの再生時間(秒)。BytePlusがこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すことや、兄弟のBytePlusサーフェスが小数の再生時間を報告することが観察されているため、クライアントは整数値を仮定してはいけません。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すことも、同系統の BytePlus の他の画面が小数の再生時間を報告することも観測されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 - アップストリームのModelArkエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetectedはコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFakeのようなドット区切りの理由が付く場合があります。これは列挙型ではなくオープンな文字列です。他のコードは検証とプロバイダーの失敗を説明します。RouterはHTTP 400エラーエンベロープおよびHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きしません。 + 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列であり、他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答の双方でポリシーファミリーを認識し、トランスポートの失敗を上書きすることはありません。 @@ -402,7 +403,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - ビデオ生成タスクのID + 動画生成タスクの ID @@ -410,11 +411,11 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 + 生成されたビデオのコンテナ形式 (`mp4` または `mov`)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成されたビデオの解像度 (例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 @@ -426,11 +427,11 @@ false: 生成されたビデオの最終フレーム画像を返しません。 タスクの状態 - 指定可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 取りうる値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - タスクが最後に更新された日時。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -442,7 +443,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - ビデオ生成モデルでは入力トークン数は計算されず、0 が既定値です。そのため、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず 0 がデフォルトになります。したがって、total_tokens = completion_tokens です。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 048ce0e7a1..ed04b46323 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,19 +2,20 @@ title: "Dreamina Seedance 2.5 260628 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-5-260628 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンス。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 3606fb83 +translationSourceHash: 2acd3f28 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": d2c28a84 + "Schema": d29d4b46 "Examples": 5465695b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -195,7 +196,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックは一切送信されません。結果を取得するには、代わりにタスクステータスルートをポーリングしてください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果はタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -205,23 +206,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみで使用することはできません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 オーディオ URL、Base64 エンコーディング、またはアセット ID。 -オーディオ URL: オーディオの公開 URL(wav、mp3)。 +オーディオ URL: オーディオ(wav、mp3)の公開 URL。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。再度送信しないでください。解像度はデフォルトで 1080p になり、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。これは唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。最終ビデオの出力ティア(4k を含む)はこのリクエストの resolution で設定します。省略した場合、最終ビデオは 1080p になります。 - Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 + Draft ビデオを `draft` を true に設定して作成したときに返されたタスク ID。 @@ -229,25 +230,25 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコーディングされたコンテンツ: 形式は data:image/\;base64,\ である必要があります + 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) +画像 URL: 画像 URL にアクセス可能であることを確認してください。 +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります。 アセット ID: 形式 asset://\ コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、または reference_image。 +画像の場合: first_frame、last_frame、reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 設定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 +テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。 パラメータ(任意): テキストプロンプトの後に --[parameters] を追加して、ビデオの仕様を制御します: - --resolution(--rs): 480p、720p、1080p(デフォルト: 720p) @@ -255,26 +256,28 @@ Base64 エンコーディングされたコンテンツ: 形式は data:image/\< - --duration(--dur): 3〜12 秒(デフォルト: 5) - --framepersecond(--fps): 24(デフォルト: 24) - --watermark(--wm): true/false(デフォルト: false) -- --seed(--seed): -1 から 2^32-1(デフォルト: -1) +- --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 自身の -バリデータが応答します。実際のトラフィックをはるかに上回る値に設定されているため、 -本物のプロンプトが拒否されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 +テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。これはバイト数ではなく文字数をカウントするため、マルチバイトの +プロンプトでは転送時にこの数倍のサイズになることがあります。これはこの 1 つの +フィールドを制限するものであり、リクエスト全体ではありません: +`content` は配列であり、ドキュメント全体を制限するのはリクエストごとの +ボディ上限です。これを適用するのは Comfy Router +(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出す場合は、 +代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに +高く設定されているため、正当なプロンプトがこれで判定されることはありません。 +呼び出し元がさらに必要とする場合は引き上げてください。 入力コンテンツのタイプ - 設定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -283,121 +286,122 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ ビデオ URL またはアセット ID。 -ビデオ URL: ビデオの公開 URL(mp4、mov)。 +ビデオ URL: ビデオ(mp4、mov)の公開 URL。 アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終ビデオがレンダリングされます。そのリクエストで最終ビデオの解像度(4k を含む)を設定します。resolution を省略した場合、最終ビデオは 1080p になります。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動)。 - 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` + 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`、`16`、`17`、`18`、`19`、`20`、`21`、`22`、`23`、`24`、`25`、`26`、`27`、`28`、`29`、`30` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` から `259200` + 範囲: `3600` 〜 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオだった場合のみで、同期 Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を作り直してください。 +false: モデルは無音のビデオを出力します。 +対応しているモデルでは、生成されたオーディオトラックはプロバイダーによってビデオとは別にコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力でも断続的に発生することがあります。そのような場合は、サイレントビデオにするために `false` を送ってください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さなファイルサイズ。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性がありファイルサイズも小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 可能な値: `mp4`, `mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみ受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 可能な値: `480p`, `720p`, `1080p`, `4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報をクエリする呼び出しで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定した後、「ビデオ生成タスクの情報をクエリする」を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。以前に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオをすばやく生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 を指定するとランダムシードが使用されます。 範囲: `-1` から `4294967295` - 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理用のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 可能な値: `default`, `flex` - 生成されたビデオに透かしを含めるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。 ### 出力 - ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合にはその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のフィールドはすべて BytePlus 自身のものです。null 許容: BytePlus はタスクの24時間後に URL をクリアするため、その後ポーリングされた succeeded ドキュメントでは `content` が存在しないか null になることがあります。 + ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロードURLと、BytePlus が返した場合にはその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにあるそれ以外のフィールドはすべて BytePlus 自身のものです。nullable です。BytePlus はタスクの24時間後に URL をクリアするため、その後にポーリングした succeeded ドキュメントでは `content` が存在しないか null になることがあります。 - 生成されたビデオの最終フレームのダウンロード 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 を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード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 を保存するのではなくフレームをダウンロードしてください。 - BytePlus が `content` の中に入れ子にしている場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedance モデルは通常これを `content` のトップレベルの兄弟として返します。トップレベルの `output_format` フィールドを参照してください。Router は存在する方の値を読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、トップレベルの `output_format` フィールドを参照してください。Router は存在する方のフィールドを読み取ります。 - 上流 URL が動作しなくなる RFC 3339 時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えた時刻で、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus がドキュメント化している URL の寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流の URL が機能しなくなる RFC 3339 の時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えた値で、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus が文書化している URL の寿命)を加えた値を超えることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた値です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースからも時刻が得られない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは関係ありません。 形式: `date-time` - BytePlus 自身の最終フレーム用ダウンロード URL で、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラ認証情報です。 + 最終フレームの BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位のまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在せず、`upstream_expires_at` まではベアラ認証情報として扱われます。 - BytePlus 自身の出力ビデオ用ダウンロード URL で、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングした Seedance 2.x タスクにのみ存在し(リクエストパラメーターはありません)、それ以外の場合は存在しません。特定のワークスペースにスコープされていないレガシー APIキーなど、ワークスペースに解決されない認証情報も含まれます。また、BytePlus が生成の24時間後に URL をクリアすると存在しなくなります。これは署名付きオブジェクトストレージ URL であるためベアラ認証情報です。保有する誰もが有効期限までビデオをダウンロードできるので、秘密情報として扱ってください。`upstream_expires_at` で期限切れとなり、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストで消費されます。 + 出力ビデオの BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にバイト単位のまま返されます。サーバー側で Comfy がオプトインしたワークスペースがポーリングする Seedance 2.x タスクにのみ存在します(リクエストパラメータはありません)。それ以外のすべての場合、たとえばワークスペースに解決されない認証情報(特定のワークスペースにスコープされていないレガシー APIキーなど)には存在せず、BytePlus が生成の24時間後に URL をクリアすると存在しなくなります。これは署名済みのオブジェクトストレージ URL であり、したがってベアラ認証情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットと同様に扱ってください。`upstream_expires_at` に失効し、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストが消費します。 - 出力ビデオのダウンロード URL です。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再送されるため、後でポーリングすると残り1時間程度のものが返されることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身の URL がそのまま残り、BytePlus はタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身の URL のままとなり、BytePlus がタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数が100回に制限されます。いずれにせよリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻です。値は UNIX タイムスタンプ(秒)です。 + タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlus の扱いが一貫していないためです。ビデオタスクでは整数秒が返されることが観測されており、隣接する BytePlus のサーフェスでは小数の再生時間が報告されているため、クライアントは整数値を仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlus の扱いが一貫していないためです。ビデオタスクが整数の秒を返す一方で、同じ BytePlus の他のサーフェスでは小数の再生時間が報告されることが観測されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 @@ -405,7 +409,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは enum ではなくオープンな文字列です。その他のコードは検証およびプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは enum ではなくオープンな文字列です。その他のコードは検証やプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識し、トランスポート障害を上書きすることはありません。 @@ -413,7 +417,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - ビデオ生成タスクの ID + 動画生成タスクの ID @@ -421,11 +425,11 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリが返す場所はここです。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 + 生成されたビデオのコンテナ形式 (mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成されたビデオの解像度 (例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 @@ -449,11 +453,11 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - モデルによって生成されたトークン数 + モデルによって生成されたトークンの数 - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークンの数は計算されず、0 がデフォルトになります。したがって、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index a2c17b032b..23942f9c9d 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Seedance 1.0 Pro 250528 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-250528 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 642f85ab +translationSourceHash: 846f38d7 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": b57b84de + "Schema": 6f05c994 "Examples": 815d621e --- + {/* 生成済みファイル。`pnpm code-pages:gen` によって router-schemas/byteplus/seedance-1-0-pro-250528.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 入力 - 無視されます。BytePlusのリクエスト形状との互換性のために受け付けられますが、タスクの送信前に削除されるため、コールバックが送信されることはありません。結果はタスクステータスのルートをポーリングして取得してください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックは一切送信されません。結果はタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -192,23 +193,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみを使用できません。少なくとも1つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートしています。 - オーディオURL、Base64エンコード、またはアセットID。 -オーディオURL: オーディオ(wav、mp3)の公開URL。 + オーディオURL、Base64 エンコード、またはアセット ID。 +オーディオURL: オーディオの公開URL(wav、mp3)。 Base64: 形式 data:audio/\;base64,\ -アセットID: 形式 asset://\ +アセット ID: 形式 asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。唯一のコンテンツ項目である必要があります。 -最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終出力のティア(4k を含む)を設定するには、このリクエストで resolution を指定します。省略した場合、最終出力は 1080p になります。 - `draft` を true に設定してドラフトビデオを作成したときに返されるタスクID。 + Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 @@ -216,15 +217,15 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) + 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) 画像URL: 画像URLにアクセスできることを確認してください。 -Base64エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセットID: 形式 asset://\ +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります +アセット ID: 形式 asset://\ コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、または reference_image。 +画像の場合: first_frame、last_frame、reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 @@ -232,14 +233,14 @@ Base64エンコードされたコンテンツ: 形式は data:image/\;ba - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 -テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 +テキストプロンプト(必須): 中国語と英語の文字を使用して、生成するビデオを説明します。 -パラメータ(任意): テキストプロンプトの後に --[parameters] を追加すると、ビデオの仕様を制御できます: +パラメータ(任意): テキストプロンプトの後に --[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) +- --duration (--dur): 3〜12 秒(デフォルト: 5) - --framepersecond (--fps): 24(デフォルト: 24) - --watermark (--wm): true/false(デフォルト: false) - --seed (--seed): -1 〜 2^32-1(デフォルト: -1) @@ -247,15 +248,7 @@ Base64エンコードされたコンテンツ: 形式は data:image/\;ba 例: "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 自身のバリデータが -代わりに応答します。実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトを -判定することはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 +Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus はテキスト長の制限を公表しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは転送時にこのサイズの数倍になることがあります。これはこの 1 つのフィールドを制限するものであり、リクエスト全体を制限するものではありません。`content` は配列であり、ドキュメント全体を制限するのはリクエストごとのボディ上限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出した場合は、代わりに BytePlus 独自のバリデータが応答します。実際のトラフィックをはるかに超える値に設定されているため、正当なプロンプトを判定することはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 @@ -269,68 +262,69 @@ Comfy側のガードレールであり、BytePlusの制約ではありません - ビデオURLまたはアセットID。 -ビデオURL: ビデオ(mp4、mov)の公開URL。 -アセットID: 形式 asset://\ + ビデオURLまたはアセット ID。 +ビデオURL: ビデオの公開URL(mp4、mov)。 +アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p のドラフトビデオを生成します。resolution は 480p である必要があります。 -返されたタスクIDを `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスクIDは7日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目に渡して最終ビデオをレンダリングします。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 1.0 pro、1.0 pro fast: [2,12]。 + ビデオの再生時間(秒)。Seedance 1.0 pro および 1.0 pro fast: [2,12]。 - 指定可能な値: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` + 指定可能な値: `2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` 〜 `259200` + 範囲: `3600` から `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。サポートされているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を再作成してください。 +false: モデルは無音のビデオを出力します。 +対応しているモデルでは、生成されたオーディオトラックはプロバイダーによってビデオとは別にコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外では受け入れる入力に対して断続的に発生することがあります。そのような場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ識別されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに Draft を `false` で再作成してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さいファイルサイズを備えます。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適しています。ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性がありファイルサイズも小さくなります。 +mov: プロ向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適しています。ファイルサイズは大きくなります。 指定可能な値: `mp4`、`mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け付けられます。具体的な比率を指定するとディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 指定可能な値: `480p`、`720p`、`1080p`、`4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会するを呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームが次のビデオタスクの先頭フレームとして使用され、複数の連続したビデオをすばやく生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会することで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームが次のビデオタスクの先頭フレームとして使用され、複数の連続したビデオをすばやく生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + ランダム性を制御するためのシード整数値。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 範囲: `-1` から `4294967295` @@ -342,57 +336,57 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 生成されたビデオにウォーターマークを含めるかどうか。 + 生成されたビデオにウォーターマークが含まれるかどうか。 -Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 +`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で Router が配信するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使われるのと同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力。出力ビデオのダウンロード URL と、BytePlus が返す場合にはその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 自身のものです。Nullable:BytePlus はタスクの 24 時間後に URL をクリアするため、その後ポーリングした成功済みドキュメントでは `content` が存在しないか null になることがあります。 + ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL に加え、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージへ再ホストされ、ここにある他のフィールドはすべて BytePlus 自身のものです。null を許容します。BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になることがあります。 - `return_last_frame` がリクエストで設定された場合に返される、生成されたビデオの最終フレームのダウンロード URL。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG と記載していますが、Router は提供されたバイト列をそのまま再ホストし、アップストリームの Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` は両方が失敗した場合の最後のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL です。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード 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 を保存するのではなくフレームをダウンロードしてください。 - BytePlus が `content` 内にネストして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)。Seedance モデルはこれを `content` と同じ階層のトップレベルフィールドとして返すことがより一般的です。トップレベルの `output_format` フィールドを参照してください。Router は存在する方のフィールドを読み取ります。 + BytePlus が `content` の中に入れ子にして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedance のモデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在するほうを読み取ります。 - アップストリーム URL が機能しなくなる RFC 3339 時刻。URL 自体が持つ有効期間を最も早い署名時刻に加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間(BytePlus が文書化している URL の寿命)を加えた時刻より遅くなることはありません。存在しない場合はタスクの `updated_at` に 24 時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流の URL が機能しなくなる RFC 3339 形式の時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えたものですが、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間(BytePlus が文書化している URL の寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に 24 時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ含まれ、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは関係ありません。 形式: `date-time` - BytePlus 自身の最終フレームのダウンロード URL。再ホストされた `last_frame_url` の隣にバイト単位でそのまま返され、`upstream_video_url` と同じ条件です。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報です。 + 最終フレームについての BytePlus 自身のダウンロード URL で、再ホストされた `last_frame_url` の隣にそのままのバイト列で返されます。条件は `upstream_video_url` と同じです。すなわち、オプトインしたワークスペースのみ、Seedance 2.x のみであり、BytePlus がクリアした後は存在せず、`upstream_expires_at` まではベアラー資格情報として扱われます。 - BytePlus 自身の出力ビデオのダウンロード URL。再ホストされた `video_url` の隣にバイト単位でそのまま返されます。サーバー側で Comfy がオプトインしたワークスペースがポーリングする Seedance 2.x タスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべて(ワークスペースに解決されない資格情報、たとえばワークスペースにスコープされていないレガシー APIキーなど)では存在しません。また、BytePlus が生成の 24 時間後に URL をクリアすると存在しなくなります。これは事前署名されたオブジェクトストレージ URL であるため、ベアラー資格情報です。保持している人は有効期限までビデオをダウンロードできるので、秘密情報と同様に扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストで消費されます。 + 出力ビデオについての BytePlus 自身のダウンロード URL で、再ホストされた `video_url` の隣にそのままのバイト列で返されます。Comfy がサーバー側でオプトインしたワークスペースによるポーリングの Seedance 2.x タスクにのみ含まれます(リクエストパラメーターはありません)。それ以外の場合は含まれず、ワークスペースに解決されない資格情報(特定のワークスペースに紐付かないレガシーな API キーなど)も同様です。また、生成の 24 時間後に BytePlus が URL をクリアすると存在しなくなります。これは署名付きのオブジェクトストレージ URL、つまりベアラー資格情報であるため、これを保持する誰もが失効までビデオをダウンロードできます。秘密情報と同様に扱ってください。`upstream_expires_at` で失効し、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストが消費します。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL です。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロード URL です。Router はビデオを Comfy のストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy が署名した URL になります。発行時に 24 時間で署名され、23 時間のメモから再利用されるため、後からのポーリングでは残り 1 時間程度の URL が返ることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身の URL がこのフィールドに残りますが、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限します。いずれの場合もリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は UNIX タイムスタンプ(秒)です。 + タスクが作成された日時です。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間(秒)。BytePlus が一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは整数秒が返される一方、BytePlus の関連サーフェスでは小数の再生時間が報告されることが確認されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す例も確認されており、BytePlus の他のサーフェスでは小数の再生時間が報告されることもあるため、クライアントは整数値だと仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 - アップストリーム ModelArk のエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のようにドット区切りの理由が付くことがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 エラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは enum ではなくオープンな文字列であり、他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答の両方でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -400,7 +394,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - The ID of the video generation task + 動画生成タスクの ID @@ -408,15 +402,15 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 自身のフィールドで、変更されずにそのまま転送されます。 + 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成済みビデオの解像度。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -428,7 +422,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。この値は秒単位の UNIX タイムスタンプです。 @@ -440,7 +434,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは入力トークン数は計算されず、0 が既定値です。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index ee5d48e414..031d1e9dd4 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,18 +2,19 @@ title: "Seedance 1.0 Pro Fast 251015 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-fast-251015 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて解説します。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 61dd0135 +translationSourceHash: 5ba64878 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": dd74b012 + "Schema": 2de625f5 "Examples": 1469ab97 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-fast-251015.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,23 +193,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートします。 オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオの公開 URL(wav、mp3)。 -Base64: 形式 data:audio/\;base64,\ -アセット ID: 形式 asset://\ +オーディオ URL: オーディオ(wav、mp3)の公開 URL。 +Base64: data:audio/\;base64,\ の形式 +アセット ID: asset://\ の形式 Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p となり、1080p のみをサポートします。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。最終出力のティア(4k を含む)はこのリクエストで解像度を設定してください。省略した場合、最終出力は 1080p になります。 - `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 + Draft ビデオを `draft` を true に設定して作成したときに返されたタスク ID。 @@ -216,10 +217,10 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) + 画像から動画を生成するための画像コンテンツ(type が "image_url" の場合) 画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式 asset://\ +Base64 エンコードされたコンテンツ: data:image/\;base64,\ の形式である必要があります +アセット ID: asset://\ の形式 @@ -234,34 +235,34 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字で記述する、生成するビデオの説明。 +テキストプロンプト(必須): 中国語および英語の文字を使用して、生成するビデオを記述します。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): テキストプロンプトの後に --[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 自身のバリデータが応答します。実際のトラフィックよりはるかに高く -設定されているため、本物のプロンプトが制限されることはありません。呼び出し元が -より多くを必要とする場合はこの値を引き上げてください。 +受け付けました。文字数でカウントし、バイト数ではないため、マルチバイトの +プロンプトは通信時にこのサイズの数倍になることがあります。これはこの 1 つの +フィールドを制限するものであり、リクエスト全体ではありません。`content` は +配列であり、ドキュメント全体を制限するのはリクエストごとのボディ上限です。 +これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。 +v1 /proxy を直接呼び出した場合は、代わりに BytePlus 自身のバリデータが +応答します。実際のトラフィックよりはるかに高く設定されているため、正当な +プロンプトが判定されることはありません。呼び出し元がより多くを必要とする +場合は引き上げてください。 - 入力コンテンツのタイプ + 入力コンテンツの種類 取り得る値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -272,129 +273,130 @@ BytePlus 自身のバリデータが応答します。実際のトラフィッ ビデオ URL またはアセット ID。 -ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式 asset://\ +ビデオ URL: ビデオ(mp4、mov)の公開 URL。 +アセット ID: asset://\ の形式 Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目に渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 +返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終ビデオをレンダリングできます。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 1.0 pro、1.0 pro fast: [2,12]。 + ビデオの再生時間(秒)。Seedance 1.0 pro および 1.0 pro fast: [2,12]。 - 指定可能な値: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` + 取り得る値: `2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` から `259200` + 範囲: `3600` 〜 `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。これをサポートするモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対して断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 +false: モデルは無音のビデオを出力します。 +対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外の点では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオ用に `false` を送信してください。これが効果を発揮するのは拒否されたモダリティがオーディオであった場合のみで、同期 Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは自身の Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を再作成してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式です。 -mp4: 一般用途向けコンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さいファイルサイズを備えます。 -mov: プロ向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズが小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` - 生成されたビデオの比率。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の最初のフレーム / 最初と最後のフレーム生成: 出力は最初のフレームの比率に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはこのフィールドの省略)のみが受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - ビデオ解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p、4k をサポートしています。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` - 生成されたビデオの最後のフレーム画像を返すかどうか。 -true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定した後、ビデオ生成タスクの情報を照会する操作を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームが次のビデオタスクの最初のフレームとして使用されるため、複数の連続したビデオをすばやく生成できます。 -false: 生成されたビデオの最後のフレーム画像を返しません。 + 生成されたビデオの最終フレーム画像を返すかどうか。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 +false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 範囲: `-1` から `4294967295` - 処理用のサービス階層。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしていません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `default`、`flex` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 +Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 - ビデオ生成タスクが完了した後の出力で、出力ビデオのダウンロードURLと、BytePlusが返す場合にはその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージへ再ホストされ、ここにある他のフィールドはすべてBytePlus独自のものです。Null許容:BytePlusはタスクの24時間後にURLを消去するため、その後でポーリングした成功ドキュメントでは `content` が存在しないかnullになっていることがあります。 + ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 自身のものです。Nullable: タスクの24時間後に BytePlus がURLを消去するため、その後にポーリングした成功済みドキュメントでは `content` が欠落または null になることがあります。 - 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナ形式(mp4 または mov)。BytePlusが `content` の中にネストして返す場合のものです。Seedanceモデルでは、`content` のトップレベルの兄弟として返すことの方が一般的です(トップレベルの `output_format` フィールドを参照)。Routerはいずれか存在する方を読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 - 上流URLが機能しなくなるRFC 3339時刻。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間を加えた時刻(BytePlusが文書化しているURLの寿命)より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流のURLが機能しなくなる RFC 3339 時刻です。URL自体が持つ最も早い署名時刻と有効期間、ただし `updated_at` が存在する場合はタスクの `updated_at` と24時間(BytePlus の文書化されたURLの寿命)のうち遅くない方、存在しない場合はタスクの `updated_at` と24時間です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 形式: `date-time` - 最終フレームに対するBytePlus独自のダウンロードURL。再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみ、BytePlusが消去すると存在しなくなり、`upstream_expires_at` まではベアラー認証情報です。 + BytePlus 自身の最終フレームのダウンロードURLで、再ホストされた `last_frame_url` の隣にそのままのバイト列で返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみ、BytePlus が消去すると欠落し、`upstream_expires_at` まではベアラ資格情報です。 - 出力ビデオに対するBytePlus独自のダウンロードURL。再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースがポーリングするSeedance 2.xタスクにのみ存在します(リクエストパラメータはありません)。それ以外の場合は存在せず、ワークスペースに解決されない認証情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)も含まれます。また、BytePlusが生成の24時間後にURLを消去すると存在しなくなります。これは署名付きオブジェクトストレージのURLであり、したがってベアラー認証情報でもあるため、保持している人は誰でも有効期限までビデオをダウンロードできます。秘密情報として扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストで消費されます。 + BytePlus 自身の出力ビデオのダウンロードURLで、再ホストされた `video_url` の隣にそのままのバイト列で返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x タスクでのみ存在します(リクエストパラメータはありません)。それ以外のすべての場合、たとえばワークスペースに解決されない資格情報(ワークスペースにスコープされていないレガシー APIキーなど)では存在せず、また生成から24時間後に BytePlus がURLを消去すると存在しなくなります。これは署名付きオブジェクトストレージのURLであり、したがってベアラ資格情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、秘密情報として扱ってください。`upstream_expires_at` に失効し、Seedance 2.5 では BytePlus が100回のダウンロードに制限しており、そのうち1回は Router 自身の再ホストが消費します。 - 出力ビデオのダウンロードURL。RouterはビデオをComfyのストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後のポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus独自のURLを保持し、BytePlusはタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間程度のものが返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身のURLを保持し、BytePlus はタスクの24時間後にそれを消去し、一部のモデルでは100回のダウンロードに制限します。いずれの場合もリンクは失効するため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は秒単位のUNIXタイムスタンプです。 + タスクが作成された時刻。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間(秒)。BytePlusがこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すこともあれば、同じBytePlusの別のサーフェスが小数の再生時間を報告することも確認されているため、クライアントは値が整数であると仮定してはいけません。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す例や、姉妹の BytePlus サーフェスが小数の再生時間を報告する例が観測されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - エラー情報。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流のModelArkエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列で、他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの障害を上書きすることはありません。 @@ -402,7 +404,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - The ID of the video generation task + ビデオ生成タスクの ID @@ -410,15 +412,15 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 生成済みビデオのコンテナ形式 (`mp4` または `mov`)。Seedance のビデオタスククエリが返す場所である、`content` の兄弟としてトップレベルで返されます。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 - 生成済みビデオの解像度 (例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度。例: `1080p`。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -430,7 +432,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - タスクが最後に更新された時間。値は UNIX タイムスタンプ (秒) です。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -442,7 +444,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - ビデオ生成モデルでは、入力トークン数は計算されず、0 がデフォルトになります。そのため、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず、0 がデフォルトです。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 6134345bb4..b041fd3bee 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Seedance 1.5 Pro 251215 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-5-pro-251215 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 2263b4cf +translationSourceHash: 8c658f01 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": f4d67fb6 + "Schema": b9957cb9 "Examples": 7e73ac5c --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-5-pro-251215.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果は代わりにタスクステータスのルートをポーリングして取得してください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることは一切ありません。結果の取得には代わりにタスクステータスのルートをポーリングしてください。 形式: `uri` @@ -192,23 +193,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオの公開 URL(wav、mp3)。 +Audio URL: オーディオ(wav、mp3)の公開 URL。 Base64: 形式 data:audio/\;base64,\ -アセット ID: 形式 asset://\ +Asset ID: 形式 asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツアイテムである必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を引き継ぐため、これらを再度送信しないでください。最終ビデオの出力ティア(4k を含む)はこのリクエストで解像度を設定してください。省略した場合、最終ビデオは 1080p になります。 - `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 + Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 @@ -217,14 +218,14 @@ Base64: 形式 data:audio/\;base64,\ 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 +Image URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式 asset://\ +Asset ID: 形式 asset://\ - コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、reference_image。 + コンテンツアイテムの役割/位置。 +画像の場合: first_frame、last_frame、または reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 @@ -239,23 +240,25 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b パラメータ(任意): テキストプロンプトの後に --[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) +- --duration (--dur): 3〜12 秒(デフォルト: 5) - --framepersecond (--fps): 24(デフォルト: 24) - --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1~2^32-1(デフォルト: -1) +- --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 自身のバリデータが代わりに応答します。 -実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトが -これによって判定されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 +テキスト長の上限を公表しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトの +プロンプトではワイヤ上でこの数倍のサイズになることがあります。これはこの +1 つのフィールドを制限するものであり、リクエスト全体ではありません: +`content` は配列であり、文書全体を制限するのはリクエストごとのボディ上限です。 +これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。 +v1 の /proxy を直接呼び出す場合は、代わりに BytePlus 独自のバリデータが +応答します。実際のトラフィックよりはるかに高く設定されているため、本物の +プロンプトが判定の対象になることはありません。呼び出し元がより多くを必要と +する場合は引き上げてください。 @@ -265,67 +268,68 @@ v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが - 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 ビデオ URL またはアセット ID。 -ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式 asset://\ +Video URL: ビデオ(mp4、mov)の公開 URL。 +Asset ID: 形式 asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で指定して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツアイテムに渡して最終ビデオをレンダリングします。そのリクエストで最終ビデオの解像度(4k を含む)を設定します。解像度を省略した場合、最終ビデオは 1080p になります。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 1.5 pro: [4,12] または -1(自動)。 - 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` + 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48h)。範囲: [3600, 259200]。 - 範囲: `3600` から `259200` + 範囲: `3600` 〜 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 -true: モデルは同期オーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外の点では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。ただしこれが有効なのは拒否されたモダリティがオーディオだった場合だけで、同期 Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を作り直してください。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 +true: モデルは同期したオーディオ付きのビデオを出力します。 +false: モデルは無音のビデオを出力します。 +対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力であっても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズは小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズはより小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズはより大きくなります。 - 取り得る値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の最初フレーム / 最初と最後のフレームからの生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 +Seedance 2.5 の first-frame / first-last-frame 生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみ受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 - 取り得る値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - 取り得る値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` 生成されたビデオの最後のフレーム画像を返すかどうか。 -true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、「ビデオ生成タスクの情報を照会する」を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオをすばやく生成できます。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報のクエリを呼び出して最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用でき、複数の連続したビデオをすばやく生成できます。 false: 生成されたビデオの最後のフレーム画像を返しません。 @@ -336,63 +340,63 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 処理に使用するサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービス階層。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 - 取り得る値: `default`, `flex` + 指定可能な値: `default`、`flex` 生成されたビデオにウォーターマークを含めるかどうか。 -`GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。 +Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 自身のものです。Null 許容: BytePlus はタスクの24時間後にURLをクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になることがあります。 + ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロードURLと、BytePlusが返す場合にはその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされ、ここにある他のすべてのフィールドはBytePlus独自のものです。null許容: BytePlusはタスクの24時間後にURLをクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないかnullであることがあります。 - 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - BytePlus が `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式 (mp4 または mov) です。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + BytePlusが `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式(mp4またはmov)です。Seedanceモデルでは `content` のトップレベルの兄弟として返すことのほうが一般的です。トップレベルの `output_format` フィールドを参照してください。Routerは存在するほうを読み取ります。 - 上流のURLが機能しなくなる RFC 3339 時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたものであり、`updated_at` が存在する場合はタスクの `updated_at` に24時間 (BytePlus が文書化しているURLの寿命) を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻となります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + アップストリームのURLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusがドキュメント化しているURLの寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 形式: `date-time` - 最終フレームに対する BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのまま返されます。つまりオプトインしたワークスペースのみ、Seedance 2.x のみが対象で、BytePlus がクリアした後は存在せず、`upstream_expires_at` まではベアラー資格情報として扱われます。 + 再ホストされた `last_frame_url` の隣にバイト単位でそのまま返される、BytePlus独自の最終フレームのダウンロードURLです。条件は `upstream_video_url` と同じで、オプトインしたワークスペースのみ、Seedance 2.xのみ、BytePlusがクリアした後は存在せず、`upstream_expires_at` まではベアラ資格情報です。 - 出力ビデオに対する BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x のタスクにのみ存在し (リクエストパラメータはありません)、それ以外のすべての場合、例えばワークスペースに解決されない資格情報 (特定のワークスペースにスコープされていないレガシー APIキーなど) では存在しません。また、BytePlus が生成の24時間後にURLをクリアすると存在しなくなります。これは署名付きオブジェクトストレージのURLであり、したがってベアラー資格情報です。保持している誰もが有効期限までビデオをダウンロードできるため、シークレットと同様に扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストが消費します。 + 再ホストされた `video_url` の隣にバイト単位でそのまま返される、BytePlus独自の出力ビデオのダウンロードURLです。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされたSeedance 2.xタスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべての場合には存在しません。ワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)も含まれ、BytePlusが生成の24時間後にURLをクリアすると存在しなくなります。これは署名付きオブジェクトストレージのURL、つまりベアラ資格情報であるため、それを保持する誰もが有効期限までビデオをダウンロードできます。秘密情報と同様に扱ってください。`upstream_expires_at` で期限切れになり、Seedance 2.5ではBytePlusが100ダウンロードに制限しており、そのうち1回はRouter自身の再ホストで消費されます。 - 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身のURLのままとなり、BytePlus はタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でのポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus独自のURLを保持し、BytePlusはタスクの24時間後にそれをクリアし、一部のモデルでは100ダウンロードに制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値は秒単位のUNIXタイムスタンプです。 - 生成されたビデオの再生時間 (秒) です。整数ではなく数値として宣言されているのは、BytePlus の扱いが一貫していないためです。ビデオタスクでは整数秒が返されることが観測されており、同系列の BytePlus のサーフェスでは小数の再生時間が報告されることもあるため、クライアントは整数値であると仮定してはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlusの扱いが一貫していないためです。ビデオタスクでは整数秒が返されることが観測されており、同じBytePlusの他のサーフェスでは小数の再生時間が報告されるため、クライアントは整数値を前提にしてはいけません。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合は、エラー情報が返されます。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドットで区切られた理由が付くことがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + アップストリームのModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの障害を表します。RouterはHTTP 400のエラーエンベロープおよびHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの障害を上書きすることはありません。 @@ -400,7 +404,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - ビデオ生成タスクのID + 動画生成タスクの ID @@ -408,15 +412,15 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてTOP LEVELで返されます。Seedanceのビデオタスククエリがこの位置で返すためです。BytePlus自身のフィールドであり、変更されずに転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟要素として TOP LEVEL で返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus自身のフィールドであり、成功したビデオタスクで返され、変更されずに転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus自身のフィールドであり、成功したビデオタスクで返され、変更されずに転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -424,11 +428,11 @@ false: 生成されたビデオの最後のフレーム画像を返しません タスクの状態 - 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 指定可能な値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - タスクが最後に更新された時間。値は秒単位のUNIXタイムスタンプです。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -440,7 +444,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - ビデオ生成モデルでは入力トークン数は計算されず、0が既定値です。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは入力トークン数は計算されず、0 がデフォルトとなります。したがって、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/krea/krea-2-large/code.mdx b/ja/development/comfy-router/models/krea/krea-2-large/code.mdx index eaa6fe6ab4..f78d0f06ff 100644 --- a/ja/development/comfy-router/models/krea/krea-2-large/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-2-large/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Krea 2 Large を使う" description: "Comfy Router 経由で krea/krea-2-large を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Krea 2 Large" -translationSourceHash: a4fdfae2 +translationSourceHash: 19dca448 translationFrom: development/comfy-router/models/krea/krea-2-large/code.mdx translationBlockHashes: "_intro": bd2a615c "Quick start": 5d997ba7 - "Schema": d755f939 + "Schema": 9e43627e "Examples": 91f72543 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/krea/krea-2-large.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ curl https://api.comfy.org/v2/models/krea/krea-2-large/requests/$REQUEST_ID \ フォーマット: `date-time` + + status が failed の場合にのみ設定されます。キャンセル済みのジョブには含まれません。 + + + + ジョブが失敗した理由: content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal、node_app_node_failed。不明なコードは internal として扱ってください。 + + + + オプション。provider_error および internal に対するプロバイダーからの自由形式のテキスト。 + + + + 変更すべきリクエストパラメータ。invalid_request および validation_failed の場合に存在します。 + + フォーマット: `uuid` diff --git a/ja/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx b/ja/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx index d04c73ff2f..db1f808158 100644 --- a/ja/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx @@ -2,17 +2,18 @@ title: "Krea 2 Medium Turbo を Comfy Router で使用する" description: "Comfy Router 経由で krea/krea-2-medium-turbo を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Krea 2 Medium Turbo" -translationSourceHash: f61cb3f9 +translationSourceHash: 5a2af2e1 translationFrom: development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx translationBlockHashes: "_intro": fffee1bd "Quick start": a305dd42 - "Schema": f06a0da8 + "Schema": 7e1ae995 "Examples": 91f72543 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-2-medium-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ Routerが `GET /v2/models/krea/krea-2-medium-turbo/openapi.json` で提供する 形式: `date-time` + + statusがfailedの場合にのみ設定されます。キャンセル済みのジョブには含まれません。 + + + + ジョブが失敗した理由: content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal、node_app_node_failed。不明なコードはinternalとして扱ってください。 + + + + オプション。provider_errorおよびinternal向けのプロバイダーによる自由形式のテキストです。 + + + + 変更すべきリクエストパラメーター。invalid_requestおよびvalidation_failedの場合に含まれます。 + + 形式: `uuid` diff --git a/ja/development/comfy-router/models/krea/krea-2-medium/code.mdx b/ja/development/comfy-router/models/krea/krea-2-medium/code.mdx index be46d0b7a2..c62ecaaf73 100644 --- a/ja/development/comfy-router/models/krea/krea-2-medium/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-2-medium/code.mdx @@ -2,17 +2,18 @@ title: "Krea 2 Medium を Comfy Router で使用する" description: "Comfy Router 経由で krea/krea-2-medium を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Krea 2 Medium" -translationSourceHash: a7f31b9b +translationSourceHash: 8c847fd4 translationFrom: development/comfy-router/models/krea/krea-2-medium/code.mdx translationBlockHashes: "_intro": d62bc601 "Quick start": 1f018136 - "Schema": 926b5274 + "Schema": 2e249b0f "Examples": 91f72543 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/krea/krea-2-medium.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ Router が `GET /v2/models/krea/krea-2-medium/openapi.json` で提供するス 形式: `date-time`
+ + status が failed の場合にのみ設定されます。キャンセル済みのジョブには含まれません。 + + + + ジョブが失敗した理由: content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal、node_app_node_failed。不明なコードは internal として扱ってください。 + + + + 任意。provider_error および internal の場合におけるプロバイダーからの自由形式のテキスト。 + + + + 変更すべきリクエストパラメータ。invalid_request および validation_failed の場合に含まれます。 + + 形式: `uuid` diff --git a/ja/development/comfy-router/models/krea/krea-2/code.mdx b/ja/development/comfy-router/models/krea/krea-2/code.mdx index 6c9a9c54b7..06c32d533e 100644 --- a/ja/development/comfy-router/models/krea/krea-2/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-2/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Krea 2 を使う" description: "Comfy Router 経由で krea/krea-2 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Krea 2" -translationSourceHash: 12dc5e3a +translationSourceHash: 72216188 translationFrom: development/comfy-router/models/krea/krea-2/code.mdx translationBlockHashes: "_intro": 5d115bf3 "Quick start": 2cc5fba4 - "Schema": 360d2f7e + "Schema": 5a67f0ed "Examples": 91f72543 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ Routerが `GET /v2/models/krea/krea-2/openapi.json` で提供するスキーマ フォーマット: `date-time` + + statusが失敗した場合にのみ設定されます。キャンセル済みのジョブには含まれません。 + + + + ジョブが失敗した理由: content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal、または node_app_node_failed。不明なコードはinternalとして扱ってください。 + + + + 省略可能。provider_error および internal に対するプロバイダーからの自由形式のテキスト。 + + + + 変更すべきリクエストパラメータ。invalid_request および validation_failed の場合に含まれます。 + + フォーマット: `uuid` diff --git a/ja/development/comfy-router/models/krea/krea-3/code.mdx b/ja/development/comfy-router/models/krea/krea-3/code.mdx index 78d8d20395..8dde36b401 100644 --- a/ja/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Krea 3 を使用する" description: "Comfy Router 経由で krea/krea-3 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Krea 3" -translationSourceHash: 56990dce +translationSourceHash: eee80c65 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": c0a0ccaf + "Schema": dbedda04 "Examples": 276619d9 --- + {/* 生成済みファイル。router-schemas/krea/krea-3.json から `pnpm code-pages:gen` で生成済み。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -156,7 +157,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 入力画像の URL。最大8件。画像を POST /proxy/krea/assets にアップロードして返される image_url(multipart フォームのフィールド `file`)は常に受け入れられます。他のパブリックな https URL が受け入れられるかどうかは環境によって異なります。受け入れられない環境では、ホスト app-uploads.krea.ai 上の https URL ではないリンクは 400 で拒否されます。受け入れられる環境では、パブリックな https の画像 URL はすべて受け入れられ、形式が不正な URL や https ではない URL は 400 で拒否されます(ポートが数値であっても範囲外である URL はこのチェックでは捕捉されず、代わりに 502 で失敗する可能性があります)。その場合の正しい形式の https URL については、呼び出し側が修正できる参照はそのホスト名を示して 400 で拒否されます。ホストが解決できない、またはフェッチ前のチェック時に公開到達可能でない、許可された回数を超えてリダイレクトする、https ではない URL や公開到達可能でないホストへリダイレクトする、408 または 429 以外の 4xx を返す、画像ではない、読み取れない形式の画像である、画像サイズヘッダーが最初の 2 MiB 内にない、または宣言された長さがない、しくは chunked エンコーディングのレスポンスが画像サイズヘッダーより前に終了する、といった場合です。それ以外のフェッチ失敗は POST /proxy/krea で 502 エラーになります(Comfy Router はこれを 500 internal_error で返します)。一時的な DNS、TLS、接続の失敗、タイムアウト、オリジンからの 408、429、5xx その他の非 200 ステータス、またはそのチェックを通過したもののフェッチの接続時に解決できない、もしくは公開到達可能でないホストです。他の URL が受け入れられない環境では、実際のアップロードではない app-uploads.krea.ai のリンクは 5xx エラーで失敗します。受け入れられる環境では、他の到達不能な参照と同様に 400 で拒否されます。サーバーがどちらに該当するかをまだ学習していない間は、app-uploads.krea.ai のリンクではないホストを持つ https URL は、公開かどうかに関わらず、再試行しても安全な 503 エラーで失敗します。テキストから画像への生成では省略します。 + 入力画像の URL。最大8件。画像を POST /proxy/krea/assets にアップロードして返される image_url(multipart フォームのフィールド `file`)は常に受け入れられます。他のパブリックな https URL が受け入れられるかどうかは環境によって異なります。受け入れられない環境では、ホスト app-uploads.krea.ai 上の https URL ではないリンクは 400 で拒否されます。受け入れられる環境では、パブリックな https の画像 URL はすべて受け入れられ、形式が不正な URL や https ではない URL は 400 で拒否されます(ポートが数値であっても範囲外である URL はこのチェックでは捕捉されず、代わりに 502 で失敗する可能性があります)。その場合の正しい形式の https URL については、呼び出し側が修正できる参照は、そのホスト名を示して 400 で拒否されます。すなわち、フェッチ前のチェック時にホストが解決できない、または公開到達可能でない、許可された回数を超えてリダイレクトする、https ではない URL や公開到達可能でないホストへリダイレクトする、408 または 429 以外の 4xx を返す、画像ではない、読み取れない形式の画像である、画像サイズヘッダーが最初の 2 MiB 内にない、または宣言された長さも chunked エンコーディングもないレスポンスが画像サイズヘッダーより前に終了する、といった場合です。それ以外のフェッチ失敗は POST /proxy/krea で 502 エラーになります(Comfy Router はこれを 500 internal_error で返します)。一時的な DNS、TLS、接続の失敗、タイムアウト、オリジンからの 408、429、5xx その他の非 200 ステータス、またはそのチェックを通過したもののフェッチの接続時に解決できない、もしくは公開到達可能でないホストです。他の URL が受け入れられない環境では、実際のアップロードではない app-uploads.krea.ai のリンクは 5xx エラーで失敗します。受け入れられる環境では、他の到達不能な参照と同様に 400 で拒否されます。サーバーがどちらに該当するかをまだ学習していない間は、app-uploads.krea.ai のリンクではないホストを持つ https URL は、公開かどうかに関わらず、再試行しても安全な 503 エラーで失敗します。テキストから画像への生成では省略します。 @@ -199,6 +200,22 @@ Router が `GET /v2/models/krea/krea-3/openapi.json` で提供するスキーマ 形式: `date-time` + + status が failed の場合にのみ設定されます。キャンセル済みのジョブには含まれません。 + + + + ジョブが失敗した理由: content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal、node_app_node_failed。不明なコードは internal として扱ってください。 + + + + 任意。provider_error および internal の場合におけるプロバイダーの自由形式のテキスト。 + + + + 変更すべきリクエストパラメーター。invalid_request および validation_failed の場合に含まれます。 + + 形式: `uuid` diff --git a/ja/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx b/ja/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx new file mode 100644 index 0000000000..9452dd2a99 --- /dev/null +++ b/ja/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx @@ -0,0 +1,324 @@ +--- +title: "Comfy Router で MiniMax H3 Image Highspeed を使用する" +description: "Comfy Router 経由で minimax/minimax-h3-image-highspeed を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "MiniMax H3 Image Highspeed" +translationSourceHash: 49584805 +translationFrom: development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx +translationBlockHashes: + "_intro": 3fd3bae8 + "Quick start": e37c76df + "Schema": 5c07b006 + "Examples": b42d5c4e +--- +{/* GENERATED FILE. Generated from router-schemas/minimax/minimax-h3-image-highspeed.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`minimax/minimax-h3-image-highspeed` のAPIリファレンスです。MiniMax から Comfy Router が提供しています。 + +**入力:** テキスト、画像 · **出力:** 画像 + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しています。cURL スニペットは同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `minimax/minimax-h3-image-highspeed` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は冪等性キーを自動的に作成し、自動リトライ時に再利用します。 +with Comfy() as client: + result = client.models.run( + "minimax/minimax-h3-image-highspeed", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は冪等性キーを自動的に作成し、自動リトライ時に再利用します。 +const { data } = await comfy.models.run("minimax/minimax-h3-image-highspeed", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備ができ次第、このプロセスまたは別のプロセスから収集できます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライ時に再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "minimax/minimax-h3-image-highspeed", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスに必要な情報はこれだけです + + # リクエストが完了するまでポーリングし、サーバーが示す Retry-After の秒数だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。 + # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライ時に再利用します。 +const handle = await comfy.models.submit("minimax/minimax-h3-image-highspeed", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 送信します。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。 +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" + +# 2. status が COMPLETED になるまでポーリングし、各レスポンスが示す Retry-After の秒数だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集します。完了時はモデルのネイティブ出力とともに 200、まだ実行中はステータスボディとともに 202 を返します。 +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + `size` が省略された場合、または `auto` の場合の出力エリアレベル。`1K`、`2K`、`4K`(デフォルト)のいずれか。 + + + + `size` が省略された場合、または `auto` の場合の出力アスペクト比。`auto`(デフォルト)、または 1:3 から 3:1 の間の `X:Y`(例: `16:9`)。 + + + + MiniMax のプロンプト拡張をオフにします。固定の `size` または `X:Y` 形式の `aspect_ratio` が必要です。 + + + + オプションの参照画像。指定した場合、リクエストは edits ルートとまったく同じように画像編集として実行されます。 + + + + 公開 http(s) URL、または `data:image/;base64,` URI。JPEG、PNG、WEBP、HEIC、HEIF に対応し、各辺は 128 から 8192 px、長辺は短辺の最大 4 倍までです。 + + + + モデル名。`MiniMax-H3-Image` または `MiniMax-H3-Image-Highspeed`。Router の呼び出し元はこのフィールドを省略するか null を送信できます。Router はリクエストパスで選択されたモデルを補います。 + + + + 画像の数。入力トークンは画像 1 枚ごとに 1 回課金されます。 + + 範囲: `1` から `10` + + + + `jpeg` と `webp` の圧縮品質。デフォルトは 95。 + + 範囲: `0` から `100` + + + + 出力画像の形式。`png`、`jpeg`、`jpg`(デフォルト)、`webp` のいずれか。 + + + + 画像のテキストによる説明。`images` と併用する場合は編集内容の説明であり、参照画像は配列の順序で画像 1、画像 2 となります。 + + + + 出力サイズ。`auto`(デフォルト)、または `2720x1536` のような `WIDTHxHEIGHT`。固定サイズは面積が 655,360 から 20,000,000 ピクセル、アスペクト比が 1:3 から 3:1 の間である必要があり、`aspect_ratio` や `area` と併用できません。 + + +Router が `GET /v2/models/minimax/minimax-h3-image-highspeed/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するのと同じドキュメントです。 + +### 出力 + + + 形式: `int64` + + + + + + + + この画像が失敗したか、または保留された場合にのみ存在します。 + + + + + + + + + + + + この画像に対して MiniMax が使用したプロンプト。 + + + + `WIDTHxHEIGHT` 形式の実際の画像サイズ。 + + + + 生成された画像の URL。有効期限があるため、画像をダウンロードしてください。 + + + + + + + + + + + + 成功した画像のトークン使用量。課金はこれに基づきます。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## 例 + +### 入力 + +```json +{ + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background." +} +``` + +### 出力 + +```json +{ + "created": 1794300000, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/minimax/minimax-h3-image/generated.jpg" + } + ], + "output_format": "jpeg", + "request_id": "06a1b2c3d4e5f60718293a4b5c6d7e8f", + "usage": { + "generated_images": 1, + "input_tokens": 10, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 10 + }, + "output_tokens": 1024, + "output_tokens_details": { + "image_tokens": 1024 + }, + "total_tokens": 1034 + } +} +``` + + diff --git a/ja/development/comfy-router/models/minimax/minimax-h3-image/code.mdx b/ja/development/comfy-router/models/minimax/minimax-h3-image/code.mdx new file mode 100644 index 0000000000..4a06e517ac --- /dev/null +++ b/ja/development/comfy-router/models/minimax/minimax-h3-image/code.mdx @@ -0,0 +1,324 @@ +--- +title: "Comfy Router で MiniMax H3 Image を使用する" +description: "minimax/minimax-h3-image を Comfy Router 経由で呼び出します。エンドポイント、リクエストの形状、および Router が返すレスポンスについて説明します。" +sidebarTitle: "MiniMax H3 Image" +translationSourceHash: 1dbc0ccb +translationFrom: development/comfy-router/models/minimax/minimax-h3-image/code.mdx +translationBlockHashes: + "_intro": 21c027f1 + "Quick start": 122cc9f4 + "Schema": af54b1a6 + "Examples": b42d5c4e +--- +{/* GENERATED FILE. `pnpm code-pages:gen` により router-schemas/minimax/minimax-h3-image.json から生成済みファイルです。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`minimax/minimax-h3-image` の API リファレンスです。Comfy Router が MiniMax から提供しています。 + +**入力:** テキスト、画像 · **出力:** 画像 + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用し、cURL スニペットは同じ呼び出しを生の HTTP で行うものです。 + +**Model ID:** `minimax/minimax-h3-image` + +**Endpoint:** `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数 COMFY_API_KEY を読み取ります。 +# SDK は自動的に idempotency key を作成し、自動リトライ時に再利用します。 +with Comfy() as client: + result = client.models.run( + "minimax/minimax-h3-image", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数 COMFY_API_KEY を読み取ります。 +// SDK は自動的に idempotency key を作成し、自動リトライ時に再利用します。 +const { data } = await comfy.models.run("minimax/minimax-h3-image", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests` に送信します。Router は実行が受け付けられるとすぐに `request_id` とともに `201` を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも取得できます。[キューの配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、取得の流れを順を追って説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数 COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライ時に再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "minimax/minimax-h3-image", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせれば、別プロセスに必要な情報はこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の時間だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 + # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを送出します。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数 COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライ時に再利用します。 +const handle = await comfy.models.submit("minimax/minimax-h3-image", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 送信。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。 +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" + +# 2. status が COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 取得。モデル本来の出力とともに 200、まだ実行中はステータス本文とともに 202 を返します。 +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + `size` を省略した場合、または `auto` の場合の出力面積レベル。`1K`、`2K`、`4K`(デフォルト)のいずれか。 + + + + `size` を省略した場合、または `auto` の場合の出力アスペクト比。`auto`(デフォルト)、または 1:3 から 3:1 の間の `X:Y`(例: `16:9`)。 + + + + MiniMax のプロンプト拡張をオフにします。固定の `size`、または `X:Y` 形式の `aspect_ratio` が必要です。 + + + + 任意の参照画像。指定した場合、リクエストは edits ルートとまったく同じく画像編集として実行されます。 + + + + 公開された http(s) URL、または `data:image/;base64,` URI。JPEG、PNG、WEBP、HEIC、HEIF に対応し、各辺は 128 から 8192 px、長辺は短辺の 4 倍以下である必要があります。 + + + + モデル名。`MiniMax-H3-Image` または `MiniMax-H3-Image-Highspeed`。Router の呼び出し元はこのフィールドを省略するか null を送信できます。その場合 Router はリクエストパスで選択されたモデルを補います。 + + + + 画像の数。入力トークンは画像 1 枚ごとに 1 回課金されます。 + + 範囲: `1` から `10` + + + + `jpeg` と `webp` の圧縮品質。デフォルトは 95。 + + 範囲: `0` から `100` + + + + 出力画像の形式。`png`、`jpeg`、`jpg`(デフォルト)、`webp` のいずれか。 + + + + 画像のテキストによる説明。`images` を指定した場合は編集内容の説明となり、参照画像は配列の順に画像 1、画像 2 として扱われます。 + + + + 出力サイズ。`auto`(デフォルト)、または `2720x1536` のような `WIDTHxHEIGHT`。固定サイズは面積が 655,360 から 20,000,000 ピクセル、アスペクト比が 1:3 から 3:1 の間である必要があり、`aspect_ratio` や `area` と組み合わせることはできません。 + + +`GET /v2/models/minimax/minimax-h3-image/openapi.json` で Router が提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使うドキュメントと同じものです。 + +### 出力 + + + 形式: `int64` + + + + + + + + この画像が失敗したか、保留された場合にのみ存在します。 + + + + + + + + + + + + この画像に対して MiniMax が使用したプロンプト。 + + + + 実際の画像サイズ(`WIDTHxHEIGHT` 形式)。 + + + + 生成された画像の URL。有効期限があるため、画像をダウンロードしてください。 + + + + + + + + + + + + 成功した画像のトークン使用量。課金はこれに基づきます。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## 例 + +### 入力 + +```json +{ + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background." +} +``` + +### 出力 + +```json +{ + "created": 1794300000, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/minimax/minimax-h3-image/generated.jpg" + } + ], + "output_format": "jpeg", + "request_id": "06a1b2c3d4e5f60718293a4b5c6d7e8f", + "usage": { + "generated_images": 1, + "input_tokens": 10, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 10 + }, + "output_tokens": 1024, + "output_tokens_details": { + "image_tokens": 1024 + }, + "total_tokens": 1034 + } +} +``` + + diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index f2bbc30d2e..c724c72780 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router で Grok Imagine Image 2.0 を使用する" description: "Comfy Router 経由で xai/grok-imagine-image-2.0 を呼び出します: endpoint、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: e062dc40 +translationSourceHash: a292528e translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: - "_intro": 614e2e15 + "_intro": 6a561296 "Quick start": ff9945c8 - "Schema": cb29dfae + "Schema": f435c296 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-2.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; `xai/grok-imagine-image-2.0` の API リファレンスです。このモデルは xAI から Comfy Router を通じて提供されます。 -**入力:** テキスト · **出力:** 画像 +**入力:** 画像、テキスト · **出力:** 画像 ## クイックスタート @@ -201,6 +200,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES エンドユーザーを表す一意の識別子。xAI が不正利用の監視と検出に役立てることができます + + xAI エンドポイント用の入力画像オブジェクト + + + + 画像入力のタイプ + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + + + マルチリファレンス編集用の入力画像のリスト。image とは同時に指定できません。複数の画像を提供する場合は、プロンプト内で \、\ などとして参照してください。 + + + + 画像入力のタイプ + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + + + xAI エンドポイント用の入力画像オブジェクト + + + + 画像入力のタイプ + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + Router が `GET /v2/models/xai/grok-imagine-image-2.0/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するのと同じドキュメントです。 ### 出力 diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index 2e9af6d657..8936c46324 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,23 +2,22 @@ title: "Grok Imagine Image Pro を Comfy Router で使用する" description: "Comfy Router 経由で xai/grok-imagine-image-pro を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: f1412f9d +translationSourceHash: 551ab410 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: - "_intro": 0da8910e + "_intro": 17b18ef8 "Quick start": 3a4bd585 - "Schema": 805c771c + "Schema": 618b5e75 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-pro.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; xAI から Comfy Router によって提供される `xai/grok-imagine-image-pro` の API リファレンスです。 -**入力:** テキスト · **出力:** 画像 +**入力:** 画像、テキスト · **出力:** 画像 xAI は [2026 年 5 月 15 日](https://docs.x.ai/developers/migration/may-15-retirement) に `grok-imagine-image-pro` を廃止し、そのリクエストを `grok-imagine-image-quality` にルーティングしました。続いて xAI は 2026 年 11 月 2 日に `grok-imagine-image-quality` を廃止しました。リクエストは現在、`grok-imagine-image-2.0` が低品質で処理します。詳細は [xAI の移行に関するお知らせ](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2) を参照してください。 @@ -188,7 +187,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 画像を返す際のレスポンス形式。url または b64_json を指定できます。Comfy は送信リクエストでこれを `url` に強制変換します。Comfy Router のディスパッチ(`POST /v2/models/xai/{model}`)でも、この `/proxy/` ルートでも同様です。いずれの場合も画像結果は再ホストされた URL として提供されるためです。enum 内の値は受け入れられたうえで無視されます。`url` か `b64_json` を送っても、フィールドを省略しても、結果は同じです。enum 外の値は(続いて説明する、各経路が認識する UNSET 表記を除き)どちらの経路でも強制変換されずに拒否され、異なるのは拒否の形だけです。この `/proxy/` ルートは受信時に `400` を返し、`POST /v2/models/xai/{model}` の Router ディスパッチは、パートナー呼び出しが行われる前に、ここで公開されている enum に対するフィールド単位の `422` を返します。UNSET と見なされる値は経路ごとに異なります。この `/proxy/` ルートでは、フィールドの省略、明示的な `null`、および `""` はいずれも未設定を意味し、受け入れられる値と同様に強制変換されます。Router ディスパッチは公開されている enum を厳密に適用するため、`null` と `""` は他の非メンバー値と同様に非メンバーです。その経路で未設定のままにするには、フィールドを省略してください。 + 画像を返す際のレスポンス形式。url または b64_json を指定できます。Comfy は送信リクエストでこれを `url` に強制変換します。Comfy Router のディスパッチ(`POST /v2/models/xai/{model}`)でも、この `/proxy/` ルートでも同様です。いずれの場合も画像結果は再ホストされた URL として提供されるためです。そのため enum 内の値は受け入れられたうえで無視されます。`url` か `b64_json` を送っても、フィールドを省略しても、結果は同じです。enum 外の値は(続いて説明する、各経路が認識する UNSET 表記を除き)どちらの経路でも強制変換されずに拒否され、異なるのは拒否の形だけです。この `/proxy/` ルートは受信時に `400` を返し、`POST /v2/models/xai/{model}` の Router ディスパッチは、パートナー呼び出しが行われる前に、ここで公開されている enum に対するフィールド単位の `422` を返します。UNSET と見なされる値は経路ごとに異なります。この `/proxy/` ルートでは、フィールドの省略、明示的な `null`、および `""` はいずれも未設定を意味し、受け入れられる値と同様に強制変換されます。Router ディスパッチは公開されている enum を厳密に適用するため、`null` と `""` は他の非メンバー値と同様に非メンバーです。その経路で未設定のままにするには、フィールドを省略してください。 指定可能な値: `url`, `b64_json` @@ -205,6 +204,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES エンドユーザーを表す一意の識別子。xAI が不正利用の監視と検出を行うのに役立ちます + + xAI エンドポイント用の入力画像オブジェクト + + + + 画像入力のタイプ + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + + + マルチリファレンス編集用の入力画像のリスト。image とは排他的です。複数の画像を指定する場合、プロンプト内で \、\ などとして参照します。 + + + + 画像入力のタイプ + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + + + xAI エンドポイント用の入力画像オブジェクト + + + + 画像入力のタイプ + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + Router が `GET /v2/models/xai/grok-imagine-image-pro/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index 73555f7bc7..02eb622108 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router で Grok Imagine Image Quality を使用する" description: "Comfy Router 経由で xai/grok-imagine-image-quality を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて。" sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 2768f32e +translationSourceHash: 1bac2ebc translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: - "_intro": 7220f036 + "_intro": 77db165f "Quick start": 799275b8 - "Schema": e2c96ff6 + "Schema": 052399f6 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-quality.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; `xai/grok-imagine-image-quality` の API リファレンス。xAI から Comfy Router によって提供されています。 -**入力:** テキスト · **出力:** 画像 +**入力:** 画像、テキスト · **出力:** 画像 xAI は 2026 年 11 月 2 日に `grok-imagine-image-quality` を廃止しました。リクエストは現在、`grok-imagine-image-2.0` が低品質で処理します。詳細は [xAI の移行に関するお知らせ](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2) を参照してください。 @@ -205,6 +204,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE エンドユーザーを表す一意の識別子。xAI による監視と不正利用の検出に役立ちます + + xAI エンドポイント用の入力画像オブジェクト + + + + 画像入力の種類 + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + + + マルチリファレンス編集用の入力画像のリスト。image とは同時に使用できません。複数の画像を指定した場合は、プロンプト内で \、\ などとして参照してください。 + + + + 画像入力の種類 + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + + + xAI エンドポイント用の入力画像オブジェクト + + + + 画像入力の種類 + + 指定可能な値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされたデータ URI) + + Router が `GET /v2/models/xai/grok-imagine-image-quality/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 9bb27cb588..3145a0c9b8 100644 --- a/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router で Grok Imagine Image を使う" description: "Comfy Router 経由で xai/grok-imagine-image を呼び出す: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Grok Imagine Image" -translationSourceHash: 2e5c55ad +translationSourceHash: 892f31a7 translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: - "_intro": a2e97c88 + "_intro": 0a2a8c08 "Quick start": a5495331 - "Schema": 171da7d5 + "Schema": f924d818 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; xAI が Comfy Router を通じて提供する `xai/grok-imagine-image` の API リファレンスです。 -**入力:** テキスト · **出力:** 画像 +**入力:** 画像、テキスト · **出力:** 画像 ## クイックスタート @@ -174,7 +173,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します(low、medium、または auto。省略時は xAI のデフォルトで、auto は生成時に low、編集時に medium を使用)。その他のモデルはこれを無視します。 - 指定可能な値: `low`、`medium`、`high`、`auto` + 取り得る値: `low`、`medium`、`high`、`auto` @@ -201,6 +200,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID エンドユーザーを表す一意の識別子。xAI が監視や不正利用の検出に役立てることができます + + xAI エンドポイント向けの入力画像オブジェクト + + + + 画像入力のタイプ + + 取り得る値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされた data URI) + + + + マルチリファレンス編集用の入力画像のリスト。image とは同時に指定できません。複数の画像を指定する場合は、プロンプト内で \、\ などとして参照してください。 + + + + 画像入力のタイプ + + 取り得る値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされた data URI) + + + + xAI エンドポイント向けの入力画像オブジェクト + + + + 画像入力のタイプ + + 取り得る値: `image_url` + + + + 入力画像の URL(公開 URL または base64 エンコードされた data URI) + + Router が `GET /v2/models/xai/grok-imagine-image/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 ### 出力 diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index 4c6db2739e..c93c86a5ec 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API リファレンス" description: "Comfy API 契約から生成済みの、Comfy Router のすべてのエンドポイント、パラメータ、レスポンスボディ、エラーバケット。" sidebarTitle: "API リファレンス" -translationSourceHash: f49adc91 +translationSourceHash: e8d9375f translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 @@ -12,7 +12,7 @@ translationBlockHashes: "Pre-flight cost estimates": 7405db0d "Result assets": 3520a8bf "Per-model input and output schemas": 61c6bde8 - "Schemas": 9738e3aa + "Schemas": 35b5a3bc --- @@ -30,6 +30,7 @@ translationBlockHashes: + {/* 生成済みファイル: 手動で編集しないでください。 @@ -1103,7 +1104,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 ### RouterBilledWorkspace -拒否された呼び出しが課金対象としていたウォレット。`RouterErrorResponse.billed_workspace` 上に現れます。「どのウォレットが空なのか」に答えるものであり、呼び出し元の UI で現在選択済みのワークスペースとは限りません。また、チームメンバーが個人の資格情報を使っている場合、資金のあるチームが開かれていても、ここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と同時にのみ存在します。 +拒否された呼び出しが課金対象としていたウォレット。`RouterErrorResponse.billed_workspace` に含まれます。「どのウォレットが空なのか」に答えるものであり、呼び出し元の UI で現在選択されているワークスペースとは限りません。また、チームメンバーが個人の認証情報を使っている場合、資金のあるチームを開いていても、ここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と同時にのみ存在します。 **フィールド** @@ -1116,23 +1117,23 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - 呼び出しがクラウドのワークスペースではなく、呼び出し元のワークスペース導入以前の Metronome 顧客に課金される場合は `legacy`。その顧客にはワークスペース id がありません。クラウドのワークスペースの場合は存在しません。 + 呼び出しがクラウドのワークスペースではなく、呼び出し元のワークスペース以前の Metronome 顧客に課金される場合は `legacy`。その顧客にはワークスペース id がありません。クラウドのワークスペースの場合は存在しません。 -### RouterChargesOnPolicyRejection +### RouterChargesOnPolicyRejection {#routerchargesonpolicyrejection} -このモデルでコンテンツポリシーによる拒否が課金対象になるかどうか。不明な値は課金対象となる可能性があるものとして扱います。 +コンテンツポリシーによる拒否がこのモデルで課金されるかどうか。不明な値は課金される可能性があるものとして扱ってください。 型: `string` ### RouterCostEstimate -この呼び出しにかかるコストを米ドルで事前に見積もったものです。ディスパッチ前に Comfy の標準リスト価格で価格設定されます。ただし、ベンダーが報告するコストで課金されるモデルの場合は、ベンダーの公開価格リストから価格設定されます。このベンダー報告のケースでは、`source: exact` が返されるのは、オプトインした少数のモデルのみであり、かつ公開価格リストが金額を完全に決定できる場合(価格を左右するすべてのフィールドが明示されているか、金額を変え得ないデフォルトのままである場合)に限られます。それ以外のベンダー報告の見積もりは、リストから完全に決定できるものを含め、すべて `estimated` です。いずれの場合も、実行は完了後にベンダーが報告する金額で課金され、見積もり額がそのまま請求されることはありません。契約料率や顧客固有の料率は反映されません。交渉済みの価格設定があるワークスペースは、リスト価格で見積もられ、契約料率で課金されます。その場合の `source: exact` はリスト価格において正確であることを意味し、そのワークスペースの請求額が正確であることを意味するものではありません。最終的な請求額ではありません。実際に支払うのは、ワークスペースの使用量および請求記録にある確定額です。実行後に報告される `X-Comfy-Credits-Used` は丸められた事後的な数値であり、領収書ではありません。`source` はその数値をどこまで信頼できるかを示します。`exact` は `amount` を持ち、`free` は `amount` が「0」で(このリクエストはレートカード上ゼロと価格設定されています)、`estimated` は `min_amount` と `max_amount` を持ち `amount` を持たず、`unknown` はいずれも持たず `reason` を持ちます。`amount` がないことを無料と解釈してはいけません。価格の固定ではありません。`pricing_as_of` を参照してください。 +この呼び出しにかかるコストを米ドルで事前に見積もったものです。価格はディスパッチ前に、Comfy のスタンダードなリスト価格で算出されます。ベンダーが報告するコストで課金されるモデルの場合は、ベンダーの公開価格表に基づいて算出されます。このベンダー報告のケースでは、`source: exact` が返されるのは、オプトインした少数のモデルに限られ、かつ公開価格表が金額を完全に決定できる場合のみです(価格を左右するすべてのフィールドが明示されているか、金額を変えようのないデフォルトのままである場合)。それ以外のベンダー報告の見積もりはすべて `estimated` となり、価格表で完全に決定できるはずのものも含まれます。いずれの場合も、実行の完了後にはベンダーが報告する金額で課金され、見積もりの数値がそのまま請求されることはありません。契約や顧客固有のレートは反映されません。個別価格を交渉したワークスペースにはリスト価格が見積もられ、契約レートで課金されます。その場合の `source: exact` はリスト価格に対して正確という意味であり、そのワークスペースの請求額が正確という意味ではありません。これは最終的な請求額ではありません。支払うのは、ワークスペースの使用量および請求記録に確定した請求額です。実行後に報告される `X-Comfy-Credits-Used` は事後に丸められた数値であり、領収書ではありません。`source` はその数値をどこまで信頼できるかを示します。`exact` は `amount` を持ちます。`free` は `amount` が "0" です(レートカードがこのリクエストをゼロで価格設定しています)。`estimated` は `min_amount` と `max_amount` を持ち、`amount` は持ちません。`unknown` はどちらも持たず、`reason` を持ちます。`amount` が存在しないことを無料と読み取らないでください。価格のロックではありません。`pricing_as_of` を参照してください。 **フィールド** - `exact` | `estimated` | `free` | `unknown`。これ以外の値は `unknown` として扱ってください。`exact` と `estimated` はいずれも見積もりを表すラベルであり、どちらも最終的な請求額ではありません。`free` はこのリクエストがレートカード上ゼロと価格設定されていることを意味するため、`amount` は「0」です。`unknown` は数値を持ちません。 + `exact` | `estimated` | `free` | `unknown`。これ以外の値は `unknown` として扱ってください。`exact` と `estimated` はいずれも見積もりを示すものであり、どちらも最終的な請求額ではありません。`free` は、レートカードがこのリクエストをゼロで価格設定していることを意味するため、`amount` は "0" です。`unknown` には金額が含まれません。 @@ -1140,100 +1141,100 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - 推定コストをドルで表した10進文字列です(例: "0.04")。最大8桁の小数で、指数表記はありません。課金対象の1セント未満の価格が「0」と表示されることはなく、「0」と表示されるのは `free` の見積もりだけです。`source` が `exact` または `free` の場合にのみ存在します。最終的な請求額ではありません。ワークスペースの使用量および請求記録にある確定額が最終的な請求額です。 + 推定コストをドル建ての10進文字列で表したもの(例: "0.04")。最大8桁の小数部を持ち、指数表記は使用しません。課金対象の1セント未満の価格が "0" として出力されることはなく、"0" になるのは `free` の見積もりのみです。`source` が `exact` または `free` の場合にのみ存在します。最終的な請求額ではありません。最終的な請求額は、ワークスペースの使用量および請求記録に確定した金額です。 - 見積もりの下限をドルで表した10進文字列です。これは見積もりであり、保証された下限ではありません。たとえば、プロバイダーがリクエストより少ない結果を返した場合(画像が0枚など)、見積もりが過去の呼び出しから学習した典型的な価格である場合、または価格がリクエスト量に対して安定的に上昇しない場合には、実際の請求額がこれより少なくなることがあります。`source` が `estimated` の場合にのみ存在します。 + 見積もりの下限をドル建ての10進文字列で表したもの。見積もりであり、保証された下限ではありません。たとえば、プロバイダーがリクエストした量より少ない結果を返した場合(画像が返されない場合など)、見積もりが過去の呼び出しから学習した典型的な価格である場合、価格がリクエストした量に応じて単調に上昇しない場合には、請求額がこれより少なくなることがあります。`source` が `estimated` の場合にのみ存在します。 - 見積もりの上限をドルで表した10進文字列です。これは見積もりであり、保証された上限ではありません。たとえば、プロバイダーが要求より多くの結果を返した場合(要求したより多くの画像など)、見積もりが過去の呼び出しから学習されたものである場合、または価格がリクエスト量に対して安定的に上昇しない場合には、実際の請求額がこれより多くなることがあります。`source` が `estimated` の場合にのみ存在します。 + 見積もりの上限をドル建ての10進文字列で表したもの。見積もりであり、保証された上限ではありません。たとえば、プロバイダーが要求より多い結果を返した場合(要求したより多くの画像が返された場合など)、見積もりが過去の呼び出しから学習されたものである場合、価格がリクエストした量に応じて単調に上昇しない場合には、請求額がこれより多くなることがあります。`source` が `estimated` の場合にのみ存在します。 - 同じ金額を米セントで表した、丸めていない計算用の値です。`amount` とともに存在します。 + 同じ金額を米セント単位で表したもの(未丸め)。計算用です。`amount` と共に存在します。 double - `min_amount` を米セントで表した、丸めていない値です。`min_amount` とともに存在します。 + `min_amount` を米セント単位で表したもの(未丸め)。`min_amount` と共に存在します。 double - `max_amount` を米セントで表した値です。`max_amount` とともに存在します。 + `max_amount` を米セント単位で表したもの。`max_amount` と共に存在します。 double - プラットフォームの換算($1 = 211 クレジット)を用いて `amount` を Comfy クレジットで表し、小数第2位に丸めた値です。`exact` の見積もりに対して `X-Comfy-Credits-Used` が持つと想定される数値です。このヘッダーは丸められた事後的な数値であり、領収書ではありません。ワークスペースの使用量および請求記録にある確定額が最終的な値です。 + プラットフォームの換算($1 = 211 クレジット)を用いて `amount` を Comfy クレジットで表し、小数第2位に丸めたもの。`exact` の見積もりに対して `X-Comfy-Credits-Used` が持つと想定される値です。このヘッダーは事後に丸められた数値であり、領収書ではありません。最終的なのは、ワークスペースの使用量および請求記録に確定した請求額です。 double - この見積もりが対象とするプロバイダーのレッグです。キュー中の送信では、実行されるレッグになります。 + この見積もりが対象とするプロバイダーのレッグ。キュー中の送信では、実行されるレッグになります。 - 正規の Comfy Router モデル ID で、`{provider}/{model}` の形式です。`POST /v2/models/{provider}/{model}` でモデルを指定する値とまったく同じであるため、呼び出し元は他の何かから再導出することなくこれをパスに埋め込めます。その `pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で結合したもので、`maxLength` はそれらの長さの合計にこの区切り文字を加えたものです。 + 正規の Comfy Router モデル ID である `{provider}/{model}`。`POST /v2/models/{provider}/{model}` でモデルを指定する値とまったく同じであるため、呼び出し元は何かから再導出することなくこのパスに埋め込むことができます。その `pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で連結したもので、`maxLength` はそれらの長さの合計に区切り文字を加えたものです。 - 型: [`RouterModelId`](#routermodelid) -- モデル ID(例: `anthropic/claude-opus-4-6`)、最大193文字 + 型: [`RouterModelId`](#routermodelid) -- モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字 - この見積もりの価格設定に使用したレートカードを取得した日時です。見積もりは価格の固定ではありません。実行は、課金が評価される時点で有効な料率で請求され、この時点の料率では請求されません。ベンダーの公開価格リストから取得した `estimated` の見積もり(ベンダーが報告するコストで課金されるモデル)では、代わりにそのリストを読み取った日付を持ちます。課金される数量が公開されたベンダーのスケジュールから予測され、その後レートカードから価格設定される見積もりは、そのスケジュールの読み取り日とカードの取得時刻のうち古い方を持ちます。これは `exact` の回答でも `estimated` の回答でも同様です(ベンダーが報告するクレジットで課金されるモデルは `estimated` のケースです)。レートカードが読み取られなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、常にこの見積もりが回答された日時です。 + この見積もりの価格算出に使用したレートカードを取得した日時。見積もりは価格のロックではありません。実行は、評価時点で有効なレートで課金され、この時点のレートではありません。ベンダーの公開価格表から取得した `estimated` の見積もり(ベンダーが報告するコストで課金されるモデル)では、代わりにその価格表を読み取った日付が入ります。課金対象の数量が公開されたベンダーのスケジュールから予測され、その後レートカードで価格設定される見積もりの場合は、そのスケジュールの読み取り日とカードの取得時刻のうち古い方が入ります(`exact` の回答でも `estimated` の回答でも同様です。ベンダーが報告するクレジットで課金されるモデルは `estimated` のケースです)。レートカードが一切読み取られなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格を算出できない `not_quotable` の呼び出し)は、見積もりに回答した日時になります。 date-time - `source` が `unknown` の場合にのみ表示されます:`not_quotable`(Router は実行前にこの呼び出しの価格を算出できません。価格はプロバイダーが返す内容に依存するか、リクエストボディが課金対象の数量を制限していないためです)、`unpriced_model`(レートカードがこのリクエストの価格を定めていません)、`byok`(キュー中の送信時のみ:実行はあなた自身のプロバイダーキーを使用するため、Comfy はそれに対して何も請求しません)、または `pricing_unavailable`(キュー中の送信時のみ:リクエストが受け付けられたときにレートカードを読み取れませんでした。これは一時的なもので、実行は通常どおり課金されます)。その他の値は `not_quotable` として解釈してください。 + `source` が `unknown` の場合にのみ表示されます:`not_quotable`(Router はこの呼び出しを実行する前に価格を算出できません。価格はプロバイダーが返す内容に依存するか、本文が課金対象の数量を制限していないためです)、`unpriced_model`(レートカードがこのリクエストの価格を設定していません)、`byok`(キュー中の送信のみ:実行ではユーザー自身のプロバイダーキーを使用するため、Comfy はその実行に対して何も請求しません)、または `pricing_unavailable`(キュー中の送信のみ:リクエストの受け付け時にレートカードを読み取れませんでした。これは一時的なもので、実行には通常どおり料金が発生します)。その他の値は `not_quotable` として扱います。 ### RouterErrorResponse -認証、アクセス、モデル検索、クォータ、プロバイダーのトランスポート障害に対するエラーボディです。 +認証、アクセス、モデル検索、クォータ、プロバイダーのトランスポート失敗に対するエラーボディです。 **フィールド** - 失敗の人間が読める説明で、エンドユーザーに提示しても安全です。機械的にパースされるものではありません。代わりに `error_type` で分岐してください。退役したモデルに対する `model_not_found` の場合、`detail` は、後継モデルが記録されていて呼び出し元から参照できるときは ` was retired on ; use `、そうでないときは通常の候補リストの代わりに単に ` was retired on ` となります。ここで示される後継モデルは常に、呼び出しの向き先を変更できる有効なカタログ ID です。提供終了日がまだ未来であるモデルは退役していません。`GET /v2/models` に引き続き掲載され、その日付までは実行可能なままです。`detail` の他の部分と同様、この退役に関する文言は表示用であり、互換性の保証はありません。機械的にパースされないというルールには、文書化された 2 つの例外があります。`POST /v2/models/{provider}/{model}` では、`409` は `invalid_input` バケットを共有する 3 つの無関係な条件に対して返され、それらを区別するのは `detail` だけです。`detail` が "this request's `image` selects the edit operation" で始まる場合はマルチパートの `model_provider` 拒否であり、`detail` が `this request resolved a BYOK credential` で始まる場合は BYOK の `model_provider` 拒否です。どちらも新しい `Idempotency-Key` では解消されません。そのルート上の他の `invalid_input` の `409` はキーの競合です。両方のプレフィックスは安定した契約上の用語であり、マッチングに使用できます。それ以外の場所では、`detail` による分岐に互換性の保証はありません。 + 失敗の人間が読める説明で、エンドユーザーに提示しても安全です。機械解析はされません。代わりに `error_type` で分岐してください。退役したモデルに対する `model_not_found` では、後継モデルが記録されていて呼び出し元から参照できる場合、`detail` は ` was retired on ; use ` となり、そうでない場合は通常の候補リストの代わりに ` was retired on ` だけになります。ここで示される後継モデルは常に、呼び出しの向き先を変更できる有効なカタログ ID です。提供終了日がまだ将来であるモデルは退役していません。`GET /v2/models` に引き続き表示され、その日付までは実行可能なままです。`detail` の他の部分と同様、この退役に関する文言は表示用であり、互換性の保証はありません。機械解析されないというルールには、文書化された 2 つの例外があります。`POST /v2/models/{provider}/{model}` では、`409` が `invalid_input` バケットを共有する 3 つの無関係な条件に対して返され、それらを区別するのは `detail` だけです。`detail` が「this request's `image` selects the edit operation」で始まる場合はマルチパートの `model_provider` 拒否であり、`detail` が `this request resolved a BYOK credential` で始まる場合は BYOK の `model_provider` 拒否です。どちらも新しい `Idempotency-Key` では解消されません。そのルート上の他の `invalid_input` `409` はキーの競合です。どちらの接頭辞も安定した契約用語であり、マッチングしてもかまいません。他のどこでも、`detail` に基づく分岐に互換性の保証はありません。 - Router の失敗を表す粗い機械可読なバケットで、`X-Comfy-Error-Type` レスポンスヘッダーにも反映されるため、呼び出し元はボディをパースせずに分岐できます。この集合は 20 個の値で閉じています。6 つのリクエストレベルのバケット `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits`、`model_not_found` に加え、トランスポートレベルの `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full`、`result_expired` です。「閉じている」とは今日文書化されている集合を指し、永遠に成り立つ上限ではありません。集合は増えることが想定されているため、これは意図的に `enum` ではなく単なる文字列になっています。したがってクライアントは、未知の値を `internal_error` として扱うべきであり、上記のリストを網羅的に switch して次の追加で壊れるべきではありません。 + Router の失敗を表す粗い機械可読なバケットで、`X-Comfy-Error-Type` レスポンスヘッダーにも反映されるため、呼び出し元はボディを解析せずに分岐できます。この集合は 20 個の値で閉じています。6 つのリクエストレベルのバケット `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits`、`model_not_found` に加え、トランスポートレベルの `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full`、`result_expired` です。「閉じている」とは、今日文書化されている時点での集合を説明するものであり、永久に成立する上限ではありません。集合は増えることが想定されているため、これは意図的にプレーンな文字列であり `enum` ではありません。そのためクライアントは、認識できない値を `internal_error` として扱う必要があり、上記のリストを網羅的に switch して次の追加で壊れてはいけません。 - Type: [`RouterErrorType`](#routererrortype) + 型: [`RouterErrorType`](#routererrortype) - モデルプロバイダーがリクエストを拒否した際に示した、範囲を限定してサニタイズした理由で、`error_type` が `invalid_input` かつ `X-Comfy-Upstream-Status` がプロバイダーの `4xx` または `2xx` である場合にのみ存在します。つまり、プロバイダーがリクエストを不正なものとして拒否し、その理由を述べた場合です。通常そのステータスは `4xx` です。成功エンベロープの中で拒否された生成を報告するプロバイダーの場合は `2xx` になります(BytePlus の失敗タスクポーリングは HTTP `200` で、理由はボディに含まれます)。その他のすべての失敗では存在しません。プロバイダーの `5xx`、トランスポート障害、コンテンツポリシーによる拒否、および Router 自身に関するあらゆる拒否が含まれます。`X-Comfy-Upstream-Detail` ヘッダーを反映します。`invalid_input` で終了した実行のキュー中コレクト(`GET /v2/models/{provider}/{model}/requests/{request_id}`)は、最初のコレクト時にこのフィールドに同じ理由を含み、その後リクエストから削除します。後のコレクトは通常、それを含まない同じ `error_type` と `detail` を返すため、最初のコレクトから読み取ってください。この読み取りはいずれのヘッダーも送信しません。 + `invalid_input` 拒否に対する、長さが制限されサニタイズされた理由です。同期ルートでは、モデルプロバイダーが示した理由であり、`error_type` が `invalid_input` で、`X-Comfy-Upstream-Status` がプロバイダーの `4xx` または `2xx` の場合にのみ存在します。つまり、プロバイダーがリクエストを不正な形式として拒否し、その理由を述べた場合です。通常、そのステータスは `4xx` です。成功エンベロープ内で拒否された生成を報告するプロバイダーでは `2xx` になります(BytePlus の失敗タスクポーリングは HTTP `200` で、理由がボディに含まれます)。プロバイダーの `5xx`、トランスポート失敗、コンテンツポリシー拒否、Router 自身に関する拒否を含む他のすべての失敗では存在せず、`X-Comfy-Upstream-Detail` ヘッダーを反映します。`invalid_input` で終了した実行のキュー中のコレクト(`GET /v2/models/{provider}/{model}/requests/{request_id}`)は、最初のコレクトでこのフィールドに同じ理由を含み、その後リクエストから削除されます。後で行うコレクトは通常、それを含まない同じ `error_type` と `detail` を返すため、最初のコレクトから読み取ってください。その読み取りではどちらのヘッダーも送信されません。キュー中のコレクトはまた、Router がリクエストをプロバイダーに送信する前に拒否し、理由を 1 文で述べられる場合、Router 自身の理由にもこのフィールドを使用します。同期ルートではそれを `detail` で返します。個々のフィールドを名指しする拒否には何も含まれません。 - コンテンツポリシーによる拒否がどの入力または出力に関するものだったかを、Router レベルの閉じた語彙で示します。`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio` です。プロバイダーがモダリティを特定しなかった場合、単なる `input` / `output` の値がどちら側かを示します。`error_type` が `content_policy_violation` で、プロバイダーが拒否された対象を機械可読なコードで示した場合にのみ存在し、それ以外では存在しません。プロバイダーのテキストでは決してありません。現在は BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI、Wan の拒否、および MiniMax Router の Nano Banana レグの Gemini 拒否について設定されています。拒否がどちら側に関するものかを示さないプロバイダーでは存在しません。`X-Comfy-Refusal-Subject` ヘッダーを反映します。 + コンテンツポリシー拒否がどの入力または出力に関するものかを示す、Router レベルの閉じた語彙です。`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio`。プロバイダーがモダリティを名指ししなかった場合、裸の `input` / `output` 値がどちら側かを示します。`error_type` が `content_policy_violation` で、プロバイダーが拒否された対象を機械可読コードで名指しした場合にのみ存在し、それ以外では存在しません。プロバイダーのテキストは決して含みません。現在、BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI、Wan の拒否、および MiniMax Router の Nano Banana レッグの Gemini 拒否について名指しされます。拒否がどちら側に関するものかを示さないプロバイダーでは存在しません。`X-Comfy-Refusal-Subject` ヘッダーを反映します。 - パートナーノードの支出拒否に対する Billing のポリシー分岐です。課金対象のウォレットが空の場合は `no_funds`、資金の読み取りがそう示さずに呼び出しが拒否された場合は `unspecified` です。`error_type` が `insufficient_credits` で、デプロイメントがウォレットの情報を報告する場合にのみ存在し、それ以外では存在しません。表示用テキストではなく機械可読なコードです。`detail` を表示し、分岐にはこちらを使用してください。 + パートナーノードの支出拒否に対する Billing のポリシー分岐です。請求対象のウォレットが空の場合は `no_funds`、資金の読み取りがそう示さずに呼び出しが拒否された場合は `unspecified` です。`error_type` が `insufficient_credits` で、デプロイメントがウォレットの事実を報告する場合にのみ存在し、それ以外では存在しません。表示テキストではなく機械可読コードです。`detail` を表示し、これで分岐してください。 - 拒否された呼び出しが課金するはずだったウォレットを、`RouterErrorResponse.billed_workspace` で示します。「どのウォレットが空なのか?」に答えるものであり、呼び出し元の UI で現在選択済みのワークスペースとは限りません。また、チームメンバーの個人クレデンシャルは、資金のあるチームが開いていても、ここではその人の個人ウォレットを示します。`denied_reason` と併せてのみ存在します。 + `RouterErrorResponse.billed_workspace` は、拒否された呼び出しが請求していたはずのウォレットです。「どのウォレットが空か」に答えるものであり、呼び出し元の UI で現在選択されているワークスペースとは限りません。また、資金のあるチームが開かれている間でも、チームメンバーの個人クレデンシャルはここでその個人ウォレットを示します。`denied_reason` と同時にのみ存在します。 - Type: [`RouterBilledWorkspace`](#routerbilledworkspace) + 型: [`RouterBilledWorkspace`](#routerbilledworkspace) - 拒否されたリクエストがどのように認証されたかを示します。`personal_api_key`、`team_api_key`、`personal_session`、`team_session` のいずれかです。「もう一方のウォレットに課金するにはどのクレデンシャルに切り替えればよいか?」に答えるものです。権限ではなく、何も付与しません。`denied_reason` と併せてのみ存在します。 + 拒否されたリクエストがどのように認証されたかを示します: `personal_api_key`、`team_api_key`、`personal_session`、`team_session` のいずれかです。「もう一方のウォレットに請求するには、どの認証情報に切り替えればよいか」に答えます。これは権限ではなく、何も付与しません。`denied_reason` と同時にのみ提示されます。 -### RouterErrorType {#routererrortype} +### RouterErrorType 機械可読な Router エラーカテゴリ。`X-Comfy-Error-Type` ヘッダーでも送信されます。 @@ -1241,51 +1242,51 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 ### RouterModelBilling -モデルを呼び出す前に確認すべき課金動作。価格や使用量は含みません。 +モデルを呼び出す前に確認すべき課金動作。価格や使用量は含まれない。 **フィールド** - このモデルがコンテンツポリシー上の理由で拒否した呼び出しが、それでも呼び出し元に課金されるかどうか。プロバイダーによって異なり、その違いは呼び出し時には見えず、同じ呼び出しに対してエラーと課金の両方を目にしたユーザーには知りようがありません。そのため、プロバイダーごとの言い伝えに任せるのではなく、呼び出し前にモデルごとに明示しています。`yes` の場合、同期ルートの `content_policy_violation` エラーに `X-Comfy-Credits-Used` が付くことがあります。プロバイダーがモデルの生成済み出力を拒否し、Comfy がその拒否された生成について使用量を記録した場合に付き、その量が記載されます。入力側の拒否、同一キーでのリプレイ(`Idempotent-Replayed: true`)、およびヘッダーの小数点以下2桁に現れないほど少額の課金には付きません。ヘッダーのない拒否は報告されるものではなく、無料だった証拠でもありません。 + このモデルがコンテンツポリシーを理由に拒否した呼び出しでも、それでも呼び出し元に課金されるかどうか。プロバイダーによって異なり、その違いは呼び出し時には見えず、同じ呼び出しに対してエラーと課金の両方を目にしたユーザーには知りようがなかった - そのため、プロバイダーごとの俗説に委ねるのではなく、呼び出し前にモデルごとに明記されている。`yes` の場合、同期ルート上の `content_policy_violation` エラーは `X-Comfy-Credits-Used` を伴うことがある。プロバイダーがモデルの生成済み出力を拒否し、Comfy がその拒否された生成の使用量を記録した場合に伴い、その量が示される。入力側の拒否、同一キーのリプレイ(`Idempotent-Replayed: true`)、およびヘッダーの小数点以下2桁に表示されないほど少額の課金は、それを伴わない。ヘッダーなしの拒否は報告されないが、無料だった証拠ではない。 型: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -1つの Comfy Router モデルごとの詳細: カタログ一覧がそのモデルについて報告するすべての情報に加え、単一モデルのルートだけが持つモデルごとのフィールド。 +1つの Comfy Router モデルごとの詳細: カタログ一覧がそのモデルについて報告するすべての内容に加え、単一モデルルートだけが持つモデルごとのフィールド。 -以下を合成します: [`RouterModelListEntry`](#routermodellistentry)、[`RouterModelDetailFields`](#routermodeldetailfields)。 +構成: [`RouterModelListEntry`](#routermodellistentry)、[`RouterModelDetailFields`](#routermodeldetailfields)。 型: `object` ### RouterModelDetailFields -モデル詳細エンドポイントが返す任意フィールド。 +モデル詳細エンドポイントから返される任意のフィールド。 **フィールド** このモデルのOpenAPIドキュメントのURL。入力スキーマと出力スキーマを含みます。 - HTTPS URL(例: `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`)、最大2048文字 + HTTPS URL(例: `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`)。最大2048文字 ### RouterModelId -`POST /v2/models/{provider}/{model}` で使用されるモデル ID。 +`POST /v2/models/{provider}/{model}` で使用するモデルID。 -型: `string`。モデル ID(例: `anthropic/claude-opus-4-6`)。最大 193 文字 +型: `string` -- モデルID(例: `anthropic/claude-opus-4-6`)、最大193文字 ### RouterModelInput -モデル入力オブジェクトです。フィールドと検証については、選択済みモデルのOpenAPIドキュメントを参照してください。 +モデル入力オブジェクト。フィールドと検証については、選択済みモデルの OpenAPI ドキュメントを参照してください。 型: `object` ### RouterModelInputSchemaDocument -1つのモデルの入力と出力のためのスタンドアロンOpenAPIドキュメント。 +1つのモデルの入力と出力をまとめたスタンドアロンの OpenAPI ドキュメントです。 型: `object` @@ -1296,31 +1297,31 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 **フィールド** - Comfy Router の正規モデルID `{provider}/{model}` です。これは `POST /v2/models/{provider}/{model}` でモデルを指定する際の値とまったく同じなので、呼び出し元は他の情報から再導出せずにそのパスへ埋め込めます。`pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で連結したもので、`maxLength` は両者の長さの合計にその区切り文字を加えたものです。 + 正規の Comfy Router モデルID。`{provider}/{model}` 形式で、`POST /v2/models/{provider}/{model}` 上でそのモデルを指定する値とまったく同じです。したがって呼び出し側は、何かから再導出することなくこの値をそのパスに埋め込めます。`pattern` は `RouterProviderSegment` と `RouterModelSegment` を単一の `/` で連結したもので、`maxLength` は両者の長さの合計にその区切り文字を加えたものです。 - 型: [`RouterModelId`](#routermodelid) -- モデルID。例: `anthropic/claude-opus-4-6`、最大193文字 + 型: [`RouterModelId`](#routermodelid) -- モデルID、例: `anthropic/claude-opus-4-6`、最大193文字 - 正規モデルID `{provider}/{model}` の小文字の `provider` セグメントです。対象となるモデルを提供するパートナーを表します。呼び出しルートの `provider` パスパラメータとカタログエントリの `provider` フィールドはどちらもこの単一のスキーマを参照しており、これにより一覧に表示されるIDと受け付けられるIDがずれるのを防いでいます。 + 正規の `{provider}/{model}` モデルIDのうち、小文字の `provider` セグメント。対象のモデルを提供するパートナーを表します。呼び出しルートの `provider` パスパラメータとカタログエントリの `provider` フィールドはどちらもこの同一のスキーマを参照しており、これによって一覧に載るIDと受け付けるIDが食い違わないようになっています。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ。例: `anthropic`、最大64文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ、例: `anthropic`、最大64文字 - 正規モデルID `{provider}/{model}` の小文字の `model` セグメントです。そのプロバイダー内で実行するモデルを表します。呼び出しルートの `model` パスパラメータとカタログエントリの `model` フィールドで共有されており、`RouterProviderSegment` と同じくずれ防止の理由によります。 + 正規の `{provider}/{model}` モデルIDのうち、小文字の `model` セグメント。そのプロバイダー内で実行するモデルを表します。`RouterProviderSegment` と同じく食い違いを防ぐ理由から、呼び出しルートの `model` パスパラメータとカタログエントリの `model` フィールドで共有されています。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ。例: `claude-opus-4-6`、最大128文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ、例: `claude-opus-4-6`、最大128文字 - 呼び出し前に呼び出し元が必要とするモデルごとの課金情報です。価格ではありません。使用量やコストの数値はここには決して表示されません。 + 呼び出し前に呼び出し側が必要とするモデルごとの課金情報であり、価格ではありません。使用量やコストの数値がここに現れることはありません。 型: [`RouterModelBilling`](#routermodelbilling) - このモデルの `GET /v2/models/{provider}/{model}/openapi.json` ドキュメントの現在の強い `ETag` です。スキーマが変更されていない間は、その読み取りで `If-None-Match` として送信すると `304` を取得できます。または、前回確認した値と比較することで、すべてのドキュメントを取得せずに、どのモデルのスキーマが変更されたかを知ることができます。その読み取りがこの呼び出し元に対して現時点で `200` を返さない場合は、常に存在しません。スキーマサービスが利用不可である、モデルのドキュメントをレンダリングできない、またはレスポンスの構築中にモデルがこの呼び出し元にとって利用不可になった場合です。タグが存在しないことはスキーマの変更ではありません。現在のタグを知るには、モデルのドキュメントを再読み取りしてください。 + このモデルの `GET /v2/models/{provider}/{model}/openapi.json` ドキュメントの現在の強い `ETag`。スキーマが変更されていない間に `304` を得るには、その読み取りで `If-None-Match` として送信します。または前回確認した値と比較すれば、すべてのドキュメントを取得することなく、どのモデルのスキーマが変更されたかを知ることができます。この呼び出し元に対してその読み取りが現時点で `200` を返さない場合は存在しません。スキーマサービスが利用不可の場合、モデルのドキュメントをレンダリングできない場合、あるいはレスポンスの構築中にそのモデルがこの呼び出し元にとって利用不可になった場合です。タグが存在しないことはスキーマの変更ではありません。現在のタグを知るには、モデルのドキュメントを再読み取りしてください。 ### RouterModelListResponse @@ -1330,25 +1331,25 @@ Router モデルカタログの 1 ページ分です。 **フィールド** - このページに含まれるモデルで、最大 `limit` 件です。 + このページのモデルで、最大 `limit` 件です。 型: [`RouterModelListEntry`](#routermodellistentry) の配列 - このページより後に別のページが存在するかどうか。これが true の間はページを辿り続けてください。短い、または空の `data` からカタログの終端を推測しないでください。 + このページの先に別のページが存在するかどうか。この値が true の間はページを辿り続けてください。`data` が短い、または空であることからカタログの終端を推測しないでください。 - Router のリストを指す不透明なカーソルです。サーバーが生成し、そのまま往復させることだけを想定しています。オフセットではなく、モデル ID でもなく、順序付けもされておらず、カタログの再構築をまたいで安定もしません。そのため、カーソルを解析する、インクリメントする、あるいは取得元の走査以外で永続化することは、いずれも契約の範囲外です。オフセットではなくカーソルを使うのは、カタログが変化し続けるリストだからです。オフセットによる走査では、走査中にエントリが追加または削除されると、気づかないうちにエントリを飛ばしたり繰り返したりしますが、呼び出し側はそれが起きたことを判別できません。 + Router リストへの不透明なカーソルです。サーバーが生成し、往復させることだけを目的としています。オフセットでもモデル ID でもなく、順序付けもされておらず、カタログの再構築をまたいで安定もしないため、パースすること、インクリメントすること、取得元の走査を超えて永続化することは、いずれも契約の範囲外です。オフセットではなくカーソルを使うのは、カタログが変化し続けるリストだからです。オフセットによる走査では、走査の途中でエントリが追加または削除されると、気付かないうちにエントリがスキップされたり重複したりし、呼び出し元はそれが起きたことを判別できません。 - 型: [`RouterPageCursor`](#routerpagecursor)。`next_cursor` として返される不透明なカーソルで、1–512 文字です。 + 型: [`RouterPageCursor`](#routerpagecursor) -- `next_cursor` として返される不透明なカーソル、1〜512 文字 - 実際に返されたページサイズ。最大値を超える `limit` を要求した場合は、拒否されるのではなく最大値に切り詰められるため、要求した値より小さくなることがあります。ページネーションには送信した値ではなくこの数値を使ってください。そうしないと、実際には受け取っていない行があるものとみなしてしまいます。 + 実際に提供されたページサイズ。最大値を超える `limit` を要求した場合は、拒否されるのではなく最大値に丸められるため、要求した値より小さくなることがあります。送信した数値ではなく、この数値でページネーションしてください。そうしないと、受け取っていない行を前提にしてしまいます。 - 1–100 + 1〜100 ### RouterModelOutput @@ -1359,148 +1360,148 @@ Router モデルカタログの 1 ページ分です。 ### RouterModelSegment -`{provider}/{model}` というモデル ID のうち、モデル部分。 +`{provider}/{model}` モデル ID のうちモデル部分。 型: `string`。英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 ### RouterPageCursor -不透明なカタログカーソル。変更せずにそのまま `cursor` として返してください。 +不透明なカタログカーソルです。`cursor` として変更せずにそのまま返してください。 -Type: `string` -- `next_cursor` として返される不透明なカーソル。1–512 文字 +型: `string` -- `next_cursor` として返される不透明なカーソル、1–512文字 ### RouterProviderSegment `{provider}/{model}` モデル ID のプロバイダー部分。 -型: `string`。英数字のスラッグ(例: `anthropic`)、最大64文字 +型: `string`。英数字のスラッグ(例: `anthropic`)、最大 64 文字 ### RouterQueueCancelResponse -このルートが解決したリクエストを表す2つのステータス(`202` と `409`)に対する、キャンセル要求への応答です。成功エンベロープとエラーエンベロープに分けず、両方で1つのボディ形状を共有します。どちらも同じ内容(キャンセルで何が見つかったか)を表しており、ステータスコードごとに異なる型を解析しなければならないクライアントにとって、分けることに利点はないためです。 +このルートが解決したリクエストを表す2つのステータス、`202` と `409` に対するキャンセル要求への応答です。成功エンベロープとエラーエンベロープに分けず、両方で1つのボディ形状を共有します。どちらも「キャンセルによって何が見つかったか」という同じ内容を表しており、ステータスコードごとに異なる型をパースしなければならないクライアントに分ける利点はないためです。 **フィールド** キュー中の Router リクエスト1件の識別子。呼び出し元がポーリング、キャンセル、結果取得に使用するハンドルです。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大36文字 - このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求で見つかった内容です。どちらも HTTP ステータスに反映されるため、クライアントはどちらで分岐してもかまいません。 + このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求が何を見つけたかを示します。どちらも HTTP ステータスに反映されるため、クライアントはどちらで分岐してもかまいません。 型: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -キャンセル要求で判明した内容です。このルートが実際に解決したリクエストを表す2つの結果について示します。どちらも HTTP ステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。 +このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求で判明した内容を示します。どちらも HTTP ステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。 -型: `string` +Type: `string` ### RouterQueuePosition -レスポンスが構成された時点で、キュー内でこのリクエストより先行しているリクエストの数。0 は、このリクエストが先頭にあることを意味します。 +レスポンスが生成された時点で、このリクエストよりキュー内で先行しているリクエストの数。0 はこのリクエストが先頭であることを意味します。 -型: `integer` -- 0 以上 +型: `integer` -- 最小値 0 ### RouterQueueRequestId -キュー中の Router リクエスト1件の識別子。呼び出し元がポーリング、キャンセル、結果の取得に使用するハンドルです。 +キュー中の Router リクエスト1件の識別子。呼び出し元がポーリング、キャンセル、結果の収集に使用するハンドルです。 -型: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大36文字 +型: `string`、`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 ### RouterQueueStatus -キュー中の Router リクエストの状態です。値はちょうど3つあり、`RouterErrorType` と異なり、こちらは閉じた `enum` です。これは、2つのスキーマが意図的に逆方向に閉じられているためです。`RouterErrorType` は失敗を分類し、その集合は拡大することが想定されているため、認識できないバケットを厳格に拒否する生成済みクライアントは、すでに何かが問題を起こしているまさにそのときに最も深刻に失敗することになります。こちらはライフサイクルであり、後で4番目の状態が追加されたライフサイクルは、enum として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更になります。そのため enum として宣言され、制約はクライアントから見える場所に明記されています。 +キュー中の Router リクエストの状態。正確に3つの値を持ち、`RouterErrorType` とは異なり、これは閉じた `enum` です。なぜなら、2つのスキーマは意図的に逆方向に閉じられているからです。`RouterErrorType` は失敗を分類し、その集合は増えることが想定されています。そのため、認識されないバケットを厳密に拒否する生成済みクライアントは、何かがすでにうまくいかなかったときに最も失敗しやすくなります。これはライフサイクルであり、後で4番目の状態が追加されたライフサイクルは、`enum` として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更です。そのため、`enum` として宣言され、制約はクライアントが見える場所に記述されています。 型: `string` ### RouterQueueStatusFields -`RouterQueueStatusResponse` のうち URL ブロック以外の半分です。キュー中の 1 リクエストの識別子、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す粗い分類を含みます。 +`RouterQueueStatusResponse` のうち URL ブロックではない半分です。キュー中の 1 リクエストの識別子、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、理由を示す大まかな分類を表します。 **フィールド** - キュー中の Router リクエスト 1 件の識別子。呼び出し元がポーリング、キャンセル、結果の取得に使うハンドルです。 + キュー中の Router リクエスト 1 件の識別子。呼び出し側がポーリング、キャンセル、結果取得に使うハンドルです。 Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 - キュー中の Router リクエストの状態です。値はちょうど 3 つで、`RouterErrorType` と違い、こちらは閉じた `enum` です。2 つのスキーマは意図的に逆方向へ閉じられているからです。`RouterErrorType` は失敗を分類するもので、その集合は増えていくことが想定されているため、未知の分類をハードに拒否する生成クライアントは、まさに何かがすでに失敗したときに最も激しく失敗することになります。こちらはライフサイクルであり、後から 4 つ目の状態を追加するライフサイクルは、enum として宣言されているかどうかに関わらず、それに対して書かれたすべてのポーリングループにとって破壊的変更になります。だからこそこれは enum として宣言され、その制約はクライアントが見える場所に明記されています。 + キュー中の Router リクエストの状態です。値はちょうど 3 つしかなく、`RouterErrorType` とは異なりこれは閉じた `enum` です。2 つのスキーマは意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えることが想定されているため、未知の分類を厳格に拒否する生成済みクライアントは、すでに何かが失敗したまさにそのときに最も激しく失敗することになります。一方こちらはライフサイクルであり、後から 4 つ目の状態を追加するライフサイクルは、enum として宣言されているかどうかに関わらず、それに対応して書かれたすべてのポーリングループにとって破壊的変更になります。だからこそ enum として宣言し、その制約はクライアントから見える場所で明示しています。 Type: [`RouterQueueStatus`](#routerqueuestatus) - レスポンスが構成された時点で、キューのうちこのリクエストより前に何件のリクエストがあるか。0 はこのリクエストが先頭であることを意味します。 + レスポンスが構成された瞬間に、このリクエストより前にキュー内にあるリクエストの数です。0 はこのリクエストが先頭であることを意味します。 Type: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 - 成功しなかった `COMPLETED` リクエストにのみ存在し、結果の読み取りがその失敗を返すときに `X-Comfy-Error-Type` に載せるのと同じ粗い分類を持ちます。これが、成功したターミナルリクエストと、失敗またはキャンセル済みのリクエストを区別するものです(どちらにも別個のターミナルステータスはありません)。また成功時には null ではなく存在しないため、その有無で分岐してください。 + 成功しなかった `COMPLETED` リクエストにのみ存在し、その失敗を返すときに結果読み取りが `X-Comfy-Error-Type` に設定するのと同じ大まかな分類を保持します。これにより、成功したターミナルリクエストと、失敗またはキャンセル済みのリクエストを区別できます。どちらにも別個のターミナルステータスは存在しません。また、成功時には null ではなく存在しないため、その有無で分岐してください。 Type: [`RouterErrorType`](#routererrortype) ### RouterQueueStatusResponse -キュー中の1つのリクエストの現在の状態であり、送信時に返されたものと同じ3つのURLを組み合わせたものです。 +キュー中のリクエスト1件の現在の状態を、送信時に返されたものと同じ3つのURLと組み合わせたものです。 -[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueStatusFields`](#routerqueuestatusfields)を組み合わせます。 +[`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueStatusFields`](#routerqueuestatusfields)を組み合わせています。 -型: `object` +Type: `object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse` のうち URL ブロックではない半分です。新しいリクエストの識別情報と、受け付けられた瞬間のその状態を表します。 +`RouterQueueSubmitResponse` のうち URL ブロックではない半分、つまり新しいリクエストの識別情報と、受け付けられた瞬間のその状態です。 **フィールド** - キュー中の Router リクエスト 1 件の識別子。呼び出し元がポーリング、キャンセル、結果取得に使うハンドルです。 + キュー中の Router リクエスト 1 件の識別子。呼び出し側がポーリング、キャンセル、結果取得に使うハンドルです。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 + Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 - キュー中の Router リクエストの状態です。値はちょうど 3 つで、`RouterErrorType` と違いこちらは閉じた `enum` です。2 つのスキーマは意図的に逆方向へ閉じているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えることが想定されるため、未知のバケットを厳格に拒否する生成済みクライアントは、何かがすでにうまくいっていないまさにその時に最も激しく失敗することになります。こちらはライフサイクルであり、後から 4 つ目の状態を追加するライフサイクルは、enum として宣言されているかどうかにかかわらず、それに対して書かれたすべてのポーリングループにとって破壊的変更となります。だからこそ enum として宣言され、その制約はクライアントが確認できる場所に明記されています。 + キュー中の Router リクエストの状態です。値はちょうど 3 つで、`RouterErrorType` と異なりこちらは閉じた `enum` です。これは 2 つのスキーマが意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えることが想定されています。そのため、未知のバケットを厳格に拒否する生成済みクライアントは、まさに何かがすでに失敗したときに最も困ることになります。こちらはライフサイクルであり、後で 4 つ目の状態が追加されるようなライフサイクルは、enum として宣言されているかどうかに関わらず、それに合わせて書かれたすべてのポーリングループにとって破壊的変更になります。そのため enum として宣言し、制約はクライアントから見える場所に明示しています。 - 型: [`RouterQueueStatus`](#routerqueuestatus) + Type: [`RouterQueueStatus`](#routerqueuestatus) - レスポンスが組み立てられた時点で、このリクエストよりキューの先頭側に何件あるか。0 はこのリクエストが先頭であることを意味します。 + レスポンスが構成された時点で、このリクエストよりキューの先頭側に何件のリクエストがあるかを示します。0 はこのリクエストが先頭であることを意味します。 - 型: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 + Type: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 - このリクエストの事前コスト見積もりで、呼び出し元に対してコスト見積もりが有効な場合、新規受け付け時に含まれます。このリクエストがピン留めされたプロバイダーレッグを提示します(キューにはフォールバックループがないため、`fallback_provider` が実行されるレッグを変えることはありません)。数値を出せない場合でも `source: unknown` として存在します。見積もりのせいで送信が失敗することはありません。冪等なリプレイ(`Idempotent-Replayed: true`)では、オリジナルの見積もりが保存されていないため省略されます。これは見積もりであり、最終的な請求額でも価格の固定でもありません。実行はレーティング時点で有効なレートで課金され、ワークスペースの使用量と請求記録にある確定済みの請求額が最終です。 + このリクエストの事前コスト見積もりです。呼び出し元に対してコスト見積もりが有効な場合、新規受け付け時に含まれます。これはこのリクエストがピン留めされたプロバイダー区間を示します(キューにはフォールバックループがないため、`fallback_provider` が実際に実行される区間を変えることはありません)。数値を示せない場合でも `source: unknown` として存在します。見積もりが原因で送信が失敗することはありません。冪等なリプレイ(`Idempotent-Replayed: true`)では省略されます。オリジナルの見積もりは保存されないためです。これは見積もりであり、最終的な請求額でも価格の固定でもありません。実行はレーティング時点で有効な料金で課金され、ワークスペースの使用量および請求記録における確定した請求額が最終となります。 - 型: [`RouterCostEstimate`](#routercostestimate) + Type: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -実行がキューに受け入れられたときに返されるハンドル。リクエストの識別情報と状態を、その残りのライフサイクルを扱う3つのURLと組み合わせたものです。 +実行がキューに受け入れられたときに返されるハンドル。リクエストの識別情報と状態を、そのライフタイムの残りを扱う3つのURLと組み合わせたものです。 -[`RouterQueueUrls`](#routerqueueurls) と [`RouterQueueSubmitFields`](#routerqueuesubmitfields) を組み合わせます。 +[`RouterQueueUrls`](#routerqueueurls)と[`RouterQueueSubmitFields`](#routerqueuesubmitfields)を合成します。 -Type: `object` +型: `object` ### RouterQueueUrls -キュー中の1つのリクエストの残りのライフタイムに対応する3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューのURLを自身で組み立てることはありません。 +キュー中の1つのリクエストの残りのライフタイムを扱う3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューURLを自分で組み立てることはありません。 **フィールド** - このリクエストのステータスを読み取るための絶対URL。 + このリクエストのステータス読み取りの絶対URL。 URI @@ -1519,7 +1520,7 @@ Type: `object` ### RouterValidationErrorContext -検証に失敗したルールについて、プロバイダーが提供する詳細情報。 +検証ルールが失敗した理由について、プロバイダーから提供される詳細。 型: `object` @@ -1530,41 +1531,41 @@ Type: `object` **フィールド** - 問題のあるフィールドへのパス。最も外側のセグメントが先頭になります。たとえば `["body", "image_url"]`、あるいは整数で配列内のインデックスを指す `["body", "images", 0]` のような形式です。 + 問題のあるフィールドへのパス。最も外側のセグメントが先頭になります。たとえば `["body", "image_url"]`、または `["body", "images", 0]` のように、整数は配列のインデックスを指します。 - この 1 件の失敗についての、人間が読める形式の説明。 + この 1 件の失敗について、人間が読める形で説明したもの。 - この失敗の具体的で機械可読な理由で、プロバイダーから変更されずにそのまま渡されます。型付き SDK の例外階層が分岐に使う値であり、レスポンスヘッダーの `error_type` はその大まかな分類にすぎません。 + この失敗の具体的で機械可読な理由。プロバイダーからそのまま変更されずに渡されます。型付き SDK の例外階層が分岐に使う値はこれであり、レスポンスヘッダーの `error_type` はその大まかな分類にすぎません。 - 1 つの `RouterValidationErrorDetail` において違反した境界値で、プロバイダーからそのまま引き継がれます。たとえば `greater_than` とともに `{"limit_value": 8}`、`image_too_small` とともに `{"min_width": 512}`、`file_too_large` とともに `{"max_size_bytes": 10485760}` のようになります。キー集合はプロバイダーとエラータイプに固有であるため、これは意図的にオープンなオブジェクトとしています。固定のフィールド一覧に絞り込んだり、`msg` 文字列に折り畳んだりすると、移植した統合がコンパイルは通るものの、境界値を読んでいた分岐を黙って失うことになります。エラータイプが境界値を持たない場合は存在しません。 + 1 つの `RouterValidationErrorDetail` に対して違反した境界値で、プロバイダーからそのまま渡されます。たとえば `greater_than` と一緒に `{"limit_value": 8}`、`image_too_small` と一緒に `{"min_width": 512}`、`file_too_large` と一緒に `{"max_size_bytes": 10485760}` といった形です。キーの集合はプロバイダーとエラータイプに固有であるため、これは意図的にオープンなオブジェクトとしています。固定のフィールドリストに絞り込んだり、`msg` 文字列に折り畳んだりすることこそが、移植したインテグレーションがコンパイルは通るのに、境界値を読んでいた分岐を黙って失う原因そのものです。エラータイプに境界値が伴わない場合、このフィールドは存在しません。 型: [`RouterValidationErrorContext`](#routervalidationerrorcontext) - 問題のある入力値で、呼び出し元が `loc` から再導出することなく何が拒否されたかを確認できるよう、そのままの形で返されます。文字列、数値、ブール、配列、オブジェクト、null のいずれの JSON 型でもよいため、このスキーマはオブジェクトに絞り込まず、意図的に型なしのままにしています。プロバイダーが入力をそのまま返さない場合は存在しません。 + 問題のある入力値。呼び出し元が `loc` から再導出しなくても何が拒否されたかを確認できるよう、そのまま返されます。文字列、数値、ブール、配列、オブジェクト、null のいずれの JSON 型でもよいため、このスキーマはオブジェクトに絞り込まず、意図的に型なしのままにしています。プロバイダーが入力をそのまま返さない場合、このフィールドは存在しません。 型: [`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -プロバイダーが値を含める場合の、拒否された入力値です。 +プロバイダーが含めている場合の、拒否された入力値です。 ### RouterValidationErrorResponse -`422` 検証エラーのレスポンスボディです。カテゴリは `X-Comfy-Error-Type` を参照してください。 +`422` 検証エラーのレスポンスボディです。カテゴリについては `X-Comfy-Error-Type` を参照してください。 **フィールド** - リクエストで検出されたすべての検証失敗。問題のあるフィールドごとに1エントリです。 + リクエストで見つかったすべての検証失敗。問題のあるフィールドごとに1つのエントリです。 型: [`RouterValidationErrorDetail`](#routervalidationerrordetail) の配列 diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index 7312b17db1..b83ca623ad 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 기능과 한계" sidebarTitle: "기능과 한계" description: "Comfy Router 또는 파트너 프록시 선택, 장시간 실행되는 호출 대비, 복구, 속도 제한 및 자산 저장에 대해 설명합니다." -translationSourceHash: fbb54868 +translationSourceHash: a81b3bd9 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": cca3ca82 + "Models without a pre-flight estimate": e7d7524a "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -30,6 +30,7 @@ translationBlockHashes: + Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나, 제출한 뒤 나중에 수집하는 대기 중 요청을 통해 실행합니다. 애플리케이션이 완료된 결과를 기다리거나 나중에 결과를 수집할 수 있고, 모델 자체의 입력 및 출력 필드를 처리할 수 있는 경우에 사용하십시오. ## Router가 지원하는 기능 @@ -123,7 +124,7 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` -- **minimax**: `minimax/minimax-gpt-image-2` +- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index 78ca91f08c..94ded37eca 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router 모델" sidebarTitle: "모든 모델" description: "Comfy Router에서 사용할 수 있는 모든 모델을 제공자별로 정리하고, 각 모델의 입력 및 출력 모달리티를 함께 표시합니다." -translationSourceHash: 04ecf050 +translationSourceHash: df7e65a1 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 2dfd8d42 + "Find by output": 4d100975 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -26,7 +26,7 @@ translationBlockHashes: "Luma": 8cd2a7ce "Luma 2": 585eb637 "Meshy": 67e26a17 - "MiniMax": 87560ab7 + "MiniMax": 63f02c44 "Moonvalley": 9e63fb77 "OpenAI": 8652024f "Openrouter": a4f6806b @@ -42,13 +42,14 @@ translationBlockHashes: "Veo": 4ccdb46f "Wan": e4d5aff5 "WaveSpeed": be89e7f0 - "xAI": e1706271 + "xAI": 38a131b8 --- + {/* GENERATED FILE. Generated from the Router catalog by `pnpm code-pages:gen`. */} 아래의 모든 모델은 동일한 라우트인 `POST /v2/models/{provider}/{model}`를 통해 제공되며, 각 모델 고유의 JSON 본문을 사용합니다. 각 페이지에는 Python, TypeScript, cURL로 작성된 실제 동작하는 요청 예시가 있습니다. 검색, 스키마, 오류, 재시도, 청구에 대해서는 [Comfy Router API 사용하기](/ko/development/comfy-router/api)를 참고하세요. @@ -65,7 +66,7 @@ translationBlockHashes: - [FLUX 비디오 업스케일](/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code): `bfl/video-upscale-v1` - [비디오 편집 V1](/ko/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1` - [비디오 편집 지우기](/ko/development/comfy-router/models/bria/video-edit-erase/code): `bria/video-edit-erase` -- [비디오 편집 초록색 스크린](/ko/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` +- [비디오 편집 그린 스크린](/ko/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` - [비디오 편집 배경 제거](/ko/development/comfy-router/models/bria/video-edit-remove-background/code): `bria/video-edit-remove-background` - [비디오 편집 배경 교체](/ko/development/comfy-router/models/bria/video-edit-replace-background/code): `bria/video-edit-replace-background` - [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` @@ -80,7 +81,7 @@ translationBlockHashes: - [H3 Max Turbo](/ko/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo` - [H3 Max](/ko/development/comfy-router/models/fal/h3-max/code): `fal/h3-max` - [Gemini Omni 1.2 Flash](/ko/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code): `gemini-interactions/gemini-omni-1.2-flash` -- [Higgsfield Genjutsu 모션 트랜스퍼 V1.0](/ko/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` +- [Higgsfield Genjutsu 모션 전송 V1.0](/ko/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` - [Higgsfield Kling 3.4k](/ko/development/comfy-router/models/higgsfield/higgsfield-kling-3-4k/code): `higgsfield/higgsfield-kling-3-4k` - [Higgsfield Kling 3 Pro](/ko/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` - [Kling 3.0 Turbo](/ko/development/comfy-router/models/kling/kling-3-0-turbo/code): `kling/kling-3.0-turbo` @@ -90,8 +91,8 @@ translationBlockHashes: - [Kling V3 Omni](/ko/development/comfy-router/models/kling/kling-v3-omni/code): `kling/kling-v3-omni` - [Kling V3](/ko/development/comfy-router/models/kling/kling-v3/code): `kling/kling-v3` - [Kling 비디오 O1](/ko/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1` -- [비디오 아바타 이미지 2비디오](/ko/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` -- [비디오 립싱크](/ko/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` +- [비디오 아바타 이미지 2video](/ko/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` +- [비디오 립 싱크](/ko/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` - [LTX 2.5 Fast](/ko/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ko/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/ko/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` @@ -109,70 +110,72 @@ translationBlockHashes: - [Aleph 2](/ko/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/ko/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ko/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` -- [클린 오디오 비디오](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` -- [Video Background Removal Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` -- [Video Background Removal Green Screen](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` -- [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` -- [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` -- [Veo 3.1 Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` -- [Veo 3.1 Lite Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` +- [오디오 비디오 정리](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` +- [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` + + + +- [립싱크 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [비디오 배경 제거 Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` +- [비디오 배경 제거 초록색 스크린](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` +- [비디오 배경 제거](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` +- [Veo 3.1 Fast 생성 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` +- [Veo 3.1 생성 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` +- [Veo 3.1 Lite 생성 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` - [HappyHorse 1.0 R2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code): `wan/happyhorse-1.0-r2v` - [HappyHorse 1.0 T2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code): `wan/happyhorse-1.0-t2v` -- [HappyHorse 1.0 Video Edit](/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code): `wan/happyhorse-1.0-video-edit` +- [HappyHorse 1.0 비디오 편집](/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code): `wan/happyhorse-1.0-video-edit` - [HappyHorse 1.1 I2V](/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code): `wan/happyhorse-1.1-i2v` - [HappyHorse 1.1 R2V](/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code): `wan/happyhorse-1.1-r2v` - [HappyHorse 1.1 T2V](/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code): `wan/happyhorse-1.1-t2v` -- [Wan 2.5 I2V Preview](/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code): `wan/wan2.5-i2v-preview` -- [Wan 2.5 T2V Preview](/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` +- [Wan 2.5 I2V 미리보기](/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code): `wan/wan2.5-i2v-preview` +- [Wan 2.5 T2V 미리보기](/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/ko/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/ko/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` - [Wan 2.6 T2V](/ko/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` - [Wan 2.7 I2V](/ko/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 R2V](/ko/development/comfy-router/models/wan/wan2-7-r2v/code): `wan/wan2.7-r2v` - [Wan 2.7 T2V](/ko/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` -- [Wan 2.7 Video Edit](/ko/development/comfy-router/models/wan/wan2-7-videoedit/code): `wan/wan2.7-videoedit` -- [Wan 3.0 Video Prime](/ko/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` -- [Wan 3.0 Video](/ko/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` +- [Wan 2.7 비디오 편집](/ko/development/comfy-router/models/wan/wan2-7-videoedit/code): `wan/wan2.7-videoedit` +- [Wan 3.0 비디오 Prime](/ko/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` +- [Wan 3.0 비디오](/ko/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - [Flashvsr](/ko/development/comfy-router/models/wavespeed/flashvsr/code): `wavespeed/flashvsr` -- [Grok Imagine Video 1.5 Lite](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code): `xai/grok-imagine-video-1.5-lite` -- [Grok Imagine Video 1.5 Preview](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code): `xai/grok-imagine-video-1.5-preview` -- [Grok Imagine Video 1.5](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5/code): `xai/grok-imagine-video-1.5` -- [Grok Imagine Video](/ko/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` +- [Grok Imagine 비디오 1.5 Lite](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code): `xai/grok-imagine-video-1.5-lite` +- [Grok Imagine 비디오 1.5 미리보기](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code): `xai/grok-imagine-video-1.5-preview` +- [Grok Imagine 비디오 1.5](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5/code): `xai/grok-imagine-video-1.5` +- [Grok Imagine 비디오](/ko/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` -- [Erase V1](/ko/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` -- [Flux 1.1 Pro Ultra Image](/ko/development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code): `bfl/flux-pro-1.1-ultra` +- [지우기 V1](/ko/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` +- [FLUX 1.1 Pro Ultra 이미지](/ko/development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code): `bfl/flux-pro-1.1-ultra` - [FLUX.1 Kontext](/ko/development/comfy-router/models/black-forest-labs/flux-1-kontext/code): `bfl/flux-kontext-pro` - [FLUX 2 Max](/ko/development/comfy-router/models/black-forest-labs/flux-2-max/code): `bfl/flux-2-max` - [FLUX 2 Pro](/ko/development/comfy-router/models/black-forest-labs/flux-2-pro/code): `bfl/flux-2-pro` -- [FLUX 3 Image](/ko/development/comfy-router/models/black-forest-labs/flux-3-image/code): `bfl/flux-3-image` -- [FLUX Pro 1.0 Expand](/ko/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code): `bfl/flux-pro-1.0-expand` -- [FLUX Pro 1.0 Fill](/ko/development/comfy-router/models/black-forest-labs/flux-pro-1-0-fill/code): `bfl/flux-pro-1.0-fill` +- [FLUX 3 이미지](/ko/development/comfy-router/models/black-forest-labs/flux-3-image/code): `bfl/flux-3-image` +- [FLUX Pro 1.0 확장](/ko/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code): `bfl/flux-pro-1.0-expand` +- [FLUX Pro 1.0 채우기](/ko/development/comfy-router/models/black-forest-labs/flux-pro-1-0-fill/code): `bfl/flux-pro-1.0-fill` - [VTO V1](/ko/development/comfy-router/models/black-forest-labs/vto-v1/code): `bfl/vto-v1` - [Fibo](/ko/development/comfy-router/models/bria/fibo/code): `bria/fibo` -- [Image Edit Add Object By Text](/ko/development/comfy-router/models/bria/image-edit-add-object-by-text/code): `bria/image-edit-add-object-by-text` -- [Image Edit Erase By Text](/ko/development/comfy-router/models/bria/image-edit-erase-by-text/code): `bria/image-edit-erase-by-text` -- [Image Edit Erase Foreground](/ko/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` -- [Image Edit Erase](/ko/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` -- [Image Edit Expand](/ko/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` -- [Image Edit Gen Fill](/ko/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` -- [Image Edit Increase Resolution](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` -- [Image Edit Product Holding](/ko/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` -- [Image Edit Product Virtual Tryon](/ko/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` -- [이미지 편집 배경 제거 가이드](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` -- [이미지 편집 배경 제거](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` -- [이미지 편집 배경 교체](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [이미지 편집 텍스트로 객체 교체](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [이미지 편집 Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` -- [이미지 편집 복원](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` -- [이미지](/ko/development/comfy-router/models/bria/image/code): `bria/image` +- [이미지 편집 텍스트로 오브젝트 추가](/ko/development/comfy-router/models/bria/image-edit-add-object-by-text/code): `bria/image-edit-add-object-by-text` +- [이미지 편집 텍스트로 지우기](/ko/development/comfy-router/models/bria/image-edit-erase-by-text/code): `bria/image-edit-erase-by-text` +- [이미지 편집 전경 지우기](/ko/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` +- [이미지 편집 지우기](/ko/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` +- [이미지 편집 확장](/ko/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` +- [이미지 편집 생성 채우기](/ko/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` +- [이미지 편집 해상도 높이기](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` +- [이미지 편집 제품 들기](/ko/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` +- [이미지 편집 제품 가상 착용](/ko/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` +- [이미지 편집 Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Remove Background](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` +- [Image Edit Replace Background](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` +- [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` +- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Restore](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` +- [Image](/ko/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` - [Seedream 4.5 251128](/ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code): `byteplus/seedream-4-5-251128` - [Seedream 5.0 260128](/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code): `byteplus/seedream-5-0-260128` @@ -206,6 +209,8 @@ translationBlockHashes: - [Uni 1](/ko/development/comfy-router/models/luma_2/uni-1/code): `luma_2/uni-1` - [Photon 1](/ko/development/comfy-router/models/luma/photon-1/code): `luma/photon-1` - [Photon Flash 1](/ko/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1` +- [MiniMax H3 Image Highspeed](/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code): `minimax/minimax-h3-image-highspeed` +- [MiniMax H3 Image](/ko/development/comfy-router/models/minimax/minimax-h3-image/code): `minimax/minimax-h3-image` - [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` @@ -214,8 +219,7 @@ translationBlockHashes: - [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Qwen Image 3.0 Pro](/ko/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/ko/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` -- [Recraft V2](/ko/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` -- [Recraft V3](/ko/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` +- [Recraft V2](/ko/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2`- [Recraft V3](/ko/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` - [Recraft V4.1 Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` - [Recraft V4.1 Pro](/ko/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` @@ -267,14 +271,13 @@ translationBlockHashes: - [FLUX 3 Video](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128`- [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` -- [Seed Audio 1.0 Multilingual](/ko/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` +- [Seed Audio 1.0 다국어](/ko/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/ko/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` - [Seedance 1.5 Pro 251215](/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` -- [Eleven Multilingual V2](/ko/development/comfy-router/models/elevenlabs/eleven-multilingual-v2/code): `elevenlabs/eleven_multilingual_v2` +- [Eleven 다국어 V2](/ko/development/comfy-router/models/elevenlabs/eleven-multilingual-v2/code): `elevenlabs/eleven_multilingual_v2` - [Eleven Sfx V2](/ko/development/comfy-router/models/elevenlabs/eleven-sfx-v2/code): `elevenlabs/eleven_sfx_v2` - [Eleven V3](/ko/development/comfy-router/models/elevenlabs/eleven-v3/code): `elevenlabs/eleven_v3` - [Eleven V4 Turbo](/ko/development/comfy-router/models/elevenlabs/eleven-v4-turbo/code): `elevenlabs/eleven_v4_turbo` @@ -290,17 +293,17 @@ translationBlockHashes: - [LTX 2.5 Fast](/ko/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ko/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [MiniMax H3](/ko/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` -- [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` -- [Pika H3 Flex Reference To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` -- [Pika H3 Flex Text To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` +- [Pika H3 Flex 이미지 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` +- [Pika H3 Flex 레퍼런스 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` +- [Pika H3 Flex 텍스트 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika Music](/ko/development/comfy-router/models/pika/pika-music/code): `pika/pika-music` - [Pika Sfx](/ko/development/comfy-router/models/pika/pika-sfx/code): `pika/pika-sfx` - [Pika Soundtrack](/ko/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` - [P Video 2](/ko/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` -- [Clean Audio Video](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Clean Audio](/ko/development/comfy-router/models/veed/clean-audio/code): `veed/clean-audio` +- [오디오 비디오 정리](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` +- [오디오 정리](/ko/development/comfy-router/models/veed/clean-audio/code): `veed/clean-audio` - [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [립싱크 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` @@ -317,16 +320,15 @@ translationBlockHashes: -- [Animations](/ko/development/comfy-router/models/meshy/animations/code): `meshy/animations` +- [애니메이션](/ko/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/ko/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` - [Meshy 7.1](/ko/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` - [Meshy 7](/ko/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` - [Remesh](/ko/development/comfy-router/models/meshy/remesh/code): `meshy/remesh` -- [Rigging](/ko/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` +- [리깅](/ko/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/ko/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ko/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/ko/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/ko/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Part](/ko/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part`- [Hunyuan 3D Smart Topology](/ko/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` - [Hunyuan 3D Texture Edit](/ko/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/ko/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` @@ -609,6 +611,8 @@ translationBlockHashes: | 모델 | ID | 입력 | 출력 | | --- | --- | --- | --- | +| [MiniMax H3 Image Highspeed](/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | 텍스트, 이미지 | 이미지 | +| [MiniMax H3 Image](/ko/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | 텍스트, 이미지 | 이미지 | | [MiniMax H3](/ko/development/comfy-router/models/minimax/minimax-h3/code) | `minimax/minimax-h3` | 텍스트, 이미지 | 비디오 + 오디오 | ## Moonvalley @@ -810,10 +814,10 @@ translationBlockHashes: | 모델 | ID | 입력 | 출력 | | --- | --- | --- | --- | -| [Grok Imagine Image 2.0](/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code) | `xai/grok-imagine-image-2.0` | 텍스트 | 이미지 | -| [Grok Imagine Image Pro](/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code) | `xai/grok-imagine-image-pro` | 텍스트 | 이미지 | -| [Grok Imagine Image Quality](/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code) | `xai/grok-imagine-image-quality` | 텍스트 | 이미지 | -| [Grok Imagine Image](/ko/development/comfy-router/models/xai/grok-imagine-image/code) | `xai/grok-imagine-image` | 텍스트 | 이미지 | +| [Grok Imagine Image 2.0](/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code) | `xai/grok-imagine-image-2.0` | 이미지, 텍스트 | 이미지 | +| [Grok Imagine Image Pro](/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code) | `xai/grok-imagine-image-pro` | 이미지, 텍스트 | 이미지 | +| [Grok Imagine Image Quality](/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code) | `xai/grok-imagine-image-quality` | 이미지, 텍스트 | 이미지 | +| [Grok Imagine Image](/ko/development/comfy-router/models/xai/grok-imagine-image/code) | `xai/grok-imagine-image` | 이미지, 텍스트 | 이미지 | | [Grok Imagine Video 1.5 Lite](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code) | `xai/grok-imagine-video-1.5-lite` | 텍스트, 이미지 | 비디오 | | [Grok Imagine Video 1.5 Preview](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code) | `xai/grok-imagine-video-1.5-preview` | 텍스트, 이미지 | 비디오 | | [Grok Imagine Video 1.5](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5/code) | `xai/grok-imagine-video-1.5` | 텍스트, 이미지 | 비디오 | diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 831b21f68c..5e4f4ada58 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Dreamina Seedance 2.0 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-260128을 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 70ec471f +translationSourceHash: a3a29c99 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 8c0478c9 + "Schema": 9c7c68b7 "Examples": 641c458b --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -197,33 +198,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전혀 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하십시오. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다 - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast, 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL(wav, mp3). + 오디오 URL, Base64 인코딩 또는 Asset ID. +오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ +Asset ID: 형식 asset://\ Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마십시오. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 4k를 포함한 최종 출력 등급에 대한 해상도는 이 요청에서 설정하세요. 생략하면 최종 결과는 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 만들 때 반환된 작업 ID입니다. @@ -232,24 +233,24 @@ Base64: 형식 data:audio/\;base64,\ 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근 가능한지 확인하십시오. +이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +Asset ID: 형식 asset://\ 콘텐츠 항목의 역할/위치입니다. 이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 전용). -오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 전용). +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델을 위한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용해 생성할 비디오를 설명합니다. 파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) @@ -262,96 +263,96 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 -공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 -될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에 적용됩니다. -`content`는 배열이며, 요청당 본문 제한이 전체 문서를 제한합니다. -이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 -직접 호출할 때는 대신 BytePlus 자체 검증기가 응답합니다. 실제 프롬프트에 대해 -판정하지 않도록 실제 트래픽보다 훨씬 높게 설정되어 있습니다. 호출자가 더 -필요로 하면 값을 높이십시오. +BytePlus 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 +공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 +문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. +이 제한은 요청 전체가 아니라 이 필드 하나만 제한합니다: `content`는 배열이며, +요청당 본문 제한이 전체 문서를 제한합니다. 이를 적용하는 표면은 +Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출하면 +대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 +실제 프롬프트를 판정하는 일이 없습니다. 호출자가 더 필요하면 값을 올리세요. - 입력 콘텐츠의 유형입니다. + 입력 콘텐츠의 유형입니다 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL(mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 Asset ID. +비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +Asset ID: 형식 asset://\ Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청에서 4k를 포함한 최종 해상도를 설정합니다. 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(auto). 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 시간 초과 임계값(초)입니다. 기본값 172800(48h). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙을 공급자가 비디오와 별도로 콘텐츠 검사합니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 나타날 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 이는 거부된 양상이 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 명시됩니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 만드세요. +false: 모델이 무음 비디오를 출력합니다. +모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략합니다. + 호출할 모델의 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 호출자는 이를 생략하기 때문입니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. -mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며 파일 크기가 더 큽니다. +mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되어 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. - 범위: `-1`에서 `4294967295`까지 + 범위: `-1` ~ `4294967295` - 처리에 사용할 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -360,46 +361,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 기준이 되는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 에서 Router가 제공하는 스키마로 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 삭제하므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy storage에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서에서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하십시오. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정하고, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy storage에 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 제공됩니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참조하십시오. Router는 둘 중 존재하는 값을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으므로 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. URL 자체가 가진 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 존재할 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 제공되고, BytePlus가 삭제하면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 없어지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 모두 존재하지 않습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 삭제하면 사라집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀값처럼 다루십시오. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 1회는 Router 자체의 재호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외 모든 경우에는 없습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 없어집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 1회를 Router 자체 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 삭제하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 비디오를 다운로드하십시오. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy storage에 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고하기도 하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. 정수가 아닌 숫자로 선언된 이유는 BytePlus가 이 부분에서 일관되지 않기 때문입니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 같은 BytePlus의 다른 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. @@ -407,7 +408,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드들은 검증 실패와 공급자 장애를 설명합니다. Router는 전송 계층 장애를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열이며, 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -415,30 +416,29 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - -비디오 생성 작업의 ID + 비디오 생성 작업의 ID - 해당 작업에서 사용한 모델의 이름과 버전 + 작업에서 사용한 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제 항목으로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드로, 값을 변경하지 않고 그대로 전달합니다. + 생성된 비디오의 컨테이너 형식(`mp4` 또는 `mov`)으로, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에 값을 반환합니다. BytePlus 자체 필드이며 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 값을 변경하지 않고 그대로 전달합니다. + 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 그대로 전달됩니다. - 해당 작업에서 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 값을 변경하지 않고 그대로 전달합니다. + 해당 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 그대로 전달됩니다. 형식: `int64` - 작업의 상태 + 작업의 상태입니다. 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` @@ -448,15 +448,15 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 요청의 토큰 사용량 + 요청의 토큰 사용량입니다. - 모델이 생성한 토큰 수 + 모델이 생성한 토큰 수입니다. - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 579142be5d..b700261684 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Dreamina Seedance 2.0 Fast 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-fast-260128을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: 8036f4db +translationSourceHash: 506a7f86 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": 90b60b2e + "Schema": 48fe2811 "Examples": 7714eccd --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -182,33 +183,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만, 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 조회 라우트를 폴링하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하여 확인하세요. 형식: `uri` - 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠입니다. + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만으로는 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL입니다(wav, mp3). -Base64: 형식은 data:audio/\;base64,\입니다. -에셋 ID: 형식은 asset://\입니다. +오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. +Base64: 형식 data:audio/\;base64,\ +에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이자 유일한 지원 값인 1080p입니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 이를 다시 전송하지 마세요. 최종 출력 등급(4k 포함)에 맞는 해상도를 이 요청에서 설정하세요. 생략하면 최종 결과물은 1080p입니다. - `draft`가 true로 설정된 상태로 Draft 비디오가 생성되었을 때 반환된 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. @@ -219,22 +220,22 @@ Base64: 형식은 data:audio/\;base64,\입니다. 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식은 asset://\입니다. +에셋 ID: 형식 asset://\ 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image입니다. +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델의 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자로 생성할 비디오를 설명합니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. 파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) @@ -245,17 +246,16 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus의 제약이 아닌 Comfy 측 보호 장치입니다. BytePlus는 텍스트 길이 -제한을 공개하지 않으며, 테스트(2026-09-17)에서 40,000자까지 허용했습니다. -바이트가 아닌 문자를 세므로, 멀티바이트 프롬프트는 전송 시 이 크기의 -몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 -제한하지는 않습니다. `content`는 배열이고, 전체 문서는 요청당 본문 -제한으로 제한됩니다. 이를 적용하는 표면은 Comfy Router -(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 때는 BytePlus -자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 -프롬프트를 판정하지 않습니다. 호출자에게 더 많은 용량이 필요하면 올리세요. +예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 +공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 +될 수 있습니다. 이 값은 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다. +`content`는 배열이고, 문서 전체를 제한하는 것은 요청당 본문 제한입니다. +이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 +직접 호출하면 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 +설정하여 실제 프롬프트를 판정하지 않도록 하세요. 호출자에게 더 많은 양이 필요하면 값을 높이세요. @@ -270,35 +270,36 @@ BytePlus의 제약이 아닌 Comfy 측 보호 장치입니다. BytePlus는 텍 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL입니다(mp4, mov). -에셋 ID: 형식은 asset://\입니다. +비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청에서 4k를 포함한 최종 해상도를 설정합니다. 해상도를 생략하면 최종 결과물은 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(auto)입니다. 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간)입니다. 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다. +모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 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 호출자는 이를 생략합니다. @@ -310,33 +311,33 @@ mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색 - 생성된 비디오의 종횡비입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 종횡비를 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 이전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 일치하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되므로 여러 개의 연속 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리용 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -345,46 +346,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 - 동영상 생성 작업이 완료된 후의 출력으로, 출력 동영상의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus의 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 함께 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 정리하며, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 동영상의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 정리합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 동영상의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 넣은 경우에 해당합니다. Seedance 모델은 이를 보통 `content`의 최상위 형제 필드로 반환하며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참고), Router는 둘 중 존재하는 쪽을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시각: URL 자체가 지니는 가장 이른 서명 시각 더하기 유효 기간이며, `updated_at`이 존재하는 경우 작업의 `updated_at` 더하기 24시간(BytePlus가 문서화한 URL 수명)을 결코 넘지 않고, 그렇지 않으면 작업의 `updated_at` 더하기 24시간입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 동작을 멈추는 RFC 3339 시각입니다. URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 존재할 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하고, BytePlus가 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인된 워크스페이스에만 해당하고, Seedance 2.x에만 해당하며, BytePlus가 정리한 뒤에는 존재하지 않고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 동영상에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 사라집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 동영상을 다운로드할 수 있으므로 비밀처럼 취급하세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데, 그중 한 번은 Router 자체의 재호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 존재하지 않습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 정리하면 존재하지 않습니다. 미리 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루어야 합니다. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하는데, 그중 1회는 Router 자체의 재호스팅이 소비합니다. - 출력 동영상에 대한 다운로드 URL입니다. Router는 동영상을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크가 만료되므로 URL을 저장하지 말고 동영상을 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 캐시 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 해당 URL을 정리하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위 UNIX 타임스탬프입니다. - 생성된 동영상의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어서 정수 대신 숫자로 선언되었습니다. 동영상 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 인터페이스는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus의 자체 필드로, 성공한 동영상 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고합니다. 따라서 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -392,23 +393,22 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected 및 OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 패밀리에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake가 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 실패를 덮어쓰지는 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 계층 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. 오류 메시지 - - 비디오 생성 작업의 ID +비디오 생성 작업의 ID - 작업에서 사용한 모델의 이름과 버전 + 작업에 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)입니다. `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. @@ -440,7 +440,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 46913536ea..327cf95811 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router와 함께 Dreamina Seedance 2.0 Mini 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-mini를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: a1d75c67 +translationSourceHash: 69e65942 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": ebf1fc3a + "Schema": 51a6f44e "Examples": db01067e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-mini.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -179,17 +180,17 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다 - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast, 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력할 수 있습니다. @@ -201,11 +202,11 @@ Base64: 형식 data:audio/\;base64,\ Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 결과의 출력 등급(4k 포함)은 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. - Draft 비디오를 `draft`를 true로 설정하여 생성했을 때 반환된 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. @@ -221,9 +222,9 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 해당). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 해당). +이미지: first_frame, last_frame 또는 reference_image. +비디오: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -231,9 +232,9 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. -파라미터 (선택 사항): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[parameters]를 추가하세요: +파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[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) @@ -242,28 +243,27 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" +예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 -길이 제한을 공개하지 않으며 테스트에서 40,000자를 허용했습니다 (2026-09-17). +BytePlus 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 +제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 -몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에 -적용됩니다. `content`는 배열이며, 문서 전체를 제한하는 것은 요청당 -본문 한도입니다. 이를 강제하는 표면은 Comfy Router -(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 때는 대신 -BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 -설정되어 있어 실제 프롬프트를 판정하는 일이 없습니다. 호출자가 더 -필요하면 값을 높이세요. +몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 +제한합니다: `content`는 배열이며, 요청당 본문 제한이 전체 문서를 +제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. +실제 프롬프트를 절대 판정하지 않도록 실제 트래픽보다 훨씬 높게 +설정되어 있습니다. 호출자가 더 많이 필요하면 값을 높이세요. - 입력 콘텐츠의 유형입니다. + 입력 콘텐츠의 유형입니다 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. @@ -274,29 +274,30 @@ BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높 Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 1080p 비디오가 렌더링됩니다. Draft 작업 ID는 7일 동안 유효합니다. +최종 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. 해당 요청에서 최종 결과의 해상도(4k 포함)를 설정합니다. 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1(자동). + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 해당 검사에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 받아들이는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 만드세요. +false: 모델이 무음 비디오를 출력합니다. +모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략합니다. + 호출할 모델의 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 호출자는 이 값을 생략합니다. @@ -308,22 +309,22 @@ mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테 - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 이 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 이전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro의 기본값: adaptive. +Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력이 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite의 기본값: 720p. Seedance 1.0 pro & pro-fast의 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정한 뒤 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -334,7 +335,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 처리용 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -343,38 +344,38 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에서 Router가 제공하는 스키마로부터 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 뒤의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담고 있습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 다시 호스팅되며, 여기의 다른 모든 필드는 BytePlus의 자체 필드입니다. Null일 수 있습니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 RE-HOST되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하십시오. + 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 넣는 경우에 해당합니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많으며, 최상위 `output_format` 필드를 참고하십시오. Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 존재합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참고), Router는 둘 중 존재하는 쪽을 읽습니다. - 업스트림 URL이 동작을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지닌 유효 기간을 더한 값입니다. `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않으며, 그렇지 않은 경우 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 다시 호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. 가장 이른 서명 시간에 URL 자체가 지닌 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at` + 24시간(BytePlus가 문서화한 URL 수명)보다 늦지 않고, 그렇지 않으면 작업의 `updated_at` + 24시간입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시간을 제공하지 않으면 생략됩니다. 다시 호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus의 자체 다운로드 URL로, 다시 호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 옵트인한 워크스페이스에만 해당하고 Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고 `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, `upstream_video_url`과 동일한 조건으로 다시 호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환됩니다. 옵트인된 워크스페이스에만 해당하고, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus의 자체 다운로드 URL로, 다시 호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 존재하지 않습니다. 여기에는 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 범위가 지정되지 않은 레거시 API 키)이 포함되며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 보유한 누구든 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루십시오. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하며 그중 1회는 Router 자체의 다시 호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 다시 호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 하나는 Router 자체의 다시 호스팅이 소비합니다. - 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 다시 호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하십시오. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 재작성하므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 1시간도 남지 않은 URL을 받을 수 있습니다. 다시 호스팅할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. @@ -382,7 +383,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 표면에서는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus의 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수 대신 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고 인접한 BytePlus 표면에서는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. @@ -390,31 +391,30 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않고 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 붙을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등입니다. 이는 열거형이 아니라 열린 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. 오류 메시지 - - 비디오 생성 작업의 ID +비디오 생성 작업의 ID - 작업에서 사용한 모델의 이름과 버전 + 작업에 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제 항목으로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus의 자체 필드이며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`와 형제 관계인 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus의 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus의 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. 형식: `int64` @@ -438,7 +438,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 0d3147eea6..6ddc08588d 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,19 +2,20 @@ title: "Comfy Router에서 Dreamina Seedance 2.5 260628 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-5-260628을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 3606fb83 +translationSourceHash: 2acd3f28 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": d2c28a84 + "Schema": d29d4b46 "Examples": 5465695b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -195,13 +196,13 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 결과는 대신 작업 상태 조회 경로를 폴링하세요. 형식: `uri` - 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠입니다. + 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠입니다 @@ -210,18 +211,18 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. +오디오 URL: 오디오의 공개 URL입니다(wav, mp3). Base64: 형식은 data:audio/\;base64,\입니다. 에셋 ID: 형식은 asset://\입니다. Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이자 유일한 지원 값인 1080p입니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 결과의 출력 등급(4k 포함)에 맞게 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환되는 작업 ID입니다. + Draft 비디오를 `draft`를 true로 설정하여 생성했을 때 반환된 작업 ID입니다. @@ -229,7 +230,7 @@ Base64: 형식은 data:audio/\;base64,\입니다. - 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. 에셋 ID: 형식은 asset://\입니다. @@ -238,8 +239,8 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 콘텐츠 항목의 역할/위치입니다. 이미지의 경우: first_frame, last_frame 또는 reference_image입니다. -비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. -오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. +비디오의 경우: reference_video입니다(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio입니다(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -247,7 +248,7 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자로 생성할 비디오를 설명합니다. 파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) @@ -258,20 +259,21 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" +예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 -텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 +제한을 공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 -몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한할 뿐 요청 전체를 제한하지 않습니다. -`content`는 배열이며, 요청당 본문 제한이 전체 문서를 제한합니다. 이를 강제하는 표면은 -Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 경우에는 -BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있으므로 -정상적인 프롬프트를 절대 거부하지 않습니다. 호출자가 더 필요로 하면 이 값을 높이세요. +몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 +제한합니다. `content`는 배열이며, 요청별 본문 제한이 문서 전체를 +제한합니다. 이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. 실제 +트래픽보다 훨씬 높게 설정하여 정상적인 프롬프트를 판정하지 않도록 +했습니다. 호출자에게 더 필요한 경우 값을 올리세요. - 입력 콘텐츠의 유형입니다. + 입력 콘텐츠의 유형입니다 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -282,13 +284,13 @@ BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +비디오 URL: 비디오의 공개 URL입니다(mp4, mov). 에셋 ID: 형식은 asset://\입니다. Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청이 최종 결과의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. @@ -306,49 +308,50 @@ BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨 Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙을 공급자가 비디오와 별도로 콘텐츠 검사합니다. 이 검사에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 명시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다. +모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략합니다. + 호출할 모델의 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 호출자는 생략하기 때문입니다. - Seedance 2.5 전용. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. + Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. +mp4: 폭넓은 호환성과 더 작은 파일 크기를 제공하는 일반 용도 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 높은 색상 정밀도로 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만 허용되며(또는 필드를 생략), 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성되는 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력이 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -357,38 +360,38 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 뒤의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담고 있습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 뒤의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고 있지만, Router는 전달받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 그대로 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우에 해당합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며, 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 제공됩니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으므로 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. - 업스트림 URL이 동작을 멈추는 RFC 3339 시각입니다. URL 자체가 지닌 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값입니다. `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않으며, 그렇지 않은 경우 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하고, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하고, BytePlus가 이를 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, `upstream_video_url`과 동일한 조건으로 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환됩니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 여기에 해당하며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 사라집니다. presigned 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 취급하세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 한 번은 Router 자체의 재호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 미리 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하는데 그중 한 번은 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 그대로 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. @@ -396,7 +399,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업에서 정수 초를 반환한 사례가 관찰되었고 같은 BytePlus의 다른 표면에서는 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이에 대해 일관성이 없으므로 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 사례가 관측되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고합니다. 따라서 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -404,15 +407,14 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열린 문자열이며 열거형이 아닙니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열이 점으로 구분된 사유를 가질 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열로, 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 응답 본문과 HTTP 200 실패 작업 응답에서 정책 계열을 인식하되, 전송 계층 실패를 덮어쓰지 않습니다. 오류 메시지 - - 비디오 생성 작업의 ID +비디오 생성 작업의 ID @@ -420,27 +422,27 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 고유 필드로, 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도이며, 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 고유 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 고유 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. 형식: `int64` - 작업의 상태 + 작업 상태 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 마지막 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. @@ -452,7 +454,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index f8ba4298d6..a545d5d20f 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Seedance 1.0 Pro 250528 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-250528을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 642f85ab +translationSourceHash: 846f38d7 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": b57b84de + "Schema": 6f05c994 "Examples": 815d621e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-250528.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -182,33 +183,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 경로를 폴링하여 결과를 확인하십시오. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. + 모델이 비디오를 생성할 입력 콘텐츠 - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast, 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL입니다(wav, mp3). -Base64: 형식은 data:audio/\;base64,\입니다. -에셋 ID: 형식은 asset://\입니다. + 오디오 URL, Base64 인코딩 또는 에셋 ID. +오디오 URL: 오디오의 공개 URL (wav, mp3). +Base64: 형식 data:audio/\;base64,\ +에셋 ID: 형식 asset://\ - Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. resolution은 기본값이 1080p이며 1080p만 지원합니다. + Seedance 2.5 전용. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마십시오. 최종 출력 등급(4k 포함)을 위해 이 요청에서 해상도를 설정하십시오. 생략하면 최종 결과물은 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. + `draft`가 true로 설정된 상태에서 Draft 비디오가 생성되었을 때 반환된 작업 ID입니다. @@ -216,27 +217,27 @@ Base64: 형식은 data:audio/\;base64,\입니다. - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근 가능한지 확인하세요. + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠 (type이 "image_url"인 경우) +이미지 URL: 이미지 URL에 접근할 수 있는지 확인하십시오. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식은 asset://\입니다. +에셋 ID: 형식 asset://\ - 콘텐츠 항목의 역할/위치입니다. + 콘텐츠 항목의 역할/위치. 이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 전용). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 전용). +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델의 입력 텍스트 정보. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 생성할 비디오에 대한 설명으로, 중국어 및 영어 문자를 사용합니다. +텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용한 생성할 비디오에 대한 설명. -파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터 (선택): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[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) @@ -247,92 +248,97 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않았고 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에 적용됩니다: -`content`는 배열이며, 요청당 본문 제한이 문서 전체를 제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, -v1 /proxy를 직접 호출할 경우에는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있어 -실제 프롬프트를 판정하지 않습니다. 호출자에게 더 필요한 경우 값을 높이세요. +BytePlus 제약이 아닌 Comfy 측 가드레일. BytePlus는 텍스트 길이 제한을 +게시하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 계산하므로 멀티바이트 프롬프트는 전송 시 +이 크기의 몇 배일 수 있습니다. 이는 이 단일 필드를 제한할 뿐 요청을 +제한하지 않습니다: `content`는 배열이며, 요청당 본문 제한이 전체 +문서를 제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. +실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하지 않습니다. +호출자가 더 필요하면 값을 높이십시오. - 입력 콘텐츠의 유형입니다. + 입력 콘텐츠의 유형 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL입니다(mp4, mov). -에셋 ID: 형식은 asset://\입니다. + 비디오 URL 또는 에셋 ID. +비디오 URL: 비디오의 공개 URL (mp4, mov). +에셋 ID: 형식 asset://\ - Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, resolution은 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 1080p 비디오를 렌더링합니다. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용. 480p Draft 비디오를 생성하며 해상도는 480p여야 합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하십시오. 해당 요청은 최종 결과물의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과물은 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 1.0 pro, 1.0 pro fast: [2,12]. + 비디오 재생 시간(초). Seedance 1.0 pro 및 1.0 pro fast: [2,12]. 가능한 값: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초). 기본값 172800 (48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 공급자가 생성된 오디오 트랙을 비디오와 별도로 콘텐츠 검사합니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다. +모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 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 호출자는 이를 생략하기 때문입니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용됩니다. 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 없습니다. 이 매개변수를 사용하면 여러 개의 연속 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되어 여러 개의 연속 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. - 범위: `-1`부터 `4294967295`까지 + 범위: `-1` ~ `4294967295` - 처리를 위한 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -341,46 +347,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅(RE-HOST)되며, 여기의 다른 모든 필드는 BytePlus 자체의 필드입니다. null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 정리하므로, 그 이후에 폴링한 성공 문서에는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담고 있습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 삭제하므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. + 요청에서 `return_last_frame`을 설정했을 때 반환되는, 생성된 비디오의 마지막 프레임 다운로드 URL입니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 제공받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 타입을 지정하며, `image/jpeg`는 둘 다 실패할 때의 최후 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로 나중 폴링에서는 1시간도 남지 않은 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 삭제합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우에 존재합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으므로 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. - 업스트림 URL이 동작을 멈추는 RFC 3339 시각입니다. URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우에는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되며 조건은 `upstream_video_url`과 같습니다. 옵트인한 워크스페이스에만 제공되고, Seedance 2.x에만 해당하며, BytePlus가 정리한 뒤에는 존재하지 않고, `upstream_expires_at`까지는 bearer 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 즉, 옵트인한 워크스페이스에만, Seedance 2.x에만 제공되며, BytePlus가 삭제하면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 존재하지 않습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 특정 워크스페이스에 연결되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 정리하면 없어집니다. presigned 오브젝트 스토리지 URL이므로 bearer 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 하나는 Router 자체의 재호스팅이 사용합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 매개변수는 없습니다), 그 외의 경우에는 존재하지 않습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 삭제하면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀처럼 취급하세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 하나를 Router의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 정리하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로 나중 폴링에서는 1시간도 남지 않은 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 삭제하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시각입니다. 값은 초 단위 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이를 일관되게 처리하지 않기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관측되었고, 인접한 다른 BytePlus 표면은 소수 재생 시간을 보고합니다. 따라서 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환하는 사례가 관찰되었고, 같은 BytePlus의 다른 API 표면은 소수 재생 시간을 보고하므로 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -388,15 +394,14 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 계층 실패를 덮어쓰지는 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 점으로 구분된 사유가 붙을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 계층 실패를 덮어쓰지는 않습니다. 오류 메시지 - - 비디오 생성 작업의 ID +비디오 생성 작업의 ID @@ -404,11 +409,11 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드로, 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 요소로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 해상도이며, 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. @@ -436,7 +441,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 80b0f0e982..5d6b392c3d 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router에서 Seedance 1.0 Pro Fast 251015 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-fast-251015를 호출하는 방법: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 61dd0135 +translationSourceHash: 5ba64878 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": dd74b012 + "Schema": 2de625f5 "Examples": 1469ab97 --- + {/* 생성된 파일. router-schemas/byteplus/seedance-1-0-pro-fast-251015.json에서 `pnpm code-pages:gen`으로 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 받으세요. 형식: `uri` @@ -192,19 +193,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL(wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. +Base64: 형식은 data:audio/\;base64,\입니다. +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. + Seedance 2.5만 해당됩니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 출력 등급(4k 포함)은 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. @@ -217,24 +218,24 @@ Base64: 형식 data:audio/\;base64,\ 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근 가능한지 확인하세요. +이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +에셋 ID: 형식은 asset://\입니다. 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지: first_frame, last_frame 또는 reference_image. +비디오: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 해당). +오디오: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 해당). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델의 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트(필수): 생성할 비디오에 대한 설명으로, 중국어와 영어 문자를 사용합니다. 파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) @@ -245,17 +246,17 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "아름다운 풍경 --ratio 16:9 --resolution 720p --duration 5" +예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 -텍스트 길이 제한을 공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 -될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에만 적용됩니다. +BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 +제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 +몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 제한합니다. `content`는 배열이며, 전체 문서를 제한하는 것은 요청당 본문 제한입니다. 이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, -v1 /proxy를 직접 호출할 경우에는 BytePlus 자체 검증기가 대신 응답합니다. -실제 트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 거부하지 않습니다. -호출자가 더 많은 양이 필요하면 값을 높이세요. +직접 v1 /proxy를 호출하면 대신 BytePlus 자체 검증기가 응답합니다. +실제 트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 판정하지 않습니다. +호출자가 더 많은 길이를 필요로 하면 값을 높이세요. @@ -269,74 +270,75 @@ v1 /proxy를 직접 호출할 경우에는 BytePlus 자체 검증기가 대신 - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL(mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5만 해당됩니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청에서 최종 결과의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 1.0 pro, 1.0 pro fast: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 1.0 pro 및 1.0 pro fast: [2,12]. 가능한 값: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` - 작업 시간 초과 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 표시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. +true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다. +모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이 값을 생략합니다. + 호출할 모델의 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 호출자는 이 값을 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. +mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큰 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)입니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 연속된 여러 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 연속된 여러 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 연속 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리용 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -345,46 +347,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 뒤의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오 마지막 프레임의 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 보통 이를 `content`의 최상위 형제 필드로 반환합니다. 최상위 `output_format` 필드를 참고하세요. Router는 두 위치 중 존재하는 것을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 `content` 안에 중첩해 반환할 때 제공됩니다. Seedance 모델은 보통 이를 `content`의 최상위 형제 필드로 반환하며, 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 쪽을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 해당 작업의 `updated_at`에 24시간을 더한 값(BytePlus가 문서화한 URL 수명)보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 있을 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - BytePlus 자체의 마지막 프레임 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다: 옵트인된 워크스페이스 전용, Seedance 2.x 전용, BytePlus가 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 옵트인한 워크스페이스 전용, Seedance 2.x 전용이며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - BytePlus 자체의 출력 비디오 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다: 가진 사람은 누구나 만료 전까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 1회는 Router 자체의 재호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 없습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 여기에 해당하며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 보유한 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 1회는 Router 자체의 재호스팅이 소모합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 재호스팅하고 이 필드를 다시 쓰므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않을 수 있습니다. 재호스팅을 수행할 수 없었을 때는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이에 대해 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 것이 관찰된 한편 인접한 다른 BytePlus 표면은 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고 인접한 BytePlus 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -392,37 +394,36 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 패밀리에 점으로 구분된 사유가 있을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아닌 열린 문자열입니다: 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 점으로 구분된 사유가 붙을 수 있습니다. 예: InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake. 이 값은 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. 오류 메시지 - - 비디오 생성 작업의 ID +비디오 생성 작업의 ID - 작업에서 사용하는 모델의 이름과 버전 + 작업에서 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 쿼리가 반환하는 위치입니다. BytePlus 자체 필드이며 변경 없이 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. 형식: `int64` - 작업 상태 + 작업의 상태입니다. 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` @@ -432,11 +433,11 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 요청의 토큰 사용량입니다. + 요청의 토큰 사용량 - 모델이 생성한 토큰 수입니다. + 모델이 생성한 토큰 수 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 92ed015aea..229379c60c 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router로 Seedance 1.5 Pro 251215 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-5-pro-251215를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 2263b4cf +translationSourceHash: 8c658f01 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": f4d67fb6 + "Schema": b9957cb9 "Examples": 7e73ac5c --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/byteplus/seedance-1-5-pro-251215.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -182,33 +183,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전혀 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하여 확인하십시오. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하세요. 형식: `uri` - 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다 - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만으로는 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL(wav, mp3). + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL입니다(wav, mp3). Base64: 형식 data:audio/\;base64,\ 에셋 ID: 형식 asset://\ - Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마십시오. 해상도는 기본값이 1080p이며 1080p만 지원합니다. + Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 콘텐츠 항목 중 유일해야 합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 4k를 포함한 최종 출력 등급에 맞게 이 요청에서 해상도를 설정하세요. 해상도를 생략하면 최종 결과는 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. + `draft`가 true로 설정된 상태에서 Draft 비디오를 생성했을 때 반환되는 작업 ID입니다. @@ -216,8 +217,8 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠(type이 "image_url"인 경우) -이미지 URL: 이미지 URL에 접근 가능한지 확인하십시오. + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). +이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. 에셋 ID: 형식 asset://\ @@ -236,30 +237,30 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. -파라미터(선택 사항): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[parameters]를 추가하십시오: +파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[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) +- --duration (--dur): 3-12초 (기본값: 5) - --framepersecond (--fps): 24 (기본값: 24) - --watermark (--wm): true/false (기본값: false) -- --seed (--seed): -1 ~ 2^32-1 (기본값: -1) +- --seed (--seed): -1부터 2^32-1까지 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) 예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 -제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 -될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 제한하지 않습니다. -`content`는 배열이며, 요청당 본문 제한이 전체 문서의 크기를 제한합니다. -이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})입니다. -v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합니다. -실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하는 일이 없도록 하며, -호출자가 더 필요로 하면 값을 높이십시오. +Comfy 측 가드레일이며 BytePlus 제약이 아닙니다. BytePlus는 +텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 계산하므로 멀티바이트 프롬프트는 전송 시 이 크기의 +여러 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 +제한합니다. `content`는 배열이며, 요청당 본문 제한이 전체 문서를 +제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})입니다. +직접 v1 /proxy를 호출하면 대신 BytePlus 자체 검증기가 +응답합니다. 실제 트래픽보다 훨씬 높게 설정하여 실제 프롬프트를 +판정하지 않도록 하세요. 호출자가 더 필요하면 늘리세요. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -269,14 +270,14 @@ v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합 - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL(mp4, mov). + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL입니다(mp4, mov). 에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. +최종 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. 해당 요청은 4k를 포함한 최종 결과의 해상도를 설정합니다. 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. @@ -286,57 +287,58 @@ v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합 - 작업 제한 시간 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 시간 초과 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. - 범위: `3600` ~ `259200` + 범위: `3600`부터 `259200`까지 Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 공급자가 생성된 오디오 트랙을 비디오와 별도로 콘텐츠 검사합니다. 해당 검사에서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 다른 조건에서는 허용하는 입력에 대해 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 됩니다. 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 해당 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다. +모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략합니다. + 호출할 모델의 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 호출자는 이를 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. +mp4: 폭넓은 호환성과 더 작은 파일 크기를 갖춘 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 높은 색상 정밀도를 갖춘 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로, 후반 작업에 적합하지만 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro의 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드를 생략하는 경우)만 허용됩니다. 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite의 기본값: 720p. Seedance 1.0 pro 및 pro-fast의 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회 API를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되므로 여러 개의 연속 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 연속된 여러 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 연속된 여러 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. - 범위: `-1` ~ `4294967295` + 범위: `-1`에서 `4294967295`까지 - 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 및 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리용 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -345,38 +347,38 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null 허용: BytePlus는 작업 후 24시간 뒤에 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 값을 읽습니다. + BytePlus가 `content` 안에 중첩해 반환할 때의 생성된 비디오의 컨테이너 형식(mp4 또는 mov)입니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 것을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. URL 자체가 지니는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 있을 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시간을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. URL 자체가 지니는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 있을 때는 해당 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦을 수 없고, `updated_at`이 없을 때는 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시간을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되는 BytePlus 자체의 마지막 프레임 다운로드 URL로, `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인한 워크스페이스 전용, Seedance 2.x 전용, BytePlus가 지운 뒤에는 없음, 그리고 `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간 뒤에 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 누구나 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 한 번은 Router 자체 재호스팅이 소비합니다. + 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환되는 BytePlus 자체의 출력 비디오 다운로드 URL입니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우(워크스페이스로 해석되지 않는 자격 증명, 예를 들어 특정 워크스페이스에 범위가 지정되지 않은 레거시 API 키 포함)에는 없고, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 없습니다. 미리 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 누구나 만료 전까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드를 100회로 제한하고 그중 하나는 Router의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체의 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. @@ -384,7 +386,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고하므로 클라이언트는 값을 정수로 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. 정수가 아닌 숫자로 선언된 것은 BytePlus가 이에 대해 일관적이지 않기 때문입니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고 같은 BytePlus의 다른 표면은 소수 재생 시간을 보고하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체의 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -392,31 +394,31 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 점으로 구분된 사유가 붙을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아니라 열린 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 계층 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열린 문자열이며 열거형이 아닙니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. 오류 메시지 - +```mdx 비디오 생성 작업의 ID - 작업에서 사용한 모델의 이름과 버전 + 작업에서 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식입니다(mp4 또는 mov). `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 쿼리가 이 값을 반환하는 위치입니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov). `content`의 형제 항목으로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회가 이 위치에 값을 반환합니다. BytePlus 자체 필드이며 값은 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 값은 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 값은 그대로 전달됩니다. 형식: `int64` @@ -440,7 +442,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/krea/krea-2-large/code.mdx b/ko/development/comfy-router/models/krea/krea-2-large/code.mdx index 9821caf735..ea45481ca7 100644 --- a/ko/development/comfy-router/models/krea/krea-2-large/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-2-large/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Krea 2 Large 사용하기" description: "Comfy Router를 통해 krea/krea-2-large를 호출하는 방법: endpoint, 요청 형태, Router가 반환하는 응답." sidebarTitle: "Krea 2 Large" -translationSourceHash: a4fdfae2 +translationSourceHash: 19dca448 translationFrom: development/comfy-router/models/krea/krea-2-large/code.mdx translationBlockHashes: "_intro": bd2a615c "Quick start": 5d997ba7 - "Schema": d755f939 + "Schema": 9e43627e "Examples": 91f72543 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/krea/krea-2-large.json에서 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ Router가 `GET /v2/models/krea/krea-2-large/openapi.json`에서 제공하는 스 형식: `date-time` + + 상태가 실패일 때만 설정됩니다. 취소된 작업에는 이 필드가 없습니다. + + + + 작업이 실패한 이유: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal 또는 node_app_node_failed. 알 수 없는 코드는 internal로 처리하세요. + + + + 선택 사항입니다. provider_error와 internal에 대한 공급자의 자유 형식 텍스트입니다. + + + + 변경해야 할 요청 파라미터로, invalid_request와 validation_failed에서 함께 제공됩니다. + + 형식: `uuid` diff --git a/ko/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx b/ko/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx index d4fced2b49..6d8d2171c4 100644 --- a/ko/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Krea 2 Medium Turbo 사용하기" description: "Comfy Router를 통해 krea/krea-2-medium-turbo를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Krea 2 Medium Turbo" -translationSourceHash: f61cb3f9 +translationSourceHash: 5a2af2e1 translationFrom: development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx translationBlockHashes: "_intro": fffee1bd "Quick start": a305dd42 - "Schema": f06a0da8 + "Schema": 7e1ae995 "Examples": 91f72543 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-2-medium-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ Router가 `GET /v2/models/krea/krea-2-medium-turbo/openapi.json`에서 제공하 형식: `date-time` + + status가 failed인 경우에만 설정됩니다. 취소된 작업에는 포함되지 않습니다. + + + + 작업이 실패한 이유: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal 또는 node_app_node_failed. 알 수 없는 코드는 internal로 처리합니다. + + + + 선택 사항. provider_error 및 internal에 대한 자유 형식의 공급자 텍스트입니다. + + + + 변경해야 할 요청 매개변수로, invalid_request 및 validation_failed와 함께 제공됩니다. + + 형식: `uuid` diff --git a/ko/development/comfy-router/models/krea/krea-2-medium/code.mdx b/ko/development/comfy-router/models/krea/krea-2-medium/code.mdx index b4366bfc70..29984541c5 100644 --- a/ko/development/comfy-router/models/krea/krea-2-medium/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-2-medium/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Krea 2 Medium 사용하기" description: "Comfy Router를 통해 krea/krea-2-medium을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Krea 2 Medium" -translationSourceHash: a7f31b9b +translationSourceHash: 8c847fd4 translationFrom: development/comfy-router/models/krea/krea-2-medium/code.mdx translationBlockHashes: "_intro": d62bc601 "Quick start": 1f018136 - "Schema": 926b5274 + "Schema": 2e249b0f "Examples": 91f72543 --- + {/* 생성된 파일. router-schemas/krea/krea-2-medium.json에서 `pnpm code-pages:gen`으로 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ Router가 `GET /v2/models/krea/krea-2-medium/openapi.json`에서 제공하는 형식: `date-time` + + status가 failed일 때만 설정됩니다. 취소된 작업에는 이 필드가 없습니다. + + + + 작업이 실패한 이유: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal 또는 node_app_node_failed. 알 수 없는 코드는 internal로 처리합니다. + + + + 선택 사항. provider_error 및 internal에 대한 공급자의 자유 형식 텍스트입니다. + + + + 변경해야 할 요청 파라미터로, invalid_request 및 validation_failed와 함께 제공됩니다. + + 형식: `uuid` @@ -249,7 +266,7 @@ Router가 `GET /v2/models/krea/krea-2-medium/openapi.json`에서 제공하는 - 생성된 이미지의 다운로드 가능한 링크. 최소 한 개 이상입니다. `urls`가 비어 있는 `completed` 작업은 `success_without_output`이며 이 문서에 도달하지 않기 때문입니다. + 생성된 이미지의 다운로드 가능한 링크. 최소 한 개입니다. `urls`가 비어 있는 `completed` 작업은 `success_without_output`이며 이 문서에 도달하지 않기 때문입니다. diff --git a/ko/development/comfy-router/models/krea/krea-2/code.mdx b/ko/development/comfy-router/models/krea/krea-2/code.mdx index 072f61650f..935a542beb 100644 --- a/ko/development/comfy-router/models/krea/krea-2/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-2/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Krea 2 사용하기" description: "Comfy Router를 통해 krea/krea-2를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Krea 2" -translationSourceHash: 12dc5e3a +translationSourceHash: 72216188 translationFrom: development/comfy-router/models/krea/krea-2/code.mdx translationBlockHashes: "_intro": 5d115bf3 "Quick start": 2cc5fba4 - "Schema": 360d2f7e + "Schema": 5a67f0ed "Examples": 91f72543 --- + {/* 생성된 파일. router-schemas/krea/krea-2.json에서 `pnpm code-pages:gen`으로 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ Router가 `GET /v2/models/krea/krea-2/openapi.json`에서 제공하는 스키마 형식: `date-time` + + status가 failed일 때만 설정됩니다. 취소된 작업에는 이 필드가 없습니다. + + + + 작업이 실패한 이유: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal 또는 node_app_node_failed. 알 수 없는 코드는 internal로 취급하세요. + + + + 선택 사항입니다. provider_error와 internal에 대한 공급자의 자유 형식 텍스트입니다. + + + + 변경해야 할 요청 파라미터로, invalid_request와 validation_failed에서 함께 제공됩니다. + + 형식: `uuid` diff --git a/ko/development/comfy-router/models/krea/krea-3/code.mdx b/ko/development/comfy-router/models/krea/krea-3/code.mdx index 4a1cb8eb49..1d5bb320a2 100644 --- a/ko/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Krea 3 사용하기" description: "Comfy Router를 통해 krea/krea-3를 호출하는 방법: 엔드포인트, 요청 형태 및 Router가 반환하는 응답입니다." sidebarTitle: "Krea 3" -translationSourceHash: 56990dce +translationSourceHash: eee80c65 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": c0a0ccaf + "Schema": dbedda04 "Examples": 276619d9 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-3.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -199,6 +200,22 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ 형식: `date-time` + + status가 failed일 때만 설정됩니다. 취소된 작업에는 없습니다. + + + + 작업 실패 이유입니다: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal 또는 node_app_node_failed. 알 수 없는 코드는 internal로 처리합니다. + + + + 선택 사항입니다. provider_error 및 internal에 대한 공급자의 자유 형식 텍스트입니다. + + + + 변경해야 할 요청 파라미터로, invalid_request 및 validation_failed와 함께 제공됩니다. + + 형식: `uuid` diff --git a/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx b/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx new file mode 100644 index 0000000000..de8ecd75da --- /dev/null +++ b/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx @@ -0,0 +1,324 @@ +--- +title: "Comfy Router에서 MiniMax H3 Image Highspeed 사용하기" +description: "Comfy Router를 통해 minimax/minimax-h3-image-highspeed를 호출합니다: 엔드포인트, 요청 형태 및 Router가 반환하는 응답입니다." +sidebarTitle: "MiniMax H3 Image Highspeed" +translationSourceHash: 49584805 +translationFrom: development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx +translationBlockHashes: + "_intro": 3fd3bae8 + "Quick start": e37c76df + "Schema": 5c07b006 + "Examples": b42d5c4e +--- +{/* GENERATED FILE. Generated from router-schemas/minimax/minimax-h3-image-highspeed.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`minimax/minimax-h3-image-highspeed`의 API 레퍼런스로, MiniMax가 제공하고 Comfy Router가 서비스합니다. + +**입력:** Text, Image · **출력:** Image + +## 빠른 시작 + +[내 Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 보냅니다. + +**Model ID:** `minimax/minimax-h3-image-highspeed` + +**Endpoint:** `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 idempotency key를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "minimax/minimax-h3-image-highspeed", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 idempotency key를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("minimax/minimax-h3-image-highspeed", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests`로 전송합니다. Router는 실행이 접수되는 즉시 `201`과 `request_id`로 응답하며, 결과는 준비가 되면 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 방법을 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "minimax/minimax-h3-image-highspeed", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자 자체의 payload이며, models.run()이 반환하는 것과 같은 값입니다. + # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("minimax/minimax-h3-image-highspeed", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 모델의 네이티브 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202를 반환합니다. +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + `size`가 생략되거나 `auto`일 때의 출력 영역 등급입니다. `1K`, `2K`, `4K`(기본값) 중 하나입니다. + + + + `size`가 생략되거나 `auto`일 때의 출력 가로세로 비율입니다. `auto`(기본값) 또는 1:3에서 3:1 사이의 `X:Y` 형식이며, 예를 들어 `16:9`입니다. + + + + MiniMax의 프롬프트 강화 기능을 끕니다. 고정된 `size` 또는 `X:Y` 형식의 `aspect_ratio`가 필요합니다. + + + + 선택적 참조 이미지입니다. 이 항목이 있으면 요청은 edits 라우트에서와 정확히 동일하게 이미지 편집으로 실행됩니다. + + + + 공개 http(s) URL 또는 `data:image/;base64,` URI입니다. JPEG, PNG, WEBP, HEIC 또는 HEIF 형식이며, 각 변은 128에서 8192 px이고 긴 변은 짧은 변의 최대 4배입니다. + + + + 모델 이름입니다. `MiniMax-H3-Image` 또는 `MiniMax-H3-Image-Highspeed`입니다. Router 호출자는 이 필드를 생략하거나 null을 보낼 수 있으며, Router가 요청 경로에 따라 선택된 모델을 채웁니다. + + + + 이미지 수입니다. 입력 토큰은 이미지당 한 번 청구됩니다. + + 범위: `1`에서 `10` + + + + `jpeg` 및 `webp`의 압축 품질이며 기본값은 95입니다. + + 범위: `0`에서 `100` + + + + 출력 이미지 형식입니다. `png`, `jpeg`, `jpg`(기본값), `webp` 중 하나입니다. + + + + 이미지에 대한 텍스트 설명입니다. `images`가 있으면 편집에 대한 설명이며, 참조 이미지는 배열 순서대로 image 1, image 2 등이 됩니다. + + + + 출력 크기이며, `auto`(기본값) 또는 `2720x1536`과 같은 `WIDTHxHEIGHT` 형식입니다. 고정 크기는 면적이 655,360에서 20,000,000 픽셀이고 가로세로 비율이 1:3에서 3:1 사이여야 하며, `aspect_ratio` 또는 `area`와 함께 사용할 수 없습니다. + + +Router가 `GET /v2/models/minimax/minimax-h3-image-highspeed/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. + +### 출력 + + + 형식: `int64` + + + + + + + + 이 이미지가 실패했거나 보류된 경우에만 존재합니다. + + + + + + + + + + + + MiniMax가 이 이미지에 사용한 프롬프트입니다. + + + + 실제 이미지 크기이며 `WIDTHxHEIGHT` 형식입니다. + + + + 생성된 이미지의 URL입니다. 만료되므로 이미지를 다운로드하세요. + + + + + + + + + + + + 성공한 이미지의 토큰 사용량입니다. 청구는 이를 기준으로 합니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## 예시 + +### 입력 + +```json +{ + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background." +} +``` + +### 출력 + +```json +{ + "created": 1794300000, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/minimax/minimax-h3-image/generated.jpg" + } + ], + "output_format": "jpeg", + "request_id": "06a1b2c3d4e5f60718293a4b5c6d7e8f", + "usage": { + "generated_images": 1, + "input_tokens": 10, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 10 + }, + "output_tokens": 1024, + "output_tokens_details": { + "image_tokens": 1024 + }, + "total_tokens": 1034 + } +} +``` + + diff --git a/ko/development/comfy-router/models/minimax/minimax-h3-image/code.mdx b/ko/development/comfy-router/models/minimax/minimax-h3-image/code.mdx new file mode 100644 index 0000000000..e1b6eb4fe4 --- /dev/null +++ b/ko/development/comfy-router/models/minimax/minimax-h3-image/code.mdx @@ -0,0 +1,324 @@ +--- +title: "Comfy Router로 MiniMax H3 Image 사용하기" +description: "Comfy Router를 통해 minimax/minimax-h3-image를 호출합니다: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." +sidebarTitle: "MiniMax H3 Image" +translationSourceHash: 1dbc0ccb +translationFrom: development/comfy-router/models/minimax/minimax-h3-image/code.mdx +translationBlockHashes: + "_intro": 21c027f1 + "Quick start": 122cc9f4 + "Schema": af54b1a6 + "Examples": b42d5c4e +--- +{/* GENERATED FILE. Generated from router-schemas/minimax/minimax-h3-image.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`minimax/minimax-h3-image`에 대한 API 레퍼런스로, Comfy Router가 MiniMax에서 제공합니다. + +**입력:** 텍스트, 이미지 · **출력:** 이미지 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다. + +**모델 ID:** `minimax/minimax-h3-image` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "minimax/minimax-h3-image", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("minimax/minimax-h3-image", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests`로 전송합니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비되면 이 프로세스든 다른 프로세스든 상관없이 수집됩니다. [대기 중인 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 방법을 단계별로 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "minimax/minimax-h3-image", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자 자체의 payload이며, models.run()이 반환하는 것과 동일한 값입니다. + # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("minimax/minimax-h3-image", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" + +# 2. status가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 200은 모델의 네이티브 출력과 함께, 202는 아직 실행 중일 때 상태 본문과 함께 반환됩니다. +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + `size`가 생략되거나 `auto`일 때의 출력 영역 레벨입니다. `1K`, `2K`, `4K` 중 하나입니다(기본값). + + + + `size`가 생략되거나 `auto`일 때의 출력 가로세로 비율입니다. `auto`(기본값) 또는 1:3에서 3:1 사이의 `X:Y` 형식이며, 예를 들어 `16:9`입니다. + + + + MiniMax의 프롬프트 향상 기능을 끕니다. 고정된 `size` 또는 `X:Y` 형식의 `aspect_ratio`가 필요합니다. + + + + 선택적 참조 이미지입니다. 이 필드가 있으면 요청은 edits 라우트에서와 정확히 동일하게 이미지 편집으로 실행됩니다. + + + + 공개 http(s) URL 또는 `data:image/;base64,` URI입니다. JPEG, PNG, WEBP, HEIC 또는 HEIF를 지원하며, 각 변은 128~8192 px이고 긴 변은 짧은 변의 최대 4배입니다. + + + + 모델 이름입니다. `MiniMax-H3-Image` 또는 `MiniMax-H3-Image-Highspeed`입니다. Router 호출자는 이 필드를 생략하거나 null을 보낼 수 있으며, Router가 요청 경로에 따라 선택된 모델을 채웁니다. + + + + 이미지 수입니다. 입력 토큰은 이미지당 한 번 청구됩니다. + + 범위: `1` ~ `10` + + + + `jpeg` 및 `webp`의 압축 품질이며 기본값은 95입니다. + + 범위: `0` ~ `100` + + + + 출력 이미지 형식입니다. `png`, `jpeg`, `jpg`(기본값), `webp` 중 하나입니다. + + + + 이미지에 대한 텍스트 설명입니다. `images`가 있으면 편집에 대한 설명이며, 참조 이미지는 배열 순서대로 이미지 1, 이미지 2 ... 입니다. + + + + 출력 크기이며 `auto`(기본값) 또는 `2720x1536`과 같은 `WIDTHxHEIGHT` 형식입니다. 고정 크기는 면적이 655,360 ~ 20,000,000 픽셀이어야 하고 가로세로 비율이 1:3에서 3:1 사이여야 하며, `aspect_ratio` 또는 `area`와 함께 사용할 수 없습니다. + + +Router가 `GET /v2/models/minimax/minimax-h3-image/openapi.json`에서 제공하는 스키마로 생성되었으며, 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 문서와 동일합니다. + +### 출력 + + + 형식: `int64` + + + + + + + + 이 이미지가 실패했거나 보류된 경우에만 존재합니다. + + + + + + + + + + + + MiniMax가 이 이미지에 사용한 프롬프트입니다. + + + + `WIDTHxHEIGHT` 형식의 실제 이미지 크기입니다. + + + + 생성된 이미지의 URL입니다. 만료되므로 이미지를 다운로드하세요. + + + + + + + + + + + + 성공한 이미지의 토큰 사용량입니다. 과금은 이를 기준으로 합니다. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## 예시 + +### 입력 + +```json +{ + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background." +} +``` + +### 출력 + +```json +{ + "created": 1794300000, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/minimax/minimax-h3-image/generated.jpg" + } + ], + "output_format": "jpeg", + "request_id": "06a1b2c3d4e5f60718293a4b5c6d7e8f", + "usage": { + "generated_images": 1, + "input_tokens": 10, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 10 + }, + "output_tokens": 1024, + "output_tokens_details": { + "image_tokens": 1024 + }, + "total_tokens": 1034 + } +} +``` + + diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index b54aa6f881..9ffc32bb73 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router에서 Grok Imagine Image 2.0 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-2.0을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: e062dc40 +translationSourceHash: a292528e translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: - "_intro": 614e2e15 + "_intro": 6a561296 "Quick start": ff9945c8 - "Schema": cb29dfae + "Schema": f435c296 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-2.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; `xai/grok-imagine-image-2.0`에 대한 API 레퍼런스입니다. 이 모델은 xAI에서 제공하며 Comfy Router가 서비스합니다. -**입력:** 텍스트 · **출력:** 이미지 +**입력:** 이미지, 텍스트 · **출력:** 이미지 ## 빠른 시작 @@ -201,6 +200,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES 최종 사용자를 나타내는 고유 식별자로, xAI가 남용을 모니터링하고 탐지하는 데 도움이 됩니다 + + xAI 엔드포인트용 입력 이미지 객체입니다 + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + + + 다중 참조 편집용 입력 이미지 목록입니다. image와 상호 배타적입니다. 이미지가 여러 개 제공된 경우 프롬프트에서 \, \ 등으로 참조하세요. + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + + + xAI 엔드포인트용 입력 이미지 객체입니다 + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + Router가 `GET /v2/models/xai/grok-imagine-image-2.0/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index 4bb3524c0c..02684f3f55 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router로 Grok Imagine Image Pro 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-pro를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: f1412f9d +translationSourceHash: 551ab410 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: - "_intro": 0da8910e + "_intro": 17b18ef8 "Quick start": 3a4bd585 - "Schema": 805c771c + "Schema": 618b5e75 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-pro.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; Comfy Router가 xAI로부터 제공하는 `xai/grok-imagine-image-pro`의 API 레퍼런스입니다. -**입력:** 텍스트 · **출력:** 이미지 +**입력:** 이미지, 텍스트 · **출력:** 이미지 xAI는 [2026년 5월 15일](https://docs.x.ai/developers/migration/may-15-retirement)에 `grok-imagine-image-pro`를 종료하고 해당 요청을 `grok-imagine-image-quality`로 라우팅했습니다. 이어서 xAI는 2026년 11월 2일에 `grok-imagine-image-quality`를 종료했습니다. 이제 요청은 `grok-imagine-image-2.0`이 낮은 품질로 처리합니다. 자세한 내용은 [xAI 마이그레이션 공지](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2)를 참조하세요. @@ -205,6 +204,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES 최종 사용자를 나타내는 고유 식별자로, xAI가 남용을 모니터링하고 탐지하는 데 도움이 됩니다 + + xAI 엔드포인트용 입력 이미지 객체 + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + + + 다중 참조 편집을 위한 입력 이미지 목록입니다. image와 상호 배타적입니다. 여러 이미지를 제공하는 경우 프롬프트에서 \, \ 등으로 참조하세요. + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + + + xAI 엔드포인트용 입력 이미지 객체 + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + Router가 `GET /v2/models/xai/grok-imagine-image-pro/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index 73d098c310..eb715f7071 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router로 Grok Imagine Image Quality 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image-quality를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 2768f32e +translationSourceHash: 1bac2ebc translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: - "_intro": 7220f036 + "_intro": 77db165f "Quick start": 799275b8 - "Schema": e2c96ff6 + "Schema": 052399f6 "Examples": 3222291b --- - {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/xai/grok-imagine-image-quality.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; -`xai/grok-imagine-image-quality`에 대한 API 레퍼런스입니다. Comfy Router가 xAI에서 제공합니다. +`xai/grok-imagine-image-quality`에 대한 API 레퍼런스입니다. xAI의 모델을 Comfy Router가 제공합니다. -**입력:** 텍스트 · **출력:** 이미지 +**입력:** 이미지, 텍스트 · **출력:** 이미지 xAI는 2026년 11월 2일에 `grok-imagine-image-quality`를 종료했습니다. 이제 요청은 `grok-imagine-image-2.0`이 낮은 품질로 처리합니다. 자세한 내용은 [xAI 마이그레이션 공지](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2)를 참조하세요. @@ -188,7 +187,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - 이미지를 반환할 응답 형식입니다. url 또는 b64_json일 수 있습니다. 이미지 결과는 어느 경우든 재호스팅된 URL로 제공되므로 Comfy는 아웃바운드 요청에서 이 값을 `url`로 강제 변환합니다. Comfy Router 디스패치(`POST /v2/models/xai/{model}`)와 이 `/proxy/` 경로 모두에서 마찬가지입니다. enum에 포함된 값은 그대로 받아들여진 뒤 무시됩니다. `url`이나 `b64_json`을 보내든, 필드를 생략하든 응답은 동일합니다. enum 밖의 값은(이어서 설명하는, 각 경로가 인식하는 UNSET 표기법을 제외하고) 두 경로 모두에서 강제 변환되지 않고 거부되며, 거부의 형태만 다릅니다. 이 `/proxy/` 라우트는 수신 시 `400`을 반환하고, `POST /v2/models/xai/{model}` Router 디스패치는 파트너 호출이 이루어지기 전에 여기에 게시된 enum에 대한 필드 단위 `422`를 반환합니다. 두 경로는 UNSET으로 간주되는 값이 서로 다릅니다. 이 `/proxy/` 라우트에서는 필드 생략, 명시적 `null`, `""` 모두 미설정을 의미하며 허용된 값과 마찬가지로 강제 변환됩니다. Router 디스패치는 게시된 enum을 엄격하게 적용하므로 `null`과 `""`는 다른 비멤버와 마찬가지로 비멤버입니다. 해당 경로에서 미설정으로 두려면 필드를 생략하세요. + 이미지를 반환할 응답 형식입니다. url 또는 b64_json일 수 있습니다. 이미지 결과는 어느 경우든 재호스팅된 URL로 제공되므로 Comfy는 아웃바운드 요청에서 이 값을 `url`로 강제 변환합니다. Comfy Router 디스패치(`POST /v2/models/xai/{model}`)와 이 `/proxy/` 경로 모두에서 마찬가지입니다. 따라서 enum에 포함된 값은 그대로 받아들여진 뒤 무시됩니다. `url`이나 `b64_json`을 보내든, 필드를 생략하든 응답은 동일합니다. enum 밖의 값은(이어서 설명하는, 각 경로가 인식하는 UNSET 표기법을 제외하고) 두 경로 모두에서 강제 변환되지 않고 거부되며, 거부의 형태만 다릅니다. 이 `/proxy/` 경로는 수신 시 `400`을 반환하고, `POST /v2/models/xai/{model}` Router 디스패치는 파트너 호출이 이루어지기 전에 여기에 게시된 enum에 대한 필드 단위 `422`를 반환합니다. 두 경로는 UNSET으로 간주되는 값이 서로 다릅니다. 이 `/proxy/` 경로에서는 필드 생략, 명시적 `null`, `""` 모두 미설정을 의미하며 허용된 값과 마찬가지로 강제 변환됩니다. Router 디스패치는 게시된 enum을 엄격하게 적용하므로 `null`과 `""`는 다른 비멤버와 마찬가지로 멤버가 아닙니다. 해당 경로에서 미설정으로 두려면 필드를 생략하세요. 가능한 값: `url`, `b64_json` @@ -205,6 +204,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE 최종 사용자를 나타내는 고유 식별자로, xAI가 남용을 모니터링하고 탐지하는 데 도움이 됩니다 + + xAI 엔드포인트용 입력 이미지 객체 + + + + 이미지 입력의 타입 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL (공개 URL 또는 base64 인코딩된 데이터 URI) + + + + 다중 참조 편집을 위한 입력 이미지 목록입니다. image와 함께 사용할 수 없습니다. 여러 이미지를 제공하는 경우 프롬프트에서 \, \ 등으로 참조하세요. + + + + 이미지 입력의 타입 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL (공개 URL 또는 base64 인코딩된 데이터 URI) + + + + xAI 엔드포인트용 입력 이미지 객체 + + + + 이미지 입력의 타입 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL (공개 URL 또는 base64 인코딩된 데이터 URI) + + Router가 `GET /v2/models/xai/grok-imagine-image-quality/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 diff --git a/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 387a7232ac..84fa0b3e8b 100644 --- a/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,23 +2,22 @@ title: "Comfy Router로 Grok Imagine Image 사용하기" description: "Comfy Router를 통해 xai/grok-imagine-image를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Grok Imagine Image" -translationSourceHash: 2e5c55ad +translationSourceHash: 892f31a7 translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: - "_intro": a2e97c88 + "_intro": 0a2a8c08 "Quick start": a5495331 - "Schema": 171da7d5 + "Schema": f924d818 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; Comfy Router가 xAI로부터 제공하는 `xai/grok-imagine-image`의 API 레퍼런스입니다. -**입력:** 텍스트 · **출력:** 이미지 +**입력:** 이미지, 텍스트 · **출력:** 이미지 ## 빠른 시작 @@ -152,7 +151,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID ### 입력 - 생성된 이미지의 비율입니다. 프롬프트에 가장 적합한 비율을 자동으로 선택하려면 기본값인 auto를 사용합니다. + 생성되는 이미지의 비율입니다. 프롬프트에 가장 적합한 비율을 자동으로 선택하려면 기본값인 auto를 사용합니다. 가능한 값: `1:1`, `3:4`, `4:3`, `9:16`, `16:9`, `2:3`, `3:2`, `9:19.5`, `19.5:9`, `9:20`, `20:9`, `1:2`, `2:1`, `auto` @@ -178,7 +177,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 생성된 이미지의 해상도입니다. 기본값은 1k입니다. + 생성되는 이미지의 해상도입니다. 기본값은 1k입니다. 가능한 값: `1k`, `2k` @@ -201,6 +200,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID 최종 사용자를 나타내는 고유 식별자로, xAI가 악용을 모니터링하고 탐지하는 데 도움이 됩니다 + + xAI 엔드포인트용 입력 이미지 객체 + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + + + 다중 참조 편집을 위한 입력 이미지 목록입니다. image와 상호 배타적입니다. 여러 이미지를 제공할 때는 프롬프트에서 \, \ 등으로 참조하세요. + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + + + xAI 엔드포인트용 입력 이미지 객체 + + + + 이미지 입력의 유형 + + 가능한 값: `image_url` + + + + 입력 이미지의 URL(공개 URL 또는 base64로 인코딩된 데이터 URI) + + Router가 `GET /v2/models/xai/grok-imagine-image/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index 69fd125904..fd8190f744 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 레퍼런스" description: "Comfy API 계약에서 생성된 모든 Comfy Router 엔드포인트, 매개변수, 응답 본문 및 오류 버킷." sidebarTitle: "API 레퍼런스" -translationSourceHash: f49adc91 +translationSourceHash: e8d9375f translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 @@ -12,7 +12,7 @@ translationBlockHashes: "Pre-flight cost estimates": 7405db0d "Result assets": 3520a8bf "Per-model input and output schemas": 61c6bde8 - "Schemas": 9738e3aa + "Schemas": 35b5a3bc --- @@ -30,6 +30,7 @@ translationBlockHashes: + {/* 생성된 파일: 손으로 편집하지 마십시오. @@ -1103,36 +1104,36 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 ### RouterBilledWorkspace -거부된 호출이 청구했을 지갑으로, `RouterErrorResponse.billed_workspace`에 표시됩니다. "어느 지갑이 비어 있는가?"라는 질문에 답하며, 호출자의 UI에서 현재 선택된 워크스페이스와 반드시 같지는 않습니다. 또한 팀 멤버가 개인 자격 증명을 사용하는 경우, 자금이 있는 팀이 열려 있더라도 여기에는 해당 멤버의 개인 지갑이 표시됩니다. `denied_reason`과 함께 표시될 때만 존재합니다. +거부된 호출이 청구했을 지갑이며, `RouterErrorResponse.billed_workspace`에 나타납니다. "어느 지갑이 비어 있는가?"라는 질문에 답합니다. 이는 호출자의 UI에서 현재 선택된 워크스페이스와 반드시 같지는 않으며, 팀 멤버가 개인 자격 증명을 사용하는 경우 자금이 있는 팀이 열려 있더라도 여기에는 해당 멤버의 개인 지갑이 표시됩니다. `denied_reason`이 있을 때만 함께 제공됩니다. **필드** - 클라우드 워크스페이스 id입니다. 레거시 레일에서는 존재하지 않습니다. + 클라우드 워크스페이스 id입니다. 레거시 레일에서는 없습니다. - `personal` 또는 `team`. 열린 문자열이므로 다른 값은 개인으로 취급하세요. + `personal` 또는 `team`입니다. 개방형 문자열이므로 다른 값은 개인으로 취급하세요. - 호출이 클라우드 워크스페이스가 아니라 호출자의 워크스페이스 이전 Metronome 고객에게 청구되는 경우 `legacy`입니다. 해당 고객은 워크스페이스 id가 없습니다. 클라우드 워크스페이스에서는 존재하지 않습니다. + 호출이 클라우드 워크스페이스가 아니라 워크스페이스 이전의 Metronome 고객에게 청구되는 경우 `legacy`입니다. 해당 고객에게는 워크스페이스 id가 없습니다. 클라우드 워크스페이스에서는 없습니다. ### RouterChargesOnPolicyRejection -이 모델에 대해 콘텐츠 정책 거부에 요금이 청구되는지 여부입니다. 알 수 없는 값은 청구될 가능성이 있는 것으로 간주하십시오. +이 모델에 대해 콘텐츠 정책 거부가 청구되는지 여부입니다. 알 수 없는 값은 청구될 가능성이 있는 것으로 간주하세요. 유형: `string` ### RouterCostEstimate -이 호출에 드는 비용을 디스패치 전에 미리 추정한 값으로, 미국 달러 기준입니다. 가격은 Comfy의 표준 정가로 책정되며, 공급자가 보고한 비용으로 청구되는 모델의 경우에는 공급자가 공개한 가격표를 기준으로 책정됩니다. 공급자 보고 방식의 경우 `source: exact`는 소수만 선택한 모델 집합에 대해서만, 그리고 공개 가격표가 금액을 완전히 결정할 때만 반환됩니다(가격을 좌우하는 모든 필드가 명시되었거나, 금액을 바꿀 수 없는 기본값으로 남아 있는 경우). 그 밖의 모든 공급자 보고 견적은 가격표가 완전히 결정할 수 있는 일부를 포함해 `estimated`입니다. 어느 경우든 실행이 끝난 뒤에는 공급자가 보고한 금액으로 청구되며, 견적에 적힌 숫자가 그대로 청구되지는 않습니다. 계약 요율이나 고객별 요율은 반영하지 않습니다. 협상된 가격이 있는 워크스페이스는 정가로 견적되고 계약 요율로 청구되며, 이때 `source: exact`는 정가 기준으로 정확하다는 뜻이지 해당 워크스페이스의 청구액이 정확하다는 뜻이 아닙니다. 최종 청구액이 아닙니다. 워크스페이스의 사용량 및 결제 기록에 정산된 청구액이 실제로 지불하는 금액입니다. 실행 후에 보고되는 `X-Comfy-Credits-Used`는 반올림된 사후 수치일 뿐 영수증이 아닙니다. `source`는 이 숫자를 얼마나 신뢰할 수 있는지를 나타냅니다. `exact`는 `amount`를 포함하고, `free`는 `amount`가 "0"이며(요율표가 이 요청을 0으로 책정함), `estimated`는 `min_amount`와 `max_amount`를 포함하고 `amount`는 없으며, `unknown`은 어느 것도 없고 `reason`을 포함합니다. `amount`가 없다고 해서 무료로 해석해서는 안 됩니다. 가격 고정이 아닙니다: `pricing_as_of`를 참고하세요. +이 호출에 비용이 얼마나 들지 디스패치 이전에 미리 추정한 값으로, 미국 달러 기준입니다. 디스패치 전에 Comfy의 표준 정가로 책정되며, 공급자가 보고한 비용으로 청구되는 모델의 경우에는 공급자가 공개한 가격표에서 책정됩니다. 공급자 보고 방식의 경우 `source: exact`는 소수의 옵트인 모델에 대해서만, 그리고 공개 가격표가 금액을 완전히 결정할 때만 반환됩니다(가격을 좌우하는 모든 필드가 명시되었거나, 금액을 바꿀 수 없는 기본값으로 남아 있는 경우). 그 밖의 모든 공급자 보고 견적은 `estimated`이며, 가격표만으로 완전히 결정될 수 있는 일부도 여기에 포함됩니다. 어느 쪽이든 실행이 완료된 후에는 공급자가 보고한 금액으로 청구되며, 견적된 숫자가 그대로 청구되지는 않습니다. 계약 또는 고객별 요율은 반영하지 않습니다. 협상된 가격이 있는 워크스페이스는 정가로 견적되고 계약 요율로 청구되며, 이때 `source: exact`는 정가 기준으로 정확하다는 뜻이지 해당 워크스페이스의 청구액이 정확하다는 뜻이 아닙니다. 최종 청구액이 아닙니다. 실제로 지불하는 금액은 워크스페이스의 사용량 및 청구 기록에 있는 정산된 청구액입니다. 실행 후에 보고되는 `X-Comfy-Credits-Used`는 반올림된 사후 수치이며 영수증이 아닙니다. `source`는 이 숫자를 얼마나 신뢰할지 알려줍니다: `exact`는 `amount`를 포함하고, `free`는 `amount` "0"(요율 카드가 이 요청을 0으로 책정)을 포함하며, `estimated`는 `min_amount`와 `max_amount`를 포함하고 `amount`는 없으며, `unknown`은 어느 것도 없이 `reason`만 포함합니다. `amount`가 없다고 해서 무료로 읽어서는 안 됩니다. 가격 고정이 아닙니다: `pricing_as_of`를 참조하세요. **필드** - `exact` | `estimated` | `free` | `unknown`이며, 그 밖의 값은 `unknown`으로 읽습니다. `exact`와 `estimated`는 모두 추정치를 나타내며, 어느 것도 최종 청구액이 아닙니다. `free`는 요율표가 이 요청을 0으로 책정했다는 뜻이므로 `amount`가 "0"입니다. `unknown`은 금액을 포함하지 않습니다. + `exact` | `estimated` | `free` | `unknown`; 그 밖의 값은 `unknown`으로 읽습니다. `exact`와 `estimated`는 모두 추정치를 나타내며, 어느 것도 최종 청구액이 아닙니다. `free`는 요율 카드가 이 요청을 0으로 책정한다는 뜻이므로 `amount`는 "0"입니다. `unknown`은 어떤 금액도 포함하지 않습니다. @@ -1140,104 +1141,102 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 - 추정 비용을 달러 단위의 십진 문자열로 나타낸 값입니다. 예: "0.04". 소수점 이하 최대 8자리까지이며 지수 표기는 쓰지 않습니다. 청구 가능한 1센트 미만 가격은 절대 "0"으로 표시되지 않으며, 오직 `free` 견적만 "0"으로 표시됩니다. `source`가 `exact` 또는 `free`일 때만 존재합니다. 최종 청구액이 아닙니다. 최종 청구액은 워크스페이스의 사용량 및 결제 기록에 정산된 금액입니다. + 달러 단위의 추정 비용을 소수 문자열로 나타낸 값입니다(예: "0.04"). 소수점 이하 최대 8자리이며 지수 표기는 없습니다. 청구 가능한 1센트 미만 가격은 "0"으로 표시되지 않으며, `free` 견적만 "0"으로 표시됩니다. `source`가 `exact` 또는 `free`일 때만 존재합니다. 최종 청구액이 아닙니다. 최종 금액은 워크스페이스의 사용량 및 청구 기록에 있는 정산된 청구액입니다. - 추정치의 하한을 달러 단위의 십진 문자열로 나타낸 값입니다. 이는 추정치일 뿐 보장된 하한이 아닙니다. 예를 들어 공급자가 요청보다 적게 반환하거나(이미지가 없는 경우 등), 과거 호출에서 학습한 통상 가격을 추정치로 쓰거나, 요청량에 따라 가격이 꾸준히 오르지 않는 경우에는 더 적게 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. + 추정치의 하한을 달러 단위 소수 문자열로 나타낸 값입니다. 이는 추정치이며 보장된 하한이 아닙니다. 예를 들어 공급자가 요청보다 적게 반환하거나(이미지가 없는 경우 등), 추정치가 과거 호출에서 학습된 일반적인 가격이거나, 가격이 요청한 수량에 따라 꾸준히 오르지 않는 경우에는 더 적게 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. - 추정치의 상한을 달러 단위의 십진 문자열로 나타낸 값입니다. 이는 추정치일 뿐 보장된 상한이 아닙니다. 예를 들어 공급자가 요청보다 많이 반환하거나(요청한 것보다 많은 이미지 등), 과거 호출에서 학습한 추정치를 쓰거나, 요청량에 따라 가격이 꾸준히 오르지 않는 경우에는 더 많이 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. + 추정치의 상한을 달러 단위 소수 문자열로 나타낸 값입니다. 이는 추정치이며 보장된 상한이 아닙니다. 예를 들어 공급자가 요청보다 많이 반환하거나(요청한 것보다 많은 이미지 등), 추정치가 과거 호출에서 학습된 것이거나, 가격이 요청한 수량에 따라 꾸준히 오르지 않는 경우에는 더 많이 청구될 수 있습니다. `source`가 `estimated`일 때만 존재합니다. - 같은 금액을 미국 센트 단위로 반올림 없이 나타낸 값으로, 계산용입니다. `amount`와 함께 존재합니다. + 동일한 금액을 미국 센트 단위로 나타낸, 반올림하지 않은 산술 계산용 값입니다. `amount`와 함께 제공됩니다. double - `min_amount`를 미국 센트 단위로 반올림 없이 나타낸 값입니다. `min_amount`와 함께 존재합니다. + `min_amount`를 미국 센트 단위로 나타낸, 반올림하지 않은 값입니다. `min_amount`와 함께 제공됩니다. double - `max_amount`를 미국 센트 단위로 나타낸 값입니다. `max_amount`와 함께 존재합니다. + `max_amount`를 미국 센트 단위로 나타낸 값입니다. `max_amount`와 함께 제공됩니다. double - 플랫폼 환산($1 = 211 크레딧)을 사용해 `amount`를 Comfy 크레딧으로 나타낸 값으로, 소수점 이하 2자리로 반올림됩니다. `exact` 견적에서 `X-Comfy-Credits-Used`가 담을 것으로 예상되는 값입니다. 이 헤더는 반올림된 사후 수치일 뿐 영수증이 아니며, 최종 금액은 워크스페이스의 사용량 및 결제 기록에 정산된 청구액입니다. + 플랫폼 환율($1 = 211 크레딧)을 사용해 `amount`를 Comfy 크레딧으로 환산한 값으로, 소수점 2자리로 반올림됩니다. `exact` 견적에 대해 `X-Comfy-Credits-Used`가 담을 것으로 예상되는 값입니다. 해당 헤더는 반올림된 사후 수치이며 영수증이 아닙니다. 워크스페이스의 사용량 및 청구 기록에 있는 정산된 청구액이 최종입니다. double - 이 견적이 대상으로 하는 공급자 구간입니다. 대기 중 제출에서는 실행될 구간을 가리킵니다. + 이 견적이 대상으로 하는 공급자 레그입니다. 대기 중 제출에서는 실제로 실행될 레그입니다. - 정규화된 Comfy Router 모델 ID인 `{provider}/{model}`로, `POST /v2/models/{provider}/{model}`에서 해당 모델을 지정하는 값과 정확히 같습니다. 따라서 호출자는 다른 무엇으로부터 다시 도출할 필요 없이 이 값을 그 경로에 그대로 끼워 넣을 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 연결한 것이며, `maxLength`는 두 값의 길이 합에 그 구분자 하나를 더한 값입니다. + 정규 Comfy Router 모델 ID인 `{provider}/{model}`입니다. `POST /v2/models/{provider}/{model}`에서 해당 모델을 지정하는 값과 정확히 동일하므로, 호출자는 다른 어떤 값에서도 다시 유도할 필요 없이 이 경로에 그대로 삽입할 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 연결한 것이며, `maxLength`는 두 값의 길이 합에 그 구분자를 더한 값입니다. 유형: [`RouterModelId`](#routermodelid) -- 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 - 이 견적을 책정한 요율표를 가져온 시점입니다. 추정치는 가격 고정이 아닙니다. 실행은 청구가 산정되는 시점에 유효한 요율로 청구되며, 이 시점의 요율이 아닙니다. 공급자가 공개한 가격표에서 가져온 `estimated` 견적(공급자가 보고한 비용으로 청구되는 모델)은 대신 그 가격표를 읽은 날짜를 담습니다. 청구 수량을 공개된 공급자 일정에서 예측한 뒤 요율표로 책정한 견적은, `exact` 답변이든 `estimated` 답변이든 해당 일정의 조회 날짜와 요율표 조회 시점 중 더 이른 쪽을 담습니다(공급자가 보고한 크레딧으로 청구되는 모델이 `estimated`인 경우입니다). 요율표를 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 요율표로도 책정할 수 없는 `not_quotable` 호출)에는 이 값이 견적이 응답된 시점입니다. + 이 견적을 책정한 요율 카드를 가져온 시점입니다. 이 추정치는 가격 고정이 아닙니다. 실행은 요율이 적용되는 시점에 유효한 요율로 청구되며, 이 시점의 요율로 청구되지 않습니다. 공급자의 공개 가격표에서 가져온 `estimated` 견적(공급자가 보고한 비용으로 청구되는 모델)은 대신 해당 가격표를 읽은 날짜를 담습니다. 청구 수량이 공급자의 공개 일정표에서 예측된 후 요율 카드로 책정되는 견적은 `exact` 답변이든 `estimated` 답변이든 해당 일정표를 읽은 날짜와 카드를 가져온 시점 중 더 이른 쪽을 담습니다(공급자가 보고한 크레딧으로 청구되는 모델이 `estimated`인 경우입니다). 요율 카드를 읽지 않은 경우(`reason: pricing_unavailable`, `byok`, 또는 어떤 카드로도 책정할 수 없는 `not_quotable` 호출)에는 이 값이 견적에 응답한 시점입니다. date-time - - `source`가 `unknown`일 때만 표시됩니다: `not_quotable`(Router는 이 호출이 실행되기 전에는 가격을 책정할 수 없습니다: 가격이 공급자가 보고하는 값에 따라 달라지거나, 요청 본문이 청구 수량을 한정하지 않는 경우입니다), `unpriced_model`(요율 카드에 이 요청의 가격이 책정되어 있지 않음), `byok`(대기 중 제출에만 해당: 실행에 자체 공급자 키를 사용하므로 Comfy는 이에 대해 아무것도 청구하지 않습니다), 또는 `pricing_unavailable`(대기 중 제출에만 해당: 요청이 접수되었을 때 요율 카드를 읽을 수 없었습니다. 이는 일시적인 상태이며, 실행에는 평소와 같이 요금이 부과됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. +`source`가 `unknown`일 때만 표시됩니다: `not_quotable` (Router가 이 호출의 실행 전 가격을 책정할 수 없음: 가격은 공급자가 회신하는 내용에 따라 달라지거나, 요청 본문이 과금 대상 수량을 한정하지 않기 때문입니다), `unpriced_model` (요율 카드가 이 요청의 가격을 책정하지 않음), `byok` (대기 중 제출에만 해당: 실행에 사용자의 공급자 키가 사용되므로 Comfy는 이에 대해 비용을 청구하지 않습니다), 또는 `pricing_unavailable` (대기 중 제출에만 해당: 요청이 접수될 때 요율 카드를 읽을 수 없었습니다. 이는 일시적인 현상이며, 실행은 평소와 같이 과금됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. ### RouterErrorResponse -인증, 액세스, 모델 조회, 할당량 및 공급자 전송 실패에 대한 오류 본문입니다. +인증, 액세스, 모델 조회, 할당량, 공급자 전송 실패에 대한 오류 본문입니다. **필드** - 실패에 대한 사람이 읽을 수 있는 설명으로, 최종 사용자에게 노출해도 안전합니다. 기계적으로 파싱하지 않습니다. 대신 `error_type`을 기준으로 분기하세요. 은퇴한 모델에 대한 `model_not_found`의 경우, 후속 모델이 기록되어 있고 호출자에게 표시된다면 `detail`은 ` was retired on ; use `로 표시되고, 그렇지 않다면 일반적인 제안 목록 대신 ` was retired on `로만 표시됩니다. 여기에 명시되는 후속 모델은 항상 호출을 다시 지정할 수 있는 라이브 카탈로그 ID입니다. 서비스 종료 날짜가 아직 미래인 모델은 은퇴한 것이 아닙니다. 해당 날짜까지 `GET /v2/models`에 계속 나열되며 계속 실행할 수 있습니다. `detail`의 나머지 부분과 마찬가지로, 이 은퇴 관련 문구는 표시용이며 호환성 보장을 수반하지 않습니다. 기계적으로 파싱하지 않는다는 규칙에 대한 두 가지 문서화된 예외가 있습니다. `POST /v2/models/{provider}/{model}`에서 `409`는 `invalid_input` 버킷을 공유하는 세 가지 서로 무관한 조건에 대해 응답되며, 오직 `detail`만이 이들을 구분합니다. `detail`이 "this request's `image` selects the edit operation"으로 시작하면 멀티파트 `model_provider` 거부이고, `detail`이 `this request resolved a BYOK credential`로 시작하면 BYOK `model_provider` 거부입니다. 둘 다 새 `Idempotency-Key`로 해소되지 않습니다. 해당 라우트에서 그 밖의 `invalid_input` `409`는 키 충돌입니다. 두 접두사는 모두 안정적인 계약 용어이며 매칭해도 됩니다. 그 외 어느 곳에서도 `detail`에 대한 분기는 호환성 보장을 수반하지 않습니다. + 최종 사용자에게 노출해도 안전한, 사람이 읽을 수 있는 실패 설명입니다. 기계적으로 파싱되지 않습니다. 대신 `error_type`으로 분기하십시오. 은퇴한 모델에 대한 `model_not_found`에서 후속 모델이 기록되어 있고 호출자에게 표시된다면 `detail`은 ` was retired on ; use `로 읽히고, 그렇지 않다면 ` was retired on `로 읽히며, 일반적인 제안 목록 대신 이렇게 표시됩니다. 여기에 명시된 후속 모델은 항상 호출을 다시 지정할 수 있는 라이브 카탈로그 ID입니다. 서비스 종료 날짜가 아직 미래인 모델은 은퇴한 것이 아닙니다. 그 모델은 `GET /v2/models`에 계속 나열되며 그 날짜까지 계속 실행할 수 있습니다. `detail`의 나머지 부분과 마찬가지로 이 은퇴 문구는 표시용이며 호환성 보장을 제공하지 않습니다. 기계적으로 파싱되지 않는다는 규칙에 대한 문서화된 두 가지 예외가 있습니다. `POST /v2/models/{provider}/{model}`에서 `409`는 `invalid_input` 버킷을 공유하는 세 가지 무관한 조건에 대해 응답되며, 오직 `detail`만이 이들을 구분합니다. "this request's `image` selects the edit operation"으로 시작하는 `detail`은 multipart `model_provider` 거부이고, `this request resolved a BYOK credential`로 시작하는 `detail`은 BYOK `model_provider` 거부입니다. 둘 다 새 `Idempotency-Key`로 해소되지 않습니다. 해당 경로에서 다른 모든 `invalid_input` `409`는 키 충돌입니다. 두 접두사 모두 안정적인 계약 용어이며 매칭에 사용할 수 있습니다. 다른 어디에서도 `detail`로 분기하는 것이 호환성 보장을 수반하지 않습니다. - Router 실패에 대한 거친, 기계 판독 가능한 버킷으로, 호출자가 본문을 파싱하지 않고 분기할 수 있도록 `X-Comfy-Error-Type` 응답 헤더에도 그대로 반영됩니다. 이 집합은 스무 개 값으로 닫혀 있습니다. 여섯 개의 요청 수준 버킷 `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits`, `model_not_found`와, 전송 수준의 `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full`, `result_expired`입니다. "닫혀 있다"는 것은 오늘 문서화된 집합을 설명하는 것이지 영원히 유지되는 한계가 아닙니다. 집합은 늘어날 것으로 예상되며, 그래서 이것이 의도적으로 `enum`이 아닌 일반 문자열입니다. 따라서 클라이언트는 알 수 없는 값을 `internal_error`로 처리해야 하며, 위 목록에 대해 빠짐없이 switch하여 다음에 추가되는 값에서 깨지는 방식이어서는 안 됩니다. + `X-Comfy-Error-Type` 응답 헤더에도 반영되어 호출자가 본문을 파싱하지 않고 분기할 수 있게 하는, Router 실패에 대한 거칠고 기계 판독 가능한 버킷입니다. 이 집합은 스무 개 값으로 닫혀 있습니다. 여섯 개의 요청 수준 버킷 `invalid_input`, `content_policy_violation`, `provider_error`, `provider_timeout`, `insufficient_credits`, `model_not_found`와, 전송 수준의 `unauthorized`, `forbidden`, `concurrency_limit_exceeded`, `client_disconnected`, `internal_error`, `deadline_exceeded`, `not_enabled`, `service_unavailable`, `rate_limited`, `cancelled`, `queue_timeout`, `request_not_found`, `queue_backlog_full`, `result_expired`입니다. "닫혀 있다"는 것은 오늘 문서화된 집합을 뜻하며 영원히 유지되는 경계가 아닙니다. 집합은 늘어날 것으로 예상되며, 그래서 이것이 의도적으로 `enum`이 아닌 평범한 문자열입니다. 따라서 클라이언트는 위 목록 전체를 빠짐없이 switch하지 말고, 인식할 수 없는 값을 `internal_error`로 취급해야 다음에 값이 추가될 때 깨지지 않습니다. 유형: [`RouterErrorType`](#routererrortype) - 모델 공급자가 요청을 거부한 이유로, 범위가 제한되고 정제된 사유입니다. `error_type`이 `invalid_input`이고 `X-Comfy-Upstream-Status`가 공급자의 `4xx` 또는 `2xx`일 때만 존재합니다. 즉, 공급자가 요청을 잘못된 형식으로 거부하면서 그 이유를 밝힌 경우입니다. 보통 그 상태 코드는 `4xx`이며, 거부된 생성을 성공 응답 봉투 안에서 보고하는 공급자의 경우에는 `2xx`입니다(BytePlus의 실패한 작업 폴링은 HTTP `200`에 사유를 본문에 담습니다). 공급자 `5xx`, 전송 실패, 콘텐츠 정책 거부, Router가 자기 자신에 대해 발생시킨 모든 거부를 포함한 다른 모든 실패에서는 존재하지 않습니다. `X-Comfy-Upstream-Detail` 헤더를 그대로 반영합니다. `invalid_input`으로 종료된 실행의 대기 중 수집(`GET /v2/models/{provider}/{model}/requests/{request_id}`)은 첫 번째 수집에서 이 필드에 동일한 사유를 담고, 그 시점에 요청에서 이를 삭제합니다. 나중의 수집은 보통 이 필드 없이 동일한 `error_type`과 `detail`로 응답하므로, 첫 번째 수집에서 읽어야 합니다. 그 읽기 요청은 두 헤더를 모두 보내지 않습니다. + `invalid_input` 거부에 대한, 길이가 제한되고 정제된 이유입니다. 동기 경로에서는 모델 공급자가 제시한 이유이며, `error_type`이 `invalid_input`이고 `X-Comfy-Upstream-Status`가 공급자의 `4xx` 또는 `2xx`일 때만 존재합니다. 즉 공급자가 요청을 잘못된 형식으로 거부하고 그 이유를 밝힌 경우입니다. 보통 그 상태는 `4xx`이고, 성공 봉투 안에서 거부된 생성을 보고하는 공급자(BytePlus의 실패한 작업 폴링은 본문에 이유가 담긴 HTTP `200`입니다)에서는 `2xx`입니다. 그 밖의 모든 실패에서는 이 필드가 없습니다. 공급자 `5xx`, 전송 실패, 콘텐츠 정책 거부, Router가 자기 자신에 대해 제기한 모든 거부를 포함합니다. 그리고 이 필드는 `X-Comfy-Upstream-Detail` 헤더를 반영합니다. `invalid_input`으로 종료된 실행의 대기 중 수집(`GET /v2/models/{provider}/{model}/requests/{request_id}`)은 첫 수집에서 같은 이유를 이 필드에 담고, 그런 다음 요청에서 이 필드를 삭제합니다. 이후 수집은 보통 같은 `error_type`과 `detail`을 이 필드 없이 응답하므로 첫 수집에서 읽어야 합니다. 그 읽기는 두 헤더 모두 보내지 않습니다. 대기 중 수집은 또한 Router가 요청을 공급자에게 보내기 전에 거부했고 그 이유를 한 문장으로 밝힐 수 있을 때 Router 자체의 이유에도 이 필드를 사용합니다. 동기 경로는 그 이유를 `detail`에 담아 응답합니다. 개별 필드를 지목하는 거부는 아무것도 담지 않습니다. - 콘텐츠 정책 거부가 어떤 입력 또는 출력에 관한 것이었는지를 Router 수준의 닫힌 어휘로 나타냅니다: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. 공급자가 모달리티를 명시하지 않은 경우에는 `input` / `output` 값만으로 어느 쪽인지 나타냅니다. `error_type`이 `content_policy_violation`이고 공급자가 거부된 대상를 기계 판독 가능한 코드로 명시한 경우에만 존재하며, 그 외에는 존재하지 않습니다. 공급자 텍스트는 결코 아닙니다. 현재 BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI, Wan의 거부와, MiniMax Router의 Nano Banana 레그에 대한 Gemini 거부에 대해 명명되며, 거부 사유가 어느 쪽에 관한 것인지 밝히지 않는 공급자는 이 필드가 비어 있습니다. `X-Comfy-Refusal-Subject` 헤더를 그대로 반영합니다. + 콘텐츠 정책 거부가 어떤 입력 또는 출력에 관한 것이었는지를 Router 수준의 닫힌 어휘로 나타냅니다: `input`, `output`, `input_text`, `input_image`, `input_video`, `input_audio`, `output_text`, `output_image`, `output_video`, `output_audio`. 공급자가 모달리티를 지목하지 않았을 때는 `input` / `output` 값만으로 어느 쪽인지를 나타냅니다. `error_type`이 `content_policy_violation`이고 공급자가 거부된 주체를 기계 판독 가능한 코드로 지목했을 때만 존재하며, 그 외에는 없습니다. 공급자 텍스트는 절대 아닙니다. 현재 BytePlus, Runway, BFL, Gemini, Veo, Vertex, xAI, Wan 거부와 MiniMax Router의 Nano Banana 레그의 Gemini 거부에 대해 명명되어 있습니다. 거부가 어느 쪽에 관한 것인지 밝히지 않는 공급자는 이 필드를 비워 둡니다. 이 필드는 `X-Comfy-Refusal-Subject` 헤더를 반영합니다. - 파트너 노드 지출 거부에 대한 빌링의 정책 분기입니다. 청구 대상 지갑이 비어 있으면 `no_funds`, 잔액 조회에서 그렇게 밝히지 않은 채 호출이 거부되면 `unspecified`입니다. `error_type`이 `insufficient_credits`이고 배포 환경이 지갑 정보를 보고하는 경우에만 존재하며, 그 외에는 존재하지 않습니다. 표시용 텍스트가 아닌 기계 판독 가능한 코드이므로, `detail`을 보여주고 분기는 이 값으로 하세요. + 파트너 노드 지출 거부에 대한 Billing의 정책 분기입니다. 청구 대상 지갑이 비어 있으면 `no_funds`, 자금 판독이 그렇게 말하지 않은 채 호출이 거부되면 `unspecified`입니다. `error_type`이 `insufficient_credits`이고 배포가 지갑 정보를 보고할 때만 존재하며, 그 외에는 없습니다. 표시 텍스트가 아닌 기계 판독 가능한 코드입니다. `detail`을 보여주고, 이 값으로 분기하십시오. - 거부된 호출이 청구했을 지갑이며, `RouterErrorResponse.billed_workspace`에 해당합니다. "어느 지갑이 비어 있는가?"에 답합니다. 호출자의 UI에서 현재 선택된 워크스페이스와 반드시 같은 것은 아니며, 팀 멤버의 개인 자격 증명은 자금이 있는 팀이 열려 있는 동안에도 여기에서 해당 개인의 개인 지갑을 가리킵니다. `denied_reason`과 함께일 때만 존재합니다. + 거부된 호출이 청구했을 지갑으로, `RouterErrorResponse.billed_workspace`에 있습니다. "어느 지갑이 비어 있는가?"에 답합니다. 반드시 호출자의 UI가 현재 선택한 워크스페이스는 아니며, 팀 멤버의 개인 자격 증명은 자금이 있는 팀이 열려 있는 동안에도 여기에 개인 지갑을 지목합니다. `denied_reason`과 함께일 때만 존재합니다. 유형: [`RouterBilledWorkspace`](#routerbilledworkspace) - - 거부된 요청이 어떤 방식으로 인증했는지를 나타냅니다: `personal_api_key`, `team_api_key`, `personal_session` 또는 `team_session`. "다른 지갑에 청구하려면 어떤 자격 증명으로 전환해야 하는가?"에 답합니다. 권한이 아니며 아무것도 부여하지 않습니다. `denied_reason`과 함께일 때만 존재합니다. +요청이 거부된 인증 방식 - `personal_api_key`, `team_api_key`, `personal_session` 또는 `team_session`. "다른 지갑으로 과금하려면 어떤 자격 증명으로 전환해야 하나?"라는 질문에 답합니다. 이는 권한이 아니며 아무것도 부여하지 않습니다. `denied_reason`과 함께 있을 때만 표시됩니다. ### RouterErrorType 기계가 읽을 수 있는 Router 오류 카테고리이며, `X-Comfy-Error-Type` 헤더로도 전송됩니다. -타입: `string` +Type: `string` ### RouterModelBilling @@ -1246,18 +1245,18 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 **필드** - 이 모델이 콘텐츠 정책을 이유로 거부한 호출이 그럼에도 호출자에게 청구되는지 여부입니다. 공급자마다 다르고, 그 차이는 호출 시점에 드러나지 않으며, 같은 호출에 대해 오류와 청구를 함께 보는 사용자는 알 방법이 없었습니다. 그래서 공급자별 통념에 맡기지 않고 호출 전에 모델별로 명시합니다. 값이 `yes`이면 동기 경로의 `content_policy_violation` 오류에 `X-Comfy-Credits-Used`가 포함될 수 있습니다. 공급자가 모델의 생성된 출력을 거부했고 Comfy가 그 거부된 생성에 대한 사용량을 기록한 경우 포함되며, 해당 수량을 담습니다. 입력 측 거부, 동일 키 재생(`Idempotent-Replayed: true`), 헤더의 소수점 두 자리로 표시하기에 너무 작은 청구에는 포함되지 않습니다. 헤더가 없는 거부는 보고되지 않은 것이지, 무료였다는 증거는 아닙니다. + 이 모델이 콘텐츠 정책상의 이유로 거부하는 호출이 그럼에도 호출자에게 청구되는지 여부입니다. 공급자마다 다르고, 그 차이는 호출 시점에는 보이지 않으며, 같은 호출에 대해 오류와 청구를 함께 본 사용자는 알 방법이 없습니다. 그래서 공급자별 속설에 맡기지 않고 호출 이전에 모델별로 명시합니다. `yes`인 경우 동기 라우트의 `content_policy_violation` 오류에 `X-Comfy-Credits-Used`가 포함될 수 있습니다. 공급자가 모델의 생성된 출력을 거부했고 Comfy가 그 거부된 생성에 대한 사용량을 기록한 경우 포함되며, 그 수량을 담습니다. 입력 측 거부, 동일 키 재전송(`Idempotent-Replayed: true`), 그리고 헤더의 소수점 두 자리로는 표시되지 않을 만큼 작은 청구에는 포함되지 않습니다. 헤더가 없는 거부는 보고되지 않는다는 것이지, 무료였다는 증거는 아닙니다. 유형: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -하나의 Comfy Router 모델에 대한 모델별 상세 정보입니다. 카탈로그 목록이 해당 모델에 대해 보고하는 모든 항목과 단일 모델 라우트에서만 제공하는 모델별 필드를 포함합니다. +Comfy Router 모델 하나에 대한 모델별 상세 정보입니다. 카탈로그 목록에서 해당 모델에 대해 보고하는 모든 항목과, 단일 모델 라우트에서만 제공되는 모델별 필드를 포함합니다. -다음으로 구성됩니다: [`RouterModelListEntry`](#routermodellistentry), [`RouterModelDetailFields`](#routermodeldetailfields). +[`RouterModelListEntry`](#routermodellistentry), [`RouterModelDetailFields`](#routermodeldetailfields)로 구성됩니다. -타입: `object` +유형: `object` ### RouterModelDetailFields @@ -1266,7 +1265,7 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 **필드** - 이 모델의 OpenAPI 문서 URL로, 입력 및 출력 스키마를 포함합니다. + 이 모델의 입력 및 출력 스키마를 포함한 OpenAPI 문서의 URL입니다. HTTPS URL, 예: `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, 최대 2048자 @@ -1275,52 +1274,52 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 `POST /v2/models/{provider}/{model}`에서 사용되는 모델 ID입니다. -Type: `string` -- 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 +유형: `string`, 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 ### RouterModelInput -모델 입력 객체입니다. 필드와 검증에 대해서는 선택한 모델의 OpenAPI 문서를 참조하세요. +모델 입력 객체입니다. 필드와 검증에 대해서는 선택된 모델의 OpenAPI 문서를 참고하세요. 유형: `object` ### RouterModelInputSchemaDocument -하나의 모델 입력과 출력을 위한 독립형 OpenAPI 문서입니다. +한 모델의 입력과 출력에 대한 독립형 OpenAPI 문서입니다. -Type: `object` +유형: `object` ### RouterModelListEntry -모델의 ID와 과금 정보입니다. +모델의 ID와 청구 정보입니다. **필드** - 정식 Comfy Router 모델 ID로, 형식은 `{provider}/{model}`입니다. 이는 `POST /v2/models/{provider}/{model}`에서 해당 모델을 지정하는 값과 정확히 일치하므로, 호출자는 다른 곳에서 값을 다시 도출할 필요 없이 이 ID를 그 경로에 그대로 넣을 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 이어 붙인 것이고, `maxLength`는 두 세그먼트 길이의 합에 구분자 하나를 더한 값입니다. + 정식 Comfy Router 모델 ID로, `{provider}/{model}` 형식입니다. `POST /v2/models/{provider}/{model}`에서 모델을 지정하는 값과 정확히 동일하므로, 호출자는 다른 곳에서 다시 유도할 필요 없이 이 값을 경로에 그대로 삽입할 수 있습니다. `pattern`은 `RouterProviderSegment`와 `RouterModelSegment`를 단일 `/`로 연결한 것이며, `maxLength`는 두 값의 길이 합에 해당 구분자 길이를 더한 값입니다. - 유형: [`RouterModelId`](#routermodelid) - 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 + 유형: [`RouterModelId`](#routermodelid) -- 모델 ID, 예: `anthropic/claude-opus-4-6`, 최대 193자 - 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `provider` 세그먼트로, 어떤 파트너의 모델을 지정하는지를 나타냅니다. 호출 경로의 `provider` 경로 매개변수와 카탈로그 항목의 `provider` 필드는 모두 이 하나의 스키마를 참조하며, 덕분에 목록에 나오는 ID와 허용되는 ID가 서로 어긋나지 않습니다. + 정식 `{provider}/{model}` 모델 ID의 소문자 `provider` 세그먼트로, 대상 모델을 제공하는 파트너입니다. 호출 라우트의 `provider` 경로 매개변수와 카탈로그 항목의 `provider` 필드가 모두 이 하나의 스키마를 참조하므로, 목록에 표시되는 ID와 허용되는 ID가 서로 어긋나지 않습니다. - 유형: [`RouterProviderSegment`](#routerprovidersegment) - 영숫자 슬러그, 예: `anthropic`, 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 - 정식 `{provider}/{model}` 모델 ID에서 소문자로 표기되는 `model` 세그먼트로, 해당 공급자 안에서 실행할 모델을 나타냅니다. 호출 경로의 `model` 경로 매개변수와 카탈로그 항목의 `model` 필드가 함께 사용하며, `RouterProviderSegment`와 같은 이유로 ID가 어긋나지 않도록 합니다. + 정식 `{provider}/{model}` 모델 ID의 소문자 `model` 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. `RouterProviderSegment`와 같은 이유로 호출 라우트의 `model` 경로 매개변수와 카탈로그 항목의 `model` 필드가 이 스키마를 공유합니다. - 유형: [`RouterModelSegment`](#routermodelsegment) - 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 - 호출하기 전에 호출자가 알아야 하는 모델별 과금 정보이며, 가격이 아닙니다. 사용량과 비용 수치는 여기에 절대 나타나지 않습니다. + 호출 전에 호출자가 알아야 하는 모델별 청구 정보입니다. 가격이 아닙니다. 사용량과 비용 수치는 여기에 나타나지 않습니다. 유형: [`RouterModelBilling`](#routermodelbilling) - 이 모델의 `GET /v2/models/{provider}/{model}/openapi.json` 문서에 대한 현재의 strong `ETag`입니다. 스키마가 변경되지 않은 동안에는 이 값을 해당 읽기 요청의 `If-None-Match`로 보내 `304`를 받을 수 있고, 또는 이전에 확인한 값과 비교하여 모든 문서를 가져오지 않고도 어떤 모델의 스키마가 변경되었는지 알 수 있습니다. 이 시점에 이 호출자에 대해 해당 읽기가 `200`을 응답하지 않는 경우에는 값이 없습니다. 즉 스키마 서비스를 사용할 수 없거나, 모델의 문서를 렌더링할 수 없거나, 응답을 생성하는 동안 모델이 이 호출자에게 사용 불가 상태가 된 경우입니다. 태그가 없다고 해서 스키마가 변경된 것은 아니므로, 현재 태그를 알려면 모델의 문서를 다시 읽으십시오. + 이 모델의 `GET /v2/models/{provider}/{model}/openapi.json` 문서에 대한 현재 강한 `ETag`입니다. 해당 읽기 요청에서 `If-None-Match`로 보내면 스키마가 변경되지 않은 동안 `304`를 받을 수 있고, 지난번에 확인한 값과 비교하면 모든 문서를 가져오지 않고도 어떤 모델의 스키마가 변경되었는지 알 수 있습니다. 이 호출자가 현재 시점에 해당 읽기 요청으로 `200` 응답을 받을 수 없는 경우에는 값이 없습니다. 즉, 스키마 서비스를 사용할 수 없거나, 모델의 문서를 렌더링할 수 없거나, 응답을 생성하는 동안 이 호출자에게 해당 모델이 더 이상 사용 가능하지 않게 된 경우입니다. 태그가 없는 것은 스키마 변경이 아닙니다. 현재 태그를 확인하려면 모델의 문서를 다시 읽으십시오. ### RouterModelListResponse @@ -1330,23 +1329,23 @@ Router 모델 카탈로그의 한 페이지입니다. **필드** - 이 페이지에 있는 모델들이며, 최대 `limit`개입니다. + 이 페이지에 있는 모델이며, 최대 `limit`개입니다. 타입: [`RouterModelListEntry`](#routermodellistentry)의 배열 - 이 페이지 이후에 또 다른 페이지가 존재하는지 여부입니다. 이 값이 참인 동안 계속 순회하세요. `data`가 짧거나 비어 있다고 해서 카탈로그의 끝이라고 추론해서는 안 됩니다. + 이 페이지 이후에 다른 페이지가 존재하는지 여부입니다. 이 값이 참인 동안 계속 진행하세요. `data`가 짧거나 비어 있다고 해서 카탈로그의 끝이라고 추론하지 마세요. - Router 목록을 가리키는 불투명한 커서입니다. 서버가 생성하며 오직 그대로 되돌려 보내는 용도로만 쓰입니다. 오프셋도, 모델 ID도 아니고, 정렬된 순서를 가지지도 않으며, 카탈로그가 재구축되면 안정적이지도 않습니다. 따라서 커서를 파싱하거나, 값을 증가시키거나, 커서가 나온 순회를 벗어나 저장하는 것은 모두 계약 범위를 벗어납니다. 오프셋 대신 커서를 쓰는 이유는 카탈로그가 계속 변하는 목록이기 때문입니다. 오프셋 순회는 순회 도중 항목이 추가되거나 삭제되면 조용히 항목을 건너뛰거나 반복하며, 호출자는 그런 일이 일어났는지 알 수 없습니다. + Router 목록을 가리키는 불투명 커서입니다. 서버에서 생성되며 오직 그대로 되돌려 전달될 뿐입니다. 즉 오프셋도, 모델 ID도 아니며, 정렬되지 않고, 카탈로그가 재구축되면 안정적이지 않습니다. 따라서 커서를 파싱하거나, 값을 증가시키거나, 커서가 나온 순회를 벗어나서 저장하는 것은 모두 계약 범위를 벗어납니다. 카탈로그가 움직이는 목록이기 때문에 오프셋 대신 커서를 사용합니다. 순회 도중 항목이 추가되거나 제거되면 오프셋 순회는 조용히 항목을 건너뛰거나 반복하며, 호출자는 그런 일이 일어났는지 알 수 없습니다. 타입: [`RouterPageCursor`](#routerpagecursor) -- `next_cursor`로 반환되는 불투명 커서, 1–512자 - 실제로 제공된 페이지 크기입니다. 최댓값을 넘는 `limit`을 요청하면 거부되지 않고 최댓값으로 제한되므로, 이 값은 요청한 값보다 작을 수 있습니다. 페이지네이션은 보낸 값이 아니라 이 숫자로 하세요. 그렇지 않으면 받지도 못한 행이 있다고 가정하게 됩니다. + 실제로 제공된 페이지 크기입니다. 최대값을 초과하는 `limit` 요청은 거부되지 않고 최대값으로 제한되므로, 이 값은 요청한 값보다 작을 수 있습니다. 페이지네이션은 보낸 값이 아니라 이 숫자를 기준으로 하세요. 그렇지 않으면 받지 못한 행이 있다고 가정하게 됩니다. 1–100 @@ -1359,142 +1358,143 @@ Router 모델 카탈로그의 한 페이지입니다. ### RouterModelSegment -`{provider}/{model}` 모델 ID의 모델 부분입니다. +`{provider}/{model}` 모델 ID에서 모델에 해당하는 부분입니다. 유형: `string`. 영숫자 슬러그(예: `claude-opus-4-6`), 최대 128자 ### RouterPageCursor -불투명한 카탈로그 커서입니다. `cursor`로 변경 없이 그대로 다시 전달하세요. +불투명한 카탈로그 커서입니다. `cursor`로 변경 없이 그대로 전달하세요. -유형: `string` -- `next_cursor`로 반환되는 불투명 커서, 1–512자 +유형: `string` -- `next_cursor`로 반환되는 불투명 커서이며, 1–512자입니다. ### RouterProviderSegment -`{provider}/{model}` 모델 ID에서 공급자 부분입니다. +`{provider}/{model}` 모델 ID에서 공급자에 해당하는 부분입니다. -타입: `string`. 영숫자 슬러그(예: `anthropic`), 최대 64자 +타입: `string` -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 ### RouterQueueCancelResponse -이 라우트가 처리한 요청을 설명하는 두 상태 코드, 즉 `202`와 `409`에 대한 취소 요청의 응답입니다. 성공 envelope와 오류 envelope를 따로 두는 대신 두 상태 모두에 하나의 본문 형태를 사용합니다. 두 상태 모두 "취소가 발견한 것"이라는 동일한 진술이며, 상태 코드마다 다른 타입을 파싱해야 하는 클라이언트는 이러한 분리에서 얻는 것이 없기 때문입니다. +이 라우트가 처리한 요청을 설명하는 두 상태, 즉 `202`와 `409`에 대한 취소 요청의 응답입니다. 성공 envelope와 오류 envelope를 따로 두지 않고 두 경우 모두 하나의 body 형태를 사용하는 이유는, 둘 다 동일한 진술, 즉 취소가 발견한 내용을 나타내기 때문이며, 상태 코드마다 다른 타입을 파싱해야 하는 클라이언트는 분리에서 얻는 이점이 없습니다. -**필드** +**Fields** - 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링, 취소, 결과 수집에 사용하는 핸들입니다. + 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 결과를 폴링하고, 취소하고, 수집할 때 사용하는 핸들입니다. - 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 + Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Up to 36 characters - 취소 요청이 발견한 것으로, 이 라우트가 실제로 처리한 요청을 설명하는 두 결과에 해당합니다. 둘 다 HTTP 상태 코드에 그대로 반영되므로 클라이언트는 어느 쪽으로든 분기할 수 있습니다. + 이 라우트가 실제로 처리한 요청을 설명하는 두 결과에 대해 취소 요청이 발견한 내용입니다. 두 결과 모두 HTTP 상태로 반영되므로 클라이언트는 어느 쪽으로든 분기할 수 있습니다. - 타입: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) + Type: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -취소 요청이 확인한 내용으로, 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 대한 것입니다. 두 결과 모두 HTTP 상태로 반영되므로 클라이언트는 둘 중 어느 것으로든 분기할 수 있습니다. +취소 요청이 확인한 내용으로, 이 라우트가 실제로 처리한 요청을 설명하는 두 가지 결과에 대한 것입니다. 두 결과 모두 HTTP 상태로도 반영되므로 클라이언트는 둘 중 하나를 기준으로 분기할 수 있습니다. -유형: `string` +타입: `string` ### RouterQueuePosition -응답이 만들어진 즉시, 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있음을 의미합니다. +응답이 생성된 즉시, 실행 대기열에서 이 요청보다 앞에 있는 요청 수입니다. 0은 이 요청이 맨 앞에 있음을 의미합니다. 타입: `integer` -- 최소 0 ### RouterQueueRequestId -대기 중인 Router 요청 하나의 식별자입니다. 호출자가 결과를 폴링하고, 취소하고, 수집할 때 사용하는 핸들입니다. +대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하며 결과를 수집할 때 사용하는 핸들입니다. -Type: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 +유형: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 ### RouterQueueStatus -대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`와 달리 이것은 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`는 실패를 분류하며 그 집합은 커질 것으로 예상되므로, 인식되지 않은 버킷을 강하게 거부하는 생성된 클라이언트는 문제가 이미 발생한 바로 그때 가장 심하게 실패할 것입니다. 이것은 생명주기이며, 나중에 네 번째 상태가 추가된 생명주기는 enum으로 선언되었든 아니든 이를 대상으로 작성된 모든 폴링 루프에 브레이킹 체인지입니다. 따라서 enum으로 선언하고, 제약 조건은 클라이언트가 볼 수 있는 곳에 명시합니다. +대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이 값은 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식되지 않은 버킷을 엄격하게 거부하는 생성된 클라이언트는 무언가가 이미 잘못된 바로 그때 가장 심하게 실패하게 됩니다. 이 값은 라이프사이클이며, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었든 아니든 그것을 대상으로 작성된 모든 폴링 루프에 호환성을 깨뜨리는 변경이 됩니다. 그래서 enum으로 선언되며, 제약은 클라이언트가 볼 수 있는 곳에 명시됩니다. 타입: `string` ### RouterQueueStatusFields -`RouterQueueStatusResponse`에서 URL 블록을 제외한 나머지 절반입니다. 대기 중인 요청 하나의 식별자, 현재 상태, 그리고 그 상태가 터미널이고 실행이 성공하지 못했을 때 그 이유를 나타내는 개략적 분류입니다. +`RouterQueueStatusResponse`에서 URL 블록을 제외한 나머지 절반입니다. 대기 중인 요청 하나의 식별자, 현재 상태, 그리고 그 상태가 터미널이면서 실행이 성공하지 못했을 때 그 이유를 나타내는 포괄적인 분류를 담습니다. **필드** - 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고, 취소하고, 결과를 수집할 때 사용하는 핸들입니다. + 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하고 결과를 수집할 때 사용하는 핸들입니다. - Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 + 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 - 대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`과 달리 이것은 닫힌 `enum`입니다. 두 스키마는 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 커질 것으로 예상되므로, 인식되지 않은 분류를 단호히 거부하는 생성된 클라이언트는 이미 뭔가 잘못된 바로 그 시점에 가장 크게 실패하게 됩니다. 이 값은 라이프사이클이고, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되든 아니든 그것을 기준으로 작성된 모든 폴링 루프에 호환성을 깨는 변경입니다. 그래서 enum으로 선언하고, 그 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. + 대기 중인 Router 요청의 상태입니다. 정확히 세 개의 값을 가지며, `RouterErrorType`와 달리 이것은 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식하지 못한 분류를 강하게 거부하는 생성된 클라이언트는 이미 무언가 잘못된 바로 그 시점에 가장 크게 실패하게 됩니다. 이쪽은 라이프사이클이며, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었든 아니든 그것을 대상으로 작성된 모든 폴링 루프에 breaking change가 됩니다. 그래서 enum으로 선언하고, 제약을 클라이언트가 확인할 수 있는 곳에 명시합니다. - Type: [`RouterQueueStatus`](#routerqueuestatus) + 타입: [`RouterQueueStatus`](#routerqueuestatus) - 응답이 구성된 그 순간을 기준으로, 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다. + 응답이 구성된 그 순간을 기준으로 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다. - Type: [`RouterQueuePosition`](#routerqueueposition) -- 0 이상 + 타입: [`RouterQueuePosition`](#routerqueueposition) -- 0 이상 - 성공하지 못한 `COMPLETED` 요청에만 존재하며, 결과 조회가 해당 실패를 반환할 때 `X-Comfy-Error-Type`에 붙이는 것과 동일한 개략적 분류를 담고 있습니다. 성공한 터미널 요청과 실패하거나 취소된 요청을 구분하는 값입니다. 두 경우 모두 별도의 터미널 상태가 없습니다. 또한 성공 시에는 null이 아니라 아예 존재하지 않으므로, 존재 여부로 분기해야 합니다. + 성공하지 못한 `COMPLETED` 요청에만 존재하며, 결과 조회가 해당 실패를 반환할 때 `X-Comfy-Error-Type`에 붙이는 것과 동일한 포괄적 분류를 담고 있습니다. 이것이 성공한 터미널 요청과 실패했거나 취소된 요청을 구분하는 기준입니다. 두 경우 모두 별도의 터미널 상태가 존재하지 않습니다. 또한 성공 시에는 null이 아니라 아예 존재하지 않으므로, 존재 여부로 분기해야 합니다. - Type: [`RouterErrorType`](#routererrortype) + 타입: [`RouterErrorType`](#routererrortype) + ### RouterQueueStatusResponse -대기 중인 요청 하나의 현재 상태로, 제출 시 반환된 것과 동일한 세 개의 URL과 함께 구성됩니다. +대기 중인 요청 하나의 현재 상태로, 제출 시 반환된 것과 동일한 세 개의 URL로 구성됩니다. [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueStatusFields`](#routerqueuestatusfields)를 구성합니다. -타입: `object` +유형: `object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse`에서 URL 블록을 제외한 나머지 절반입니다. 새 요청의 식별자와, 그 요청이 접수된 순간의 상태를 담습니다. +`RouterQueueSubmitResponse`에서 URL 블록이 아닌 나머지 절반입니다. 즉, 새 요청의 식별자와 해당 요청이 접수된 순간의 상태입니다. **필드** - 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고, 취소하고, 결과를 수집할 때 사용하는 핸들입니다. + 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 폴링하고 취소하며 결과를 수집할 때 사용하는 핸들입니다. 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 - 대기 중인 Router 요청의 상태입니다. 값은 정확히 세 가지이며, `RouterErrorType`과 달리 이 스키마는 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 앞으로 늘어날 것으로 예상되므로, 인식하지 못한 버킷을 강하게 거부하는 생성 클라이언트는 무언가가 이미 잘못된 바로 그 시점에 가장 크게 실패하게 됩니다. 반면 이 값은 생애 주기이며, 나중에 네 번째 상태를 추가하는 생애 주기는 enum으로 선언되었든 아니든 그에 맞춰 작성된 모든 폴링 루프에 호환성을 깨뜨리는 변경이 됩니다. 그래서 enum으로 선언하고, 그 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. + 대기 중인 Router 요청의 상태입니다. 값은 정확히 세 가지이며, `RouterErrorType`과 달리 이것은 닫힌 `enum`입니다. 두 스키마가 의도적으로 서로 반대 방향으로 닫혀 있기 때문입니다. `RouterErrorType`은 실패를 분류하며 그 집합은 늘어날 것으로 예상되므로, 인식되지 않은 버킷을 강하게 거부하는 생성된 클라이언트는 이미 무언가 잘못된 바로 그 시점에 가장 크게 실패하게 됩니다. 반면 이것은 라이프사이클이며, 나중에 네 번째 상태가 추가된 라이프사이클은 enum으로 선언되었든 아니든 그것을 대상으로 작성된 모든 폴링 루프에 호환성을 깨는 변경입니다. 그래서 enum으로 선언하고, 제약을 클라이언트가 볼 수 있는 곳에 명시합니다. 타입: [`RouterQueueStatus`](#routerqueuestatus) - 응답이 구성된 순간, 실행 대기열에서 이 요청보다 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다. + 응답이 구성된 순간을 기준으로, 이 요청보다 실행 대기열에서 앞에 있는 요청의 수입니다. 0이면 이 요청이 맨 앞에 있습니다. - 타입: [`RouterQueuePosition`](#routerqueueposition) -- 최소 0 + 타입: [`RouterQueuePosition`](#routerqueueposition) -- 0 이상 - 이 요청에 대한 사전 비용 추정치로, 호출자에게 비용 추정이 활성화되어 있을 때 새로 접수된 요청에 포함됩니다. 이 요청이 고정된 공급자 구간을 기준으로 산정됩니다. 실행 대기열에는 대체(fallback) 루프가 없으므로 `fallback_provider`가 실제로 실행되는 구간을 바꾸지 않습니다. 수치를 제시할 수 없을 때도 `source: unknown`과 함께 그대로 포함됩니다. 제출은 추정치 때문에 실패하지 않습니다. 멱등 재생(`Idempotent-Replayed: true`)에서는 원본 견적이 저장되지 않으므로 생략됩니다. 이는 추정치이며 최종 청구액도, 가격 고정도 아닙니다. 실행은 요금이 산정되는 시점에 유효한 요율로 청구되며, 워크스페이스의 사용량 및 결제 기록에 정산된 청구액이 최종입니다. + 이 요청에 대한 사전 비용 추정치로, 호출자에게 비용 추정치가 활성화되어 있을 때 새로 접수된 요청에 포함됩니다. 이 요청이 고정된 공급자 구간의 견적을 제시합니다(실행 대기열에는 대체 루프가 없으므로 `fallback_provider`는 실행되는 구간을 절대 바꾸지 않습니다). 수치를 제시할 수 없을 때도 이 항목은 `source: unknown`과 함께 그대로 존재하며, 제출은 추정치 때문에 실패하지 않습니다. 멱등 재생(`Idempotent-Replayed: true`)에서는 생략되는데, 원본 견적이 저장되지 않기 때문입니다. 이것은 추정치이며 최종 청구 금액도, 가격 고정도 아닙니다. 실행은 요금이 산정되는 시점에 유효한 요율로 청구되며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다. 타입: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -실행이 실행 대기열에 수락될 때 반환되는 핸들입니다. 요청의 식별 정보와 상태에, 수명 주기의 나머지 부분을 처리하는 세 개의 URL을 결합한 것입니다. +실행이 실행 대기열에 승인될 때 반환되는 핸들로, 요청의 식별자와 상태에 나머지 수명 주기를 처리하는 세 개의 URL을 결합한 것입니다. -[`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields)로 구성됩니다. +[`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields)를 구성합니다. -타입: `object` +Type: `object` ### RouterQueueUrls -대기 중인 요청 하나의 남은 수명 동안 사용할 세 개의 URL입니다. 클라이언트가 실행 대기열 URL을 직접 구성하지 않도록, 활성 핸들을 포함하는 모든 응답에서 반환됩니다. +대기 중인 요청 하나의 남은 수명을 처리하는 세 가지 URL로, 활성 핸들을 포함하는 모든 응답에서 반환되므로 클라이언트가 실행 대기열 URL을 직접 구성할 필요가 없습니다. **필드** @@ -1505,7 +1505,7 @@ Type: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0- - 이 요청의 결과를 가져오는 절대 URL입니다. + 이 요청의 결과를 수집하는 절대 URL입니다. URI @@ -1518,18 +1518,18 @@ Type: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0- ### RouterValidationErrorContext -실패한 검증 규칙에 대해 공급자가 제공한 세부 정보입니다. +검증에 실패한 규칙에 대해 공급자가 제공한 세부 정보입니다. 유형: `object` ### RouterValidationErrorDetail -필드 수준의 검증 실패 하나를 나타냅니다. +하나의 필드 수준 검증 실패입니다. **필드** - 문제가 발생한 필드까지의 경로이며, 가장 바깥 세그먼트가 먼저 옵니다. 예를 들어 `["body", "image_url"]` 또는 정수가 배열의 인덱스를 가리키는 `["body", "images", 0]`과 같습니다. + 문제가 된 필드의 경로이며, 가장 바깥쪽 세그먼트가 먼저 옵니다. 예를 들어 `["body", "image_url"]` 또는 `["body", "images", 0]`처럼 배열을 정수로 인덱싱하는 경우도 있습니다. @@ -1537,28 +1537,28 @@ Type: `string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0- - 이 실패의 구체적이고 기계가 읽을 수 있는 사유이며, 공급자로부터 변경 없이 그대로 전달됩니다. 타입이 지정된 SDK 예외 계층이 분기하는 값이 바로 이것이며, 응답 헤더의 `error_type`은 그저 이를 묶은 상위 범주일 뿐입니다. + 이 실패에 대한 구체적이고 기계가 읽을 수 있는 사유로, 공급자로부터 변경 없이 그대로 전달됩니다. 타입이 지정된 SDK 예외 계층이 분기하는 값이 바로 이 값이며, 응답 헤더의 `error_type`은 그저 이를 크게 묶은 범주일 뿐입니다. - 하나의 `RouterValidationErrorDetail`에서 위반된 경계 값으로, 공급자로부터 그대로 전달됩니다. 예를 들어 `greater_than`과 함께 오는 `{"limit_value": 8}`, `image_too_small`과 함께 오는 `{"min_width": 512}`, `file_too_large`와 함께 오는 `{"max_size_bytes": 10485760}`과 같습니다. 키 집합은 공급자와 오류 타입에 따라 달라지므로, 이 객체는 의도적으로 열린 객체입니다. 고정된 필드 목록으로 좁히거나 `msg` 문자열에 합쳐 버리면, 이식된 통합이 컴파일은 되지만 해당 경계를 읽던 분기를 조용히 잃게 되는 바로 그 원인이 됩니다. 오류 타입에 경계 값이 없는 경우에는 존재하지 않습니다. + 하나의 `RouterValidationErrorDetail`에 대해 위반된 제한값으로, 공급자로부터 그대로 전달됩니다. 예를 들어 `greater_than`과 함께 오는 `{"limit_value": 8}`, `image_too_small`과 함께 오는 `{"min_width": 512}`, 또는 `file_too_large`와 함께 오는 `{"max_size_bytes": 10485760}` 등입니다. 키 집합은 공급자와 오류 타입에 따라 달라지므로, 이 객체는 의도적으로 열린 객체입니다. 고정된 필드 목록으로 좁히거나 `msg` 문자열에 합쳐 버리면, 이식된 통합이 컴파일은 되지만 제한값을 읽던 분기를 조용히 잃게 되는 바로 그 원인이 됩니다. 오류 타입에 제한값이 없으면 생략됩니다. 타입: [`RouterValidationErrorContext`](#routervalidationerrorcontext) - 문제가 된 입력 값으로, 호출자가 `loc`에서 다시 추론하지 않고도 무엇이 거부되었는지 볼 수 있도록 그대로 되돌려 전달됩니다. 문자열, 숫자, 논리값, 배열, 객체 또는 null 등 모든 JSON 타입이 될 수 있으므로, 이 스키마는 객체로 좁히지 않고 의도적으로 타입을 지정하지 않은 상태로 둡니다. 공급자가 입력을 되돌려 전달하지 않는 경우에는 존재하지 않습니다. + 문제가 된 입력값으로, 호출자가 `loc`에서 다시 도출하지 않고도 무엇이 거부되었는지 볼 수 있도록 그대로 되돌려 줍니다. 문자열, 숫자, 논리값, 배열, 객체, null 등 어떤 JSON 타입이든 될 수 있으므로, 이 스키마는 객체로 좁히지 않고 의도적으로 타입을 지정하지 않은 상태로 둡니다. 공급자가 입력값을 되돌려 주지 않으면 생략됩니다. 타입: [`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -공급자가 포함한 경우, 거부된 입력 값입니다. +공급자가 해당 값을 포함하는 경우, 거부된 입력 값입니다. ### RouterValidationErrorResponse -`422` 검증 오류 본문입니다. 카테고리는 `X-Comfy-Error-Type`을 확인하세요. +`422` 검증 오류 본문입니다. 카테고리를 확인하려면 `X-Comfy-Error-Type`을 읽으세요. **필드** diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index 6c8bb4f029..351d18613a 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 的能力与限制" sidebarTitle: "能力与限制" description: "选择 Comfy Router 还是合作伙伴代理,为长时间运行的调用做好规划,并了解恢复、速率限制与资产存储。" -translationSourceHash: fbb54868 +translationSourceHash: a81b3bd9 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": cca3ca82 + "Models without a pre-flight estimate": e7d7524a "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -30,6 +30,7 @@ translationBlockHashes: + Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个已排队的请求运行:你提交请求,稍后再收集结果。当你的应用能够等待一个已完成的结果,或稍后收集结果,并且能够处理模型自身的输入和输出字段时,就使用它。 ## Router 支持的功能 @@ -123,7 +124,7 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` -- **minimax**: `minimax/minimax-gpt-image-2` +- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index 542ef95afe..7ea320b28f 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router 模型" sidebarTitle: "所有模型" description: "Comfy Router 提供的全部模型,按提供方分组,并列出每个模型的输入和输出模态。" -translationSourceHash: 04ecf050 +translationSourceHash: df7e65a1 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 2dfd8d42 + "Find by output": 4d100975 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -26,7 +26,7 @@ translationBlockHashes: "Luma": 8cd2a7ce "Luma 2": 585eb637 "Meshy": 67e26a17 - "MiniMax": 87560ab7 + "MiniMax": 63f02c44 "Moonvalley": 9e63fb77 "OpenAI": 8652024f "Openrouter": a4f6806b @@ -42,13 +42,14 @@ translationBlockHashes: "Veo": 4ccdb46f "Wan": e4d5aff5 "WaveSpeed": be89e7f0 - "xAI": e1706271 + "xAI": 38a131b8 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 Router 目录生成。 */} 以下每个模型都由同一条路由提供服务:`POST /v2/models/{provider}/{model}`,并使用该模型自身的 JSON 请求体。每个页面都会展示在 Python、TypeScript 和 cURL 中可用的请求示例。关于模型发现、schema、错误、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api)。 @@ -110,8 +111,7 @@ translationBlockHashes: - [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code):`runway/gen4_turbo` - [Sync 3](/zh/development/comfy-router/models/synclabs/sync-3/code):`synclabs/sync-3` - [Clean Audio Video](/zh/development/comfy-router/models/veed/clean-audio-video/code):`veed/clean-audio-video` -- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0` -- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` +- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0`- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` - [Video Background Removal Fast](/zh/development/comfy-router/models/veed/video-background-removal-fast/code):`veed/video-background-removal-fast` - [Video Background Removal Green Screen](/zh/development/comfy-router/models/veed/video-background-removal-green-screen/code):`veed/video-background-removal-green-screen` - [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal` @@ -143,7 +143,7 @@ translationBlockHashes: - [Grok Imagine Video](/zh/development/comfy-router/models/xai/grok-imagine-video/code):`xai/grok-imagine-video` - + - [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code):`beeble/switchx` - [Erase V1](/zh/development/comfy-router/models/black-forest-labs/erase-v1/code):`bfl/erase-v1` @@ -171,7 +171,7 @@ translationBlockHashes: - [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background` - [图像编辑:按文本替换对象](/zh/development/comfy-router/models/bria/image-edit-replace-object-by-text/code):`bria/image-edit-replace-object-by-text` - [图像编辑:Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` -- [图像编辑:修复](/zh/development/comfy-router/models/bria/image-edit-restore/code):`bria/image-edit-restore` +- [图像编辑:恢复](/zh/development/comfy-router/models/bria/image-edit-restore/code):`bria/image-edit-restore` - [图像](/zh/development/comfy-router/models/bria/image/code):`bria/image` - [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code):`byteplus/seedream-4-0-250828` - [Seedream 4.5 251128](/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code):`byteplus/seedream-4-5-251128` @@ -206,6 +206,8 @@ translationBlockHashes: - [Uni 1](/zh/development/comfy-router/models/luma_2/uni-1/code):`luma_2/uni-1` - [Photon 1](/zh/development/comfy-router/models/luma/photon-1/code):`luma/photon-1` - [Photon Flash 1](/zh/development/comfy-router/models/luma/photon-flash-1/code):`luma/photon-flash-1` +- [MiniMax H3 Image Highspeed](/zh/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code):`minimax/minimax-h3-image-highspeed` +- [MiniMax H3 Image](/zh/development/comfy-router/models/minimax/minimax-h3-image/code):`minimax/minimax-h3-image` - [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code):`openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code):`openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code):`openai/gpt-image-2.5-sunburst` @@ -214,8 +216,7 @@ translationBlockHashes: - [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code):`openai/gpt-image-2` - [Qwen Image 3.0 Pro](/zh/development/comfy-router/models/qwen/qwen-image-3-0-pro/code):`qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/zh/development/comfy-router/models/qwen/qwen-image-3-0/code):`qwen/qwen-image-3.0` -- [Recraft V2](/zh/development/comfy-router/models/recraft/recraftv2/code):`recraft/recraftv2` -- [Recraft V3](/zh/development/comfy-router/models/recraft/recraftv3/code):`recraft/recraftv3` +- [Recraft V2](/zh/development/comfy-router/models/recraft/recraftv2/code):`recraft/recraftv2`- [Recraft V3](/zh/development/comfy-router/models/recraft/recraftv3/code):`recraft/recraftv3` - [Recraft V4.1 Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code):`recraft/recraftv4_1_pro_vector` - [Recraft V4.1 Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-pro/code):`recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code):`recraft/recraftv4_1_utility_pro_vector` @@ -267,8 +268,7 @@ translationBlockHashes: - [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code):`bfl/flux-3-video` -- [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code):`byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code):`byteplus/dreamina-seedance-2-0-260128`- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code):`byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code):`byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/zh/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code):`byteplus/seed-audio-1.0-multilingual` @@ -325,8 +325,7 @@ translationBlockHashes: - [Rigging](/zh/development/comfy-router/models/meshy/rigging/code):`meshy/rigging` - [Stable Fast 3D](/zh/development/comfy-router/models/stability/stable-fast-3d/code):`stability/stable-fast-3d` - [Stable Point Aware 3D](/zh/development/comfy-router/models/stability/stable-point-aware-3d/code):`stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/zh/development/comfy-router/models/tencent/hunyuan-3d-part/code):`tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Part](/zh/development/comfy-router/models/tencent/hunyuan-3d-part/code):`tencent/hunyuan-3d-part`- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology` - [Hunyuan 3D Texture Edit](/zh/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code):`tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/zh/development/comfy-router/models/tencent/hunyuan-3d-uv/code):`tencent/hunyuan-3d-uv` @@ -609,6 +608,8 @@ translationBlockHashes: | 模型 | ID | 输入 | 输出 | | --- | --- | --- | --- | +| [MiniMax H3 Image Highspeed](/zh/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | 文本, 图像 | 图像 | +| [MiniMax H3 Image](/zh/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | 文本, 图像 | 图像 | | [MiniMax H3](/zh/development/comfy-router/models/minimax/minimax-h3/code) | `minimax/minimax-h3` | 文本, 图像 | 视频 + 音频 | ## Moonvalley @@ -810,11 +811,11 @@ translationBlockHashes: | 模型 | ID | 输入 | 输出 | | --- | --- | --- | --- | -| [Grok Imagine Image 2.0](/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code) | `xai/grok-imagine-image-2.0` | 文本 | 图像 | -| [Grok Imagine Image Pro](/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code) | `xai/grok-imagine-image-pro` | 文本 | 图像 | -| [Grok Imagine Image Quality](/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code) | `xai/grok-imagine-image-quality` | 文本 | 图像 | -| [Grok Imagine Image](/zh/development/comfy-router/models/xai/grok-imagine-image/code) | `xai/grok-imagine-image` | 文本 | 图像 | -| [Grok Imagine Video 1.5 Lite](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code) | `xai/grok-imagine-video-1.5-lite` | 文本, 图像 | 视频 | -| [Grok Imagine Video 1.5 Preview](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code) | `xai/grok-imagine-video-1.5-preview` | 文本, 图像 | 视频 | -| [Grok Imagine Video 1.5](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5/code) | `xai/grok-imagine-video-1.5` | 文本, 图像 | 视频 | -| [Grok Imagine Video](/zh/development/comfy-router/models/xai/grok-imagine-video/code) | `xai/grok-imagine-video` | 文本, 图像 | 视频 | +| [Grok Imagine Image 2.0](/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code) | `xai/grok-imagine-image-2.0` | 图像、文本 | 图像 | +| [Grok Imagine Image Pro](/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code) | `xai/grok-imagine-image-pro` | 图像、文本 | 图像 | +| [Grok Imagine Image Quality](/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code) | `xai/grok-imagine-image-quality` | 图像、文本 | 图像 | +| [Grok Imagine Image](/zh/development/comfy-router/models/xai/grok-imagine-image/code) | `xai/grok-imagine-image` | 图像、文本 | 图像 | +| [Grok Imagine Video 1.5 Lite](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code) | `xai/grok-imagine-video-1.5-lite` | 文本、图像 | 视频 | +| [Grok Imagine Video 1.5 Preview](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code) | `xai/grok-imagine-video-1.5-preview` | 文本、图像 | 视频 | +| [Grok Imagine Video 1.5](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5/code) | `xai/grok-imagine-video-1.5` | 文本、图像 | 视频 | +| [Grok Imagine Video](/zh/development/comfy-router/models/xai/grok-imagine-video/code) | `xai/grok-imagine-video` | 文本、图像 | 视频 | diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 763dfe84b5..33eb25b254 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "使用 Dreamina Seedance 2.0 260128 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-260128:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 70ec471f +translationSourceHash: a3a29c99 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 8c0478c9 + "Schema": 9c7c68b7 "Examples": 641c458b --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-260128.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -197,33 +198,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 输入 - 已忽略。仅为兼容 BytePlus 的请求结构而接受,但在提交任务前会被移除,因此不会发送任何回调;请改为轮询任务状态接口获取结果。 + 忽略。仅为兼容 BytePlus 的请求形状而接受,但在任务提交之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 格式:`uri` - 模型用于生成视频的输入内容 + 供模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。只有 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开 URL(wav, mp3)。 -Base64:格式 data:audio/\;base64,\ -资产 ID:格式 asset://\ +音频 URL:音频的公开 URL(wav、mp3)。 +Base64:格式为 data:audio/\;base64,\ +资产 ID:格式为 asset://\ 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;不要再次发送这些内容。resolution 默认为且仅支持 1080p。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;不要再次发送这些内容。在该请求上设置最终视频输出档位的分辨率,包括 4k;省略时最终视频为 1080p。 - 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 + 创建 Draft 视频时将 `draft` 设为 true 所返回的任务 ID。 @@ -232,9 +233,9 @@ Base64:格式 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片 URL:确保图像 URL 可访问。 +图像 URL:请确保图像 URL 可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式 asset://\ +资产 ID:格式为 asset://\ @@ -243,99 +244,97 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能的值:`first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型的输入文本信息。包括文本提示词和可选参数。 + 模型的输入文本信息。包含文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[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) +参数(可选):在文本提示词之后添加 --[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)。 -它按字符而非字节计数,因此多字节提示词在传输时可能达到该大小的数倍。它只限制这一个字段,而不是整个请求:`content` 是数组,真正限制整个文档的是每个请求的正文大小上限。执行该限制的是 Comfy Router (/v2/models/byteplus/\{model});直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器响应。该值设置得远高于真实流量,因此它不会对真实提示词进行判定;如果调用方需要更多,请调高该值。 +Comfy 侧的防护限制,而非 BytePlus 的约束。BytePlus 未公布文本长度限制,在测试中曾接受 40,000 个字符(2026-09-17)。它按字符而非字节计数,因此多字节的提示词在传输时可能是该大小的数倍。它约束的是这一个字段,而不是整个请求:`content` 是数组,整个文档由每请求的请求体限制来约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器给出回应。该值设置得远高于真实流量,因此它永远不会对真正的提示词作出裁决;如果调用方需要更多,可以提高该值。 输入内容的类型 - 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 + 输入视频对象。只有 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 视频 URL 或资产 ID。 -视频 URL:视频的公开 URL(mp4, mov)。 -资产 ID:格式 asset://\ +视频 URL:视频的公开 URL(mp4、mov)。 +资产 ID:格式为 asset://\ - 仅 Seedance 2.5。生成 480p Draft 视频;resolution 必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 放入 `draft_task` 内容项中即可渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - 任务超时阈值(秒)。默认 172800(48h)。范围:[3600, 259200]。 + 任务超时阈值,单位为秒。默认 172800(48h)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 + Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持该参数。生成的视频是否包含与画面同步的音频。 true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -对于支持该参数的模型,提供商会将已生成的音轨与视频分开进行内容检查;此处的拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能会间歇性出现。如果发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 +false:模型输出无声视频。在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容检查;此处的拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能间歇性出现。如果发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(已排队的请求还无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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 拒绝任何其他值以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 + 要调用的模型 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 拒绝。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略该参数。 - 仅适用于 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅限 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`,`mov` + 可能的值:`mp4`、`mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧 / 首末帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini 以及 1.5 pro 默认:adaptive。 +Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`,`4:3`,`1:1`,`3:4`,`9:16`,`21:9`,`9:21`,`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 +注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可选值:`480p`,`720p`,`1080p`,`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` - 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将该参数设置为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 + 是否返回所生成视频的最后一帧图像。 +true: 返回所生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与所生成的视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回所生成视频的最后一帧图像。 @@ -345,55 +344,55 @@ false: 不返回已生成视频的最后一帧图像。 - 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 处理所使用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`,`flex` + 可能的值:`default`、`flex` - 已生成的视频是否包含水印。 + 生成的视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 +本文档根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 视频生成任务完成后的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回最后一帧时该帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储上;此处的其他所有字段都是 BytePlus 自己的。可为空:BytePlus 会在任务之后 24 小时清除这些 URL,而之后轮询一个已成功的文档时,可能遇到 `content` 缺失或为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL;当 BytePlus 返回时,还包含其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储;这里的其他所有字段都来自 BytePlus 自身。可为空:BytePlus 会在任务 24 小时后清除这些 URL,之后轮询到的已完成文档中,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是两者都失败时的最后回退手段。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时有效期为 24 小时,并从 23 小时备忘记录中重放,所以之后的轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段改为保留 BytePlus 自己的 URL,BytePlus 会在任务之后 24 小时清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是存储 URL。 + 已生成视频最后一帧的下载 URL;当请求设置了 `return_last_frame` 时返回。不要从此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并依据上游的 Content-Type 或内容嗅探来确定其类型;`image/jpeg` 只是两者都失败时的最后兜底方案。Router 会把最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,所以稍后轮询可能返回一个最短只剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 - 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 中时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参阅顶层 `output_format` 字段,Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 内。Seedance 模型更常将其作为 `content` 的顶层同级字段返回;参见顶层的 `output_format` 字段,Router 会读取两者中出现的那个。 - 上游 URL 停止工作的 RFC 3339 时间:最早签名时间加上这些 URL 自身携带的有效期,当存在 `updated_at` 时,它绝不晚于任务的 `updated_at` 加 24 小时(即 BytePlus 文档中说明的 URL 有效期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才出现;当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + 上游 URL 失效的 RFC 3339 时间:即 URL 自身携带的最早签名时间加上有效期;当存在 `updated_at` 时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档说明的 URL 有效期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时才会出现;当两个来源都没有提供时间时则省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 - Format: `date-time` + 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,会与重新托管的 `last_frame_url` 一起逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,一旦 BytePlus 清除它就会缺失,并且在 `upstream_expires_at` 之前是持有者凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前是 bearer 凭据。 - BytePlus 自己的输出视频下载 URL,会与重新托管的 `video_url` 一起逐字节原样返回。仅对由 Comfy 已在服务器端选择加入的工作区轮询的 Seedance 2.x 任务存在(没有请求参数);对其他所有情况都缺失,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥);一旦 BytePlus 在生成后 24 小时清除其 URL,也会缺失。它是对象存储预签名 URL,因此是持有者凭证:任何持有它的人都可以在过期前下载视频,所以请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次由 Router 自己的重新托管操作消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅对由 Comfy 已在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务存在(没有请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭据(例如未限定到某个工作区的传统 API 密钥);并且在生成 24 小时后 BytePlus 清除其 URL 后也缺失。它是一个预签名对象存储 URL,因此也是 bearer 凭据:任何持有它的人都能在过期前下载视频,所以应将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时有效期为 24 小时,并从 23 小时备忘记录中重放,所以之后的轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段改为保留 BytePlus 自己的 URL,BytePlus 会在任务之后 24 小时清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是存储 URL。 + 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,所以稍后轮询可能返回一个最短只剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 - 任务创建时间。该值为以秒为单位的 UNIX 时间戳。 + 任务创建的时间。该值为以秒为单位的 UNIX 时间戳。 - 已生成视频的时长,单位为秒。声明为数字而不是整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同类接口报告小数时长,因此客户端不得假定该值为整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而不是 integer,是因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同类接口会上报小数时长,因此客户端不应假定为整数值。这是 BytePlus 自己的字段,在已成功的视频任务中返回并原样转发。 @@ -401,37 +400,36 @@ false: 不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误代码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个错误码家族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他代码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略家族,而不会覆盖传输故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 标识内容策略拒绝。一个错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会识别 HTTP 400 错误响应包和 HTTP 200 失败任务响应中的策略错误族,但不会覆盖传输故障。 报错信息 - - 视频生成任务的 ID +视频生成任务的 ID - 任务所使用的模型名称和版本 + 任务使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是由此返回该字段。这是 BytePlus 自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回,Seedance 视频任务查询会在此处返回该字段。这是 BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。 - 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。 格式:`int64` - 任务状态 + 任务的状态 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 5ab516fef8..8d8f8e47b3 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 Dreamina Seedance 2.0 Fast 260128" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-fast-260128:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: 8036f4db +translationSourceHash: 506a7f86 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": 90b60b2e + "Schema": 48fe2811 "Examples": 7714eccd --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -182,33 +183,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 输入 - 会被忽略。为兼容 BytePlus 的请求结构而接受,但在任务提交之前会被移除,因此不会发送任何回调;请改为轮询任务状态路由来获取结果。 + 已忽略。为兼容 BytePlus 的请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` - 供模型生成视频的输入内容 + 用于模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 个图像或视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 - 音频网址、Base64 编码或资产 ID。 -音频网址:音频的公开网址(wav、mp3)。 + 音频 URL、Base64 编码或资产 ID。 +音频 URL:音频的公开 URL(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ - 仅 Seedance 2.5 适用。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为且仅支持 1080p。 + 仅限 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。请在此请求中设置 resolution,以指定最终视频的输出档位,包括 4k;省略时最终视频为 1080p。 - 在 `draft` 设置为 true 的情况下创建 Draft 视频时返回的任务 ID。 + 创建 Draft 视频时 `draft` 设置为 true 所返回的任务 ID。 @@ -216,7 +217,7 @@ Base64:格式为 data:audio/\;base64,\ - 用于图生视频生成的图像内容(当 type 为 "image_url" 时) + 用于图生视频的图像内容(当 type 为 "image_url" 时) 图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -224,36 +225,38 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 内容项的角色/位置。 -图像:first_frame、last_frame 或 reference_image。 -视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 -音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于图像:first_frame、last_frame 或 reference_image。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 供模型使用的输入文本信息。包含文本提示词和可选参数。 + 模型的输入文本信息。包括文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词之后添加 --[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) +参数(可选):在文本提示词后添加 --[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” +示例:“美丽的风景 --ratio 16:9 --resolution 720p --duration 5” -这是 Comfy 侧的防护措施,而非 BytePlus 的限制。BytePlus 未公布文本长度上限,并在测试中接受了 40,000 个字符(2026-09-17)。它按字符而非字节计数,因此一个多字节的提示词在传输时可能达到该大小的数倍。它约束的是这一个字段,而不是整个请求:`content` 是一个数组,整个文档由每个请求的请求体上限来约束。执行该限制的是 Comfy Router(/v2/models/byteplus/\{model});在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器应答。该上限设置得远高于真实流量,因此它从不对真实的提示词作出裁决:如果调用方需要更多,可以提高该值。 +Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,并在测试中接受过 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此多字节提示词在网络传输时可能达到此大小的数倍。它限制的是这一个字段,而不是整个请求: +`content` 是数组,整个文档由每个请求的请求体限制来约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器响应。该值设置得远高于真实流量,因此它从不会对真实提示词作出裁决;如果调用方需要更多,可以提高该值。 输入内容的类型 - 可选值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -261,74 +264,75 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 视频网址或资产 ID。 -视频网址:视频的公开网址(mp4、mov)。 + 视频 URL 或资产 ID。 +视频 URL:视频的公开 URL(mp4、mov)。 资产 ID:格式为 asset://\ - 仅 Seedance 2.5 适用。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅限 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 放入 `draft_task` 内容项中,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 - 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 + 视频时长(秒)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 可能值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - 任务超时阈值,单位为秒。默认值为 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true: 模型输出带同步音频的视频。 -false: 模型输出无声视频。在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容检查;如果此处被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种拒绝可能间歇性出现。如果发生这种情况,请为静音视频发送 `false`;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其标识为 `refusal_subject: output_audio`(已排队请求尚无法标识它)。Seedance 2.5 的最终渲染会从它的 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 +true: 模型输出包含同步音频的视频。 +false: 模型输出无声视频。 +在支持该功能的模型上,生成的音轨由提供商单独于视频进行内容检查;那里的拒绝会以 `content_policy_violation` 报告,并且由于每次运行音频都不同,对于提供商原本接受的输入,这种拒绝可能间歇出现。如果发生这种情况,请为静音视频传入 `false`;仅当音频就是被拒绝的模态时这才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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 拒绝任何其他值以及省略它的请求。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段中填充它,因此 Router 调用方会省略它。 + 要调用的模型 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 拒绝任何其他值以及省略该字段的请求。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 仅限 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件更大。 + 仅 Seedance 2.5 支持。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 可能的值:`mp4`、`mov` - 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的比例,因此仅接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 和 pro-fast 默认值:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +true: 返回已生成视频的最后一帧图像。将此参数设为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 false: 不返回已生成视频的最后一帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 范围:`-1` 到 `4294967295` - 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 可能的值:`default`、`flex` @@ -337,38 +341,38 @@ false: 不返回已生成视频的最后一帧图像。 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前验证调用所依据的同一份文档。 +根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 视频生成任务完成后得到的输出,包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他字段都是 BytePlus 自己的。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,之后轮询到的成功文档可能不带 `content`,或其为 null。 + 视频生成任务完成后返回的输出,包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务 24 小时后清除这些 URL,此后轮询一份已成功的文档时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据该 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定类型,`image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写该字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从一条 23 小时的缓存记录中重放,因此更晚的轮询可能拿到只剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它。无论哪种方式链接都会过期,因此请下载该帧,而不要存储 URL。 + 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会把最后一帧重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以较晚的轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务 24 小时后清除它。无论哪种情况链接都会过期,因此请下载该帧,而不是保存 URL。 - 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段,Router 会读取两者中存在的那一个。 + 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将它作为 `content` 的顶层同级字段返回,见顶层 `output_format` 字段;Router 会读取两者中存在的那个。 - 上游 URL 失效的 RFC 3339 时间:由这些 URL 自身携带的最早签名时间加有效期得出,当 `updated_at` 存在时不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记载的 URL 生存期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时才存在,当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生存期无关。 + 上游 URL 失效的 RFC 3339 时间:URL 自身携带的最早签名时间加上有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记载的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才存在,当两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并排逐字节返回,适用条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不存在,并且在 `upstream_expires_at` 之前属于 bearer 凭证。 + BytePlus 自有的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列原样返回,条款与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,且在 `upstream_expires_at` 之前属于 bearer 凭证。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并排逐字节返回。仅当任务是由 Comfy 在服务端选择加入的工作区轮询的 Seedance 2.x 任务时才存在(没有请求参数);对其他所有情况都不存在,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在生成 24 小时后 BytePlus 清除其 URL 后也不存在。它是一个预签名的对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都能在它过期前下载视频,所以要像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 + BytePlus 自有的输出视频下载 URL,与重新托管的 `video_url` 并列原样返回。仅在由 Comfy 已在服务器端选择加入的工作区轮询的 Seedance 2.x 任务中出现(没有请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此属于 bearer 凭证:任何持有它的人都能在过期前下载视频,所以请把它当作机密对待。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写该字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从一条 23 小时的缓存记录中重放,因此更晚的轮询可能拿到只剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上将其限制为 100 次下载。无论哪种方式链接都会过期,因此请下载视频,而不要存储 URL。 + 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以较晚的轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况链接都会过期,因此请下载视频,而不是保存 URL。 @@ -376,7 +380,7 @@ false: 不返回已生成视频的最后一帧图像。 - 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这方面并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同级接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 + 生成视频的时长,单位为秒。声明为 number 而不是 integer,是因为 BytePlus 在这一点上并不一致:已观察到视频任务返回整秒,而同系列的其他 BytePlus 接口会反馈小数时长,因此客户端不应假定该值为整数。这是 BytePlus 的自有字段,在成功的视频任务上返回并原样转发。 @@ -384,31 +388,30 @@ false: 不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一个族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放的字符串,而非枚举:其他错误码描述验证失败和提供商失败。Router 会在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略族,但不会覆盖传输层失败。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某一族错误码可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商失败。Router 会在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略族,而不会覆盖传输层失败。 报错信息 - - 视频生成任务的 ID +The ID of the video generation task - 任务所使用的模型名称和版本 + 该任务所使用的模型名称与版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询会在此处返回该字段。BytePlus 自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的兄弟字段返回:Seedance 视频任务查询正是在此返回该字段。这是 BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 - 任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 格式:`int64` @@ -424,7 +427,7 @@ false: 不返回已生成视频的最后一帧图像。 - 本次请求的 token 用量 + 该请求的 token 用量 @@ -432,7 +435,7 @@ false: 不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认值为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认值为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index d1474a43f1..f4f2c54c93 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,18 +2,19 @@ title: "通过 Comfy Router 使用 Dreamina Seedance 2.0 Mini" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-mini:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: a1d75c67 +translationSourceHash: 69e65942 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": ebf1fc3a + "Schema": 51a6f44e "Examples": db01067e --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-mini.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -182,33 +183,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 输入 - 忽略。为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 + 已忽略。为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 格式:`uri` - 供模型生成视频的输入内容 + 供模型生成视频的输入内容。 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 张图像或视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 - 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开 URL(wav、mp3)。 -Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ + 音频网址、Base64 编码或资产 ID。 +音频网址:音频的公开网址(wav、mp3)。 +Base64:格式 data:audio/\;base64,\ +资产 ID:格式 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送它们。resolution 默认为且仅支持 1080p。 + 仅 Seedance 2.5 支持。用于渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。在此请求中设置最终输出档位的分辨率,包括 4k;省略该值时最终视频为 1080p。 - 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 + 在将 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 @@ -217,9 +218,9 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:请确保图片网址可访问。 +图片网址:确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ @@ -237,24 +238,17 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 文本提示词(必填):使用中文和英文字符描述要生成的视频。 参数(可选):在文本提示词后添加 --[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) +- --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)。 -它按字符而不是字节计数,因此多字节提示词在传输时可能达到 -此大小的数倍。它限制的是这一个字段,而不是请求: -`content` 是数组,而整个文档受每请求正文限制约束。 -Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; -在直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器应答。 -设置得远高于真实流量,以便它永远不会裁决真正的提示词。如果调用方需要更多,请提高该值。 +Comfy 侧的防护措施,而非 BytePlus 的限制。BytePlus 未公布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。它按字符计数,而非字节,因此多字节提示词在传输时可能达到此大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是数组,而每次请求的请求体大小限制才是约束整个文档的界限。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;在直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器作出响应。该值设置得远高于真实流量,因此它永远不会对真实提示词进行裁决;如果调用方需要更多,请提高该值。 @@ -268,64 +262,65 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; - 视频 URL 或资产 ID。 -视频 URL:视频的公开 URL(mp4、mov)。 -资产 ID:格式为 asset://\ + 视频网址或资产 ID。 +视频网址:视频的公开网址(mp4、mov)。 +资产 ID:格式 asset://\ - 仅 Seedance 2.5。生成 480p Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 + 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 +在 `draft_task` 内容项中传入返回的任务 ID,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。Draft 任务 ID 有效期为 7 天。 - 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 + 视频时长(秒)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true: 模型输出带有同步音频的视频。 -false: 模型输出无声视频。在支持该功能的模型上,已生成的音频轨道由提供商与视频分开进行内容审核;若音频被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本接受的输入,也可能间歇性出现。若发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其命名为 `refusal_subject: output_audio`(排队中的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 + Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持此参数。生成的视频是否包含与画面同步的音频。 +true: 模型输出带同步音频的视频。 +false: 模型输出无声视频。 +在支持该功能的模型上,提供商会对生成的音轨单独进行内容审核,与视频分开;若音轨被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能是偶发的。如果遇到这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有效,同步的 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求尚不会标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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,省略该值时也会返回 400。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 `/v2/models/byteplus/\{model}` 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 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。它不在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 仅 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅 Seedance 2.5 适用。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);具体比例会在调度前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 +Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 +注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 +true:返回已生成视频的最后一帧图像。将本参数设为 true 后,你可以通过调用“查询视频生成任务信息”接口获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用本参数可以生成多段连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多段连续视频。 +false:不返回已生成视频的最后一帧图像。 @@ -335,87 +330,87 @@ false: 不返回已生成视频的最后一帧图像。 - 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` - 已生成视频是否包含水印。 + 已生成的视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` 提供的 schema 生成,此文档也是它在请求到达提供商之前校验调用时所依据的同一文档。 +生成自 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` 提供的 Schema,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL;当 BytePlus 返回最后一帧时,还包含最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储;这里的其他所有字段均来自 BytePlus 本身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,而在此之后轮询已成功的文档时,`content` 可能缺失或为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL;当 BytePlus 返回最后一帧 URL 时,也包含其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都被重新托管到 Comfy 存储;此处的其他字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询到的成功文档中,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧指定为 PNG,Router 会重新托管其收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定其类型,只有当两者都失败时,`image/jpeg` 才作为最后的回退。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,因此较晚的轮询可能返回仅剩一小时有效期的 URL。如果无法执行重新托管,该字段会改为保留 BytePlus 自己的 URL;BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的字节,并根据上游 Content-Type 或内容嗅探判断其类型,只有两者都失败时才会最后回退到 `image/jpeg`。Router 会把最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时;签发时按 24 小时签名,并从 23 小时缓存中重放,因此稍后轮询可能拿到仅剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种情况,链接都会过期,因此请下载该帧,而不要保存 URL。 - 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回(见顶层 `output_format` 字段),Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参见顶层 `output_format` 字段;Router 会读取两者中存在的那个。 - 上游 URL 停止工作的时间,采用 RFC 3339 格式:URL 自身携带的最早签名时间加有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档给出的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时提供,当两个来源都未给出时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + RFC 3339 时间,表示上游 URL 停止工作的时间:URL 自身携带的最早签名时间加有效期;当 `updated_at` 存在时,该时间绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才存在;当两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一起逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不再提供,并且在 `upstream_expires_at` 之前是持有者凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列按字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前属于 bearer 凭据。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一起逐字节原样返回。仅当轮询 Seedance 2.x 任务的工作区已在服务器端由 Comfy 选择加入时才提供(没有请求参数);对其他所有情况均不提供,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且一旦 BytePlus 在生成 24 小时后清除其 URL,也会不再提供。它是预签名对象存储 URL,因此也是持有者凭证:任何持有它的人都能在过期前下载视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列按字节原样返回。仅对由 Comfy 在服务器端选择加入的工作区轮询的 Seedance 2.x 任务存在(没有请求参数);对其他所有情况都不存在,包括解析不到任何工作区的凭据(例如未限定到某个工作区的传统 API 密钥),并且 BytePlus 在生成 24 小时后清除其 URL 后也不存在。它是预签名对象存储 URL,因此是一种 bearer 凭据:任何持有它的人都可以在过期前下载视频,所以请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,因此较晚的轮询可能返回仅剩一小时有效期的 URL。如果无法执行重新托管,该字段会改为保留 BytePlus 自己的 URL;BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 + 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时;签发时按 24 小时签名,并从 23 小时缓存中重放,因此稍后轮询可能拿到仅剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要保存 URL。 - 任务创建时间。该值是 UNIX 时间戳,单位为秒。 + 任务创建时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为数字而非整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同级接口会反馈小数时长,因此客户端不得假定该值为整数。BytePlus 自己的字段,在已成功的视频任务上返回,并原样转发。 + 已生成视频的时长,单位为秒。声明为数值而不是整数,是因为 BytePlus 对此并不一致:曾观察到视频任务返回整秒数,而同属 BytePlus 的其他接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务中返回并原样转发。 - 错误信息。如果任务成功,则返回 null。如果任务失败,则返回错误信息。 + 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 标识内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是开放字符串,而非枚举:其他错误码用于描述验证与提供商失败。Router 能在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输失败。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商失败。Router 会在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 报错信息 - +```mdx 视频生成任务的 ID - 该任务使用的模型名称及版本 + 任务所使用模型的名称和版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的兄弟字段返回,Seedance 视频任务查询即在此处返回该字段。这是 BytePlus 自有字段,原样透传。 + 已生成视频的容器格式(mp4 或 mov),在顶层返回,作为 `content` 的同级字段。Seedance 视频任务查询正是在此处返回该字段。该字段为 BytePlus 自有字段,原样透传。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,原样透传。 + 已生成视频的分辨率,例如 `1080p`。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 - 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,原样透传。 + 该任务实际使用的生成种子。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 格式:`int64` @@ -423,7 +418,7 @@ false: 不返回已生成视频的最后一帧图像。 任务的状态 - 可能的值:`queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 1aacbc9334..1ce8bae6ef 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,19 +2,20 @@ title: "使用 Dreamina Seedance 2.5 260628 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-5-260628:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 3606fb83 +translationSourceHash: 2acd3f28 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": d2c28a84 + "Schema": d29d4b46 "Examples": 5465695b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -195,33 +196,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 输入 - 已忽略。为兼容 BytePlus 的请求形状而接受,但在提交任务之前就会被移除,因此永远不会发送回调;请改为轮询任务状态路由来获取结果。 + 已忽略。为兼容 BytePlus 请求结构而接受,但在提交任务之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` - 供模型生成视频的输入内容 + 模型用于生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 与 2.0 mini 不能仅使用音频,必须包含至少 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 个图像或视频;Seedance 2.5 支持仅音频输入。 音频 URL、Base64 编码或资产 ID。 音频 URL:音频的公开 URL(wav、mp3)。 -Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ +Base64:格式 data:audio/\;base64,\ +资产 ID:格式 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。分辨率默认为且仅支持 1080p。 + 仅限 Seedance 2.5。要渲染为最终视频的草稿任务。它必须是唯一的内容项。 +最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;不要再次发送它们。在此请求上设置最终输出档位的分辨率,包括 4k;如果省略,则最终视频为 1080p。 - 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 + 使用 `draft` 设置为 true 创建草稿视频时返回的任务 ID。 @@ -230,115 +231,115 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:请确保图片网址可访问。 -Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式为 asset://\ +图片网址:确保图片网址可访问。 +Base64 编码的内容:格式必须为 data:image/\;base64,\ +资产 ID:格式 asset://\ 内容项的角色/位置。 -对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 +对于图像: first_frame、last_frame 或 reference_image。 +对于视频: reference_video(仅限 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于音频: reference_audio(仅限 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 供模型使用的输入文本信息。包含文本提示词和可选参数。 - -文本提示词(必填):使用中文和英文字符描述要生成的视频。 - -参数(可选):在文本提示词之后添加 --[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)。 -它按字符而非字节计数,因此多字节提示词在网络传输时可能达到该值的 -数倍。它限定的是这一个字段,而不是整个请求: -`content` 是数组,整个文档由每请求的请求体上限来限定。 -执行该限制的是 Comfy Router(/v2/models/byteplus/\{model}); -若直接调用 v1 /proxy,则由 BytePlus 自己的校验器给出答复。 -该值设置得远高于真实流量,因此它永远不会裁决真实的提示词;如果调用方需要更多,可以提高该值。 + 模型用于输入的文本信息。包括文本提示词和可选参数。 + +文本提示词(必填):使用中英文字符描述要生成的视频。 + +参数(可选):在文本提示词后添加 --[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) + +示例:"一幅美丽的风景 --ratio 16:9 --resolution 720p --duration 5" + +Comfy 侧护栏,而非 BytePlus 约束。BytePlus 未发布文本长度限制, +并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符计数,而非字节,因此多字节提示词在传输中可能达到此大小的数倍。 +它限制的是这一个字段,而非整个请求:`content` 是一个数组, +每个请求的正文限制才是整个文档的边界。Comfy Router (/v2/models/byteplus/\{model}) +是执行该限制的层面;直接调用 v1 /proxy 时,由 BytePlus 自己的验证器应答。 +设置为远高于真实流量,以确保它永远不会判定真实的提示词。如果调用方需要更多,请提高此值。 输入内容的类型 - 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持视频输入。 + 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 视频 URL 或资产 ID。 视频 URL:视频的公开 URL(mp4、mov)。 -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ - 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -在 `draft_task` 内容项中传入返回的任务 ID,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 + 仅限 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 +在 `draft_task` 内容项中传入返回的任务 ID 以渲染最终视频。该请求设置最终视频的分辨率,包括 4k;如果省略分辨率,则最终视频为 1080p。草稿任务 ID 有效期为 7 天。 - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动)。 + 视频时长,以秒为单位。Seedance 2.5:[4,30] 或 -1(自动)。 - 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` + 可能的值: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`、`16`、`17`、`18`、`19`、`20`、`21`、`22`、`23`、`24`、`25`、`26`、`27`、`28`、`29`、`30` - 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值,以秒为单位。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带有同步音频的视频。 -false:模型输出无声视频。在支持此功能的模型上,生成的音轨会由提供商与视频分开进行内容检查;若此处被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频不同,对于提供商原本会接受的输入,这种拒绝可能间歇性出现。若发生这种情况,请发送 `false` 以生成无声视频;仅当被拒绝的模态是音频时,这样做才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚不会标识这一点)。Seedance 2.5 的最终渲染会继承其 Draft 任务的 `generate_audio`,因此请改用 `false` 重新创建 Draft。 + 受 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true: 模型输出包含同步音频的视频。 +false: 模型输出无声视频。 +在支持该功能的模型上,生成的音频轨道会由提供商单独于视频进行内容审核;若音频被拒,会以 `content_policy_violation` 报告,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种拒绝可能是间歇性的。如果遇到这种情况,请发送 `false` 以获得无声视频;这仅在音频正是被拒的模态时才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 + 要调用的模型 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。直接以 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它:代理会以 400 拒绝任何其他值,也会以 400 拒绝省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充该值,所以 Router 调用方会省略它。 - 仅限 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅适用于 Seedance 2.5。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),色彩精度高,适合后期制作;文件大小更大。 - 可能的值:`mp4`, `mov` + 可选值:`mp4`、`mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast、2.0 mini 和 1.5 pro 的默认值:adaptive。 -Seedance 2.5 的首帧/首尾帧生成:输出会遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);具体比例会在调度前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体的比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体的比例。 - 可能的值:`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro 和 1.0 lite 的默认值:720p。Seedance 1.0 pro 和 pro-fast 的默认值:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可能的值:`480p`, `720p`, `1080p`, `4k` + 可选值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。该最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不含水印。使用此参数可以生成多个连续视频:将先前生成的视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 +是:返回已生成视频的最后一帧图像。将该参数设置为是之后,你可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +否:不返回已生成视频的最后一帧图像。 @@ -348,47 +349,47 @@ false: 不返回已生成视频的最后一帧图像。 - 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可能的值:`default`, `flex` + 可选值:`default`、`flex` 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` 提供的 schema 生成,该 schema 也是它在请求到达提供商之前用于校验调用的同一文档。 +本文档由 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 视频生成任务已完成后的输出,包含输出视频的下载 URL,以及 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储;这里的其他字段均由 BytePlus 提供。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在此之后轮询已成功的文档时,`content` 可能缺失或为 null。 + 视频生成任务已完成后的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他所有字段都来自 BytePlus 自身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在此期间之后再轮询已成功的文档时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管其收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 仅在两者都失败时作为最后的兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是由 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时缓存中重放,因此之后的轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会改为保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种方式,链接都会过期,因此请下载该帧,而不是存储 URL。 + 已生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储上并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘录中重放,因此之后的轮询可能返回剩余有效期仅一小时的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自身的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 - 当 BytePlus 将其嵌套在 `content` 内时,表示已生成视频的容器格式(mp4 或 mov)。Seedance 模型更常将其作为 `content` 的顶层同级字段返回;请参阅顶层的 `output_format` 字段。Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 内。Seedance 模型更常见的是将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段。Router 会读取两者中存在的那个。 - RFC 3339 时间,表示上游 URL 停止工作的时间:最早的签名时间加上这些 URL 自身携带的有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生存期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时才提供,当两个来源都未给出时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + 上游 URL 失效的 RFC 3339 时间:取最早的签名时间加上 URL 自身携带的有效期;当 `updated_at` 存在时,该时间绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅在存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,当两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,适用条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不存在,并且在 `upstream_expires_at` 之前是一种 bearer 凭证。 + BytePlus 自身的最后一帧下载 URL,与重新托管的 `last_frame_url` 并排原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前属于持有者凭证。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅当 Seedance 2.x 任务由 Comfy 已在服务器端选择加入的工作区轮询时才提供(没有请求参数);其他所有情况下均不存在,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都可以在它过期前下载视频,所以请像对待机密一样对待它。它会在 `upstream_expires_at` 过期,在 Seedance 2.5 上 BytePlus 将其限制为最多 100 次下载,其中一次会被 Router 自己的重新托管消耗。 + BytePlus 自身的输出视频下载 URL,与重新托管的 `video_url` 并排原样返回。仅当任务由 Comfy 在服务器端已选择加入的工作区轮询时,才为 Seedance 2.x 任务返回(没有请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),以及在 BytePlus 于生成 24 小时后清除其 URL 之后。它是预签名的对象存储 URL,因此属于持有者凭证:任何持有它的人都可以在过期前下载该视频,请将其视为机密。它在 `upstream_expires_at` 过期,在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是由 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时缓存中重放,因此之后的轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会改为保留 BytePlus 自己的 URL;BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将下载次数限制为 100 次。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘录中重放,因此之后的轮询可能返回剩余有效期仅一小时的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自身的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 @@ -396,39 +397,38 @@ false: 不返回已生成视频的最后一帧图像。 - 已生成视频的时长,单位为秒。声明为数字而非整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而其他 BytePlus 接口会报告小数时长,因此客户端不得假定该值为整数。这是 BytePlus 自己的字段,在已成功的视频任务上返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同级接口会报告小数时长,因此客户端不得假定其为整数值。这是 BytePlus 自身的字段,在已成功的视频任务上返回并原样转发。 - 错误信息。如果任务成功,则返回 null。如果任务失败,则返回错误信息。 + 错误信息。若任务成功,则返回 null。若任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点号分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商失败。Router 会在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输故障。 报错信息 - - 视频生成任务的 ID +The ID of the video generation task - 任务所使用的模型名称与版本 + 任务所使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回。Seedance 视频任务查询正是在此位置返回该字段。该字段为 BytePlus 自有字段,原样透传。 + 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务上返回并原样转发。 - 该任务实际使用的生成种子。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 实际用于该任务的生成种子。BytePlus 自有字段,在成功的视频任务上返回并原样转发。 格式:`int64` @@ -444,7 +444,7 @@ false: 不返回已生成视频的最后一帧图像。 - 本次请求的 token 用量 + 请求的 token 用量 @@ -452,7 +452,7 @@ false: 不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,其默认值为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index abebaade7b..3ad3be8301 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,18 +2,19 @@ title: "将 Seedance 1.0 Pro 250528 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-250528:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 642f85ab +translationSourceHash: 846f38d7 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": b57b84de + "Schema": 6f05c994 "Examples": 815d621e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-250528.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -182,29 +183,29 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 输入 - 已忽略。为兼容 BytePlus 的请求结构而接受该字段,但在任务提交前会将其移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 + 忽略。为兼容 BytePlus 请求形状而接受,但在任务提交之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 格式:`uri` - 模型用于生成视频的输入内容 + 用于模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 - 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开 URL(wav、mp3)。 + 音频网址、Base64 编码或资产 ID。 +音频网址:音频的公开网址(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ - 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。resolution 默认为且仅支持 1080p。 + 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。请在此请求中为最终输出设置分辨率档位,包括 4k;省略时最终视频为 1080p。 @@ -217,7 +218,7 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片 URL:请确保图片 URL 可访问。 +图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -225,21 +226,21 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 内容项的角色/位置。 对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持)。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 + 模型的输入文本信息。包括文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: +参数(可选):在文本提示词之后添加 --[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) +- --duration(--dur):3-12 秒(默认:5) - --framepersecond(--fps):24(默认:24) - --watermark(--wm):true/false(默认:false) - --seed(--seed):-1 至 2^32-1(默认:-1) @@ -248,20 +249,19 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" 这是 Comfy 侧的防护限制,而非 BytePlus 的约束。BytePlus 未公布 -文本长度上限,并在测试中接受了 40,000 个字符(2026-09-17)。 -它按字符而非字节计数,因此多字节提示词在传输途中的大小可能达到 -该限制的数倍。它只约束这一个字段,而非整个请求: -`content` 是数组,而单请求的正文大小限制才约束整个文档。 -Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; -在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器作出响应。 -该值设置得远高于真实流量,因此它永远不会裁定真实提示词,如果调用方 -需要更多,可以提高该限制。 +文本长度上限,并且在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此在网络传输中多字节提示词的体积可能达到 +该数值的数倍。它约束的是这一个字段,而不是整个请求: +`content` 是数组,整个文档由每请求的请求体上限约束。执行该限制的 +接口是 Comfy Router(/v2/models/byteplus/\{model});直接调用 v1 /proxy +时,则由 BytePlus 自己的校验器应答。该值设置得远高于真实流量, +因此它从不会对真实提示词做出裁定;如果调用方需要更多,可以提高该值。 输入内容的类型 - 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -269,14 +269,14 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; - 视频 URL 或资产 ID。 -视频 URL:视频的公开 URL(mp4、mov)。 + 视频网址或资产 ID。 +视频网址:视频的公开网址(mp4、mov)。 资产 ID:格式为 asset://\ - 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,即可渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 @@ -286,47 +286,47 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; - 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值,单位为秒。默认 172800(48h)。范围:[3600, 259200]。 - 范围:`3600` 至 `259200` + 范围:`3600` 到 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -是:模型输出带同步音频的视频。 -否:模型输出无声视频。在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容审核;若音频未通过审核,会被报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对于提供商在其他方面可以接受的输入,这种拒绝可能是间歇性的。如果出现这种情况,请传入 `false` 以获取无声视频;仅当音频是被拒绝的模态时这才会起作用,同步的 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求尚无法识别出这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 + 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true:模型输出带同步音频的视频。 +false:模型输出无声视频。在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;若音频被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种情况可能间歇性出现。若出现该情况,请发送 `false` 以生成无声视频;只有当被拒绝的模态是音频时这才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法标识该信息)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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 调用时 MUST 提供该字段,代理会以 400 拒绝任何其他取值以及缺省该字段的请求。它 NOT 在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。 + 要调用的模型 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。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 仅适用于 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅 Seedance 2.5 适用。输出视频的容器格式。 +mp4:通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),颜色精度高,适合后期制作;文件大小更大。 可选值:`mp4`、`mov` 已生成视频的宽高比。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会跟随首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 拒绝。在这些模式下,Seedance 2.0 接受具体比例。 +Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 +注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 可选值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将该参数设为 true 后,你可以通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 +true:返回已生成视频的最后一帧图像。将该参数设为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +false:不返回已生成视频的最后一帧图像。 @@ -342,41 +342,41 @@ false: 不返回已生成视频的最后一帧图像。 - 已生成的视频是否包含水印。 + 已生成视频是否包含水印。 -生成自 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` 提供的 Schema,与它在请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前校验调用时使用的文档相同。 ### 输出 - 视频生成任务完成后的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回的情况下,其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 均被重新托管到 Comfy 存储上;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 在任务完成 24 小时后清除这些 URL,因此此后轮询一个已成功的文档时,`content` 可能缺失或为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储上;这里的其他每个字段都是 BytePlus 自己的。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在那之后轮询到的已成功文档可能 `content` 缺失或为 null。 - 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游的 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是两者都失败时的最终回退。Router 将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是一个 Comfy 签名的 URL,有效期最长 24 小时。该 URL 在签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的轮询返回的 URL 可能仅剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种情况,链接都会过期,因此请下载该帧,而不要存储 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以之后轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 - 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 中时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段。Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 内。Seedance 模型更常把它作为 `content` 的顶层同级字段返回,见顶层的 `output_format` 字段,Router 会读取两者中存在的那个。 - RFC 3339 时间,表示上游 URL 失效的时间:取 URL 自身携带的最早签名时间加有效期,当 `updated_at` 存在时,不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档中记载的 URL 生命周期);否则取任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时提供,当两个来源都未给出时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + 上游 URL 失效的 RFC 3339 时间:URL 自身携带的最早签名时间加上其有效期;当 `updated_at` 存在时,不会晚于任务的 `updated_at` 加 24 小时(BytePlus 文档中记录的 URL 生存期),否则为任务的 `updated_at` 加 24 小时。仅在 `upstream_video_url` 或 `upstream_last_frame_url` 存在时出现,两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生存期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列按原样返回,其条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,在 BytePlus 清除后缺失,并且在 `upstream_expires_at` 之前属于持有者凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一并原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、在 BytePlus 清除后缺失,并且在 `upstream_expires_at` 之前属于 bearer 凭证。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列按原样返回。仅当任务由 Comfy 在服务器端已选择加入的工作区轮询 Seedance 2.x 任务时才提供(没有请求参数);对其他所有情况均缺失,包括解析不到任何工作区的凭证(例如未绑定到工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此属于持有者凭证:任何持有它的人都可以在过期前下载视频,因此请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一并原样返回。仅在由服务端选择加入的 Comfy 工作区轮询的 Seedance 2.x 任务中出现(没有可用的请求参数);对其他所有人都不出现,包括无法解析到任何工作区的凭证(例如未绑定工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都能在其过期前下载视频,请把它当作机密对待。它在 `upstream_expires_at` 过期,在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 将视频重新托管到 Comfy 存储并重写此字段,因此它通常是一个 Comfy 签名的 URL,有效期最长 24 小时。该 URL 在签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的轮询返回的 URL 可能仅剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要存储 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以之后轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 @@ -384,7 +384,7 @@ false: 不返回已生成视频的最后一帧图像。 - 生成视频的时长,单位为秒。声明为数字而非整数,是因为 BytePlus 在此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不能假定该值为整数。这是 BytePlus 自有字段,在已完成的视频任务上返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:视频任务曾被观察到返回整数秒,而同系列的其他 BytePlus 接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 @@ -392,7 +392,7 @@ false: 不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误响应信封和 HTTP 200 失败任务响应中识别策略系列,同时不会覆盖传输层故障。 @@ -404,21 +404,21 @@ false: 不返回已生成视频的最后一帧图像。 - 该任务所使用的模型名称和版本 + 任务所使用的模型名称和版本 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 的自有字段,原样转发。 + 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是从这里返回该字段。这是 BytePlus 自有字段,原样透传。 - 生成视频的分辨率,例如 `1080p`。这是 BytePlus 的自有字段,在成功的视频任务中返回,并原样转发。 + 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 - 该任务实际使用的生成种子。这是 BytePlus 的自有字段,在成功的视频任务中返回,并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 - 格式:`int64` + Format: `int64` @@ -440,7 +440,7 @@ false: 不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认值为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数,其默认值为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index e2daccec1b..65fa2c9021 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,18 +2,19 @@ title: "使用 Comfy Router 调用 Seedance 1.0 Pro Fast 251015" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-fast-251015:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 61dd0135 +translationSourceHash: 5ba64878 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": dd74b012 + "Schema": 2de625f5 "Examples": 1469ab97 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedance-1-0-pro-fast-251015.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -182,33 +183,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 输入 - 已忽略。为兼容 BytePlus 请求结构而接受此字段,但会在提交任务前将其移除,因此永远不会发送回调;请改为轮询任务状态接口获取结果。 + 会被忽略。此项仅为兼容 BytePlus 的请求结构而接受,但在任务提交之前即被移除,因此不会发送任何回调;请改为轮询任务状态路由以获取结果。 格式:`uri` - 模型生成视频所用的输入内容 + 供模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 与 2.0 mini 不能仅使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 - 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开 URL(wav、mp3)。 -Base64:格式 data:audio/\;base64,\ -资产 ID:格式 asset://\ + 音频网址、Base64 编码或资产 ID。 +音频网址:音频的公开网址(wav、mp3)。 +Base64:格式为 data:audio/\;base64,\ +资产 ID:格式为 asset://\ 仅限 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 与 omni_reference_task_type,请勿再次发送这些内容。请在本次请求中为最终视频的输出档位设置分辨率,包括 4k;若省略,则最终视频为 1080p。 - 将 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 + 创建 Draft 视频时(`draft` 设为 true)返回的任务 ID。 @@ -217,62 +218,69 @@ Base64:格式 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:请确保图片网址可访问。 +图片网址:请确保该图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式 asset://\ +资产 ID:格式为 asset://\ 内容项的角色/位置。 -图像:first_frame、last_frame 或 reference_image。 -视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 -音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于图像:first_frame、last_frame 或 reference_image。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 - 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 模型的输入文本信息。包括文本提示词和可选参数。 + 模型的输入文本信息。包含文本提示词和可选参数。 -文本提示词(必填):使用中英文字符描述要生成的视频。 +文本提示词(必填):用中英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[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) +参数(可选):在文本提示词之后添加 --[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)。它按字符而非字节计数,因此多字节提示词在传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是一个数组,而每个请求的请求体上限才限制整个文档。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器负责应答。该值设置得远高于真实流量,因此绝不会对真实提示词作出裁决;如果调用方需要更多,可提高该值。 +这是 Comfy 侧的保护性限制,而非 BytePlus 的约束。BytePlus 并未公布文本长度 +上限,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此在传输时,多字节提示词的实际大小可能是该上限的 +数倍。它限制的只是这一个字段,而不是整个请求: +`content` 是数组,整个文档受每次请求的请求体上限约束。 +执行该限制的入口是 Comfy Router(/v2/models/byteplus/\{model});直接调用 v1 /proxy 时, +则由 BytePlus 自己的校验器负责。该值设置得远高于真实流量,因此它永远不会 +判定真实提示词。如果调用方需要更大的长度,可以提高该值。 输入内容的类型 - 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 + 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持视频输入。 - 视频 URL 或资产 ID。 -视频 URL:视频的公开 URL(mp4、mov)。 -资产 ID:格式 asset://\ + 视频网址或资产 ID。 +视频网址:视频的公开网址(mp4、mov)。 +资产 ID:格式为 asset://\ 仅限 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 +将返回的任务 ID 放入 `draft_task` 内容项中,即可渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;若省略分辨率,则最终视频为 1080p。Draft 任务 ID 在 7 天内保持有效。 - 视频时长,单位为秒。Seedance 1.0 pro 和 1.0 pro fast:[2,12]。 + 视频时长,单位为秒。Seedance 1.0 pro 与 1.0 pro fast:[2,12]。 可能的值:`2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` @@ -284,91 +292,91 @@ Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本 - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true: 模型输出带同步音频的视频。 -false: 模型输出无声视频。在支持该功能的模型上,提供商会对生成的音轨与视频分开进行内容审核;如果音轨被拒绝,会报告为 `content_policy_violation`,并且由于每次运行音频都不同,对于提供商原本接受的输入,这种拒绝可能间歇性出现。如果发生这种情况,请为静音视频发送 `false`;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其命名为 `refusal_subject: output_audio`(排队中的请求尚不会标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为使用 `false` 重新创建 Draft。 + Seedance 2.5、2.0、2.0 fast、2.0 mini 与 1.5 pro 支持此参数。指定生成的视频是否包含与画面同步的音频。 +true:模型输出带同步音频的视频。 +false:模型输出无声视频。在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容检查;若音轨被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频不同,对于提供商原本接受的输入,这种拒绝可能会间歇性出现。如果发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其命名为 `refusal_subject: output_audio`(已排队的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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 拒绝任何其他值以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填入它,因此 Router 调用方会省略它。 + 要调用的模型 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 拒绝任何其他值,以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 - 仅限 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅适用于 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可能的值:`mp4`、`mov` + 可能的值:`mp4`, `mov` - 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的比例,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 生成视频的比例。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 的默认值:adaptive。 +Seedance 2.5 的首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);在调度之前,具体比例会以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可能的值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`, `720p`, `1080p`, `4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,你可以通过调用“查询视频生成任务的信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用此参数可以生成多个连续视频:将上一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 false: 不返回已生成视频的最后一帧图像。 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 - 范围:`-1` 到 `4294967295` + 范围:`-1` 至 `4294967295` - 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 - 可能的值:`default`、`flex` + 可能的值:`default`, `flex` 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前校验调用时所依据的同一文档。 +根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` 提供的 schema 生成,该 schema 也是它在请求到达提供商之前用来验证调用的同一份文档。 ### 输出 - 视频生成任务完成后返回的输出,包含输出视频的下载 URL,以及在 BytePlus 提供时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他每个字段都来自 BytePlus 本身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询到的成功文档中 `content` 可能缺失或为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他每个字段都是 BytePlus 自己的。可为空:BytePlus 会在任务完成 24 小时后清除 URL,之后轮询到的已成功的文档可能带有缺失或为 null 的 `content`。 - 已生成视频最后一帧的下载 URL,在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的任何字节,并根据上游的 Content-Type 或内容探测来确定其类型,只有当两者都失败时,`image/jpeg` 才作为最后的兜底。Router 会将最后一帧重新托管到 Comfy 存储上并重写此字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它。无论哪种方式,链接都会过期,因此请下载该帧,而不是保存 URL。 + 已生成视频最后一帧的下载 URL,仅当请求设置了 `return_last_frame` 时返回。不要根据这个 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会把最后一帧重新托管到 Comfy 存储上并改写这个字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的一次轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况链接都会过期,因此请下载该帧,而不要保存 URL。 - 已生成视频的容器格式(mp4 或 mov),在 BytePlus 将其嵌套在 `content` 中时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段,Router 会读取两者中存在的那一个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段;Router 会读取两者中存在的那个。 - 上游 URL 停止工作的 RFC 3339 时间:即 URL 本身携带的最早签名时间加有效期,当任务的 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + RFC 3339 格式的上游 URL 失效时间:取最早的签名时间加上 URL 自身携带的有效期;当存在 `updated_at` 时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 有效期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,两个来源都不提供时间时则省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前属于持有者凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列、逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,且在 `upstream_expires_at` 之前属于持有即可用的凭证。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅在由 Comfy 已在服务器端选择加入的工作区轮询 Seedance 2.x 任务时出现(没有请求参数);对其他所有人均缺失,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是一个预签名的对象存储 URL,因此属于持有者凭证:任何持有它的人都能在过期前下载该视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 时过期,并且在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列、逐字节原样返回。仅对由 Comfy 在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务出现(没有对应的请求参数);对其他所有情况都不出现,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后也不出现。它是预签名的对象存储 URL,因此属于持有即可用的凭证:任何持有它的人都能在过期前下载该视频,所以请像对待密钥一样对待它。它在 `upstream_expires_at` 过期,且在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并重写此字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是保存 URL。 + 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储上并改写这个字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的一次轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况链接都会过期,因此请下载视频,而不要保存 URL。 @@ -376,7 +384,7 @@ false: 不返回已生成视频的最后一帧图像。 - 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:视频任务曾被观察到返回整秒,而同系列的其他 BytePlus 接口会上报带小数的时长,因此客户端不得假定它是整数值。该字段属于 BytePlus 自身,在成功的视频任务上返回并原样转发。 + 已生成视频的时长,单位为秒。声明为数字而非整数,是因为 BytePlus 在这方面并不一致:已观察到视频任务返回整秒,而同系列的其他 BytePlus 接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在已成功的视频任务上返回并原样转发。 @@ -384,37 +392,36 @@ false: 不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一族错误可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,不是枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别内容策略族,但不会覆盖传输层面的故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放的字符串,不是枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输层故障。 报错信息 - - 视频生成任务的 ID +The ID of the video generation task - 该任务所使用的模型的名称和版本 + 该任务所使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此位置返回该字段。BytePlus 自有字段,原样透传。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 自有字段,原样透传。 - 已生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回,原样透传。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 - 该任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回,原样透传。 + 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 格式:`int64` - 任务的状态 + 任务状态 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -428,11 +435,11 @@ false: 不返回已生成视频的最后一帧图像。 - 模型生成的 token 数量 + 模型生成的 token 数 - 对于视频生成模型,不计算输入 token 数,默认为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数,默认为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index c1747d7edb..264060d464 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,18 +2,19 @@ title: "通过 Comfy Router 使用 Seedance 1.5 Pro 251215" description: "通过 Comfy Router 调用 byteplus/seedance-1-5-pro-251215:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 2263b4cf +translationSourceHash: 8c658f01 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": f4d67fb6 + "Schema": b9957cb9 "Examples": 7e73ac5c --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedance-1-5-pro-251215.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### 输入 - 已忽略。为兼容 BytePlus 请求结构而接受,但在任务提交前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 + 忽略。仅为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此不会发送任何回调;请改为轮询任务状态路由以获取结果。 格式:`uri` @@ -192,23 +193,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 - 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开 URL(wav、mp3)。 -Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ + 音频网址、Base64 编码或资产 ID。 +音频网址:音频的公开网址(wav、mp3)。 +Base64:格式 data:audio/\;base64,\ +资产 ID:格式 asset://\ - 仅 Seedance 2.5。要作为最终视频渲染的草稿任务。它必须是唯一的内容项。 -最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。 + 仅 Seedance 2.5 可用。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。在此请求中为最终视频的输出档位设置分辨率,包括 4k;省略时最终视频为 1080p。 - 当 `draft` 设置为 true 创建草稿视频时返回的任务 ID。 + 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 @@ -217,9 +218,9 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:请确保图片网址可访问。 +图片网址:确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ @@ -232,25 +233,28 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 供模型使用的输入文本信息。包含文本提示词和可选参数。 + 供模型使用的输入文本信息。包括文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 参数(可选):在文本提示词后添加 --[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) +- --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)。 -它按字符而非字节计数,因此多字节提示词在传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求: -`content` 是数组,而整个文档由单次请求的正文限制来约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; -直接调用 v1 /proxy 时,则改由 BytePlus 自己的验证器应答。将该值设置得远高于真实流量,因此它永远不会裁决真实提示词;如果调用方需要更多,可以提高该值。 +Comfy 侧护栏,并非 BytePlus 的限制。BytePlus 未公布 +文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此多字节提示词在传输时可能达到此大小的数倍。 +它限制的是这一个字段,而不是整个请求: +`content` 是一个数组,而整个文档受每个请求的正文大小限制约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; +直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器作出响应。 +该限制设置得远高于真实流量,因此它永远不会裁决真实提示词;如果调用方需要更多,请提高该限制。 @@ -264,163 +268,162 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 视频 URL 或资产 ID。 -视频 URL:视频的公开 URL(mp4、mov)。 -资产 ID:格式为 asset://\ + 视频网址或资产 ID。 +视频网址:视频的公开网址(mp4、mov)。 +资产 ID:格式 asset://\ - 仅 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。草稿任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5 可用。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时,最终视频为 1080p。Draft 任务 ID 有效期为 7 天。 视频时长,单位为秒。Seedance 1.5 pro:[4,12] 或 -1(自动)。 - 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` + 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - 任务超时阈值,以秒为单位。默认 172800(48h)。范围:[3600, 259200]。 + 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 - 范围:`3600` 至 `259200` + 范围:`3600` 到 `259200` - 支持该参数的模型为 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro。生成的视频是否包含与画面同步的音频。 -true: 模型输出带同步音频的视频。 -false: 模型输出无声视频。 -对于支持该功能的模型,已生成的音频轨道会由提供商与视频分开进行内容检查;此处的拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频不同,对于提供商原本接受的输入,这种拒绝可能间歇性出现。如果发生这种情况,请为无声视频发送 `false`;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其命名为 `refusal_subject: output_audio`(排队中的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为使用 `false` 重新创建 Draft。 + 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true:模型输出带同步音频的视频。 +false:模型输出无声视频。 +在支持该功能的模型上,生成的音频轨道会由提供商与视频分开进行内容检查;此处的拒绝会以 `content_policy_violation` 报告,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种拒绝可能是间歇性的。如果出现这种情况,请为无声视频发送 `false`;这仅在音频正是被拒绝的模态时才有帮助,同步 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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。它并不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 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 拒绝任何其他值以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 - 仅限 Seedance 2.5。输出视频的容器格式。 + 仅 Seedance 2.5。输出视频的容器格式。 mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),色彩精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + Possible values: `mp4`, `mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在调度前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧 / 首末帧生成:输出遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 +注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可选值:`480p`、`720p`、`1080p`、`4k` + Possible values: `480p`, `720p`, `1080p`, `4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的第一帧,从而快速生成多个连续视频。 +true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,你可以通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 false: 不返回已生成视频的最后一帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围:`-1` 到 `4294967295` + Range: `-1` to `4294967295` - 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 处理服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + Possible values: `default`, `flex` 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前它用于验证调用的文档相同。 +该内容生成自 Router 在 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` 提供的 schema,与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 - 视频生成任务完成后的输出,包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务结束 24 小时后清除这些 URL,届时再轮询一个已成功的文档,其 `content` 可能缺失或为 null。 + 视频生成任务完成后的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询一条已成功的文档时,`content` 可能缺失或为 null。 - 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管其收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定类型,`image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,所以它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,因此后续轮询可能返回一个仅剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务结束 24 小时后清除它。无论哪种方式,链接都会过期,因此请下载该帧,而不是存储 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游 Content-Type 或内容嗅探来确定其类型,只有在两者都失败时,`image/jpeg` 才是最后的兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签为 24 小时,并从一份 23 小时的缓存记录中重放,因此后续轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它。无论哪种情况链接都会过期,因此请下载该帧,而不要保存 URL。 - 生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 中。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段,Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),在 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参见顶层 `output_format` 字段,Router 会读取两者中存在的那个。 - 上游 URL 停止工作的 RFC 3339 时间:最早签名时间加上 URL 自身携带的有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现;当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + RFC 3339 时间,表示上游 URL 停止可用的时间:即 URL 自身携带的最早签发时间加有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记录的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时出现,当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后会缺失,并且在 `upstream_expires_at` 之前都是持有者凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一同逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,且在 `upstream_expires_at` 之前一直是一个持有者凭证。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅对由 Comfy 在服务器端已选择加入的工作区轮询的 Seedance 2.x 任务出现(没有请求参数);对其他所有情况均不出现,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥);并且在 BytePlus 于生成 24 小时后清除其 URL 后也不出现。它是预签名的对象存储 URL,因此也是持有者凭证:任何持有它的人都能在过期前下载视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一同逐字节原样返回。仅当任务由 Comfy 在服务端选择加入的工作区轮询 Seedance 2.x 任务时才会出现(没有对应的请求参数);对其他所有情况都不出现,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名对象存储 URL,因此也是一种持有者凭证:任何持有它的人都能在过期前下载视频,请像对待密钥一样对待它。它在 `upstream_expires_at` 过期,而在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,所以它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,因此后续轮询可能返回一个仅剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签为 24 小时,并从一份 23 小时的缓存记录中重放,因此后续轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并且在某些模型上将其限制为 100 次下载。无论哪种情况链接都会过期,因此请下载视频,而不要保存 URL。 - 任务创建时间。该值为 UNIX 时间戳,单位为秒。 + 任务创建的时间。该值为 UNIX 时间戳(秒)。 - 生成视频的时长,单位为秒。声明为数字而不是整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而其他 BytePlus 接口会报告小数时长,因此客户端不得假定其为整数值。这是 BytePlus 自有字段,在成功的视频任务上返回并原样转发。 + 已生成视频的时长,单位为秒。声明为数字而非整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他界面会报告带小数的时长,因此客户端不应假定其值为整数。这是 BytePlus 的自有字段,在已成功的视频任务上返回并原样转发。 - 错误信息。如果任务成功,则返回 null;如果任务失败,则返回错误信息。 + 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误代码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,不是枚举:其他代码描述验证和提供商故障。Router 会在 HTTP 400 错误响应包和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一系列可能带有点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证与提供商故障。Router 会在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略类错误,同时不会覆盖传输层故障。 报错信息 - - The ID of the video generation task +The ID of the video generation task -> 视频生成任务的 ID - 任务所使用的模型名称和版本 + 该任务所使用的模型名称和版本 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询就是在这里返回该字段。BytePlus 自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在**顶层**返回,作为 `content` 的同级字段。Seedance 视频任务查询就是在这里返回该字段的。这是 BytePlus 自身的字段,原样透传。 - 生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自身的字段,在成功的视频任务中返回,并原样透传。 - 任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自身的字段,在成功的视频任务中返回,并原样透传。 格式:`int64` - 任务的状态 + 任务状态 - 可能的值:`queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -428,7 +431,7 @@ false: 不返回已生成视频的最后一帧图像。 - 请求的 token 使用量 + 该请求的 token 用量 @@ -436,7 +439,7 @@ false: 不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/krea/krea-2-large/code.mdx b/zh/development/comfy-router/models/krea/krea-2-large/code.mdx index bfd0046775..ec1b659e46 100644 --- a/zh/development/comfy-router/models/krea/krea-2-large/code.mdx +++ b/zh/development/comfy-router/models/krea/krea-2-large/code.mdx @@ -2,17 +2,18 @@ title: "使用 Comfy Router 调用 Krea 2 Large" description: "通过 Comfy Router 调用 krea/krea-2-large:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Krea 2 Large" -translationSourceHash: a4fdfae2 +translationSourceHash: 19dca448 translationFrom: development/comfy-router/models/krea/krea-2-large/code.mdx translationBlockHashes: "_intro": bd2a615c "Quick start": 5d997ba7 - "Schema": d755f939 + "Schema": 9e43627e "Examples": 91f72543 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/krea/krea-2-large.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ curl https://api.comfy.org/v2/models/krea/krea-2-large/requests/$REQUEST_ID \ 格式:`date-time` + + 仅在 status 为 failed 时设置。已取消的任务不携带此项。 + + + + 作业失败的原因:content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal 或 node_app_node_failed。未知的代码一律按 internal 处理。 + + + + 可选。提供商为 provider_error 和 internal 提供的自由格式文本。 + + + + 需要更改的请求参数,在 invalid_request 和 validation_failed 时出现。 + + 格式:`uuid` diff --git a/zh/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx b/zh/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx index 77fb0fece2..69c0a1961a 100644 --- a/zh/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx +++ b/zh/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx @@ -2,17 +2,18 @@ title: "将 Krea 2 Medium Turbo 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 krea/krea-2-medium-turbo:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Krea 2 Medium Turbo" -translationSourceHash: f61cb3f9 +translationSourceHash: 5a2af2e1 translationFrom: development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx translationBlockHashes: "_intro": fffee1bd "Quick start": a305dd42 - "Schema": f06a0da8 + "Schema": 7e1ae995 "Examples": 91f72543 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-2-medium-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ curl https://api.comfy.org/v2/models/krea/krea-2-medium-turbo/requests/$REQUEST_ 格式:`date-time` + + 仅在状态为 failed 时设置。已取消的任务不包含此字段。 + + + + 任务失败的原因:content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal 或 node_app_node_failed。遇到未知代码时按 internal 处理。 + + + + 可选。用于 provider_error 和 internal 的提供商自由格式文本。 + + + + 需要更改的请求参数,在 invalid_request 和 validation_failed 时出现。 + + 格式:`uuid` diff --git a/zh/development/comfy-router/models/krea/krea-2-medium/code.mdx b/zh/development/comfy-router/models/krea/krea-2-medium/code.mdx index 92571dd5a2..3ba69624d5 100644 --- a/zh/development/comfy-router/models/krea/krea-2-medium/code.mdx +++ b/zh/development/comfy-router/models/krea/krea-2-medium/code.mdx @@ -2,17 +2,18 @@ title: "配合 Comfy Router 使用 Krea 2 Medium" description: "通过 Comfy Router 调用 krea/krea-2-medium:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Krea 2 Medium" -translationSourceHash: a7f31b9b +translationSourceHash: 8c847fd4 translationFrom: development/comfy-router/models/krea/krea-2-medium/code.mdx translationBlockHashes: "_intro": d62bc601 "Quick start": 1f018136 - "Schema": 926b5274 + "Schema": 2e249b0f "Examples": 91f72543 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/krea/krea-2-medium.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ curl https://api.comfy.org/v2/models/krea/krea-2-medium/requests/$REQUEST_ID \ 格式:`date-time` + + 仅在状态为失败时设置。已取消的任务不包含此项。 + + + + 作业失败的原因:content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal 或 node_app_node_failed。未知的代码请按 internal 处理。 + + + + 可选。provider_error 和 internal 时提供商的自由格式文本。 + + + + 需要更改的请求参数,在 invalid_request 和 validation_failed 时出现。 + + 格式:`uuid` diff --git a/zh/development/comfy-router/models/krea/krea-2/code.mdx b/zh/development/comfy-router/models/krea/krea-2/code.mdx index 5c36e93aa7..e173eccf93 100644 --- a/zh/development/comfy-router/models/krea/krea-2/code.mdx +++ b/zh/development/comfy-router/models/krea/krea-2/code.mdx @@ -2,17 +2,18 @@ title: "在 Comfy Router 中使用 Krea 2" description: "通过 Comfy Router 调用 krea/krea-2:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Krea 2" -translationSourceHash: 12dc5e3a +translationSourceHash: 72216188 translationFrom: development/comfy-router/models/krea/krea-2/code.mdx translationBlockHashes: "_intro": 5d115bf3 "Quick start": 2cc5fba4 - "Schema": 360d2f7e + "Schema": 5a67f0ed "Examples": 91f72543 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/krea/krea-2.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -236,6 +237,22 @@ curl https://api.comfy.org/v2/models/krea/krea-2/requests/$REQUEST_ID \ 格式:`date-time` + + 仅在 status 为 failed 时设置。已取消的任务不携带此字段。 + + + + 任务失败的原因:content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal 或 node_app_node_failed。未知的代码一律按 internal 处理。 + + + + 可选。provider_error 和 internal 时由提供商提供的自由格式文本。 + + + + 需要更改的请求参数,在 invalid_request 和 validation_failed 时出现。 + + 格式:`uuid` diff --git a/zh/development/comfy-router/models/krea/krea-3/code.mdx b/zh/development/comfy-router/models/krea/krea-3/code.mdx index f620c67b11..083a81383c 100644 --- a/zh/development/comfy-router/models/krea/krea-3/code.mdx +++ b/zh/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用 Krea 3" description: "通过 Comfy Router 调用 krea/krea-3:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Krea 3" -translationSourceHash: 56990dce +translationSourceHash: eee80c65 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": c0a0ccaf + "Schema": dbedda04 "Examples": 276619d9 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/krea/krea-3.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -199,6 +200,22 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ 格式:`date-time` + + 仅在 status 为 failed 时设置。已取消的任务不包含此字段。 + + + + 作业失败的原因:content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal 或 node_app_node_failed。遇到未知代码时按 internal 处理。 + + + + 可选。provider_error 和 internal 情况下由提供商提供的自由格式文本。 + + + + 需要更改的请求参数,在 invalid_request 和 validation_failed 时出现。 + + 格式:`uuid` diff --git a/zh/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx b/zh/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx new file mode 100644 index 0000000000..912a69a68b --- /dev/null +++ b/zh/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx @@ -0,0 +1,324 @@ +--- +title: "通过 Comfy Router 使用 MiniMax H3 Image Highspeed" +description: "通过 Comfy Router 调用 minimax/minimax-h3-image-highspeed:端点、请求形状以及 Router 返回的响应。" +sidebarTitle: "MiniMax H3 Image Highspeed" +translationSourceHash: 49584805 +translationFrom: development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx +translationBlockHashes: + "_intro": 3fd3bae8 + "Quick start": e37c76df + "Schema": 5c07b006 + "Examples": b42d5c4e +--- +{/* GENERATED FILE. 由 `pnpm code-pages:gen` 从 router-schemas/minimax/minimax-h3-image-highspeed.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`minimax/minimax-h3-image-highspeed` 的 API 参考,由 Comfy Router 提供,来自 MiniMax。 + +**输入:** 文本、图像 · **输出:** 图像 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 片段是通过原始 HTTP 进行的相同调用。 + +**模型 ID:** `minimax/minimax-h3-image-highspeed` + +**端点:** `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "minimax/minimax-h3-image-highspeed", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("minimax/minimax-h3-image-highspeed", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" +``` + + + +请求体相同,发送到 `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests`。一旦运行被受理,Router 就会以 `201` 返回 `request_id`;结果就绪后即可从当前进程或另一个进程收集。[队列投递](/zh/development/comfy-router/queue) 会逐步介绍状态、取消和收集的处理流程。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "minimax/minimax-h3-image-highspeed", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # 加上模型 ID,就是另一个进程所需的全部信息 + + # 轮询直到请求完成,并等待服务器指定的 Retry-After 时间。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自身的载荷,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在此处抛出带类型的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("minimax/minimax-h3-image-highspeed", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 会以 201 返回 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" + +# 2. 轮询直到状态为 COMPLETED,并等待每个响应指定的 Retry-After 秒数。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。完成时返回 200 和模型的原生输出;仍在运行时返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 当省略 `size` 或为 `auto` 时,输出面积级别。取值为 `1K`、`2K`、`4K`(默认)。 + + + + 当省略 `size` 或为 `auto` 时,输出宽高比。`auto`(默认)或介于 1:3 到 3:1 之间的 `X:Y`,例如 `16:9`。 + + + + 关闭 MiniMax 的提示词增强功能。需要固定的 `size` 或 `X:Y` 形式的 `aspect_ratio`。 + + + + 可选的参考图像。存在时,请求将作为图像编辑执行,与 edits 路由上完全一致。 + + + + 公开的 http(s) URL 或 `data:image/;base64,` URI。JPEG、PNG、WEBP、HEIC 或 HEIF,每边 128 到 8192 px,长边最多为短边的 4 倍。 + + + + 模型名。`MiniMax-H3-Image` 或 `MiniMax-H3-Image-Highspeed`。Router 调用方可以省略此字段或发送 null;Router 会填入请求路径所选择的模型。 + + + + 图像数量。输入 token 按每张图像计费一次。 + + 取值范围:`1` 到 `10` + + + + `jpeg` 和 `webp` 的压缩质量,默认 95。 + + 取值范围:`0` 到 `100` + + + + 输出图像格式。取值为 `png`、`jpeg`、`jpg`(默认)、`webp`。 + + + + 图像的文本描述。与 `images` 一起使用时,为编辑的描述;参考图像按数组顺序依次为图像 1、图像 2 等。 + + + + 输出尺寸,`auto`(默认)或 `WIDTHxHEIGHT`(例如 `2720x1536`)。固定尺寸的面积必须为 655,360 到 20,000,000 像素,宽高比介于 1:3 和 3:1 之间,且不能与 `aspect_ratio` 或 `area` 组合使用。 + + +生成自 Router 在 `GET /v2/models/minimax/minimax-h3-image-highspeed/openapi.json` 提供的 schema,该 schema 与请求到达提供商之前 Router 用于校验调用的文档相同。 + +### 输出 + + + 格式:`int64` + + + + + + + + 仅当该图像失败或被拦截时存在。 + + + + + + + + + + + + MiniMax 为此图像使用的提示词。 + + + + 实际图像尺寸,格式为 `WIDTHxHEIGHT`。 + + + + 生成图像的 URL。该 URL 会过期,请下载图像。 + + + + + + + + + + + + 成功图像的 token 用量。计费基于此。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## 示例 + +### 输入 + +```json +{ + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background." +} +``` + +### 输出 + +```json +{ + "created": 1794300000, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/minimax/minimax-h3-image/generated.jpg" + } + ], + "output_format": "jpeg", + "request_id": "06a1b2c3d4e5f60718293a4b5c6d7e8f", + "usage": { + "generated_images": 1, + "input_tokens": 10, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 10 + }, + "output_tokens": 1024, + "output_tokens_details": { + "image_tokens": 1024 + }, + "total_tokens": 1034 + } +} +``` + + diff --git a/zh/development/comfy-router/models/minimax/minimax-h3-image/code.mdx b/zh/development/comfy-router/models/minimax/minimax-h3-image/code.mdx new file mode 100644 index 0000000000..870a098303 --- /dev/null +++ b/zh/development/comfy-router/models/minimax/minimax-h3-image/code.mdx @@ -0,0 +1,324 @@ +--- +title: "通过 Comfy Router 使用 MiniMax H3 Image" +description: "通过 Comfy Router 调用 minimax/minimax-h3-image:端点、请求形状以及 Router 返回的响应。" +sidebarTitle: "MiniMax H3 Image" +translationSourceHash: 1dbc0ccb +translationFrom: development/comfy-router/models/minimax/minimax-h3-image/code.mdx +translationBlockHashes: + "_intro": 21c027f1 + "Quick start": 122cc9f4 + "Schema": af54b1a6 + "Examples": b42d5c4e +--- +{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/minimax/minimax-h3-image.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`minimax/minimax-h3-image` 的 API 参考,由 Comfy Router 提供,模型来自 MiniMax。 + +**输入:** 文本、图像 · **输出:** 图像 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段则是通过原始 HTTP 发出的同一调用。 + +**模型 ID:** `minimax/minimax-h3-image` + +**端点:** `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用。 +with Comfy() as client: + result = client.models.run( + "minimax/minimax-h3-image", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用。 +const { data } = await comfy.models.run("minimax/minimax-h3-image", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests`。一旦运行被接纳,Router 就会返回 `201` 和一个 `request_id`,结果在就绪后即可收集,可由本进程或另一个进程完成。[队列交付](/zh/development/comfy-router/queue)详细介绍了状态、取消与收集。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量读取 COMFY_API_KEY。 +# 每次调用 submit() 都会生成自己的 Idempotency-Key,并在自动重试时复用。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "minimax/minimax-h3-image", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # 配合模型 ID,这就是另一个进程所需的全部信息 + + # 轮询直到请求完成,等待服务器指定的 Retry-After。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自己的载荷,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在这里抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// 每次调用 submit() 都会生成自己的 Idempotency-Key,并在自动重试时复用。 +const handle = await comfy.models.submit("minimax/minimax-h3-image", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并带有 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" + +# 2. 轮询直到 status 为 COMPLETED,每次响应都会指明需要等待的 Retry-After 秒数。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。200 返回模型的原生输出,202 表示仍在运行并返回状态体。 +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 当省略 `size` 或 `size` 为 `auto` 时的输出面积级别。取值为 `1K`、`2K`、`4K`(默认)。 + + + + 当省略 `size` 或 `size` 为 `auto` 时的输出宽高比。`auto`(默认),或 1:3 到 3:1 之间的 `X:Y`,例如 `16:9`。 + + + + 关闭 MiniMax 的提示词增强。需要搭配固定的 `size` 或 `X:Y` 形式的 `aspect_ratio`。 + + + + 可选的参考图像。存在时,请求将以图像编辑方式执行,与编辑路由完全一致。 + + + + 公开的 http(s) URL,或 `data:image/;base64,` URI。支持 JPEG、PNG、WEBP、HEIC 或 HEIF,每边 128 至 8192 px,长边不超过短边的 4 倍。 + + + + 模型名。`MiniMax-H3-Image` 或 `MiniMax-H3-Image-Highspeed`。Router 调用方可以省略此字段或发送 null;Router 会填入由请求路径所选的模型。 + + + + 图像数量。输入 token 按每张图像计费一次。 + + 范围:`1` 到 `10` + + + + `jpeg` 和 `webp` 的压缩质量,默认 95。 + + 范围:`0` 到 `100` + + + + 输出图像格式。取值为 `png`、`jpeg`、`jpg`(默认)、`webp`。 + + + + 图像的文字描述。与 `images` 一起使用时,为编辑的描述;参考图像按数组顺序依次为图像 1、图像 2,以此类推。 + + + + 输出尺寸,`auto`(默认)或 `WIDTHxHEIGHT`,例如 `2720x1536`。固定尺寸的面积必须为 655,360 至 20,000,000 像素,宽高比在 1:3 到 3:1 之间,且不能与 `aspect_ratio` 或 `area` 同时使用。 + + +由 Router 在 `GET /v2/models/minimax/minimax-h3-image/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前校验调用所用的同一份文档。 + +### 输出 + + + 格式:`int64` + + + + + + + + 仅当该图像失败或被拦截时存在。 + + + + + + + + + + + + MiniMax 为该图像使用的提示词。 + + + + 实际图像尺寸,格式为 `WIDTHxHEIGHT`。 + + + + 生成图像的 URL。该 URL 会过期,请下载图像。 + + + + + + + + + + + + 成功图像的 token 用量。计费以此为基础。 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## 示例 + +### 输入 + +```json +{ + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background." +} +``` + +### 输出 + +```json +{ + "created": 1794300000, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/minimax/minimax-h3-image/generated.jpg" + } + ], + "output_format": "jpeg", + "request_id": "06a1b2c3d4e5f60718293a4b5c6d7e8f", + "usage": { + "generated_images": 1, + "input_tokens": 10, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 10 + }, + "output_tokens": 1024, + "output_tokens_details": { + "image_tokens": 1024 + }, + "total_tokens": 1034 + } +} +``` + + diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index 309178558b..4f562296bb 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,23 +2,22 @@ title: "将 Grok Imagine Image 2.0 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 xai/grok-imagine-image-2.0:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: e062dc40 +translationSourceHash: a292528e translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: - "_intro": 614e2e15 + "_intro": 6a561296 "Quick start": ff9945c8 - "Schema": cb29dfae + "Schema": f435c296 "Examples": 3222291b --- - {/* GENERATED FILE. 由 `pnpm code-pages:gen` 从 router-schemas/xai/grok-imagine-image-2.0.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; `xai/grok-imagine-image-2.0` 的 API 参考,该模型由 Comfy Router 从 xAI 提供。 -**输入:** 文本 · **输出:** 图像 +**输入:** 图像、文本 · **输出:** 图像 ## 快速开始 @@ -174,7 +173,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,编辑时使用 medium)。其他模型会忽略此项。 - 可能的值:`low`、`medium`、`high`、`auto` + 可选值:`low`、`medium`、`high`、`auto` @@ -184,7 +183,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES - 返回图像时使用的响应格式。可以是 url 或 b64_json。Comfy 会在出站请求中将其强制转换为 `url`:无论是在 Comfy Router 的调度(`POST /v2/models/xai/{model}`)中,还是在此 `/proxy/` 路由上都是如此,因为图像结果无论采用哪种格式都以重新托管的 URL 提供。enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都不会被强制转换,而是会被拒绝,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同:在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换;Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员,要在该处保持未设置,请省略该字段。 + 返回图像时使用的响应格式。可以是 url 或 b64_json。Comfy 会在出站请求中将其强制转换为 `url`:无论是在 Comfy Router 的调度(`POST /v2/models/xai/{model}`)中,还是在此 `/proxy/` 路由上都是如此,因为图像结果无论采用哪种格式都以重新托管的 URL 提供。因此,枚举内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。枚举之外的值(不包括下文所述两处接口各自识别的 UNSET 写法)在两处都会被拒绝,而不是被强制转换,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布枚举对应的字段级 `422`。两处对 UNSET 的判定不同:在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换;Router 调度严格按公布的枚举执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员,要在该处保持未设置,请省略该字段。 可选值:`url`、`b64_json` @@ -201,6 +200,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES 代表你的最终用户的唯一标识符,可帮助 xAI 监控和检测滥用行为 + + xAI 端点使用的输入图像对象 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + + + 用于多参考编辑的输入图像列表。与 image 互斥。提供多张图像时,请在提示词中以 \、\ 等引用它们。 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + + + xAI 端点使用的输入图像对象 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + 根据 Router 在 `GET /v2/models/xai/grok-imagine-image-2.0/openapi.json` 提供的 schema 生成,这与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index b16b161e13..a70bf3a50f 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,26 +2,25 @@ title: "配合 Comfy Router 使用 Grok Imagine Image Pro" description: "通过 Comfy Router 调用 xai/grok-imagine-image-pro:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: f1412f9d +translationSourceHash: 551ab410 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: - "_intro": 0da8910e + "_intro": 17b18ef8 "Quick start": 3a4bd585 - "Schema": 805c771c + "Schema": 618b5e75 "Examples": 3222291b --- - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/xai/grok-imagine-image-pro.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; 由 Comfy Router 从 xAI 提供的 `xai/grok-imagine-image-pro` API 参考。 -**输入:** 文本 · **输出:** 图像 +**输入:** 图像、文本 · **输出:** 图像 -xAI 已于 [2026 年 5 月 15 日](https://docs.x.ai/developers/migration/may-15-retirement)停用 `grok-imagine-image-pro`,并将其请求转发至 `grok-imagine-image-quality`。xAI 又于 2026 年 11 月 2 日停用 `grok-imagine-image-quality`。现在请求由 `grok-imagine-image-2.0` 以低质量提供服务。参见 [xAI 的迁移通知](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2)。 +xAI 已于 [2026 年 5 月 15 日](https://docs.x.ai/developers/migration/may-15-retirement)停用 `grok-imagine-image-pro`,并将请求转发至 `grok-imagine-image-quality`。xAI 又于 2026 年 11 月 2 日停用 `grok-imagine-image-quality`。现在请求由 `grok-imagine-image-2.0` 以低质量提供服务。参见 [xAI 的迁移通知](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2)。 ## 快速开始 @@ -162,7 +161,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES - 要使用的模型。支持:grok-imagine-image(默认)、grok-imagine-image-pro、grok-imagine-image-quality、grok-imagine-image-2.0。弃用的 -beta id 会被别名到其 GA 模型。 + 要使用的模型。支持:grok-imagine-image(默认)、grok-imagine-image-pro、grok-imagine-image-quality、grok-imagine-image-2.0。弃用的 -beta id 会作为别名指向其 GA 模型。 @@ -178,7 +177,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,编辑时使用 medium)。其他模型会忽略此项。 - 可能的值:`low`、`medium`、`high`、`auto` + 可选值:`low`、`medium`、`high`、`auto` @@ -205,6 +204,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES 代表你的最终用户的唯一标识符,可帮助 xAI 监控和检测滥用行为 + + xAI 端点的输入图像对象 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的 data URI) + + + + 用于多参考编辑的输入图像列表。与 image 互斥。提供多张图像时,请在提示词中将它们分别称为 \、\ 等。 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的 data URI) + + + + xAI 端点的输入图像对象 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的 data URI) + + 根据 Router 在 `GET /v2/models/xai/grok-imagine-image-pro/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前 Router 用于校验调用的同一份文档。 ### 输出 diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index 96c5a68406..0651a4cc6b 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,23 +2,22 @@ title: "配合 Comfy Router 使用 Grok Imagine Image Quality" description: "通过 Comfy Router 调用 xai/grok-imagine-image-quality:端点、请求结构与 Router 返回的响应。" sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 2768f32e +translationSourceHash: 1bac2ebc translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: - "_intro": 7220f036 + "_intro": 77db165f "Quick start": 799275b8 - "Schema": e2c96ff6 + "Schema": 052399f6 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-quality.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; `xai/grok-imagine-image-quality` 的 API 参考,由 Comfy Router 提供,来自 xAI。 -**输入:** 文本 · **输出:** 图像 +**输入:** 图像、文本 · **输出:** 图像 xAI 已于 2026 年 11 月 2 日停用 `grok-imagine-image-quality`。现在请求由 `grok-imagine-image-2.0` 以低质量提供服务。参见 [xAI 的迁移通知](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2)。 @@ -178,7 +177,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,编辑时使用 medium)。其他模型会忽略此项。 - 可能的值:`low`、`medium`、`high`、`auto` + 可选值:`low`、`medium`、`high`、`auto` @@ -205,6 +204,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE 代表你的终端用户的唯一标识符,可帮助 xAI 监控和检测滥用行为 + + xAI 端点的输入图像对象 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + + + 用于多参考编辑的输入图像列表。与 image 互斥。提供多张图像时,请在提示词中以 \、\ 等引用它们。 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + + + xAI 端点的输入图像对象 + + + + 图像输入的类型 + + 可选值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + 根据 Router 在 `GET /v2/models/xai/grok-imagine-image-quality/openapi.json` 提供的 schema 生成,这是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 70f243a657..31824062c8 100644 --- a/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,23 +2,22 @@ title: "使用 Grok Imagine Image 与 Comfy Router" description: "通过 Comfy Router 调用 xai/grok-imagine-image:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Grok Imagine Image" -translationSourceHash: 2e5c55ad +translationSourceHash: 892f31a7 translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: - "_intro": a2e97c88 + "_intro": 0a2a8c08 "Quick start": a5495331 - "Schema": 171da7d5 + "Schema": f924d818 "Examples": 3222291b --- - {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; `xai/grok-imagine-image` 的 API 参考文档,由 Comfy Router 提供,来源于 xAI。 -**输入:** 文本 · **输出:** 图像 +**输入:** 图像、文本 · **输出:** 图像 ## 快速开始 @@ -184,7 +183,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID - 返回图像所用的响应格式。可以是 url 或 b64_json。Comfy 会在对外请求中将其强制转换为 `url`,无论是在 Comfy Router 的调度(`POST /v2/models/xai/{model}`)上,还是在这条 `/proxy/` 路由上,因为图像结果无论如何都以重新托管的 URL 形式提供。enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都不会被强制转换,而是会被拒绝,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同:在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换;Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员,要在该处保持未设置,请省略该字段。 + 返回图像所用的响应格式。可以是 url 或 b64_json。Comfy 会在对外请求中将其强制转换为 `url`,无论是在 Comfy Router 的调度(`POST /v2/models/xai/{model}`)上,还是在这条 `/proxy/` 路由上,因为图像结果无论如何都以重新托管的 URL 形式提供。因此,enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都不会被强制转换,而是会被拒绝,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同。在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换。Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员:要在该处保持未设置,请省略该字段。 可能的值:`url`, `b64_json` @@ -201,6 +200,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID 代表你的最终用户的唯一标识符,可帮助 xAI 监控和检测滥用行为 + + xAI 端点使用的输入图像对象 + + + + 图像输入的类型 + + 可能的值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + + + 用于多参考编辑的输入图像列表。与 image 互斥。当提供多张图像时,请在提示词中以 \、\ 等指代它们。 + + + + 图像输入的类型 + + 可能的值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + + + xAI 端点使用的输入图像对象 + + + + 图像输入的类型 + + 可能的值:`image_url` + + + + 输入图像的 URL(公开 URL 或 base64 编码的数据 URI) + + 本文档由 Router 在 `GET /v2/models/xai/grok-imagine-image/openapi.json` 提供的 schema 生成,这与请求到达提供商之前 Router 用于校验调用的文档完全相同。 ### 输出 diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 7d8862956f..781356e26a 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -2,7 +2,7 @@ title: "Comfy Router API 参考" description: "每个 Comfy Router 端点、参数、响应体和错误分类,均由 Comfy API 契约生成。" sidebarTitle: "API 参考" -translationSourceHash: f49adc91 +translationSourceHash: e8d9375f translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 @@ -12,7 +12,7 @@ translationBlockHashes: "Pre-flight cost estimates": 7405db0d "Result assets": 3520a8bf "Per-model input and output schemas": 61c6bde8 - "Schemas": 9738e3aa + "Schemas": 35b5a3bc --- @@ -29,6 +29,7 @@ translationBlockHashes: + {/* 生成的文件:请勿手动编辑。 @@ -1101,36 +1102,36 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ ### RouterBilledWorkspace -被拒绝的调用原本会扣费的钱包,位于 `RouterErrorResponse.billed_workspace`。它回答的是“哪个钱包是空的?”这一问题:它不一定是调用方 UI 当前已选择的工作区,而且团队成员使用个人凭证时,即使已打开一个有余额的团队,这里列出的仍是其个人钱包。仅在同时存在 `denied_reason` 时出现。 +被拒绝的调用原本会扣费的那个钱包,位于 `RouterErrorResponse.billed_workspace`。它回答的是“哪个钱包是空的?”这一问题:它不一定是调用方 UI 当前已选择的工作区,而且团队成员的个人凭证在这里指向的是其个人钱包,即使当前打开的是一个有余额的团队。仅与 `denied_reason` 一同出现。 **字段** - 云端工作区 id。在传统通道上不存在。 + 云端工作区 id。在传统计费轨道上不存在。 - `personal` 或 `team`。这是一个开放字符串:遇到任何其他值都按个人处理。 + `personal` 或 `team`。这是一个开放字符串:任何其他值都按个人处理。 - 当调用计费到调用方在工作区出现之前的 Metronome 客户、而非云端工作区时,为 `legacy`;该客户没有工作区 id。对于云端工作区,此字段不存在。 + 当调用计费的对象是调用方在引入工作区之前的 Metronome 客户,而不是云端工作区时,为 `legacy`;该客户没有工作区 id。对于云端工作区则不存在。 ### RouterChargesOnPolicyRejection -此模型的内容策略拒绝是否计费。未知值按可能计费处理。 +此模型在内容策略拒绝时是否计费。将未知值视为可能计费。 类型:`string` ### RouterCostEstimate -调用前的预检估算,用于说明本次调用的费用(以美元计):在调度前按 Comfy 标准标价计价;对于按提供商报告的费用计费的模型,则取自提供商公布的价目表。对于这种由提供商报告费用的情形,仅在少量已选择加入的模型上返回 `source: exact`,并且仅当公布的价目表完全确定该金额时(每个影响价格的字段都已明确给出,或保留在不会改变该金额的默认值);其余所有由提供商报告的报价都是 `estimated`,其中也包括一些价目表本可完全确定的报价。无论哪种情况,运行完成后仍按提供商报告的费用计费,绝不会原样按报价金额收费。它不反映合同费率或客户特定费率:有协商定价的工作区会按标价报价,但按其合同费率收费,此时 `source: exact` 表示按标价精确,而非该工作区的实际收费。它不是最终费用:你支付的是工作区用量和账单记录中的结算费用。运行后报告的 `X-Comfy-Credits-Used` 是四舍五入的事后数字,不是收据。`source` 表示该数字的可信程度:`exact` 携带 `amount`;`free` 携带 `amount` "0"(费率卡将此请求计价为零);`estimated` 携带 `min_amount` 和 `max_amount`,不携带 `amount`;`unknown` 两者都不携带,并携带 `reason`。切勿将缺失的 `amount` 理解为免费。它不是价格锁定:见 `pricing_as_of`。 +这是对本次调用将产生多少费用的预检估算,以美元计。它在派发之前按 Comfy 的标准目录价计价;对于按厂商上报成本计费的模型,则按厂商公布的价格表计价。对于后者,只有在少数主动选择加入的模型上,且只有在公布的价格表能完全确定该数字时(每个影响价格的字段都已明确给出,或保留在不会改变结果的默认值上),才会返回 `source: exact`;其他所有厂商上报的报价都是 `estimated`,其中包括一些价格表本可完全确定的报价。无论哪种情况,运行结束后仍按厂商上报的金额计费,绝不会原样照搬报价数字。它不反映合同价或客户专属费率:设有协商定价的工作区按目录价报价、按合同费率收费,此时 `source: exact` 表示在目录价上是精确的,并不代表该工作区的实际扣费。它不是最终费用:你实际支付的是工作区用量与账单记录中的结算费用。运行结束后返回的 `X-Comfy-Credits-Used` 是四舍五入的事后数字,不是收据。`source` 说明该数字的可信程度:`exact` 携带 `amount`;`free` 携带 `amount` "0"(费率卡将本次请求计价为零);`estimated` 携带 `min_amount` 和 `max_amount`,不带 `amount`;`unknown` 两者都不带,只有 `reason`。绝不要把缺失的 `amount` 读作免费。它不是价格锁定:见 `pricing_as_of`。 **字段** - `exact` | `estimated` | `free` | `unknown`;其他任何值都按 `unknown` 处理。`exact` 和 `estimated` 都表示估算;两者都不是最终费用。`free` 表示费率卡将此请求计价为零,因此 `amount` 为 "0"。`unknown` 不携带任何金额。 + `exact` | `estimated` | `free` | `unknown`;其他任何值都按 `unknown` 读取。`exact` 和 `estimated` 标注的都是估算值;两者都不是最终费用。`free` 表示费率卡将本次请求计价为零,因此 `amount` 为 "0"。`unknown` 不携带任何数字。 @@ -1138,59 +1139,58 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ - 预估费用,以美元表示,为十进制字符串,例如 "0.04",最多 8 位小数且不使用指数。可计费的低于 1 美分的价格绝不会显示为 "0";只有 `free` 报价显示 "0"。仅在 `source` 为 `exact` 或 `free` 时出现。它不是最终费用:最终费用是工作区用量和账单记录中的结算费用。 + 估算费用,以十进制字符串表示的美元金额,例如 "0.04",最多 8 位小数且不使用指数。可收费的亚分价格绝不会显示为 "0";只有 `free` 报价才显示 "0"。仅在 `source` 为 `exact` 或 `free` 时出现。它不是最终费用:最终费用是工作区用量与账单记录中的结算费用。 - 预估金额的下限,以美元表示,为十进制字符串。它只是估算,不是保证下限:调用实际收费可能更低,例如提供商返回的数量少于请求(例如没有返回图像)、估算值是根据过往调用学习到的典型价格,或价格未随请求数量稳定上升。仅在 `source` 为 `estimated` 时出现。 + 估算区间的下限,以十进制字符串表示的美元金额。它是估算值,不是保底下限:一次调用的计费可能更低,例如提供商返回的内容少于请求(比如没有返回图像)、估算值是根据过往调用学到的典型价格,或价格并不随请求的数量稳步上升。仅在 `source` 为 `estimated` 时出现。 - 预估金额的上限,以美元表示,为十进制字符串。它只是估算,不是保证上限:调用实际收费可能更高,例如提供商返回的数量多于请求(例如返回的图像数量超过请求数量)、估算值是根据过往调用学习得到的,或价格未随请求数量稳定上升。仅在 `source` 为 `estimated` 时出现。 + 估算区间的上限,以十进制字符串表示的美元金额。它是估算值,不是保底上限:一次调用的计费可能更高,例如提供商返回的内容多于请求(比如返回的图像多于请求数量)、估算值是根据过往调用学到的,或价格并不随请求的数量稳步上升。仅在 `source` 为 `estimated` 时出现。 - 同一金额以美分表示,不四舍五入,供计算使用。与 `amount` 一同出现。 + 同一数字以美分表示,不四舍五入,便于算术运算。与 `amount` 一同出现。 double - `min_amount` 对应的美分金额,不四舍五入。与 `min_amount` 一同出现。 + `min_amount` 以美分表示,不四舍五入。与 `min_amount` 一同出现。 double - `max_amount` 对应的美分金额。与 `max_amount` 一同出现。 + `max_amount` 以美分表示。与 `max_amount` 一同出现。 double - `amount` 按平台换算比例($1 = 211 积分)折算成的 Comfy 积分,四舍五入到 2 位小数,也就是在 `exact` 报价下 `X-Comfy-Credits-Used` 预期携带的数值。该响应头是四舍五入的事后数字,不是收据;工作区用量和账单记录中的结算费用才是最终费用。 + `amount` 按平台换算($1 = 211 积分)折算成的 Comfy 积分数,四舍五入到 2 位小数,也就是 `exact` 报价下 `X-Comfy-Credits-Used` 预期携带的数字。该响应头是四舍五入的事后数字,不是收据;工作区用量与账单记录中的结算费用才是最终结果。 double - 此报价对应的提供商线路。对于已排队的提交,它就是将要运行的线路。 + 本次报价对应的提供商环节。在已排队的提交中,它就是将要运行的环节。 - 规范的 Comfy Router 模型 ID,`{provider}/{model}`,正是用于在 `POST /v2/models/{provider}/{model}` 上定位该模型的值,因此调用方可以将其插入该路径,而无需从其他任何内容重新推导。其 `pattern` 为 `RouterProviderSegment` 和 `RouterModelSegment` 以单个 `/` 连接,`maxLength` 为二者长度之和再加上该分隔符。 + 规范的 Comfy Router 模型 ID,即 `{provider}/{model}`,它正是用于在 `POST /v2/models/{provider}/{model}` 上寻址该模型的值,因此调用方可以直接把它插入该路径,无需从其他信息重新推导。其 `pattern` 由 `RouterProviderSegment` 和 `RouterModelSegment` 以单个 `/` 连接而成,`maxLength` 为两者长度之和再加上该分隔符。 - 类型:[`RouterModelId`](#routermodelid),模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 + 类型:[`RouterModelId`](#routermodelid) -- 模型 ID,例如 `anthropic/claude-opus-4-6`,最长 193 个字符 - 此报价所依据的费率卡的获取时间。该估算不是价格锁定:运行会按计费时生效的费率收费,而不是按此时间点的费率。从提供商公布的价目表取得的 `estimated` 报价(即按提供商报告的费用计费的模型)则携带读取该价目表的日期。如果报价的计费数量是根据提供商公布的费率表预测得出,然后再按费率卡计价,则该报价携带该费率表读取日期与费率卡获取时间中较早的一个;`exact` 和 `estimated` 结果都是如此(按提供商报告的积分计费的模型属于 `estimated` 情况)。如果没有读取任何费率卡(`reason: pricing_unavailable`、`byok`,或无法根据任何费率卡计价的 `not_quotable` 调用),则此时间为报价答复的时间。 + 本次报价所依据的费率卡的获取时间。估算不是价格锁定:运行按计费时生效的费率收费,而不是按这一时刻的费率。取自厂商公布价格表的 `estimated` 报价(即按厂商上报成本计费的模型)携带的则是读取该价格表的日期。如果一笔报价的计费数量是根据公布的厂商价目表预测、再按费率卡定价的,那么无论最终答案是 `exact` 还是 `estimated`(按厂商上报积分计费的模型属于 `estimated` 情形),它携带的都是该价目表读取日期与费率卡获取时间中较早的那个。如果根本没有读取任何费率卡(`reason: pricing_unavailable`、`byok`,或无法从任何费率卡定价的 `not_quotable` 调用),则此处是给出该报价的时间。 date-time - - 仅在 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在运行之前为本次调用定价,因为其价格取决于提供商回传的内容,或者请求体未限定计费数量)、`unpriced_model`(费率卡片未对本次请求定价)、`byok`(仅限已执行提交:该运行使用你自己的提供商密钥,因此 Comfy 不为其计费)、或 `pricing_unavailable`(仅限已执行提交:在请求被接纳时无法读取费率卡片;这是暂时性的,该运行仍照常计费)。其他任何值均按 `not_quotable` 理解。 +仅当 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在调用运行之前为其定价,价格取决于提供商回传的内容,或者请求体未限定计费数量)、`unpriced_model`(费率卡片未对该请求定价)、`byok`(仅适用于已执行提交:该运行使用你自己的提供商密钥,因此 Comfy 不为此计费),或 `pricing_unavailable`(仅适用于已执行提交:请求被受理时无法读取费率卡片;这是暂时性的,该运行仍照常计费)。读取到任何其他值时,一律视为 `not_quotable`。 ### RouterErrorResponse @@ -1200,66 +1200,65 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ **字段** - 人类可读的失败描述,可安全地展示给最终用户。它不用于机器解析:请改为根据 `error_type` 分支。对于已退役模型上的 `model_not_found`,当记录的后继模型存在且对调用方可见时,`detail` 显示为 ` was retired on ; use `;若不可见,则只显示 ` was retired on `,而不是通常的建议列表。此处给出的后继模型始终是目录中的有效 ID,调用可以重新指向它。停用日期仍在未来的模型不算已退役:它仍会由 `GET /v2/models` 列出,并在此日期之前保持可运行。与 `detail` 的其余部分一样,这段退役措辞仅用于展示,不附带任何兼容性保证。“不用于机器解析”这条规则有两个已记录的例外:在 `POST /v2/models/{provider}/{model}` 上,`409` 会因三种互不相关但同属 `invalid_input` 分类的情况而返回,只有 `detail` 能区分它们。以 "this request's `image` selects the edit operation" 开头的 `detail` 是 multipart 的 `model_provider` 拒绝,以 `this request resolved a BYOK credential` 开头的 `detail` 是 BYOK 的 `model_provider` 拒绝;两者都不会因为新的 `Idempotency-Key` 而消除。该路由上其他任何 `invalid_input` 的 `409` 都是键冲突。这两个前缀都是稳定的契约条款,可以被匹配。除此之外,任何地方根据 `detail` 分支都不带兼容性保证。 + 人类可读的失败描述,可安全展示给最终用户。它不会被机器解析,请改为根据 `error_type` 分支处理。对于已退役模型上的 `model_not_found`,当存在继任模型且该模型对调用方可见时,`detail` 为 ` was retired on ; use `;若继任模型不可见,则仅为 ` was retired on `,而不是通常的建议列表。此处指名的继任者始终是目录中的有效 ID,调用可以重新指向它。日落日期仍在未来的模型并未退役:它仍会出现在 `GET /v2/models` 的列表中,并在该日期之前保持可运行。与 `detail` 的其他部分一样,这段退役措辞仅用于展示,不提供任何兼容性保证。“不做机器解析”规则有两个有文档记载的例外:在 `POST /v2/models/{provider}/{model}` 上,`409` 会针对三种互不相关的状况返回,它们共用 `invalid_input` 这个桶,只有 `detail` 能区分它们:以 "this request's `image` selects the edit operation" 开头的 `detail` 是 multipart 的 `model_provider` 拒绝,以 "this request resolved a BYOK credential" 开头的 `detail` 是 BYOK 的 `model_provider` 拒绝;两者都不会因新的 `Idempotency-Key` 而消除。该路由上任何其他 `invalid_input` 的 `409` 都是 key 冲突。这两个前缀都是稳定的契约条款,可以被匹配。除此之外,任何其他位置根据 `detail` 分支都不提供兼容性保证。 - Router 失败的粗粒度、机器可读分类,会同步到 `X-Comfy-Error-Type` 响应头,使调用方无需解析响应体即可分支。该集合封闭于二十个值:六个请求级分类 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`,以及传输级分类 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full` 和 `result_expired`。“封闭”描述的是当前文档中的集合,而不是永远成立的界限:该集合预计会增长,这正是它被刻意定义为普通字符串而非 `enum` 的原因,因此客户端必须将无法识别的值当作 `internal_error` 处理,而不是对上面的列表做穷举 switch,从而在下一次新增值时出错。 + 针对 Router 失败的粗粒度、机器可读的分桶,会同步反映在 `X-Comfy-Error-Type` 响应头上,使调用方无需解析响应体即可分支。该集合封闭为二十个值:六个请求级桶 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`,加上传输级的 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full` 和 `result_expired`。“封闭”描述的是当前文档所载的集合,并非永远成立的边界:该集合预期会增长,这正是此处刻意使用普通字符串而非 `enum` 的原因,因此客户端必须将无法识别的值视为 `internal_error`,而不是对上表做穷举式 switch,从而在下次新增时出错。 - 类型:[`RouterErrorType`](#routererrortype) + Type: [`RouterErrorType`](#routererrortype) - 模型提供商拒绝该请求时给出的、经过净化的长度受限原因,仅在 `error_type` 为 `invalid_input` 且 `X-Comfy-Upstream-Status` 为提供商的 `4xx` 或 `2xx` 时出现,即提供商认为请求格式有误而拒绝了请求并说明了原因。通常该状态是 `4xx`;对于在成功信封内报告生成被拒绝的提供商,它是 `2xx`(BytePlus 的失败任务轮询是 HTTP `200`,原因在响应体中)。在其他所有失败中都不存在,包括提供商 `5xx`、传输失败、内容策略拒绝以及 Router 针对自身提出的任何拒绝。它会同步到 `X-Comfy-Upstream-Detail` 响应头。以 `invalid_input` 结束的运行,其已执行收集(`GET /v2/models/{provider}/{model}/requests/{request_id}`)在第一次收集时会在该字段中带上同样的原因,随后便把它从请求中删除:之后的收集通常返回相同的 `error_type` 和 `detail` 但不包含该字段,因此请从第一次收集中读取。该次收集不会发送这两个响应头。 + `invalid_input` 拒绝的有界、已脱敏的原因。在同步路由上,它是模型提供商给出的原因,仅当 `error_type` 为 `invalid_input` 且 `X-Comfy-Upstream-Status` 是提供商的 `4xx` 或 `2xx` 时存在,即提供商以请求格式错误为由拒绝了请求并说明了原因。通常该状态是 `4xx`;对于在成功信封内报告生成被拒的提供商,它是 `2xx`(BytePlus 的失败任务轮询是 HTTP `200`,原因在其响应体中)。该字段在其他所有失败中都不存在,包括提供商的 `5xx`、传输失败、内容策略拒绝以及 Router 就自身提出的任何拒绝,并且它与 `X-Comfy-Upstream-Detail` 头一致。以 `invalid_input` 结束的运行,其队列收集(`GET /v2/models/{provider}/{model}/requests/{request_id}`)会在首次收集时在此字段中携带相同原因,随后将其从请求中删除:后续收集通常返回相同的 `error_type` 和 `detail` 但不含该字段,因此请从首次收集读取它。那次读取不会发送这两个头。当 Router 在把请求发送给提供商之前就将其拒绝、并能用一句话说明原因时,队列收集也会用此字段承载 Router 自身的原因,而同步路由会在 `detail` 中返回该原因;指名了各个字段的拒绝则不携带任何内容。 - 内容策略拒绝所针对的输入或输出,采用 Router 级的封闭词表:`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio`。当提供商未指明模态时,裸的 `input` / `output` 值用于指明是哪一侧。仅在 `error_type` 为 `content_policy_violation` 且提供商以机器可读代码指明了被拒绝对象时出现;否则不存在。绝不是提供商的文本。目前对 BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI 和 Wan 的拒绝会给出该字段,MiniMax Router 的 Nano Banana 分支中的 Gemini 拒绝也会给出;若提供商的拒绝未说明涉及哪一侧,则该字段不存在。它会同步到 `X-Comfy-Refusal-Subject` 响应头。 + 内容策略拒绝所涉及的输入或输出,采用 Router 层面的封闭词汇:`input`、`output`、`input_text`、`input_image`、`input_video`、`input_audio`、`output_text`、`output_image`、`output_video`、`output_audio`。当提供商未指明模态时,裸的 `input` / `output` 值用于指明是哪一侧。仅当 `error_type` 为 `content_policy_violation` 且提供商以机器可读代码指明了被拒对象时存在;否则不存在。绝不是提供商文本。目前已为 BytePlus、Runway、BFL、Gemini、Veo、Vertex、xAI 和 Wan 万相的拒绝做了命名,也为 MiniMax Router 的 Nano Banana 分支中的 Gemini 拒绝做了命名;若提供商的拒绝未说明涉及哪一侧,则该字段不存在。它与 `X-Comfy-Refusal-Subject` 头一致。 - 计费系统对合作伙伴节点扣费拒绝的策略分支:当被计费钱包为空时为 `no_funds`,当调用被拒绝但没有资金读取结果说明原因时为 `unspecified`。仅在 `error_type` 为 `insufficient_credits` 且部署会上报钱包信息时出现;否则不存在。它是机器可读代码,而非展示文本:展示 `detail`,根据该字段分支。 + 计费针对合作伙伴节点花费拒绝的策略分支:当被计费的钱包为空时为 `no_funds`,当调用被拒但没有任何资金读数说明原因时为 `unspecified`。仅当 `error_type` 为 `insufficient_credits` 且部署会上报钱包事实时存在;否则不存在。它是机器可读代码,而非展示文本:展示 `detail`,对此字段分支。 - 被拒绝的调用原本会扣费的钱包,位于 `RouterErrorResponse.billed_workspace`。它回答“哪个钱包是空的?”:它不一定是调用方 UI 当前选择的工作区,而且团队成员使用个人凭据时,这里给出的是其个人钱包,即使当前打开的是一个余额充足的团队。仅在 `denied_reason` 同时存在时出现。 + 被拒调用本应扣费的钱包,位于 `RouterErrorResponse.billed_workspace`。它回答“哪个钱包是空的?”:它不一定是调用方 UI 当前选中的工作区;即使打开了资金充足的团队,团队成员的个人凭证也会在此指明其个人钱包。仅与 `denied_reason` 一同存在。 - 类型:[`RouterBilledWorkspace`](#routerbilledworkspace) + Type: [`RouterBilledWorkspace`](#routerbilledworkspace) - - 被拒绝的请求是如何认证的:`personal_api_key`、`team_api_key`、`personal_session` 或 `team_session`。它回答“我该切换到哪个凭据来向另一个钱包计费?”。它不是权限,也不授予任何权限。仅在 `denied_reason` 同时存在时出现。 +被拒绝的请求通过哪种方式完成认证:`personal_api_key`、`team_api_key`、`personal_session` 或 `team_session`。用于回答“我该切换到哪个凭据,才能向另一个钱包计费?”。它并非权限,也不授予任何权限。仅与 `denied_reason` 一同出现。 ### RouterErrorType -机器可读的 Router 错误类别,也会通过 `X-Comfy-Error-Type` 请求头一起发送。 +机器可读的 Router 错误类别,同时也会随 `X-Comfy-Error-Type` 响应头一同发送。 -类型:`string` +Type: `string` ### RouterModelBilling -调用模型之前需要检查的计费行为。不包含价格或用量信息。 +在调用模型之前需要检查的计费行为。不包含价格或用量。 **字段** - 当模型因内容政策原因拒绝某次调用时,该调用是否仍向调用方计费。各提供商的做法并不相同,而这种差异在调用时是不可见的:用户在同一次调用中同时看到错误和扣费,也无从预先得知,因此这一行为在调用之前按模型明确说明,而不是留给各提供商口口相传。当该值为 `yes` 时,同步路由上的 `content_policy_violation` 错误可能带有 `X-Comfy-Credits-Used`:当提供商拒绝了模型已生成的输出,且 Comfy 记录了该次被拒绝生成的用量时,就会带有该响应头,其值为对应的数量。输入侧的拒绝、同一密钥的重放(`Idempotent-Replayed: true`),以及小到无法在该响应头的两位小数中体现的扣费,都不会带有它;不带该响应头的拒绝只是未报告,并不代表它是免费的。 + 当此模型因内容政策原因拒绝某次调用时,该调用是否仍会向调用方收费。各提供商的做法不同,这种差异在调用时不可见,而用户若在同一次调用中既看到错误又看到扣费,也无从事先知晓。因此这里要在调用前按模型明确说明,而不是依赖各提供商各自的惯例。当其值为 `yes` 时,同步路由上的 `content_policy_violation` 错误可能会携带 `X-Comfy-Credits-Used`:当提供商拒绝的是模型生成的输出,且 Comfy 已记录该次被拒绝生成的用量时,它会携带该响应头,并包含相应数量。输入端拒绝、同一密钥的重放(`Idempotent-Replayed: true`)以及金额过小、无法在响应头的两位小数中显示的收费都不会携带该响应头;未携带该响应头的拒绝不会被报告,但这并不能证明它是免费的。 类型:[`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) ### RouterModelDetail -针对一个 Comfy Router 模型的逐模型详细信息:包含目录列表为其报告的全部内容,以及只有单模型路由才会携带的逐模型字段。 +单个 Comfy Router 模型的按模型详情:目录列表为其报告的全部内容,以及只有单模型路由才会携带的按模型字段。 -组合了 [`RouterModelListEntry`](#routermodellistentry) 和 [`RouterModelDetailFields`](#routermodeldetailfields)。 +由 [`RouterModelListEntry`](#routermodellistentry)、[`RouterModelDetailFields`](#routermodeldetailfields) 组合而成。 类型:`object` ### RouterModelDetailFields -由模型详情端点返回的可选字段。 +模型详情端点返回的可选字段。 **字段** @@ -1273,19 +1272,19 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ 用于 `POST /v2/models/{provider}/{model}` 的模型 ID。 -类型:`string`,模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 +Type: `string`:模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 ### RouterModelInput -模型输入对象。阅读已选择模型的 OpenAPI 文档,了解字段和验证。 +模型输入对象。请阅读已选择模型的 OpenAPI 文档,了解字段和验证规则。 类型:`object` ### RouterModelInputSchemaDocument -一份独立的 OpenAPI 文档,描述单个模型的输入和输出。 +用于单个模型输入与输出的独立 OpenAPI 文档。 -类型:`object` +Type: `object` ### RouterModelListEntry @@ -1294,223 +1293,223 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ **字段** - 规范的 Comfy Router 模型 ID,`{provider}/{model}`,正是用于在 `POST /v2/models/{provider}/{model}` 上定位该模型的值,因此调用方可以直接把它插入该路径,而无需再从任何来源重新推导。它的 `pattern` 是由单个 `/` 连接的 `RouterProviderSegment` 与 `RouterModelSegment`,`maxLength` 则是两者长度之和再加上该分隔符。 + 规范的 Comfy Router 模型 ID,`{provider}/{model}`,正是用于在 `POST /v2/models/{provider}/{model}` 上定位该模型的那个值,因此调用方可以直接把它插入该路径,而无需从任何其他来源重新推导。它的 `pattern` 是由单个 `/` 连接的 `RouterProviderSegment` 与 `RouterModelSegment`,而 `maxLength` 是两者长度之和再加上该分隔符。 - 类型:[`RouterModelId`](#routermodelid),即模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 + 类型:[`RouterModelId`](#routermodelid),模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 - 规范 `{provider}/{model}` 模型 ID 中小写的 `provider` 段,即所定位模型所属的合作伙伴。调用路由的 `provider` 路径参数与目录条目的 `provider` 字段都引用这同一个 schema,正是这一点让列出的 ID 与接受的 ID 不会逐渐偏离。 + 规范的 `{provider}/{model}` 模型 ID 中的小写 `provider` 段,即所调用模型所属的合作伙伴。调用路由的 `provider` 路径参数与目录条目的 `provider` 字段都引用这一个 schema,正是这一点使得列出的 ID 与实际接受的 ID 不会彼此漂移。 - 类型:[`RouterProviderSegment`](#routerprovidersegment),即字母数字 slug,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中小写的 `model` 段,即在该提供商下要运行的模型。调用路由的 `model` 路径参数与目录条目的 `model` 字段共用它,原因与 `RouterProviderSegment` 相同,同样是为了避免偏差。 + 规范的 `{provider}/{model}` 模型 ID 中的小写 `model` 段,即在该提供商内要运行的模型。与 `RouterProviderSegment` 出于同样的防漂移原因,它由调用路由的 `model` 路径参数与目录条目的 `model` 字段共享。 - 类型:[`RouterModelSegment`](#routermodelsegment),即字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 调用方在调用之前需要了解的按模型计费信息,而不是价格。用量与费用数字绝不会出现在这里。 + 调用方在调用之前所需的按模型计费信息,而非价格。用量与费用数据绝不会出现在这里。 类型:[`RouterModelBilling`](#routermodelbilling) - 该模型 `GET /v2/models/{provider}/{model}/openapi.json` 文档当前的强 `ETag`。在该读取请求中把它作为 `If-None-Match` 发送,可在 schema 未变化时得到 `304`;也可以把它与上次见到的值比较,从而无需获取每份文档就能得知哪些模型的 schema 发生了变化。只要该读取在此刻对这位调用方不会返回 `200`,该字段就缺失:schema 服务不可用、该模型的文档无法渲染,或者在响应构建期间该模型对这位调用方变为不可用。标签缺失并不代表 schema 发生了变化;请重新读取该模型的文档以获知其当前标签。 + 该模型 `GET /v2/models/{provider}/{model}/openapi.json` 文档当前的强 `ETag`。在对该文档的读取中把它作为 `If-None-Match` 发送,可在 schema 未变更时得到 `304`;或将它与此前见到的值比较,从而无需抓取每个文档就能得知哪些模型的 schema 发生了变化。当该读取此刻不会对这位调用方返回 `200` 时,该字段缺失:schema 服务不可用、该模型的文档无法渲染,或在响应构建期间该模型对这位调用方变为不可用。标签缺失并不代表 schema 发生变化;请重新读取该模型的文档以获知其当前标签。 -### RouterModelListResponse +### RouterModelListResponse {#routermodellistresponse} Router 模型目录中的一页。 **字段** - 本页中的模型,最多 `limit` 个。 + 本页包含的模型,最多为 `limit` 个。 类型:由 [`RouterModelListEntry`](#routermodellistentry) 组成的数组 - 本页之后是否还存在另一页。只要该值为 true,就继续遍历;不要因为 `data` 较短或为空就推断目录已经结束。 + 本页之后是否还有另一页。只要该值为是,就应继续遍历;不要因为 `data` 很短或为空就推断目录已结束。 - 指向 Router 列表的不透明游标。它由服务器生成,并且只会原样往返传递:它既不是偏移量,也不是模型 ID,既不保证有序,也不会在目录重建后保持稳定。因此,解析游标、递增游标,或在产生该游标的那次遍历之外持久化游标,都不在约定范围内。这里使用游标而不是偏移量,是因为目录是一个不断变化的列表:如果在遍历中途添加或删除条目,偏移量遍历会静默跳过或重复条目,而调用方无法察觉是否发生了这种情况。 + 指向 Router 列表的不透明游标。它由服务器生成,且只用于原样往返传递:它不是一个偏移量,不是模型 ID,不保证有序,也不保证在目录重建后保持稳定,因此解析它、对其自增,或在它来源的遍历之外持久化它,均超出约定范围。之所以使用游标而非偏移量,是因为目录是一个不断变化的列表:在遍历过程中添加或删除条目时,基于偏移量的遍历会静默跳过或重复条目,而调用方无法察觉这种情况。 - 类型:[`RouterPageCursor`](#routerpagecursor)。作为 `next_cursor` 返回的不透明游标,1–512 个字符 + 类型:[`RouterPageCursor`](#routerpagecursor) -- 作为 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 - 实际提供的页大小。请求的 `limit` 超过最大值时会被限制到最大值,而不是被拒绝,因此该值可能小于所请求的值:请使用这个数字进行分页,而不是使用你发送的数字,否则你会误以为自己收到了实际未收到的条目。 + 实际提供的分页大小。若请求的 `limit` 超过最大值,会被限制到最大值而不是被拒绝,因此该值可能小于所请求的值。分页时应使用这个数字,而不是你发送的数字,否则你会误以为收到了实际并未返回的行。 1–100 ### RouterModelOutput -模型结果对象。请阅读所选模型的输出 Schema 以了解其确切形状。 +模型结果对象。请查阅已选择模型的输出 Schema 以了解其确切的形状。 类型:`object` ### RouterModelSegment -`{provider}/{model}` 模型 ID 中的模型部分。 +`{provider}/{model}` 模型 ID 中表示模型的部分。 类型:`string`,字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 ### RouterPageCursor -一个不透明的目录游标。请将其原样传回,作为 `cursor`。 +不透明的目录游标。请将其原样传回,作为 `cursor` 使用。 -类型:`string`。作为 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 +类型:`string`,作为 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 ### RouterProviderSegment `{provider}/{model}` 模型 ID 中的提供商部分。 -类型:`string`,由字母和数字组成的 slug,例如 `anthropic`,最多 64 个字符 +类型:`string`,字母数字格式的 slug,例如 `anthropic`,最多 64 个字符 ### RouterQueueCancelResponse -对于描述此路由已处理的请求的两种状态,即 `202` 和 `409`,这是对取消请求的响应。两种状态共用同一种响应体形状,而不是一个成功信封加一个错误信封,因为两者表达的是同一件事:取消操作发现了什么。客户端如果必须按不同状态码解析不同类型,这种拆分不会带来任何好处。 +对取消请求的应答,适用于描述此路由已处理请求的两种状态,即 `202` 和 `409`。两种状态共用同一种响应体形状,而不是一个成功封装加一个错误封装,因为两者表达的是同一项陈述,即取消操作发现了什么;而客户端若必须按每个状态码解析不同类型,也无法从这种拆分中获得任何好处。 **字段** - 一个已排队 Router 请求的标识符,即调用方用于轮询、取消和收集结果的句柄。 + 一个已执行 Router 请求的标识符,即调用方用于轮询、取消并收集结果的句柄。 - 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 + 类型:[`RouterQueueRequestId`](#routerqueuerequestid),`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 - 取消请求发现的结果,对应描述此路由实际已处理请求的两种结果。两者都由 HTTP 状态码镜像反映,因此客户端可以任选其一进行分支判断。 + 取消请求所发现的内容,适用于描述此路由实际处理请求的两种结果。两者都会由 HTTP 状态反映,因此客户端可以基于任意一个进行分支。 类型:[`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus -表示取消请求所发现的结果,对应两种描述此路由实际处理的请求的结果。两者都会通过 HTTP 状态码反映,因此客户端可以任选其一进行分支判断。 +表示取消请求所发现的结果,适用于描述此路由实际已处理请求的两种结果。这两种结果都会由 HTTP 状态码反映,因此客户端可以依据其中任一结果进行分支处理。 -类型:`字符串` +类型:`string` ### RouterQueuePosition -响应生成的那一刻,该请求在队列中前面还有多少个请求。零表示该请求位于队首。 +在响应组装完成的那一刻,队列中有多少个请求排在本请求之前。值为 0 表示本请求位于队列最前端。 -类型:`integer` -- 至少为 0 +类型:`integer`,至少为 0 ### RouterQueueRequestId -一条排队中的 Router 请求的标识符,即调用方用于轮询、取消并取回结果的句柄。 +一个排队中的 Router 请求的标识符,即调用方用来轮询、取消请求并获取结果时使用的句柄。 -类型:`string` -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 +类型:`string`,`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 ### RouterQueueStatus -队列中 Router 请求的状态。它恰好有三个值,而且与 `RouterErrorType` 不同,这是一个封闭的 `enum`,因为这两个 schema 有意朝相反方向封闭。`RouterErrorType` 用于对失败进行分类,其集合预计会增长,因此如果生成的客户端硬性拒绝无法识别的分类桶,它恰恰会在已经出现问题的时候失败得最严重。这个 schema 描述的是生命周期;如果之后为生命周期增加第四种状态,那么无论是否将其声明为 enum,都会对针对它编写的每个轮询循环造成破坏性变更,因此它被声明为 enum,并且该约束会在客户端可以看到的位置说明。 +排队中的 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这个类型是一个封闭的 `enum`,因为这两个 schema 是有意朝相反方向封闭的。`RouterErrorType` 用于对失败进行分类,其集合预期会扩展;因此,如果一个生成的客户端硬性拒绝无法识别的分类,那么它恰恰会在已经出错的时候失败得最严重。这个类型表示一个生命周期,而如果以后为这个生命周期添加第四个状态,就会对每一个针对它编写的轮询循环构成破坏性变更,无论它是否被声明为 enum;因此它被声明为 enum,并且该约束会在客户端能够看到的地方说明。 类型:`string` ### RouterQueueStatusFields -`RouterQueueStatusResponse` 中除 URL 块之外的另一半:一个已排队请求的身份、它当前的状态,以及在该状态为终端且运行未成功时,说明原因所在的粗粒度分类桶。 +`RouterQueueStatusResponse` 中不属于 URL 块的那一半:一个排队中的请求的身份、其当前状态,以及当该状态为终态且运行未成功时,说明原因的粗粒度分类。 **字段** - 一个已排队的 Router 请求的标识符,即调用方用于轮询、取消并收集结果的句柄。 + 一个排队中的 Router 请求的标识符,也是调用方轮询、取消和收集结果所用的句柄。 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 - 已排队的 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这一项是封闭的 `enum`,因为这两个 schema 被有意设计成朝相反的方向封闭。`RouterErrorType` 用于对失败进行分类,其集合预期会增长,因此,如果生成的客户端硬性拒绝无法识别的分类桶,那么它恰恰会在已经出错的时候失败得最严重。而这一项是生命周期,日后新增第四种状态对每一个针对它编写的轮询循环都是破坏性变更,无论它是否被声明为 enum。因此它被声明为 enum,并在客户端能看到的地方明确说明这一约束。 + 排队中的 Router 请求的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这是一个封闭的 `enum`,因为这两个 schema 被有意设计成朝相反方向封闭。`RouterErrorType` 对失败进行分类,其集合预期会增长,因此,如果一个生成的客户端强硬拒绝无法识别的分类,那么恰恰会在已经出错时失败得最严重。而这一项是生命周期,日后新增第四个状态的生命周期,无论是否声明为 enum,都会是对所有针对它编写的轮询循环的破坏性变更,因此它被声明为 enum,并且该约束会在客户端能看到的地方说明。 类型:[`RouterQueueStatus`](#routerqueuestatus) - 在响应组装的那一刻,队列中有多少个请求排在这一请求之前。零表示该请求位于队首。 + 在响应组装完成的那一刻,队列中有多少个请求排在此请求之前。零表示此请求位于队首。 - 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少 0 + 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少为 0 - 仅出现在未成功的 `COMPLETED` 请求上,携带与结果读取在该失败返回时置于 `X-Comfy-Error-Type` 上的相同粗粒度分类桶。它用于区分成功的终端请求与失败或被取消的终端请求(这两者都没有单独的终端状态),并且在成功时是缺失而非 null,因此请根据其是否存在进行分支判断。 + 仅出现在未成功的 `COMPLETED` 请求上,携带的粗粒度分类与结果读取在返回该失败时放到 `X-Comfy-Error-Type` 上的分类相同。它用于区分已成功的终态请求与失败或已取消的请求:这两种情况都没有单独的终态状态;并且它在成功时缺失而不是为 `null`,因此应根据其是否存在进行分支。 类型:[`RouterErrorType`](#routererrortype) ### RouterQueueStatusResponse -单个排队中请求的当前状态,与提交时返回的那三个 URL 组合在一起。 +单个排队中请求的当前状态,由与提交时返回的相同三个 URL 组合而成。 -组合了 [`RouterQueueUrls`](#routerqueueurls) 与 [`RouterQueueStatusFields`](#routerqueuestatusfields)。 +组合了 [`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueStatusFields`](#routerqueuestatusfields)。 类型:`object` ### RouterQueueSubmitFields -`RouterQueueSubmitResponse` 中不属于 URL 块的那一半内容:新请求的身份标识,以及它在被接纳那一刻的状态。 +`RouterQueueSubmitResponse` 中除 URL 块之外的另一半:新请求的身份,以及它在被接纳那一刻的状态。 **字段** - 一个已排队 Router 请求的标识符,即调用方用于轮询、取消并获取结果的句柄。 + 标识一个已排队的 Router 请求,即调用方用于轮询、取消和获取结果的句柄。 - 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最多 36 个字符 + 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 - 一个已排队 Router 请求的状态。它恰好有三个值,与 `RouterErrorType` 不同,这个 schema 是一个封闭的 `enum`,因为这两个 schema 故意朝着相反的方向封闭。`RouterErrorType` 用于对失败进行分类,它的取值集合预期会增长,因此一个硬性拒绝未识别分类的已生成客户端,恰恰会在已经出了问题的时候失败得最严重。而此项是一个生命周期,日后新增第四种状态的生命周期,对每一个针对它编写的轮询循环来说都是破坏性变更,无论它是否被声明为 enum,因此它被声明为 enum,并把该约束写在客户端能看到的地方。 + 排队中的 Router 请求所处的状态。它恰好有三个值,并且与 `RouterErrorType` 不同,这是一个封闭的 `enum`,因为这两个 schema 是有意朝相反方向封闭的。`RouterErrorType` 对失败进行分类,其取值集合预期会增长,因此如果生成的客户端硬性拒绝一个无法识别的分类,它恰恰会在已经出错的时候失败得最严重。而这里描述的是生命周期,一个日后新增第四种状态的生命周期,无论是否声明为 enum,对每一个针对它编写的轮询循环来说都是破坏性变更,因此它被声明为 enum,并把这个约束写在客户端能看到的地方。 类型:[`RouterQueueStatus`](#routerqueuestatus) - 在响应合成的那一刻,队列中有多少个请求排在它前面。零表示该请求位于队首。 + 在响应组装完成的那一刻,队列中有多少个请求排在这个请求前面。零表示该请求位于队首。 - 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少 0 + 类型:[`RouterQueuePosition`](#routerqueueposition) -- 至少为 0 - 该请求的预检成本估算,在调用方启用了成本估算时,于全新接纳的请求上提供。它报出的是该请求被固定到的提供商侧分段(队列没有回退循环,因此 `fallback_provider` 永远不会改变实际执行的分段)。当无法给出数字时,它仍然存在,并带有 `source: unknown`;提交绝不会因为该估算而失败。在幂等重放(`Idempotent-Replayed: true`)时会省略,因为原始报价未被存储。它只是估算,不是最终费用,也不是价格锁定:运行会按计价时生效的费率计费,而你工作区的用量与账单记录中结算后的费用才是最终的。 + 此请求的预检成本估算,当调用方启用了成本估算时,新接纳的请求会带上它。它报出的是此请求所固定到的提供商侧(队列没有回退循环,因此 `fallback_provider` 永远不会改变实际运行的那一侧)。当无法给出数字时,它依然存在,并带有 `source: unknown`;提交绝不会因为估算而失败。在幂等重放(`Idempotent-Replayed: true`)时省略,因为原始报价不会被保存。它是估算值,不是最终费用,也不是价格锁定:运行时按计费时生效的费率收取费用,而工作区用量与账单记录中结算后的费用才是最终结果。 类型:[`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse -运行被接纳进入队列时返回的句柄:包含请求的身份与状态,并组合了三个用于访问其剩余生命周期的 URL。 +当一次运行被接纳进入队列时返回的句柄:包含该请求的标识与状态,并与用于访问其剩余生命周期的三个 URL 组合而成。 -组合了 [`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueSubmitFields`](#routerqueuesubmitfields)。 +由 [`RouterQueueUrls`](#routerqueueurls)、[`RouterQueueSubmitFields`](#routerqueuesubmitfields) 组合而成。 类型:`object` ### RouterQueueUrls -这三个 URL 覆盖某个排队请求剩余生命周期中的各项操作,凡是携带有效句柄的响应都会返回它们,客户端因此无需自行拼接队列 URL。 +这三个 URL 指向某个排队中请求剩余生命周期的各个部分,会在每个携带有效句柄的响应中返回,因此客户端无需自行拼接队列 URL。 **字段** - 读取该请求状态的绝对 URL。 + 此请求状态读取的绝对 URL。 URI - 收集该请求结果的绝对 URL。 + 此请求结果收集所在的绝对 URL。 URI - 发起取消请求的绝对 URL。 + 发起取消请求所用的绝对 URL。 URI @@ -1523,46 +1522,46 @@ Router 模型目录中的一页。 ### RouterValidationErrorDetail -单个字段级别的验证失败。 +单个字段级验证失败。 **字段** - 出错字段的路径,最外层片段在前。例如 `["body", "image_url"]`,或 `["body", "images", 0]`,其中整数表示数组中的索引。 + 指向出错字段的路径,最外层片段在前,例如 `["body", "image_url"]`,或 `["body", "images", 0]`,其中整数用于索引数组。 - 对这一次失败的人类可读描述。 + 对这一单次失败的人类可读描述。 - 这一次失败的具体、机器可读的原因,由提供商原样传递。类型化 SDK 的异常层次结构正是依据该值进行分支判断;响应头中的 `error_type` 只是它的粗略分类。 + 此次失败的具体的、机器可读的原因,由提供商原样透传。类型化 SDK 的异常层级正是基于该值进行分支判断;响应头中的 `error_type` 只是它的粗粒度分类。 - 单个 `RouterValidationErrorDetail` 所违反的边界值,由提供商逐字传递。例如 `{"limit_value": 8}` 配合 `greater_than`,`{"min_width": 512}` 配合 `image_too_small`,或 `{"max_size_bytes": 10485760}` 配合 `file_too_large`。键集合取决于具体的提供商和错误类型,因此这里刻意为开放式对象:把它收窄为固定字段列表,或将其折叠进 `msg` 字符串,正是移植集成后能够编译通过、却悄悄丢失读取该边界的分支的原因。当错误类型不携带边界值时,该字段不存在。 + 针对单个 `RouterValidationErrorDetail` 所违反的边界,由提供商原样传递,例如 `{"limit_value": 8}` 配合 `greater_than`,`{"min_width": 512}` 配合 `image_too_small`,或 `{"max_size_bytes": 10485760}` 配合 `file_too_large`。键集合取决于具体的提供商和错误类型,因此这里刻意设计为开放对象:把它收窄为固定的字段列表,或将其并入 `msg` 字符串,恰恰会导致移植过来的集成在编译通过后,静默丢失了读取该边界的分支。当错误类型不携带边界时,该字段不存在。 类型:[`RouterValidationErrorContext`](#routervalidationerrorcontext) - 出错的输入值,原样回显,以便调用方无需从 `loc` 重新推导就能看到被拒绝的内容。任意 JSON 类型均可:字符串、数字、布尔、数组、对象或 null,因此此 schema 刻意不做类型限定,而不是收窄为对象。当提供商不回显输入时,该字段不存在。 + 出错的输入值,原样回显,使调用方无需再从 `loc` 重新推导即可看到被拒绝的内容。可为任意 JSON 类型,包括字符串、数字、布尔、数组、对象或 null,因此该 schema 刻意不设类型,而不是收窄为对象。当提供商不回显输入时,该字段不存在。 类型:[`RouterValidationErrorInput`](#routervalidationerrorinput) ### RouterValidationErrorInput -被拒绝的输入值(当提供商包含该值时)。 +被拒绝的输入值,前提是提供商包含该值。 ### RouterValidationErrorResponse -`422` 验证错误响应体。读取 `X-Comfy-Error-Type` 以了解其类别。 +`422` 验证错误响应体。读取 `X-Comfy-Error-Type` 以获取其类别。 **字段** - 请求中发现的每个验证失败,每个违规字段对应一个条目。 + 请求中发现的每一处验证失败,每个出错的字段对应一条记录。 - 类型:由 [`RouterValidationErrorDetail`](#routervalidationerrordetail) 组成的数组 + 类型:数组,元素为 [`RouterValidationErrorDetail`](#routervalidationerrordetail) From d47fd45c1d128f73f12aa5b683e89e929a6157af Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 12 Nov 2026 11:20:12 +0800 Subject: [PATCH 18/36] i18n(es): sync the router schema and model pages with upstream/main (2026-11-12) --- es/development/comfy-router/limitations.mdx | 7 +- es/development/comfy-router/models.mdx | 81 ++--- .../dreamina-seedance-2-0-260128/code.mdx | 28 +- .../code.mdx | 43 ++- .../dreamina-seedance-2-0-mini/code.mdx | 32 +- .../dreamina-seedance-2-5-260628/code.mdx | 34 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 30 +- .../seedance-1-0-pro-fast-251015/code.mdx | 32 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 33 +- .../models/krea/krea-2-large/code.mdx | 21 +- .../models/krea/krea-2-medium-turbo/code.mdx | 21 +- .../models/krea/krea-2-medium/code.mdx | 31 +- .../comfy-router/models/krea/krea-2/code.mdx | 27 +- .../comfy-router/models/krea/krea-3/code.mdx | 21 +- .../minimax-h3-image-highspeed/code.mdx | 324 ++++++++++++++++++ .../models/minimax/minimax-h3-image/code.mdx | 324 ++++++++++++++++++ .../xai/grok-imagine-image-2-0/code.mdx | 53 ++- .../xai/grok-imagine-image-pro/code.mdx | 55 ++- .../xai/grok-imagine-image-quality/code.mdx | 53 ++- .../models/xai/grok-imagine-image/code.mdx | 51 ++- es/development/comfy-router/reference.mdx | 59 ++-- 21 files changed, 1117 insertions(+), 243 deletions(-) create mode 100644 es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx create mode 100644 es/development/comfy-router/models/minimax/minimax-h3-image/code.mdx diff --git a/es/development/comfy-router/limitations.mdx b/es/development/comfy-router/limitations.mdx index d8e717eaba..3b42a3165d 100644 --- a/es/development/comfy-router/limitations.mdx +++ b/es/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Capacidades y límites de Comfy Router" sidebarTitle: "Capacidades y límites" description: "Elige Router o un proxy socio, planifica llamadas largas y entiende la recuperación, los límites de tasa y el almacenamiento de recursos." -translationSourceHash: fbb54868 +translationSourceHash: a81b3bd9 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": cca3ca82 + "Models without a pre-flight estimate": e7d7524a "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -22,6 +22,7 @@ translationBlockHashes: + Router ejecuta un modelo socio a través de una llamada HTTP síncrona o mediante una solicitud en cola que envías y recoges más tarde. Úsalo cuando tu aplicación pueda esperar un resultado finalizado o recogerlo más tarde, y pueda manejar los campos de entrada y salida propios del modelo. ## Qué admite Router @@ -115,7 +116,7 @@ Esta lista se reduce a medida que crece la cobertura de estimaciones. Se genera - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` -- **minimax**: `minimax/minimax-gpt-image-2` +- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 1fd2cc28c7..0cc0bf4fdd 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Modelos de Comfy Router" sidebarTitle: "Todos los modelos" description: "Todos los modelos disponibles en Comfy Router, agrupados por proveedor, con su modalidad de entrada y salida." -translationSourceHash: 04ecf050 +translationSourceHash: df7e65a1 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 2dfd8d42 + "Find by output": 4d100975 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -26,7 +26,7 @@ translationBlockHashes: "Luma": 8cd2a7ce "Luma 2": 585eb637 "Meshy": 67e26a17 - "MiniMax": 87560ab7 + "MiniMax": 63f02c44 "Moonvalley": 9e63fb77 "OpenAI": 8652024f "Openrouter": a4f6806b @@ -42,12 +42,13 @@ translationBlockHashes: "Veo": 4ccdb46f "Wan": e4d5aff5 "WaveSpeed": be89e7f0 - "xAI": e1706271 + "xAI": 38a131b8 --- + {/* ARCHIVO GENERADO. Generado a partir del catálogo del Router por `pnpm code-pages:gen`. */} Todos los modelos que aparecen a continuación se sirven por la misma ruta, `POST /v2/models/{provider}/{model}`, con el cuerpo JSON propio del modelo. Cada página muestra una solicitud funcional en Python, TypeScript y cURL. Para descubrimiento, esquemas, errores, reintentos y facturación, consulta [Usar la API de Comfy Router](/es/development/comfy-router/api). @@ -109,40 +110,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/es/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [Clean Audio Video](/es/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/es/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [Lipsync 2.0](/es/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` -- [Video Background Removal Fast](/es/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` -- [Video Background Removal Green Screen](/es/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` -- [Video Background Removal](/es/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` -- [Veo 3.1 Fast Generate 001](/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` -- [Veo 3.1 Generate 001](/es/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` -- [Veo 3.1 Lite Generate 001](/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` -- [HappyHorse 1.0 I2V](/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` -- [HappyHorse 1.0 R2V](/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code): `wan/happyhorse-1.0-r2v` -- [HappyHorse 1.0 T2V](/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code): `wan/happyhorse-1.0-t2v` -- [HappyHorse 1.0 Video Edit](/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code): `wan/happyhorse-1.0-video-edit` -- [HappyHorse 1.1 I2V](/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code): `wan/happyhorse-1.1-i2v` -- [HappyHorse 1.1 R2V](/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code): `wan/happyhorse-1.1-r2v` -- [HappyHorse 1.1 T2V](/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code): `wan/happyhorse-1.1-t2v` -- [Wan 2.5 I2V Preview](/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code): `wan/wan2.5-i2v-preview` -- [Wan 2.5 T2V Preview](/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` -- [Wan 2.6 I2V](/es/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` -- [Wan 2.6 R2V](/es/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` -- [Wan 2.6 T2V](/es/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` -- [Wan 2.7 I2V](/es/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` -- [Wan 2.7 R2V](/es/development/comfy-router/models/wan/wan2-7-r2v/code): `wan/wan2.7-r2v` -- [Wan 2.7 T2V](/es/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` -- [Wan 2.7 Video Edit](/es/development/comfy-router/models/wan/wan2-7-videoedit/code): `wan/wan2.7-videoedit` -- [Wan 3.0 Video Prime](/es/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` -- [Wan 3.0 Video](/es/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` -- [Flashvsr](/es/development/comfy-router/models/wavespeed/flashvsr/code): `wavespeed/flashvsr` -- [Grok Imagine Video 1.5 Lite](/es/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code): `xai/grok-imagine-video-1.5-lite` -- [Grok Imagine Video 1.5 Preview](/es/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code): `xai/grok-imagine-video-1.5-preview` -- [Grok Imagine Video 1.5](/es/development/comfy-router/models/xai/grok-imagine-video-1-5/code): `xai/grok-imagine-video-1.5` -- [Grok Imagine Video](/es/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - - - +- [Fabric 1.0](/es/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` + - [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/es/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -164,14 +133,13 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/es/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` -- [Editar imagen: eliminar fondo guiado](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` -- [Editar imagen: eliminar fondo](/es/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` -- [Editar imagen: reemplazar fondo](/es/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Editar imagen: reemplazar objeto por texto](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Editar imagen: Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` -- [Editar imagen: restaurar](/es/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` -- [Imagen](/es/development/comfy-router/models/bria/image/code): `bria/image` +- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Remove Background](/es/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` +- [Image Edit Replace Background](/es/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` +- [Image Edit Replace Object By Text](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` +- [Image Edit Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Restore](/es/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` +- [Image](/es/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` - [Seedream 4.5 251128](/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code): `byteplus/seedream-4-5-251128` - [Seedream 5.0 260128](/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code): `byteplus/seedream-5-0-260128` @@ -205,6 +173,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Uni 1](/es/development/comfy-router/models/luma_2/uni-1/code): `luma_2/uni-1` - [Photon 1](/es/development/comfy-router/models/luma/photon-1/code): `luma/photon-1` - [Photon Flash 1](/es/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1` +- [MiniMax H3 Image Highspeed](/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code): `minimax/minimax-h3-image-highspeed` +- [MiniMax H3 Image](/es/development/comfy-router/models/minimax/minimax-h3-image/code): `minimax/minimax-h3-image` - [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` @@ -213,8 +183,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Qwen Image 3.0 Pro](/es/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/es/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` -- [Recraft V2](/es/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` -- [Recraft V3](/es/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` +- [Recraft V2](/es/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2`- [Recraft V3](/es/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` - [Recraft V4.1 Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` - [Recraft V4.1 Pro](/es/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` @@ -266,8 +235,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [FLUX 3 Video](/es/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128`- [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/es/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` @@ -324,8 +292,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Rigging](/es/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/es/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Part](/es/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part`- [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` - [Hunyuan 3D Texture Edit](/es/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` @@ -608,6 +575,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | +| [MiniMax H3 Image Highspeed](/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | Texto, Imagen | Imagen | +| [MiniMax H3 Image](/es/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | Texto, Imagen | Imagen | | [MiniMax H3](/es/development/comfy-router/models/minimax/minimax-h3/code) | `minimax/minimax-h3` | Texto, Imagen | Video + Audio | ## Moonvalley @@ -809,10 +778,10 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | -| [Grok Imagine Image 2.0](/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code) | `xai/grok-imagine-image-2.0` | Texto | Imagen | -| [Grok Imagine Image Pro](/es/development/comfy-router/models/xai/grok-imagine-image-pro/code) | `xai/grok-imagine-image-pro` | Texto | Imagen | -| [Grok Imagine Image Quality](/es/development/comfy-router/models/xai/grok-imagine-image-quality/code) | `xai/grok-imagine-image-quality` | Texto | Imagen | -| [Grok Imagine Image](/es/development/comfy-router/models/xai/grok-imagine-image/code) | `xai/grok-imagine-image` | Texto | Imagen | +| [Grok Imagine Image 2.0](/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code) | `xai/grok-imagine-image-2.0` | Imagen, Texto | Imagen | +| [Grok Imagine Image Pro](/es/development/comfy-router/models/xai/grok-imagine-image-pro/code) | `xai/grok-imagine-image-pro` | Imagen, Texto | Imagen | +| [Grok Imagine Image Quality](/es/development/comfy-router/models/xai/grok-imagine-image-quality/code) | `xai/grok-imagine-image-quality` | Imagen, Texto | Imagen | +| [Grok Imagine Image](/es/development/comfy-router/models/xai/grok-imagine-image/code) | `xai/grok-imagine-image` | Imagen, Texto | Imagen | | [Grok Imagine Video 1.5 Lite](/es/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code) | `xai/grok-imagine-video-1.5-lite` | Texto, Imagen | Video | | [Grok Imagine Video 1.5 Preview](/es/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code) | `xai/grok-imagine-video-1.5-preview` | Texto, Imagen | Video | | [Grok Imagine Video 1.5](/es/development/comfy-router/models/xai/grok-imagine-video-1-5/code) | `xai/grok-imagine-video-1.5` | Texto, Imagen | Video | diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index a9f9749561..15f836a08b 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,15 +2,16 @@ title: "Usa Dreamina Seedance 2.0 260128 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-260128 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 70ec471f +translationSourceHash: a3a29c99 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 8c0478c9 + "Schema": 9c7c68b7 "Examples": 641c458b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -214,7 +215,7 @@ ID de recurso: Formato asset://\ Solo para Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution toma el valor predeterminado y solo admite 1080p. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. @@ -286,7 +287,7 @@ ID de recurso: Formato asset://\ Solo para Seedance 2.5. Genera un video Draft en 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final en 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; cuando se omite resolution, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -298,14 +299,13 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Umbral de tiempo de espera de la tarea en segundos. Valor predeterminado 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: El modelo genera un video con audio sincronizado. -false: El modelo genera un video silencioso. -En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +false: El modelo genera un video silencioso.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. @@ -329,7 +329,7 @@ Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. -Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. +Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -343,7 +343,7 @@ false: No devuelve la imagen del último fotograma del video generado. Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -373,17 +373,17 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` rehospedadas. + Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` rehospedada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` rehospedada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave de API antigua no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume la rehospedación del propio Router. + La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio realojamiento de Router. @@ -403,7 +403,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envolturas de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte. + Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas HTTP 200 de tareas fallidas, sin sobrescribir los fallos de transporte. @@ -439,7 +439,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La hora en que la tarea se actualizó por última vez. El valor es un timestamp UNIX en segundos. + La hora de la última actualización de la tarea. El valor es un timestamp UNIX en segundos. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index beb2e240a0..52bd01b70a 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,14 +2,15 @@ title: "Usa Dreamina Seedance 2.0 Fast 260128 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-fast-260128 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: 8036f4db +translationSourceHash: 506a7f86 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": 90b60b2e + "Schema": 48fe2811 "Examples": 7714eccd --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -188,7 +189,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ - Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar audio por sí solo: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. + Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar solo audio: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. @@ -199,8 +200,8 @@ Asset ID: Formato asset://\ - Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution toma el valor 1080p por defecto y solo admite 1080p. + Solo Seedance 2.5. La tarea Draft que se renderizará como el video final. Debe ser el único elemento de contenido. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. @@ -272,7 +273,7 @@ Asset ID: Formato asset://\ Solo Seedance 2.5. Genera un video Draft de 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; cuando se omite la resolución, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -284,14 +285,13 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video sin audio. -En los modelos que lo admiten, el proveedor revisa la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +false: el modelo genera un video sin audio.En los modelos que lo admiten, el proveedor revisa la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. @@ -315,7 +315,7 @@ Generación con primer fotograma / primer y último fotograma de Seedance 2.5: l Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. -Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. +Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -329,7 +329,7 @@ false: No devuelve la imagen del último fotograma del video generado. Entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -347,7 +347,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr ### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router vuelve a alojar tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Anulable: BytePlus borra las URL 24 horas después de la tarea, y un documento en estado succeeded consultado después de eso puede traer `content` ausente o null. + La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router vuelve a alojar tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Anulable: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. @@ -359,17 +359,17 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` rehospedadas. + Hora RFC 3339 en la que las URL de origen dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` rehospedada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` re-alojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` rehospedada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave de API antigua no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume la rehospedación del propio Router. + La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` re-alojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el re-alojamiento del propio Router. @@ -381,7 +381,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr - La duración del video generado en segundos. Se declara como number en lugar de integer porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies de BytePlus informan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. + La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies de BytePlus informan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. @@ -389,15 +389,14 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr - Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no una enumeración: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envoltorios de error HTTP 400 y en respuestas de tarea fallida HTTP 200 sin sobrescribir los fallos de transporte. + Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas HTTP 200 de tarea fallida sin sobrescribir los fallos de transporte. El mensaje de error - - El ID de la tarea de generación de video +El ID de la tarea de generación de video @@ -405,15 +404,15 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr - Formato de contenedor del video generado (mp4 o mov), que se devuelve en el NIVEL SUPERIOR como un hermano de `content`: aquí es donde lo devuelve la consulta de tarea de video de Seedance. Campo propio de BytePlus, que se reenvía sin cambios. + Formato de contenedor del video generado (mp4 o mov), que se devuelve en el NIVEL SUPERIOR como un hermano de `content`: aquí es donde lo devuelve la consulta de tarea de video de Seedance. Es un campo propio de BytePlus, que se reenvía sin cambios. - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. + La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. - La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. + La semilla de generación que realmente se usó para la tarea. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. Formato: `int64` diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 17c68357d2..60b13471ce 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,14 +2,15 @@ title: "Usa Dreamina Seedance 2.0 Mini con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-mini desde Comfy Router: endpoint, forma de la solicitud y respuesta." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: a1d75c67 +translationSourceHash: 69e65942 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": ebf1fc3a + "Schema": 51a6f44e "Examples": db01067e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-mini.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -199,8 +200,8 @@ Asset ID: formato asset://\ - Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution toma el valor predeterminado 1080p y solo admite ese valor. + Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Define resolution en esta solicitud para el nivel de salida del video final, incluido 4k; si se omite, el video final es 1080p. @@ -272,7 +273,7 @@ Asset ID: formato asset://\ Solo Seedance 2.5. Genera un video Draft de 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud define la resolución del video final, incluido 4k; si se omite la resolución, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -290,8 +291,7 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo produce un video con audio sincronizado. -false: el modelo produce un video sin audio. -En los modelos que lo admiten, la pista de audio generada es revisada por contenido por el proveedor de forma independiente al video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +false: el modelo produce un video sin audio.En los modelos que lo admiten, la pista de audio generada es revisada por contenido por el proveedor de forma independiente al video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. @@ -315,7 +315,7 @@ Generación con primer fotograma / primer y último fotograma de Seedance 2.5: l Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. -Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. +Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -329,7 +329,7 @@ false: No devuelve la imagen del último fotograma del video generado. Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -351,7 +351,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del origen o de una inspección del contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se genera y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del origen o de una inspección del contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. @@ -359,21 +359,21 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` rehospedadas. + Hora RFC 3339 en la que las URL del origen dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` rehospedada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` re-alojada y en los mismos términos que `upstream_video_url`: solo para espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` rehospedada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave de API antigua no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume la rehospedación del propio Router. + La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` re-alojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el re-alojamiento del propio Router. - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se genera y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -381,7 +381,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La duración del video generado en segundos. Se declara como número y no como entero porque BytePlus no es consistente al respecto: se han observado tareas de video que devuelven segundos enteros y otras superficies de BytePlus del mismo tipo reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. + La duración del video generado en segundos. Se declara como número y no como entero porque BytePlus no es consistente al respecto: se han observado tareas de video que devuelven segundos enteros y superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. @@ -389,7 +389,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas de tarea fallida HTTP 200 sin sobrescribir los fallos de transporte. + Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas de tarea fallida HTTP 200 sin sobrescribir los fallos de transporte. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index e52f97df88..77036bec1a 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,15 +2,16 @@ title: "Usa Dreamina Seedance 2.5 260628 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-5-260628 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 3606fb83 +translationSourceHash: 2acd3f28 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": d2c28a84 + "Schema": d29d4b46 "Examples": 5465695b --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/byteplus/dreamina-seedance-2-5-260628.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -201,7 +202,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot - Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar audio por sí solo: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. + Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar audio por sí solos: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. @@ -213,7 +214,7 @@ ID de recurso: Formato asset://\ Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type; no los envíes de nuevo. resolution toma el valor predeterminado 1080p y solo admite 1080p. +El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type; no los envíes de nuevo. Define resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. @@ -285,7 +286,7 @@ ID de recurso: Formato asset://\ Solo Seedance 2.5. Genera un video Draft en 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final en 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud define la resolución del video final, incluido 4k; cuando se omite la resolución, el video final es 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. @@ -304,6 +305,7 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con lo visual. true: el modelo genera un video con audio sincronizado. false: el modelo genera un video silencioso. + En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio varía en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. @@ -328,7 +330,7 @@ Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. -Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. +Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -342,7 +344,7 @@ false: No devuelve la imagen del último fotograma del video generado. Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -360,33 +362,33 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream ### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se RE-ALOJAN en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. + La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router REALOJA tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del upstream o de una inspección del contenido, e `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router realoja los bytes que recibe y les asigna un tipo a partir del Content-Type del proveedor o de una inspección del contenido, e `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router realoja el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` rehospedadas. + Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida útil documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando está presente `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` rehospedada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo para espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y es una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` rehospedada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave de API antigua no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume la rehospedación del propio Router. + La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el realojamiento del propio Router. - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router realoja el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -402,7 +404,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - Código de error del upstream de ModelArk. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en sobres de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte. + Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en sobres de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin anular los fallos de transporte. @@ -414,7 +416,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - El nombre y la versión del modelo utilizado por la tarea + El nombre y la versión del modelo usado por la tarea diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 5e78d526f7..fa6df3bf63 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedance 1.0 Pro 250528 con Comfy Router" description: "Llama a byteplus/seedance-1-0-pro-250528 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 642f85ab +translationSourceHash: 846f38d7 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": b57b84de + "Schema": 6f05c994 "Examples": 815d621e --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/byteplus/seedance-1-0-pro-250528.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -200,7 +201,7 @@ ID de recurso: formato asset://\ Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution tiene 1080p como valor predeterminado y solo admite 1080p. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece la resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. @@ -272,7 +273,7 @@ ID de recurso: formato asset://\ Solo Seedance 2.5. Genera un video Draft de 480p; la resolution debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolution del video final, incluido 4k; cuando se omite la resolution, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -284,14 +285,13 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Umbral de tiempo de espera de la tarea en segundos. Valor predeterminado 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video sin audio. -En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso vuelve a crear el Draft con `false`. +false: el modelo genera un video sin audio.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso vuelve a crear el Draft con `false`. @@ -315,7 +315,7 @@ Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite, predeterminado: 720p. Seedance 1.0 pro y pro-fast, predeterminado: 1080p. -Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. +Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -347,11 +347,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda ### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus devuelve una, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se VUELVEN A ALOJAR en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite nulo: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o nulo. + La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus devuelve una, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se VUELVEN A ALOJAR en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Puede ser nulo: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o nulo. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de la imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG del lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo según el Content-Type del origen o una detección de contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de la imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG del lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo según el Content-Type del origen o una detección de contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. @@ -359,21 +359,21 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` rehospedadas. + Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` rehospedada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` rehospedada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave de API antigua no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume la rehospedación del propio Router. + La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el realojamiento del propio Router. - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -389,7 +389,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envoltorios de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas, sin sobrescribir los fallos de transporte. + Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas HTTP 200 de tarea fallida sin sobrescribir los fallos de transporte. diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index c32b085668..97dce010fe 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedance 1.0 Pro Fast 251015 con Comfy Router" description: "Llama a byteplus/seedance-1-0-pro-fast-251015 desde Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 61dd0135 +translationSourceHash: 5ba64878 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": dd74b012 + "Schema": 2de625f5 "Examples": 1469ab97 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-fast-251015.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -200,7 +201,7 @@ Asset ID: Formato asset://\ Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution tiene como valor predeterminado 1080p y solo admite 1080p. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece la resolución en esta solicitud para el nivel de salida del video final, incluido 4k; si la omites, el video final es 1080p. @@ -272,7 +273,7 @@ Asset ID: Formato asset://\ Solo Seedance 2.5. Genera un video Draft en 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final en 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; si omites la resolución, el video final es 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. @@ -284,14 +285,13 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video silencioso. -En los modelos que lo admiten, el proveedor revisa la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si esto ocurre; eso ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +false: el modelo genera un video silencioso.En los modelos que lo admiten, el proveedor revisa la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si esto ocurre; eso ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. @@ -315,7 +315,7 @@ Generación de primer frame / primer y último frame con Seedance 2.5: la salida Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite predeterminado: 720p. Seedance 1.0 pro y pro-fast predeterminado: 1080p. -Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. +Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -329,7 +329,7 @@ false: No devuelve la imagen del último frame del video generado. Entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -355,21 +355,21 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo más a menudo como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven con mayor frecuencia como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente. - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` rehospedadas. + Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` rehospedada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` rehospedada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave de API antigua no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume la rehospedación del propio Router. + La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el realojamiento del propio Router. @@ -389,7 +389,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed - Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por política de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de política en envoltorios de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas, sin anular los fallos de transporte. + Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Esto es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte. @@ -409,11 +409,11 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. + La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus que aparece en tareas de video exitosas y se reenvía sin cambios. - La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. + La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus que aparece en tareas de video exitosas y se reenvía sin cambios. Formato: `int64` diff --git a/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 0ba1db2f28..d3a5dfaf3a 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,14 +2,15 @@ title: "Usa Seedance 1.5 Pro 251215 con Comfy Router" description: "Llama a byteplus/seedance-1-5-pro-251215 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 2263b4cf +translationSourceHash: 8c658f01 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": f4d67fb6 + "Schema": b9957cb9 "Examples": 7e73ac5c --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-5-pro-251215.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -200,7 +201,7 @@ ID de recurso: formato asset://\ Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. resolution toma el valor predeterminado 1080p y solo admite 1080p. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. @@ -272,7 +273,7 @@ ID de recurso: formato asset://\ Solo Seedance 2.5. Genera un video Draft de 480p; resolution debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final de 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; cuando se omite resolution, el video final es 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. @@ -284,18 +285,17 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Umbral de tiempo de espera de la tarea en segundos. Predeterminado: 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video silencioso. -En los modelos que lo admiten, el proveedor somete la pista de audio generada a una verificación de contenido independiente de la del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta por lo demás. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. +false: el modelo genera un video silencioso.En los modelos que lo admiten, el proveedor somete la pista de audio generada a una verificación de contenido independiente de la del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta por lo demás. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. -El ID del modelo al que se llama. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa de v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. + El ID del modelo al que se llama. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa de v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. @@ -315,7 +315,7 @@ Generación de Seedance 2.5 con primer fotograma / primer y último fotograma: l Resolución del video. Valor predeterminado en Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite: 720p. Valor predeterminado en Seedance 1.0 pro y pro-fast: 1080p. -Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p y 1080p. +Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -329,7 +329,7 @@ false: No devuelve la imagen del último fotograma del video generado. Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Rango: `-1` a `4294967295` + Alcance: `-1` a `4294967295` @@ -355,21 +355,21 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo con más frecuencia como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven con más frecuencia como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` rehospedadas. + Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` rehospedada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` re-alojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` rehospedada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave de API antigua no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume la rehospedación del propio Router. + La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` re-alojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el re-alojamiento del propio Router. @@ -389,15 +389,14 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - Código de error de ModelArk upstream. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas HTTP 200 de tareas fallidas, sin sobrescribir los fallos de transporte. + Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas de tarea fallida HTTP 200 sin sobrescribir los fallos de transporte. El mensaje de error - - El ID de la tarea de generación de video +The ID de la tarea de generación de video diff --git a/es/development/comfy-router/models/krea/krea-2-large/code.mdx b/es/development/comfy-router/models/krea/krea-2-large/code.mdx index f10ca89d11..d608ba8d2a 100644 --- a/es/development/comfy-router/models/krea/krea-2-large/code.mdx +++ b/es/development/comfy-router/models/krea/krea-2-large/code.mdx @@ -2,14 +2,15 @@ title: "Usa Krea 2 Large con Comfy Router" description: "Llama a krea/krea-2-large con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Krea 2 Large" -translationSourceHash: a4fdfae2 +translationSourceHash: 19dca448 translationFrom: development/comfy-router/models/krea/krea-2-large/code.mdx translationBlockHashes: "_intro": bd2a615c "Quick start": 5d997ba7 - "Schema": d755f939 + "Schema": 9e43627e "Examples": 91f72543 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-2-large.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -233,6 +234,22 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-2-la Formato: `date-time` + + Solo se establece cuando el estado es failed. Una tarea cancelada no lleva ninguno. + + + + Por qué falló la tarea: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal o node_app_node_failed. Trata un código desconocido como internal. + + + + Opcional. Texto libre del proveedor para provider_error e internal. + + + + El parámetro de la solicitud que debes cambiar; aparece con invalid_request y validation_failed. + + Formato: `uuid` diff --git a/es/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx b/es/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx index b31df2a33f..5067cdecd2 100644 --- a/es/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx +++ b/es/development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx @@ -2,15 +2,16 @@ title: "Usa Krea 2 Medium Turbo con Comfy Router" description: "Llama a krea/krea-2-medium-turbo con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Krea 2 Medium Turbo" -translationSourceHash: f61cb3f9 +translationSourceHash: 5a2af2e1 translationFrom: development/comfy-router/models/krea/krea-2-medium-turbo/code.mdx translationBlockHashes: "_intro": fffee1bd "Quick start": a305dd42 - "Schema": f06a0da8 + "Schema": 7e1ae995 "Examples": 91f72543 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-2-medium-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -234,6 +235,22 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-2-me Formato: `date-time` + + Solo se establece cuando el estado es failed. Una tarea cancelada no lo lleva. + + + + Por qué falló la tarea: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal o node_app_node_failed. Trata un código desconocido como internal. + + + + Opcional. Texto libre del proveedor para provider_error e internal. + + + + El parámetro de la solicitud que debes cambiar; aparece con invalid_request y validation_failed. + + Formato: `uuid` diff --git a/es/development/comfy-router/models/krea/krea-2-medium/code.mdx b/es/development/comfy-router/models/krea/krea-2-medium/code.mdx index 00f4854a1a..a9c5161d34 100644 --- a/es/development/comfy-router/models/krea/krea-2-medium/code.mdx +++ b/es/development/comfy-router/models/krea/krea-2-medium/code.mdx @@ -2,14 +2,15 @@ title: "Usa Krea 2 Medium con Comfy Router" description: "Llama a krea/krea-2-medium con Comfy Router: endpoint, forma de la solicitud y respuesta del Router." sidebarTitle: "Krea 2 Medium" -translationSourceHash: a7f31b9b +translationSourceHash: 8c847fd4 translationFrom: development/comfy-router/models/krea/krea-2-medium/code.mdx translationBlockHashes: "_intro": d62bc601 "Quick start": 1f018136 - "Schema": 926b5274 + "Schema": 2e249b0f "Examples": 91f72543 --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/krea/krea-2-medium.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -166,7 +167,7 @@ curl https://api.comfy.org/v2/models/krea/krea-2-medium/requests/$REQUEST_ID \ - Referencias de estilo que se usarán para la generación + Referencias de estilo para usar en la generación @@ -180,7 +181,7 @@ curl https://api.comfy.org/v2/models/krea/krea-2-medium/requests/$REQUEST_ID \ - Moodboards que se usarán para la generación. Actualmente limitado a un moodboard. + Moodboards para usar en la generación. Por ahora se limita a uno. @@ -208,7 +209,7 @@ curl https://api.comfy.org/v2/models/krea/krea-2-medium/requests/$REQUEST_ID \ - Estilos (normalmente LoRAs) que se usarán para la generación + Estilos (normalmente LoRAs) para usar en la generación @@ -233,6 +234,22 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-2-me Formato: `date-time` + + Solo se establece cuando el estado es failed. Una tarea cancelada no lo incluye. + + + + Por qué falló la tarea: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal o node_app_node_failed. Trata un código desconocido como internal. + + + + Opcional. Texto libre del proveedor para provider_error e internal. + + + + El parámetro de la solicitud que debes cambiar; aparece con invalid_request y validation_failed. + + Formato: `uuid` @@ -246,11 +263,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-2-me - Las imágenes generadas, como enlaces descargables. Al menos uno, porque una tarea `completed` con `urls` vacío es `success_without_output` y nunca llega a este documento. + Las imágenes generadas, como enlaces de descarga. Al menos uno, porque una tarea `completed` con `urls` vacío es `success_without_output` y nunca llega a este documento. - Siempre `completed` en este documento: es el único estado que Router informa como éxito, y el vocabulario de Krea debe coincidir exactamente, sensible a mayúsculas y minúsculas. + Siempre `completed` en este documento: es el único estado que Router informa como éxito, y el vocabulario de Krea se compara distinguiendo mayúsculas y minúsculas. Valores posibles: `completed` diff --git a/es/development/comfy-router/models/krea/krea-2/code.mdx b/es/development/comfy-router/models/krea/krea-2/code.mdx index 7fc887c1d3..a582457a4c 100644 --- a/es/development/comfy-router/models/krea/krea-2/code.mdx +++ b/es/development/comfy-router/models/krea/krea-2/code.mdx @@ -2,14 +2,15 @@ title: "Usa Krea 2 con Comfy Router" description: "Llama a krea/krea-2 con Comfy Router: endpoint, forma de la solicitud y respuesta del Router." sidebarTitle: "Krea 2" -translationSourceHash: 12dc5e3a +translationSourceHash: 72216188 translationFrom: development/comfy-router/models/krea/krea-2/code.mdx translationBlockHashes: "_intro": 5d115bf3 "Quick start": 2cc5fba4 - "Schema": 360d2f7e + "Schema": 5a67f0ed "Examples": 91f72543 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -208,7 +209,7 @@ curl https://api.comfy.org/v2/models/krea/krea-2/requests/$REQUEST_ID \ - Estilos (normalmente LoRA) que se usarán para la generación + Estilos (normalmente LoRAs) que se usarán para la generación @@ -233,6 +234,22 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-2/op Formato: `date-time` + + Solo aparece cuando el estado es failed. Una tarea cancelada no lo incluye. + + + + Por qué falló la tarea: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal o node_app_node_failed. Trata un código desconocido como internal. + + + + Opcional. Texto libre del proveedor para provider_error e internal. + + + + El parámetro de la solicitud que hay que cambiar; aparece con invalid_request y validation_failed. + + Formato: `uuid` @@ -242,7 +259,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-2/op - Lo establecen las tareas de loraTraining, no una generación; una respuesta `200` de estos modelos incluye `urls`. + Las tareas de loraTraining lo establecen, no una generación; una respuesta `200` de estos modelos incluye `urls`. @@ -250,7 +267,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-2/op - Siempre `completed` en este documento: es el único estado que Router informa como éxito, y el vocabulario de Krea debe coincidir exactamente, sensible a mayúsculas y minúsculas. + Siempre `completed` en este documento: es el único estado que Router informa como éxito, y el vocabulario de Krea se compara distinguiendo mayúsculas y minúsculas. Valores posibles: `completed` diff --git a/es/development/comfy-router/models/krea/krea-3/code.mdx b/es/development/comfy-router/models/krea/krea-3/code.mdx index 878ea2eafe..4c77bda1e2 100644 --- a/es/development/comfy-router/models/krea/krea-3/code.mdx +++ b/es/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,14 +2,15 @@ title: "Usa Krea 3 con Comfy Router" description: "Llama a krea/krea-3 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Krea 3" -translationSourceHash: 56990dce +translationSourceHash: eee80c65 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": c0a0ccaf + "Schema": dbedda04 "Examples": 276619d9 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-3.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -197,6 +198,22 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-3/op Formato: `date-time` + + Solo se establece cuando el estado es failed. Un trabajo cancelado no lo lleva. + + + + Por qué falló el trabajo: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal o node_app_node_failed. Trata un código desconocido como internal. + + + + Opcional. Texto libre del proveedor para provider_error e internal. + + + + El parámetro de la solicitud que hay que cambiar; aparece con invalid_request y validation_failed. + + Formato: `uuid` diff --git a/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx b/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx new file mode 100644 index 0000000000..cf51c435c7 --- /dev/null +++ b/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx @@ -0,0 +1,324 @@ +--- +title: "Usa MiniMax H3 Image Highspeed con Comfy Router" +description: "Llama a minimax/minimax-h3-image-highspeed mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "MiniMax H3 Image Highspeed" +translationSourceHash: 49584805 +translationFrom: development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx +translationBlockHashes: + "_intro": 3fd3bae8 + "Quick start": e37c76df + "Schema": 5c07b006 + "Examples": b42d5c4e +--- +{/* GENERATED FILE. Generated from router-schemas/minimax/minimax-h3-image-highspeed.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `minimax/minimax-h3-image-highspeed`, servido por Comfy Router de MiniMax. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. + +**ID del modelo:** `minimax/minimax-h3-image-highspeed` + +**Endpoint:** `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY desde el entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "minimax/minimax-h3-image-highspeed", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("minimax/minimax-h3-image-highspeed", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge una vez que está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY desde el entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "minimax/minimax-h3-image-highspeed", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("minimax/minimax-h3-image-highspeed", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indique cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se está ejecutando. +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Nivel de área de salida cuando se omite `size` o es `auto`. Uno de `1K`, `2K`, `4K` (predeterminado). + + + + Relación de aspecto de salida cuando se omite `size` o es `auto`. `auto` (predeterminado) o `X:Y` entre 1:3 y 3:1, por ejemplo `16:9`. + + + + Desactiva el mejoramiento de prompt de MiniMax. Requiere un `size` fijo o un `aspect_ratio` con formato `X:Y`. + + + + Imágenes de referencia opcionales. Cuando están presentes, la solicitud se ejecuta como una edición de imagen, exactamente igual que en la ruta de ediciones. + + + + Una URL http(s) pública o un URI `data:image/;base64,`. JPEG, PNG, WEBP, HEIC o HEIF, cada lado de 128 a 8192 px, con el lado largo como máximo 4 veces el lado corto. + + + + Nombre del modelo. `MiniMax-H3-Image` o `MiniMax-H3-Image-Highspeed`. Quienes llaman al Router pueden omitir este campo o enviar null; el Router completa el modelo seleccionado por la ruta de la solicitud. + + + + Cantidad de imágenes. Los tokens de entrada se cobran una vez por imagen. + + Alcance: `1` a `10` + + + + Calidad de compresión para `jpeg` y `webp`, predeterminado 95. + + Alcance: `0` a `100` + + + + Formato de la imagen de salida. Uno de `png`, `jpeg`, `jpg` (predeterminado), `webp`. + + + + Descripción de texto de la imagen. Junto con `images`, es la descripción de la edición; las imágenes de referencia son la imagen 1, la imagen 2 y así sucesivamente, en el orden del arreglo. + + + + Tamaño de salida, `auto` (predeterminado) o `WIDTHxHEIGHT`, por ejemplo `2720x1536`. Un tamaño fijo debe tener un área de 655,360 a 20,000,000 píxeles y una relación de aspecto entre 1:3 y 3:1, y no se puede combinar con `aspect_ratio` ni con `area`. + + +Se genera a partir del esquema que el Router publica en `GET /v2/models/minimax/minimax-h3-image-highspeed/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Formato: `int64` + + + + + + + + Presente solo cuando esta imagen falló o fue retenida. + + + + + + + + + + + + El prompt que MiniMax usó para esta imagen. + + + + Tamaño real de la imagen como `WIDTHxHEIGHT`. + + + + URL de la imagen generada. Caduca, así que descarga la imagen. + + + + + + + + + + + + Uso de tokens de las imágenes que se generaron correctamente. La facturación se basa en él. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Ejemplos + +### Entrada + +```json +{ + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background." +} +``` + +### Salida + +```json +{ + "created": 1794300000, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/minimax/minimax-h3-image/generated.jpg" + } + ], + "output_format": "jpeg", + "request_id": "06a1b2c3d4e5f60718293a4b5c6d7e8f", + "usage": { + "generated_images": 1, + "input_tokens": 10, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 10 + }, + "output_tokens": 1024, + "output_tokens_details": { + "image_tokens": 1024 + }, + "total_tokens": 1034 + } +} +``` + + diff --git a/es/development/comfy-router/models/minimax/minimax-h3-image/code.mdx b/es/development/comfy-router/models/minimax/minimax-h3-image/code.mdx new file mode 100644 index 0000000000..bd6c43a594 --- /dev/null +++ b/es/development/comfy-router/models/minimax/minimax-h3-image/code.mdx @@ -0,0 +1,324 @@ +--- +title: "Usa MiniMax H3 Image con Comfy Router" +description: "Llama a minimax/minimax-h3-image con Comfy Router: endpoint, forma de la solicitud y respuesta del Router." +sidebarTitle: "MiniMax H3 Image" +translationSourceHash: 1dbc0ccb +translationFrom: development/comfy-router/models/minimax/minimax-h3-image/code.mdx +translationBlockHashes: + "_intro": 21c027f1 + "Quick start": 122cc9f4 + "Schema": af54b1a6 + "Examples": b42d5c4e +--- +{/* GENERATED FILE. Generated from router-schemas/minimax/minimax-h3-image.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API para `minimax/minimax-h3-image`, servida por Comfy Router de MiniMax. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. + +**ID del modelo:** `minimax/minimax-h3-image` + +**Endpoint:** `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "minimax/minimax-h3-image", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("minimax/minimax-h3-image", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "minimax/minimax-h3-image", + { + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud fallida o cancelada genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("minimax/minimax-h3-image", { + area: "1K", + prompt: "A single red maple leaf resting on a plain white background.", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud fallida o cancelada se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"area\": \"1K\", \"prompt\": \"A single red maple leaf resting on a plain white background.\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Nivel de área de salida cuando `size` se omite o es `auto`. Uno de `1K`, `2K`, `4K` (predeterminado). + + + + Relación de aspecto de salida cuando `size` se omite o es `auto`. `auto` (predeterminado) o `X:Y` entre 1:3 y 3:1, por ejemplo `16:9`. + + + + Desactiva la mejora de prompt de MiniMax. Requiere un `size` fijo o un `aspect_ratio` con formato `X:Y`. + + + + Imágenes de referencia opcionales. Cuando están presentes, la solicitud se ejecuta como una edición de imagen, exactamente igual que en la ruta de ediciones. + + + + Una URL http(s) pública o un URI `data:image/;base64,`. JPEG, PNG, WEBP, HEIC o HEIF, cada lado de 128 a 8192 px, con el lado largo como máximo 4 veces el lado corto. + + + + Nombre del modelo. `MiniMax-H3-Image` o `MiniMax-H3-Image-Highspeed`. Quienes llaman al Router pueden omitir este campo o enviar null; el Router completa el modelo seleccionado por la ruta de la solicitud. + + + + Número de imágenes. Los tokens de entrada se cobran una vez por imagen. + + Alcance: `1` a `10` + + + + Calidad de compresión para `jpeg` y `webp`, predeterminado 95. + + Alcance: `0` a `100` + + + + Formato de la imagen de salida. Uno de `png`, `jpeg`, `jpg` (predeterminado), `webp`. + + + + Descripción de texto de la imagen. Con `images`, la descripción de la edición; las imágenes de referencia son imagen 1, imagen 2 y así sucesivamente, en el orden del arreglo. + + + + Tamaño de salida, `auto` (predeterminado) o `WIDTHxHEIGHT`, por ejemplo `2720x1536`. Un tamaño fijo debe tener un área de 655,360 a 20,000,000 píxeles y una relación de aspecto entre 1:3 y 3:1, y no se puede combinar con `aspect_ratio` ni con `area`. + + +Generado a partir del esquema que el Router publica en `GET /v2/models/minimax/minimax-h3-image/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Formato: `int64` + + + + + + + + Presente solo cuando esta imagen falló o fue retenida. + + + + + + + + + + + + El prompt que MiniMax usó para esta imagen. + + + + Tamaño real de la imagen como `WIDTHxHEIGHT`. + + + + URL de la imagen generada. Caduca, así que descarga la imagen. + + + + + + + + + + + + Uso de tokens de las imágenes exitosas. La facturación se basa en él. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +## Ejemplos + +### Entrada + +```json +{ + "area": "1K", + "prompt": "A single red maple leaf resting on a plain white background." +} +``` + +### Salida + +```json +{ + "created": 1794300000, + "data": [ + { + "size": "1024x1024", + "url": "https://example.invalid/minimax/minimax-h3-image/generated.jpg" + } + ], + "output_format": "jpeg", + "request_id": "06a1b2c3d4e5f60718293a4b5c6d7e8f", + "usage": { + "generated_images": 1, + "input_tokens": 10, + "input_tokens_details": { + "image_tokens": 0, + "text_tokens": 10 + }, + "output_tokens": 1024, + "output_tokens_details": { + "image_tokens": 1024 + }, + "total_tokens": 1034 + } +} +``` + + diff --git a/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx index a69df58c1c..c1a677d2ef 100644 --- a/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx +++ b/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx @@ -2,21 +2,22 @@ title: "Usa Grok Imagine Image 2.0 con Comfy Router" description: "Llama a xai/grok-imagine-image-2.0 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Grok Imagine Image 2.0" -translationSourceHash: e062dc40 +translationSourceHash: a292528e translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx translationBlockHashes: - "_intro": 614e2e15 + "_intro": 6a561296 "Quick start": ff9945c8 - "Schema": cb29dfae + "Schema": f435c296 "Examples": 3222291b --- + {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-2.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; Referencia de la API para `xai/grok-imagine-image-2.0`, servida por Comfy Router desde xAI. -**Entrada:** Texto · **Salida:** Imagen +**Entrada:** Imagen, Texto · **Salida:** Imagen ## Inicio rápido @@ -69,7 +70,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0 \ -The same body, sent to `POST https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests`. Router answers `201` with a `request_id` as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. [Entrega en cola](/es/development/comfy-router/queue) walks through status, cancellation and collection. +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. ```python Python @@ -199,6 +200,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES Un identificador único que representa a tu usuario final, lo que puede ayudar a xAI a monitorear y detectar abusos + + Objeto de imagen de entrada para los endpoints de xAI + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o URI de datos codificada en base64) + + + + Lista de imágenes de entrada para edición con múltiples referencias. Es mutuamente excluyente con image. Cuando proporcionas varias imágenes, refiérete a ellas como \, \, etc. en el prompt. + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o URI de datos codificada en base64) + + + + Objeto de imagen de entrada para los endpoints de xAI + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o URI de datos codificada en base64) + + Generado a partir del esquema que Router sirve en `GET /v2/models/xai/grok-imagine-image-2.0/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida diff --git a/es/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/es/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx index 6e297387d6..e86d5b1a55 100644 --- a/es/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx +++ b/es/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx @@ -2,24 +2,25 @@ title: "Usa Grok Imagine Image Pro con Comfy Router" description: "Llama a xai/grok-imagine-image-pro mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Grok Imagine Image Pro" -translationSourceHash: f1412f9d +translationSourceHash: 551ab410 translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx translationBlockHashes: - "_intro": 0da8910e + "_intro": 17b18ef8 "Quick start": 3a4bd585 - "Schema": 805c771c + "Schema": 618b5e75 "Examples": 3222291b --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/xai/grok-imagine-image-pro.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; -Referencia de API para `xai/grok-imagine-image-pro`, servida por Comfy Router desde xAI. +Referencia de API para `xai/grok-imagine-image-pro`, que Comfy Router sirve desde xAI. -**Entrada:** Texto · **Salida:** Imagen +**Entrada:** Imagen, Texto · **Salida:** Imagen -xAI retiró `grok-imagine-image-pro` el [15 de mayo de 2026](https://docs.x.ai/developers/migration/may-15-retirement) y dirigió sus solicitudes a `grok-imagine-image-quality`. Después, xAI retiró `grok-imagine-image-quality` el 2 de noviembre de 2026. Ahora las solicitudes las atiende `grok-imagine-image-2.0` con calidad baja. Consulta el [aviso de migración de xAI](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2). +xAI retiró `grok-imagine-image-pro` el [15 de mayo de 2026](https://docs.x.ai/developers/migration/may-15-retirement) y dirigió sus solicitudes a `grok-imagine-image-quality`. xAI retiró `grok-imagine-image-quality` el 2 de noviembre de 2026. Ahora las solicitudes las atiende `grok-imagine-image-2.0` con calidad baja. Consulta el [aviso de migración de xAI](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2). ## Inicio rápido @@ -203,6 +204,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES Un identificador único que representa a tu usuario final, lo que puede ayudar a xAI a monitorear y detectar abusos + + Objeto de imagen de entrada para los endpoints de xAI + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o data URI codificado en base64) + + + + Lista de imágenes de entrada para edición con múltiples referencias. Es mutuamente excluyente con image. Cuando se proporcionan varias imágenes, refiérete a ellas como \, \, etc. en el prompt. + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o data URI codificado en base64) + + + + Objeto de imagen de entrada para los endpoints de xAI + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o data URI codificado en base64) + + Generado a partir del esquema que Router sirve en `GET /v2/models/xai/grok-imagine-image-pro/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida diff --git a/es/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/es/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx index d6cf4c25e5..0a1f0731cb 100644 --- a/es/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx +++ b/es/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx @@ -2,21 +2,22 @@ title: "Usa Grok Imagine Image Quality con Comfy Router" description: "Llama a xai/grok-imagine-image-quality con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Grok Imagine Image Quality" -translationSourceHash: 2768f32e +translationSourceHash: 1bac2ebc translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx translationBlockHashes: - "_intro": 7220f036 + "_intro": 77db165f "Quick start": 799275b8 - "Schema": e2c96ff6 + "Schema": 052399f6 "Examples": 3222291b --- + {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-quality.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; Referencia de API para `xai/grok-imagine-image-quality`, servida por Comfy Router desde xAI. -**Entrada:** Texto · **Salida:** Imagen +**Entrada:** Imagen, Texto · **Salida:** Imagen xAI retiró `grok-imagine-image-quality` el 2 de noviembre de 2026. Ahora las solicitudes las atiende `grok-imagine-image-2.0` con calidad baja. Consulta el [aviso de migración de xAI](https://docs.x.ai/developers/migration/imagine-image-quality-nov-2). @@ -174,7 +175,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE - Calidad de la imagen de salida. Para grok-imagine-image-2.0 esto selecciona el nivel de precio: low, medium o auto (el valor predeterminado de xAI cuando se omite; auto sirve low para la generación y medium para las ediciones). Los demás modelos lo ignoran. + Calidad de la imagen de salida. Para grok-imagine-image-2.0 esto selecciona el nivel de precio: low, medium o auto (el valor predeterminado de xAI cuando se omite; auto entrega low para la generación y medium para las ediciones). Los demás modelos lo ignoran. Valores posibles: `low`, `medium`, `high`, `auto` @@ -203,6 +204,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE Un identificador único que representa a tu usuario final, que puede ayudar a xAI a monitorear y detectar abusos + + Objeto de imagen de entrada para los endpoints de xAI + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o URI de datos codificada en base64) + + + + Lista de imágenes de entrada para edición con múltiples referencias. Es mutuamente excluyente con image. Cuando proporcionas varias imágenes, refiérete a ellas como \, \, etc. en el prompt. + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o URI de datos codificada en base64) + + + + Objeto de imagen de entrada para los endpoints de xAI + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o URI de datos codificada en base64) + + Generado a partir del esquema que Router sirve en `GET /v2/models/xai/grok-imagine-image-quality/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida diff --git a/es/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/es/development/comfy-router/models/xai/grok-imagine-image/code.mdx index 44e5661d7f..ea379ab62a 100644 --- a/es/development/comfy-router/models/xai/grok-imagine-image/code.mdx +++ b/es/development/comfy-router/models/xai/grok-imagine-image/code.mdx @@ -2,21 +2,22 @@ title: "Usa Grok Imagine Image con Comfy Router" description: "Llama a xai/grok-imagine-image mediante Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Grok Imagine Image" -translationSourceHash: 2e5c55ad +translationSourceHash: 892f31a7 translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx translationBlockHashes: - "_intro": a2e97c88 + "_intro": 0a2a8c08 "Quick start": a5495331 - "Schema": 171da7d5 + "Schema": f924d818 "Examples": 3222291b --- + {/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; Referencia de API para `xai/grok-imagine-image`, servida por Comfy Router desde xAI. -**Entrada:** Texto · **Salida:** Imagen +**Entrada:** Imagen, Texto · **Salida:** Imagen ## Inicio rápido @@ -199,6 +200,48 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID Un identificador único que representa a tu usuario final, que puede ayudar a xAI a monitorear y detectar abusos + + Objeto de imagen de entrada para los endpoints de xAI + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o data URI codificada en base64) + + + + Lista de imágenes de entrada para edición con múltiples referencias. Es mutuamente excluyente con image. Cuando se proporcionan varias imágenes, refiérete a ellas como \, \, etc. en el prompt. + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o data URI codificada en base64) + + + + Objeto de imagen de entrada para los endpoints de xAI + + + + Tipo de la entrada de imagen + + Valores posibles: `image_url` + + + + URL de la imagen de entrada (URL pública o data URI codificada en base64) + + Generado a partir del esquema que el Router sirve en `GET /v2/models/xai/grok-imagine-image/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index 7722d0f6a0..4892382a87 100644 --- a/es/development/comfy-router/reference.mdx +++ b/es/development/comfy-router/reference.mdx @@ -2,7 +2,7 @@ title: "Referencia de la API de Comfy Router" sidebarTitle: "Referencia de la API" description: "Todos los endpoints, parámetros, respuestas y errores de Comfy Router, según el contrato de la API de Comfy." -translationSourceHash: f49adc91 +translationSourceHash: e8d9375f translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 @@ -12,9 +12,10 @@ translationBlockHashes: "Pre-flight cost estimates": 7405db0d "Result assets": 3520a8bf "Per-model input and output schemas": 61c6bde8 - "Schemas": 9738e3aa + "Schemas": 35b5a3bc --- + {/* ARCHIVO GENERADO -- NO EDITAR A MANO. @@ -1087,7 +1088,7 @@ Lee los campos de cada modelo desde `GET /v2/models/{provider}/{model}/openapi.j ### RouterBilledWorkspace -La cartera a la que se habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a "¿qué cartera está vacía?": no es necesariamente el espacio de trabajo que la interfaz de quien llama tiene seleccionado en este momento, y la credencial personal de un miembro del equipo indica aquí su cartera personal incluso mientras hay un equipo con fondos abierto. Solo aparece junto con `denied_reason`. +La cartera a la que se habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a "¿qué cartera está vacía?": no es necesariamente el espacio de trabajo que la interfaz de quien llama tiene seleccionado en este momento, y la credencial personal de un miembro del equipo indica aquí su cartera personal incluso mientras hay un equipo con saldo abierto. Solo aparece junto con `denied_reason`. **Campos** @@ -1100,12 +1101,12 @@ La cartera a la que se habría cobrado una llamada rechazada, en `RouterErrorRes - `legacy` cuando la llamada factura al cliente de Metronome anterior a los espacios de trabajo de quien llama en lugar de a un espacio de trabajo de Cloud; ese cliente no tiene id de espacio de trabajo. Ausente para un espacio de trabajo de Cloud. + `legacy` cuando la llamada factura al cliente de Metronome anterior a los espacios de trabajo de quien llama, en lugar de a un espacio de trabajo de Cloud; ese cliente no tiene id de espacio de trabajo. Ausente para un espacio de trabajo de Cloud. ### RouterChargesOnPolicyRejection -Indica si se cobra un rechazo por política de contenido en este modelo. Trata un valor desconocido como posiblemente cobrado. +Indica si se cobra un rechazo por política de contenido en este modelo. Trata cualquier valor desconocido como potencialmente cobrado. Tipo: `string` @@ -1170,13 +1171,12 @@ Una estimación previa a la ejecución de lo que costará esta llamada, en dóla - Cuándo se obtuvo la tarjeta de tarifas con la que se cotizó esta estimación. La estimación no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifica, no en este instante. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor (un modelo facturado por el costo que reporta el proveedor) lleva en su lugar la fecha en que se leyó esa lista. Una cotización cuya cantidad facturable se predice a partir de un calendario publicado por el proveedor y luego se tarifica con la tarjeta lleva la más antigua entre la fecha de lectura de ese calendario y la hora de obtención de la tarjeta, tanto para una respuesta `exact` como para una `estimated` (un modelo facturado por los créditos que reporta su proveedor es el caso `estimated`). Siempre que no se haya leído ninguna tarjeta de tarifas (`reason: pricing_unavailable`, `byok` o una llamada `not_quotable` que no se puede tarificar con ninguna tarjeta), esto es cuándo se respondió la cotización. + Cuándo se obtuvo la tarjeta de tarifas con la que se calculó esta cotización. La estimación no es un bloqueo de precio: la ejecución se cobra a las tarifas vigentes cuando se tarifa, no en este instante. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor (un modelo facturado por el costo que reporta su proveedor) lleva en su lugar la fecha en que se leyó esa lista. Una cotización cuya cantidad facturable se predice a partir de un calendario de precios publicado por el proveedor y luego se tarifa con la tarjeta de tarifas lleva la más antigua entre la fecha de lectura de ese calendario y la hora de obtención de la tarjeta, tanto para una respuesta `exact` como para una `estimated` (un modelo facturado por los créditos que reporta su proveedor es el caso `estimated`). Siempre que no se leyó ninguna tarjeta de tarifas (`reason: pricing_unavailable`, `byok` o una llamada `not_quotable` que no se puede tarifar con ninguna tarjeta), esto es el momento en que se respondió la cotización. date-time - - Se presenta solo cuando `source` es `unknown`: `not_quotable` (Router no puede calcular el precio de esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no limita una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no tiene precio para esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella) o `pricing_unavailable` (solo envío en cola: no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra como de costumbre). Interpreta cualquier otro valor como `not_quotable`. +Se presenta solo cuando `source` es `unknown`: `not_quotable` (Router no puede calcular el precio de esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no limita una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no tiene precio para esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella) o `pricing_unavailable` (solo envío en cola: no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra como de costumbre). Interpreta cualquier otro valor como `not_quotable`. ### RouterErrorResponse @@ -1186,7 +1186,7 @@ Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelos, cuo **Campos** - Descripción legible por humanos del fallo, segura para mostrarla a un usuario final. No se analiza por máquina: en su lugar, ramifica según `error_type`. Para `model_not_found` en un modelo retirado, `detail` muestra ` was retired on ; use ` cuando hay un sucesor registrado y visible para quien llama, o solo ` was retired on ` cuando no lo hay, en lugar de la lista de sugerencias habitual. Un sucesor nombrado aquí siempre es un ID de catálogo activo al que se puede redirigir la llamada. Un modelo cuya fecha de retiro todavía está en el futuro no está retirado: sigue apareciendo en `GET /v2/models` y se puede ejecutar hasta esa fecha. Como el resto de `detail`, este texto sobre el retiro es solo para mostrar y no conlleva ninguna garantía de compatibilidad. Las dos excepciones documentadas a la regla de que no se analiza por máquina: en `POST /v2/models/{provider}/{model}` la respuesta `409` cubre tres condiciones no relacionadas que comparten la categoría `invalid_input`, y solo `detail` las distingue: un `detail` que comienza con "this request's `image` selects the edit operation" es el rechazo de `model_provider` en multipart, y un `detail` que comienza con `this request resolved a BYOK credential` es el rechazo de `model_provider` por BYOK; ninguna de las dos desaparece con un nuevo `Idempotency-Key`. Cualquier otra respuesta `409` de `invalid_input` en esa ruta es el conflicto de clave. Ambos prefijos son términos de contrato estables y se pueden comparar. En ningún otro caso, ramificar según `detail` conlleva una garantía de compatibilidad. + Descripción legible por humanos del fallo, segura para mostrarla a un usuario final. No se analiza por máquina; en su lugar, ramifica según `error_type`. Para `model_not_found` en un modelo retirado, `detail` dice ` was retired on ; use ` cuando hay un sucesor registrado y visible para quien llama, o solo ` was retired on ` cuando no lo hay, en lugar de la lista de sugerencias habitual. Un sucesor nombrado aquí siempre es un ID de catálogo activo al que se puede redirigir la llamada. Un modelo cuya fecha de retiro todavía está en el futuro no está retirado: sigue apareciendo en `GET /v2/models` y se puede ejecutar hasta esa fecha. Como el resto de `detail`, este texto sobre el retiro es solo para mostrar y no conlleva ninguna garantía de compatibilidad. Las dos excepciones documentadas a la regla de que no se analiza por máquina: en `POST /v2/models/{provider}/{model}` la respuesta `409` cubre tres condiciones no relacionadas que comparten la categoría `invalid_input`, y solo `detail` las distingue: un `detail` que comienza con "this request's `image` selects the edit operation" es el rechazo de `model_provider` en multipart, y un `detail` que comienza con `this request resolved a BYOK credential` es el rechazo de `model_provider` por BYOK; ninguno de los dos desaparece con un nuevo `Idempotency-Key`. Cualquier otro `409` de `invalid_input` en esa ruta es el conflicto de clave. Ambos prefijos son términos de contrato estables y se pueden hacer coincidir. En ningún otro caso, ramificar según `detail` conlleva una garantía de compatibilidad. @@ -1196,7 +1196,7 @@ Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelos, cuo - Un motivo acotado y saneado que dio el proveedor del modelo para rechazar la solicitud, presente solo cuando `error_type` es `invalid_input` y `X-Comfy-Upstream-Status` es un `4xx` o `2xx` del proveedor, es decir, cuando el proveedor rechazó la solicitud por estar mal formada e indicó por qué. Normalmente ese estado es un `4xx`; es un `2xx` para un proveedor que informa una generación rechazada dentro de una respuesta de éxito (una consulta de tarea fallida de BytePlus es HTTP `200` con el motivo en su cuerpo). Ausente en cualquier otro fallo, incluidos los `5xx` del proveedor, los fallos de transporte, los rechazos por política de contenido y cualquier rechazo que el Router haya generado sobre sí mismo. Replica el encabezado `X-Comfy-Upstream-Detail`. La consulta en cola (`GET /v2/models/{provider}/{model}/requests/{request_id}`) de una ejecución que terminó en `invalid_input` incluye el mismo motivo en este campo en su primera consulta, que luego lo elimina de la solicitud: una consulta posterior normalmente responde el mismo `error_type` y `detail` sin él, así que léelo en la primera consulta. Esa lectura no envía ninguno de los dos encabezados. + Un motivo acotado y saneado para un rechazo por `invalid_input`. En la ruta síncrona, es el motivo que dio el proveedor del modelo, presente solo cuando `error_type` es `invalid_input` y `X-Comfy-Upstream-Status` es un `4xx` o `2xx` del proveedor, es decir, cuando el proveedor rechazó la solicitud por estar mal formada e indicó por qué. Normalmente ese estado es un `4xx`; es un `2xx` para un proveedor que informa una generación rechazada dentro de una respuesta de éxito (una consulta de tarea fallida de BytePlus es HTTP `200` con el motivo en su cuerpo). En esa ruta, está ausente en cualquier otro fallo, incluidos los `5xx` del proveedor, los fallos de transporte, los rechazos por política de contenido y cualquier rechazo que el Router haya generado sobre sí mismo, y replica el encabezado `X-Comfy-Upstream-Detail`. La consulta en cola (`GET /v2/models/{provider}/{model}/requests/{request_id}`) de una ejecución que terminó en `invalid_input` incluye el mismo motivo en este campo en su primera consulta, que luego lo elimina de la solicitud: una consulta posterior normalmente responde el mismo `error_type` y `detail` sin él, así que léelo en la primera consulta. Esa lectura no envía ninguno de los dos encabezados. La consulta en cola también usa este campo para el motivo propio del Router cuando el Router rechazó la solicitud antes de enviarla al proveedor y puede expresar el motivo en una sola frase, que la ruta síncrona responde en `detail`; un rechazo que nombra campos individuales no lleva ninguno. @@ -1208,18 +1208,17 @@ Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelos, cuo - La billetera que habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a "¿qué billetera está vacía?": no es necesariamente el espacio de trabajo que la interfaz de quien llama tiene seleccionado en este momento, y la credencial personal de un miembro del equipo nombra aquí su billetera personal incluso mientras está abierto un equipo con fondos. Presente solo junto con `denied_reason`. + La billetera a la que se habría cobrado una llamada rechazada, en `RouterErrorResponse.billed_workspace`. Responde a "¿qué billetera está vacía?": no es necesariamente el espacio de trabajo que la interfaz de quien llama tiene seleccionado en ese momento, y la credencial personal de un miembro del equipo nombra aquí su billetera personal incluso mientras hay un equipo con fondos abierto. Presente solo junto con `denied_reason`. Tipo: [`RouterBilledWorkspace`](#routerbilledworkspace) - - Cómo se autenticó la solicitud rechazada: `personal_api_key`, `team_api_key`, `personal_session` o `team_session`. Responde a "¿a qué credencial cambio para facturar a la otra billetera?". No es un permiso y no otorga nada. Presente solo junto con `denied_reason`. +Cómo se autenticó la solicitud rechazada: `personal_api_key`, `team_api_key`, `personal_session` o `team_session`. Responde a "¿a qué credencial cambio para facturar a la otra billetera?". No es un permiso y no otorga nada. Presente solo junto con `denied_reason`. ### RouterErrorType -Categoría de error del Router legible por máquina, que además se envía en el encabezado `X-Comfy-Error-Type`. +Categoría de error del Router legible por máquina, que también se envía en el encabezado `X-Comfy-Error-Type`. Tipo: `string` @@ -1230,7 +1229,7 @@ Comportamiento de facturación que debes verificar antes de invocar un modelo. N **Campos** - Si una llamada que este modelo rechaza por motivos de política de contenido se cobra de todos modos al solicitante. Los proveedores difieren, la diferencia es invisible en el momento de la llamada, y un usuario que ve un error y un cargo por la misma llamada no tiene forma de haberlo sabido, así que se indica por modelo, antes de la llamada, en lugar de dejarlo al folclore de cada proveedor. Cuando es `yes`, un error `content_policy_violation` en la ruta síncrona puede llevar `X-Comfy-Credits-Used`: lo lleva cuando el proveedor rechazó la salida generada por el modelo y Comfy registró uso para esa generación rechazada, y lleva esa cantidad. Un rechazo del lado de la entrada, una repetición con la misma clave (`Idempotent-Replayed: true`) y un cargo demasiado pequeño para mostrarse en los dos decimales del encabezado no lo llevan; un rechazo sin el encabezado no se reporta, no es prueba de que haya sido gratis. + Si una llamada que este modelo rechaza por motivos de política de contenido se cobra de todos modos al solicitante. Los proveedores difieren, la diferencia es invisible en el momento de la llamada, y un usuario que ve un error y un cargo por la misma llamada no tiene forma de haberlo sabido, así que se indica por modelo, antes de la llamada, en lugar de dejarlo al folclore de cada proveedor. Cuando es `yes`, un error `content_policy_violation` en la ruta síncrona puede incluir `X-Comfy-Credits-Used`: lo incluye cuando el proveedor rechazó la salida generada por el modelo y Comfy registró uso para esa generación rechazada, con esa cantidad. Un rechazo del lado de la entrada, una repetición con la misma clave (`Idempotent-Replayed: true`) y un cargo demasiado pequeño para aparecer en los dos decimales del encabezado no lo incluyen; un rechazo sin el encabezado no se reporta, lo que no es prueba de que haya sido gratis. Tipo: [`RouterChargesOnPolicyRejection`](#routerchargesonpolicyrejection) @@ -1250,7 +1249,7 @@ Campos opcionales que devuelve el endpoint de detalles del modelo. **Campos** - URL del documento OpenAPI de este modelo, incluidos sus esquemas de entrada y salida. + URL del documento OpenAPI de este modelo, donde se incluyen sus esquemas de entrada y salida. URL HTTPS, p. ej. `https://api.comfy.org/v2/models/bfl/flux-2-pro/openapi.json`, hasta 2048 caracteres @@ -1263,7 +1262,7 @@ Tipo: `string`: ID de modelo, p. ej. `anthropic/claude-opus-4-6`, hasta 193 cara ### RouterModelInput -El objeto de entrada del modelo. Consulta el documento OpenAPI del modelo seleccionado para ver los campos y la validación. +El objeto de entrada del modelo. Consulta el documento OpenAPI del modelo seleccionado para conocer los campos y la validación. Tipo: `object` @@ -1324,7 +1323,7 @@ Una página del catálogo de modelos de Router. - Un cursor opaco dentro de una lista de Router. Lo produce el servidor y solo se reenvía tal cual: no es un desplazamiento, no es un ID de modelo, no está ordenado y no es estable entre reconstrucciones del catálogo; por lo tanto, analizarlo, incrementarlo o persistirlo más allá del recorrido del que provino quedan fuera del contrato. Se usa un cursor en lugar de un desplazamiento porque el catálogo es una lista en movimiento: un recorrido por desplazamiento omite o repite entradas de forma silenciosa cuando se agregan o eliminan entradas a mitad del recorrido, y quien llama no puede detectar que eso ocurrió. + Un cursor opaco dentro de una lista de Router. Lo produce el servidor y solo se devuelve sin modificar: no es un desplazamiento, no es un ID de modelo, no está ordenado y no es estable entre reconstrucciones del catálogo; por lo tanto, analizarlo, incrementarlo o persistirlo más allá del recorrido del que provino quedan fuera del contrato. Se usa un cursor en lugar de un desplazamiento porque el catálogo es una lista en movimiento: un recorrido por desplazamiento omite o repite entradas de forma silenciosa cuando se agregan o eliminan entradas a mitad del recorrido, y quien llama no puede detectar que eso ocurrió. Tipo: [`RouterPageCursor`](#routerpagecursor): cursor opaco devuelto como `next_cursor`, de 1–512 caracteres @@ -1343,7 +1342,7 @@ Tipo: `object` ### RouterModelSegment -La parte del modelo en un ID de modelo con formato `{provider}/{model}`. +La parte del modelo dentro de un ID de modelo con formato `{provider}/{model}`. Tipo: `string` -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, de hasta 128 caracteres @@ -1357,16 +1356,16 @@ Tipo: `string` -- Cursor opaco devuelto como `next_cursor`, de 1 a 512 caractere La parte del proveedor de un ID de modelo `{provider}/{model}`. -Tipo: `string`. Slug alfanumérico, p. ej. `anthropic`. Hasta 64 caracteres. +Tipo: `string`. Slug alfanumérico, por ejemplo `anthropic`. Hasta 64 caracteres. ### RouterQueueCancelResponse -La respuesta a una solicitud de cancelación para los dos estados que describen una solicitud que esta ruta resolvió: el `202` y el `409`. Una sola forma de cuerpo para ambos en lugar de un sobre de éxito más un sobre de error, porque ambos son la misma declaración (lo que encontró la cancelación), y un cliente que tiene que analizar un tipo distinto por código de estado no gana nada con la división. +La respuesta a una solicitud de cancelación para los dos estados que describen una solicitud que esta ruta resolvió: el `202` y el `409`. Una sola forma de cuerpo para ambos en lugar de un envoltorio de éxito más un envoltorio de error, porque ambos expresan lo mismo (lo que encontró la cancelación), y un cliente que tiene que analizar un tipo distinto por código de estado no gana nada con esa división. **Campos** - Identificador de una solicitud de Router en cola: el identificador mediante el cual un cliente consulta, cancela y recoge un resultado. + Identificador de una solicitud de Router en cola: el identificador con el que un cliente consulta, cancela y recoge un resultado. Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) (`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres) @@ -1403,7 +1402,7 @@ Tipo: `string` ### RouterQueueStatusFields -La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad de una solicitud en cola, su estado actual y, cuando ese estado es terminal y la ejecución no tuvo éxito, el grupo general que indica por qué. +La mitad de `RouterQueueStatusResponse` que no forma parte del bloque de URL: la identidad de una solicitud en cola, su estado actual y, cuando ese estado es terminal y la ejecución no tuvo éxito, el grupo general que indica por qué. **Campos** @@ -1414,7 +1413,7 @@ La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad - El estado de una solicitud en cola del Router. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas son cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta un grupo no reconocido fallaría con más fuerza justo cuando algo ya había salido mal. Este es un ciclo de vida, y un ciclo de vida con un cuarto estado añadido más tarde es un cambio incompatible para todos los bucles de consulta escritos contra él, se declare como enum o no. Por eso se declara como uno, y la restricción se indica donde un cliente puede verla. + El estado de una solicitud en cola del Router. Tiene exactamente tres valores y, a diferencia de `RouterErrorType`, este es un `enum` cerrado, porque los dos esquemas son cerrados en direcciones opuestas a propósito. `RouterErrorType` clasifica fallos y se espera que su conjunto crezca, así que un cliente generado que rechazara de forma estricta un grupo no reconocido fallaría más gravemente justo cuando algo ya había salido mal. Este es un ciclo de vida, y añadir más tarde un cuarto estado a un ciclo de vida es un cambio incompatible para todos los bucles de consulta escritos contra él, se declare como enum o no. Por eso se declara como tal, y la restricción se indica donde un cliente puede verla. Tipo: [`RouterQueueStatus`](#routerqueuestatus) @@ -1426,7 +1425,7 @@ La mitad de `RouterQueueStatusResponse` que no es el bloque de URL: la identidad - Presente solo en una solicitud `COMPLETED` que no tuvo éxito, y contiene el mismo grupo general que la lectura del resultado pone en `X-Comfy-Error-Type` cuando devuelve ese fallo. Es lo que distingue una solicitud terminal que tuvo éxito de una que falló o se canceló (no hay un estado terminal separado para ninguna de las dos), y está ausente en caso de éxito en lugar de ser null, así que comprueba su presencia. + Presente solo en una solicitud `COMPLETED` que no tuvo éxito, y contiene el mismo grupo general que la lectura del resultado pone en `X-Comfy-Error-Type` cuando devuelve ese fallo. Es lo que distingue una solicitud terminal que tuvo éxito de una que falló o se canceló (no hay un estado terminal separado para ninguna de las dos), y está ausente en caso de éxito en lugar de ser null, así que decide según su presencia. Tipo: [`RouterErrorType`](#routererrortype) @@ -1441,7 +1440,7 @@ Tipo: `object` ### RouterQueueSubmitFields -La parte de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad de la nueva solicitud y su estado en el instante en que se admitió. +La mitad de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad de la nueva solicitud y su estado en el instante en que se admitió. **Campos** @@ -1471,7 +1470,7 @@ La parte de `RouterQueueSubmitResponse` que no es el bloque de URL: la identidad ### RouterQueueSubmitResponse -El identificador devuelto cuando la cola admite una ejecución: la identidad y el estado de la solicitud, junto con las tres URL que abarcan el resto de su ciclo de vida. +El identificador que se devuelve cuando se admite una ejecución en la cola: la identidad y el estado de la solicitud, junto con las tres URL que cubren el resto de su ciclo de vida. Combina [`RouterQueueUrls`](#routerqueueurls) y [`RouterQueueSubmitFields`](#routerqueuesubmitfields). @@ -1479,7 +1478,7 @@ Tipo: `object` ### RouterQueueUrls -Las tres URL que abarcan el resto del ciclo de vida de una solicitud en cola; se devuelven en cada respuesta que incluye un handle activo para que el cliente nunca tenga que componer por su cuenta una URL de cola. +Las tres URL que apuntan al resto del ciclo de vida de una solicitud en cola, devueltas en cada respuesta que incluye un handle activo para que el cliente nunca tenga que componer por su cuenta una URL de cola. **Campos** @@ -1526,7 +1525,7 @@ Un fallo de validación a nivel de campo. - El límite violado para un `RouterValidationErrorDetail`, transmitido literalmente desde el proveedor. Por ejemplo, `{"limit_value": 8}` junto a `greater_than`, `{"min_width": 512}` junto a `image_too_small`, o `{"max_size_bytes": 10485760}` junto a `file_too_large`. El conjunto de claves es específico del proveedor y del tipo de error, así que deliberadamente es un objeto abierto: restringirlo a una lista fija de campos, o plegarlo dentro de la cadena `msg`, es precisamente cómo una integración portada compila y luego pierde silenciosamente la rama que leía el límite. Ausente cuando el tipo de error no lleva un límite. + El límite violado para un `RouterValidationErrorDetail`, transmitido literalmente desde el proveedor. Por ejemplo, `{"limit_value": 8}` junto a `greater_than`, `{"min_width": 512}` junto a `image_too_small`, o `{"max_size_bytes": 10485760}` junto a `file_too_large`. El conjunto de claves es específico del proveedor y del tipo de error, así que deliberadamente es un objeto abierto: restringirlo a una lista fija de campos, o plegarlo dentro de la cadena `msg`, es precisamente cómo una integración portada compila y luego pierde en silencio la rama que leía el límite. Ausente cuando el tipo de error no lleva un límite. Tipo: [`RouterValidationErrorContext`](#routervalidationerrorcontext) @@ -1548,7 +1547,7 @@ El cuerpo del error de validación `422`. Consulta `X-Comfy-Error-Type` para con **Campos** - Cada fallo de validación encontrado en la solicitud, una entrada por campo con problemas. + Cada fallo de validación encontrado en la solicitud, una entrada por cada campo con problemas. Tipo: array de [`RouterValidationErrorDetail`](#routervalidationerrordetail) From 91c2078a78e5db3ad5b4a4b6924a76c3148a9f30 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 12 Nov 2026 11:20:29 +0800 Subject: [PATCH 19/36] i18n: point the router pricing rows at the localized MiniMax H3 Image pages --- es/development/comfy-router/pricing.mdx | 8 ++++---- ja/development/comfy-router/pricing.mdx | 8 ++++---- ko/development/comfy-router/pricing.mdx | 8 ++++---- zh/development/comfy-router/pricing.mdx | 8 ++++---- 4 files changed, 16 insertions(+), 16 deletions(-) diff --git a/es/development/comfy-router/pricing.mdx b/es/development/comfy-router/pricing.mdx index fffe41ce25..0f3c13025f 100644 --- a/es/development/comfy-router/pricing.mdx +++ b/es/development/comfy-router/pricing.mdx @@ -34,8 +34,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | Texto: 1508.65
Imagen: 2413.84 | Texto: 3017.3
Imagen: 9051.9 | | [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | Texto: 1508.65
Imagen: 2413.84 | Texto: 3017.3
Imagen: 9051.9 | | [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | Texto: 1055
Imagen: 1688 | Texto: 2110
Imagen: 6752 | -| [MiniMax H3 Image](/es/development/comfy-router/models) | `minimax/minimax-h3-image` | Texto: 693.979
Imagen: 452.595 | Imagen: 1146.574 | -| [MiniMax H3 Image Highspeed](/es/development/comfy-router/models) | `minimax/minimax-h3-image-highspeed` | Texto: 693.979
Imagen: 905.19 | Imagen: 2293.148 | +| [MiniMax H3 Image](/es/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | Texto: 693.979
Imagen: 452.595 | Imagen: 1146.574 | +| [MiniMax H3 Image Highspeed](/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | Texto: 693.979
Imagen: 905.19 | Imagen: 2293.148 | | [Nano Banana 2](/es/development/comfy-router/models/google/nano-banana-2/code) | `vertexai/gemini-3.1-flash-image` | Imagen / Texto / Video: 126.6 | Texto / Razonamiento: 759.6
Imagen: 15192 | | [Nano Banana 2 Lite](/es/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | Imagen / Texto / Video: 63.3 | Texto / Razonamiento: 379.8
Imagen: 7596 | | [Nano Banana Pro](/es/development/comfy-router/models/google/nano-banana-pro/code) | `vertexai/gemini-3-pro-image` | Imagen / Texto: 506.4 | Texto / Razonamiento: 3038.4
Imagen: 30384 | @@ -779,8 +779,8 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | Texto: $7.15
Imagen: $11.44 | Texto: $14.30
Imagen: $42.90 | | [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | Texto: $7.15
Imagen: $11.44 | Texto: $14.30
Imagen: $42.90 | | [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | Texto: $5.00
Imagen: $8.00 | Texto: $10.00
Imagen: $32.00 | -| [MiniMax H3 Image](/es/development/comfy-router/models) | `minimax/minimax-h3-image` | Texto: $3.289
Imagen: $2.145 | Imagen: $5.434 | -| [MiniMax H3 Image Highspeed](/es/development/comfy-router/models) | `minimax/minimax-h3-image-highspeed` | Texto: $3.289
Imagen: $4.29 | Imagen: $10.868 | +| [MiniMax H3 Image](/es/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | Texto: $3.289
Imagen: $2.145 | Imagen: $5.434 | +| [MiniMax H3 Image Highspeed](/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | Texto: $3.289
Imagen: $4.29 | Imagen: $10.868 | | [Nano Banana 2](/es/development/comfy-router/models/google/nano-banana-2/code) | `vertexai/gemini-3.1-flash-image` | Imagen / Texto / Video: $0.60 | Texto / Razonamiento: $3.60
Imagen: $72.00 | | [Nano Banana 2 Lite](/es/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | Imagen / Texto / Video: $0.30 | Texto / Razonamiento: $1.80
Imagen: $36.00 | | [Nano Banana Pro](/es/development/comfy-router/models/google/nano-banana-pro/code) | `vertexai/gemini-3-pro-image` | Imagen / Texto: $2.40 | Texto / Razonamiento: $14.40
Imagen: $144.00 | diff --git a/ja/development/comfy-router/pricing.mdx b/ja/development/comfy-router/pricing.mdx index 863e343925..1b80ece0c5 100644 --- a/ja/development/comfy-router/pricing.mdx +++ b/ja/development/comfy-router/pricing.mdx @@ -34,8 +34,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | テキスト: 1508.65
画像: 2413.84 | テキスト: 3017.3
画像: 9051.9 | | [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | テキスト: 1508.65
画像: 2413.84 | テキスト: 3017.3
画像: 9051.9 | | [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | テキスト: 1055
画像: 1688 | テキスト: 2110
画像: 6752 | -| [MiniMax H3 Image](/ja/development/comfy-router/models) | `minimax/minimax-h3-image` | テキスト: 693.979
画像: 452.595 | 画像: 1146.574 | -| [MiniMax H3 Image Highspeed](/ja/development/comfy-router/models) | `minimax/minimax-h3-image-highspeed` | テキスト: 693.979
画像: 905.19 | 画像: 2293.148 | +| [MiniMax H3 Image](/ja/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | テキスト: 693.979
画像: 452.595 | 画像: 1146.574 | +| [MiniMax H3 Image Highspeed](/ja/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | テキスト: 693.979
画像: 905.19 | 画像: 2293.148 | | [Nano Banana 2](/ja/development/comfy-router/models/google/nano-banana-2/code) | `vertexai/gemini-3.1-flash-image` | 画像 / テキスト / 動画: 126.6 | テキスト / 推論: 759.6
画像: 15192 | | [Nano Banana 2 Lite](/ja/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | 画像 / テキスト / 動画: 63.3 | テキスト / 推論: 379.8
画像: 7596 | | [Nano Banana Pro](/ja/development/comfy-router/models/google/nano-banana-pro/code) | `vertexai/gemini-3-pro-image` | 画像 / テキスト: 506.4 | テキスト / 推論: 3038.4
画像: 30384 | @@ -779,8 +779,8 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | テキスト: $7.15
画像: $11.44 | テキスト: $14.30
画像: $42.90 | | [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | テキスト: $7.15
画像: $11.44 | テキスト: $14.30
画像: $42.90 | | [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | テキスト: $5.00
画像: $8.00 | テキスト: $10.00
画像: $32.00 | -| [MiniMax H3 Image](/ja/development/comfy-router/models) | `minimax/minimax-h3-image` | テキスト: $3.289
画像: $2.145 | 画像: $5.434 | -| [MiniMax H3 Image Highspeed](/ja/development/comfy-router/models) | `minimax/minimax-h3-image-highspeed` | テキスト: $3.289
画像: $4.29 | 画像: $10.868 | +| [MiniMax H3 Image](/ja/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | テキスト: $3.289
画像: $2.145 | 画像: $5.434 | +| [MiniMax H3 Image Highspeed](/ja/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | テキスト: $3.289
画像: $4.29 | 画像: $10.868 | | [Nano Banana 2](/ja/development/comfy-router/models/google/nano-banana-2/code) | `vertexai/gemini-3.1-flash-image` | 画像 / テキスト / 動画: $0.60 | テキスト / 推論: $3.60
画像: $72.00 | | [Nano Banana 2 Lite](/ja/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | 画像 / テキスト / 動画: $0.30 | テキスト / 推論: $1.80
画像: $36.00 | | [Nano Banana Pro](/ja/development/comfy-router/models/google/nano-banana-pro/code) | `vertexai/gemini-3-pro-image` | 画像 / テキスト: $2.40 | テキスト / 推論: $14.40
画像: $144.00 | diff --git a/ko/development/comfy-router/pricing.mdx b/ko/development/comfy-router/pricing.mdx index fb076f6992..8cb206cbd5 100644 --- a/ko/development/comfy-router/pricing.mdx +++ b/ko/development/comfy-router/pricing.mdx @@ -34,8 +34,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 텍스트: 1508.65
이미지: 2413.84 | 텍스트: 3017.3
이미지: 9051.9 | | [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 텍스트: 1508.65
이미지: 2413.84 | 텍스트: 3017.3
이미지: 9051.9 | | [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 텍스트: 1055
이미지: 1688 | 텍스트: 2110
이미지: 6752 | -| [MiniMax H3 Image](/ko/development/comfy-router/models) | `minimax/minimax-h3-image` | 텍스트: 693.979
이미지: 452.595 | 이미지: 1146.574 | -| [MiniMax H3 Image Highspeed](/ko/development/comfy-router/models) | `minimax/minimax-h3-image-highspeed` | 텍스트: 693.979
이미지: 905.19 | 이미지: 2293.148 | +| [MiniMax H3 Image](/ko/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | 텍스트: 693.979
이미지: 452.595 | 이미지: 1146.574 | +| [MiniMax H3 Image Highspeed](/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | 텍스트: 693.979
이미지: 905.19 | 이미지: 2293.148 | | [Nano Banana 2](/ko/development/comfy-router/models/google/nano-banana-2/code) | `vertexai/gemini-3.1-flash-image` | 이미지 / 텍스트 / 동영상: 126.6 | 텍스트 / 추론: 759.6
이미지: 15192 | | [Nano Banana 2 Lite](/ko/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | 이미지 / 텍스트 / 동영상: 63.3 | 텍스트 / 추론: 379.8
이미지: 7596 | | [Nano Banana Pro](/ko/development/comfy-router/models/google/nano-banana-pro/code) | `vertexai/gemini-3-pro-image` | 이미지 / 텍스트: 506.4 | 텍스트 / 추론: 3038.4
이미지: 30384 | @@ -779,8 +779,8 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 텍스트: $7.15
이미지: $11.44 | 텍스트: $14.30
이미지: $42.90 | | [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 텍스트: $7.15
이미지: $11.44 | 텍스트: $14.30
이미지: $42.90 | | [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 텍스트: $5.00
이미지: $8.00 | 텍스트: $10.00
이미지: $32.00 | -| [MiniMax H3 Image](/ko/development/comfy-router/models) | `minimax/minimax-h3-image` | 텍스트: $3.289
이미지: $2.145 | 이미지: $5.434 | -| [MiniMax H3 Image Highspeed](/ko/development/comfy-router/models) | `minimax/minimax-h3-image-highspeed` | 텍스트: $3.289
이미지: $4.29 | 이미지: $10.868 | +| [MiniMax H3 Image](/ko/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | 텍스트: $3.289
이미지: $2.145 | 이미지: $5.434 | +| [MiniMax H3 Image Highspeed](/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | 텍스트: $3.289
이미지: $4.29 | 이미지: $10.868 | | [Nano Banana 2](/ko/development/comfy-router/models/google/nano-banana-2/code) | `vertexai/gemini-3.1-flash-image` | 이미지 / 텍스트 / 동영상: $0.60 | 텍스트 / 추론: $3.60
이미지: $72.00 | | [Nano Banana 2 Lite](/ko/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | 이미지 / 텍스트 / 동영상: $0.30 | 텍스트 / 추론: $1.80
이미지: $36.00 | | [Nano Banana Pro](/ko/development/comfy-router/models/google/nano-banana-pro/code) | `vertexai/gemini-3-pro-image` | 이미지 / 텍스트: $2.40 | 텍스트 / 추론: $14.40
이미지: $144.00 | diff --git a/zh/development/comfy-router/pricing.mdx b/zh/development/comfy-router/pricing.mdx index b0fef9326e..bf5a806eee 100644 --- a/zh/development/comfy-router/pricing.mdx +++ b/zh/development/comfy-router/pricing.mdx @@ -34,8 +34,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 文本: 1508.65
图像: 2413.84 | 文本: 3017.3
图像: 9051.9 | | [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 文本: 1508.65
图像: 2413.84 | 文本: 3017.3
图像: 9051.9 | | [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 文本: 1055
图像: 1688 | 文本: 2110
图像: 6752 | -| [MiniMax H3 Image](/zh/development/comfy-router/models) | `minimax/minimax-h3-image` | 文本: 693.979
图像: 452.595 | 图像: 1146.574 | -| [MiniMax H3 Image Highspeed](/zh/development/comfy-router/models) | `minimax/minimax-h3-image-highspeed` | 文本: 693.979
图像: 905.19 | 图像: 2293.148 | +| [MiniMax H3 Image](/zh/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | 文本: 693.979
图像: 452.595 | 图像: 1146.574 | +| [MiniMax H3 Image Highspeed](/zh/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | 文本: 693.979
图像: 905.19 | 图像: 2293.148 | | [Nano Banana 2](/zh/development/comfy-router/models/google/nano-banana-2/code) | `vertexai/gemini-3.1-flash-image` | 图像 / 文本 / 视频: 126.6 | 文本 / 推理: 759.6
图像: 15192 | | [Nano Banana 2 Lite](/zh/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | 图像 / 文本 / 视频: 63.3 | 文本 / 推理: 379.8
图像: 7596 | | [Nano Banana Pro](/zh/development/comfy-router/models/google/nano-banana-pro/code) | `vertexai/gemini-3-pro-image` | 图像 / 文本: 506.4 | 文本 / 推理: 3038.4
图像: 30384 | @@ -779,8 +779,8 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 文本: $7.15
图像: $11.44 | 文本: $14.30
图像: $42.90 | | [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 文本: $7.15
图像: $11.44 | 文本: $14.30
图像: $42.90 | | [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 文本: $5.00
图像: $8.00 | 文本: $10.00
图像: $32.00 | -| [MiniMax H3 Image](/zh/development/comfy-router/models) | `minimax/minimax-h3-image` | 文本: $3.289
图像: $2.145 | 图像: $5.434 | -| [MiniMax H3 Image Highspeed](/zh/development/comfy-router/models) | `minimax/minimax-h3-image-highspeed` | 文本: $3.289
图像: $4.29 | 图像: $10.868 | +| [MiniMax H3 Image](/zh/development/comfy-router/models/minimax/minimax-h3-image/code) | `minimax/minimax-h3-image` | 文本: $3.289
图像: $2.145 | 图像: $5.434 | +| [MiniMax H3 Image Highspeed](/zh/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code) | `minimax/minimax-h3-image-highspeed` | 文本: $3.289
图像: $4.29 | 图像: $10.868 | | [Nano Banana 2](/zh/development/comfy-router/models/google/nano-banana-2/code) | `vertexai/gemini-3.1-flash-image` | 图像 / 文本 / 视频: $0.60 | 文本 / 推理: $3.60
图像: $72.00 | | [Nano Banana 2 Lite](/zh/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | 图像 / 文本 / 视频: $0.30 | 文本 / 推理: $1.80
图像: $36.00 | | [Nano Banana Pro](/zh/development/comfy-router/models/google/nano-banana-pro/code) | `vertexai/gemini-3-pro-image` | 图像 / 文本: $2.40 | 文本 / 推理: $14.40
图像: $144.00 | From 498dd09402a5d9a44fa55c1eaa646b51d5a83d0a Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 12 Nov 2026 11:21:44 +0800 Subject: [PATCH 20/36] i18n(ko): move the video model list back under the video accordion --- ko/development/comfy-router/models.mdx | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index 94ded37eca..1af91d5b47 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -111,10 +111,7 @@ translationBlockHashes: - [Gen 4 Turbo](/ko/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ko/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [오디오 비디오 정리](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`
- - - +- [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` - [립싱크 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [비디오 배경 제거 Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [비디오 배경 제거 초록색 스크린](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` From 78916f56690b676035919863d8b995bb45408fb0 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 12 Nov 2026 11:27:25 +0800 Subject: [PATCH 21/36] i18n: split glued field tags and translate the remaining router response bodies --- .../byteplus/dreamina-seedance-2-0-fast-260128/code.mdx | 3 ++- .../models/byteplus/seedance-1-5-pro-251215/code.mdx | 3 ++- es/development/comfy-router/reference.mdx | 6 ++++-- .../byteplus/dreamina-seedance-2-0-fast-260128/code.mdx | 3 ++- .../models/byteplus/dreamina-seedance-2-0-mini/code.mdx | 3 ++- .../models/byteplus/dreamina-seedance-2-5-260628/code.mdx | 3 ++- .../models/byteplus/seedance-1-0-pro-250528/code.mdx | 3 ++- .../models/byteplus/seedance-1-0-pro-fast-251015/code.mdx | 3 ++- .../models/byteplus/seedance-1-5-pro-251215/code.mdx | 2 +- ko/development/comfy-router/reference.mdx | 6 ++++-- .../models/byteplus/dreamina-seedance-2-0-260128/code.mdx | 3 ++- .../byteplus/dreamina-seedance-2-0-fast-260128/code.mdx | 3 ++- .../models/byteplus/dreamina-seedance-2-0-mini/code.mdx | 2 +- .../models/byteplus/dreamina-seedance-2-5-260628/code.mdx | 3 ++- .../models/byteplus/seedance-1-0-pro-fast-251015/code.mdx | 3 ++- .../models/byteplus/seedance-1-5-pro-251215/code.mdx | 3 ++- zh/development/comfy-router/reference.mdx | 6 ++++-- 17 files changed, 38 insertions(+), 20 deletions(-) diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 52bd01b70a..4861484c41 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -396,7 +396,8 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr El mensaje de error -El ID de la tarea de generación de video + + El ID de la tarea de generación de video diff --git a/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index d3a5dfaf3a..b79fce23c8 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -396,7 +396,8 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda El mensaje de error -The ID de la tarea de generación de video + + El ID de la tarea de generación de video diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index 4892382a87..fceae0ef56 100644 --- a/es/development/comfy-router/reference.mdx +++ b/es/development/comfy-router/reference.mdx @@ -1176,7 +1176,8 @@ Una estimación previa a la ejecución de lo que costará esta llamada, en dóla date-time -Se presenta solo cuando `source` es `unknown`: `not_quotable` (Router no puede calcular el precio de esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no limita una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no tiene precio para esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella) o `pricing_unavailable` (solo envío en cola: no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra como de costumbre). Interpreta cualquier otro valor como `not_quotable`. + + Se presenta solo cuando `source` es `unknown`: `not_quotable` (Router no puede calcular el precio de esta llamada antes de que se ejecute: su precio depende de lo que el proveedor informe de vuelta, o el cuerpo no limita una cantidad facturable), `unpriced_model` (la tarjeta de tarifas no tiene precio para esta solicitud), `byok` (solo envío en cola: la ejecución usa tu propia clave de proveedor, así que Comfy no cobra nada por ella) o `pricing_unavailable` (solo envío en cola: no se pudo leer la tarjeta de tarifas cuando se admitió la solicitud; esto es transitorio y la ejecución se cobra como de costumbre). Interpreta cualquier otro valor como `not_quotable`. ### RouterErrorResponse @@ -1213,7 +1214,8 @@ Cuerpo de error para fallos de autenticación, acceso, búsqueda de modelos, cuo Tipo: [`RouterBilledWorkspace`](#routerbilledworkspace) -Cómo se autenticó la solicitud rechazada: `personal_api_key`, `team_api_key`, `personal_session` o `team_session`. Responde a "¿a qué credencial cambio para facturar a la otra billetera?". No es un permiso y no otorga nada. Presente solo junto con `denied_reason`. + + Cómo se autenticó la solicitud rechazada: `personal_api_key`, `team_api_key`, `personal_session` o `team_session`. Responde a "¿a qué credencial cambio para facturar a la otra billetera?". No es un permiso y no otorga nada. Presente solo junto con `denied_reason`. ### RouterErrorType diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index b700261684..a75c8e7533 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -400,7 +400,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -비디오 생성 작업의 ID + + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 327cf95811..ed87f58287 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -398,7 +398,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -비디오 생성 작업의 ID + + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 6ddc08588d..306a583f4e 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -414,7 +414,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -비디오 생성 작업의 ID + + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index a545d5d20f..c22e0e1519 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -401,7 +401,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -비디오 생성 작업의 ID + + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 5d6b392c3d..ab9403c646 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -401,7 +401,8 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -비디오 생성 작업의 ID + + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 229379c60c..d096f88a92 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -401,7 +401,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 오류 메시지 -```mdx + 비디오 생성 작업의 ID diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index fd8190f744..78636aabfd 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -1192,7 +1192,8 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 date-time -`source`가 `unknown`일 때만 표시됩니다: `not_quotable` (Router가 이 호출의 실행 전 가격을 책정할 수 없음: 가격은 공급자가 회신하는 내용에 따라 달라지거나, 요청 본문이 과금 대상 수량을 한정하지 않기 때문입니다), `unpriced_model` (요율 카드가 이 요청의 가격을 책정하지 않음), `byok` (대기 중 제출에만 해당: 실행에 사용자의 공급자 키가 사용되므로 Comfy는 이에 대해 비용을 청구하지 않습니다), 또는 `pricing_unavailable` (대기 중 제출에만 해당: 요청이 접수될 때 요율 카드를 읽을 수 없었습니다. 이는 일시적인 현상이며, 실행은 평소와 같이 과금됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. + + `source`가 `unknown`일 때만 표시됩니다: `not_quotable` (Router가 이 호출의 실행 전 가격을 책정할 수 없음: 가격은 공급자가 회신하는 내용에 따라 달라지거나, 요청 본문이 과금 대상 수량을 한정하지 않기 때문입니다), `unpriced_model` (요율 카드가 이 요청의 가격을 책정하지 않음), `byok` (대기 중 제출에만 해당: 실행에 사용자의 공급자 키가 사용되므로 Comfy는 이에 대해 비용을 청구하지 않습니다), 또는 `pricing_unavailable` (대기 중 제출에만 해당: 요청이 접수될 때 요율 카드를 읽을 수 없었습니다. 이는 일시적인 현상이며, 실행은 평소와 같이 과금됩니다). 다른 값은 모두 `not_quotable`로 해석합니다. ### RouterErrorResponse @@ -1229,7 +1230,8 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 유형: [`RouterBilledWorkspace`](#routerbilledworkspace) -요청이 거부된 인증 방식 - `personal_api_key`, `team_api_key`, `personal_session` 또는 `team_session`. "다른 지갑으로 과금하려면 어떤 자격 증명으로 전환해야 하나?"라는 질문에 답합니다. 이는 권한이 아니며 아무것도 부여하지 않습니다. `denied_reason`과 함께 있을 때만 표시됩니다. + + 요청이 거부된 인증 방식 - `personal_api_key`, `team_api_key`, `personal_session` 또는 `team_session`. "다른 지갑으로 과금하려면 어떤 자격 증명으로 전환해야 하나?"라는 질문에 답합니다. 이는 권한이 아니며 아무것도 부여하지 않습니다. `denied_reason`과 함께 있을 때만 표시됩니다. ### RouterErrorType diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 33eb25b254..60b1c8a805 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -407,7 +407,8 @@ false: 不返回所生成视频的最后一帧图像。 报错信息 -视频生成任务的 ID + + 视频生成任务的 ID diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 8d8f8e47b3..871fe23914 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -395,7 +395,8 @@ false: 不返回已生成视频的最后一帧图像。 报错信息 -The ID of the video generation task + + 视频生成任务的 ID diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index f4f2c54c93..189a836383 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -393,7 +393,7 @@ false:不返回已生成视频的最后一帧图像。 报错信息 -```mdx + 视频生成任务的 ID diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 1ce8bae6ef..57080b35de 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -412,7 +412,8 @@ Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的宽高比,因此 报错信息 -The ID of the video generation task + + 视频生成任务的 ID diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 65fa2c9021..964757845e 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -399,7 +399,8 @@ false: 不返回已生成视频的最后一帧图像。 报错信息 -The ID of the video generation task + + 视频生成任务的 ID diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 264060d464..79ce67fcf9 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -399,7 +399,8 @@ false: 不返回已生成视频的最后一帧图像。 报错信息 -The ID of the video generation task -> 视频生成任务的 ID + + 视频生成任务的 ID diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 781356e26a..7c4a11bd54 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -1190,7 +1190,8 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ date-time -仅当 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在调用运行之前为其定价,价格取决于提供商回传的内容,或者请求体未限定计费数量)、`unpriced_model`(费率卡片未对该请求定价)、`byok`(仅适用于已执行提交:该运行使用你自己的提供商密钥,因此 Comfy 不为此计费),或 `pricing_unavailable`(仅适用于已执行提交:请求被受理时无法读取费率卡片;这是暂时性的,该运行仍照常计费)。读取到任何其他值时,一律视为 `not_quotable`。 + + 仅当 `source` 为 `unknown` 时出现:`not_quotable`(Router 无法在调用运行之前为其定价,价格取决于提供商回传的内容,或者请求体未限定计费数量)、`unpriced_model`(费率卡片未对该请求定价)、`byok`(仅适用于已执行提交:该运行使用你自己的提供商密钥,因此 Comfy 不为此计费),或 `pricing_unavailable`(仅适用于已执行提交:请求被受理时无法读取费率卡片;这是暂时性的,该运行仍照常计费)。读取到任何其他值时,一律视为 `not_quotable`。 ### RouterErrorResponse @@ -1227,7 +1228,8 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ Type: [`RouterBilledWorkspace`](#routerbilledworkspace) -被拒绝的请求通过哪种方式完成认证:`personal_api_key`、`team_api_key`、`personal_session` 或 `team_session`。用于回答“我该切换到哪个凭据,才能向另一个钱包计费?”。它并非权限,也不授予任何权限。仅与 `denied_reason` 一同出现。 + + 被拒绝的请求通过哪种方式完成认证:`personal_api_key`、`team_api_key`、`personal_session` 或 `team_session`。用于回答“我该切换到哪个凭据,才能向另一个钱包计费?”。它并非权限,也不授予任何权限。仅与 `denied_reason` 一同出现。 ### RouterErrorType From a32d3af05ffbf5743d2c0a5e064e17e40ca6d395 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 12 Nov 2026 11:37:20 +0800 Subject: [PATCH 22/36] i18n: restore the router models index lists and accordion order --- es/development/comfy-router/models.mdx | 45 +++++++++++++++++++++++--- ja/development/comfy-router/models.mdx | 15 ++++++--- ko/development/comfy-router/models.mdx | 12 ++++--- zh/development/comfy-router/models.mdx | 12 ++++--- 4 files changed, 66 insertions(+), 18 deletions(-) diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 0cc0bf4fdd..f0fe9ddcce 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -110,7 +110,38 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/es/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [Clean Audio Video](/es/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/es/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` +- [Fabric 1.0](/es/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` +- [Lipsync 2.0](/es/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Video Background Removal Fast](/es/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` +- [Video Background Removal Green Screen](/es/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` +- [Video Background Removal](/es/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` +- [Veo 3.1 Fast Generate 001](/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` +- [Veo 3.1 Generate 001](/es/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` +- [Veo 3.1 Lite Generate 001](/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` +- [HappyHorse 1.0 I2V](/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` +- [HappyHorse 1.0 R2V](/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code): `wan/happyhorse-1.0-r2v` +- [HappyHorse 1.0 T2V](/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code): `wan/happyhorse-1.0-t2v` +- [HappyHorse 1.0 Video Edit](/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code): `wan/happyhorse-1.0-video-edit` +- [HappyHorse 1.1 I2V](/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code): `wan/happyhorse-1.1-i2v` +- [HappyHorse 1.1 R2V](/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code): `wan/happyhorse-1.1-r2v` +- [HappyHorse 1.1 T2V](/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code): `wan/happyhorse-1.1-t2v` +- [Wan 2.5 I2V Preview](/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code): `wan/wan2.5-i2v-preview` +- [Wan 2.5 T2V Preview](/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` +- [Wan 2.6 I2V](/es/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` +- [Wan 2.6 R2V](/es/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` +- [Wan 2.6 T2V](/es/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` +- [Wan 2.7 I2V](/es/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.7 R2V](/es/development/comfy-router/models/wan/wan2-7-r2v/code): `wan/wan2.7-r2v` +- [Wan 2.7 T2V](/es/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` +- [Wan 2.7 Video Edit](/es/development/comfy-router/models/wan/wan2-7-videoedit/code): `wan/wan2.7-videoedit` +- [Wan 3.0 Video Prime](/es/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` +- [Wan 3.0 Video](/es/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` +- [Flashvsr](/es/development/comfy-router/models/wavespeed/flashvsr/code): `wavespeed/flashvsr` +- [Grok Imagine Video 1.5 Lite](/es/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code): `xai/grok-imagine-video-1.5-lite` +- [Grok Imagine Video 1.5 Preview](/es/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code): `xai/grok-imagine-video-1.5-preview` +- [Grok Imagine Video 1.5](/es/development/comfy-router/models/xai/grok-imagine-video-1-5/code): `xai/grok-imagine-video-1.5` +- [Grok Imagine Video](/es/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` +
- [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` @@ -133,7 +164,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/es/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` +- [Image Edit Remove Background Guided](/es/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/es/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/es/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [Image Edit Replace Object By Text](/es/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -183,7 +215,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Qwen Image 3.0 Pro](/es/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/es/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` -- [Recraft V2](/es/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2`- [Recraft V3](/es/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` +- [Recraft V2](/es/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` +- [Recraft V3](/es/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` - [Recraft V4.1 Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` - [Recraft V4.1 Pro](/es/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/es/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` @@ -235,7 +268,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [FLUX 3 Video](/es/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128`- [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` +- [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/es/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` @@ -292,7 +326,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Rigging](/es/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/es/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part`- [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Part](/es/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` +- [Hunyuan 3D Smart Topology](/es/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` - [Hunyuan 3D Texture Edit](/es/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index 5c969d4c14..152c86c775 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -111,7 +111,8 @@ translationBlockHashes: - [Gen 4 Turbo](/ja/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ja/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` - [オーディオとビデオをクリーン化](/ja/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0`- [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` +- [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ja/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ja/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` - [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` @@ -165,7 +166,8 @@ translationBlockHashes: - [Image Edit Increase Resolution](/ja/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/ja/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/ja/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` +- [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ja/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ja/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -215,7 +217,8 @@ translationBlockHashes: - [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Qwen Image 3.0 Pro](/ja/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/ja/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` -- [Recraft V2](/ja/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2`- [Recraft V3](/ja/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` +- [Recraft V2](/ja/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` +- [Recraft V3](/ja/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` - [Recraft V4.1 Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` - [Recraft V4.1 Pro](/ja/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` @@ -267,7 +270,8 @@ translationBlockHashes: - [FLUX 3 Video](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128`- [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` +- [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/ja/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` @@ -324,7 +328,8 @@ translationBlockHashes: - [Rigging](/ja/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/ja/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ja/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/ja/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part`- [Hunyuan 3D Smart Topology](/ja/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Part](/ja/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` +- [Hunyuan 3D Smart Topology](/ja/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` - [Hunyuan 3D Texture Edit](/ja/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/ja/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index 1af91d5b47..fc191d85f0 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -166,7 +166,8 @@ translationBlockHashes: - [이미지 편집 해상도 높이기](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [이미지 편집 제품 들기](/ko/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [이미지 편집 제품 가상 착용](/ko/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [이미지 편집 Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight`- [Image Edit Remove Background Guided](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [이미지 편집 Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` +- [Image Edit Remove Background Guided](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` - [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` @@ -216,7 +217,8 @@ translationBlockHashes: - [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Qwen Image 3.0 Pro](/ko/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/ko/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` -- [Recraft V2](/ko/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2`- [Recraft V3](/ko/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` +- [Recraft V2](/ko/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` +- [Recraft V3](/ko/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` - [Recraft V4.1 Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` - [Recraft V4.1 Pro](/ko/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` @@ -268,7 +270,8 @@ translationBlockHashes: - [FLUX 3 Video](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128`- [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` +- [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 다국어](/ko/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` @@ -325,7 +328,8 @@ translationBlockHashes: - [리깅](/ko/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/ko/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ko/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/ko/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part`- [Hunyuan 3D Smart Topology](/ko/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Part](/ko/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` +- [Hunyuan 3D Smart Topology](/ko/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology` - [Hunyuan 3D Texture Edit](/ko/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/ko/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index 7ea320b28f..ae9eb4d5d7 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -111,7 +111,8 @@ translationBlockHashes: - [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code):`runway/gen4_turbo` - [Sync 3](/zh/development/comfy-router/models/synclabs/sync-3/code):`synclabs/sync-3` - [Clean Audio Video](/zh/development/comfy-router/models/veed/clean-audio-video/code):`veed/clean-audio-video` -- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0`- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` +- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0` +- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` - [Video Background Removal Fast](/zh/development/comfy-router/models/veed/video-background-removal-fast/code):`veed/video-background-removal-fast` - [Video Background Removal Green Screen](/zh/development/comfy-router/models/veed/video-background-removal-green-screen/code):`veed/video-background-removal-green-screen` - [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal` @@ -216,7 +217,8 @@ translationBlockHashes: - [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code):`openai/gpt-image-2` - [Qwen Image 3.0 Pro](/zh/development/comfy-router/models/qwen/qwen-image-3-0-pro/code):`qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/zh/development/comfy-router/models/qwen/qwen-image-3-0/code):`qwen/qwen-image-3.0` -- [Recraft V2](/zh/development/comfy-router/models/recraft/recraftv2/code):`recraft/recraftv2`- [Recraft V3](/zh/development/comfy-router/models/recraft/recraftv3/code):`recraft/recraftv3` +- [Recraft V2](/zh/development/comfy-router/models/recraft/recraftv2/code):`recraft/recraftv2` +- [Recraft V3](/zh/development/comfy-router/models/recraft/recraftv3/code):`recraft/recraftv3` - [Recraft V4.1 Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code):`recraft/recraftv4_1_pro_vector` - [Recraft V4.1 Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-pro/code):`recraft/recraftv4_1_pro` - [Recraft V4.1 Utility Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code):`recraft/recraftv4_1_utility_pro_vector` @@ -268,7 +270,8 @@ translationBlockHashes: - [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code):`bfl/flux-3-video` -- [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code):`byteplus/dreamina-seedance-2-0-260128`- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code):`byteplus/dreamina-seedance-2-0-260128` +- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code):`byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code):`byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/zh/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code):`byteplus/seed-audio-1.0-multilingual` @@ -325,7 +328,8 @@ translationBlockHashes: - [Rigging](/zh/development/comfy-router/models/meshy/rigging/code):`meshy/rigging` - [Stable Fast 3D](/zh/development/comfy-router/models/stability/stable-fast-3d/code):`stability/stable-fast-3d` - [Stable Point Aware 3D](/zh/development/comfy-router/models/stability/stable-point-aware-3d/code):`stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/zh/development/comfy-router/models/tencent/hunyuan-3d-part/code):`tencent/hunyuan-3d-part`- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology` +- [Hunyuan 3D Part](/zh/development/comfy-router/models/tencent/hunyuan-3d-part/code):`tencent/hunyuan-3d-part` +- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology` - [Hunyuan 3D Texture Edit](/zh/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code):`tencent/hunyuan-3d-texture-edit` - [Hunyuan 3D Uv](/zh/development/comfy-router/models/tencent/hunyuan-3d-uv/code):`tencent/hunyuan-3d-uv` From f33fa033fd8ea4c42d56a988100728850cc707c6 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Fri, 13 Nov 2026 11:04:13 +0800 Subject: [PATCH 23/36] i18n: resync router code pages after the 2026-11-12 cloud sync (batch 1) --- .../anthropic/claude-fable-5-1/code.mdx | 7 ++-- .../models/anthropic/claude-fable-5/code.mdx | 7 ++-- .../claude-haiku-4-5-20251001/code.mdx | 9 +++-- .../models/anthropic/claude-opus-4-6/code.mdx | 7 ++-- .../models/anthropic/claude-opus-4-7/code.mdx | 7 ++-- .../models/anthropic/claude-opus-4-8/code.mdx | 7 ++-- .../models/anthropic/claude-opus-5-5/code.mdx | 9 +++-- .../models/anthropic/claude-opus-5/code.mdx | 7 ++-- .../claude-sonnet-4-5-20250929/code.mdx | 7 ++-- .../anthropic/claude-sonnet-4-6/code.mdx | 7 ++-- .../models/anthropic/claude-sonnet-5/code.mdx | 7 ++-- .../comfy-router/models/krea/krea-3/code.mdx | 35 +++++++++-------- ja/development/comfy-router/providers.mdx | 31 +++++++-------- .../anthropic/claude-fable-5-1/code.mdx | 7 ++-- .../models/anthropic/claude-fable-5/code.mdx | 7 ++-- .../claude-haiku-4-5-20251001/code.mdx | 7 ++-- .../models/anthropic/claude-opus-4-6/code.mdx | 7 ++-- .../models/anthropic/claude-opus-4-7/code.mdx | 7 ++-- .../models/anthropic/claude-opus-4-8/code.mdx | 7 ++-- .../models/anthropic/claude-opus-5-5/code.mdx | 7 ++-- .../models/anthropic/claude-opus-5/code.mdx | 7 ++-- .../claude-sonnet-4-5-20250929/code.mdx | 7 ++-- .../anthropic/claude-sonnet-4-6/code.mdx | 9 +++-- .../models/anthropic/claude-sonnet-5/code.mdx | 7 ++-- .../comfy-router/models/krea/krea-3/code.mdx | 38 +++++++++---------- ko/development/comfy-router/providers.mdx | 31 +++++++-------- .../anthropic/claude-fable-5-1/code.mdx | 7 ++-- .../models/anthropic/claude-fable-5/code.mdx | 7 ++-- .../claude-haiku-4-5-20251001/code.mdx | 7 ++-- .../models/anthropic/claude-opus-4-6/code.mdx | 7 ++-- .../models/anthropic/claude-opus-4-7/code.mdx | 7 ++-- .../models/anthropic/claude-opus-4-8/code.mdx | 7 ++-- .../models/anthropic/claude-opus-5-5/code.mdx | 9 +++-- .../models/anthropic/claude-opus-5/code.mdx | 7 ++-- .../claude-sonnet-4-5-20250929/code.mdx | 7 ++-- .../anthropic/claude-sonnet-4-6/code.mdx | 9 +++-- .../models/anthropic/claude-sonnet-5/code.mdx | 7 ++-- .../comfy-router/models/krea/krea-3/code.mdx | 33 ++++++++-------- zh/development/comfy-router/providers.mdx | 31 +++++++-------- 39 files changed, 236 insertions(+), 204 deletions(-) diff --git a/ja/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx b/ja/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx index 4305d8877f..344ba7487b 100644 --- a/ja/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Claude Fable 5.1 を使う" description: "Comfy Router 経由で anthropic/claude-fable-5-1 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Fable 5.1" -translationSourceHash: 0c17cbf0 +translationSourceHash: 72432b96 translationFrom: development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx translationBlockHashes: "_intro": d52eb513 "Quick start": 66ea5c23 - "Schema": d2c6492b + "Schema": 9180e71b "Examples": e6e3e477 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-fable-5-1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5-1/requests/$REQUES - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効(INERT)です。Router はディスパッチ前にこれを `false` に確定させ、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` にするとレスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` を false にするか省略してください。`/proxy/` オペレーションの 200 のうち `text/event-stream` の部分には、Router に対応するものがありません。 diff --git a/ja/development/comfy-router/models/anthropic/claude-fable-5/code.mdx b/ja/development/comfy-router/models/anthropic/claude-fable-5/code.mdx index fc44f9f36f..71547b66d2 100644 --- a/ja/development/comfy-router/models/anthropic/claude-fable-5/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-fable-5/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Claude Fable 5 を使う" description: "Comfy Router 経由で anthropic/claude-fable-5 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Fable 5" -translationSourceHash: 2b085858 +translationSourceHash: fac73389 translationFrom: development/comfy-router/models/anthropic/claude-fable-5/code.mdx translationBlockHashes: "_intro": 5f3f65cf "Quick start": bffec245 - "Schema": 15962b1f + "Schema": fb6e12b6 "Examples": d4496b58 --- + {/* 生成済みファイル。`pnpm code-pages:gen` によって router-schemas/anthropic/claude-fable-5.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5/requests/$REQUEST_ - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は作用しません。Router はディスパッチの前にこれを `false` に確定させ、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 のルート `POST /proxy/anthropic/v1/messages` では、`true` を指定するとレスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` に false を指定するか省略してください。`/proxy/` オペレーションの 200 における `text/event-stream` の部分には、Router 側の対応物がありません。 diff --git a/ja/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx b/ja/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx index 2aeee37eae..42e3f82deb 100644 --- a/ja/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Claude Haiku 4.5 20251001 を使用する" description: "Comfy Router 経由で anthropic/claude-haiku-4-5-20251001 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Haiku 4.5 20251001" -translationSourceHash: dd8d78f3 +translationSourceHash: eb49608c translationFrom: development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx translationBlockHashes: "_intro": bf2f46fc "Quick start": 5526f5fd - "Schema": 9679eecf + "Schema": 1e6040f8 "Examples": 18cca7af --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-haiku-4-5-20251001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-haiku-4-5-20251001/request - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効(INERT)です。Router はディスパッチ前にこれを `false` に確定し、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` を指定すると、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` に false を指定するか、省略してください。`/proxy/` オペレーションの 200 応答のうち `text/event-stream` の部分には、Router に対応するものがありません。 @@ -268,7 +269,7 @@ Router が `GET /v2/models/anthropic/claude-haiku-4-5-20251001/openapi.json` で - ブロックの種類。`text` が `text` を持つ唯一のものであり、`thinking`、`redacted_thinking`、`tool_use`、`server_tool_use`、およびツール結果ブロックが、現在 Anthropic が送信するその他の種類であり、このリストは拡張されます。 + ブロックの種類。`text` が `text` を持つ唯一のものであり、`thinking`、`redacted_thinking`、`tool_use`、`server_tool_use`、およびツール結果ブロックが、現在 Anthropic が送信するその他の種類です。このリストは今後拡張される可能性があります。 ## 例 diff --git a/ja/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx b/ja/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx index ebe62c52ac..8ab9fc1b2e 100644 --- a/ja/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Claude Opus 4.6 を使う" description: "Comfy Router 経由で anthropic/claude-opus-4-6 を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Opus 4.6" -translationSourceHash: 93ccca91 +translationSourceHash: cb5d7e2f translationFrom: development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx translationBlockHashes: "_intro": a1da9d27 "Quick start": 642b5091 - "Schema": d3b6797e + "Schema": c13974e1 "Examples": 2cc5500c --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/anthropic/claude-opus-4-6.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-6/requests/$REQUEST - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic メッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効(INERT)です。Router はディスパッチ前にこれを `false` に確定(SETTLE)し、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` にするとレスポンスは単一の JSON ボディではなく、Anthropic メッセージイベントの `text/event-stream` になります。Router では `stream` に false を送るか省略してください。`/proxy/` オペレーションの 200 のうち `text/event-stream` の部分には、Router に対応するものがありません。 diff --git a/ja/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx b/ja/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx index 77c78115dd..1234bc7754 100644 --- a/ja/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Claude Opus 4.7 を使用する" description: "Comfy Router 経由で anthropic/claude-opus-4-7 を呼び出します: endpoint、リクエスト形状、Router が返すレスポンスについて。" sidebarTitle: "Claude Opus 4.7" -translationSourceHash: 274ad2a2 +translationSourceHash: 75f77626 translationFrom: development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx translationBlockHashes: "_intro": 9c9cb89b "Quick start": 8bed0f96 - "Schema": 69d553ae + "Schema": 64cc6da3 "Examples": 8eadda7c --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-4-7.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-7/requests/$REQUEST - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効(INERT)です。Router はディスパッチ前にこれを `false` に確定させ、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` を指定すると、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` に false を指定するか省略してください。`/proxy/` オペレーションの 200 レスポンスのうち `text/event-stream` 側に対応するものは Router にはありません。 diff --git a/ja/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx b/ja/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx index 24826132ed..a6a0a1d562 100644 --- a/ja/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Claude Opus 4.8 を使用する" description: "Comfy Router 経由で anthropic/claude-opus-4-8 を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Opus 4.8" -translationSourceHash: aef515bf +translationSourceHash: 4aae8e49 translationFrom: development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx translationBlockHashes: "_intro": 74fdd245 "Quick start": 874f5aef - "Schema": 0519e19d + "Schema": f74f93ff "Examples": 07251ae9 --- + {/* GENERATED FILE. router-schemas/anthropic/claude-opus-4-8.json から `pnpm code-pages:gen` により生成されたファイルです。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-8/requests/$REQUEST - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効(INERT)です。Router はディスパッチ前にこれを `false` に確定し、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` にするとレスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` に `false` を送るか省略してください。`/proxy/` オペレーションの 200 のうち `text/event-stream` 側には、Router に対応するものがありません。 diff --git a/ja/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx b/ja/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx index 0faa96b2c7..a90ee1ca42 100644 --- a/ja/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router で Claude Opus 5.5 を使う" description: "Comfy Router 経由で anthropic/claude-opus-5-5 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて。" sidebarTitle: "Claude Opus 5.5" -translationSourceHash: 84c96ea2 +translationSourceHash: 9b019780 translationFrom: development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx translationBlockHashes: "_intro": ae2af968 "Quick start": c6539c4b - "Schema": 3c0dd311 + "Schema": 1dca9f7c "Examples": fd6d9b8d --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/anthropic/claude-opus-5-5.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -190,14 +191,14 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5-5/requests/$REQUEST - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効(INERT)です。Router はディスパッチ前に `stream` を `false` に確定し、常に完了したメッセージを単一の JSON ドキュメントとして返します。v1 のルート `POST /proxy/anthropic/v1/messages` では、`true` を指定すると、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` に false を指定するか、省略してください。`/proxy/` オペレーションの 200 のうち `text/event-stream` の部分には、Router 側に対応するものがありません。 トップレベルのシステムプロンプト。文字列またはコンテンツブロックの配列のいずれかで、どちらもそのまま Anthropic に渡されます。 -`GET /v2/models/anthropic/claude-opus-5-5/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 +Router が `GET /v2/models/anthropic/claude-opus-5-5/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 diff --git a/ja/development/comfy-router/models/anthropic/claude-opus-5/code.mdx b/ja/development/comfy-router/models/anthropic/claude-opus-5/code.mdx index 1a67c4564d..03c87fc062 100644 --- a/ja/development/comfy-router/models/anthropic/claude-opus-5/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-opus-5/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Claude Opus 5 を使用する" description: "Comfy Router 経由で anthropic/claude-opus-5 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Opus 5" -translationSourceHash: d5eb64ff +translationSourceHash: 3c1df63d translationFrom: development/comfy-router/models/anthropic/claude-opus-5/code.mdx translationBlockHashes: "_intro": 8a45f373 "Quick start": 2f41262e - "Schema": 8006be48 + "Schema": eabb47c6 "Examples": 6926a739 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/anthropic/claude-opus-5.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5/requests/$REQUEST_I - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は INERT(無効)です。Router はディスパッチ前にこれを `false` に確定させ、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` にするとレスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` に false を送るか、省略してください。`/proxy/` オペレーションの 200 のうち `text/event-stream` の部分に対応する Router の挙動はありません。 diff --git a/ja/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx b/ja/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx index 4eba1c167e..3016d0819f 100644 --- a/ja/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx @@ -2,16 +2,17 @@ title: "Claude Sonnet 4.5 20250929 を Comfy Router で使用する" description: "Comfy Router 経由で anthropic/claude-sonnet-4-5-20250929 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Sonnet 4.5 20250929" -translationSourceHash: af2be0cb +translationSourceHash: f146cae8 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx translationBlockHashes: "_intro": e5d80e67 "Quick start": c93ab6db - "Schema": c0b4e9c3 + "Schema": 14769c2e "Examples": 78b06084 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-4-5-20250929.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-5-20250929/reques - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効です。Router はディスパッチ前に `false` に確定させ、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` にするとレスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` を false で送信するか、省略してください。`/proxy/` オペレーションの 200 のうち `text/event-stream` の側面には、Router に対応するものがありません。 diff --git a/ja/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx b/ja/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx index 88c0bde7eb..e919718b84 100644 --- a/ja/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx @@ -2,16 +2,17 @@ title: "Claude Sonnet 4.6 を Comfy Router で使用する" description: "Comfy Router 経由で anthropic/claude-sonnet-4-6 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Sonnet 4.6" -translationSourceHash: 9d3bf586 +translationSourceHash: 51c4d648 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx translationBlockHashes: "_intro": e6f03e00 "Quick start": c2210e0e - "Schema": 7e4df7aa + "Schema": 9c28d0e8 "Examples": 7fb5285d --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-4-6.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-6/requests/$REQUE - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効です。Router はディスパッチ前にこれを `false` に確定し、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` を指定すると、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` に false を指定するか省略してください。`/proxy/` オペレーションの 200 における `text/event-stream` 側には、Router に対応するものがありません。 diff --git a/ja/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx b/ja/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx index d6107524df..a05225963e 100644 --- a/ja/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Claude Sonnet 5 を使う" description: "Comfy Router 経由で anthropic/claude-sonnet-5 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Sonnet 5" -translationSourceHash: a4550d3d +translationSourceHash: 6752140c translationFrom: development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx translationBlockHashes: "_intro": 9027b350 "Quick start": 23b1d5d3 - "Schema": ed894fd9 + "Schema": a6d8a431 "Examples": a3ab5037 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/anthropic/claude-sonnet-5.json から生成。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-5/requests/$REQUEST - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効(INERT)です。Router はディスパッチ前にこれを `false` に確定させ、常に完了したメッセージを 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` にするとレスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` を false にするか省略してください。`/proxy/` オペレーションの 200 レスポンスのうち `text/event-stream` の部分には、Router 側に対応するものがありません。 diff --git a/ja/development/comfy-router/models/krea/krea-3/code.mdx b/ja/development/comfy-router/models/krea/krea-3/code.mdx index 8dde36b401..a4d30258d7 100644 --- a/ja/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router で Krea 3 を使用する" description: "Comfy Router 経由で krea/krea-3 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Krea 3" -translationSourceHash: eee80c65 +translationSourceHash: cd728587 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": dbedda04 + "Schema": 7aa8390e "Examples": 276619d9 --- - {/* 生成済みファイル。router-schemas/krea/krea-3.json から `pnpm code-pages:gen` で生成済み。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -153,15 +152,15 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ ### 入力 - 1:1、4:5、3:4、2:3、9:16、5:4、4:3、3:2、16:9、21:9。resolution と併用します。省略すると自動でフレーミングされます。 + 1:1、4:5、3:4、2:3、9:16、5:4、4:3、3:2、16:9 または 21:9。解像度と併用します。自動フレーミングの場合は省略します。 - 入力画像の URL。最大8件。画像を POST /proxy/krea/assets にアップロードして返される image_url(multipart フォームのフィールド `file`)は常に受け入れられます。他のパブリックな https URL が受け入れられるかどうかは環境によって異なります。受け入れられない環境では、ホスト app-uploads.krea.ai 上の https URL ではないリンクは 400 で拒否されます。受け入れられる環境では、パブリックな https の画像 URL はすべて受け入れられ、形式が不正な URL や https ではない URL は 400 で拒否されます(ポートが数値であっても範囲外である URL はこのチェックでは捕捉されず、代わりに 502 で失敗する可能性があります)。その場合の正しい形式の https URL については、呼び出し側が修正できる参照は、そのホスト名を示して 400 で拒否されます。すなわち、フェッチ前のチェック時にホストが解決できない、または公開到達可能でない、許可された回数を超えてリダイレクトする、https ではない URL や公開到達可能でないホストへリダイレクトする、408 または 429 以外の 4xx を返す、画像ではない、読み取れない形式の画像である、画像サイズヘッダーが最初の 2 MiB 内にない、または宣言された長さも chunked エンコーディングもないレスポンスが画像サイズヘッダーより前に終了する、といった場合です。それ以外のフェッチ失敗は POST /proxy/krea で 502 エラーになります(Comfy Router はこれを 500 internal_error で返します)。一時的な DNS、TLS、接続の失敗、タイムアウト、オリジンからの 408、429、5xx その他の非 200 ステータス、またはそのチェックを通過したもののフェッチの接続時に解決できない、もしくは公開到達可能でないホストです。他の URL が受け入れられない環境では、実際のアップロードではない app-uploads.krea.ai のリンクは 5xx エラーで失敗します。受け入れられる環境では、他の到達不能な参照と同様に 400 で拒否されます。サーバーがどちらに該当するかをまだ学習していない間は、app-uploads.krea.ai のリンクではないホストを持つ https URL は、公開かどうかに関わらず、再試行しても安全な 503 エラーで失敗します。テキストから画像への生成では省略します。 + 入力画像URL。最大8件。8件を超えるエントリは取得前に拒否されます(/proxy/krea では 400、Comfy Router のスキーマチェックは先に 422 を返します)。画像を POST /proxy/krea/assets にアップロードした際に返される image_url(multipart フォームフィールド `file`)は常に受け入れられます。他の公開 https URL が受け入れられるかどうかは環境によって異なります。受け入れられない環境では、ホスト app-uploads.krea.ai 上の https URL ではないリンクはすべて、'image_urls must be image_url values returned by POST /proxy/krea/assets' という 400 で拒否されるため、代わりに画像をアップロードしてください。受け入れられる環境では、公開 https 画像 URL はすべて受け入れられ、不正な形式または https でない URL は 400 で拒否されます(ポートが数値だが範囲外の URL はこのチェックでは捕捉されず、代わりに 502 で失敗する可能性があります)。その場合、整形式の https URL については、呼び出し側が修正できる参照はそのホスト名を示す 400 で拒否されます。取得前のチェック時にそのホストが解決できない、または公開的に到達できない場合、許可された回数を超えてリダイレクトする場合、https でない URL へ、または公開的に到達できないホストへリダイレクトする場合、408 または 429 以外の 4xx を返す場合、画像でない場合、読み取れない形式の画像である場合、画像サイズヘッダーが先頭 2 MiB 以内にない場合、または長さが宣言されていない、もしくは chunked エンコーディングのレスポンスが画像サイズヘッダーより前に終了する場合です。それ以外の取得時の失敗は POST /proxy/krea で 502 エラーになります(Comfy Router は 500 internal_error で応答します)。一時的な DNS、TLS、接続の失敗、タイムアウト、オリジンからの 408、429、5xx その他の非 200 ステータス、またはそのチェックを通過したものの取得時の接続で解決できない、もしくは公開的に到達できないホストです。これらの一部は再試行で解消します(リゾルバエラー、タイムアウト、切断された接続、5xx、408、429 を返すオリジン、またはホストチェックと接続の間に DNS 応答が非公開アドレスに切り替わったホストで、再試行時に成功するか、非公開ホストとして 400 になる場合があります)。一方、毎回同じように失敗するものもあります。たとえば、取得が信頼しない TLS 証明書(自己署名、期限切れ、ホスト名の不一致)、または 200 以外の 2xx や取得が追従しない 3xx(204、206、300、304、305、あるいは Location のない 301、302、303、307、308 など)を返すオリジンです。そのため、再試行しても同じように失敗する場合は、代わりに画像をアップロードしてください。Comfy Router 経由でキューに入ったリクエストは、image_urls のいずれかが app-uploads.krea.ai のリンクでない場合、そのような失敗を再試行しないため、原因が解消しうる場合はご自身で再送信してください。他の URL が受け入れられない環境では、実際のアップロードではない app-uploads.krea.ai のリンクは 5xx エラーで失敗します。受け入れられる環境では、他の到達不能な参照と同様に 400 で拒否されます。サーバーがどちらに該当するかをまだ認識していない間は、app-uploads.krea.ai のリンクではないホストを持つ https URL は、公開かどうかに関わらず、再試行しても安全な 503 エラーで失敗します(キューのリクエストはそれに対して自動的に再試行されます)。キューのリクエストの 400 には汎用の invalid_input の詳細のみが含まれるため、ホストも上記の文言も示されず、キューはそれを再試行しません。キューの 400 は image_urls だけでなく任意のフィールド(たとえば未対応の解像度や thinking_mode)に起因する可能性があるため、まず他のフィールドを確認してください。それらが有効であれば、各画像を POST /proxy/krea/assets にアップロードし、その image_url の値と新しい Idempotency-Key(またはなし)で再送信してください。ボディを変更してキーを再利用すると 409 invalid_input で拒否され、これは画像について何も示しません。同じボディで再利用すると、元の request_id と Idempotent-Replayed: true を伴う 201 が返るため、新しい実行は開始されず、その結果 URL は同じ 400 を返します(ステータス URL は error_type invalid_input を伴う 200 を返します)。他の公開 https URL が受け入れられる環境で、その再送信も 400 で失敗する場合、問題は画像自体にあります(たとえば、サポートされていない画像である、または画像サイズヘッダーが先頭 2 MiB 以内にない)。受け入れられない環境では、同じアップロード済み画像はその 400 ではなく 5xx(Comfy Router では 500 internal_error)で失敗し、やはり問題は画像にあるため、再度アップロードしても解決しません。各画像のサイズを見つけるために読み取られるのは先頭 2 MiB のみであるため、そのウィンドウ内でサイズ情報を読み取れない画像(たとえば 2 MiB を超える埋め込みメタデータを持つ JPEG、または透過データが、なければ最初の画像データチャンクの開始位置が、2 MiB を超えたところにあるパレット PNG で、たとえば 2 MiB を超えるテキストや色プロフィールのチャンクの後にあるもの)は、アップロード済みかどうかに関わらず、画像サイズヘッダーが先頭 2 MiB 以内にないという 400 で拒否されます。大きなメタデータを除いて再保存するか、パレット PNG を非パレット PNG として保存してください。国際化ホストは ASCII(punycode)形式で送信してください。非 ASCII のホスト名は存在しないものとして拒否されます。テキストから画像への生成では省略します。 - berry(デフォルト、品質重視)または jam(高速)。 + berry(デフォルト、品質)または jam(速度)。 @@ -169,11 +168,11 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 生成する内容。image_urls と併用する場合は編集指示となり、何を変更し、何を維持するかを記述します。 + 生成する内容。image_urls を指定する場合は編集指示で、何を変更し、何を同じまま保つべきかを記述します。 - 画像の残りの部分を保持するローカル編集を行う場合は true に設定します。model に berry、image_urls に少なくとも1つの画像が必要です。 + 画像の残りの部分を保つローカル編集の場合は true に設定します。model berry と image_urls に少なくとも1つの画像が必要です。 @@ -185,10 +184,10 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - fast(デフォルト)、high、ultra。high と ultra は複雑な編集をより詳細に計画するため、時間がかかります。ultra には resolution 2k が必要です。 + fast(デフォルト)、high または ultra。high と ultra は複雑な編集をより詳細に計画し、時間がかかります。ultra には解像度 2k が必要です。 -Router が `GET /v2/models/krea/krea-3/openapi.json` で提供するスキーマから生成されています。これはリクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 +Router が `GET /v2/models/krea/krea-3/openapi.json` で提供するスキーマから生成済みです。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 @@ -201,15 +200,15 @@ Router が `GET /v2/models/krea/krea-3/openapi.json` で提供するスキーマ - status が failed の場合にのみ設定されます。キャンセル済みのジョブには含まれません。 + status が failed の場合にのみ設定されます。キャンセル済みのジョブには付与されません。 - ジョブが失敗した理由: content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal、node_app_node_failed。不明なコードは internal として扱ってください。 + ジョブが失敗した理由: content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal、または node_app_node_failed。不明なコードは internal として扱ってください。 - 任意。provider_error および internal の場合におけるプロバイダーの自由形式のテキスト。 + 任意。provider_error および internal の場合にプロバイダーが返す自由形式のテキストです。 @@ -221,21 +220,21 @@ Router が `GET /v2/models/krea/krea-3/openapi.json` で提供するスキーマ - 完了した生成結果。`KreaJob` と異なり、ここでは null を許容しません。`result` に `urls` が含まれないターミナルジョブは Comfy Router のエラーとして返されるため、`200` には常に含まれます。 + 完了した生成結果。`KreaJob` と異なり、ここでは null 許容ではありません。`result` に `urls` が含まれないターミナル状態のジョブは Comfy Router のエラーとして返されるため、`200` には必ず `urls` が含まれます。 - 生成ではなく loraTraining ジョブによって設定されます。これらのモデルの `200` には `urls` が含まれます。 + 生成ではなく loraTraining ジョブによって設定されます。これらのモデルに対する `200` には `urls` が含まれます。 - 生成された画像。ダウンロード可能なリンクとして提供されます。`urls` が空の `completed` ジョブは `success_without_output` となり、このドキュメントには到達しないため、少なくとも1つ含まれます。 + 生成済み画像へのダウンロード可能なリンク。`urls` が空の `completed` ジョブは `success_without_output` となり、このドキュメントには到達しないため、少なくとも1つ含まれます。 - このドキュメントでは常に `completed` です。Router が成功として報告する唯一のステータスであり、Krea の語彙は大文字小文字の変換なしで照合されます。 + このドキュメントでは常に `completed` です。Router が成功として報告する唯一のステータスであり、Krea の語彙は大文字と小文字を区別せずに照合されます。 - 指定可能な値: `completed` + 取り得る値: `completed` ## 例 diff --git a/ja/development/comfy-router/providers.mdx b/ja/development/comfy-router/providers.mdx index 64359fced0..9c12fdffbc 100644 --- a/ja/development/comfy-router/providers.mdx +++ b/ja/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の配信プロバイダー" sidebarTitle: "配信プロバイダー" description: "各 Comfy Router モデルを配信できるプロバイダーと、代替プロバイダーを選択する方法を確認できます。" -translationSourceHash: 2e5f5f1e +translationSourceHash: 26a39d7a translationFrom: development/comfy-router/providers.mdx --- @@ -14,20 +14,21 @@ translationFrom: development/comfy-router/providers.mdx ## プロバイダー別の対応状況 -| モデル / プロバイダー | **Comfy(デフォルト)** | **fal** | **Higgsfield** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | -| --- | --- | --- | --- | --- | --- | --- | --- | --- | -| [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | -| [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | -| [Gemini 2.5 Flash Image](/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | ✓ | - | - | - | - | -| [Gemini Nano Banana 2.1](/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | ✓ | - | - | - | - | -| [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | -| [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | -| [Kling 3.0 Turbo](/ja/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | -| [Kling V3](/ja/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | ✓* | - | -| [Nano Banana 2](/ja/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [Nano Banana Pro](/ja/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [Wan 3.0 Video](/ja/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | +| モデル / プロバイダー | **Comfy(デフォルト)** | **fal** | **Higgsfield** | **Kelly** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | +| [Dreamina Seedance 2.0 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | +| [Dreamina Seedance 2.0 Fast 260128](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code) | ✓ | - | - | ✓ | - | - | - | - | - | +| [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | +| [Gemini 2.5 Flash Image](/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [Gemini Nano Banana 2.1](/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [Kling 3.0 Turbo](/ja/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | - | +| [Kling V3](/ja/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | - | ✓* | - | +| [Nano Banana 2](/ja/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [Nano Banana Pro](/ja/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [Wan 3.0 Video](/ja/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | - | \* このプロバイダーは、デフォルトよりも狭い制限でモデルを配信します。モデルページを参照してください。 diff --git a/ko/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx b/ko/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx index 744e046311..62c8c8ec03 100644 --- a/ko/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router에서 Claude Fable 5.1 사용하기" description: "Comfy Router를 통해 anthropic/claude-fable-5-1을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Claude Fable 5.1" -translationSourceHash: 0c17cbf0 +translationSourceHash: 72432b96 translationFrom: development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx translationBlockHashes: "_intro": d52eb513 "Quick start": 66ea5c23 - "Schema": d2c6492b + "Schema": 9180e71b "Examples": e6e3e477 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-fable-5-1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5-1/requests/$REQUES - true이면 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 라우트 `POST /v2/models/anthropic/{model}`에서 `stream`은 아무 효과가 없습니다(INERT). Router는 디스패치 이전에 이 값을 `false`로 확정하며, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 라우트에서는 `true`이면 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 쪽에 해당하는 Router 동작은 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-fable-5/code.mdx b/ko/development/comfy-router/models/anthropic/claude-fable-5/code.mdx index 0bb45a2c25..65cf5a684b 100644 --- a/ko/development/comfy-router/models/anthropic/claude-fable-5/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-fable-5/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Claude Fable 5 사용하기" description: "Comfy Router를 통해 anthropic/claude-fable-5를 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Claude Fable 5" -translationSourceHash: 2b085858 +translationSourceHash: fac73389 translationFrom: development/comfy-router/models/anthropic/claude-fable-5/code.mdx translationBlockHashes: "_intro": 5f3f65cf "Quick start": bffec245 - "Schema": 15962b1f + "Schema": fb6e12b6 "Examples": d4496b58 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-fable-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5/requests/$REQUEST_ - true이면 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효(INERT)입니다. Router는 디스패치 이전에 이를 `false`로 확정하며, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 경로에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 동작이 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx b/ko/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx index f6f25344a1..fcf613bd0a 100644 --- a/ko/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Claude Haiku 4.5 20251001 사용하기" description: "Comfy Router를 통해 anthropic/claude-haiku-4-5-20251001을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Claude Haiku 4.5 20251001" -translationSourceHash: dd8d78f3 +translationSourceHash: eb49608c translationFrom: development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx translationBlockHashes: "_intro": bf2f46fc "Quick start": 5526f5fd - "Schema": 9679eecf + "Schema": 1e6040f8 "Examples": 18cca7af --- + {/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/anthropic/claude-haiku-4-5-20251001.json에서 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-haiku-4-5-20251001/request - 참일 때 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 라우트 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효(INERT)입니다. Router는 디스패치 이전에 이를 `false`로 확정하며 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 라우트에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 것이 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx b/ko/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx index 1a18a5c3fa..1ff82b347c 100644 --- a/ko/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router와 함께 Claude Opus 4.6 사용하기" description: "Comfy Router를 통해 anthropic/claude-opus-4-6 호출하기: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Claude Opus 4.6" -translationSourceHash: 93ccca91 +translationSourceHash: cb5d7e2f translationFrom: development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx translationBlockHashes: "_intro": a1da9d27 "Quick start": 642b5091 - "Schema": d3b6797e + "Schema": c13974e1 "Examples": 2cc5500c --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/anthropic/claude-opus-4-6.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-6/requests/$REQUEST - 참일 때 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효입니다. Router는 디스패치 이전에 이를 `false`로 확정하고, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 경로에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 동작이 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx b/ko/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx index 7c33d4fc36..eda1c34391 100644 --- a/ko/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router와 함께 Claude Opus 4.7 사용하기" description: "Comfy Router를 통해 anthropic/claude-opus-4-7을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Claude Opus 4.7" -translationSourceHash: 274ad2a2 +translationSourceHash: 75f77626 translationFrom: development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx translationBlockHashes: "_intro": 9c9cb89b "Quick start": 8bed0f96 - "Schema": 69d553ae + "Schema": 64cc6da3 "Examples": 8eadda7c --- + {/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/anthropic/claude-opus-4-7.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-7/requests/$REQUEST - true이면 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트로 이루어진 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효(INERT)입니다. Router는 디스패치 이전에 이를 `false`로 확정(SETTLES)하며 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 경로에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트로 이루어진 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 것이 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx b/ko/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx index 5fccd33ab2..74fbc0fbfc 100644 --- a/ko/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router에서 Claude Opus 4.8 사용하기" description: "Comfy Router를 통해 anthropic/claude-opus-4-8을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Claude Opus 4.8" -translationSourceHash: aef515bf +translationSourceHash: 4aae8e49 translationFrom: development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx translationBlockHashes: "_intro": 74fdd245 "Quick start": 874f5aef - "Schema": 0519e19d + "Schema": f74f93ff "Examples": 07251ae9 --- + {/* 생성된 파일. router-schemas/anthropic/claude-opus-4-8.json에서 `pnpm code-pages:gen`으로 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-8/requests/$REQUEST - true이면 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효(INERT)입니다. Router는 디스패치 이전에 이 값을 `false`로 확정(SETTLES)하며, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 경로에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 쪽에는 Router에 대응하는 동작이 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx b/ko/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx index 59772dc27f..b8d523a839 100644 --- a/ko/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router에서 Claude Opus 5.5 사용하기" description: "Comfy Router를 통해 anthropic/claude-opus-5-5를 호출하는 방법: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Claude Opus 5.5" -translationSourceHash: 84c96ea2 +translationSourceHash: 9b019780 translationFrom: development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx translationBlockHashes: "_intro": ae2af968 "Quick start": c6539c4b - "Schema": 3c0dd311 + "Schema": 1dca9f7c "Examples": fd6d9b8d --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/anthropic/claude-opus-5-5.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5-5/requests/$REQUEST - true이면 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효(INERT)입니다. Router는 디스패치 이전에 이를 `false`로 확정하며, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 경로에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`에 false를 보내거나 생략하세요. `/proxy/` 작업 200 응답의 `text/event-stream` 부분에는 Router에 대응하는 항목이 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-opus-5/code.mdx b/ko/development/comfy-router/models/anthropic/claude-opus-5/code.mdx index 696cc11fee..10250d4565 100644 --- a/ko/development/comfy-router/models/anthropic/claude-opus-5/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-opus-5/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Claude Opus 5 사용하기" description: "Comfy Router를 통해 anthropic/claude-opus-5를 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답." sidebarTitle: "Claude Opus 5" -translationSourceHash: d5eb64ff +translationSourceHash: 3c1df63d translationFrom: development/comfy-router/models/anthropic/claude-opus-5/code.mdx translationBlockHashes: "_intro": 8a45f373 "Quick start": 2f41262e - "Schema": 8006be48 + "Schema": eabb47c6 "Examples": 6926a739 --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/anthropic/claude-opus-5.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5/requests/$REQUEST_I - true이면 응답은 단일 JSON 본문이 아니라 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효(INERT)입니다. Router는 디스패치 이전에 이 값을 `false`로 확정하며, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 경로 `POST /proxy/anthropic/v1/messages`에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 동작이 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx b/ko/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx index 4213388e83..d836637b2c 100644 --- a/ko/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Claude Sonnet 4.5 20250929 사용하기" description: "Comfy Router를 통해 anthropic/claude-sonnet-4-5-20250929를 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Claude Sonnet 4.5 20250929" -translationSourceHash: af2be0cb +translationSourceHash: f146cae8 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx translationBlockHashes: "_intro": e5d80e67 "Quick start": c93ab6db - "Schema": c0b4e9c3 + "Schema": 14769c2e "Examples": 78b06084 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/anthropic/claude-sonnet-4-5-20250929.json에서 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-5-20250929/reques - 참일 때 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효(INERT)입니다. Router는 디스패치 이전에 이를 `false`로 확정(SETTLES)하며, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 경로에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 동작이 없습니다. diff --git a/ko/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx b/ko/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx index 581536b779..79ac599a8a 100644 --- a/ko/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Claude Sonnet 4.6 사용하기" description: "Comfy Router를 통해 anthropic/claude-sonnet-4-6을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Claude Sonnet 4.6" -translationSourceHash: 9d3bf586 +translationSourceHash: 51c4d648 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx translationBlockHashes: "_intro": e6f03e00 "Quick start": c2210e0e - "Schema": 7e4df7aa + "Schema": 9c28d0e8 "Examples": 7fb5285d --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/anthropic/claude-sonnet-4-6.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-6/requests/$REQUE - true이면 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 무효(INERT)입니다. Router는 디스패치 이전에 이를 `false`로 확정하고 완료된 메시지를 항상 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 경로에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업의 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 동작이 없습니다. @@ -268,7 +269,7 @@ Router가 `GET /v2/models/anthropic/claude-sonnet-4-6/openapi.json`에서 제공 - 블록의 종류입니다. `text`는 `text`를 담는 유일한 블록이며, `thinking`, `redacted_thinking`, `tool_use`, `server_tool_use` 및 도구 결과 블록은 오늘날 Anthropic이 전송하는 다른 종류들이고, 이 목록은 열려 있습니다. + 블록의 종류입니다. `text`는 `text`를 담는 유일한 블록이며, `thinking`, `redacted_thinking`, `tool_use`, `server_tool_use` 및 도구 결과 블록은 현재 Anthropic이 전송하는 다른 종류들이고, 이 목록은 열려 있습니다. ## 예시 diff --git a/ko/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx b/ko/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx index 3ae40137d4..33a16b71dd 100644 --- a/ko/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router에서 Claude Sonnet 5 사용하기" description: "Comfy Router를 통해 anthropic/claude-sonnet-5를 호출합니다. 엔드포인트, 요청 형태, Router가 반환하는 응답을 다룹니다." sidebarTitle: "Claude Sonnet 5" -translationSourceHash: a4550d3d +translationSourceHash: 6752140c translationFrom: development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx translationBlockHashes: "_intro": 9027b350 "Quick start": 23b1d5d3 - "Schema": ed894fd9 + "Schema": a6d8a431 "Examples": a3ab5037 --- + {/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/anthropic/claude-sonnet-5.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-5/requests/$REQUEST - true인 경우, 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 아무런 효력이 없습니다(INERT). Router는 디스패치 이전에 이를 `false`로 확정하며, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 경로 `POST /proxy/anthropic/v1/messages`에서는 `true`일 때 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`을 false로 보내거나 생략하세요. `/proxy/` 작업이 반환하는 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 동작이 없습니다. diff --git a/ko/development/comfy-router/models/krea/krea-3/code.mdx b/ko/development/comfy-router/models/krea/krea-3/code.mdx index 1d5bb320a2..af6296c8f4 100644 --- a/ko/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router로 Krea 3 사용하기" description: "Comfy Router를 통해 krea/krea-3를 호출하는 방법: 엔드포인트, 요청 형태 및 Router가 반환하는 응답입니다." sidebarTitle: "Krea 3" -translationSourceHash: eee80c65 +translationSourceHash: cd728587 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": dbedda04 + "Schema": 7aa8390e "Examples": 276619d9 --- - {/* GENERATED FILE. Generated from router-schemas/krea/krea-3.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -153,11 +152,11 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ ### 입력 - 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9 또는 21:9. 해상도와 함께 사용합니다. 자동 프레이밍을 원하면 생략합니다. + 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9 또는 21:9. resolution과 함께 사용하며, 자동 구도를 원하면 생략합니다. - 입력 이미지 URL이며 최대 8개입니다. 이미지를 POST /proxy/krea/assets에 업로드하여 반환된 image_url(multipart form 필드 `file`)은 항상 허용됩니다. 다른 공개 https URL이 허용되는지는 환경에 따라 다릅니다. 허용되지 않는 환경에서는 호스트 app-uploads.krea.ai의 https URL이 아닌 링크는 400으로 거부됩니다. 허용되는 환경에서는 공개 https 이미지 URL이면 허용되며, 형식이 잘못되었거나 https가 아닌 URL은 400으로 거부됩니다(포트가 숫자이지만 범위를 벗어난 URL은 이 검사에서 잡히지 않고 대신 502로 실패할 수 있습니다). 허용되는 환경에서 형식이 올바른 https URL의 경우, 호출자가 고칠 수 있는 참조는 해당 호스트를 명시하며 400으로 거부됩니다. 가져오기 전에 확인했을 때 호스트가 확인되지 않거나 공개적으로 접근할 수 없는 경우, 허용된 횟수를 초과하여 리다이렉트하는 경우, https가 아닌 URL이나 공개적으로 접근할 수 없는 호스트로 리다이렉트하는 경우, 408 또는 429가 아닌 4xx를 반환하는 경우, 이미지가 아닌 경우, 읽을 수 없는 형식의 이미지인 경우, 이미지 크기 헤더가 처음 2 MiB 안에 없는 경우, 또는 선언된 길이가 없거나 청크 인코딩된 응답이 이미지 크기 헤더 전에 끝나는 경우입니다. 가져오는 중 그 밖의 실패는 POST /proxy/krea에서 502 오류로 실패합니다(Comfy Router는 이에 500 internal_error로 응답합니다). 일시적인 DNS, TLS 또는 연결 실패, 타임아웃, 원본의 408, 429, 5xx 또는 기타 200이 아닌 상태, 또는 해당 검사를 통과했지만 가져오기가 연결할 때 확인되지 않거나 공개적으로 접근할 수 없는 호스트입니다. 다른 URL이 허용되지 않는 환경에서는 실제 업로드가 아닌 app-uploads.krea.ai 링크가 5xx 오류로 실패합니다. 허용되는 환경에서는 접근할 수 없는 다른 참조와 마찬가지로 400으로 거부됩니다. 서버가 아직 어느 쪽이 적용되는지 알지 못하는 동안에는 app-uploads.krea.ai 링크가 아닌 호스트의 모든 https URL은 공개 여부와 관계없이 재시도해도 안전한 503 오류로 실패합니다. 텍스트 기반 이미지 생성 시에는 생략합니다. + 입력 이미지 URL이며, 최대 8개입니다. 8개를 초과하면 가져오기를 시도하기 전에 거부됩니다 (/proxy/krea에서는 400, Comfy Router의 스키마 검사는 먼저 422로 응답합니다). 이미지를 POST /proxy/krea/assets에 업로드하면(multipart 폼 필드 `file`) 반환되는 image_url은 항상 허용됩니다. 다른 공개 https URL이 허용되는지는 환경에 따라 다릅니다. 허용되지 않는 환경에서는 호스트 app-uploads.krea.ai의 https URL이 아닌 모든 링크가 'image_urls must be image_url values returned by POST /proxy/krea/assets'라는 메시지와 함께 400으로 거부되므로, 대신 이미지를 업로드하세요. 허용되는 환경에서는 공개 https 이미지 URL이면 모두 허용되며, 형식이 잘못되었거나 https가 아닌 URL은 400으로 거부됩니다(포트가 숫자이지만 범위를 벗어난 URL은 이 검사에서 잡히지 않고 대신 502로 실패할 수 있습니다). 그 경우 형식이 올바른 https URL에 대해, 호출자가 고칠 수 있는 참조는 해당 호스트를 명시하며 400으로 거부됩니다. 가져오기 전 검사에서 호스트가 확인되지 않거나 공개적으로 접근할 수 없는 경우, 허용된 횟수보다 많이 리디렉션하는 경우, https가 아닌 URL이나 공개적으로 접근할 수 없는 호스트로 리디렉션하는 경우, 408 또는 429가 아닌 4xx를 반환하는 경우, 이미지가 아닌 경우, 읽을 수 없는 형식의 이미지인 경우, 이미지 크기 헤더가 처음 2 MiB 안에 없는 경우, 또는 선언된 길이가 없거나 청크 인코딩된 응답이 이미지 크기 헤더 전에 끝나는 경우입니다. 그 밖의 가져오기 실패는 POST /proxy/krea에서 502 오류로 실패합니다(Comfy Router는 이를 500 internal_error로 응답합니다). 일시적인 DNS, TLS 또는 연결 실패, 타임아웃, 원본 서버의 408, 429, 5xx 또는 200이 아닌 기타 상태, 또는 해당 검사를 통과했지만 가져오기가 연결할 때 확인되지 않거나 공개적으로 접근할 수 없는 호스트가 여기에 해당합니다. 이 중 일부는 재시도하면 해소됩니다(리졸버 오류, 타임아웃, 끊긴 연결, 5xx, 408 또는 429를 반환하는 원본 서버, 또는 호스트 검사와 연결 사이에 DNS 응답이 비공개 주소로 바뀌는 호스트로, 재시도하면 성공하거나 비공개 호스트에 대한 400을 받을 수 있습니다). 다른 일부는 매번 같은 방식으로 실패합니다. 예를 들어 가져오기가 신뢰하지 않는 TLS 인증서(자체 서명, 만료 또는 잘못된 호스트 이름)이거나, 원본 서버가 200이 아닌 2xx 또는 가져오기가 따르지 않는 3xx(예: 204, 206, 300, 304, 305 또는 Location이 없는 301, 302, 303, 307, 308)를 반환하는 경우입니다. 따라서 재시도해도 같은 방식으로 실패하면 대신 이미지를 업로드하세요. Comfy Router를 통해 대기 중인 요청은 image_urls 중 하나라도 app-uploads.krea.ai 링크가 아니면 이런 실패를 재시도하지 않으므로, 원인이 해소될 수 있다면 직접 다시 제출하세요. 다른 URL이 허용되지 않는 환경에서 실제 업로드가 아닌 app-uploads.krea.ai 링크는 5xx 오류로 실패합니다. 허용되는 환경에서는 다른 접근 불가 참조와 마찬가지로 400으로 거부됩니다. 서버가 어느 쪽이 적용되는지 아직 파악하지 못한 동안에는 app-uploads.krea.ai 링크가 아닌 호스트를 가진 모든 https URL이 공개 여부와 관계없이 재시도해도 안전한 503 오류로 실패합니다(대기 중인 요청은 이 오류에 대해 자동으로 재시도됩니다). 대기 중인 요청의 400은 일반적인 invalid_input 상세만 담고 있으므로 위에 나온 호스트나 문구를 보여주지 않으며, 실행 대기열은 이를 재시도하지 않습니다. 대기 중인 요청의 400은 image_urls뿐 아니라 모든 필드에서 발생할 수 있으므로(예: 지원되지 않는 resolution 또는 thinking_mode), 다른 필드를 먼저 확인하세요. 다른 필드가 유효하다면 각 이미지를 POST /proxy/krea/assets에 업로드하고 해당 image_url 값과 새 Idempotency-Key(또는 키 없이)로 다시 제출하세요. 본문을 바꾸고 키를 재사용하면 409 invalid_input으로 거부되며, 이는 이미지에 대해 아무것도 알려주지 않습니다. 같은 본문으로 키를 재사용하면 원본 request_id와 Idempotent-Replayed: true와 함께 201로 응답하므로 새 실행을 시작하지 않으며, 그 결과 URL은 동일한 400을 반환합니다(상태 URL은 error_type invalid_input과 함께 200으로 응답합니다). 다른 공개 https URL이 허용되는 환경에서 그 재제출도 400으로 실패하면 이미지 자체가 문제입니다(예: 지원되지 않는 이미지이거나 이미지 크기 헤더가 처음 2 MiB 안에 없음). 허용되지 않는 환경에서는 같은 업로드된 이미지가 그 400 대신 5xx(Comfy Router에서는 500 internal_error)로 실패하며, 여전히 이미지가 문제이므로 다시 업로드해도 도움이 되지 않습니다. 각 이미지의 처음 2 MiB만 읽어 크기를 찾으므로, 그 창 안에서 크기 정보를 읽을 수 없는 이미지(예: 2 MiB가 넘는 내장 메타데이터가 있는 JPEG, 또는 투명도 데이터가, 없으면 첫 이미지 데이터 청크의 시작이 2 MiB를 넘어 위치하는 팔레트 PNG. 예를 들어 2 MiB가 넘는 텍스트 또는 색상 프로필 청크 뒤에 위치)는 업로드 여부와 관계없이 이미지 크기 헤더가 처음 2 MiB 안에 없다는 400으로 거부됩니다. 큰 메타데이터 없이 다시 저장하거나, 팔레트 PNG를 비팔레트 PNG로 저장하세요. 국제화된 호스트는 ASCII(punycode) 형식으로 보내세요. 비ASCII 호스트 이름은 존재하지 않는 것으로 거부됩니다. 텍스트 기반 이미지 생성에서는 생략합니다. @@ -165,15 +164,15 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - + - 생성할 내용입니다. image_urls와 함께 사용할 때는 편집 지시문이며, 무엇을 변경하고 무엇을 그대로 유지해야 하는지 설명합니다. + 생성할 내용입니다. image_urls와 함께 사용하면 편집 지시문이며, 무엇이 바뀌어야 하고 무엇이 그대로여야 하는지 설명하세요. - 이미지의 나머지 부분을 유지하는 국소 편집을 수행하려면 true로 설정합니다. model berry와 image_urls의 이미지 최소 한 개가 필요합니다. + 이미지의 나머지 부분을 유지하는 국소 편집을 하려면 true로 설정합니다. model berry와 image_urls에 최소 한 개의 이미지가 필요합니다. @@ -181,14 +180,13 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - + - fast(기본값), high 또는 ultra. high와 ultra는 복잡한 편집을 더 자세히 계획하며 시간이 더 오래 걸립니다. ultra는 해상도 2k가 필요합니다. + fast(기본값), high 또는 ultra. high와 ultra는 복잡한 편집을 더 자세히 계획하며 시간이 더 오래 걸립니다. ultra는 resolution 2k가 필요합니다. - -`GET /v2/models/krea/krea-3/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/krea/krea-3/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 이전에 호출을 검증하는 기준이 되는 동일한 문서입니다. ### 출력 @@ -201,19 +199,19 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - status가 failed일 때만 설정됩니다. 취소된 작업에는 없습니다. + status가 failed일 때만 설정됩니다. 취소된 작업에는 이 값이 없습니다. - 작업 실패 이유입니다: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal 또는 node_app_node_failed. 알 수 없는 코드는 internal로 처리합니다. + 작업이 실패한 이유입니다: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal 또는 node_app_node_failed. 알 수 없는 코드는 internal로 취급하세요. - 선택 사항입니다. provider_error 및 internal에 대한 공급자의 자유 형식 텍스트입니다. + 선택 사항입니다. provider_error와 internal에 대한 공급자의 자유 형식 텍스트입니다. - 변경해야 할 요청 파라미터로, invalid_request 및 validation_failed와 함께 제공됩니다. + 변경해야 할 요청 파라미터로, invalid_request와 validation_failed에서 함께 제공됩니다. @@ -221,19 +219,19 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 완료된 생성 결과입니다. `KreaJob`과 달리 여기서는 null이 될 수 없습니다. `result`에 `urls`가 없는 터미널 작업은 Comfy Router 오류로 응답되므로, `200` 응답에는 항상 이 필드가 포함됩니다. + 완료된 생성 결과입니다. `KreaJob`과 달리 여기서는 null이 될 수 없습니다: `urls`가 없는 `result`를 가진 터미널 작업은 Comfy Router 오류로 응답되므로, `200` 응답에는 항상 이 값이 포함됩니다. - 생성이 아니라 loraTraining 작업에 의해 설정됩니다. 이 모델들의 `200` 응답에는 `urls`가 포함됩니다. + 생성 작업이 아니라 loraTraining 작업에서 설정됩니다. 이 모델들의 `200` 응답에는 `urls`가 포함됩니다. - 생성된 이미지로, 다운로드 가능한 링크 형태입니다. 최소 한 개 이상인데, `urls`가 비어 있는 `completed` 작업은 `success_without_output`이며 이 문서에 도달하지 않기 때문입니다. + 다운로드 가능한 링크 형태의 생성된 이미지입니다. 최소 한 개가 존재합니다. `urls`가 비어 있는 `completed` 작업은 `success_without_output`이며 이 문서에 도달하지 않기 때문입니다. - 이 문서에서는 항상 `completed`입니다. Router가 성공으로 보고하는 유일한 상태이며, Krea의 용어는 대소문자 변환 없이 그대로 매칭됩니다. + 이 문서에서는 항상 `completed`입니다. Router가 성공으로 보고하는 유일한 status이며, Krea의 어휘는 대소문자 구분 없이 매칭되지 않고 그대로 매칭됩니다. 가능한 값: `completed` diff --git a/ko/development/comfy-router/providers.mdx b/ko/development/comfy-router/providers.mdx index a53b7e93da..18a539b529 100644 --- a/ko/development/comfy-router/providers.mdx +++ b/ko/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 서빙 공급자" sidebarTitle: "서빙 공급자" description: "각 Comfy Router 모델을 서빙할 수 있는 공급자와 대체 공급자를 선택하는 방법을 확인합니다." -translationSourceHash: 2e5f5f1e +translationSourceHash: 26a39d7a translationFrom: development/comfy-router/providers.mdx --- @@ -14,20 +14,21 @@ translationFrom: development/comfy-router/providers.mdx ## 공급자 지원 현황 -| 모델 / 공급자 | **Comfy (기본)** | **fal** | **Higgsfield** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | -| --- | --- | --- | --- | --- | --- | --- | --- | --- | -| [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | -| [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | -| [Gemini 2.5 Flash Image](/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | ✓ | - | - | - | - | -| [Gemini Nano Banana 2.1](/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | ✓ | - | - | - | - | -| [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | -| [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | -| [Kling 3.0 Turbo](/ko/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | -| [Kling V3](/ko/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | ✓* | - | -| [Nano Banana 2](/ko/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [Nano Banana Pro](/ko/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [Wan 3.0 Video](/ko/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | +| 모델 / 공급자 | **Comfy (기본)** | **fal** | **Higgsfield** | **Kelly** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | +| [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | +| [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code) | ✓ | - | - | ✓ | - | - | - | - | - | +| [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | +| [Gemini 2.5 Flash Image](/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [Gemini Nano Banana 2.1](/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [Kling 3.0 Turbo](/ko/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | - | +| [Kling V3](/ko/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | - | ✓* | - | +| [Nano Banana 2](/ko/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [Nano Banana Pro](/ko/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [Wan 3.0 Video](/ko/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | - | \* 이 공급자는 기본 공급자보다 더 좁은 제한으로 모델을 서빙합니다. 자세한 내용은 모델 페이지를 참고하세요. diff --git a/zh/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx b/zh/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx index e80d099c67..ce3d861f59 100644 --- a/zh/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx @@ -2,16 +2,17 @@ title: "将 Claude Fable 5.1 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 anthropic/claude-fable-5-1:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Claude Fable 5.1" -translationSourceHash: 0c17cbf0 +translationSourceHash: 72432b96 translationFrom: development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx translationBlockHashes: "_intro": d52eb513 "Quick start": 66ea5c23 - "Schema": d2c6492b + "Schema": 9180e71b "Examples": e6e3e477 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-fable-5-1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5-1/requests/$REQUES - 当该值为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 正文。 + 在 Comfy Router 的路由 `POST /v2/models/anthropic/{model}` 上,`stream` 不起作用:Router 会在分发之前将它的取值固定为 `false`,并始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会使响应变为 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 正文。在 Router 上请将 `stream` 传为 false 或省略该字段;`/proxy/` 操作的 200 响应中 `text/event-stream` 这一部分在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/anthropic/claude-fable-5/code.mdx b/zh/development/comfy-router/models/anthropic/claude-fable-5/code.mdx index a2d0d19f2b..2ea4c655a2 100644 --- a/zh/development/comfy-router/models/anthropic/claude-fable-5/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-fable-5/code.mdx @@ -2,16 +2,17 @@ title: "将 Claude Fable 5 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 anthropic/claude-fable-5:端点、请求结构与 Router 返回的响应。" sidebarTitle: "Claude Fable 5" -translationSourceHash: 2b085858 +translationSourceHash: fac73389 translationFrom: development/comfy-router/models/anthropic/claude-fable-5/code.mdx translationBlockHashes: "_intro": 5f3f65cf "Quick start": bffec245 - "Schema": 15962b1f + "Schema": fb6e12b6 "Examples": d4496b58 --- + {/* GENERATED FILE. 由 `pnpm code-pages:gen` 从 router-schemas/anthropic/claude-fable-5.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5/requests/$REQUEST_ - 为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 响应体。 + 在 Comfy Router 路由 `POST /v2/models/anthropic/{model}` 上,`stream` 是无效的:Router 会在派发之前将其固定为 `false`,并且始终以单个 JSON 文档返回完整的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,取 `true` 会使响应变成由 Anthropic 消息事件组成的 `text/event-stream`,而不是单个 JSON 响应体。在 Router 上请将 `stream` 设为 false 或省略;`/proxy/` 操作 200 响应中 `text/event-stream` 这一部分在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx b/zh/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx index f70de42b48..07d2250154 100644 --- a/zh/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx @@ -2,16 +2,17 @@ title: "将 Claude Haiku 4.5 20251001 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 anthropic/claude-haiku-4-5-20251001:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Claude Haiku 4.5 20251001" -translationSourceHash: dd8d78f3 +translationSourceHash: eb49608c translationFrom: development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx translationBlockHashes: "_intro": bf2f46fc "Quick start": 5526f5fd - "Schema": 9679eecf + "Schema": 1e6040f8 "Examples": 18cca7af --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/anthropic/claude-haiku-4-5-20251001.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-haiku-4-5-20251001/request - 当设置为 `true` 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 主体。 + 在 Comfy Router 路由 `POST /v2/models/anthropic/{model}` 上,`stream` 是无效的(INERT):Router 会在分发之前将其固定为 `false`,并始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会让响应成为 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 主体。在 Router 上请将 `stream` 设为 false 或省略它;`/proxy/` 操作的 200 响应中 `text/event-stream` 的那一半在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx b/zh/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx index 4fdbac2274..e84f7b797d 100644 --- a/zh/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx @@ -2,16 +2,17 @@ title: "将 Claude Opus 4.6 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 anthropic/claude-opus-4-6:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Claude Opus 4.6" -translationSourceHash: 93ccca91 +translationSourceHash: cb5d7e2f translationFrom: development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx translationBlockHashes: "_intro": a1da9d27 "Quick start": 642b5091 - "Schema": d3b6797e + "Schema": c13974e1 "Examples": 2cc5500c --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-4-6.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-6/requests/$REQUEST - 为 true 时,响应不再是单个 JSON 正文,而是由 Anthropic 消息事件组成的 `text/event-stream`。 + 在 Comfy Router 的 `POST /v2/models/anthropic/{model}` 路由上,`stream` 不起作用:Router 会在派发之前将其固定为 `false`,并且始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会让响应变成由 Anthropic 消息事件组成的 `text/event-stream`,而不是单个 JSON 正文。在 Router 上请将 `stream` 设为 false 或直接省略;`/proxy/` 操作返回 200 响应中 `text/event-stream` 的那一半,在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx b/zh/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx index 43a03d5cfd..a845f8ab42 100644 --- a/zh/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx @@ -2,16 +2,17 @@ title: "将 Claude Opus 4.7 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 anthropic/claude-opus-4-7:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Claude Opus 4.7" -translationSourceHash: 274ad2a2 +translationSourceHash: 75f77626 translationFrom: development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx translationBlockHashes: "_intro": 9c9cb89b "Quick start": 8bed0f96 - "Schema": 69d553ae + "Schema": 64cc6da3 "Examples": 8eadda7c --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-4-7.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-7/requests/$REQUEST - 为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 响应体。 + 在 Comfy Router 的 `POST /v2/models/anthropic/{model}` 路由上,`stream` 不生效:Router 会在派发之前将其固定为 `false`,并始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会让响应变成由 Anthropic 消息事件组成的 `text/event-stream`,而不是单个 JSON 响应体。在 Router 上请将 `stream` 传为 false 或省略;`/proxy/` 操作 200 响应中 `text/event-stream` 那一半在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx b/zh/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx index f3f2e8e6b7..a016df106c 100644 --- a/zh/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx @@ -2,16 +2,17 @@ title: "配合 Comfy Router 使用 Claude Opus 4.8" description: "通过 Comfy Router 调用 anthropic/claude-opus-4-8:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Claude Opus 4.8" -translationSourceHash: aef515bf +translationSourceHash: 4aae8e49 translationFrom: development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx translationBlockHashes: "_intro": 74fdd245 "Quick start": 874f5aef - "Schema": 0519e19d + "Schema": f74f93ff "Examples": 07251ae9 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/anthropic/claude-opus-4-8.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-8/requests/$REQUEST - 当为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而非单个 JSON 正文。 + 在 Comfy Router 的 `POST /v2/models/anthropic/{model}` 路由上,`stream` 是无效的:Router 会在派发前将它固定为 `false`,并始终把已完成的消息作为单个 JSON 文档返回。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会让响应变成 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 正文。在 Router 上请将 `stream` 设为 false 或省略它;`/proxy/` 操作 200 响应中 `text/event-stream` 的那一半在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx b/zh/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx index 8b62419713..86c6bc021d 100644 --- a/zh/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx @@ -2,14 +2,15 @@ title: "使用 Claude Opus 5.5 搭配 Comfy Router" description: "通过 Comfy Router 调用 anthropic/claude-opus-5-5:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Claude Opus 5.5" -translationSourceHash: 84c96ea2 +translationSourceHash: 9b019780 translationFrom: development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx translationBlockHashes: "_intro": ae2af968 "Quick start": c6539c4b - "Schema": 3c0dd311 + "Schema": 1dca9f7c "Examples": fd6d9b8d --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/anthropic/claude-opus-5-5.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -190,14 +191,14 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5-5/requests/$REQUEST - 当为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 主体。 + 在 Comfy Router 的路由 `POST /v2/models/anthropic/{model}` 上,`stream` 是无效的:Router 会在分发之前将其固定为 `false`,并始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会让响应成为由 Anthropic 消息事件组成的 `text/event-stream`,而不是单个 JSON 主体。在 Router 上请将 `stream` 设为 false 或省略它;`/proxy/` 操作 200 响应中 `text/event-stream` 的那一半在 Router 上没有对应形式。 顶层系统提示词。可以是字符串,也可以是内容块数组;两者都会原样传递给 Anthropic。 -由 Router 在 `GET /v2/models/anthropic/claude-opus-5-5/openapi.json` 处提供的架构生成,该文档与请求到达提供商之前用于校验调用的文档是同一份。 +由 Router 在 `GET /v2/models/anthropic/claude-opus-5-5/openapi.json` 处提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档是同一份。 ### 输出 diff --git a/zh/development/comfy-router/models/anthropic/claude-opus-5/code.mdx b/zh/development/comfy-router/models/anthropic/claude-opus-5/code.mdx index efd496a0d1..c2b1cfb03f 100644 --- a/zh/development/comfy-router/models/anthropic/claude-opus-5/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-opus-5/code.mdx @@ -2,16 +2,17 @@ title: "将 Claude Opus 5 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 anthropic/claude-opus-5:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Claude Opus 5" -translationSourceHash: d5eb64ff +translationSourceHash: 3c1df63d translationFrom: development/comfy-router/models/anthropic/claude-opus-5/code.mdx translationBlockHashes: "_intro": 8a45f373 "Quick start": 2f41262e - "Schema": 8006be48 + "Schema": eabb47c6 "Examples": 6926a739 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5/requests/$REQUEST_I - 为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 响应体。 + 在 Comfy Router 的 `POST /v2/models/anthropic/{model}` 路由上,`stream` 是无效的(INERT):Router 会在派发之前将其固定为 `false`,并且始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会让响应变为 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 响应体。在 Router 上请发送 `stream` false 或省略它;`/proxy/` 操作 200 响应中 `text/event-stream` 的那一半在 Router 上没有对应项。 diff --git a/zh/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx b/zh/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx index 80c8cf5699..b230db5319 100644 --- a/zh/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx @@ -2,16 +2,17 @@ title: "将 Claude Sonnet 4.5 20250929 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 anthropic/claude-sonnet-4-5-20250929:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Claude Sonnet 4.5 20250929" -translationSourceHash: af2be0cb +translationSourceHash: f146cae8 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx translationBlockHashes: "_intro": e5d80e67 "Quick start": c93ab6db - "Schema": c0b4e9c3 + "Schema": 14769c2e "Examples": 78b06084 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-4-5-20250929.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-5-20250929/reques - 为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 响应体。 + 在 Comfy Router 的 `POST /v2/models/anthropic/{model}` 路由上,`stream` 不起作用:Router 会在派发之前将其固定为 `false`,并且始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会使响应成为由 Anthropic 消息事件组成的 `text/event-stream`,而不是单个 JSON 响应体。在 Router 上请将 `stream` 设为 false 或直接省略;`/proxy/` 操作 200 响应中的 `text/event-stream` 部分在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx b/zh/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx index 7b1e805636..a05989e4f1 100644 --- a/zh/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx @@ -2,16 +2,17 @@ title: "使用 Comfy Router 调用 Claude Sonnet 4.6" description: "通过 Comfy Router 调用 anthropic/claude-sonnet-4-6:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Claude Sonnet 4.6" -translationSourceHash: 9d3bf586 +translationSourceHash: 51c4d648 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx translationBlockHashes: "_intro": e6f03e00 "Quick start": c2210e0e - "Schema": 7e4df7aa + "Schema": 9c28d0e8 "Examples": 7fb5285d --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-4-6.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -176,7 +177,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-6/requests/$REQUE - 对话轮次。完整的 content block 分类请参阅 Anthropic Messages API 文档。 + 对话轮次。完整的 content block 分类体系请参阅 Anthropic Messages API 文档。 @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-6/requests/$REQUE - 为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 响应体。 + 在 Comfy Router 的路由 `POST /v2/models/anthropic/{model}` 上,`stream` 是无效的:Router 会在派发之前将其固定为 `false`,并始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会使响应成为 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 响应体。在 Router 上请将 `stream` 设为 false 或将其省略;`/proxy/` 操作的 200 响应中属于 `text/event-stream` 的那一部分,在 Router 上没有对应的实现。 diff --git a/zh/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx b/zh/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx index d4f80bc0f9..697d163fb4 100644 --- a/zh/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx @@ -2,16 +2,17 @@ title: "将 Claude Sonnet 5 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 anthropic/claude-sonnet-5:端点、请求结构与 Router 返回的响应。" sidebarTitle: "Claude Sonnet 5" -translationSourceHash: a4550d3d +translationSourceHash: 6752140c translationFrom: development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx translationBlockHashes: "_intro": 9027b350 "Quick start": 23b1d5d3 - "Schema": ed894fd9 + "Schema": a6d8a431 "Examples": a3ab5037 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/anthropic/claude-sonnet-5.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-5/requests/$REQUEST - 为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 响应体。 + 在 Comfy Router 的 `POST /v2/models/anthropic/{model}` 路由上,`stream` 不起作用(INERT):Router 会在分发之前将其固定为 `false`,并且始终以单个 JSON 文档返回已完成的消息。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会使响应成为由 Anthropic 消息事件组成的 `text/event-stream`,而不是单个 JSON 响应体。在 Router 上请将 `stream` 发送为 `false` 或将其省略;`/proxy/` 操作的 200 响应中 `text/event-stream` 的那一半在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/krea/krea-3/code.mdx b/zh/development/comfy-router/models/krea/krea-3/code.mdx index 083a81383c..64f35ba32a 100644 --- a/zh/development/comfy-router/models/krea/krea-3/code.mdx +++ b/zh/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,17 +2,16 @@ title: "通过 Comfy Router 使用 Krea 3" description: "通过 Comfy Router 调用 krea/krea-3:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Krea 3" -translationSourceHash: eee80c65 +translationSourceHash: cd728587 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": dbedda04 + "Schema": 7aa8390e "Examples": 276619d9 --- - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/krea/krea-3.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -153,15 +152,15 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ ### 输入 - 1:1、4:5、3:4、2:3、9:16、5:4、4:3、3:2、16:9 或 21:9。与 resolution 配合使用;省略则自动构图。 + 1:1、4:5、3:4、2:3、9:16、5:4、4:3、3:2、16:9 或 21:9。与 resolution 配合使用;省略则自动取景。 - 输入图像 URL,最多 8 个。将图像上传到 POST /proxy/krea/assets(multipart 表单字段 `file`)后返回的 image_url 始终会被接受。其他公共 https URL 是否会被接受取决于环境:在不接受的环境中,任何不是主机 app-uploads.krea.ai 上的 https URL 的链接都会被以 400 拒绝;在接受的环境中,任何公共 https 图像 URL 都会被接受,而格式错误或不是 https 的 URL 会被以 400 拒绝(端口为数字但超出范围的 URL 不会被此检查捕获,可能反而以 502 失败)。在这种情况下,对于格式正确的 https URL,调用方可以修复的引用会被以 400 拒绝并指明其主机:在抓取之前检查时,其主机无法解析或无法公开访问;它重定向的次数超过允许值、重定向到不是 https 的 URL,或重定向到无法公开访问的主机;它返回 408 或 429 以外的 4xx;它不是图像;它是无法读取格式的图像;它的图像尺寸头不在前 2 MiB 之内;或者未声明长度或使用分块编码的响应在其图像尺寸头之前就结束了。抓取它的任何其他失败都会使 POST /proxy/krea 以 502 错误失败(Comfy Router 以 500 internal_error 应答):临时的 DNS、TLS 或连接失败,超时,源站返回 408、429、5xx 或其他非 200 状态,或者通过了该检查但在抓取连接时无法解析或无法公开访问的主机。在不接受其他 URL 的环境中,不是实时上传的 app-uploads.krea.ai 链接会以 5xx 错误失败;在接受的环境中,它会像任何其他不可达的引用一样被以 400 拒绝。当服务器尚未确定适用哪种情况时,任何主机不是 app-uploads.krea.ai 链接的 https URL(无论是否公共)都会以 503 错误失败,该错误可以安全重试。文生图时省略。 + 输入图片网址,最多 8 个。超过 8 个条目会在任何抓取之前被拒绝(在 /proxy/krea 上返回 400;Comfy Router 的 schema 检查会先返回 422)。将图像上传到 POST /proxy/krea/assets(multipart 表单字段 `file`)所返回的 image_url 始终会被接受。其他公共 https 网址是否被接受取决于环境:在不接受的环境中,任何不是 app-uploads.krea.ai 主机上的 https 网址的链接都会被拒绝并返回 400,提示 'image_urls must be image_url values returned by POST /proxy/krea/assets',因此请改为上传图像;在接受的环境中,任何公共 https 图片网址都会被接受,而格式错误或不是 https 的网址会被拒绝并返回 400(端口为数字但超出范围的网址不会被此检查捕获,而是可能以 502 失败)。在这种情况下,对于格式正确的 https 网址,调用方可修复的引用会被拒绝并返回 400,并指明其主机:抓取前检查时其主机无法解析或不可公开访问;重定向次数超过允许值;重定向到不是 https 的网址;重定向到不可公开访问的主机;返回 408 或 429 以外的 4xx;它不是图像;它是无法读取格式的图像;其图像尺寸头不在前 2 MiB 内;或者没有声明长度或使用分块编码的响应在其图像尺寸头之前就结束了。抓取它的任何其他失败都会在 POST /proxy/krea 上以 502 错误失败(Comfy Router 以 500 internal_error 应答):瞬时的 DNS、TLS 或连接失败,超时,源站返回 408、429、5xx 或其他非 200 状态,或者通过了该检查但在抓取连接时无法解析或不可公开访问的主机。其中一些在重试时会消失(解析器错误、超时、连接断开、源站返回 5xx、408 或 429,或者某个主机的 DNS 应答在主机检查与连接之间切换到非公共地址,重试时可能成功,也可能得到针对非公共主机的 400);另一些则每次都同样失败,例如抓取不信任的 TLS 证书(自签名、已过期或主机名错误),或者源站返回 200 以外的 2xx,或者抓取不跟随的 3xx(例如 204、206、300、304 或 305,或者没有 Location 的 301、302、303、307 或 308),因此如果重试以同样的方式失败,请改为上传图像。通过 Comfy Router 排队的请求在其任一 image_urls 不是 app-uploads.krea.ai 链接时不会重试此类失败,因此如果原因可以消失,请自行重新提交。在不接受其他网址的环境中,不是有效上传的 app-uploads.krea.ai 链接会以 5xx 错误失败;在接受的环境中,它会像任何其他不可达的引用一样被拒绝并返回 400。在服务器尚未确定适用哪种情况期间,任何主机不是 app-uploads.krea.ai 链接的 https 网址,无论是否公共,都会以 503 错误失败,且可以安全重试(排队中的请求会对此自动重试)。排队请求的 400 只带有通用的 invalid_input 详情,因此它既不显示主机,也不显示上面的措辞,并且队列不会重试它。排队请求的 400 可能来自任何字段,不仅是 image_urls(例如不受支持的分辨率或 thinking_mode),因此请先检查其他字段。如果它们有效,请将每张图像上传到 POST /proxy/krea/assets,并用这些 image_url 值以及新的 Idempotency-Key(或不带)重新提交:用更改过的请求体复用该 Key 会被拒绝并返回 409 invalid_input,这并不说明图像有问题;用相同的请求体复用它则会以 201 应答,并带有原始的 request_id 和 Idempotent-Replayed: true,因此它不会启动新的运行,其结果网址会返回同样的 400(其状态网址以 200 应答,error_type 为 invalid_input)。在接受其他公共 https 网址的环境中,如果重新提交同样以 400 失败,则问题出在图像本身(例如它不是受支持的图像,或者其图像尺寸头不在前 2 MiB 内)。在它们不被接受的环境中,同一张已上传的图像会以 5xx(Comfy Router 上为 500 internal_error)而不是该 400 失败,问题仍然出在图像上,因此再次上传也无济于事。每张图像只读取前 2 MiB 来查找其尺寸,因此如果图像的大小信息无法在该窗口内读取(例如嵌入元数据超过 2 MiB 的 JPEG,或者透明数据(若无透明数据,则是其第一个图像数据块的起始位置)位于 2 MiB 之后的调色板 PNG,例如在超过 2 MiB 的文本或颜色配置文件块之后),无论是否上传,都会被拒绝并返回 400,说明其图像尺寸头不在前 2 MiB 内;请将其重新保存以去掉过大的元数据,或者将调色板 PNG 保存为非调色板 PNG。国际化主机请以其 ASCII(punycode)形式发送;非 ASCII 主机名会被拒绝,视为不存在。文生图时省略。 - berry(默认,质量优先)或 jam(速度优先)。 + berry(默认,质量)或 jam(速度)。 @@ -169,11 +168,11 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 要生成的内容。与 image_urls 一起使用时,为编辑指令;描述应改变的内容以及应保持不变的内容。 + 要生成的内容。配合 image_urls 时,为编辑指令;描述应该改变什么、应该保持不变什么。 - 设为 true 以执行局部编辑并保留图像的其他部分。需要 model 为 berry,且 image_urls 中至少包含一个图像。 + 设为 true 表示保留图像其余部分的局部编辑。需要 model 为 berry,且 image_urls 中至少有 1 张图像。 @@ -185,10 +184,10 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - fast(默认)、high 或 ultra。high 和 ultra 会更详细地规划复杂编辑,耗时也更长。ultra 需要 resolution 为 2k。 + fast(默认)、high 或 ultra。high 和 ultra 会更详细地规划复杂编辑,耗时更长。ultra 需要 resolution 为 2k。 -根据 Router 在 `GET /v2/models/krea/krea-3/openapi.json` 提供的 Schema 生成,这也是它在请求到达提供商之前校验调用所用的同一份文档。 +根据 Router 在 `GET /v2/models/krea/krea-3/openapi.json` 提供的 schema 生成,与 Router 在请求到达提供商之前校验调用时使用的是同一份文档。 ### 输出 @@ -201,15 +200,15 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 仅在 status 为 failed 时设置。已取消的任务不包含此字段。 + 仅在状态为 failed 时设置。已取消的任务不携带该字段。 - 作业失败的原因:content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal 或 node_app_node_failed。遇到未知代码时按 internal 处理。 + 作业失败的原因:content_policy、invalid_request、validation_failed、model_unavailable、insufficient_balance、timeout、auto_cancelled、provider_error、internal 或 node_app_node_failed。将未知代码视为 internal。 - 可选。provider_error 和 internal 情况下由提供商提供的自由格式文本。 + 可选。用于 provider_error 和 internal 的自由格式提供商文本。 @@ -221,19 +220,19 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 已完成的生成结果。与 `KreaJob` 上不同,此处不可为空:终端任务的 `result` 若不包含 `urls`,会作为 Comfy Router 错误返回,因此 `200` 响应中始终带有该字段。 + 已完成的生成结果。此处不可为空,与 `KreaJob` 上不同:终端任务的 `result` 不包含 `urls` 时,会以 Comfy Router 错误作答,因此 `200` 始终会携带它。 - 由 loraTraining 任务而非生成过程设置;这些模型的 `200` 响应带有 `urls`。 + 由 loraTraining 作业设置,而不是由生成过程设置;这些模型的 `200` 会携带 `urls`。 - 已生成的图像,以可下载链接的形式提供。至少一个,因为 `completed` 状态的任务若 `urls` 为空即为 `success_without_output`,永远不会出现在本文档中。 + 已生成的图像,以可下载链接的形式提供。至少有一个,因为 `urls` 为空的 `completed` 作业属于 `success_without_output`,永远不会到达此文档。 - 在本文档中始终为 `completed`:这是 Router 唯一报告为成功的状态,并且 Krea 的用词匹配不进行大小写折叠。 + 在此文档中始终为 `completed`:它是 Router 报告为成功的唯一状态,并且 Krea 的词汇匹配不进行大小写折叠。 可能的值:`completed` diff --git a/zh/development/comfy-router/providers.mdx b/zh/development/comfy-router/providers.mdx index 7b7120e2ed..a5705d8ca0 100644 --- a/zh/development/comfy-router/providers.mdx +++ b/zh/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 服务提供商" sidebarTitle: "服务提供商" description: "查看每个 Comfy Router 模型可由哪些提供商提供服务,以及如何选择备用提供商。" -translationSourceHash: 2e5f5f1e +translationSourceHash: 26a39d7a translationFrom: development/comfy-router/providers.mdx --- @@ -14,20 +14,21 @@ translationFrom: development/comfy-router/providers.mdx ## 提供商覆盖范围 -| 模型 / 提供商 | **Comfy(默认)** | **fal** | **Higgsfield** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | -| --- | --- | --- | --- | --- | --- | --- | --- | --- | -| [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | -| [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | -| [Gemini 2.5 Flash Image](/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | ✓ | - | - | - | - | -| [Gemini Nano Banana 2.1](/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | ✓ | - | - | - | - | -| [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | - | ✓ | -| [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | -| [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | -| [Kling 3.0 Turbo](/zh/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | -| [Kling V3](/zh/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | ✓* | - | -| [Nano Banana 2](/zh/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [Nano Banana Pro](/zh/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [Wan 3.0 Video](/zh/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | +| 模型 / 提供商 | **Comfy(默认)** | **fal** | **Higgsfield** | **Kelly** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | +| [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | +| [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code) | ✓ | - | - | ✓ | - | - | - | - | - | +| [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | +| [Gemini 2.5 Flash Image](/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [Gemini Nano Banana 2.1](/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [Kling 3.0 Turbo](/zh/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | - | +| [Kling V3](/zh/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | - | ✓* | - | +| [Nano Banana 2](/zh/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [Nano Banana Pro](/zh/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [Wan 3.0 Video](/zh/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | - | \* 该提供商为此模型提供服务时,限制比默认提供商更严格;请参阅模型页面。 From c5bdc9884fe039a0428cc14be09ddee7eed4749e Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Fri, 13 Nov 2026 11:12:50 +0800 Subject: [PATCH 24/36] i18n: resync router code pages after the 2026-11-12 cloud sync (batch 2: byteplus, google flash models) --- .../dreamina-seedance-2-0-260128/code.mdx | 154 +++++++-------- .../code.mdx | 153 ++++++++------- .../dreamina-seedance-2-0-mini/code.mdx | 165 ++++++++-------- .../dreamina-seedance-2-5-260628/code.mdx | 156 +++++++-------- .../byteplus/seedance-1-0-pro-250528/code.mdx | 132 +++++++------ .../seedance-1-0-pro-fast-251015/code.mdx | 161 ++++++++-------- .../google/gemini-2-5-flash-image/code.mdx | 149 +++++++-------- .../google/gemini-3-1-flash-lite/code.mdx | 155 +++++++-------- .../models/google/gemini-3-7-flash/code.mdx | 123 ++++++------ .../models/google/gemini-3-8-flash/code.mdx | 153 +++++++-------- .../dreamina-seedance-2-0-260128/code.mdx | 136 +++++++------- .../code.mdx | 153 ++++++++------- .../dreamina-seedance-2-0-mini/code.mdx | 136 ++++++++------ .../dreamina-seedance-2-5-260628/code.mdx | 137 +++++++------- .../byteplus/seedance-1-0-pro-250528/code.mdx | 136 ++++++++------ .../seedance-1-0-pro-fast-251015/code.mdx | 126 +++++++------ .../google/gemini-2-5-flash-image/code.mdx | 103 +++++----- .../models/google/gemini-3-7-flash/code.mdx | 105 ++++++----- .../models/google/gemini-3-8-flash/code.mdx | 128 ++++++------- .../dreamina-seedance-2-0-260128/code.mdx | 132 +++++++------ .../code.mdx | 146 ++++++++------- .../dreamina-seedance-2-0-mini/code.mdx | 153 ++++++++------- .../dreamina-seedance-2-5-260628/code.mdx | 141 +++++++------- .../byteplus/seedance-1-0-pro-250528/code.mdx | 128 +++++++------ .../seedance-1-0-pro-fast-251015/code.mdx | 177 +++++++++--------- .../google/gemini-2-5-flash-image/code.mdx | 118 ++++++------ .../google/gemini-3-1-flash-lite/code.mdx | 132 ++++++------- .../models/google/gemini-3-7-flash/code.mdx | 105 ++++++----- .../models/google/gemini-3-8-flash/code.mdx | 121 ++++++------ 29 files changed, 2121 insertions(+), 1893 deletions(-) diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 25f7ca8434..e0f5ac5598 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "Dreamina Seedance 2.0 260128 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-260128 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: a3a29c99 +translationSourceHash: 63aaaa35 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 - "Serving providers": 74eb2a7c - "Schema": 9c7c68b7 + "Serving providers": 6d20a079 + "Schema": 3b5d80d0 "Examples": 641c458b --- @@ -17,6 +17,7 @@ translationBlockHashes: + {/* 生成済みファイル。router-schemas/byteplus/dreamina-seedance-2-0-260128.json から `pnpm code-pages:gen` によって生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -187,6 +188,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque - **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` - **Higgsfield**、`higgsfield/higgsfield-seedance-2.0` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=higgsfield` +- **Kelly**、`kelly/kelly-seedance-2.0` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=kelly` - **Pika**、`pika/pika-seedance-2.0` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=pika` - **Runware**、`runware/runware-seedance-2.0` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=runware` - **WaveSpeed**、`wavespeed/wavespeed-seedance-2.0` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=wavespeed` @@ -212,15 +214,15 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque - オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオ(wav、mp3)の公開 URL。 + オーディオ URL、Base64 エンコーディング、またはアセット ID。 +オーディオ URL: オーディオ(wav、mp3)の公開 URL。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終出力のティア(4k を含む)に合わせてこのリクエストで解像度を設定してください。省略した場合、最終出力は 1080p になります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終ビデオの出力ティア(4k を含む)はこのリクエストで解像度を設定してください。省略した場合、最終ビデオは 1080p になります。 @@ -232,7 +234,7 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) + 画像から動画への生成のための画像コンテンツ(type が "image_url" の場合) 画像 URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -241,8 +243,8 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b コンテンツ項目の役割/位置。 画像の場合: first_frame、last_frame、または reference_image。 -ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 -オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` @@ -250,34 +252,25 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 +テキストプロンプト(必須): 生成するビデオの説明を中国語および英語の文字で記述します。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): テキストプロンプトの後に --[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 自身のバリデータが応答します。実際のトラフィックをはるかに上回る値に -設定されているため、本物のプロンプトを判定することは決してありません。呼び出し元が -より多くを必要とする場合は引き上げてください。 +Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus はテキスト長の制限を公表しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。 +バイト数ではなく文字数でカウントするため、マルチバイトのプロンプトではワイヤ上のサイズがこの数倍になることがあります。これはこの 1 つのフィールドを制限するものであり、リクエストを制限するものではありません: `content` は配列であり、ドキュメント全体を制限するのはリクエストごとのボディ上限です。これを強制するのは Comfy Router(/v2/models/byteplus/\{model})のサーフェスです。v1 /proxy を直接呼び出した場合は、代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、実際のプロンプトが判定対象になることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 - 入力コンテンツの種類 + 入力コンテンツのタイプ 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -288,64 +281,73 @@ BytePlus 自身のバリデータが応答します。実際のトラフィッ ビデオ URL またはアセット ID。 -ビデオ URL: ビデオ(mp4、mov)の公開 URL。 +ビデオ URL: ビデオ(mp4、mov)の公開 URL。 アセット ID: 形式 asset://\ Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終ビデオがレンダリングされます。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 +最終ビデオをレンダリングするには、返されたタスク ID を `draft_task` コンテンツ項目で渡します。そのリクエストで最終ビデオの解像度(4k を含む)を設定します。解像度を省略した場合、最終ビデオは 1080p になります。Draft タスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(auto)。 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウト閾値(秒)。デフォルト 172800(48h)。範囲: [3600, 259200]。 - 範囲: `3600`〜`259200` + 範囲: `3600` から `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成済みビデオに映像と同期したオーディオが含まれるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力でも断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオであった場合のみで、同期 Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を作り直してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 + + + + Seedance 2.5 のみ。参照メディアをどのタスクに使用するか。省略時は auto を意味し、モデルはプロンプトと参照メディアからタスクを推測します。その解釈と競合する設定(編集として解釈した場合の `duration` や `ratio` など)は生成が開始された後にのみ解決され、課金されます。 +reference: 参照画像、ビデオ、オーディオに導かれて、要求された `duration` の新しいビデオを生成します。 +edit: 接続された参照ビデオを変更します。出力はソースクリップ自体の長さとアスペクト比を保つため、`duration: -1` を送信し、`ratio` を省略します(または `adaptive` を送信します)。 +extend: 参照ビデオを継続します。出力は新しく生成されたセグメントのみで、要求された `duration` を持ちます。アスペクト比はクリップに従います。 +明示的な値を指定した場合、送信時にプロバイダーによって検証されます(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`)。そのため、リクエストに合わない値は生成開始前に失敗し、課金されません。auto にはそのようなチェックはありません。このチェックはネイティブの BytePlus 側でのみ実行されます。代替プロバイダー側(フォールバック時、または `model_provider` で選択した場合)にはタスク種別のフィールドがなく、値は破棄され、そのプロバイダーが auto と同様に自身でタスクを推測します。破棄されたことは `X-Comfy-Router-Dropped-Params` で開示され、同期実行ルートのレスポンスと、キュー中の送信の `201` に含まれます。キュー中のルートにはフォールバックがないため、`model_provider` を通じてのみ代替側に到達します。 + + 指定可能な値: `reference`、`edit`、`extend` - Seedance 2.5 のみ。出力ビデオのコンテナ形式です。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズが小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さいファイルサイズを実現します。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 のファーストフレーム / ファースト・ラストフレーム生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p、4k をサポートしています。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` - 生成されたビデオの最後のフレーム画像を返すかどうか。 -true: 生成されたビデオの最後のフレーム画像を返します。このパラメーターを true に設定した後、ビデオ生成タスクの情報を照会するを呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、連続する複数のビデオを生成できます。前に生成したビデオの最後のフレームが次のビデオタスクの最初のフレームとして使用されるため、連続する複数のビデオをすばやく生成できます。 -false: 生成されたビデオの最後のフレーム画像を返しません。 + 生成されたビデオの最終フレーム画像を返すかどうか。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定した後、ビデオ生成タスクの情報のクエリを呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオのそれと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。前回生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオを素早く生成できます。 +false: 生成されたビデオの最終フレーム画像を返しません。 @@ -355,47 +357,47 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `default`、`flex` - 生成されたビデオにウォーターマークを含めるかどうか。 + 生成されたビデオに透かしを含めるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` で Router が提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 - ビデオ生成タスク完了後の出力です。出力ビデオのダウンロードURLと、BytePlusが返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされており、ここにあるその他のフィールドはすべてBytePlus自身のものです。Null許容: BytePlusはタスクの24時間後にURLをクリアするため、その後でポーリングした成功済みのドキュメントでは `content` が存在しないかnullである可能性があります。 + 動画生成タスクの完了後の出力です。出力動画のダウンロードURLと、BytePlusが返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされ、ここにあるその他のフィールドはすべてBytePlus独自のものです。Nullable: BytePlusはタスクの24時間後にURLをクリアするため、その後にポーリングした成功済みドキュメントでは `content` が存在しないかnullであることがあります。 - 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 + 生成された動画の最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - BytePlusがこれを `content` の中にネストする場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedanceモデルでは `content` のトップレベルの兄弟として返すことのほうが一般的です(トップレベルの `output_format` フィールドを参照)。Routerはどちらか存在する方を読み取ります。 + BytePlusが `content` の内部にネストした場合の、生成された動画のコンテナ形式(mp4またはmov)です。Seedanceモデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、トップレベルの `output_format` フィールドを参照してください。Routerは存在する方の値を読み取ります。 - 上流URLが機能しなくなる時刻を表すRFC 3339形式の値です。URL自体が持つ最も早い署名時刻と有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusが文書化しているURLの寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ含まれ、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流URLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻と有効期間の和で、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusが文書化したURLの寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 - 形式: `date-time` + Format: `date-time` - BytePlus自身の最終フレームのダウンロードURLです。再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみが対象で、BytePlusがクリアすると存在しなくなり、`upstream_expires_at` まではベアラ認証情報です。 + BytePlus自身の最終フレームのダウンロードURLで、再ホストされた `last_frame_url` の隣にバイト単位でそのまま返され、`upstream_video_url` と同じ条件が適用されます: オプトインしたワークスペースのみ、Seedance 2.xのみ、BytePlusがクリアすると存在しなくなり、`upstream_expires_at` まではベアラ資格情報です。 - BytePlus自身の出力ビデオのダウンロードURLで、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースがポーリングするSeedance 2.xのタスクにのみ含まれます(リクエストパラメータはありません)。それ以外のすべての場合、たとえばワークスペースに解決されない認証情報(いずれのワークスペースにもスコープされていないレガシーAPIキーなど)では含まれず、また生成から24時間後にBytePlusがURLをクリアすると含まれなくなります。これは署名済みのオブジェクトストレージURLであり、したがってベアラ認証情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットとして扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストが消費します。 + BytePlus自身の出力動画のダウンロードURLで、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースがポーリングしたSeedance 2.xのタスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべての場合、たとえばワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシーなAPIキーなど)では存在しません。また、生成から24時間後にBytePlusがURLをクリアすると存在しなくなります。これは署名済みのオブジェクトストレージURL、つまりベアラ資格情報であるため、それを保持する誰もが有効期限まで動画をダウンロードできます。シークレットと同様に扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストが消費します。 - 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドには代わりにBytePlus自身のURLが残りますが、BytePlusはタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限しています。いずれにせよリンクは失効するため、URLを保存するのではなくビデオをダウンロードしてください。 + 出力動画のダウンロードURLです。Routerは動画をComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再適用されるため、後でのポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus自身のURLを保持し、BytePlusはタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなく動画をダウンロードしてください。 @@ -403,7 +405,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlusがこの点で一貫していないためです。ビデオタスクは秒単位の整数を返すことが観測されており、同系列のBytePlusのサーフェスでは小数の再生時間が報告されることもあるため、クライアントは整数値を前提にしてはいけません。BytePlus自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成された動画の再生時間(秒)です。BytePlusがこの点で一貫していないため、整数ではなく数値として宣言されています: ビデオタスクが整数の秒を返すことも、隣接するBytePlusのサーフェスが小数の再生時間を報告することも観察されているため、クライアントは整数値を仮定してはなりません。BytePlus自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 @@ -411,7 +413,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetectedは、コンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFakeのように、ドット区切りの理由が付くことがあります。これは列挙型ではなくオープンな文字列です: その他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識し、トランスポートの失敗を上書きしません。 @@ -419,47 +421,47 @@ false: 生成されたビデオの最後のフレーム画像を返しません - ビデオ生成タスクの ID + The ID of the video generation task - タスクで使用されたモデルの名前とバージョン + The name and version of the model used by the task - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 独自のフィールドで、そのまま転送されます。 + Container format of the generated video (mp4 or mov), returned at the TOP LEVEL as a sibling of `content` - this is where the Seedance video task query returns it. BytePlus's own field, forwarded unchanged. - 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + The resolution of the generated video, for example `1080p`. BytePlus's own field, returned on succeeded video tasks and forwarded unchanged. - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + The generation seed actually used for the task. BytePlus's own field, returned on succeeded video tasks and forwarded unchanged. - 形式: `int64` + Format: `int64` - タスクの状態 + The state of the task - 指定可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + Possible values: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 + The time when the task was last updated. The value is a UNIX timestamp in seconds. - リクエストのトークン使用量 + The token usage for the request - モデルによって生成されたトークン数 + The number of tokens generated by the model - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens です。 + For the video generation model, the number of input tokens is not calculated and defaults to 0. Therefore, total_tokens = completion_tokens. ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index cf2e1c46f0..85909c959e 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,13 @@ title: "Comfy Router で Dreamina Seedance 2.0 Fast 260128 を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-fast-260128 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: 506a7f86 +translationSourceHash: fd645dad translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": 48fe2811 + "Serving providers": dfa238a4 + "Schema": bb84c022 "Examples": 7714eccd --- @@ -15,6 +16,7 @@ translationBlockHashes: + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -178,12 +180,21 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ +## 提供プロバイダー + +このモデルは、リクエストで別のプロバイダーが指定されない限り、Comfy Router が直接提供します。以下のプロバイダーも、同じエンドポイントと同じモデル ID でこのモデルを提供しており、`model_provider` クエリパラメーターで選択します。 + +- **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128` +- **Kelly**、`kelly/kelly-seedance-2.0-fast` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128?model_provider=kelly` + +`strict_mode` のデフォルトは false のため、Router はこのページで説明されているネイティブなリクエストボディをプロバイダー独自のスキーマに変換し、レスポンスを元の形式に戻します。API リファレンスの [`model_provider`、`strict_mode`、`fallback_provider`](/ja/development/comfy-router/reference#post-v2modelsprovidermodel) と、この方法でルーティングされるすべてのモデルについては [提供プロバイダー](/ja/development/comfy-router/providers) を参照してください。 + ## スキーマ ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果を取得するには、代わりにタスクステータス取得用のルートをポーリングしてください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに結果はタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -193,11 +204,11 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、画像またはビデオを最低 1 つ含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートします。 - オーディオの URL、Base64 エンコード、またはアセット ID。 + オーディオ URL、Base64 エンコード、またはアセット ID。 オーディオ URL: オーディオの公開 URL(wav、mp3)。 Base64: 形式は data:audio/\;base64,\ アセット ID: 形式は asset://\ @@ -217,8 +228,8 @@ Base64: 形式は data:audio/\;base64,\ - 画像から動画を生成する際の画像コンテンツ(type が "image_url" の場合) -画像URL: 画像URLにアクセスできることを確認してください。 + 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) +画像 URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります。 アセット ID: 形式は asset://\ @@ -229,41 +240,40 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 使用可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 +テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。 パラメータ(任意): テキストプロンプトの後に --[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) +- --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 自身のバリデータが応答します。実際の -トラフィックよりはるかに高く設定されているため、正当なプロンプトがこれによって -判定されることはありません。呼び出し元がさらに必要とする場合は引き上げてください。 +テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。 +文字数(バイト数ではない)でカウントするため、マルチバイトのプロンプトは +ワイヤ上ではこのサイズの数倍になる場合があります。これはこの 1 つのフィールドを制限するものであり、 +リクエスト全体を制限するものではありません。`content` は配列であり、リクエスト全体の +ボディ制限がドキュメント全体を制限します。これを適用するのは +Comfy Router(/v2/models/byteplus/\{model})であり、v1 /proxy への直接呼び出しでは +代わりに BytePlus 独自のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、 +実際のプロンプトを判定することはありません。呼び出し元がさらに必要とする場合は引き上げてください。 - 入力コンテンツの種類 + 入力コンテンツのタイプ - 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 使用可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -271,65 +281,74 @@ v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが - ビデオの URL またはアセット ID。 + ビデオ URL またはアセット ID。 ビデオ URL: ビデオの公開 URL(mp4、mov)。 アセット ID: 形式は asset://\ Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終ビデオをレンダリングします。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 +返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終ビデオをレンダリングします。このリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 - 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 使用可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。 範囲: `3600` ~ `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオ用に `false` を送ってください。これが効果を発揮するのは、拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ識別されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 +false: モデルは無音のビデオを出力します。サポートされているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外の点では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオ用に `false` を送信してください。これが有効なのはオーディオが拒否されたモダリティであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 + + + + Seedance 2.5 のみ。参照メディアを使用するタスク。省略すると auto を意味し、モデルがプロンプトと参照メディアからタスクを推論します。その解釈と競合する設定(編集として解釈したものに対する `duration` や `ratio` など)は、生成が開始された後にのみ解決され、その生成は課金されます。 +reference: 参照画像、ビデオ、オーディオに導かれて、要求された `duration` の新しいビデオを生成します。 +edit: 接続された参照ビデオを変更します。出力はソースクリップ自体の長さとアスペクト比を保つため、`duration: -1` を送信し、`ratio` を省略します(または `adaptive` を送信します)。 +extend: 参照ビデオを継続します。出力は新たに生成されたセグメントのみで、要求された `duration` を持ち、アスペクト比はクリップに従います。 +明示的な値は送信時にプロバイダーによって検証されるため(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`)、リクエストに適合しない値は生成開始前に失敗し、課金されません。auto にはそのようなチェックはありません。このチェックはネイティブの BytePlus レッグでのみ実行されます。代替プロバイダーレッグ(フォールバック時、または `model_provider` で選択した場合)にはタスクタイプのフィールドがなく、値は破棄され、そのプロバイダーが auto と同様にタスク自体を推論します。破棄されたことは `X-Comfy-Router-Dropped-Params` で、同期実行ルートのレスポンスとキュー中の送信の `201` で通知されます。キュー中のルートにはフォールバックがないため、`model_provider` を通じてのみ代替レッグに到達します。 + + 指定可能な値: `reference`、`edit`、`extend` Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズが小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さなファイルサイズを持ちます。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみ受け付けられます。具体的な比率を指定すると、送信前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の first-frame / first-last-frame 生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` - 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、「ビデオ生成タスクの情報の照会」を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオをすばやく生成できます。 -false: 生成されたビデオの最終フレーム画像を返しません。 + 生成されたビデオの最後のフレーム画像を返すかどうか。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報の照会を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。以前に生成されたビデオの最後のフレームが次のビデオタスクの最初のフレームとして使用され、複数の連続したビデオを迅速に生成できます。 +false: 生成されたビデオの最後のフレーム画像を返しません。 @@ -339,63 +358,63 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `default`、`flex` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに届く前に呼び出しを検証する際に Router が使用するドキュメントと同じものです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で Router が提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 自身のものです。Nullable。BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になっていることがあります。 + ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロードURLと、BytePlusが返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージへ再ホストされ、ここにある他のすべてのフィールドはBytePlus自身のものです。Nullable:BytePlusはタスクの24時間後にURLをクリアするため、その後にポーリングした成功済みドキュメントでは `content` が存在しないかnullになっていることがあります。 - 生成されたビデオの最終フレームのダウンロード 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 を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナ形式(mp4 または mov)。BytePlus が `content` の中にネストして返す場合に存在します。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在するほうを読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlusが `content` の中にネストして返す場合のものです。Seedanceモデルはこれを `content` のトップレベルの兄弟として返すことの方が一般的です。トップレベルの `output_format` フィールドを参照してください。Routerはどちらか存在する方を読み取ります。 - 上流 URL が機能しなくなる RFC 3339 時刻。最も早い署名時刻に URL 自体が持つ有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間を加えたもの(BytePlus がドキュメント化している URL の寿命)より後になることはなく、存在しない場合はタスクの `updated_at` に 24 時間を加えたものです。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流のURLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` プラス24時間(BytePlusが文書化しているURLの寿命)より後になることはなく、存在しない場合はタスクの `updated_at` プラス24時間です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 形式: `date-time` - 最終フレームについての BytePlus 自身のダウンロード URL。再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのままのバイト列として返されます。オプトインしたワークスペースのみ、Seedance 2.x のみが対象で、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報として扱われます。 + BytePlus自身の最終フレームのダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.xのみが対象で、BytePlusがクリアした後は存在せず、`upstream_expires_at` まではベアラ認証情報です。 - 出力ビデオについての BytePlus 自身のダウンロード URL。再ホストされた `video_url` の隣に、そのままのバイト列として返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x のタスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべての場合には存在しません。たとえばワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシー APIキーなど)の場合も含みます。また、生成から 24 時間後に BytePlus が URL をクリアすると存在しなくなります。これは署名付きオブジェクトストレージの URL であり、したがってベアラー資格情報です。所持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットと同様に扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストで消費されます。 + BytePlus自身の出力ビデオのダウンロードURLで、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされたSeedance 2.xのタスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべての場合(ワークスペースに解決されない認証情報、たとえばワークスペースにスコープされていないレガシーAPIキーなど)には存在せず、BytePlusが生成の24時間後にURLをクリアすると存在しなくなります。これは署名付きオブジェクトストレージURLであり、したがってベアラ認証情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットとして扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5ではBytePlusがこれを100ダウンロードに制限しており、そのうち1回はRouter自身の再ホストが消費します。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再送されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限しています。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus自身のURLのままとなり、BytePlusはタスクの24時間後にそれをクリアし、一部のモデルでは100ダウンロードに制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値はUNIXタイムスタンプ(秒)です。 - 生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すこともあれば、同じ BytePlus の別のサーフェスが小数の再生時間を報告することも確認されているため、クライアントは整数値であると仮定してはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlusがこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは整数秒を返すことが観測されており、同系列のBytePlusのサーフェスでは小数の再生時間が報告されるため、クライアントは整数値を仮定してはなりません。BytePlus自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列であり、他のコードは検証やプロバイダーの失敗を表します。Router はポリシーファミリーを HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答で認識し、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列で、他のコードは検証やプロバイダーの障害を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識し、トランスポートの障害を上書きすることはありません。 @@ -403,7 +422,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 動画生成タスクの ID + ビデオ生成タスクの ID @@ -411,11 +430,11 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(`mp4` または `mov`)。`content` の兄弟としてトップレベルで返されます。これは Seedance のビデオタスククエリがこの値を返す位置です。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 @@ -427,11 +446,11 @@ false: 生成されたビデオの最終フレーム画像を返しません。 タスクの状態 - 取りうる値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + 取りうる値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - タスクが最後に更新された時間。この値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒)です。 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index b75228e1db..ce0007aedf 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Dreamina Seedance 2.0 Mini を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-mini を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69e65942 +translationSourceHash: 55b49c2a translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 51a6f44e + "Schema": def7c834 "Examples": db01067e --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/byteplus/dreamina-seedance-2-0-mini.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -183,7 +184,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに、結果はタスクステータスのルートをポーリングして取得してください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに結果を取得するには、タスクステータスのルートをポーリングしてください。 形式: `uri` @@ -193,23 +194,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみを使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートします。 - オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオの公開 URL(wav、mp3)。 -Base64: 形式は data:audio/\;base64,\ -アセット ID: 形式は asset://\ + オーディオURL、Base64 エンコード、またはアセット ID。 +オーディオURL: オーディオの公開 URL(wav、mp3)。 +Base64: 形式 data:audio/\;base64,\ +アセット ID: 形式 asset://\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクの prompt、入力アセット、duration、ratio、seed、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終出力のティア(4k を含む)に合わせてこのリクエストで resolution を設定してください。省略した場合、最終出力は 1080p になります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。このリクエストで、4k を含む最終出力のティアに応じた解像度を設定してください。省略した場合、最終出力は 1080p です。 - `draft` を true にして Draft ビデオを作成したときに返されるタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -217,185 +218,187 @@ Base64: 形式は data:audio/\;base64,\ - 画像から動画への生成のための画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 + 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) +画像URL: 画像URLにアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式は asset://\ +アセット ID: 形式 asset://\ コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、reference_image。 -ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 -オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +画像の場合: first_frame、last_frame、または reference_image。 +ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 使用可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字で生成するビデオを記述します。 +テキストプロンプト(必須): 中国語と英語の文字を使用して生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): ビデオの仕様を制御するには、テキストプロンプトの後に --[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 自身のバリデータが応答します。実際のトラフィックをはるかに -上回る値に設定されているため、正当なプロンプトがこれで判定されることはありません。 -呼び出し元がさらに多くを必要とする場合は引き上げてください。 +Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus はテキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。これはバイトではなく文字をカウントするため、マルチバイトのプロンプトは転送時にこのサイズの数倍になる可能性があります。これはリクエスト全体ではなく、この 1 つのフィールドを制限します: `content` は配列であり、ドキュメント全体を制限するのはリクエストごとのボディ制限です。Comfy Router (/v2/models/byteplus/\{model}) がこれを適用するエンドポイントです。直接の v1 /proxy 呼び出しでは、代わりに BytePlus 自身のバリデーターが応答します。実際のトラフィックよりはるかに高く設定し、正当なプロンプトがこの制限によって判定されないようにしてください。呼び出し元がさらに必要とする場合は、引き上げてください。 入力コンテンツのタイプ - 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 使用可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。 - ビデオ URL またはアセット ID。 -ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式は asset://\ + ビデオURL またはアセット ID。 +ビデオURL: ビデオの公開 URL(mp4、mov)。 +アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終ビデオをレンダリングします。そのリクエストで最終出力の resolution(4k を含む)を設定します。resolution を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +最終ビデオをレンダリングするには、返されたタスク ID を `draft_task` コンテンツ項目で渡します。そのリクエストでは、4k を含む最終出力の解像度を設定します。解像度を省略した場合、最終出力は 1080p です。Draft タスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。 + ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(auto)。 - 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 使用可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - タスクのタイムアウト閾値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` 〜 `259200` + 範囲: `3600` から `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオ用に `false` を送ってください。これが有効なのは、拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キューのリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 +対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによるコンテンツチェックを受けます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力であっても断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 + - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 + + + + Seedance 2.5 のみ。参照メディアを何に使うかのタスクです。省略時は auto を意味し、モデルはプロンプトと参照メディアからタスクを推測します。その読み取りと競合する設定(編集として解釈した場合の `duration` や `ratio` など)は生成が開始された後にしか解決されず、課金されます。 +reference: 参照画像、ビデオ、オーディオに導かれて、要求された `duration` の新しいビデオを生成します。 +edit: 接続された参照ビデオを変更します。出力はソースクリップ自体の長さとアスペクト比を保つため、`duration: -1` を送信し、`ratio` を省略します(または `adaptive` を送信します)。 +extend: 参照ビデオを継続します。出力は要求された `duration` の新しく生成されたセグメントのみで、アスペクト比はクリップに従います。 +明示的な値は送信時にプロバイダーによって検証される(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`)ため、リクエストに合わない値は生成開始前に失敗し、課金されません。auto にはそのようなチェックはありません。このチェックはネイティブの BytePlus 側でのみ実行されます。代替プロバイダー側(フォールバック時、または `model_provider` で選択した場合)にはタスク種別フィールドがなく、値は破棄され、そのプロバイダーが auto と同様に自分でタスクを推測します。破棄されたことは `X-Comfy-Router-Dropped-Params` で、同期実行ルートのレスポンスとキュー送信時の `201` に示されます。キュールートにはフォールバックがないため、`model_provider` を通じてのみ代替側に到達します。 + + 指定可能な値: `reference`、`edit`、`extend` - Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性がありファイルサイズも小さくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式です。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さいファイルサイズを実現します。 mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適しています。ファイルサイズは大きくなります。 - Possible values: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の最初のフレーム / 最初と最後のフレーム生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 - Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - Possible values: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` - 生成されたビデオの最後のフレーム画像を返すかどうか。 -true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報をクエリすることで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。前に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオを素早く生成できます。 -false: 生成されたビデオの最後のフレーム画像を返しません。 + 生成されたビデオの最終フレーム画像を返すかどうか。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報をクエリする API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると複数の連続したビデオを生成できます。前のビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオを素早く生成できます。 +false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + 乱数を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 - Range: `-1` to `4294967295` + 範囲: `-1` から `4294967295` 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - Possible values: `default`, `flex` + 指定可能な値: `default`、`flex` 生成されたビデオに透かしを含めるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使われるのと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で Router が提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 - ビデオ生成タスク完了後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、それ以外のフィールドはすべて BytePlus 自身のものです。Nullable - BytePlus はタスクの24時間後にURLを消去するため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になっていることがあります。 + 動画生成タスクの完了後に得られる出力で、出力動画のダウンロードURLと、BytePlusが返す場合にはその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされ、ここにある他のフィールドはすべてBytePlus自身のものです。Nullable: BytePlusはタスクの24時間後にURLを消去するため、その後でポーリングした成功済みドキュメントでは `content` が存在しないかnullである可能性があります。 - 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 + 生成された動画の最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中に入れ子にして返す場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + 生成された動画のコンテナ形式(mp4またはmov)で、BytePlusが `content` の中にネストして返す場合に含まれます。Seedanceモデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、その場合はトップレベルの `output_format` フィールドを参照してください。Routerはどちらか存在する方を読み取ります。 - 上流のURLが機能しなくなる RFC 3339 時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus が文書化しているURLの寿命)を加えた時刻より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流のURLが機能しなくなるRFC 3339時刻。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間を加えた時刻(BytePlusが文書化しているURLの寿命)より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の有効期間とは無関係です。 形式: `date-time` - 最終フレームに対する BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのままの形で返されます。オプトイン済みのワークスペースのみ、Seedance 2.x のみで、BytePlus が消去すると存在しなくなり、`upstream_expires_at` まではベアラー認証情報として扱われます。 + BytePlus自身の最終フレームのダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.xのみ、BytePlusが消去した後は存在せず、`upstream_expires_at` まではベアラ認証情報です。 - 出力ビデオに対する BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にそのままの形で返されます。Comfy がサーバー側でオプトインしたワークスペースによってポーリングされた Seedance 2.x タスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべてでは存在しません。ワークスペースに解決されない認証情報(ワークスペースにスコープされていないレガシー APIキーなど)も含まれ、BytePlus が生成の24時間後にURLを消去すると存在しなくなります。これは署名付きオブジェクトストレージのURLであるためベアラー認証情報であり、それを保持する誰もが期限切れまでビデオをダウンロードできます。したがって秘密情報として扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストで消費されます。 + BytePlus自身の出力動画のダウンロードURLで、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされたSeedance 2.xのタスクにのみ存在します(リクエストパラメータはありません)。それ以外のすべての場合には存在せず、ワークスペースに解決されない認証情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)も含まれます。また、BytePlusが生成の24時間後にURLを消去すると存在しなくなります。これは署名済みオブジェクトストレージのURLであるため、ベアラ認証情報です。保持している人は誰でも有効期限まで動画をダウンロードできるので、秘密情報として扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5ではBytePlusが100回のダウンロードに制限しており、そのうち1回はRouter自身の再ホストで消費されます。 - 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身のURLのままとなり、BytePlus はタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 + 出力動画のダウンロードURL。Routerは動画をComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再利用されるため、後でポーリングすると残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus自身のURLのままとなり、BytePlusはタスクの24時間後にそれを消去し、一部のモデルでは100回のダウンロードに制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなく動画をダウンロードしてください。 - タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻。値は秒単位のUNIXタイムスタンプです。 - 生成されたビデオの再生時間(秒)です。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すことも、同系統の BytePlus の他の画面が小数の再生時間を報告することも観測されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 + 生成された動画の再生時間(秒)。BytePlusがこれについて一貫していないため、整数ではなく数値として宣言されています。動画タスクが整数秒を返す例や、同系列のBytePlusのサーフェスが小数の再生時間を報告する例が観察されているため、クライアントは整数値と仮定してはいけません。BytePlus自身のフィールドで、成功した動画タスクで返され、変更されずに転送されます。 - エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報。タスクが成功するとnullが返されます。タスクが失敗すると、エラー情報が返されます。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列であり、他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答の双方でポリシーファミリーを認識し、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -403,23 +406,23 @@ false: 生成されたビデオの最後のフレーム画像を返しません - 動画生成タスクの ID + ビデオ生成タスクのID - タスクで使用されたモデルの名前とバージョン + タスクで使用されるモデルの名前とバージョン - 生成されたビデオのコンテナ形式 (`mp4` または `mov`)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。これは Seedance のビデオタスククエリが返す場所です。BytePlus 独自のフィールドで、変更されずに転送されます。 - 生成されたビデオの解像度 (例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 形式: `int64` @@ -427,7 +430,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません タスクの状態 - 取りうる値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 取り得る値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` @@ -443,7 +446,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません - ビデオ生成モデルでは、入力トークン数は計算されず 0 がデフォルトになります。したがって、total_tokens = completion_tokens です。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトは 0 です。したがって、total_tokens = completion_tokens です。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index ed04b46323..87e2cc990d 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "Dreamina Seedance 2.5 260628 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-5-260628 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンス。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 2acd3f28 +translationSourceHash: eb57edfc translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 - "Serving providers": 197dd61a - "Schema": d29d4b46 + "Serving providers": 79988fbb + "Schema": 254e7e79 "Examples": 5465695b --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -186,6 +187,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque - **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628` - **fal**、`fal/fal-seedance-2.5` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=fal` - **Higgsfield**、`higgsfield/higgsfield-seedance-2.5` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=higgsfield` +- **Kelly**、`kelly/kelly-seedance-2.5` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=kelly` - **Runware**、`runware/runware-seedance-2.5` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=runware` - **WaveSpeed**、`wavespeed/wavespeed-seedance-2.5` として: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=wavespeed` @@ -217,12 +219,12 @@ Base64: 形式 data:audio/\;base64,\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。これは唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。最終ビデオの出力ティア(4k を含む)はこのリクエストの resolution で設定します。省略した場合、最終ビデオは 1080p になります。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、それらを再度送信しないでください。最終出力のティア(4k を含む)はこのリクエストの resolution で設定します。省略した場合、最終出力は 1080p になります。 - Draft ビデオを `draft` を true に設定して作成したときに返されたタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -230,54 +232,55 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセス可能であることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります。 + type が "image_url" の場合の、画像から動画への生成用の画像コンテンツ +画像 URL: 画像 URL にアクセスできることを確認してください。 +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、reference_image。 +画像の場合: first_frame、last_frame、または reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 指定可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。 +テキストプロンプト(必須): 中国語と英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): テキストプロンプトの後に --[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" +例: "美しい風景 --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 自身のバリデータが応答します。実際のトラフィックよりはるかに -高く設定されているため、正当なプロンプトがこれで判定されることはありません。 -呼び出し元がさらに必要とする場合は引き上げてください。 +テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。これはバイト数ではなく文字数を数えるため、マルチバイトの +プロンプトでは通信上のサイズがこの数倍になることがあります。この上限は +この 1 つのフィールドを制限するものであり、リクエスト全体を制限するもの +ではありません。`content` は配列であり、ドキュメント全体を制限するのは +リクエストごとのボディ上限です。この上限を適用するのは Comfy Router +(/v2/models/byteplus/\{model}) です。v1 /proxy を直接呼び出した場合は、 +代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックより +はるかに高く設定されているため、本物のプロンプトがこの上限で判断される +ことはありません。呼び出し元がより大きな値を必要とする場合は引き上げて +ください。 入力コンテンツのタイプ - 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -291,125 +294,134 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終ビデオがレンダリングされます。そのリクエストで最終ビデオの解像度(4k を含む)を設定します。resolution を省略した場合、最終ビデオは 1080p になります。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目に渡すと、最終ビデオがレンダリングされます。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動)。 - 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`、`16`、`17`、`18`、`19`、`20`、`21`、`22`、`23`、`24`、`25`、`26`、`27`、`28`、`29`、`30` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` 〜 `259200` + 範囲: `3600` から `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックはプロバイダーによってビデオとは別にコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力でも断続的に発生することがあります。そのような場合は、サイレントビデオにするために `false` を送ってください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力でも断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオだった場合のみで、同期 Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 + + + + Seedance 2.5 のみ。参照メディアをどのタスクに使うか。省略すると auto を意味し、モデルはプロンプトと参照メディアからタスクを推論します。その解釈と競合する設定(編集として解釈した場合の `duration` や `ratio` など)は、生成が開始された後にのみ解決され、課金されます。 +reference: 参照画像、ビデオ、オーディオに導かれて、要求された `duration` の新しいビデオを生成します。 +edit: 接続された参照ビデオを変更します。出力はソースクリップ自体の長さとアスペクト比を保つため、`duration: -1` を送信し、`ratio` を省略します(または `adaptive` を送信します)。 +extend: 参照ビデオを継続します。出力は新しく生成されたセグメントのみで、要求された `duration` を持ちます。アスペクト比はクリップに従います。 +明示的な値は送信時にプロバイダーによって検証されるため(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`)、リクエストに適合しない値は生成が始まる前に失敗し、課金されません。auto にはそのようなチェックはありません。このチェックはネイティブの BytePlus 側でのみ実行されます。代替プロバイダーの経路(フォールバック時、または `model_provider` で選択した場合)にはタスク種別フィールドがなく、値は破棄され、そのプロバイダーが auto と同様に自らタスクを推論します。破棄されたことは `X-Comfy-Router-Dropped-Params` で通知され、同期実行ルートのレスポンスと、キュー中の送信の `201` に含まれます。キュー中のルートにはフォールバックがないため、`model_provider` を通した場合にのみ代替経路に到達します。 + + 指定可能な値: `reference`, `edit`, `extend` Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性がありファイルサイズも小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さいファイルサイズ。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適しています。ファイルサイズは大きくなります。 - 可能な値: `mp4`, `mov` + 指定可能な値: `mp4`, `mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast と 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 - 可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast と 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast と 2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p、4k をサポートしています。 - 可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`, `720p`, `1080p`, `4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定した後、「ビデオ生成タスクの情報をクエリする」を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。以前に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオをすばやく生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定した後、「ビデオ生成タスクの情報の照会」を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオを素早く生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 を指定するとランダムシードが使用されます。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 範囲: `-1` から `4294967295` - 処理用のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービス階層。Seedance 2.5、2.0 と 2.0 fast は flex(オフライン推論)をサポートしていません。 - 可能な値: `default`, `flex` + 指定可能な値: `default`, `flex` - 生成されたビデオにウォーターマークを含めるかどうか。 + 生成されたビデオに透かしを含めるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` で Router が提供するスキーマから生成されています。これはリクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロードURLと、BytePlus が返した場合にはその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにあるそれ以外のフィールドはすべて BytePlus 自身のものです。nullable です。BytePlus はタスクの24時間後に URL をクリアするため、その後にポーリングした succeeded ドキュメントでは `content` が存在しないか null になることがあります。 + ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返した場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はいずれも Comfy ストレージへ再ホストされます。ここにある他のフィールドはすべて BytePlus 自身のものです。Nullable: BytePlus はタスクの24時間後に URL をクリアするため、その後ポーリングした成功済みドキュメントでは `content` が欠落または null になることがあります。 - 生成されたビデオの最終フレームのダウンロード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 を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード 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 を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、トップレベルの `output_format` フィールドを参照してください。Router は存在する方のフィールドを読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の内部にネストした場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く(トップレベルの `output_format` フィールドを参照)、Router は存在するほうを読み取ります。 - 上流の URL が機能しなくなる RFC 3339 の時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えた値で、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus が文書化している URL の寿命)を加えた値を超えることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた値です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースからも時刻が得られない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは関係ありません。 + 上流の URL が機能しなくなる RFC 3339 時刻です。最も早い署名時刻に URL 自体が持つ有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus が文書化している URL の寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 形式: `date-time` - 最終フレームの BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位のまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在せず、`upstream_expires_at` まではベアラ認証情報として扱われます。 + 最終フレームについての BytePlus 自身のダウンロード URL で、`upstream_video_url` と同じ条件で、再ホストされた `last_frame_url` の隣にバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると欠落し、`upstream_expires_at` まではベアラクレデンシャルです。 - 出力ビデオの BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にバイト単位のまま返されます。サーバー側で Comfy がオプトインしたワークスペースがポーリングする Seedance 2.x タスクにのみ存在します(リクエストパラメータはありません)。それ以外のすべての場合、たとえばワークスペースに解決されない認証情報(特定のワークスペースにスコープされていないレガシー APIキーなど)には存在せず、BytePlus が生成の24時間後に URL をクリアすると存在しなくなります。これは署名済みのオブジェクトストレージ URL であり、したがってベアラ認証情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットと同様に扱ってください。`upstream_expires_at` に失効し、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストが消費します。 + 出力ビデオについての BytePlus 自身のダウンロード URL で、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x タスクにのみ存在します(リクエストパラメータはありません)。それ以外には存在しません。ワークスペースに解決されないクレデンシャル(特定のワークスペースにスコープされていないレガシー API キーなど)も含まれます。また、生成の24時間後に BytePlus が URL をクリアすると存在しなくなります。これはプレサインドのオブジェクトストレージ URL であり、したがってベアラクレデンシャルです。保持している人は誰でも有効期限までビデオをダウンロードできるため、シークレットと同様に扱ってください。有効期限は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストが消費します。 - 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身の URL のままとなり、BytePlus がタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数が100回に制限されます。いずれにせよリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドには代わりに BytePlus 自身の URL が残ります。これは BytePlus がタスクの24時間後にクリアし、一部のモデルではダウンロード回数が100回に制限されます。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlus の扱いが一貫していないためです。ビデオタスクが整数の秒を返す一方で、同じ BytePlus の他のサーフェスでは小数の再生時間が報告されることが観測されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成されたビデオの再生時間(秒)。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すこともあれば、隣接する BytePlus のサーフェスが小数の再生時間を報告することも観測されており、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは enum ではなくオープンな文字列です。その他のコードは検証やプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識し、トランスポート障害を上書きすることはありません。 + 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例として InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake があります。これは列挙型ではなくオープンな文字列です。他のコードは検証およびプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -417,23 +429,21 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 動画生成タスクの ID - タスクで使用されたモデルの名前とバージョン - 生成されたビデオのコンテナ形式 (mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 + 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 - 生成されたビデオの解像度 (例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -453,11 +463,11 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - モデルによって生成されたトークンの数 + モデルによって生成されたトークン数 - ビデオ生成モデルでは、入力トークンの数は計算されず、0 がデフォルトになります。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 23942f9c9d..901ee04563 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Seedance 1.0 Pro 250528 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-250528 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 846f38d7 +translationSourceHash: 4453f401 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": 6f05c994 + "Schema": d82c78ff "Examples": 815d621e --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* 生成済みファイル。`pnpm code-pages:gen` によって router-schemas/byteplus/seedance-1-0-pro-250528.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -183,7 +184,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックは一切送信されません。結果はタスクステータスのルートをポーリングして取得してください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりにタスクステータスのルートをポーリングして結果を取得してください。 形式: `uri` @@ -193,23 +194,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートしています。 + 入力オーディオオブジェクト。オーディオ入力をサポートするのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートします。 - オーディオURL、Base64 エンコード、またはアセット ID。 -オーディオURL: オーディオの公開URL(wav、mp3)。 + オーディオ URL、Base64 エンコード、またはアセット ID。 +オーディオ URL: オーディオの公開 URL(wav、mp3)。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終出力のティア(4k を含む)を設定するには、このリクエストで resolution を指定します。省略した場合、最終出力は 1080p になります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。4k を含む最終出力のティアを設定するには、このリクエストで解像度を指定します。省略した場合、最終出力は 1080p になります。 - Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -218,7 +219,7 @@ Base64: 形式 data:audio/\;base64,\ 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -画像URL: 画像URLにアクセスできることを確認してください。 +画像 URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -233,22 +234,24 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語と英語の文字を使用して、生成するビデオを説明します。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): テキストプロンプトの後に --[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 独自のバリデータが応答します。実際のトラフィックをはるかに超える値に設定されているため、正当なプロンプトを判定することはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 +Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus はテキスト長の制限を公表しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。 +これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトではワイヤ上のサイズがこの数倍になることがあります。これはこの 1 つのフィールドを制限するものであって、リクエストを制限するものではありません: +`content` は配列であり、ドキュメント全体を制限するのはリクエストごとのボディ上限です。これを適用するのは Comfy Router (/v2/models/byteplus/\{model}) です。v1 /proxy を直接呼び出した場合は、代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトがこれによって判断されることはありません。呼び出し元がさらに必要とする場合は引き上げてください。 @@ -258,18 +261,18 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ - 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力をサポートするのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 - ビデオURLまたはアセット ID。 -ビデオURL: ビデオの公開URL(mp4、mov)。 + ビデオ URL またはアセット ID。 +ビデオ URL: ビデオの公開 URL(mp4、mov)。 アセット ID: 形式 asset://\ Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目に渡して最終ビデオをレンダリングします。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 +返されたタスク ID を `draft_task` コンテンツ項目に渡して最終ビデオをレンダリングします。そのリクエストで 4k を含む最終出力の解像度を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 @@ -279,114 +282,123 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48h)。範囲: [3600, 259200]。 範囲: `3600` から `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成済みビデオに映像と同期したオーディオが含まれるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックはプロバイダーによってビデオとは別にコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外では受け入れる入力に対して断続的に発生することがあります。そのような場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ識別されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに Draft を `false` で再作成してください。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ識別されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに Draft を `false` で再作成してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 + + + + Seedance 2.5 のみ。参照メディアをどのタスクに使用するか。省略すると auto を意味し、モデルはプロンプトと参照メディアからタスクを推論します。その解釈と競合する設定(編集として解釈した場合の `duration` や `ratio` など)は生成が開始された後にしか解決されず、その分は課金されます。 +reference: 参照画像、ビデオ、オーディオに導かれて、指定された `duration` の新しいビデオを生成します。 +edit: 接続された参照ビデオを変更します。出力はソースクリップ自身の長さとアスペクト比を維持するため、`duration: -1` を送信し、`ratio` を省略します(または `adaptive` を送信します)。 +extend: 参照ビデオを継続します。出力は指定された `duration` の新しく生成されたセグメントのみで、アスペクト比はクリップに従います。 +明示的な値は送信時にプロバイダーによって検証されるため(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`)、リクエストに適合しない値は生成が開始される前に失敗し、課金されません。auto にはそのようなチェックはありません。このチェックはネイティブの BytePlus 側でのみ実行されます。代替プロバイダー側(フォールバック時、または `model_provider` で選択した場合)にはタスク種別のフィールドがなく、値は破棄され、そのプロバイダーが auto と同様にタスク自体を推論します。この破棄は、同期実行ルートのレスポンスと、キュー中の送信の `201` において `X-Comfy-Router-Dropped-Params` で開示されます。キュー中のルートにはフォールバックがないため、`model_provider` を通じてのみ代替側に到達します。 + + Possible values: `reference`, `edit`, `extend` Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性がありファイルサイズも小さくなります。 -mov: プロ向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適しています。ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性があり、ファイルサイズも小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適していますが、ファイルサイズは大きくなります。 - 指定可能な値: `mp4`、`mov` + Possible values: `mp4`, `mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け付けられます。具体的な比率を指定するとディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 +Seedance 2.5 の最初のフレーム / 最初と最後のフレームの生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 - 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - 指定可能な値: `480p`、`720p`、`1080p`、`4k` + Possible values: `480p`, `720p`, `1080p`, `4k` - 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会することで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームが次のビデオタスクの先頭フレームとして使用され、複数の連続したビデオをすばやく生成できます。 -false: 生成されたビデオの最終フレーム画像を返しません。 + 生成されたビデオの最後のフレーム画像を返すかどうか。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメーターを true に設定した後は、「ビデオ生成タスクの情報の照会」を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。以前に生成されたビデオの最後のフレームが次のビデオタスクの最初のフレームとして使用されるため、複数の連続したビデオをすばやく生成できます。 +false: 生成されたビデオの最後のフレーム画像を返しません。 - ランダム性を制御するためのシード整数値。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 - 範囲: `-1` から `4294967295` + Range: `-1` to `4294967295` 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`、`flex` + Possible values: `default`, `flex` 生成されたビデオにウォーターマークが含まれるかどうか。 -`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で Router が配信するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使われるのと同じドキュメントです。 +Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL に加え、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージへ再ホストされ、ここにある他のフィールドはすべて BytePlus 自身のものです。null を許容します。BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないか null になることがあります。 + ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロードURLと、BytePlusが返す場合にはその最終フレームのダウンロードURLが含まれます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされ、ここにあるその他のフィールドはすべてBytePlus自身のものです。Nullable: BytePlusはタスクの24時間後にURLを消去するため、その後でポーリングしたsucceededのドキュメントでは `content` が存在しないかnullになることがあります。 - 生成されたビデオの最終フレームのダウンロード 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 を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - BytePlus が `content` の中に入れ子にして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedance のモデルはこれを `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在するほうを読み取ります。 + BytePlusが `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式(mp4またはmov)です。Seedanceモデルでは `content` のトップレベルの兄弟として返すことが多く、トップレベルの `output_format` フィールドを参照してください。Routerはどちらか存在する方を読み取ります。 - 上流の URL が機能しなくなる RFC 3339 形式の時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えたものですが、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間(BytePlus が文書化している URL の寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に 24 時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ含まれ、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは関係ありません。 + 上流のURLが機能しなくなるRFC 3339の時刻です。URL自体が持つ最も早い署名時刻と有効期間、または `updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusが文書化しているURLの寿命)を加えた時刻のいずれか早い方です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 形式: `date-time` - 最終フレームについての BytePlus 自身のダウンロード URL で、再ホストされた `last_frame_url` の隣にそのままのバイト列で返されます。条件は `upstream_video_url` と同じです。すなわち、オプトインしたワークスペースのみ、Seedance 2.x のみであり、BytePlus がクリアした後は存在せず、`upstream_expires_at` まではベアラー資格情報として扱われます。 + BytePlus自身の最終フレームのダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.xのみで、BytePlusが消去すると存在しなくなり、`upstream_expires_at` までベアラ認証情報として扱われます。 - 出力ビデオについての BytePlus 自身のダウンロード URL で、再ホストされた `video_url` の隣にそのままのバイト列で返されます。Comfy がサーバー側でオプトインしたワークスペースによるポーリングの Seedance 2.x タスクにのみ含まれます(リクエストパラメーターはありません)。それ以外の場合は含まれず、ワークスペースに解決されない資格情報(特定のワークスペースに紐付かないレガシーな API キーなど)も同様です。また、生成の 24 時間後に BytePlus が URL をクリアすると存在しなくなります。これは署名付きのオブジェクトストレージ URL、つまりベアラー資格情報であるため、これを保持する誰もが失効までビデオをダウンロードできます。秘密情報と同様に扱ってください。`upstream_expires_at` で失効し、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストが消費します。 + BytePlus自身の出力ビデオのダウンロードURLで、再ホストされた `video_url` の隣にそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースがポーリングするSeedance 2.xタスクでのみ存在します(リクエストパラメーターはありません)。それ以外のすべての場合、たとえばワークスペースに解決されない認証情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)では存在せず、生成から24時間後にBytePlusがURLを消去すると存在しなくなります。これは署名付きオブジェクトストレージのURLであるためベアラ認証情報であり、それを保持する誰もが有効期限までビデオをダウンロードできます。シークレットと同様に扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL です。Router はビデオを Comfy のストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy が署名した URL になります。発行時に 24 時間で署名され、23 時間のメモから再利用されるため、後からのポーリングでは残り 1 時間程度の URL が返ることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身の URL がこのフィールドに残りますが、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限します。いずれの場合もリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。生成時に24時間で署名され、23時間のメモから再送されるため、後でのポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドにはBytePlus自身のURLが残りますが、BytePlusはタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限しています。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された日時です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値はUNIXタイムスタンプ(秒)です。 - 生成されたビデオの再生時間(秒)です。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す例も確認されており、BytePlus の他のサーフェスでは小数の再生時間が報告されることもあるため、クライアントは整数値だと仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlusがこれについて一貫していないためです。ビデオタスクでは整数秒を返すことが観測されており、同じBytePlusの他の画面では小数の再生時間が報告されるため、クライアントは整数値を前提にしてはいけません。BytePlus自身のフィールドで、succeededのビデオタスクで返され、そのまま転送されます。 - エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは enum ではなくオープンな文字列であり、他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答の両方でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetectedはコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、たとえばInputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFakeなどがあります。これは列挙型ではなくオープンな文字列です。その他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識し、トランスポートの失敗を上書きしません。 @@ -394,7 +406,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 動画生成タスクの ID + The ID of the video generation task @@ -402,15 +414,15 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 独自のフィールドで、そのまま転送されます。 - 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 形式: `int64` @@ -418,11 +430,11 @@ false: 生成されたビデオの最終フレーム画像を返しません。 タスクの状態 - 取りうる値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + 指定可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - タスクが最後に更新された時間。この値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -434,7 +446,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - ビデオ生成モデルでは入力トークン数は計算されず、0 が既定値です。そのため、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens です。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 031d1e9dd4..593046ae1f 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "Seedance 1.0 Pro Fast 251015 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-fast-251015 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて解説します。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 5ba64878 +translationSourceHash: cadcf7af translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 2de625f5 + "Schema": db13820d "Examples": 1469ab97 --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-fast-251015.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -183,7 +184,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 入力 - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果は代わりにタスクステータスのルートをポーリングして取得してください。 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスク送信前に削除されるため、コールバックが送信されることはありません。結果は代わりにタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -193,23 +194,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートします。 + 入力オーディオオブジェクト。オーディオ入力をサポートするのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力をサポートします。 オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオ(wav、mp3)の公開 URL。 -Base64: data:audio/\;base64,\ の形式 -アセット ID: asset://\ の形式 +オーディオ URL: オーディオの公開 URL(wav、mp3)。 +Base64: 形式 data:audio/\;base64,\ +アセット ID: 形式 asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。最終出力のティア(4k を含む)はこのリクエストで解像度を設定してください。省略した場合、最終出力は 1080p になります。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスクです。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。最終出力のティア(4k を含む)はこのリクエストで resolution を設定してください。省略した場合、最終出力は 1080p になります。 - Draft ビデオを `draft` を true に設定して作成したときに返されたタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。 @@ -217,10 +218,10 @@ Base64: data:audio/\;base64,\ の形式 - 画像から動画を生成するための画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: data:image/\;base64,\ の形式である必要があります -アセット ID: asset://\ の形式 + 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) +画像URL: 画像URL にアクセスできることを確認してください。 +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります +アセット ID: 形式 asset://\ @@ -229,174 +230,182 @@ Base64 エンコードされたコンテンツ: data:image/\;base64,\ モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して、生成するビデオを記述します。 +テキストプロンプト(必須): 中国語および英語の文字を使用して、生成するビデオを説明します。 -パラメータ(任意): テキストプロンプトの後に --[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) +パラメータ(任意): テキストプロンプトの後に --[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 自身のバリデータが -応答します。実際のトラフィックよりはるかに高く設定されているため、正当な -プロンプトが判定されることはありません。呼び出し元がより多くを必要とする -場合は引き上げてください。 +テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。 +バイト数ではなく文字数を数えるため、マルチバイトのプロンプトでは転送時のサイズが +この数倍になることがあります。これはこの 1 つのフィールドを制限するもので、 +リクエスト全体を制限するものではありません: `content` は配列であり、 +ドキュメント全体を制限するのはリクエストごとのボディ上限です。これを強制するのは +Comfy Router(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出した場合は、 +代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されており、 +正当なプロンプトがこれで判定されることはありません。呼び出し元がさらに必要とする場合は +引き上げてください。 入力コンテンツの種類 - 取り得る値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力をサポートするのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 ビデオ URL またはアセット ID。 -ビデオ URL: ビデオ(mp4、mov)の公開 URL。 -アセット ID: asset://\ の形式 +ビデオ URL: ビデオの公開 URL(mp4、mov)。 +アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終ビデオをレンダリングできます。そのリクエストで最終出力の解像度(4k を含む)を設定します。解像度を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目で渡して最終ビデオをレンダリングします。そのリクエストで最終出力の resolution(4k を含む)を設定します。resolution を省略した場合、最終出力は 1080p になります。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 1.0 pro および 1.0 pro fast: [2,12]。 - 取り得る値: `2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` + 指定可能な値: `2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルト 172800(48h)。範囲: [3600, 259200]。 - 範囲: `3600` 〜 `259200` + 範囲: `3600` ~ `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされます。生成されるビデオに映像と同期したオーディオが含まれるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外の点では受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオ用に `false` を送信してください。これが効果を発揮するのは拒否されたモダリティがオーディオであった場合のみで、同期 Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは自身の Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を再作成してください。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはプロバイダーによってビデオとは別にコンテンツチェックされます。そこでの拒否は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。ただしこれが有効なのは、拒否されたモダリティがオーディオだった場合のみで、同期的な Router のレスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ識別されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 - 呼び出すモデルの 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 の呼び出し元は省略します。 + 呼び出すモデルの 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 の呼び出し元は省略します。 + + + + Seedance 2.5 のみ。参照メディアを何に使うかのタスク。省略すると auto を意味します。モデルはプロンプトと参照メディアからタスクを推論し、その解釈と競合する設定(編集と解釈した入力に対する `duration` や `ratio` など)は生成が開始された後にのみ解決されますが、その分は課金されます。 +reference: 参照画像、ビデオ、オーディオに導かれて、要求された `duration` の新しいビデオを生成します。 +edit: 接続された参照ビデオを変更します。出力はソースクリップ自体の長さとアスペクト比を維持するため、`duration: -1` を送信し、`ratio` を省略します(または `adaptive` を送信します)。 +extend: 参照ビデオを続けます。出力は要求された `duration` の新しく生成されたセグメントのみで、そのアスペクト比はクリップに従います。 +明示的な値は送信時にプロバイダーによって検証されるため(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`)、リクエストに適合しない値は生成開始前に失敗し、課金されません。auto にはこのようなチェックはありません。このチェックはネイティブの BytePlus 側でのみ実行されます。代替プロバイダー側(フォールバック時、または `model_provider` で選択した場合)にはタスク種別フィールドがなく、値は破棄され、そのプロバイダーが auto と同様にタスク自体を推論します。破棄は `X-Comfy-Router-Dropped-Params` で開示され、同期実行ルートのレスポンスと、キュー中の送信の `201` に含まれます。キュー中のルートにはフォールバックがないため、代替側に到達するのは `model_provider` 経由のみです。 + + 指定可能な値: `reference`, `edit`, `extend` Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズが小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さなファイルサイズを備えます。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適していますが、ファイルサイズは大きくなります。 - 指定可能な値: `mp4`、`mov` + 指定可能な値: `mp4`, `mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはこのフィールドの省略)のみが受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 - 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p、4k をサポートしています。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - 指定可能な値: `480p`、`720p`、`1080p`、`4k` + 指定可能な値: `480p`, `720p`, `1080p`, `4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報の照会を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオを素早く生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 + 乱数を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 範囲: `-1` から `4294967295` - 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`、`flex` + 指定可能な値: `default`, `flex` 生成されたビデオにウォーターマークを含めるかどうか。 -Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 +`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で Router が提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされ、ここにある他のすべてのフィールドは BytePlus 自身のものです。Nullable: タスクの24時間後に BytePlus がURLを消去するため、その後にポーリングした成功済みドキュメントでは `content` が欠落または null になることがあります。 + ビデオ生成タスク完了後の出力で、出力ビデオのダウンロードURLと、BytePlusが返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされ、ここにある他のすべてのフィールドはBytePlus独自のものです。Null許容: BytePlusはタスクの24時間後にURLを消去するため、その後でポーリングされた成功済みドキュメントでは `content` が欠落しているかnullである可能性があります。 - 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + 生成されたビデオのコンテナ形式(mp4またはmov)で、BytePlusが `content` の中にネストした場合に返されます。Seedanceモデルはより一般的に `content` のトップレベルの兄弟としてこれを返します。トップレベルの `output_format` フィールドを参照してください。Routerはいずれか存在する方を読み取ります。 - 上流のURLが機能しなくなる RFC 3339 時刻です。URL自体が持つ最も早い署名時刻と有効期間、ただし `updated_at` が存在する場合はタスクの `updated_at` と24時間(BytePlus の文書化されたURLの寿命)のうち遅くない方、存在しない場合はタスクの `updated_at` と24時間です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + 上流URLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻と有効期間、`updated_at` が存在する場合はタスクの `updated_at` に24時間を加えたもの(BytePlusがドキュメント化したURLの寿命)より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えたものです。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 形式: `date-time` - BytePlus 自身の最終フレームのダウンロードURLで、再ホストされた `last_frame_url` の隣にそのままのバイト列で返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみ、BytePlus が消去すると欠落し、`upstream_expires_at` まではベアラ資格情報です。 + 最終フレームのBytePlus自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.xのみ、BytePlusが消去すると欠落し、`upstream_expires_at` まではベアラ資格情報です。 - BytePlus 自身の出力ビデオのダウンロードURLで、再ホストされた `video_url` の隣にそのままのバイト列で返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングする Seedance 2.x タスクでのみ存在します(リクエストパラメータはありません)。それ以外のすべての場合、たとえばワークスペースに解決されない資格情報(ワークスペースにスコープされていないレガシー APIキーなど)では存在せず、また生成から24時間後に BytePlus がURLを消去すると存在しなくなります。これは署名付きオブジェクトストレージのURLであり、したがってベアラ資格情報です。保持している人は誰でも有効期限までビデオをダウンロードできるため、秘密情報として扱ってください。`upstream_expires_at` に失効し、Seedance 2.5 では BytePlus が100回のダウンロードに制限しており、そのうち1回は Router 自身の再ホストが消費します。 + 出力ビデオのBytePlus自身のダウンロードURLで、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされたSeedance 2.xタスクに対してのみ存在し(リクエストパラメータはありません)、それ以外のすべて(ワークスペースに解決されない資格情報、たとえばワークスペースにスコープされていないレガシーAPIキーなど)では存在せず、生成から24時間後にBytePlusがURLを消去すると欠落します。これは署名済みオブジェクトストレージURL、つまりベアラ資格情報であるため、それを保持する誰もが有効期限までビデオをダウンロードできます。秘密情報のように扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5ではBytePlusがダウンロード回数を100回に制限し、そのうち1回はRouter自身の再ホストが消費します。 - 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間程度のものが返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 自身のURLを保持し、BytePlus はタスクの24時間後にそれを消去し、一部のモデルでは100回のダウンロードに制限します。いずれの場合もリンクは失効するため、URLを保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。RouterはビデオをComfyストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後のポーリングでは残り1時間程度のものが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus自身のURLを保持し、BytePlusはタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値は秒単位のUNIXタイムスタンプです。 - 生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す例や、姉妹の BytePlus サーフェスが小数の再生時間を報告する例が観測されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlusはこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すことや、兄弟のBytePlusサーフェスが小数の再生時間を報告することが観察されているため、クライアントは整数値を仮定してはいけません。BytePlus自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの障害を上書きすることはありません。 + 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetectedはコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列です。他のコードは検証とプロバイダーの失敗を表します。RouterはHTTP 400エラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識し、トランスポートの失敗を上書きしません。 @@ -412,15 +421,15 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成済みビデオの解像度。例: `1080p`。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -440,11 +449,11 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` - モデルによって生成されたトークン数 + モデルによって生成されたトークンの数 - ビデオ生成モデルでは、入力トークン数は計算されず、0 がデフォルトです。そのため、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークンの数は計算されず、0 がデフォルトです。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index 5fd3785296..a7489d2bbd 100644 --- a/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で Gemini 2.5 Flash Image を使用する" description: "Comfy Router 経由で vertexai/gemini-2.5-flash-image を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Gemini 2.5 Flash Image" -translationSourceHash: 9bd54fc7 +translationSourceHash: f785dde3 translationFrom: development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx translationBlockHashes: "_intro": ac1aef55 "Quick start": 7ec68bbf "Serving providers": beb2dd36 - "Schema": f124875a + "Schema": f53ea977 "Examples": 19258aaa --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/vertexai/gemini-2.5-flash-image.json から生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -197,7 +198,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R ### 入力 - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは、単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -205,7 +206,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - URIベースのデータ。 + URIベースのデータです。 @@ -213,33 +214,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 - 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生バイトのインラインデータです。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコードです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB - フォーマット: `byte` + 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 - 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオをどのように読み取るか。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断できるようにするには "AGENTIC" を設定します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 - テキストプロンプトまたはコードスニペット。 + テキストプロンプトまたはコードスニペットです。 @@ -247,11 +248,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 指定可能な値: `user`、`model` + 指定可能な値: `user`, `model` - 生成のためのサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自体の動作にフォールバックします。 + 生成のためのサンプリング、長さ、出力の設定です。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作に従います。 @@ -259,27 +260,27 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 生成画像のアスペクト比 + 生成される画像のアスペクト比 - 任意。生成画像の出力フォーマット。 + 任意。生成される画像の画像出力形式です。 - 任意。出力画像の圧縮品質。 + 任意。出力画像の圧縮品質です。 - 任意。Vertex AI の経路(Comfy 自身のクレデンシャルで処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエスト)で、出力を保存する画像フォーマット。これらの経路で受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 エラーで拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームにはそのようなプロパティが存在せず、指定されていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずリクエストから削除され、出力フォーマットは AI Studio が選択したものになります。どの経路でも、送信した値を前提とするのではなく、受け取ったレスポンスのパートからメディアタイプを読み取ってください(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)。 + 任意。出力を保存する画像形式です。対象となるのは Vertex AI の経路、すなわち Comfy 自身の認証情報で処理されるリクエストと、GCP サービスアカウントで認証された BYOK リクエストです。そこでは `image/png` と `image/jpeg` が受け入れられ、大文字と小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。例外は Google AI Studio の APIキーで認証された BYOK リクエストです。その上流にはそのようなプロパティが存在せず、存在する場合は呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を前提にするのではなく、受け取ったレスポンスのパート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み戻してください。 - 任意。生成画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値 1K を使用します。 + 任意。生成される画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 - レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおよそ 60 ~ 80 語に相当します。 + レスポンスで生成できるトークンの最大数です。1 トークンはおよそ 4 文字です。100 トークンはおおよそ 60〜80 語に相当します。 範囲: `16` から `65536` @@ -289,7 +290,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じレスポンスを返すよう最善を尽くします。決定論的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用していてもレスポンスにばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + シードを特定の値に固定した場合、モデルは繰り返しのリクエストに対して同じ応答を返すようベストエフォートで動作します。決定的な出力は保証されません。また、同じシード値を使用していても、モデルや temperature などのパラメータ設定を変更すると、応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -297,45 +298,45 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - temperature は、レスポンス生成中のサンプリングに使用されます。これは topP と topK が適用されるときに発生します。temperature は、トークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由度や創造性を必要としないプロンプトに適しており、高い temperature はより多様で創造的な結果につながる可能性があります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対するレスポンスはほぼ決定論的になりますが、わずかなばらつきが生じる可能性は依然としてあります。モデルが汎用的すぎる、短すぎるレスポンスを返す場合や、フォールバックレスポンスを返す場合は、temperature を上げてみてください + temperature は、topP と topK が適用される応答生成中のサンプリングに使用されます。temperature は、トークン選択におけるランダム性の度合いを制御します。低い temperature は、自由度が低く創造性を抑えた応答が求められるプロンプトに適しており、高い temperature はより多様で創造的な結果につながります。temperature が 0 の場合、最も確率の高いトークンが常に選択されます。この場合、特定のプロンプトに対する応答はほぼ決定的になりますが、少量のばらつきが生じる可能性はあります。モデルの応答が一般的すぎる、短すぎる、またはフォールバック応答が返される場合は、temperature を上げてみてください。 - 範囲: `0` ~ `2` + 範囲: `0` から `2` - 形式: `float` + 形式: `浮動小数点` - 省略可能。思考機能の設定です。思考とは、モデルが複雑なタスクをより小さなステップに分解し、より高品質なレスポンスを生成するプロセスです。 + オプション。thinking 機能の設定です。thinking は、モデルが複雑なタスクをより小さなステップに分解し、より高品質な応答を生成するプロセスです。 - 省略可能。true の場合、モデルはレスポンスにその思考を含めます。 + オプション。true の場合、モデルは自身の思考を応答に含めます。 - 省略可能。モデルの思考プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + オプション。モデルの thinking プロセスのトークン予算です。モデルはこの予算内に収まるようベストエフォートで動作します。 - 省略可能。モデルの思考レベルです。 + オプション。モデルの thinking レベルです。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K は、モデルが出力するトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率が高いものになります。Top-K が 3 の場合、temperature を使用して、最も確率が高い 3 つのトークンの中から次のトークンが選択されます。 + Top-K は、モデルが出力するトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率の高いものになります。top-K が 3 の場合、次に選択されるトークンは、temperature を用いて最も確率の高い 3 つのトークンの中から選択されます。 - 範囲: `1` ~ `…` + 範囲: `1` から `…` 指定した場合、nucleus サンプリングが使用されます。 -Top-P は、モデルが出力するトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率が高いもの(top-K を参照)から低いものへと順に選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で top-P の値が 0.5 の場合、モデルは temperature を使用して次のトークンとして A または B を選択し、C は候補から除外されます。 -ランダム性の低いレスポンスにするには低い値を、よりランダムなレスポンスにするには高い値を指定します。 +Top-P は、モデルが出力するトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率の高いもの (top-K を参照) から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を用いて A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 +ランダム性の低い応答には低い値を、ランダム性の高い応答には高い値を指定してください。 - 範囲: `0` ~ `1` + 範囲: `0` から `1` - 形式: `float` + 形式: `浮動小数点` @@ -351,11 +352,11 @@ Top-P は、モデルが出力するトークンを選択する方法を変更 - モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン制限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part のコンテンツは別々の段落にしてください。 + モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスに影響しません。注: parts にはテキストのみを使用し、各 part の content は別々の段落にしてください。 - 1 つのメッセージを構成する、順序付けられた parts のリストです。parts ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数などの入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + 単一のメッセージを構成する、順序付けられた part のリストです。part ごとに異なる IANA MIME タイプを持つことができます。トークンの最大数や画像の数などの入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 @@ -363,13 +364,13 @@ Top-P は、モデルが出力するトークンを選択する方法を変更 - メッセージを作成するエンティティの役割です。以下の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターン会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空のままにするか、設定しないでください。 + メッセージを作成するエンティティの識別子です。以下の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model 値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンではない会話では、このフィールドは空のままにするか、未設定にできます。 指定可能な値: `user`, `model` - システムが、モデルの知識や範囲を超えたアクション(またはアクションの集合)を実行するために外部システムと連携できるようにするコードです。Function calling を参照してください。 + システムがモデルの知識や範囲外でアクションまたはアクションの集合を実行するために、外部システムとやり取りできるようにするコードです。Function calling を参照してください。 @@ -385,45 +386,45 @@ Top-P は、モデルが出力するトークンを選択する方法を変更 - 関数のパラメータの JSON スキーマ + 関数パラメータの JSON スキーマ - true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に失効します。 + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間で失効します。 - ビデオ入力の場合、Duration 形式でビデオの開始オフセットと終了オフセットを指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。このメタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 + ビデオ入力の場合、Duration 形式でビデオの開始と終了のオフセットを指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 - ビデオのタイムライン位置に対する再生時間オフセットを表します。 + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 - ナノ秒精度の符号付き秒の小数部分です。小数部分を持つ負の秒の値でも、nanos の値は非負でなければなりません。 + ナノ秒解像度での秒の小数部(符号付き)。小数部を持つ負の秒値であっても、nanos 値は非負である必要があります。 範囲: `0` から `999999999` - 時間幅の符号付き秒です。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の秒(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 範囲: `-315576000000` から `315576000000` - ビデオのタイムライン位置に対する再生時間オフセットを表します。 + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 - ナノ秒精度の符号付き秒の小数部分です。小数部分を持つ負の秒の値でも、nanos の値は非負でなければなりません。 + ナノ秒解像度での秒の小数部(符号付き)。小数部を持つ負の秒値であっても、nanos 値は非負である必要があります。 範囲: `0` から `999999999` - 時間幅の符号付き秒です。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の秒(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 範囲: `-315576000000` から `315576000000` @@ -473,7 +474,7 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - モデルとの現在の会話のコンテンツです。単一ターンのクエリでは、これは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツ。単一ターンのクエリでは、これは単一のインスタンスです。マルチターンのクエリでは、これは会話履歴と最新のリクエストを含む繰り返しフィールドです。 @@ -489,29 +490,29 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini の audio と video の要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生のバイトによるインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ上限: 20MB 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini の audio と video の要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオを読み取る方法です。固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。省略した場合は、デフォルトの固定レートサンプリングが使用されます。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るか。固定レートのフレームサンプリングではなく、モデルに検査するセグメントを決定させるには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -519,7 +520,7 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - このパートがモデルからの思考/推論ステップであることを示します。 + このパートがモデルからの思考/推論ステップであることを示します。 @@ -545,7 +546,7 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - レスポンスが作成されたときのタイムスタンプ。 + レスポンスが作成されたタイムスタンプ。 @@ -569,17 +570,19 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 -取り得る値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + コンテンツが違反する可能性のある安全カテゴリ + + 可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全カテゴリに違反する確率 - 取り得る値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - レスポンスの一意な識別子。 + レスポンスの一意の識別子。 @@ -587,21 +590,21 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - 出力専用。入力のキャッシュ部分(キャッシュされたコンテンツ)に含まれるトークン数。 + 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 - レスポンスに含まれるトークン数。 + レスポンス内のトークン数。 - モダリティ別の候補トークンの内訳。 + 候補トークンのモダリティ別の内訳。 - 入力または出力コンテンツのモダリティの種類。 + 入力または出力コンテンツのモダリティのタイプ。 - 取り得る値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -609,17 +612,17 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - リクエストに含まれるトークン数。cachedContent が設定されている場合でも、これは有効なプロンプト全体のサイズであり、キャッシュされたコンテンツに含まれるトークン数も含まれます。 + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数を含みます。 - モダリティ別のプロンプトトークンの内訳。 + プロンプトトークンのモダリティ別の内訳。 - 入力または出力コンテンツのモダリティの種類。 + 入力または出力コンテンツのモダリティのタイプ。 - 取り得る値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -627,7 +630,7 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - 思考の出力に含まれるトークン数。 + thoughts 出力に含まれるトークン数。 @@ -635,13 +638,13 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - モダリティ別のツール使用プロンプトトークンの内訳。 + ツール使用プロンプトトークンのモダリティ別の内訳。 - 入力または出力コンテンツのモダリティの種類。 + 入力または出力コンテンツのモダリティのタイプ。 - 取り得る値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index e84bfa7eec..cda87c2e0b 100644 --- a/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Gemini 3.1 Flash Lite を使用する" description: "Comfy Router 経由で vertexai/gemini-3.1-flash-lite を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Gemini 3.1 Flash Lite" -translationSourceHash: 52b7530c +translationSourceHash: 1a291975 translationFrom: development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx translationBlockHashes: "_intro": 408e9eae "Quick start": 869398cb - "Schema": 1d473fa3 + "Schema": 2859a2da "Examples": 2ebce337 --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-3.1-flash-lite.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -185,7 +186,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE ### 入力 - モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは1つのインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -201,29 +202,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - data または fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 生バイトのインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト形式のインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコードです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB 形式: `byte` - data または fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングではなく、検査するセグメントをモデルに判断させるには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るかです。固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -231,15 +232,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - このパートがモデルからの思考/推論ステップであることを示します。 + このパートがモデルによる思考/推論のステップであることを示します。 - 指定可能な値: `user`, `model` + 指定可能な値: `user`、`model` - 生成のサンプリング、長さ、出力に関する設定です。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。 + 生成のためのサンプリング、長さ、出力の設定です。すべてのフィールドは省略可能です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外のフィールドはモデル自身の動作に従います。 @@ -247,29 +248,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - 生成済み画像のアスペクト比 + 生成される画像のアスペクト比 - 任意。生成済み画像の画像出力フォーマット。 + 省略可能。生成される画像の出力形式です。 - 任意。出力画像の圧縮品質。 + 省略可能。出力画像の圧縮品質です。 - 任意。出力を保存する画像フォーマットです。対象となるのは Vertex AI の経路、すなわち Comfy 自身の認証情報で処理されるリクエストと、GCP サービスアカウントで認証された BYOK リクエストです。そこで受け入れられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。例外は Google AI Studio の API キーで認証された BYOK リクエストです。その上流にはそのようなプロパティが存在せず、存在する場合は呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力フォーマットは AI Studio が選択したものになります。どの経路でも、送信した値を前提とするのではなく、返されたレスポンスパート(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 + 省略可能。出力を保存する画像形式です。対象は Vertex AI の経路、すなわち Comfy 自身の認証情報で処理されるリクエストと、GCP サービスアカウントで認証される BYOK リクエストです。そこでの許容値は `image/png` と `image/jpeg` で、大文字と小文字は区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証される BYOK リクエストは例外です。その上流にはこのプロパティが存在せず、指定されていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を仮定するのではなく、返された response パート(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 - 任意。生成される画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 + 省略可能。生成される画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 - レスポンスで生成できるトークンの最大数です。1 トークンはおよそ 4 文字です。100 トークンはおよそ 60〜80 語に相当します。 + レスポンスで生成できるトークンの最大数です。1 トークンは約 4 文字です。100 トークンはおよそ 60~80 語に相当します。 - 範囲: `16` から `65536` + 範囲: `16` ~ `65536` @@ -277,7 +278,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - seed を特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じ seed 値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムな seed 値が使用されます。以下のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じシード値を使用しても応答にばらつきが生じることがあります。デフォルトではランダムなシード値が使用されます。以下のモデルで利用できます: gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 @@ -285,7 +286,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - 温度は、応答生成中のサンプリングに使用され、これは topP と topK が適用されるときに発生します。温度はトークン選択におけるランダム性の度合いを制御します。低い温度は、あまり自由奔放でない、あるいは創造的な応答を必要としないプロンプトに適しており、高い温度はより多様な、あるいは創造的な結果につながります。温度が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ確定的ですが、わずかな変動は依然として起こり得ます。モデルが返す応答が一般的すぎる、短すぎる、またはモデルがフォールバック応答を返す場合は、温度を上げてみてください。 + temperature は応答の生成中にサンプリングに使用され、topP と topK が適用されるときに機能します。temperature はトークン選択のランダム性の度合いを制御します。低い temperature は、自由度や創造性の低い応答が求められるプロンプトに適しており、高い temperature はより多様または創造的な結果につながる可能性があります。temperature が 0 の場合、最も確率の高いトークンが常に選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、少量のばらつきは依然として発生する可能性があります。モデルが返す応答が一般的すぎる場合、短すぎる場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください。 範囲: `0` から `2` @@ -293,33 +294,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。 + オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解し、品質の高い応答を生成するプロセスです。 - オプション。true の場合、モデルは自身の思考を応答に含めます。 + オプション。true の場合、モデルは応答に自身の思考を含めます。 - オプション。モデルの思考プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + オプション。モデルの thinking プロセスのトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 - オプション。モデルの思考レベルです。 + オプション。モデルの thinking レベルです。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` - Top-K は、モデルが出力のためにトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率が高いものになります。Top-K が 3 の場合、次のトークンは、温度を用いて最も確率の高い 3 つのトークンの中から選択されます。 + Top-K は、モデルが出力用のトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙全体の中で最も確率の高いものになります。top-K が 3 の場合、次に選択されるトークンは、temperature を使用して確率の高い上位 3 個のトークンの中から選択されます。 範囲: `1` から `…` 指定した場合、nucleus サンプリングが使用されます。 -Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、最も確率の高いもの(top-K を参照)から最も低いものへと、その確率の合計が top-P の値に等しくなるまで選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは温度を用いて A または B のいずれかを次のトークンとして選択し、C は候補から除外します。 -よりランダム性の低い応答には低い値を、よりランダム性の高い応答には高い値を指定してください。 +Top-P は、モデルが出力用のトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率の高いもの(top-K を参照)から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外します。 +ランダム性を抑えたい場合は低い値を、ランダム性を高めたい場合は高い値を指定してください。 範囲: `0` から `1` @@ -327,37 +328,37 @@ Top-P は、モデルが出力のためにトークンを選択する方法を - 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に対して適用されます。 + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に適用されます。 - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + 指定可能な値: `OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` - モデルをより良い性能へと導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルの性能には影響しません。注: parts にはテキストのみを使用し、各 part のコンテンツは別々の段落にしてください。 + モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part のコンテンツは別々の段落にしてください。 - 1 つのメッセージを構成する、順序付けられた part のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数など入力の制限については、Google モデルページのモデル仕様を参照してください。 + 単一のメッセージを構成する順序付けられた part のリストです。part ごとに異なる IANA MIME タイプを持つことができます。トークンの最大数や画像の数などの入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 - テキストプロンプトまたはコードスニペット。 + テキストプロンプトまたはコードスニペットです。 - メッセージを作成するエンティティの識別情報です。次の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターン会話の中でモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空のままにするか、未設定にできます。 + メッセージを作成するエンティティの識別子です。次の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターン会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空のままにするか、未設定にできます。 - 指定可能な値: `user`, `model` + 指定可能な値: `user`、`model` - システムがモデルの知識や範囲の外にあるアクションまたはアクション群を実行するために、外部システムとやり取りできるようにするコードです。Function calling を参照してください。 + システムがモデルの知識と範囲外でアクションまたは一連のアクションを実行するために、外部システムと連携できるようにするコードの断片です。Function calling を参照してください。 @@ -373,50 +374,50 @@ Top-P は、モデルが出力のためにトークンを選択する方法を - 関数パラメータの JSON スキーマ + 関数パラメータ用の JSON スキーマ - true の場合、生成済み画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に失効します。 + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に失効します。 - ビデオ入力の場合、Duration 形式でのビデオの開始オフセットと終了オフセット。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。このメタデータは、ビデオデータが inlineData または fileData で提示されている間のみ指定してください。 + ビデオ入力の場合、ビデオの開始オフセットと終了オフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。このメタデータは、ビデオデータが inlineData または fileData で指定されている場合にのみ指定してください。 - ビデオタイムライン位置の再生時間オフセットを表します。 + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 - ナノ秒解像度での秒の符号付き小数部。小数部を持つ負の秒値であっても、nanos 値は非負でなければなりません。 + ナノ秒精度での秒の小数部(符号付き)。小数部を持つ負の秒値であっても、nanos の値は非負でなければなりません。 範囲: `0` から `999999999` - 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の秒数(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 範囲: `-315576000000` から `315576000000` - ビデオタイムライン位置の再生時間オフセットを表します。 + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 - ナノ秒解像度での秒の符号付き小数部。小数部を持つ負の秒値であっても、nanos 値は非負でなければなりません。 + ナノ秒精度での秒の小数部(符号付き)。小数部を持つ負の秒値であっても、nanos の値は非負でなければなりません。 範囲: `0` から `999999999` - 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の秒数(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 範囲: `-315576000000` から `315576000000` -Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。 +`GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しの検証に使用されるものと同じドキュメントです。 ### 出力 @@ -477,29 +478,29 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル (音声なし) の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ (mimeType) も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、そのデータのメディアタイプ (mimeType) も指定する必要があります。サイズ制限: 20MB 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル (音声なし) の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - モデルがこのパートのビデオを読み取る方法。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、検査するセグメントをモデルが判断します。省略した場合はデフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るか。固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -507,11 +508,11 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - このパートがモデルからの思考/推論ステップであることを示します。 + このパートがモデルによる思考/推論のステップであることを示します。 - 指定可能な値: `user`, `model` + 指定可能な値: `user`、`model` @@ -523,21 +524,21 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - コンテンツが指定された安全カテゴリに違反する確率 + コンテンツが指定された安全性カテゴリに違反する確率 - 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` - 応答が作成されたタイムスタンプ。 + レスポンスが作成されたタイムスタンプ。 - 応答の生成に使用されたモデルのバージョン。 + レスポンスの生成に使用されたモデルのバージョン。 @@ -561,13 +562,13 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - コンテンツが指定された安全カテゴリに違反する確率 + コンテンツが指定された安全性カテゴリに違反する確率 - 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - レスポンスの一意の識別子。 + レスポンスの一意な識別子。 @@ -575,7 +576,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - 出力専用。入力内のキャッシュ部分(キャッシュされたコンテンツ)のトークン数。 + 出力のみ。入力のキャッシュ部分 (キャッシュされたコンテンツ) のトークン数。 @@ -583,13 +584,13 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - モダリティごとの候補トークンの内訳。 + 候補トークンのモダリティ別の内訳。 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -597,17 +598,17 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトサイズの合計であり、キャッシュされたコンテンツ内のトークン数も含まれます。 + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプト全体のサイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 - モダリティごとのプロンプトトークンの内訳。 + プロンプトトークンのモダリティ別の内訳。 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -615,7 +616,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - thoughts 出力に含まれるトークン数。 + 思考出力に含まれるトークン数。 @@ -623,13 +624,13 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - モダリティごとのツール使用プロンプトトークンの内訳。 + ツール使用プロンプトのトークンのモダリティ別の内訳。 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -637,11 +638,11 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` で提 - トークンの合計数(プロンプト + 候補)。 + トークンの合計数 (プロンプト + 候補)。 - リクエストに使用されたトラフィックタイプ(例: PROVISIONED_THROUGHPUT)。 + リクエストに使用されたトラフィックの種類 (例: PROVISIONED_THROUGHPUT)。 ## 例 diff --git a/ja/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/ja/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index 48557f2d15..623579ca35 100644 --- a/ja/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -2,18 +2,19 @@ title: "Comfy Router で Gemini 3.7 Flash を使う" description: "Comfy Router 経由で vertexai/gemini-3.7-flash を呼び出します: endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Gemini 3.7 Flash" -translationSourceHash: a5b78a88 +translationSourceHash: 059b025e translationFrom: development/comfy-router/models/google/gemini-3-7-flash/code.mdx translationBlockHashes: "_intro": 8eab9a58 "Quick start": b4872308 - "Schema": b5f16a3c + "Schema": cc4c8104 "Examples": 1da8dd0c --- + {/* 生成済みファイル。`router-schemas/vertexai/gemini-3.7-flash.json` から `pnpm code-pages:gen` により生成。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -186,7 +187,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST ### 入力 - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツ。単一ターンのクエリでは1つのインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -194,7 +195,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - URI ベースのデータ。 + URIベースのデータ。 @@ -202,29 +203,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + dataフィールドまたはfileUriフィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は8.4時間、ビデオファイル(音声なし)の最大長は1時間です。詳細は Gemini のオーディオとビデオの要件を参照してください。テキストファイルはUTF-8でエンコードされている必要があります。テキストファイルのコンテンツはトークン上限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイトデータとしてのインラインデータ。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使って最大3000枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、そのデータのメディアタイプ(mimeType)も指定する必要があります。サイズ上限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオのbase64エンコーディング。メディアをインラインで含める場合は、そのデータのメディアタイプ(mimeType)も指定する必要があります。サイズ上限: 20MB 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + dataフィールドまたはfileUriフィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は8.4時間、ビデオファイル(音声なし)の最大長は1時間です。詳細は Gemini のオーディオとビデオの要件を参照してください。テキストファイルはUTF-8でエンコードされている必要があります。テキストファイルのコンテンツはトークン上限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオをどのように読み取るか。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、検査するセグメントをモデルが判断します。省略すると、既定の固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るか。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定します。省略すると、既定の固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -240,19 +241,19 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 生成のサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にそれが適用され、それ以外はモデル自身の動作に従います。 + 生成のためのサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下のフィールドのうち `default` を宣言しているものは省略時にその値が適用され、それ以外はモデル自体の動作に従います。 - 画像生成の構成 + 画像生成の設定 - 生成される画像のアスペクト比 + 生成画像のアスペクト比 - 任意。生成される画像の画像出力形式。 + 任意。生成画像の出力形式。 @@ -260,17 +261,17 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 任意。出力を保存する画像形式。Vertex AI の経路、すなわち Comfy 自身の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエストで使用されます。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字へ正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時の既定値は `image/png` です。例外は Google AI Studio の API キーで認証された BYOK リクエストです。その上流にはそのようなプロパティが存在せず、指定されていると呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を前提とせず、与えられたレスポンスのパート(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み戻してください。 + 任意。出力を保存する画像形式(Vertex AI のパス上): Comfy 自身の認証情報で処理されるリクエストと、GCP サービスアカウントで認証された BYOK リクエストです。そこでの許容値は `image/png` と `image/jpeg` で、大文字と小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした400エラーで拒否されます。省略時は `image/png` が既定値です。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。その上流にはこのプロパティが存在せず、含まれていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択するものになります。どのパスでも、送信した値を仮定せず、返されたレスポンスパート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み戻してください。 - 任意。生成される画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルは既定値の 1K を使用します。 + 任意。生成画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルは既定値の 1K を使用します。 - レスポンスで生成できるトークンの最大数。1 トークンはおよそ 4 文字です。100 トークンはおよそ 60~80 語に相当します。 + レスポンスで生成できるトークンの最大数。1トークンは約4文字です。100トークンはおよそ60〜80語に相当します。 - 範囲: `16` ~ `65536` + 範囲: `16` から `65536` @@ -278,7 +279,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用しても応答が変動することがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すようベストエフォートで動作します。決定論的な出力は保証されません。また、temperature などのモデルやパラメータの設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用可能です: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -286,9 +287,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - temperature は応答生成中のサンプリングに使用され、これは topP と topK が適用されるときに発生します。temperature はトークン選択のランダム性の度合いを制御します。低い temperature は、より限定的または創造的でない応答が求められるプロンプトに適しており、高い temperature はより多様で創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定的ですが、わずかな変動は依然として起こり得ます。モデルが一般的すぎる応答や短すぎる応答を返す場合、またはフォールバック応答を返す場合は、temperature を上げてみてください + temperature は応答の生成中にサンプリングに使用され、これは topP と topK が適用されるときに行われます。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由闊達でない応答や創造性の低い応答が求められるプロンプトに適しており、高い temperature はより多様な結果や創造的な結果につながる可能性があります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、少量のばらつきが生じる可能性は依然としてあります。モデルが返す応答が一般的すぎる場合、短すぎる場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください。 - 範囲: `0` ~ `2` + 範囲: `0` から `2` 形式: `float` @@ -298,37 +299,37 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - オプション。true の場合、モデルは応答に自身の思考を含めます。 + オプション。true の場合、モデルは自身の思考を応答に含めます。 - オプション。モデルの思考プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + オプション。モデルの思考プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるようベストエフォートで動作します。 オプション。モデルの思考レベルです。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - top-K はモデルが出力用のトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率が高いものになります。top-K が 3 の場合、次に選択されるトークンは、temperature を用いて確率上位 3 個のトークンの中から選択されます。 + Top-K は、モデルが出力用のトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率が高いものになります。Top-K が 3 の場合、次に選択されるトークンは、temperature を使用して確率の高い上位 3 個のトークンの中から選択されます。 - 範囲: `1` ~ `…` + 範囲: `1` から `…` - 指定した場合、ニュークリアスサンプリングが使用されます。 -top-P はモデルが出力用のトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率の高いもの(top-K を参照)から低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を用いて A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 -よりランダム性の低い応答には低い値、よりランダム性の高い応答には高い値を指定します。 + 指定した場合、nucleus サンプリングが使用されます。 +Top-P は、モデルが出力用のトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率が高いもの(top-K を参照)から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 +ランダム性の低い応答には低い値を、ランダム性の高い応答には高い値を指定してください。 - 範囲: `0` ~ `1` + 範囲: `0` から `1` 形式: `float` - 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に適用されます。 + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に対して適用されます。 @@ -340,11 +341,11 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に回答してください」「回答に専門用語を使わないでください」などです。テキスト文字列はトークン制限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part の内容は別々の段落にしてください。 + モデルをより良いパフォーマンスへ導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン制限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各パートのコンテンツは別々の段落にしてください。 - 1 つのメッセージを構成する順序付けられた parts のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数などの入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + 単一のメッセージを構成する、順序付けされたパートのリストです。パートごとに異なる IANA MIME タイプを持つ場合があります。トークンの最大数や画像の数などの入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 @@ -352,13 +353,13 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - メッセージを作成するエンティティの識別情報です。以下の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空のままにするか、未設定にできます。 + メッセージを作成するエンティティの識別情報です。次の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。 model: メッセージがモデルによって生成されたことを示します。model 値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白のままにするか未設定にできます。 指定可能な値: `user`, `model` - システムがモデルの知識や範囲外のアクション、またはアクション群を実行するために外部システムとやり取りできるようにするコードです。Function calling を参照してください。 + システムがモデルの知識や範囲の外でアクションまたは一連のアクションを実行するために、外部システムとやり取りできるようにするコードです。Function calling を参照してください。 @@ -378,46 +379,46 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 + true の場合、生成済み画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に失効します。 - ビデオ入力の場合、ビデオの開始と終了のオフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 }、"endOffset": \{ "seconds": 70 } を設定します。このメタデータは、ビデオデータが inlineData または fileData で渡されている場合にのみ指定してください。 + ビデオ入力の場合、ビデオの開始オフセットと終了オフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で渡されている場合にのみ指定してください。 - ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + ビデオタイムライン上の位置に対する再生時間オフセットを表します。 - ナノ秒単位の符号付き秒の端数。端数を伴う負の秒の値でも、nanos の値は負でない値である必要があります。 + ナノ秒精度の秒の小数部分(符号付き)。小数部を持つ負の秒値であっても、nanos 値は非負でなければなりません。 範囲: `0` から `999999999` まで - 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲である必要があります。 + 時間幅の秒部分(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲で指定する必要があります。 範囲: `-315576000000` から `315576000000` まで - ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + ビデオタイムライン上の位置に対する再生時間オフセットを表します。 - ナノ秒単位の符号付き秒の端数。端数を伴う負の秒の値でも、nanos の値は負でない値である必要があります。 + ナノ秒精度の秒の小数部分(符号付き)。小数部を持つ負の秒値であっても、nanos 値は非負でなければなりません。 範囲: `0` から `999999999` まで - 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲である必要があります。 + 時間幅の秒部分(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲で指定する必要があります。 範囲: `-315576000000` から `315576000000` まで -`GET /v2/models/vertexai/gemini-3.7-flash/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。 +これは、Router が `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json` で配信するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 @@ -446,7 +447,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - フォーマット: `date` + 形式: `date` @@ -462,7 +463,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは、これは単一のインスタンスです。マルチターンのクエリでは、これは会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -478,29 +479,29 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細は Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度には制限がありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト列によるインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ上限: 20MB - フォーマット: `byte` + 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細は Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度には制限がありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオを読み取る方法。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、検査するセグメントをモデルが判断できるようになります。省略した場合は、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオを読み取る方法。固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -508,7 +509,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - このパートがモデルによる思考/推論のステップであることを示します。 + このパートがモデルからの思考/推論ステップであることを示します。 @@ -528,7 +529,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - コンテンツが指定された安全カテゴリに違反する確率 + コンテンツが指定された安全性カテゴリに違反する確率 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -562,9 +563,9 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - コンテンツが指定された安全カテゴリに違反している確率 + コンテンツが指定された安全性カテゴリに違反する確率 - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -576,7 +577,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - 出力のみ。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 + 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 @@ -590,7 +591,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -598,7 +599,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは実効的なプロンプト全体のサイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 @@ -608,7 +609,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -616,7 +617,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し - 思考の出力に含まれるトークン数。 + thoughts 出力に含まれるトークン数。 @@ -630,7 +631,7 @@ top-P はモデルが出力用のトークンを選択する方法を変更し 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/ja/development/comfy-router/models/google/gemini-3-8-flash/code.mdx b/ja/development/comfy-router/models/google/gemini-3-8-flash/code.mdx index 1e61214b08..b4fb55e650 100644 --- a/ja/development/comfy-router/models/google/gemini-3-8-flash/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-3-8-flash/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Gemini 3.8 Flash を使う" description: "Comfy Router 経由で vertexai/gemini-3.8-flash を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Gemini 3.8 Flash" -translationSourceHash: 723f1618 +translationSourceHash: aec8f1da translationFrom: development/comfy-router/models/google/gemini-3-8-flash/code.mdx translationBlockHashes: "_intro": c76d5ed4 "Quick start": e986a155 - "Schema": e5173b06 + "Schema": ab7655e4 "Examples": 48b9d5db --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/vertexai/gemini-3.8-flash.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -185,7 +186,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST ### 入力 - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -201,29 +202,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン上限にカウントされます。画像の解像度には制限がありません。 - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 生のバイトによるインラインデータ。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ上限: 20MB - フォーマット: `byte` + 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン上限にカウントされます。画像の解像度には制限がありません。 - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - モデルがこのパートのビデオをどのように読み取るか。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るか。固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -231,7 +232,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - このパートがモデルによる思考/推論のステップであることを示します。 + このパートがモデルからの思考/推論ステップであることを示します。 @@ -239,7 +240,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 生成のためのサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にそれが適用され、それ以外のフィールドはモデル自身の動作にフォールバックします。 + 生成のためのサンプリング、長さ、出力の設定です。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作に従います。 @@ -251,7 +252,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 任意。生成される画像の画像出力フォーマット。 + 任意。生成される画像の出力形式。 @@ -259,7 +260,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 任意。出力を保存する画像フォーマット。Vertex AI のパス、すなわち Comfy 独自の認証情報で処理されるリクエストと、GCP サービスアカウントで認証される BYOK リクエストで使用されます。そこでの許容値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証される BYOK リクエストは例外です。その上流にはそのようなプロパティが存在せず、指定されていると呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力フォーマットは AI Studio が選択したものになります。どのパスでも、送信した値を前提とせず、返されたレスポンスパート(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 + 任意。出力を保存する画像形式です。これは Vertex AI の経路、すなわち Comfy 自身の認証情報で処理されるリクエストと、GCP サービスアカウントで認証される BYOK リクエストに適用されます。そこでの指定可能な値は `image/png` と `image/jpeg` で、大文字と小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値はこのフィールドを示す 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証される BYOK リクエストは例外です。その上流にはこのプロパティが存在せず、含まれていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を前提とせず、返されたレスポンスパート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 @@ -267,7 +268,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおよそ 60~80 語に相当します。 + レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおよそ 60〜80 語に相当します。 範囲: `16` から `65536` @@ -277,7 +278,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - seed を特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じ seed 値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムな seed 値が使用されます。以下のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用可能です: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -285,7 +286,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - temperature は応答生成中のサンプリングに使用され、topP と topK が適用されるときに機能します。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由すぎない、または創造的でない応答を必要とするプロンプトに適しており、高い temperature はより多様で創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定的になりますが、ごくわずかなばらつきが生じる可能性は残ります。モデルが一般的すぎる応答や短すぎる応答を返す場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください + temperature は、topP と topK が適用される応答生成中のサンプリングに使用されます。temperature は、トークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由度が高くない応答や創造的な応答が求められるプロンプトに適しており、高い temperature は、より多様な結果や創造的な結果につながる可能性があります。temperature が 0 の場合、最も確率の高いトークンが常に選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、少量のばらつきは依然として発生する可能性があります。モデルが一般的すぎる応答や短すぎる応答を返す場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください 範囲: `0` から `2` @@ -293,33 +294,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。 + 任意。思考機能の設定です。思考とは、モデルが複雑なタスクを小さなステップに分解して、より高品質な応答を生成するプロセスです。 - オプション。true の場合、モデルは自身の思考を応答に含めます。 + 任意。true の場合、モデルは応答に自身の思考を含めます。 - オプション。モデルの思考プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + 任意。モデルの思考プロセスに使用するトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 - オプション。モデルの thinking レベルです。 + 任意。モデルの思考レベルです。 - 使用可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K は、モデルが出力するトークンをどのように選択するかを変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率の高いものになります。top-K が 3 の場合、temperature を使用して、最も確率の高い 3 つのトークンの中から次のトークンが選択されます。 + Top-K は、モデルが出力用のトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率が高いものになります。top-K が 3 の場合、temperature を使用して、次に選択されるトークンを確率が高い上位 3 つのトークンから選択します。 範囲: `1` から `…` 指定した場合、nucleus サンプリングが使用されます。 -Top-P は、モデルが出力するトークンをどのように選択するかを変更します。トークンは、その確率の合計が top-P の値に達するまで、最も確率の高いもの (top-K を参照) から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 -ランダム性の低い応答には低い値を、ランダム性の高い応答には高い値を指定してください。 +Top-P は、モデルが出力用のトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、確率が最も高いもの(top-K を参照)から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C を候補から除外します。 +ランダム性の低い応答には低い値を、ランダム性の高い応答には高い値を指定します。 範囲: `0` から `1` @@ -327,23 +328,23 @@ Top-P は、モデルが出力するトークンをどのように選択する - 安全でないコンテンツをブロックするためのリクエストごとの設定。GenerateContentResponse.candidates に対して適用されます。 + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に対して適用されます。 - 使用可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - 使用可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + 可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` - モデルをより良いパフォーマンスへ導くための指示。たとえば「できるだけ簡潔に回答してください」や「回答で専門用語を使用しないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part のコンテンツは別々の段落にしてください。 + モデルをより良いパフォーマンスに導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「応答で専門用語を使用しないでください」などです。テキスト文字列はトークン制限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part のコンテンツは別々の段落にしてください。 - 1 つのメッセージを構成する順序付けられた parts のリスト。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数などの入力の上限については、Google のモデルページにあるモデル仕様を参照してください。 + 単一のメッセージを構成する順序付けられた parts のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数など、入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 @@ -351,13 +352,13 @@ Top-P は、モデルが出力するトークンをどのように選択する - メッセージを作成するエンティティの識別情報。次の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model 値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空欄または未設定のままにできます。 + メッセージを作成するエンティティの識別情報です。次の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model 値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白のままにするか、未設定にできます。 - 使用可能な値: `user`, `model` + 可能な値: `user`, `model` - モデルの知識と範囲の外でアクションまたはアクションのセットを実行するために、システムが外部システムと連携できるようにするコード。Function calling を参照してください。 + モデルの知識と範囲の外でアクションまたは一連のアクションを実行するために、システムが外部システムとやり取りできるようにするコードの断片です。Function calling を参照してください。 @@ -373,50 +374,50 @@ Top-P は、モデルが出力するトークンをどのように選択する - 関数のパラメータの JSON スキーマ + 関数パラメータの JSON スキーマ - true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 + true の場合、生成済み画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 - ビデオ入力の場合、ビデオの開始と終了のオフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 + ビデオ入力の場合、Duration 形式でビデオの開始オフセットと終了オフセットを指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提供されている場合にのみ指定してください。 - ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + ビデオタイムライン上の位置に対する Duration オフセットを表します。 - ナノ秒解像度での秒の符号付き小数部。小数を含む負の秒の値であっても、nanos の値は非負でなければなりません。 + ナノ秒単位の秒の小数部分(符号付き)。小数を含む負の秒値でも、nanos 値は非負でなければなりません。 - 範囲: `0` ~ `999999999` + 範囲: `0` から `999999999` - 期間の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 期間の秒数(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 - 範囲: `-315576000000` ~ `315576000000` + 範囲: `-315576000000` から `315576000000` - ビデオのタイムライン位置に対する再生時間のオフセットを表します。 + ビデオタイムライン上の位置に対する Duration オフセットを表します。 - ナノ秒解像度での秒の符号付き小数部。小数を含む負の秒の値であっても、nanos の値は非負でなければなりません。 + ナノ秒単位の秒の小数部分(符号付き)。小数を含む負の秒値でも、nanos 値は非負でなければなりません。 - 範囲: `0` ~ `999999999` + 範囲: `0` から `999999999` - 期間の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 期間の秒数(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 - 範囲: `-315576000000` ~ `315576000000` + 範囲: `-315576000000` から `315576000000` -これは Router が `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json` で提供するスキーマから生成されたものです。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に照合するドキュメントと同じものです。 +このスキーマは、Router が `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる同じドキュメントです。 ### 出力 @@ -445,7 +446,7 @@ Top-P は、モデルが出力するトークンをどのように選択する - Format: `date` + 形式: `date` @@ -461,7 +462,7 @@ Top-P は、モデルが出力するトークンをどのように選択する - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -477,29 +478,29 @@ Top-P は、モデルが出力するトークンをどのように選択する - data または fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。使用可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細は Gemini のオーディオおよびビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 使用可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト形式のインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB - Format: `byte` + 形式: `byte` - data または fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。使用可能な値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細は Gemini のオーディオおよびビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 使用可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - モデルがこのパートのビデオを読み取る方法。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定します。省略した場合はデフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断できるようにするには、"AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -507,11 +508,11 @@ Top-P は、モデルが出力するトークンをどのように選択する - このパートがモデルによる思考/推論ステップであることを示します。 + このパートがモデルからの思考/推論ステップであることを示します。 - Possible values: `user`, `model` + 使用可能な値: `user`、`model` @@ -523,13 +524,13 @@ Top-P は、モデルが出力するトークンをどのように選択する - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 使用可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全性カテゴリに違反する確率 - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 使用可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -537,7 +538,7 @@ Top-P は、モデルが出力するトークンをどのように選択する - レスポンスの生成に使用されたモデルバージョン。 + レスポンスの生成に使用されたモデルのバージョン。 @@ -557,17 +558,19 @@ Top-P は、モデルが出力するトークンをどのように選択する - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + コンテンツが違反する可能性がある安全性カテゴリ + + 可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全性カテゴリに違反する確率 - 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - レスポンスの一意な識別子。 + レスポンスの一意の識別子。 @@ -575,11 +578,11 @@ Top-P は、モデルが出力するトークンをどのように選択する - 出力のみ。入力のキャッシュ部分(キャッシュされたコンテンツ)に含まれるトークン数。 + 出力専用。入力のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 - レスポンスに含まれるトークン数。 + レスポンス内のトークン数。 @@ -589,7 +592,7 @@ Top-P は、モデルが出力するトークンをどのように選択する 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -597,7 +600,7 @@ Top-P は、モデルが出力するトークンをどのように選択する - リクエストに含まれるトークン数。cachedContent が設定されている場合でも、これは有効なプロンプト全体のサイズであり、キャッシュされたコンテンツのトークン数も含まれます。 + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの総サイズであり、キャッシュされたコンテンツ内のトークン数も含みます。 @@ -607,7 +610,7 @@ Top-P は、モデルが出力するトークンをどのように選択する 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -615,7 +618,7 @@ Top-P は、モデルが出力するトークンをどのように選択する - 思考の出力に含まれるトークン数。 + thoughts 出力に含まれるトークン数。 @@ -629,7 +632,7 @@ Top-P は、モデルが出力するトークンをどのように選択する 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -637,11 +640,11 @@ Top-P は、モデルが出力するトークンをどのように選択する - トークンの総数(プロンプト + 候補)。 + トークンの合計数(プロンプト + 候補)。 - リクエストに使用されたトラフィックの種類(例: PROVISIONED_THROUGHPUT)。 + リクエストに使用されたトラフィックタイプ(例: PROVISIONED_THROUGHPUT)。 ## 例 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 5e4f4ada58..1c22d633f3 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Dreamina Seedance 2.0 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-260128을 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: a3a29c99 +translationSourceHash: 63aaaa35 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 - "Serving providers": 74eb2a7c - "Schema": 9c7c68b7 + "Serving providers": 6d20a079 + "Schema": 3b5d80d0 "Examples": 641c458b --- @@ -17,6 +17,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -187,6 +188,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque - **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` - **Higgsfield**, `higgsfield/higgsfield-seedance-2.0` 이름으로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=higgsfield` +- **Kelly**, `kelly/kelly-seedance-2.0` 이름으로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=kelly` - **Pika**, `pika/pika-seedance-2.0` 이름으로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=pika` - **Runware**, `runware/runware-seedance-2.0` 이름으로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=runware` - **WaveSpeed**, `wavespeed/wavespeed-seedance-2.0` 이름으로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=wavespeed` @@ -198,33 +200,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전혀 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다 + 모델이 비디오를 생성하기 위한 입력 콘텐츠 - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 Asset ID. -오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. -Base64: 형식 data:audio/\;base64,\ -Asset ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL입니다(wav, mp3). +Base64: 형식은 data:audio/\;base64,\입니다. +에셋 ID: 형식은 asset://\입니다. Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 4k를 포함한 최종 출력 등급에 대한 해상도는 이 요청에서 설정하세요. 생략하면 최종 결과는 1080p입니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 결과의 출력 등급(4k 포함)은 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 만들 때 반환된 작업 ID입니다. + Draft 비디오를 `draft`를 true로 설정하여 생성했을 때 반환된 작업 ID입니다. @@ -235,24 +237,24 @@ Asset ID: 형식 asset://\ 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -Asset ID: 형식 asset://\ +에셋 ID: 형식은 asset://\입니다. 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image입니다. +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델을 위한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용해 생성할 비디오를 설명합니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자로 생성할 비디오를 설명합니다. -파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[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) @@ -261,20 +263,17 @@ Asset ID: 형식 asset://\ - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" +예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 -공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 -문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. -이 제한은 요청 전체가 아니라 이 필드 하나만 제한합니다: `content`는 배열이며, -요청당 본문 제한이 전체 문서를 제한합니다. 이를 적용하는 표면은 -Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출하면 -대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 -실제 프롬프트를 판정하는 일이 없습니다. 호출자가 더 필요하면 값을 올리세요. +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않았고, 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로, 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 값은 요청이 아니라 이 필드 하나만 제한합니다. +`content`는 배열이며, 문서 전체를 제한하는 것은 요청당 본문 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있어 +실제 프롬프트를 판정하는 일은 없습니다. 호출자에게 더 필요하면 값을 올리세요. - 입력 콘텐츠의 유형입니다 + 입력 콘텐츠의 유형 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -284,50 +283,59 @@ Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출하 - 비디오 URL 또는 Asset ID. -비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. -Asset ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL입니다(mp4, mov). +에셋 ID: 형식은 asset://\입니다. Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청에서 4k를 포함한 최종 해상도를 설정합니다. 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청에서 최종 결과의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(auto). + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 작업 시간 초과 임계값(초)입니다. 기본값 172800(48h). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 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 호출자는 이를 생략합니다. + + + + Seedance 2.5 전용입니다. 참조 미디어가 사용되는 작업입니다. 생략하면 auto를 의미합니다. 모델이 프롬프트와 참조 미디어로부터 작업을 추론하며, 그 해석과 충돌하는 설정(예: 편집으로 해석한 대상에 대한 `duration` 또는 `ratio`)은 생성이 시작된 이후에야 처리되며 이는 과금됩니다. +reference: 참조 이미지, 비디오, 오디오를 바탕으로 요청한 `duration`의 새 비디오를 생성합니다. +edit: 연결된 참조 비디오를 변경합니다. 출력은 소스 클립 자체의 길이와 가로세로 비율을 유지하므로 `duration: -1`을 보내고 `ratio`는 생략하세요(또는 `adaptive`를 보내세요). +extend: 참조 비디오를 이어갑니다. 출력은 요청한 `duration`의 새로 생성된 구간만이며, 가로세로 비율은 클립을 따릅니다. +명시적인 값은 제출 시 공급자가 검증하므로(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), 요청에 맞지 않는 값은 생성이 시작되기 전에 실패하며 과금되지 않습니다. auto에는 그러한 검사가 없습니다. 이 검사는 네이티브 BytePlus 구간에서만 실행됩니다. 대체 공급자 구간(폴백 시 또는 `model_provider`로 선택한 경우)에는 작업 유형 필드가 없어 값을 버리며, 해당 공급자는 auto와 마찬가지로 스스로 작업을 추론합니다. 값이 버려졌다는 사실은 동기 실행 경로의 응답과 대기 중 제출의 `201`에 있는 `X-Comfy-Router-Dropped-Params`에 표시됩니다. 대기 중 경로에는 폴백이 없으므로 `model_provider`를 통해서만 대체 구간에 도달합니다. + + 가능한 값: `reference`, `edit`, `extend` Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mp4: 폭넓은 호환성과 더 작은 파일 크기를 갖춘 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 높은 색상 정밀도를 갖춘 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 후반 작업에 적합하며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 가로세로 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 가로세로 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용됩니다. 구체적인 비율은 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` @@ -341,7 +349,7 @@ Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 뒤 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 일치하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되어 여러 개의 연속 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -361,38 +369,38 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 에서 Router가 제공하는 스키마로 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에서 제공하는 스키마, 즉 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서에서 생성되었습니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy storage에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서에서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 RE-HOSTED되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable - BytePlus는 작업 24시간 후 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정하고, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy storage에 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하십시오. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으므로 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 보통 이를 `content`의 최상위 형제 필드로 반환하며, 최상위 `output_format` 필드를 참조하십시오. Router는 둘 중 존재하는 것을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. URL 자체가 가진 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 존재할 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시간으로, URL 자체가 지닌 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시간을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 없어지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다: 옵트인한 워크스페이스 전용, Seedance 2.x 전용, BytePlus가 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외 모든 경우에는 없습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 없어집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 1회를 Router 자체 재호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외 모든 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 24시간 후 URL을 지우면 사라집니다. 이는 미리 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 누구든 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 취급하십시오. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 하나를 Router 자체 재호스팅이 소비합니다. - 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy storage에 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 다시 호스팅하고 이 필드를 재작성하므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간에 불과한 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하십시오. @@ -400,7 +408,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 생성된 비디오의 재생 시간(초)입니다. 정수가 아닌 숫자로 선언된 이유는 BytePlus가 이 부분에서 일관되지 않기 때문입니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 같은 BytePlus의 다른 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이에 대해 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 같은 BytePlus의 다른 표면은 소수 재생 시간을 보고하므로 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -408,7 +416,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열이며, 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected 및 OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열은 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유를 가질 수 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -416,47 +424,45 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 작업의 ID - - 작업에서 사용한 모델의 이름과 버전 + 작업에서 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(`mp4` 또는 `mov`)으로, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에 값을 반환합니다. BytePlus 자체 필드이며 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(`mp4` 또는 `mov`)으로, `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 해당 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 그대로 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. - 해당 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. 형식: `int64` - 작업의 상태입니다. + 작업의 상태 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 마지막 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 요청의 토큰 사용량입니다. + 요청의 토큰 사용량 - 모델이 생성한 토큰 수입니다. + 모델이 생성한 토큰 수 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index a75c8e7533..5808a82d73 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,13 @@ title: "Comfy Router로 Dreamina Seedance 2.0 Fast 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-fast-260128을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: 506a7f86 +translationSourceHash: fd645dad translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": 48fe2811 + "Serving providers": dfa238a4 + "Schema": bb84c022 "Examples": 7714eccd --- @@ -15,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -178,38 +180,47 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ +## 서빙 공급자 + +이 모델은 요청에서 다른 공급자를 지정하지 않는 한 Comfy Router가 직접 서빙합니다. 아래 공급자들도 동일한 엔드포인트와 동일한 모델 ID로 이 모델을 서빙하며, `model_provider` 쿼리 매개변수로 선택됩니다. + +- **Comfy** (기본값): `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128` +- **Kelly**, `kelly/kelly-seedance-2.0-fast`로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128?model_provider=kelly` + +`strict_mode`의 기본값은 `false`이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자의 자체 스키마로 변환하고 응답을 다시 변환합니다. API 참조에서 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)를, 이 방식으로 라우팅되는 모든 모델에 대해서는 [서빙 공급자](/ko/development/comfy-router/providers)를 참조하세요. + ## 스키마 ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하여 확인하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만, 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과를 얻으려면 작업 상태 라우트를 폴링하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. + 모델이 비디오를 생성하기 위한 입력 콘텐츠 - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만으로는 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. + 오디오 URL, Base64 인코딩 또는 에셋 ID. +오디오 URL: 오디오의 공개 URL (wav, mp3). Base64: 형식 data:audio/\;base64,\ 에셋 ID: 형식 asset://\ - Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 이를 다시 전송하지 마세요. 최종 출력 등급(4k 포함)에 맞는 해상도를 이 요청에서 설정하세요. 생략하면 최종 결과물은 1080p입니다. + Seedance 2.5 전용. 최종 비디오로 렌더링할 초안(Draft) 작업입니다. 유일한 콘텐츠 항목이어야 합니다. +최종 비디오는 초안 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 출력 등급(4k 포함)에 맞게 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. + 초안 비디오를 `draft`를 true로 설정하여 생성했을 때 반환된 작업 ID입니다. @@ -217,27 +228,27 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. + 이미지 기반 비디오 생성용 이미지 콘텐츠 (type이 "image_url"인 경우) +이미지 URL: 이미지 URL에 접근 가능한지 확인하세요. +Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\이어야 합니다. 에셋 ID: 형식 asset://\ - 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image입니다. -비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. -오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. + 콘텐츠 항목의 역할/위치. +이미지의 경우: first_frame, last_frame 또는 reference_image. +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델용 입력 텍스트 정보. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트 (필수): 중국어 및 영어 문자로 생성할 비디오를 설명합니다. -파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. +파라미터 (선택): 텍스트 프롬프트 뒤에 --[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) @@ -246,98 +257,108 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 -공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 -될 수 있습니다. 이 값은 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다. -`content`는 배열이고, 문서 전체를 제한하는 것은 요청당 본문 제한입니다. -이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 -직접 호출하면 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 -설정하여 실제 프롬프트를 판정하지 않도록 하세요. 호출자에게 더 많은 양이 필요하면 값을 높이세요. +예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +BytePlus 제약이 아닌 Comfy 측 보호 장치입니다. BytePlus는 텍스트 길이 제한을 +공표하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 +몇 배가 될 수 있습니다. 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다: +`content`는 배열이고, 전체 문서를 제한하는 것은 요청당 본문 제한입니다. +이를 적용하는 표면은 Comfy Router (/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. +실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하지 않습니다. +호출자에게 더 많은 용량이 필요하면 값을 높이세요. - 입력 콘텐츠의 유형입니다. + 입력 콘텐츠의 유형 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. + 비디오 URL 또는 에셋 ID. +비디오 URL: 비디오의 공개 URL (mp4, mov). 에셋 ID: 형식 asset://\ - Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청에서 4k를 포함한 최종 해상도를 설정합니다. 해상도를 생략하면 최종 결과물은 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용. 480p 초안 비디오를 생성하며, 해상도는 480p여야 합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청은 최종 결과의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과는 1080p입니다. 초안 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(auto)입니다. + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간)입니다. 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각적 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 해당 검사에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 이는 오디오가 거부된 모달리티였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 표시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략합니다. + 호출할 모델의 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 호출자는 이를 생략합니다. + + + + Seedance 2.5 전용입니다. 참조 미디어가 사용되는 작업입니다. 생략하면 auto를 의미합니다: 모델이 프롬프트와 참조 미디어에서 작업을 추론하며, 그 해석과 충돌하는 설정(예: 모델이 편집으로 해석하는 대상에 대한 `duration` 또는 `ratio`)은 생성이 시작된 이후에만 해결되고, 이 경우 과금됩니다. +reference: 참조 이미지, 비디오 및 오디오를 기반으로 요청된 `duration`의 새 비디오를 생성합니다. +edit: 연결된 참조 비디오를 변경합니다. 출력은 소스 클립 자체의 길이와 화면 비율을 유지하므로 `duration: -1`을 보내고 `ratio`를 생략하세요(또는 `adaptive`를 보내세요). +extend: 참조 비디오를 이어서 계속합니다. 출력은 요청된 `duration`의 새로 생성된 세그먼트만이며, 화면 비율은 클립을 따릅니다. +명시적 값은 제출 시 공급자가 검증하므로(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), 요청에 맞지 않는 값은 생성이 시작되기 전에 실패하고 과금되지 않습니다. auto에는 이러한 검사가 없습니다. 이 검사는 네이티브 BytePlus 레그에서만 실행됩니다. 대체 공급자 레그(폴백 시 또는 `model_provider`로 선택한 경우)에는 작업 유형 필드가 없어 값을 버리고, 해당 공급자는 auto와 마찬가지로 작업을 자체적으로 추론합니다. 값이 버려진 사실은 동기 실행 경로의 응답과 대기 중인 제출의 `201`에서 `X-Comfy-Router-Dropped-Params`를 통해 공개됩니다. 대기 경로에는 폴백이 없으므로 `model_provider`를 통해서만 대체 레그에 도달합니다. + + 가능한 값: `reference`, `edit`, `extend` Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며, 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 이전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드 생략만) 허용됩니다. 구체적인 비율은 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p 및 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. - 범위: `-1` ~ `4294967295` + 범위: `-1`부터 `4294967295`까지 - 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -346,46 +367,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 함께 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 정리하며, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable: 작업 후 24시간이 지나면 BytePlus가 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 정리합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참고), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우에 해당합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으므로 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. - 업스트림 URL이 동작을 멈추는 RFC 3339 시각입니다. URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 존재할 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값입니다. `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦을 수 없으며, 그렇지 않은 경우 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인된 워크스페이스에만 해당하고, Seedance 2.x에만 해당하며, BytePlus가 정리한 뒤에는 존재하지 않고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인한 워크스페이스에만, Seedance 2.x에만 제공되고, BytePlus가 지운 뒤에는 없으며, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 존재하지 않습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 정리하면 존재하지 않습니다. 미리 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루어야 합니다. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하는데, 그중 1회는 Router 자체의 재호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 없습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 여기에 해당하며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 없어집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 한 번은 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 캐시 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 해당 URL을 정리하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 1시간도 남지 않은 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크가 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시각입니다. 값은 초 단위 UNIX 타임스탬프입니다. + 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고합니다. 따라서 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰된 반면, 인접한 다른 BytePlus 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 이 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. @@ -393,7 +414,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 계층 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열에는 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake와 같습니다. 이것은 열거형이 아닌 열린 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -405,19 +426,19 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 작업에 사용된 모델의 이름과 버전 + 작업에서 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov). `content`와 같은 최상위 레벨(TOP LEVEL)로 반환되며, Seedance 비디오 작업 조회가 바로 이 위치에서 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. + 생성된 비디오의 해상도이며, 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. + 해당 작업에 실제로 사용된 생성 시드. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. 형식: `int64` @@ -429,7 +450,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 마지막으로 업데이트된 시간. 값은 초 단위의 UNIX 타임스탬프입니다. @@ -441,7 +462,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index ed87f58287..3e69b6782c 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router와 함께 Dreamina Seedance 2.0 Mini 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-mini를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69e65942 +translationSourceHash: 55b49c2a translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 51a6f44e + "Schema": def7c834 "Examples": db01067e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-mini.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -180,7 +181,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백이 전혀 전송되지 않습니다. 대신 결과를 얻으려면 작업 상태 경로를 폴링하세요. 형식: `uri` @@ -190,23 +191,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력할 수 있습니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL (wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID. +오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. +Base64: data:audio/\;base64,\ 형식 +에셋 ID: asset://\ 형식 Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 결과의 출력 등급(4k 포함)은 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 출력 등급(4k 포함)에 맞게 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환되는 작업 ID입니다. @@ -214,17 +215,17 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다 (type이 "image_url"인 경우). + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +에셋 ID: asset://\ 형식 콘텐츠 항목의 역할/위치입니다. -이미지: first_frame, last_frame 또는 reference_image. -비디오: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image. +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -232,28 +233,28 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오에 대한 설명입니다. -파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택 사항): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[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) +- --seed (--seed): -1부터 2^32-1까지 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 -제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 -몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 -제한합니다: `content`는 배열이며, 요청당 본문 제한이 전체 문서를 -제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, -v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. -실제 프롬프트를 절대 판정하지 않도록 실제 트래픽보다 훨씬 높게 -설정되어 있습니다. 호출자가 더 많이 필요하면 값을 높이세요. +예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +BytePlus 제약 사항이 아닌 Comfy 측 가드레일입니다. BytePlus는 +텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 +허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 +이 크기의 몇 배가 될 수 있습니다. 이는 요청 전체가 아니라 이 필드 하나만 +제한합니다. `content`는 배열이며, 전체 문서는 요청당 본문 제한에 의해 +제한됩니다. 이를 강제하는 인터페이스는 Comfy Router(/v2/models/byteplus/\{model})입니다. +직접 v1 /proxy를 호출하면 대신 BytePlus 자체 검증기가 응답합니다. +실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하지 않습니다. +호출자가 더 많은 양을 필요로 하면 값을 높이세요. @@ -267,18 +268,18 @@ v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합 - 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL (mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID. +비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +에셋 ID: asset://\ 형식 Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -최종 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. 해당 요청에서 최종 결과의 해상도(4k 포함)를 설정합니다. 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청은 4k를 포함한 최종 결과의 해상도를 설정합니다. 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). + 비디오 재생 시간(초)입니다. Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(auto). 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` @@ -286,37 +287,48 @@ v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. - 범위: `3600` ~ `259200` + 범위: `3600`부터 `259200`까지 - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. false: 모델이 무음 비디오를 출력합니다. -모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. +이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 해당 검사에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + - 호출할 모델의 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 호출자는 이 값을 생략합니다. + 호출할 모델의 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 호출자는 생략합니다. + + + + Seedance 2.5 전용입니다. 참조 미디어가 사용되는 작업입니다. 생략하면 auto를 의미합니다. 모델이 프롬프트와 참조 미디어로부터 작업을 추론하며, 모델의 해석과 충돌하는 설정(예: 편집으로 해석되는 요청에 대한 `duration` 또는 `ratio`)은 생성이 시작된 뒤에야 처리되며, 이 경우 과금됩니다. +reference: 참조 이미지, 비디오, 오디오를 바탕으로 요청한 `duration` 길이의 새 비디오를 생성합니다. +edit: 연결된 참조 비디오를 변경합니다. 출력은 소스 클립 자체의 길이와 화면 비율을 유지하므로 `duration: -1`을 보내고 `ratio`를 생략하세요(또는 `adaptive`를 보내세요). +extend: 참조 비디오를 이어서 생성합니다. 출력은 요청한 `duration`만큼 새로 생성된 구간뿐이며, 화면 비율은 클립을 따릅니다. +명시적인 값은 제출 시 공급자가 검증하므로(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), 요청에 맞지 않는 값은 생성이 시작되기 전에 실패하며 과금되지 않습니다. auto에는 이러한 검사가 없습니다. 이 검사는 네이티브 BytePlus 경로에서만 실행됩니다. 대체 공급자 경로(폴백 시, 또는 `model_provider`로 선택한 경우)에는 작업 유형 필드가 없어 해당 값을 버리고, 그 공급자가 auto와 마찬가지로 작업을 스스로 추론합니다. 값이 버려진 사실은 동기 실행 라우트의 응답과 대기 중 제출의 `201` 응답에서 `X-Comfy-Router-Dropped-Params`로 공개됩니다. 대기 중 라우트에는 폴백이 없으므로 `model_provider`를 통해서만 대체 경로에 도달합니다. + + 가능한 값: `reference`, `edit`, `extend` Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. -mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며, 파일 크기가 더 큽니다. +mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro의 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력이 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite의 기본값: 720p. Seedance 1.0 pro & pro-fast의 기본값: 1080p. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. 참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` @@ -324,7 +336,7 @@ Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력이 첫 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정한 뒤 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -344,46 +356,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에서 Router가 제공하는 스키마로부터 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 RE-HOST되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담고 있습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기 있는 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 존재합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참고), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 제공됩니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으니 최상위 `output_format` 필드를 참고하세요. Router는 두 위치 중 존재하는 값을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. 가장 이른 서명 시간에 URL 자체가 지닌 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at` + 24시간(BytePlus가 문서화한 URL 수명)보다 늦지 않고, 그렇지 않으면 작업의 `updated_at` + 24시간입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시간을 제공하지 않으면 생략됩니다. 다시 호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 작업의 `updated_at`에 24시간을 더한 값(BytePlus가 문서화한 URL 수명)보다 늦지 않습니다. `updated_at`이 없으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, `upstream_video_url`과 동일한 조건으로 다시 호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환됩니다. 옵트인된 워크스페이스에만 해당하고, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 다시 호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 하나는 Router 자체의 다시 호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 없습니다. 특정 워크스페이스에 한정되지 않은 레거시 API 키처럼 워크스페이스로 해석되지 않는 자격 증명도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다: 소지한 사람은 만료 전까지 비디오를 다운로드할 수 있으니 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하는데 그중 한 번은 Router 자신의 재호스팅이 소비합니다. - 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 재작성하므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 1시간도 남지 않은 URL을 받을 수 있습니다. 다시 호스팅할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었을 때는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수 대신 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고 인접한 BytePlus 표면에서는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 사례가 관찰되었고, 인접한 다른 BytePlus 표면에서는 소수 재생 시간을 보고하기도 합니다. 따라서 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -391,7 +403,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 붙을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등입니다. 이는 열거형이 아니라 열린 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 이유가 붙을 수 있습니다. 이것은 열거형이 아니라 개방형 문자열입니다: 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. @@ -403,25 +415,25 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 작업에 사용된 모델의 이름과 버전 + 작업에서 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`와 형제 관계인 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)입니다. `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회가 이 위치에 값을 반환합니다. BytePlus 자체 필드이며, 변경 없이 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. + 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. 형식: `int64` - 작업의 상태 + 작업의 상태입니다 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` @@ -431,11 +443,11 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 요청의 토큰 사용량 + 요청의 토큰 사용량입니다 - 모델이 생성한 토큰 수 + 모델이 생성한 토큰 수입니다 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 306a583f4e..618f69f9b5 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router에서 Dreamina Seedance 2.5 260628 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-5-260628을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 2acd3f28 +translationSourceHash: eb57edfc translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 - "Serving providers": 197dd61a - "Schema": d29d4b46 + "Serving providers": 79988fbb + "Schema": 254e7e79 "Examples": 5465695b --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -186,6 +187,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque - **Comfy** (기본값): `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628` - **fal**, `fal/fal-seedance-2.5`로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=fal` - **Higgsfield**, `higgsfield/higgsfield-seedance-2.5`로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=higgsfield` +- **Kelly**, `kelly/kelly-seedance-2.5`로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=kelly` - **Runware**, `runware/runware-seedance-2.5`로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=runware` - **WaveSpeed**, `wavespeed/wavespeed-seedance-2.5`로: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=wavespeed` @@ -196,33 +198,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 결과는 대신 작업 상태 조회 경로를 폴링하세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만, 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠입니다 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL입니다(wav, mp3). -Base64: 형식은 data:audio/\;base64,\입니다. -에셋 ID: 형식은 asset://\입니다. +오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. +Base64: data:audio/\;base64,\ 형식입니다. +에셋 ID: asset://\ 형식입니다. Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 결과의 출력 등급(4k 포함)에 맞게 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 최종 출력 등급(4k 포함)에 맞게 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. - Draft 비디오를 `draft`를 true로 설정하여 생성했을 때 반환된 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. @@ -232,15 +234,15 @@ Base64: 형식은 data:audio/\;base64,\입니다. 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식은 asset://\입니다. +Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어야 합니다. +에셋 ID: asset://\ 형식입니다. 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image입니다. -비디오의 경우: reference_video입니다(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio입니다(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image. +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -250,7 +252,7 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 텍스트 프롬프트(필수): 중국어 및 영어 문자로 생성할 비디오를 설명합니다. -파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. +파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[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) @@ -259,21 +261,21 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 -제한을 공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 -몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 -제한합니다. `content`는 배열이며, 요청별 본문 제한이 문서 전체를 -제한합니다. 이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, -v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. 실제 -트래픽보다 훨씬 높게 설정하여 정상적인 프롬프트를 판정하지 않도록 -했습니다. 호출자에게 더 필요한 경우 값을 올리세요. +예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +BytePlus의 제약이 아닌 Comfy 측 보호 장치입니다. BytePlus는 +텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로, 멀티바이트 프롬프트는 전송 시 이 크기의 +몇 배가 될 수 있습니다. 이 한도를 이 필드 하나에 적용되는 것으로, 요청 전체에 +적용되는 것은 아닙니다: `content`는 배열이며, 전체 문서의 한도는 요청당 +본문 한도로 결정됩니다. 이를 강제하는 표면은 Comfy Router +(/v2/models/byteplus/\{model})입니다. v1 /proxy를 직접 호출하면 대신 BytePlus +자체 검증기가 응답합니다. 실제 프롬프트를 판정하지 않도록 실제 트래픽보다 +훨씬 높게 설정되어 있습니다. 호출자가 더 필요하면 값을 올리세요. - 입력 콘텐츠의 유형입니다 + 입력 콘텐츠의 유형입니다. 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -284,17 +286,17 @@ v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL입니다(mp4, mov). -에셋 ID: 형식은 asset://\입니다. +비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +에셋 ID: asset://\ 형식입니다. Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청이 최종 결과의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하면 최종 비디오가 렌더링됩니다. 해당 요청이 최종 결과의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동). + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(auto). 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` @@ -306,27 +308,36 @@ v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합 - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 이 단계에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 받아들이는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. - 호출할 모델의 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 호출자는 생략하기 때문입니다. + 호출할 모델의 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 호출자는 이 값을 생략합니다. + + + + Seedance 2.5 전용입니다. 참조 미디어가 어떤 작업에 사용되는지입니다. 생략하면 auto를 의미합니다: 모델이 프롬프트와 참조 미디어로부터 작업을 추론하며, 모델의 해석과 충돌하는 설정(예: 편집으로 해석한 대상에 대한 `duration` 또는 `ratio`)은 생성이 시작된 이후에야 해결되고, 이때 과금됩니다. +reference: 참조 이미지, 비디오, 오디오를 안내로 삼아 요청한 `duration`의 새 비디오를 생성합니다. +edit: 연결된 참조 비디오를 변경합니다. 출력은 소스 클립 자체의 길이와 화면 비율을 유지하므로 `duration: -1`을 보내고 `ratio`를 생략하세요(또는 `adaptive`를 보내세요). +extend: 참조 비디오를 이어갑니다. 출력은 요청한 `duration`의 새로 생성된 구간뿐이며, 화면 비율은 클립을 따릅니다. +명시적인 값은 제출 시 공급자가 검증하므로(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), 요청에 맞지 않는 값은 생성이 시작되기 전에 실패하며 과금되지 않습니다. auto에는 그러한 검사가 없습니다. 이 검사는 네이티브 BytePlus 경로에서만 실행됩니다. 대체 공급자 경로(폴백 시, 또는 `model_provider`로 선택한 경우)에는 작업 유형 필드가 없어 값을 버리고, 해당 공급자는 auto의 경우와 마찬가지로 작업을 스스로 추론합니다. 이렇게 값이 버려진 사실은 동기 실행 라우트의 응답과 대기 중인 제출의 `201` 응답에서 `X-Comfy-Router-Dropped-Params`에 표시됩니다. 대기 중인 라우트에는 폴백이 없으므로 `model_provider`를 통해서만 대체 경로에 도달합니다. + + 가능한 값: `reference`, `edit`, `extend` Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 폭넓은 호환성과 더 작은 파일 크기를 제공하는 일반 용도 컨테이너(H.264/AAC, yuv420p)입니다. -mov: 높은 색상 정밀도로 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며 파일 크기가 더 큽니다. +mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며, 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성되는 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력이 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만 허용됩니다(또는 필드를 생략). 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` @@ -340,18 +351,18 @@ Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력이 첫 프 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 즉, 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -360,46 +371,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 기준이 되는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 뒤의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 다시 호스팅(RE-HOST)되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 제공됩니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으므로 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 더 흔히 이를 `content`의 최상위 형제 필드로 반환하며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 것을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값입니다. `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않으며, 그렇지 않은 경우 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하고, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. URL 자체가 가지는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 있을 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시간을 제공하지 않으면 생략됩니다. 다시 호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. 형식: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, `upstream_video_url`과 동일한 조건으로 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환됩니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, `upstream_video_url`과 동일한 조건으로 다시 호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환됩니다. 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 미리 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하는데 그중 한 번은 Router 자체의 재호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 다시 호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재합니다(요청 파라미터는 없습니다). 그 외 모든 경우에는 없으며, 워크스페이스로 확인되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)의 경우도 마찬가지이고, BytePlus가 생성 후 24시간이 지나 URL을 지우면 없어집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 값처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 한 번은 Router 자체의 다시 호스팅이 사용합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 생성 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 받을 수 있습니다. 다시 호스팅할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시간입니다. 값은 초 단위 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이에 대해 일관성이 없으므로 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 사례가 관측되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고합니다. 따라서 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 대해 일관적이지 않기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 사례가 관측되었고, 같은 BytePlus의 다른 표면은 소수 재생 시간을 보고하므로 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -407,7 +418,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열이 점으로 구분된 사유를 가질 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열로, 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 응답 본문과 HTTP 200 실패 작업 응답에서 정책 계열을 인식하되, 전송 계층 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 이유를 가질 수 있습니다. 이것은 enum이 아닌 열린 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 실패를 덮어쓰지 않습니다. @@ -419,39 +430,39 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 작업에서 사용한 모델의 이름과 버전 + 작업에 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 고유 필드로, 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, 최상위 수준에서 `content`의 형제로 반환됩니다. Seedance 비디오 작업 쿼리가 이를 반환하는 위치입니다. BytePlus 자체 필드이며 변경되지 않은 채 전달됩니다. - 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 고유 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경되지 않은 채 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 고유 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경되지 않은 채 전달됩니다. 형식: `int64` - 작업 상태 + 작업의 상태 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - 작업이 마지막 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 요청의 토큰 사용량 + 요청에 대한 토큰 사용량 - 모델이 생성한 토큰 수 + 모델에 의해 생성된 토큰 수 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index c22e0e1519..3d162a25e9 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Seedance 1.0 Pro 250528 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-250528을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 846f38d7 +translationSourceHash: 4453f401 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": 6f05c994 + "Schema": d82c78ff "Examples": 815d621e --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-250528.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -183,33 +184,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 경로를 폴링하여 결과를 확인하십시오. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 가져오세요. 형식: `uri` - 모델이 비디오를 생성할 입력 콘텐츠 + 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠입니다 - 입력 오디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast & 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. + 오디오 URL, Base64 인코딩 또는 Asset ID입니다. 오디오 URL: 오디오의 공개 URL (wav, mp3). Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ +Asset ID: 형식 asset://\ - Seedance 2.5 전용. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마십시오. 최종 출력 등급(4k 포함)을 위해 이 요청에서 해상도를 설정하십시오. 생략하면 최종 결과물은 1080p입니다. + Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. +최종 비디오는 Draft 작업의 prompt, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용합니다. 이 값들을 다시 보내지 마세요. 이 요청에서 최종 출력 등급(4k 포함)에 맞게 해상도를 설정하세요. 생략하면 최종 결과물은 1080p입니다. - `draft`가 true로 설정된 상태에서 Draft 비디오가 생성되었을 때 반환된 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. @@ -217,27 +218,27 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠 (type이 "image_url"인 경우) -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하십시오. + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다 (type이 "image_url"인 경우). +이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +Asset ID: 형식 asset://\ - 콘텐츠 항목의 역할/위치. + 콘텐츠 항목의 역할/위치입니다. 이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast & 2.0 mini 전용). +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast & 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델의 입력 텍스트 정보. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델에 입력되는 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용한 생성할 비디오에 대한 설명. +텍스트 프롬프트 (필수): 생성할 비디오에 대한 설명으로, 중국어 및 영어 문자를 사용합니다. -파라미터 (선택): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[parameters]를 추가하십시오: +파라미터 (선택): 텍스트 프롬프트 뒤에 --[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) @@ -246,74 +247,85 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus 제약이 아닌 Comfy 측 가드레일. BytePlus는 텍스트 길이 제한을 -게시하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 계산하므로 멀티바이트 프롬프트는 전송 시 -이 크기의 몇 배일 수 있습니다. 이는 이 단일 필드를 제한할 뿐 요청을 -제한하지 않습니다: `content`는 배열이며, 요청당 본문 제한이 전체 -문서를 제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, -v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. -실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하지 않습니다. -호출자가 더 필요하면 값을 높이십시오. +예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 +제한을 공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 +몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 +제한하지는 않습니다. `content`는 배열이고 전체 문서의 범위는 요청별 +본문 제한이 결정합니다. 이를 적용하는 표면은 Comfy Router +(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출하면 BytePlus +자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있어 +정상적인 프롬프트를 판정하는 일은 없습니다. 호출자에게 더 필요한 경우 +값을 높이세요. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID. + 비디오 URL 또는 Asset ID입니다. 비디오 URL: 비디오의 공개 URL (mp4, mov). -에셋 ID: 형식 asset://\ +Asset ID: 형식 asset://\ - Seedance 2.5 전용. 480p Draft 비디오를 생성하며 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하십시오. 해당 요청은 최종 결과물의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과물은 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청에서 최종 결과물의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과물은 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초). Seedance 1.0 pro 및 1.0 pro fast: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 1.0 pro 및 1.0 pro fast: [2,12]. 가능한 값: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` - 작업 타임아웃 임계값(초). 기본값 172800 (48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. false: 모델이 무음 비디오를 출력합니다. -모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. + 이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 이 단계에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 다른 조건에서는 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 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 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 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 호출자는 이를 생략합니다. + + + + Seedance 2.5 전용입니다. 참조 미디어를 어떤 작업에 사용할지 지정합니다. 생략하면 auto입니다: 모델이 프롬프트와 참조 미디어로부터 작업을 추론하며, 그 판단과 충돌하는 설정(예: 편집으로 읽은 요청에 지정한 `duration` 또는 `ratio`)은 생성이 시작된 이후에야 해결되며 이때 과금됩니다. +reference: 참조 이미지, 비디오, 오디오를 바탕으로 요청한 `duration` 길이의 새 비디오를 생성합니다. +edit: 연결된 참조 비디오를 변경합니다. 출력은 소스 클립 자체의 길이와 화면 비율을 유지하므로 `duration: -1`을 보내고 `ratio`를 생략하세요(또는 `adaptive`를 보내세요). +extend: 참조 비디오를 이어서 생성합니다. 출력은 요청한 `duration`만큼 새로 생성된 구간뿐이며, 화면 비율은 클립을 따릅니다. +명시적으로 지정한 값은 제출 시 공급자가 검증하므로(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), 요청에 맞지 않는 값은 생성이 시작되기 전에 실패하며 과금되지 않습니다. auto에는 이러한 검사가 없습니다. 이 검사는 네이티브 BytePlus 경로에서만 실행됩니다. 대체 공급자 경로(폴백 시, 또는 `model_provider`로 선택한 경우)에는 작업 유형 필드가 없어 값을 버리며, 해당 공급자는 auto와 마찬가지로 스스로 작업을 추론합니다. 값이 버려졌다는 사실은 동기 실행 경로의 응답과 대기 중인 제출의 `201`에서 `X-Comfy-Router-Dropped-Params`로 공개됩니다. 대기 중인 경로에는 폴백이 없으므로 `model_provider`를 통해서만 대체 경로에 도달합니다. + + 가능한 값: `reference`, `edit`, `extend` Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드 생략만) 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` @@ -327,12 +339,12 @@ Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 뒤 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 난수성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` @@ -347,46 +359,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`에서 Router가 제공하는 스키마에서 생성되었습니다. 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 바로 그 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담고 있습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 삭제하므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 RE-HOSTED되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 요청에서 `return_last_frame`을 설정했을 때 반환되는, 생성된 비디오의 마지막 프레임 다운로드 URL입니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 제공받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 타입을 지정하며, `image/jpeg`는 둘 다 실패할 때의 최후 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로 나중 폴링에서는 1시간도 남지 않은 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 삭제합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오 마지막 프레임의 다운로드 URL이며, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 re-host하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 타입을 지정하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 re-host하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. Re-host를 수행할 수 없었던 경우 이 필드는 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 더 흔히 `content`의 최상위 형제로 반환하며, 최상위 `output_format` 필드를 참조하세요. Router는 둘 중 존재하는 값을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우에는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. URL 자체가 지니는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 있으면 해당 값에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않고, 없으면 해당 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시간을 제공하지 않으면 생략됩니다. Re-host된 `video_url` / `last_frame_url`의 수명과는 무관합니다. - 형식: `date-time` + Format: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 즉, 옵트인한 워크스페이스에만, Seedance 2.x에만 제공되며, BytePlus가 삭제하면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, re-host된 `last_frame_url` 옆에 바이트 단위 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인된 워크스페이스에만, Seedance 2.x에만 해당하고, BytePlus가 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 매개변수는 없습니다), 그 외의 경우에는 존재하지 않습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 삭제하면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀처럼 취급하세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 하나를 Router의 재호스팅이 소비합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, re-host된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 제공되며(요청 파라미터는 없습니다), 그 외의 경우에는 제공되지 않습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 보유한 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 1회는 Router 자체의 re-host가 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로 나중 폴링에서는 1시간도 남지 않은 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 삭제하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 re-host하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. Re-host를 수행할 수 없었던 경우 이 필드는 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환하는 사례가 관찰되었고, 같은 BytePlus의 다른 API 표면은 소수 재생 시간을 보고하므로 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값을 일관되게 처리하지 않기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 사례가 관찰되었고, 인접한 다른 BytePlus API는 소수 재생 시간을 보고합니다. 따라서 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -394,7 +406,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 점으로 구분된 사유가 붙을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 계층 실패를 덮어쓰지는 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 붙을 수 있습니다. 예: InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake. 이것은 열거형이 아닌 열린 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 계층 실패를 재정의하지 않습니다. @@ -410,15 +422,15 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 요소로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 항목으로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 전달됩니다. - 생성된 비디오의 해상도이며, 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. + 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. 형식: `int64` @@ -442,7 +454,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index ab9403c646..e2349d0860 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router에서 Seedance 1.0 Pro Fast 251015 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-fast-251015를 호출하는 방법: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 5ba64878 +translationSourceHash: cadcf7af translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 2de625f5 + "Schema": db13820d "Examples": 1469ab97 --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* 생성된 파일. router-schemas/byteplus/seedance-1-0-pro-fast-251015.json에서 `pnpm code-pages:gen`으로 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -183,7 +184,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 입력 - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 받으세요. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` @@ -193,23 +194,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. 오디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. 오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. -Base64: 형식은 data:audio/\;base64,\입니다. -에셋 ID: 형식은 asset://\입니다. +Base64: 형식 data:audio/\;base64,\ +에셋 ID: 형식 asset://\ - Seedance 2.5만 해당됩니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 최종 출력 등급(4k 포함)은 이 요청에서 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. + Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 최종 출력 등급(4k 포함)에 맞게 이 요청에 해상도를 설정하세요. 생략하면 최종 결과는 1080p입니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. + Draft 비디오가 `draft`가 true로 설정된 상태로 생성되었을 때 반환된 작업 ID입니다. @@ -217,27 +218,27 @@ Base64: 형식은 data:audio/\;base64,\입니다. - 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식은 asset://\입니다. +에셋 ID: 형식 asset://\ 콘텐츠 항목의 역할/위치입니다. -이미지: first_frame, last_frame 또는 reference_image. -비디오: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 해당). -오디오: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 해당). +이미지의 경우: first_frame, last_frame 또는 reference_image. +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델의 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 생성할 비디오에 대한 설명으로, 중국어와 영어 문자를 사용합니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 작성하는, 생성할 비디오에 대한 설명입니다. -파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. +파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[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) @@ -246,17 +247,11 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 -제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 -몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 제한합니다. -`content`는 배열이며, 전체 문서를 제한하는 것은 요청당 본문 제한입니다. -이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, -직접 v1 /proxy를 호출하면 대신 BytePlus 자체 검증기가 응답합니다. -실제 트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 판정하지 않습니다. -호출자가 더 많은 길이를 필요로 하면 값을 높이세요. +예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +Comfy 측 가드레일이며, BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 계산하므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이는 요청이 아니라 이 단일 필드에만 한도를 적용합니다: +`content`는 배열이며, 요청별 본문 한도가 전체 문서의 한도를 결정합니다. Comfy Router(/v2/models/byteplus/\{model})가 이를 강제하는 경로이며, 직접 v1 /proxy를 호출하면 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트에는 판정을 내리지 않습니다. 호출자가 더 많은 길이를 필요로 하면 값을 높이세요. @@ -266,18 +261,18 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. 비디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. 비디오 URL 또는 에셋 ID입니다. 비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. -에셋 ID: 형식은 asset://\입니다. +에셋 ID: 형식 asset://\ - Seedance 2.5만 해당됩니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 비디오를 렌더링하세요. 해당 요청에서 최종 결과의 해상도(4k 포함)를 설정하며, 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. +최종 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. 해당 요청은 4k를 포함한 최종 결과의 해상도를 설정합니다. 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. @@ -287,33 +282,42 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 시간 초과 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다.모델이 이를 지원하는 경우, 생성된 오디오 트랙은 비디오와 별도로 공급자가 콘텐츠 검사를 수행합니다. 해당 검사에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이 경우 무음 비디오를 원하면 `false`를 보내세요. 다만 이는 거부된 양상이 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 표시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. - 호출할 모델의 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 호출자는 이 값을 생략합니다. + 호출할 모델의 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 호출자는 이를 생략합니다. + + + + Seedance 2.5 전용입니다. 참조 미디어가 사용되는 작업입니다. 생략하면 auto를 의미합니다. 모델이 프롬프트와 참조 미디어로부터 작업을 추론하며, 추론 결과와 충돌하는 설정(예: 편집으로 해석한 대상에 지정한 `duration` 또는 `ratio`)은 생성이 시작된 이후에야 해결되므로 과금됩니다. +reference: 요청한 `duration`의 새 비디오를 참조 이미지, 비디오, 오디오를 바탕으로 생성합니다. +edit: 연결된 참조 비디오를 변경합니다. 출력은 소스 클립 자체의 길이와 화면 비율을 유지하므로 `duration: -1`을 보내고 `ratio`를 생략하세요(또는 `adaptive`를 보내세요). +extend: 참조 비디오를 이어서 연장합니다. 출력은 요청한 `duration`만큼 새로 생성된 구간뿐이며, 화면 비율은 클립을 따릅니다. +명시적으로 지정한 값은 제출 시 공급자가 검증하므로(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), 요청에 맞지 않는 값은 생성이 시작되기 전에 실패하며 과금되지 않습니다. auto에는 이러한 검사가 없습니다. 이 검사는 네이티브 BytePlus 경로에서만 실행됩니다. 대체 공급자 경로(폴백 시, 또는 `model_provider`로 선택한 경우)에는 작업 유형 필드가 없어 값이 제거되며, 해당 공급자는 auto와 마찬가지로 작업을 스스로 추론합니다. 값이 제거된 사실은 동기 실행 라우트의 응답과 대기 중인 제출의 `201` 응답에서 `X-Comfy-Router-Dropped-Params`로 공개됩니다. 대기 중인 라우트에는 폴백이 없으므로 `model_provider`를 통해서만 대체 경로에 도달합니다. + + 가능한 값: `reference`, `edit`, `extend` Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. -mov: 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큰 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)입니다. +mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드 생략) 허용되며, 구체적인 비율은 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서도 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` @@ -327,7 +331,7 @@ Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 연속 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -347,46 +351,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 뒤의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 담습니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 다시 호스팅(RE-HOSTED)됩니다. 여기 있는 다른 모든 필드는 BytePlus 자체의 것입니다. Null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오 마지막 프레임의 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 `content` 안에 중첩해 반환할 때 제공됩니다. Seedance 모델은 보통 이를 `content`의 최상위 형제 필드로 반환하며, 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, BytePlus가 이를 `content` 안에 중첩해 반환할 때 존재합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 쪽을 읽습니다. - 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 있을 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 모두 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 해당 작업의 `updated_at`에 24시간을 더한 값(BytePlus가 문서화한 URL 수명)보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 다시 호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. - 형식: `date-time` + Format: `date-time` - 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 옵트인한 워크스페이스 전용, Seedance 2.x 전용이며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, `upstream_video_url`과 동일한 조건으로 다시 호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환됩니다. 옵트인한 워크스페이스에만 제공되고, Seedance 2.x에만 제공되며, BytePlus가 이를 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. - 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 없습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 여기에 해당하며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 사라집니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 보유한 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 1회는 Router 자체의 재호스팅이 소모합니다. + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 다시 호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 존재하지 않습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 특정 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 이는 presigned 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 이를 100회 다운로드로 제한하고, 그중 한 번은 Router 자체의 다시 호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 재호스팅하고 이 필드를 다시 쓰므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않을 수 있습니다. 재호스팅을 수행할 수 없었을 때는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 재작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 1시간도 남지 않은 URL을 받을 수 있습니다. 다시 호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 100회 다운로드로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시각입니다. 값은 초 단위 UNIX 타임스탬프입니다. + 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고 인접한 BytePlus 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이에 대해 일관성이 없어 정수 대신 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 것이 관찰되었고, 인접한 BytePlus 인터페이스들은 소수 재생 시간을 보고합니다. 따라서 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 그대로 전달됩니다. @@ -394,7 +398,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 점으로 구분된 사유가 붙을 수 있습니다. 예: InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake. 이 값은 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등 점으로 구분된 사유가 있을 수 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않고 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. @@ -406,25 +410,25 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 작업에서 사용된 모델의 이름과 버전 + 작업에서 사용한 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 쿼리가 반환하는 위치입니다. BytePlus 자체 필드이며 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`와 같은 레벨의 최상위로 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 해당 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. 형식: `int64` - 작업의 상태입니다. + 작업의 상태 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` @@ -442,7 +446,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index de4ea6e3d9..3c55eeff3b 100644 --- a/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Gemini 2.5 Flash Image 사용하기" description: "Comfy Router를 통해 vertexai/gemini-2.5-flash-image를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Gemini 2.5 Flash Image" -translationSourceHash: 9bd54fc7 +translationSourceHash: f785dde3 translationFrom: development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx translationBlockHashes: "_intro": ac1aef55 "Quick start": 7ec68bbf "Serving providers": beb2dd36 - "Schema": f124875a + "Schema": f53ea977 "Examples": 19258aaa --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-2.5-flash-image.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -197,7 +198,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R ### 입력 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 질의의 경우 단일 인스턴스입니다. 다중 턴 질의의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 멀티 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. @@ -213,7 +214,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참고하세요. 텍스트 파일은 UTF-8로 인코딩해야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -223,19 +224,19 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참고하세요. 텍스트 파일은 UTF-8로 인코딩해야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하게 하려면 "AGENTIC"을 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. @@ -243,7 +244,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. @@ -251,7 +252,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 생성에 대한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 값을 적용하고, 나머지는 모델 자체의 동작을 따릅니다. + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 기본값이 적용되고, 나머지 필드는 모델 자체 동작을 따릅니다. @@ -259,7 +260,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 생성된 이미지의 화면 비율 + 생성된 이미지의 가로세로 비율 @@ -271,7 +272,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 선택 사항입니다. 출력을 저장할 이미지 형식이며, Vertex AI 경로에 적용됩니다. 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청입니다. 이 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청을 전달하기 전에 소문자로 정규화합니다. 그 밖의 값은 이 필드를 명시한 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없어 이 필드가 있으면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 대로 결정됩니다. 모든 경로에서 전송한 값을 가정하지 말고, 받은 응답 부분에서 미디어 타입을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). + 선택 사항입니다. 출력 이미지를 저장할 이미지 형식이며, Vertex AI 경로에 적용됩니다. 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청입니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청을 전달하기 전에 소문자로 정규화합니다. 그 밖의 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없고 이 필드가 존재하면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며, 출력 형식은 AI Studio가 선택하는 값이 됩니다. 모든 경로에서 보낸 값을 가정하지 말고, 받은 응답 파트에서 미디어 타입을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). @@ -279,7 +280,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰 하나는 약 4자에 해당합니다. 100 토큰은 대략 60~80단어에 해당합니다. + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 대략 4자입니다. 100 토큰은 대략 60-80단어에 해당합니다. 범위: `16` ~ `65536` @@ -289,7 +290,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R -시드가 특정 값으로 고정되면 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 차이가 생길 수 있습니다. 기본적으로는 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + 시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델 또는 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 발생할 수 있습니다. 기본적으로 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -297,7 +298,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - temperature는 응답 생성 중 샘플링에 사용되며, 이는 topP와 topK가 적용될 때 발생합니다. Temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 덜 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 특정 프롬프트에 대한 응답은 대부분 결정론적이지만 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공한다면 temperature를 높여 보세요. + temperature는 응답 생성 중 샘플링에 사용되며, 이 샘플링은 topP와 topK가 적용될 때 발생합니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하며, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정적이지만, 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공하는 경우 temperature를 높여 보세요. 범위: `0` ~ `2` @@ -305,33 +306,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 선택 사항입니다. 사고 기능에 대한 구성입니다. 사고란 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + 선택 사항. 사고 기능에 대한 설정입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. - 선택 사항입니다. true이면 모델이 자신의 사고 내용을 응답에 포함합니다. + 선택 사항. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. - 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산을 지키기 위해 최선을 다합니다. + 선택 사항. 모델의 사고 프로세스에 대한 토큰 예산입니다. 모델은 이 예산 내에 머물도록 최선을 다합니다. - 선택 사항입니다. 모델의 사고 수준입니다. + 선택 사항. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘에 있는 모든 토큰 중 확률이 가장 높은 토큰입니다. Top-K가 3이면 다음 토큰은 확률이 가장 높은 3개 토큰 중에서 temperature를 사용해 선택됩니다. + Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중 확률이 가장 높은 토큰입니다. top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개 토큰 중에서 다음 토큰이 선택됩니다. 범위: `1` ~ `…` - 지정하면 nucleus 샘플링이 사용됩니다. -Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 것(top-K 참조)부터 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용해 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. -덜 무작위적인 응답에는 낮은 값을, 더 무작위적인 응답에는 높은 값을 지정하세요. + 지정하면 뉴클레우스 샘플링이 사용됩니다. +Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 확률이 가장 높은 토큰(top-K 참조)부터 가장 낮은 토큰까지 선택하며, 확률의 합이 top-P 값과 같아질 때까지 진행합니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5이면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +무작위성이 적은 응답에는 더 낮은 값을, 더 무작위적인 응답에는 더 높은 값을 지정하세요. 범위: `0` ~ `1` @@ -351,11 +352,11 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 모델이 더 나은 성능을 내도록 이끄는 지침입니다. 예를 들어 "가능한 한 간결하게 답하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. + 모델이 더 나은 성능을 발휘하도록 유도하는 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. - 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 서로 다른 IANA MIME type을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + 단일 메시지를 구성하는 정렬된 part 목록입니다. 서로 다른 part는 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수 또는 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. @@ -363,13 +364,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 메시지를 생성하는 주체의 정체성입니다. 다음 값을 지원합니다. user: 실제 사람이 보낸 메시지, 일반적으로 사용자가 생성한 메시지를 나타냅니다. model: 모델이 생성한 메시지를 나타냅니다. model 값은 다중 턴 대화에서 모델의 메시지를 대화에 삽입할 때 사용됩니다. 다중 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않아도 됩니다. + 메시지를 생성하는 주체의 ID입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람이 보낸 것이며 일반적으로 사용자가 생성한 메시지임을 나타냅니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 다중 턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 다중 턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않을 수 있습니다. 가능한 값: `user`, `model` - 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호 작용할 수 있게 하는 코드 조각입니다. 함수 호출(Function calling)을 참조하세요. + 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 시스템이 외부 시스템과 상호작용할 수 있도록 하는 코드 조각입니다. 함수 호출을 참조하세요. @@ -385,15 +386,15 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 함수 파라미터의 JSON 스키마 + 함수 파라미터에 대한 JSON 스키마 - true이면 생성된 이미지가 클라우드 스토리지에 업로드되고, 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 이후에 만료됩니다. + 참이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. - 비디오 입력의 경우, 비디오의 시작 및 종료 오프셋을 Duration 형식으로 지정합니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + 비디오 입력의 경우, 재생 시간(Duration) 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 이 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. @@ -401,13 +402,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 네거티브 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 부호 있는 초 단위 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000 이상 +315,576,000,000 이하여야 합니다. + 시간 범위의 부호 있는 초 값입니다. -315,576,000,000에서 +315,576,000,000 사이(양 끝 포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` @@ -417,18 +418,18 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 네거티브 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 부호 있는 초 단위 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000 이상 +315,576,000,000 이하여야 합니다. + 시간 범위의 부호 있는 초 값입니다. -315,576,000,000에서 +315,576,000,000 사이(양 끝 포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` -Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 제공하는 스키마에서 생성되며, 요청이 공급자에 도달하기 이전에 호출을 검증할 때 사용하는 문서와 동일한 문서입니다. +`GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -473,7 +474,7 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 - 모델과 주고받은 현재 대화의 콘텐츠입니다. 단일 턴 질의에서는 단일 인스턴스입니다. 다중 턴 질의에서는 대화 기록과 최신 요청을 담는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 멀티 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. @@ -489,33 +490,33 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 사용할 수 있는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash에서는 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 사용할 수 있는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 구간을 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. - 텍스트 프롬프트 또는 코드 조각입니다. + 텍스트 프롬프트 또는 코드 스니펫입니다. @@ -545,7 +546,7 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 - 응답이 생성된 시각입니다. + 응답이 생성된 타임스탬프입니다. @@ -569,13 +570,13 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 - 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. - 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -587,7 +588,7 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 - 출력 전용입니다. 입력에서 캐시된 부분(캐시된 콘텐츠)의 토큰 수입니다. + 출력 전용입니다. 입력의 캐시된 부분(캐시된 콘텐츠)에 있는 토큰 수입니다. @@ -601,7 +602,7 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -609,7 +610,7 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 - 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이 값은 여전히 총 유효 프롬프트 크기이며, 따라서 캐시된 콘텐츠의 토큰 수를 포함합니다. + 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. @@ -619,7 +620,7 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -641,7 +642,7 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -649,7 +650,7 @@ Router가 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json`에서 - 총 토큰 수입니다(프롬프트 + 후보). + 총 토큰 수(프롬프트 + 후보)입니다. diff --git a/ko/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/ko/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index c2a0dcffa6..484ec41b8e 100644 --- a/ko/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -2,17 +2,18 @@ title: "Gemini 3.7 Flash를 Comfy Router와 함께 사용하기" description: "Comfy Router를 통해 vertexai/gemini-3.7-flash를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Gemini 3.7 Flash" -translationSourceHash: a5b78a88 +translationSourceHash: 059b025e translationFrom: development/comfy-router/models/google/gemini-3-7-flash/code.mdx translationBlockHashes: "_intro": 8eab9a58 "Quick start": b4872308 - "Schema": b5f16a3c + "Schema": cc4c8104 "Examples": 1da8dd0c --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/vertexai/gemini-3.7-flash.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -185,7 +186,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST ### 입력 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 멀티 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. @@ -201,7 +202,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -217,21 +218,21 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. "AGENTIC"으로 설정하면 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정합니다. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 생략하면 기본 고정 비율 샘플링이 사용됩니다. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. - 텍스트 프롬프트 또는 코드 조각입니다. + 텍스트 프롬프트 또는 코드 스니펫입니다. - 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. @@ -239,15 +240,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략하면 그 값을 적용하고, 나머지는 모델 자체 동작을 따릅니다. + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 값을 적용하고, 나머지는 모델 자체 동작을 따릅니다. - 이미지 생성 구성 + 이미지 생성을 위한 구성입니다. - 생성된 이미지의 가로세로 비율 + 생성된 이미지의 가로세로 비율입니다. @@ -259,17 +260,17 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 선택 사항입니다. 출력을 저장할 이미지 형식이며, Vertex AI 경로(Comfy 자체 자격 증명으로 처리되는 요청, 그리고 GCP 서비스 계정으로 인증된 BYOK 요청)에 적용됩니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이고, 대소문자를 구분하지 않고 일치시킨 뒤 요청을 전달하기 전에 소문자로 정규화합니다. 그 외의 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 그 업스트림에는 이런 속성이 없어 이 필드가 있으면 호출 전체를 거부하므로, 이 필드는 반영되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 값이 됩니다. 모든 경로에서 전송한 값을 가정하지 말고, 받은 응답 부분(`inlineData.mimeType`, `uploadImagesToStorage`가 설정된 경우에는 `fileData.mimeType`)에서 미디어 타입을 다시 읽으세요. + 선택 사항입니다. 출력을 저장할 이미지 형식이며, Vertex AI 경로(Comfy 자체 자격 증명으로 처리되는 요청, GCP 서비스 계정으로 인증된 BYOK 요청)에 적용됩니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키고 요청을 전달하기 전에 소문자로 정규화합니다. 그 밖의 값은 이 필드를 지목한 400 오류로 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 그러한 속성이 없고 이 필드가 존재하면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며, 출력 형식은 AI Studio가 선택하는 값을 따릅니다. 모든 경로에서 전송한 값을 가정하지 말고, 받은 응답 파트에서 미디어 타입을 다시 읽으세요(`inlineData.mimeType`, `uploadImagesToStorage`가 설정된 경우에는 `fileData.mimeType`). - 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델이 기본값 1K를 사용합니다. + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. - 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 약 4자에 해당합니다. 100 토큰은 대략 60~80단어에 해당합니다. + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 대략 4자에 해당합니다. 100 토큰은 대략 60~80단어에 해당합니다. - 범위: `16`부터 `65536`까지 + 범위: `16` ~ `65536` @@ -277,7 +278,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST -시드를 특정 값으로 고정하면 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 동일한 시드 값을 사용하더라도 모델이나 temperature 같은 파라미터 설정을 변경하면 응답에 변형이 발생할 수 있습니다. 기본적으로는 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다. gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + 시드를 특정 값으로 고정하면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 모델이나 temperature와 같은 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -285,7 +286,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - Temperature는 응답을 생성하는 동안 샘플링에 사용되며, 이 샘플링은 topP와 topK가 적용될 때 일어납니다. Temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하고 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정적이지만, 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체(fallback) 응답을 제공한다면 temperature를 높여 보세요 + temperature는 topP와 topK가 적용되는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 덜 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만, 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답(fallback)을 제공하는 경우 temperature를 높여 보세요 범위: `0` ~ `2` @@ -293,33 +294,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 선택 사항입니다. 사고(thinking) 기능에 대한 구성입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + 선택 사항. 사고(thinking) 기능에 대한 설정입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. - 선택 사항입니다. true이면 모델이 응답에 자신의 사고를 포함합니다. + 선택 사항. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. - 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산을 지키기 위해 최선을 다합니다. + 선택 사항. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산을 넘지 않도록 최선을 다합니다. - 선택 사항입니다. 모델의 사고 수준입니다. + 선택 사항. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 가운데 확률이 가장 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개의 토큰 가운데에서 다음 토큰이 선택됩니다. + Top-K는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. top-K가 1이면 다음에 선택되는 토큰은 모델 어휘 전체에서 가장 확률이 높은 토큰입니다. top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개의 토큰 중에서 다음 토큰을 선택합니다. 범위: `1` ~ `…` - 지정하면 nucleus 샘플링이 사용됩니다. -Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률이 가장 높은 것(top-K 참조)부터 확률의 합이 top-P 값과 같아질 때까지 확률이 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. -무작위성이 더 적은 응답을 원하면 낮은 값을, 무작위성이 더 큰 응답을 원하면 높은 값을 지정하세요. + 지정한 경우 nucleus 샘플링이 사용됩니다. +Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값이 될 때까지 확률이 가장 높은( top-K 참조) 것부터 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +무작위성이 낮은 응답을 원하면 낮은 값을, 무작위성이 높은 응답을 원하면 높은 값을 지정하세요. 범위: `0` ~ `1` @@ -339,11 +340,11 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. + 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "Answer as concisely as possible" 또는 "Don't use technical terms in your response"와 같습니다. 이 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 content는 별도의 단락으로 구성해야 합니다. - 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 IANA MIME 타입이 다를 수 있습니다. 최대 토큰 수나 이미지 수 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. @@ -351,13 +352,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 메시지를 생성하는 주체의 식별자입니다. 다음 값이 지원됩니다. user: 실제 사람이 보낸 메시지임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 모델이 생성한 메시지임을 나타냅니다. model 값은 다중 턴 대화에서 모델의 메시지를 대화에 삽입할 때 사용됩니다. 다중 턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않아도 됩니다. + 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람, 일반적으로 사용자가 생성한 메시지임을 나타냅니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 멀티턴 대화 중에 모델의 메시지를 대화에 삽입할 때 사용됩니다. 멀티턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않을 수 있습니다. 가능한 값: `user`, `model` - 시스템이 모델의 지식과 범위를 벗어난 작업 또는 작업 집합을 수행하기 위해 외부 시스템과 상호작용할 수 있게 하는 코드 조각입니다. 함수 호출을 참조하세요. + 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호작용할 수 있도록 하는 코드 조각입니다. 함수 호출(Function calling)을 참조하세요. @@ -373,15 +374,15 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 함수 파라미터의 JSON 스키마 + 함수 파라미터에 대한 JSON 스키마 - true이면 생성된 이미지가 클라우드 스토리지에 업로드되고, 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + 참이면 생성된 이미지가 인라인 base64 데이터 대신 클라우드 스토리지에 업로드되어 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. - 비디오 입력의 경우, Duration 형식으로 표현된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 }, "endOffset": \{ "seconds": 70 }으로 설정합니다. 이 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공될 때만 지정해야 합니다. + 비디오 입력의 경우, 비디오의 시작 및 종료 오프셋을 Duration 형식으로 지정합니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공될 때만 지정해야 합니다. @@ -389,13 +390,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도로 표현된 부호 있는 초의 소수부입니다. 소수부를 가진 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 초 단위 소수 부분(부호 있음). 소수 부분이 있는 음수 초 값도 나노 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000 이상 +315,576,000,000 이하여야 합니다. + 시간 범위의 초 단위 값(부호 있음). -315,576,000,000 이상 +315,576,000,000 이하여야 합니다. 범위: `-315576000000` ~ `315576000000` @@ -405,18 +406,18 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도로 표현된 부호 있는 초의 소수부입니다. 소수부를 가진 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 초 단위 소수 부분(부호 있음). 소수 부분이 있는 음수 초 값도 나노 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000 이상 +315,576,000,000 이하여야 합니다. + 시간 범위의 초 단위 값(부호 있음). -315,576,000,000 이상 +315,576,000,000 이하여야 합니다. 범위: `-315576000000` ~ `315576000000` -Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -477,29 +478,29 @@ Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공 - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite와 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩해야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite와 gemini-2.0-flash에서는 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite와 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩해야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. @@ -527,7 +528,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공 - 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -557,7 +558,9 @@ Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공 - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 콘텐츠가 위반할 수 있는 안전 카테고리 + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` @@ -583,7 +586,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공 - 모달리티별 후보 토큰 내역입니다. + 모달리티별 후보 토큰의 세부 내역입니다. @@ -597,11 +600,11 @@ Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공 - 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이 값은 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. - 모달리티별 프롬프트 토큰 내역입니다. + 모달리티별 프롬프트 토큰의 세부 내역입니다. @@ -615,15 +618,15 @@ Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공 - thoughts 출력에 포함된 토큰 수입니다. + 사고(thoughts) 출력에 있는 토큰 수입니다. - 도구 사용 프롬프트에 포함된 토큰 수입니다. + 도구 사용 프롬프트에 있는 토큰 수입니다. - 모달리티별 도구 사용 프롬프트 토큰 내역입니다. + 모달리티별 도구 사용 프롬프트 토큰의 세부 내역입니다. diff --git a/ko/development/comfy-router/models/google/gemini-3-8-flash/code.mdx b/ko/development/comfy-router/models/google/gemini-3-8-flash/code.mdx index ff1a4b0c2a..38ca6a0a68 100644 --- a/ko/development/comfy-router/models/google/gemini-3-8-flash/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-3-8-flash/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Gemini 3.8 Flash 사용하기" description: "Comfy Router를 통해 vertexai/gemini-3.8-flash를 호출합니다: endpoint, 요청 형태, Router가 반환하는 응답을 다룹니다." sidebarTitle: "Gemini 3.8 Flash" -translationSourceHash: 723f1618 +translationSourceHash: aec8f1da translationFrom: development/comfy-router/models/google/gemini-3-8-flash/code.mdx translationBlockHashes: "_intro": c76d5ed4 "Quick start": e986a155 - "Schema": e5173b06 + "Schema": ab7655e4 "Examples": 48b9d5db --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-3.8-flash.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -185,7 +186,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST ### 입력 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. @@ -201,13 +202,13 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash에서는 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. @@ -217,13 +218,13 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정합니다. 기본 고정 비율 샘플링을 사용하려면 생략합니다. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. @@ -231,7 +232,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. @@ -239,7 +240,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언하는 필드는 생략하면 해당 기본값이 적용되고, 나머지는 모델 자체 동작으로 처리됩니다. + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략하면 해당 기본값이 적용되고, 나머지는 모델 자체 동작을 따릅니다. @@ -259,7 +260,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 선택 사항입니다. 출력을 저장할 이미지 형식이며, Vertex AI 경로(Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청)에 적용됩니다. 해당 경로에서 허용되는 값은 `image/png` 및 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키고 요청이 전달되기 전에 소문자로 정규화합니다. 그 밖의 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없고 이 필드가 있으면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 대로 결정됩니다. 모든 경로에서 보낸 값을 가정하지 말고, 주어진 응답 부분(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`)에서 미디어 유형을 다시 읽으세요. + 선택 사항입니다. 출력을 저장할 이미지 형식이며, Vertex AI 경로(Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청)에 적용됩니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청이 전달되기 전에 소문자로 정규화됩니다. 그 밖의 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없고 이 필드가 있으면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 값을 따릅니다. 모든 경로에서 전송한 값을 가정하지 말고, 받은 응답 파트에서 미디어 유형을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). @@ -267,7 +268,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰 하나는 약 4자입니다. 100토큰은 대략 60~80단어에 해당합니다. + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 대략 4자에 해당합니다. 100 토큰은 약 60-80 단어에 해당합니다. 범위: `16` ~ `65536` @@ -276,8 +277,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - - 시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같이 모델이나 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 차이가 발생할 수 있습니다. 기본적으로는 무작위 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Available for the following models:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + +시드를 특정 값으로 고정하면 모델은 반복되는 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로는 임의의 시드 값이 사용됩니다. 사용 가능한 모델:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -285,7 +287,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - temperature는 topP와 topK가 적용될 때 발생하는, 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 개방형이거나 창의적인 응답이 덜 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만 약간의 변동은 여전히 발생할 수 있습니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공한다면 temperature를 높여 보세요 + temperature는 응답 생성 중 샘플링에 사용되며, topP와 topK가 적용될 때 함께 동작합니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 개방적이거나 창의적인 응답이 필요하지 않은 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 반환한다면 temperature를 높여 보세요. 범위: `0` ~ `2` @@ -293,32 +295,32 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 선택 사항입니다. 사고(thinking) 기능에 대한 구성입니다. 사고란 모델이 더 높은 품질의 응답을 생성하기 위해 복잡한 작업을 더 작은 단계로 나누는 과정입니다. + 선택 사항입니다. 사고 기능에 대한 설정입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. - 선택 사항입니다. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. + 선택 사항입니다. 참이면 모델이 응답에 자신의 사고 내용을 포함합니다. - 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산 내에 머무르기 위해 최선을 다합니다. + 선택 사항입니다. 모델의 사고 과정에 대한 토큰 예산입니다. 모델은 이 예산을 지키기 위해 최선을 다합니다. 선택 사항입니다. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중에서 가장 확률이 높은 토큰입니다. top-K가 3이면 temperature를 사용해 가장 확률이 높은 3개 토큰 중에서 다음 토큰이 선택됩니다. + Top-K는 모델이 출력에 사용할 토큰을 선택하는 방식을 바꿉니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중 가장 확률이 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개의 토큰 중에서 다음 토큰을 선택합니다. 범위: `1` ~ `…` - 지정하면 nucleus 샘플링이 사용됩니다. -Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 것(top-K 참조)부터 가장 낮은 것까지 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용해 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. + 지정하면 nucleus sampling이 사용됩니다. +Top-P는 모델이 출력에 사용할 토큰을 선택하는 방식을 바꿉니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 토큰(top-K 참고)부터 가장 낮은 토큰까지에서 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. 무작위성이 적은 응답을 원하면 낮은 값을, 무작위성이 큰 응답을 원하면 높은 값을 지정하세요. 범위: `0` ~ `1` @@ -339,25 +341,25 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 content는 별도의 단락에 있어야 합니다. + 모델이 더 나은 성능을 내도록 유도하는 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 이 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 content는 별도의 단락에 있어야 합니다. - 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 IANA MIME 유형이 다를 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 서로 다른 IANA MIME 타입을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참고하세요. - 텍스트 프롬프트 또는 코드 조각입니다. + 텍스트 프롬프트 또는 코드 스니펫입니다. - 메시지를 만드는 주체의 정체성입니다. 다음 값이 지원됩니다: user: 메시지가 실제 사람이 보낸 것임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 다중 턴 대화에서 모델의 메시지를 대화에 삽입할 때 사용됩니다. 다중 턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않을 수 있습니다. + 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람, 일반적으로 사용자가 생성한 메시지임을 나타냅니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 멀티턴 대화 중에 모델의 메시지를 대화에 삽입할 때 사용됩니다. 멀티턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않아도 됩니다. 가능한 값: `user`, `model` - 모델의 지식과 범위를 벗어난 작업 또는 작업 집합을 수행하기 위해 시스템이 외부 시스템과 상호 작용할 수 있게 하는 코드 조각입니다. Function calling을 참조하세요. + 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호작용할 수 있게 하는 코드 조각입니다. 함수 호출을 참고하세요. @@ -373,15 +375,15 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 함수 파라미터의 JSON 스키마 + 함수 파라미터에 대한 JSON 스키마 - true이면 생성된 이미지가 인라인 base64 데이터 대신 클라우드 스토리지에 업로드되어 서명된 URL로 반환됩니다. URL은 24시간 이후에 만료됩니다. + 참이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. - 비디오 입력의 경우 Duration 형식으로 비디오의 시작 및 종료 오프셋을 지정합니다. 예를 들어 1:00에 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + 비디오 입력의 경우, Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공될 때만 지정해야 합니다. @@ -389,13 +391,13 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도의 부호 있는 초 단위 소수입니다. 음수 초 값에 소수가 있는 경우에도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 초 단위 소수 부분(부호 있음)입니다. 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000 이상 +315,576,000,000 이하이어야 합니다. + 시간 구간의 초(부호 있음)입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` @@ -405,18 +407,18 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도의 부호 있는 초 단위 소수입니다. 음수 초 값에 소수가 있는 경우에도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 초 단위 소수 부분(부호 있음)입니다. 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000 이상 +315,576,000,000 이하이어야 합니다. + 시간 구간의 초(부호 있음)입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` -Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 기준이 되는 동일한 문서입니다. +Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -461,7 +463,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. @@ -477,9 +479,9 @@ Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공 - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 제외)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참고하세요. 텍스트 파일은 UTF-8로 인코딩해야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. - 사용 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -487,19 +489,19 @@ Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공 - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 유형(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 제외)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참고하세요. 텍스트 파일은 UTF-8로 인코딩해야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. - 사용 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 그 이후 Flash 모델에서 지원됩니다. @@ -507,11 +509,11 @@ Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공 - 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. - 사용 가능한 값: `user`, `model` + 가능한 값: `user`, `model` @@ -523,13 +525,13 @@ Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공 - 사용 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + 해당 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. - 사용 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -567,7 +569,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공 - 응답의 고유 식별자입니다. + 응답의 고유 식별자. @@ -575,73 +577,73 @@ Router가 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json`에서 제공 - 출력 전용. 입력에서 캐시된 부분(캐시된 콘텐츠)의 토큰 수입니다. + 출력 전용. 입력에서 캐시된 부분(캐시된 콘텐츠)의 토큰 수. - 응답의 토큰 수입니다. + 응답의 토큰 수. - 모달리티별 후보 토큰 분석입니다. + 모달리티별 후보 토큰 내역. - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + 입력 또는 출력 콘텐츠 모달리티 유형. 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` - 해당 모달리티의 토큰 수입니다. + 지정된 모달리티의 토큰 수. - 요청의 토큰 수입니다. cachedContent가 설정된 경우에도 이는 여전히 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + 요청의 토큰 수. cachedContent가 설정된 경우에도 이것은 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. - 모달리티별 프롬프트 토큰 분석입니다. + 모달리티별 프롬프트 토큰 내역. - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + 입력 또는 출력 콘텐츠 모달리티 유형. 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` - 해당 모달리티의 토큰 수입니다. + 지정된 모달리티의 토큰 수. - thoughts 출력에 포함된 토큰 수입니다. + thoughts 출력에 포함된 토큰 수. - 도구 사용 프롬프트에 포함된 토큰 수입니다. + 도구 사용 프롬프트에 포함된 토큰 수. - 모달리티별 도구 사용 프롬프트 토큰 분석입니다. + 모달리티별 도구 사용 프롬프트 토큰 내역. - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + 입력 또는 출력 콘텐츠 모달리티 유형. 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` - 해당 모달리티의 토큰 수입니다. + 지정된 모달리티의 토큰 수. - 총 토큰 수(프롬프트 + 후보)입니다. + 총 토큰 수(프롬프트 + 후보). - 요청에 사용된 트래픽 유형입니다(예: PROVISIONED_THROUGHPUT). + 요청에 사용된 트래픽 유형(예: PROVISIONED_THROUGHPUT). ## 예시 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 60b1c8a805..83ce7d1d24 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,13 +2,13 @@ title: "使用 Dreamina Seedance 2.0 260128 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-260128:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: a3a29c99 +translationSourceHash: 63aaaa35 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 - "Serving providers": 74eb2a7c - "Schema": 9c7c68b7 + "Serving providers": 6d20a079 + "Schema": 3b5d80d0 "Examples": 641c458b --- @@ -17,6 +17,7 @@ translationBlockHashes: + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-260128.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -187,6 +188,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque - **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` - **Higgsfield**,以 `higgsfield/higgsfield-seedance-2.0` 的形式:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=higgsfield` +- **Kelly**,以 `kelly/kelly-seedance-2.0` 的形式:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=kelly` - **Pika**,以 `pika/pika-seedance-2.0` 的形式:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=pika` - **Runware**,以 `runware/runware-seedance-2.0` 的形式:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=runware` - **WaveSpeed**,以 `wavespeed/wavespeed-seedance-2.0` 的形式:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=wavespeed` @@ -198,7 +200,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 输入 - 忽略。仅为兼容 BytePlus 的请求形状而接受,但在任务提交之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 + 已忽略。仅为兼容 BytePlus 的请求结构而接受,但在提交任务前会被移除,因此不会发送任何回调;请改为轮询任务状态路由以获取结果。 格式:`uri` @@ -208,19 +210,19 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque - 输入音频对象。只有 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 - 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开 URL(wav、mp3)。 + 音频网址、Base64 编码或资产 ID。 +音频网址:音频的公开网址(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;不要再次发送这些内容。在该请求上设置最终视频输出档位的分辨率,包括 4k;省略时最终视频为 1080p。 + 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次提交这些参数。在此请求上设置 resolution 以指定最终视频的输出档位(包括 4k);若省略,最终视频为 1080p。 @@ -233,7 +235,7 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图像 URL:请确保图像 URL 可访问。 +图像网址:请确保图像网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -248,11 +250,11 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 模型的输入文本信息。包含文本提示词和可选参数。 + 供模型使用的输入文本信息。包含文本提示词和可选参数。 -文本提示词(必填):使用中英文字符描述要生成的视频。 +文本提示词(必填):使用中文和英文字符描述要生成的视频。 -参数(可选):在文本提示词之后添加 --[parameters] 以控制视频规格: +参数(可选):在文本提示词后添加 --[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) @@ -263,7 +265,15 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 侧的防护限制,而非 BytePlus 的约束。BytePlus 未公布文本长度限制,在测试中曾接受 40,000 个字符(2026-09-17)。它按字符而非字节计数,因此多字节的提示词在传输时可能是该大小的数倍。它约束的是这一个字段,而不是整个请求:`content` 是数组,整个文档由每请求的请求体限制来约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器给出回应。该值设置得远高于真实流量,因此它永远不会对真正的提示词作出裁决;如果调用方需要更多,可以提高该值。 +Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布 +文本长度上限,并且在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此多字节提示词在网络传输中的大小可能 +是其数倍。它只约束这一个字段,而不约束整个请求: +`content` 是一个数组,整个文档由每请求的请求体上限来约束。 +执行该限制的入口是 Comfy Router(/v2/models/byteplus/\{model}); +直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器作出响应。该值 +设置得远高于真实流量,因此它永远不会裁决真实提示词——如果调用方 +需要更多,可以提高该值。 @@ -273,68 +283,78 @@ Comfy 侧的防护限制,而非 BytePlus 的约束。BytePlus 未公布文本 - 输入视频对象。只有 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 + 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 - 视频 URL 或资产 ID。 -视频 URL:视频的公开 URL(mp4、mov)。 + 视频网址或资产 ID。 +视频网址:视频的公开网址(mp4、mov)。 资产 ID:格式为 asset://\ - 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 放入 `draft_task` 内容项中即可渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;resolution 必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;若省略 resolution,最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 - 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 + 视频时长(秒)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - 任务超时阈值,单位为秒。默认 172800(48h)。范围:[3600, 259200]。 + 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持该参数。生成的视频是否包含与画面同步的音频。 + Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 true:模型输出带同步音频的视频。 -false:模型输出无声视频。在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容检查;此处的拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能间歇性出现。如果发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(已排队的请求还无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 +false:模型输出无声视频。`support 支持` 的模型上,已生成的音轨会由提供商与视频分开进行内容检查;若音频被拒,会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能间歇性出现。若遇到这种情况,可发送 `false` 以生成无声视频;只有当音频才是被拒的模态时这才有帮助,同步 Router 响应会将其标记为 `refusal_subject: output_audio`(队列请求尚无法标识这一点)。Seedance 2.5 的最终渲染会从它的 Draft 任务继承 `generate_audio`,因此应改用 `false` 重新创建 Draft。 - 要调用的模型 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 拒绝。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略该参数。 + 要调用的模型 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 拒绝任何其他取值,以及省略该值的情况。它不在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 + + + + 仅 Seedance 2.5。参考媒体所用于的任务类型。省略表示自动:模型从提示词和参考媒体推断任务,而与其推断结果冲突的设置(例如在它识别为编辑的任务上设置 `duration` 或 `ratio`)只有在生成开始之后才会被处理,而生成开始即计费。 +reference:生成一段新的视频,时长为请求的 `duration`,由参考图像、视频和音频引导。 +edit:修改所连接的参考视频。输出保留来源片段自身的长度和宽高比,因此请发送 `duration: -1` 并省略 `ratio`(或发送 `adaptive`)。 +extend:延续参考视频。输出仅为新生成的片段,时长为请求的 `duration`;其宽高比跟随该片段。 +显式取值会在提交时由提供商校验(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`),因此与请求不匹配的取值会在生成开始之前失败,且不计费;自动模式没有此类校验。该校验仅在原生 BytePlus 路径上执行:备用提供商路径(回退时,或通过 `model_provider` 选择)没有任务类型字段,会丢弃该值,并由该提供商自行推断任务,与自动模式相同。丢弃情况会在 `X-Comfy-Router-Dropped-Params` 中披露,包括同步运行路由的响应以及队列提交的 `201` 响应。队列路由没有回退,因此只能通过 `model_provider` 到达备用路径。 + + 可能取值:`reference`、`edit`、`extend` - 仅限 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅 Seedance 2.5。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广、文件大小更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可能的值:`mp4`、`mov` + 可能取值:`mp4`、`mov` - 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini 以及 1.5 pro 默认:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能取值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可能的值:`480p`、`720p`、`1080p`、`4k` + 可能取值:`480p`、`720p`、`1080p`、`4k` - 是否返回所生成视频的最后一帧图像。 -true: 返回所生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与所生成的视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回所生成视频的最后一帧图像。 + 是否返回已生成视频的最后一帧图像。 +true:返回已生成视频的最后一帧图像。将此参数设置为 true 后,可通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false:不返回已生成视频的最后一帧图像。 @@ -344,55 +364,55 @@ false: 不返回所生成视频的最后一帧图像。 - 处理所使用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可能的值:`default`、`flex` + 可能取值:`default`、`flex` - 生成的视频是否包含水印。 + 已生成视频是否包含水印。 -本文档根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 +由 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 提供的 Schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 ### 输出 - 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL;当 BytePlus 返回时,还包含其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储;这里的其他所有字段都来自 BytePlus 自身。可为空:BytePlus 会在任务 24 小时后清除这些 URL,之后轮询到的已完成文档中,`content` 可能缺失或为 null。 + 视频生成任务完成后的输出,包含输出视频的下载 URL,以及 BytePlus 返回最后一帧时该帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储;这里的其他字段均来自 BytePlus 自身。可为空:BytePlus 会在任务结束 24 小时后清除这些 URL,因此之后轮询一个已成功的文档时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL;当请求设置了 `return_last_frame` 时返回。不要从此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并依据上游的 Content-Type 或内容嗅探来确定其类型;`image/jpeg` 只是两者都失败时的最后兜底方案。Router 会把最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,所以稍后轮询可能返回一个最短只剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管其收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以之后轮询可能返回一个最短只剩一小时有效期的 URL。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务结束 24 小时后清除该 URL。无论哪种情况,链接都会过期,因此请下载该帧,而不是存储 URL。 - 已生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 内。Seedance 模型更常将其作为 `content` 的顶层同级字段返回;参见顶层的 `output_format` 字段,Router 会读取两者中出现的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常将其作为 `content` 的顶层同级字段返回(请参阅顶层 `output_format` 字段),Router 会读取两者中存在的那个。 - 上游 URL 失效的 RFC 3339 时间:即 URL 自身携带的最早签名时间加上有效期;当存在 `updated_at` 时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档说明的 URL 有效期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时才会出现;当两个来源都没有提供时间时则省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + 上游 URL 停止工作的时间(RFC 3339 格式):即最早签发时间加上 URL 本身携带的有效期;当存在任务的 `updated_at` 时,该时间绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才会出现,并且在两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前是 bearer 凭据。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列按字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择启用的工作区、仅限 Seedance 2.x、在 BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前是 Bearer 凭证。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅对由 Comfy 已在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务存在(没有请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭据(例如未限定到某个工作区的传统 API 密钥);并且在生成 24 小时后 BytePlus 清除其 URL 后也缺失。它是一个预签名对象存储 URL,因此也是 bearer 凭据:任何持有它的人都能在过期前下载视频,所以应将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列按字节原样返回。仅当 Seedance 2.x 任务由 Comfy 已在服务器端选择启用的工作区轮询时才出现(没有请求参数);对其他所有情况都不出现,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在生成 24 小时后 BytePlus 清除其 URL 后即不出现。它是一个预签名的对象存储 URL,因此也是一种 Bearer 凭证:任何持有它的人都可以在它过期前下载视频,因此请将其视为机密。它会在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,所以稍后轮询可能返回一个最短只剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以之后轮询可能返回一个最短只剩一小时有效期的 URL。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务结束 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是存储 URL。 - 任务创建的时间。该值为以秒为单位的 UNIX 时间戳。 + 任务创建时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为 number 而不是 integer,是因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同类接口会上报小数时长,因此客户端不应假定为整数值。这是 BytePlus 自己的字段,在已成功的视频任务中返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而非 integer,因为 BytePlus 对此并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不得假定其为整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回,并原样转发。 @@ -400,7 +420,7 @@ false: 不返回所生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 标识内容策略拒绝。一个错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会识别 HTTP 400 错误响应包和 HTTP 200 失败任务响应中的策略错误族,但不会覆盖传输故障。 + 上游 ModelArk 错误代码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他代码描述验证和提供商失败。Router 会在 HTTP 400 错误响应包和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 @@ -412,25 +432,25 @@ false: 不返回所生成视频的最后一帧图像。 - 任务使用的模型名称和版本 + 任务所用模型的名称和版本 - 已生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回,Seedance 视频任务查询会在此处返回该字段。这是 BytePlus 自有字段,原样转发。 + 生成视频的容器格式(`mp4` 或 `mov`),在顶层作为 `content` 的兄弟字段返回:Seedance 视频任务查询就是在这里返回该字段。BytePlus 自有字段,原样透传。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。 + 生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回并原样透传。 - 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。 + 任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回并原样透传。 格式:`int64` - 任务的状态 + 任务状态 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -440,7 +460,7 @@ false: 不返回所生成视频的最后一帧图像。 - 请求的 token 用量 + 请求的 token 使用量 @@ -448,7 +468,7 @@ false: 不返回所生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数,默认为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 871fe23914..e45d2a78e3 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,13 @@ title: "使用 Comfy Router 调用 Dreamina Seedance 2.0 Fast 260128" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-fast-260128:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: 506a7f86 +translationSourceHash: fd645dad translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": 48fe2811 + "Serving providers": dfa238a4 + "Schema": bb84c022 "Examples": 7714eccd --- @@ -15,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -178,38 +180,47 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ +## Serving providers + +除非请求中指定了其他提供商,否则该模型由 Comfy Router 直接提供服务。以下提供商也可以提供该模型,使用相同的端点、相同的模型 ID,通过 `model_provider` 查询参数进行选择。 + +- **Comfy**(默认):`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128` +- **Kelly**,名为 `kelly/kelly-seedance-2.0-fast`:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128?model_provider=kelly` + +`strict_mode` 默认为 false,因此 Router 会将本页记载的原生请求体转换为提供商自身的 schema,并将响应转换回来。请参阅 API 参考中的 [`model_provider`、`strict_mode` 与 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel),以及 [Serving providers](/zh/development/comfy-router/providers) 了解所有以这种方式路由的模型。 + ## Schema ### 输入 - 已忽略。为兼容 BytePlus 的请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 + 忽略。为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` - 用于模型生成视频的输入内容 + 模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频:它们必须包含至少 1 个图像或视频;Seedance 2.5 支持仅音频输入。 音频 URL、Base64 编码或资产 ID。 音频 URL:音频的公开 URL(wav、mp3)。 -Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ +Base64:格式 data:audio/\;base64,\ +资产 ID:格式 asset://\ - 仅限 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。请在此请求中设置 resolution,以指定最终视频的输出档位,包括 4k;省略时最终视频为 1080p。 + 仅 Seedance 2.5。要渲染为最终视频的草稿任务。它必须是唯一的内容项。 +最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。在此请求上设置分辨率以指定最终输出的档位,包括 4k;省略时最终视频为 1080p。 - 创建 Draft 视频时 `draft` 设置为 true 所返回的任务 ID。 + 当草稿视频以 `draft` 设置为 true 创建时返回的任务 ID。 @@ -217,10 +228,10 @@ Base64:格式为 data:audio/\;base64,\ - 用于图生视频的图像内容(当 type 为 "image_url" 时) -图片网址:请确保图片网址可访问。 + 用于图生视频生成的图像内容(当 type 为 "image_url" 时) +图片网址:确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ @@ -229,7 +240,7 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` @@ -238,25 +249,23 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 文本提示词(必填):使用中英文字符描述要生成的视频。 参数(可选):在文本提示词后添加 --[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) - -示例:“美丽的风景 --ratio 16:9 --resolution 720p --duration 5” - -Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,并在测试中接受过 40,000 个字符(2026-09-17)。 -它按字符而非字节计数,因此多字节提示词在网络传输时可能达到此大小的数倍。它限制的是这一个字段,而不是整个请求: -`content` 是数组,整个文档由每个请求的请求体限制来约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器响应。该值设置得远高于真实流量,因此它从不会对真实提示词作出裁决;如果调用方需要更多,可以提高该值。 +- --resolution (--rs): 480p, 720p, 1080p (default: 720p) +- --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (default: 16:9 or adaptive) +- --duration (--dur): 3-12 seconds (default: 5) +- --framepersecond (--fps): 24 (default: 24) +- --watermark (--wm): true/false (default: false) +- --seed (--seed): -1 to 2^32-1 (default: -1) +- --camerafixed (--cf): true/false (default: false) + +示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +Comfy 侧的防护措施,并非 BytePlus 的限制。BytePlus 未公布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。它按字符计数,而不是字节,因此多字节提示词在传输时可能达到此大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是一个数组,而整个文档受每请求正文限制的约束。Comfy Router(/v2/models/byteplus/\{model})是执行此限制的接口;在直接调用 v1 /proxy 时,由 BytePlus 自己的验证器进行应答。该值设置得远高于实际流量,因此永远不会对真实提示词进行裁决;如果调用方需要更多,可以提高它。 输入内容的类型 - 可能值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -266,18 +275,18 @@ Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本 视频 URL 或资产 ID。 视频 URL:视频的公开 URL(mp4、mov)。 -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ - 仅限 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 放入 `draft_task` 内容项中,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 +将返回的任务 ID 放在 `draft_task` 内容项中,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。草稿任务 ID 有效期为 7 天。 视频时长(秒)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 可能值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` @@ -287,41 +296,52 @@ Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本 - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true: 模型输出包含同步音频的视频。 + 受 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与视觉同步的音频。 +true: 模型输出带有同步音频的视频。 false: 模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商单独于视频进行内容检查;那里的拒绝会以 `content_policy_violation` 报告,并且由于每次运行音频都不同,对于提供商原本接受的输入,这种拒绝可能间歇出现。如果发生这种情况,请为静音视频传入 `false`;仅当音频就是被拒绝的模态时这才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 +在支持该功能的模型上,已生成的音频轨道由提供商单独于视频进行内容检查;若此处被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商本会接受的输入,该拒绝可能是间歇性的。如果出现这种情况,请发送 `false` 以获取无声视频;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其标为 `refusal_subject: output_audio`(排队中的请求尚不会指明它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 + - 要调用的模型 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 拒绝任何其他值以及省略该字段的请求。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 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。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段中填充它,因此 Router 调用方会省略它。 + + + + 仅限 Seedance 2.5。参考媒体所用于的任务。省略表示 auto:模型会从提示词和参考媒体推断任务,而与其解读相冲突的设置(例如在它解读为编辑的任务上使用 `duration` 或 `ratio`)只会在生成开始之后才被处理,而生成是计费的。 +reference: 生成一个具有所请求 `duration` 的新视频,由参考图像、视频和音频引导。 +edit: 修改连接的参考视频。输出会保留来源片段自身的长度和宽高比,因此请发送 `duration: -1` 并省略 `ratio`(或发送 `adaptive`)。 +extend: 延续参考视频。输出仅为新生成的片段,具有所请求的 `duration`;其宽高比跟随该片段。 +显式值会在提交时由提供商校验(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`),因此不符合请求的值会在生成开始之前失败,且不计费;auto 没有这类检查。该检查仅在原生 BytePlus 链路上运行:备用提供商链路(在回退时,或通过 `model_provider` 选择)没有任务类型字段,会丢弃该值,由该提供商自行推断任务,与 auto 相同。丢弃情况会在 `X-Comfy-Router-Dropped-Params` 中披露,出现在同步运行路由的响应中,以及排队提交的 `201` 中。排队路由没有回退,因此只能通过 `model_provider` 到达备用链路。 + + 可能的值:`reference`、`edit`、`extend` - 仅 Seedance 2.5 支持。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅限 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC、yuv420p),兼容性广、文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),色彩精度高,适合后期制作;文件更大。 可能的值:`mp4`、`mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出跟随首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +true: 返回已生成视频的最后一帧图像。将此参数设为 true 后,可通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 false: 不返回已生成视频的最后一帧图像。 @@ -332,13 +352,13 @@ false: 不返回已生成视频的最后一帧图像。 - 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 可能的值:`default`、`flex` - 已生成视频是否包含水印。 + 已生成的视频是否包含水印。 根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 @@ -346,33 +366,33 @@ false: 不返回已生成视频的最后一帧图像。 ### 输出 - 视频生成任务完成后返回的输出,包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务 24 小时后清除这些 URL,此后轮询一份已成功的文档时,`content` 可能缺失或为 null。 + 视频生成任务完成后的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处其余所有字段均为 BytePlus 自己的字段。可为空:BytePlus 会在任务结束 24 小时后清除这些 URL,若在此之后轮询一个已成功的文档,其 `content` 可能缺失或为 null。 - 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会把最后一帧重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以较晚的轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务 24 小时后清除它。无论哪种情况链接都会过期,因此请下载该帧,而不是保存 URL。 + 所生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,只有在两者都失败时才回退到 `image/jpeg`。Router 会将最后一帧重新托管到 Comfy 存储并改写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。该 URL 在生成时签名 24 小时,并从 23 小时的备忘录中重放,因此稍后轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务结束 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是存储 URL。 - 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将它作为 `content` 的顶层同级字段返回,见顶层 `output_format` 字段;Router 会读取两者中存在的那个。 + 所生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常见的情况是将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段;Router 会读取两者中存在的那个。 - 上游 URL 失效的 RFC 3339 时间:URL 自身携带的最早签名时间加上有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记载的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才存在,当两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + 上游 URL 失效的 RFC 3339 时间:最早签名时间加上 URL 本身携带的有效期;当存在 `updated_at` 时,不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档中说明的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时才会出现,两个来源都无法提供时间时则省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自有的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列原样返回,条款与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,且在 `upstream_expires_at` 之前属于 bearer 凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一并按字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不再出现,在 `upstream_expires_at` 之前属于持有者凭证。 - BytePlus 自有的输出视频下载 URL,与重新托管的 `video_url` 并列原样返回。仅在由 Comfy 已在服务器端选择加入的工作区轮询的 Seedance 2.x 任务中出现(没有请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此属于 bearer 凭证:任何持有它的人都能在过期前下载视频,所以请把它当作机密对待。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一并按字节原样返回。仅当任务由 Comfy 在服务器端选择加入的工作区轮询 Seedance 2.x 任务时才存在(没有对应的请求参数);其他情况均不返回,包括无法解析到任何工作区的凭证(例如未绑定到工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后也不再出现。它是一个预签名对象存储 URL,因此也是一种持有者凭证:任何持有它的人都能在过期前下载该视频,所以请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其下载次数限制为 100 次,其中一次会被 Router 自身的重新托管所消耗。 - 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以较晚的轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况链接都会过期,因此请下载视频,而不是保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并改写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。该 URL 在生成时签名 24 小时,并从 23 小时的备忘录中重放,因此稍后轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载该视频,而不是存储 URL。 @@ -380,15 +400,15 @@ false: 不返回已生成视频的最后一帧图像。 - 生成视频的时长,单位为秒。声明为 number 而不是 integer,是因为 BytePlus 在这一点上并不一致:已观察到视频任务返回整秒,而同系列的其他 BytePlus 接口会反馈小数时长,因此客户端不应假定该值为整数。这是 BytePlus 的自有字段,在成功的视频任务上返回并原样转发。 + 所生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:视频任务曾出现过返回整数秒的情况,而 BytePlus 其他相关接口会返回带小数的时长,因此客户端不得假定其为整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 - 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 + 错误信息。如果任务成功,则返回 null;如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某一族错误码可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商失败。Router 会在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略族,而不会覆盖传输层失败。 + 上游 ModelArk 错误代码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个类别可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他代码描述验证失败和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 任务失败响应中识别策略类别,但不会覆盖传输层故障。 @@ -396,29 +416,29 @@ false: 不返回已生成视频的最后一帧图像。 - 视频生成任务的 ID + The ID of the video generation task - 该任务所使用的模型名称与版本 + 任务所使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的兄弟字段返回:Seedance 视频任务查询正是在此返回该字段。这是 BytePlus 自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层返回,与 `content` 同级,Seedance 视频任务查询就是在这里返回该字段的。这是 BytePlus 自己的字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自己的字段,在成功的视频任务中返回,原样转发。 - 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自己的字段,在成功的视频任务中返回,原样转发。 格式:`int64` - 任务状态 + 任务的状态 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -436,7 +456,7 @@ false: 不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认值为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 189a836383..44816b1a5f 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,12 +2,12 @@ title: "通过 Comfy Router 使用 Dreamina Seedance 2.0 Mini" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-mini:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69e65942 +translationSourceHash: 55b49c2a translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 51a6f44e + "Schema": def7c834 "Examples": db01067e --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-mini.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -183,33 +184,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 输入 - 已忽略。为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 + 已忽略。为了兼容 BytePlus 请求结构而接受,但在任务提交前会被移除,因此不会发送任何回调;请改为轮询任务状态路由以获取结果。 格式:`uri` - 供模型生成视频的输入内容。 + 用于模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能仅使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 张图像或 1 个视频;Seedance 2.5 支持仅音频输入。 - 音频网址、Base64 编码或资产 ID。 -音频网址:音频的公开网址(wav、mp3)。 -Base64:格式 data:audio/\;base64,\ -资产 ID:格式 asset://\ + 音频 URL、Base64 编码或资产 ID。 +音频 URL:音频的公开 URL(wav、mp3)。 +Base64:格式为 data:audio/\;base64,\ +资产 ID:格式为 asset://\ - 仅 Seedance 2.5 支持。用于渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。在此请求中设置最终输出档位的分辨率,包括 4k;省略该值时最终视频为 1080p。 + 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。请在此请求中设置最终视频输出档位对应的分辨率,包括 4k;如果省略该参数,最终视频为 1080p。 - 在将 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 + 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 @@ -218,9 +219,9 @@ Base64:格式 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:确保图片网址可访问。 +图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式 asset://\ +资产 ID:格式为 asset://\ @@ -229,32 +230,39 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 供模型使用的输入文本信息。包括文本提示词和可选参数。 + 用于模型的输入文本信息。包含文本提示词和可选参数。 -文本提示词(必填):使用中文和英文字符描述要生成的视频。 +文本提示词(必填):使用中英文字符描述要生成的视频。 参数(可选):在文本提示词后添加 --[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)。它按字符计数,而非字节,因此多字节提示词在传输时可能达到此大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是数组,而每次请求的请求体大小限制才是约束整个文档的界限。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;在直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器作出响应。该值设置得远高于真实流量,因此它永远不会对真实提示词进行裁决;如果调用方需要更多,请提高该值。 +- --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)。 +它统计的是字符数而不是字节数,因此多字节提示词在网络传输中的大小可能达到该值的数倍。 +它限制的是这一个字段,而不是整个请求: +`content` 是数组,整个文档受每次请求的正文大小限制约束。 +Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口; +直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器负责响应。 +该值设置得远高于真实流量,因此绝不会拒绝真实提示词;如果调用方需要更多,请提高该值。 输入内容的类型 - 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -262,56 +270,65 @@ Comfy 侧的防护措施,而非 BytePlus 的限制。BytePlus 未公布文本 - 视频网址或资产 ID。 -视频网址:视频的公开网址(mp4、mov)。 -资产 ID:格式 asset://\ + 视频 URL 或资产 ID。 +视频 URL:视频的公开 URL(mp4、mov)。 +资产 ID:格式为 asset://\ 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 -在 `draft_task` 内容项中传入返回的任务 ID,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。Draft 任务 ID 有效期为 7 天。 +将返回的任务 ID 放入 `draft_task` 内容项中,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;如果省略分辨率,最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 - 视频时长(秒)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 + 视频时长,单位为秒。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。 - 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 可能的值:`-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持此参数。生成的视频是否包含与画面同步的音频。 -true: 模型输出带同步音频的视频。 -false: 模型输出无声视频。 -在支持该功能的模型上,提供商会对生成的音轨单独进行内容审核,与视频分开;若音轨被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能是偶发的。如果遇到这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有效,同步的 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求尚不会标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 + Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持此参数。表示生成的视频是否包含与画面同步的音频。 +true: 模型输出带有同步音频的视频。 +false: 模型输出无声视频。在支持该功能的模型上,生成的音频轨道会由提供商与视频分开进行内容检查;此处若被拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频都不相同,对于提供商原本接受的输入,这种拒绝可能是间歇性的。若遇到这种情况,请发送 `false` 以生成无声视频;这仅在音频正是被拒绝的模态时才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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。它不在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 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。直接通过 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它:代理会以 400 拒绝任何其他值,以及省略它的请求。它不在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + + + + 仅适用于 Seedance 2.5。参考媒体所用于的任务。省略即表示 auto:模型会根据提示词和参考媒体推断任务,而与其判断相冲突的设置(例如在它判定为编辑的任务上设置 `duration` 或 `ratio`)只有在生成开始之后才会被处理,而此过程会计费。 +reference: 生成一段所请求 `duration` 的新视频,由参考图像、视频和音频引导。 +edit: 修改连接的参考视频。输出保留源片段自身的长度和宽高比,因此请发送 `duration: -1` 并省略 `ratio`(或发送 `adaptive`)。 +extend: 延续参考视频。输出仅为新生成的片段,时长由所请求的 `duration` 决定;其宽高比跟随该片段。 +显式值会在提交时由提供商校验(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`),因此不符合请求的值会在生成开始之前失败且不计费;auto 没有这类检查。该校验仅在 BytePlus 原生分支上执行:备用提供商分支(在回退时,或通过 `model_provider` 选择)没有任务类型字段,会丢弃该值,并由该提供商自行推断任务,与 auto 相同。丢弃情况会在 `X-Comfy-Router-Dropped-Params` 中披露,同步运行路由的响应和排队提交的 `201` 中都会包含。排队路由没有回退,因此只能通过 `model_provider` 到达备用分支。 + + 可能的值:`reference`、`edit`、`extend` - 仅 Seedance 2.5 适用。输出视频的容器格式。 -mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅适用于 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件更大。 可能的值:`mp4`、`mov` - 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 和 pro-fast 默认值:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 可能的值:`480p`、`720p`、`1080p`、`4k` @@ -319,8 +336,8 @@ Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将本参数设为 true 后,你可以通过调用“查询视频生成任务信息”接口获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用本参数可以生成多段连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多段连续视频。 -false:不返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将此参数设为 true 后,可通过调用 Quering the information about a video generation task(查询视频生成任务信息)获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用此参数可以生成多段连续视频:将上一段已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多段连续视频。 +false: 不返回已生成视频的最后一帧图像。 @@ -330,55 +347,55 @@ false:不返回已生成视频的最后一帧图像。 - 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 可能的值:`default`、`flex` - 已生成的视频是否包含水印。 + 已生成视频是否包含水印。 -生成自 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` 提供的 Schema,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +由 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` 提供的 Schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL;当 BytePlus 返回最后一帧 URL 时,也包含其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都被重新托管到 Comfy 存储;此处的其他字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询到的成功文档中,`content` 可能缺失或为 null。 + 视频生成任务完成后返回的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他所有字段都是 BytePlus 自己的。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询到的已成功文档可能不带 `content`,或其为 null。 - 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的字节,并根据上游 Content-Type 或内容嗅探判断其类型,只有两者都失败时才会最后回退到 `image/jpeg`。Router 会把最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时;签发时按 24 小时签名,并从 23 小时缓存中重放,因此稍后轮询可能拿到仅剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种情况,链接都会过期,因此请下载该帧,而不要保存 URL。 + 生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 重新托管它实际收到的字节,并根据上游的 Content-Type 或内容嗅探来判定类型,`image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的缓存记录中回放,所以之后的轮询可能拿到的 URL 只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它。无论哪种方式链接都会过期,因此请下载该帧,而不要存储 URL。 - 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参见顶层 `output_format` 字段;Router 会读取两者中存在的那个。 + 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常见的是将其作为 `content` 的顶层同级字段返回,请参见顶层 `output_format` 字段;Router 会读取两者中存在的那个。 - RFC 3339 时间,表示上游 URL 停止工作的时间:URL 自身携带的最早签名时间加有效期;当 `updated_at` 存在时,该时间绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才存在;当两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + 上游 URL 失效的 RFC 3339 时间:最早的签名时间加上 URL 本身携带的有效期,当存在 `updated_at` 时不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记载的 URL 有效期);否则为任务的 `updated_at` 加 24 小时。仅在存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列按字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前属于 bearer 凭据。 + BytePlus 自己提供的最后一帧下载 URL,与重新托管的 `last_frame_url` 一起逐字节返回,适用条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即不存在,并在 `upstream_expires_at` 之前属于 bearer 凭据。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列按字节原样返回。仅对由 Comfy 在服务器端选择加入的工作区轮询的 Seedance 2.x 任务存在(没有请求参数);对其他所有情况都不存在,包括解析不到任何工作区的凭据(例如未限定到某个工作区的传统 API 密钥),并且 BytePlus 在生成 24 小时后清除其 URL 后也不存在。它是预签名对象存储 URL,因此是一种 bearer 凭据:任何持有它的人都可以在过期前下载视频,所以请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 + BytePlus 自己提供的输出视频下载 URL,与重新托管的 `video_url` 一起逐字节返回。仅在由 Comfy 在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务中出现(没有对应的请求参数);对其他所有情况都不出现,包括无法解析到任何工作区的凭据(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后也不出现。它是预签名的对象存储 URL,因此是一种 bearer 凭据:任何持有它的人都能在过期前下载视频,因此请把它当作机密对待。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时;签发时按 24 小时签名,并从 23 小时缓存中重放,因此稍后轮询可能拿到仅剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的缓存记录中回放,所以之后的轮询可能拿到的 URL 只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并且在某些模型上将其限制为 100 次下载。无论哪种方式链接都会过期,因此请下载视频,而不要存储 URL。 - 任务创建时间。该值为 UNIX 时间戳,单位为秒。 + 任务的创建时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为数值而不是整数,是因为 BytePlus 对此并不一致:曾观察到视频任务返回整秒数,而同属 BytePlus 的其他接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务中返回并原样转发。 + 生成视频的时长,单位为秒。之所以声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:已观察到视频任务返回整数秒,而同属 BytePlus 的其它接口会报告小数时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 @@ -386,7 +403,7 @@ false:不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商失败。Router 会在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个类别可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略类别,但不会覆盖传输故障。 @@ -398,19 +415,19 @@ false:不返回已生成视频的最后一帧图像。 - 任务所使用模型的名称和版本 + 任务所用模型的名称和版本 - 已生成视频的容器格式(mp4 或 mov),在顶层返回,作为 `content` 的同级字段。Seedance 视频任务查询正是在此处返回该字段。该字段为 BytePlus 自有字段,原样透传。 + 已生成视频的容器格式(`mp4` 或 `mov`),在顶层返回,与 `content` 同级,Seedance 视频任务查询就是在此处返回该字段。这是 BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,原样转发。 - 该任务实际使用的生成种子。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,原样转发。 格式:`int64` @@ -426,7 +443,7 @@ false:不返回已生成视频的最后一帧图像。 - 本次请求的 token 用量 + 请求的 token 用量 @@ -434,7 +451,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 57080b35de..e8cdfe25a2 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,13 +2,13 @@ title: "使用 Dreamina Seedance 2.5 260628 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-5-260628:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 2acd3f28 +translationSourceHash: eb57edfc translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 - "Serving providers": 197dd61a - "Schema": d29d4b46 + "Serving providers": 79988fbb + "Schema": 254e7e79 "Examples": 5465695b --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -186,6 +187,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque - **Comfy**(默认):`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628` - **fal**,模型 ID 为 `fal/fal-seedance-2.5`:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=fal` - **Higgsfield**,模型 ID 为 `higgsfield/higgsfield-seedance-2.5`:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=higgsfield` +- **Kelly**,模型 ID 为 `kelly/kelly-seedance-2.5`:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=kelly` - **Runware**,模型 ID 为 `runware/runware-seedance-2.5`:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=runware` - **WaveSpeed**,模型 ID 为 `wavespeed/wavespeed-seedance-2.5`:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=wavespeed` @@ -196,7 +198,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 输入 - 已忽略。为兼容 BytePlus 请求结构而接受,但在提交任务之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 + 已忽略。为兼容 BytePlus 请求形状而接受,但在提交任务之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` @@ -206,7 +208,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 与 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 @@ -217,8 +219,8 @@ Base64:格式 data:audio/\;base64,\ - 仅限 Seedance 2.5。要渲染为最终视频的草稿任务。它必须是唯一的内容项。 -最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;不要再次发送它们。在此请求上设置最终输出档位的分辨率,包括 4k;如果省略,则最终视频为 1080p。 + 仅 Seedance 2.5。要渲染为最终视频的草稿任务。它必须是唯一的内容项。 +最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。请在此请求上设置最终视频输出档位的分辨率,包括 4k;省略时,最终视频为 1080p。 @@ -231,22 +233,22 @@ Base64:格式 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:确保图片网址可访问。 -Base64 编码的内容:格式必须为 data:image/\;base64,\ +图片网址:请确保图片网址可访问。 +Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式 asset://\ 内容项的角色/位置。 -对于图像: first_frame、last_frame 或 reference_image。 -对于视频: reference_video(仅限 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 -对于音频: reference_audio(仅限 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于图像:first_frame、last_frame 或 reference_image。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 - 可能的值: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型用于输入的文本信息。包括文本提示词和可选参数。 + 模型所需的输入文本信息。包含文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 @@ -259,25 +261,23 @@ Base64 编码的内容:格式必须为 data:image/\;base64,\ - --seed (--seed):-1 到 2^32-1(默认:-1) - --camerafixed (--cf):true/false(默认:false) -示例:"一幅美丽的风景 --ratio 16:9 --resolution 720p --duration 5" +示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 侧护栏,而非 BytePlus 约束。BytePlus 未发布文本长度限制, -并在测试中接受了 40,000 个字符(2026-09-17)。 -它按字符计数,而非字节,因此多字节提示词在传输中可能达到此大小的数倍。 -它限制的是这一个字段,而非整个请求:`content` 是一个数组, -每个请求的正文限制才是整个文档的边界。Comfy Router (/v2/models/byteplus/\{model}) -是执行该限制的层面;直接调用 v1 /proxy 时,由 BytePlus 自己的验证器应答。 -设置为远高于真实流量,以确保它永远不会判定真实的提示词。如果调用方需要更多,请提高此值。 +Comfy 侧防护措施,并非 BytePlus 约束。BytePlus 未发布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符而非字节计数,因此多字节提示词在传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求: +`content` 是数组,而每请求的请求体限制才约束整个文档。Comfy Router(/v2/models/byteplus/\{model})是实施该限制的接口; +直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器作出响应。该限制被设置得远高于真实流量,因此它绝不会对真实提示词作出判定; +如果调用方需要更多,可以提高该限制。 输入内容的类型 - 可能的值: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 + 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持视频输入。 @@ -287,125 +287,134 @@ Comfy 侧护栏,而非 BytePlus 约束。BytePlus 未发布文本长度限制 - 仅限 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 -在 `draft_task` 内容项中传入返回的任务 ID 以渲染最终视频。该请求设置最终视频的分辨率,包括 4k;如果省略分辨率,则最终视频为 1080p。草稿任务 ID 有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时,最终视频为 1080p。草稿任务 ID 的有效期为 7 天。 - 视频时长,以秒为单位。Seedance 2.5:[4,30] 或 -1(自动)。 + 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动)。 - 可能的值: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`、`16`、`17`、`18`、`19`、`20`、`21`、`22`、`23`、`24`、`25`、`26`、`27`、`28`、`29`、`30` + 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`、`16`、`17`、`18`、`19`、`20`、`21`、`22`、`23`、`24`、`25`、`26`、`27`、`28`、`29`、`30` - 任务超时阈值,以秒为单位。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - 受 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true: 模型输出包含同步音频的视频。 -false: 模型输出无声视频。 -在支持该功能的模型上,生成的音频轨道会由提供商单独于视频进行内容审核;若音频被拒,会以 `content_policy_violation` 报告,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种拒绝可能是间歇性的。如果遇到这种情况,请发送 `false` 以获得无声视频;这仅在音频正是被拒的模态时才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 + Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持此参数。生成的视频是否包含与视觉画面同步的音频。 +true:模型输出带同步音频的视频。 +false:模型输出无声视频。在支持该功能的模型上,生成的音频轨道会由提供商独立于视频进行内容检查;若此处被拒绝,会报告为 `content_policy_violation`,并且由于每次运行生成的音频都不同,对于提供商本来可以接受的输入,这种拒绝可能是间歇性的。如果遇到这种情况,请为无声视频发送 `false`;这只在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其标注为 `refusal_subject: output_audio`(排队中的请求尚不会指出这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为使用 `false` 重新创建 Draft。 - 要调用的模型 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。直接以 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它:代理会以 400 拒绝任何其他值,也会以 400 拒绝省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充该值,所以 Router 调用方会省略它。 + 要调用的模型 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 拒绝任何其他值以及省略该字段的调用。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + + + + 仅 Seedance 2.5。参考媒体所用于的任务。省略表示自动:模型根据提示词和参考媒体推断任务,而与它的判断相冲突的设置(例如对它所判定为编辑的任务设置 `duration` 或 `ratio`)只会在生成开始之后才被处理,而生成是计费的。 +reference: 生成一段所请求 `duration` 的新视频,由参考图像、视频和音频引导。 +edit: 修改所连接的参考视频。输出保留来源片段自身的长度和宽高比,因此请发送 `duration: -1` 并省略 `ratio`(或发送 `adaptive`)。 +extend: 延续参考视频。输出仅为新生成的片段,时长按所请求的 `duration`;其宽高比跟随该片段。 +显式值会在提交时由提供商校验(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`),因此不适合该请求的值会在生成开始之前就失败,且不计费;auto 没有这种检查。该检查仅在原生 BytePlus 分支上执行:备用提供商分支(在回退时,或通过 `model_provider` 选择)没有任务类型字段,会丢弃该值,由该提供商自行推断任务,与 auto 时相同。丢弃情况会在 `X-Comfy-Router-Dropped-Params` 中披露,出现在同步运行路由的响应中以及排队提交的 `201` 上。排队路由没有回退,因此只能通过 `model_provider` 才会到达备用分支。 + + 可能的值:`reference`、`edit`、`extend` - 仅适用于 Seedance 2.5。输出视频的容器格式。 -mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),色彩精度高,适合后期制作;文件大小更大。 + 仅 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` - 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体的比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体的比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 的默认值:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前被以 400 拒绝。在这些模式下,Seedance 2.0 接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 的默认值:720p。Seedance 1.0 pro 与 pro-fast 的默认值:1080p。 +注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -是:返回已生成视频的最后一帧图像。将该参数设置为是之后,你可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 -否:不返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将该参数设置为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围:`-1` 到 `4294967295` + 范围:`-1` 至 `4294967295` - 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` 已生成视频是否包含水印。 -本文档由 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +本文档由 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 - 视频生成任务已完成后的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他所有字段都来自 BytePlus 自身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在此期间之后再轮询已成功的文档时,`content` 可能缺失或为 null。 + 视频生成任务完成后的输出,包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储;此处的其他所有字段都是 BytePlus 自己的字段。可为 null:BytePlus 会在任务结束 24 小时后清除这些 URL,因此在此之后轮询一个已成功的文档时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储上并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘录中重放,因此之后的轮询可能返回剩余有效期仅一小时的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自身的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 + 已生成视频最后一帧的下载 URL,仅当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧说明为 PNG,Router 会重新托管它实际收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定其类型,`image/jpeg` 仅在两者都失败时作为最后的兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是一个由 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以稍后轮询可能返回一个只剩不到一小时的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务结束 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不要存储 URL。 - 已生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 内。Seedance 模型更常见的是将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段。Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),仅当 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的同级顶层字段返回,请参阅顶层 `output_format` 字段;Router 会读取两者中存在的那个。 - 上游 URL 失效的 RFC 3339 时间:取最早的签名时间加上 URL 自身携带的有效期;当 `updated_at` 存在时,该时间绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅在存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,当两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + 上游 URL 停止可用的 RFC 3339 时间:取最早签发时间加上这些 URL 自身携带的有效期,当 `updated_at` 存在时,不得晚于任务的 `updated_at` 加 24 小时(BytePlus 文档中说明的 URL 寿命);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才存在;两个来源都未给出时间时则省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自身的最后一帧下载 URL,与重新托管的 `last_frame_url` 并排原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前属于持有者凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一并原样返回,其出现条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x,一旦 BytePlus 清除即缺失,并且在 `upstream_expires_at` 之前属于持有者凭证。 - BytePlus 自身的输出视频下载 URL,与重新托管的 `video_url` 并排原样返回。仅当任务由 Comfy 在服务器端已选择加入的工作区轮询时,才为 Seedance 2.x 任务返回(没有请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),以及在 BytePlus 于生成 24 小时后清除其 URL 之后。它是预签名的对象存储 URL,因此属于持有者凭证:任何持有它的人都可以在过期前下载该视频,请将其视为机密。它在 `upstream_expires_at` 过期,在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一并原样返回。仅当任务由 Comfy 在服务端选择加入的工作区轮询时,才对 Seedance 2.x 任务存在(没有对应的请求参数);对其他所有人都不存在,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥);并且在生成 24 小时后 BytePlus 清除其 URL 后也不存在。它是预签名对象存储 URL,因此属于持有者凭证:任何持有者在过期前都能下载该视频,请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘录中重放,因此之后的轮询可能返回剩余有效期仅一小时的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自身的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是一个由 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以稍后轮询可能返回一个只剩不到一小时的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要存储 URL。 - 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 + 任务的创建时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同级接口会报告小数时长,因此客户端不得假定其为整数值。这是 BytePlus 自身的字段,在已成功的视频任务上返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这点上并不一致:视频任务曾被观察到返回整秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不得假定它是整数值。这是 BytePlus 自己的字段,在已成功的视频任务上返回,并原样转发。 - 错误信息。若任务成功,则返回 null。若任务失败,则返回错误信息。 + 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 标识内容策略拒绝。某一族错误码可能带有点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串而非枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略族,但不会覆盖传输层故障。 @@ -417,19 +426,19 @@ Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的宽高比,因此 - 任务所使用的模型名称和版本 + 任务所用模型的名称和版本 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。BytePlus 自有字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 自有字段,原样转发。 - 生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务上返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务上返回,并原样转发。 - 实际用于该任务的生成种子。BytePlus 自有字段,在成功的视频任务上返回并原样转发。 + 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务上返回,并原样转发。 格式:`int64` @@ -453,7 +462,7 @@ Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的宽高比,因此 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 的数量,默认值为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 3ad3be8301..134328f900 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,12 +2,12 @@ title: "将 Seedance 1.0 Pro 250528 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-250528:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 846f38d7 +translationSourceHash: 4453f401 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": 6f05c994 + "Schema": d82c78ff "Examples": 815d621e --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-250528.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -183,17 +184,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 输入 - 忽略。为兼容 BytePlus 请求形状而接受,但在任务提交之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。 + 已忽略。接受该字段仅为兼容 BytePlus 的请求形状,但在提交任务之前会将其移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` - 用于模型生成视频的输入内容 + 供模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 @@ -205,11 +206,11 @@ Base64:格式为 data:audio/\;base64,\ 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。请在此请求中为最终输出设置分辨率档位,包括 4k;省略时最终视频为 1080p。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。在此请求上设置 resolution 以确定最终视频的输出档位,包括 4k;若省略,则最终视频为 1080p。 - 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 + 创建 Draft 视频且 `draft` 设为 true 时返回的任务 ID。 @@ -229,13 +230,13 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能的值:`first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` 模型的输入文本信息。包括文本提示词和可选参数。 -文本提示词(必填):使用中英文字符描述要生成的视频。 +文本提示词(必填):使用中文和英文字符描述要生成的视频。 参数(可选):在文本提示词之后添加 --[parameters] 以控制视频规格: - --resolution(--rs):480p、720p、1080p(默认:720p) @@ -243,25 +244,26 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - --duration(--dur):3-12 秒(默认:5) - --framepersecond(--fps):24(默认:24) - --watermark(--wm):true/false(默认:false) -- --seed(--seed):-1 至 2^32-1(默认:-1) +- --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)。 -它按字符而非字节计数,因此在网络传输中多字节提示词的体积可能达到 -该数值的数倍。它约束的是这一个字段,而不是整个请求: -`content` 是数组,整个文档由每请求的请求体上限约束。执行该限制的 -接口是 Comfy Router(/v2/models/byteplus/\{model});直接调用 v1 /proxy -时,则由 BytePlus 自己的校验器应答。该值设置得远高于真实流量, -因此它从不会对真实提示词做出裁定;如果调用方需要更多,可以提高该值。 +Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本长度 +上限,并在测试中接受了 40,000 个字符(2026-09-17)。 +它统计的是字符数而非字节数,因此多字节提示词在传输时可能达到该 +上限的数倍。它只约束这一个字段,而不是整个请求: +`content` 是一个数组,整个文档由每请求的请求体限制来约束。 +Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; +在直接调用 v1 /proxy 时,则由 BytePlus 自有的校验器给出响应。该值 +设置得远高于真实流量,因此绝不会用来裁决真实提示词 — 若调用方需要 +更多,可将其提高。 输入内容的类型 - 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -275,57 +277,67 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,即可渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;resolution 必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;若省略 resolution,则最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 - 视频时长,单位为秒。Seedance 1.0 pro 和 1.0 pro fast:[2,12]。 + 视频时长,以秒为单位。Seedance 1.0 pro 和 1.0 pro fast:[2,12]。 - 可能的值:`2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` + 可能的值:`2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - 任务超时阈值,单位为秒。默认 172800(48h)。范围:[3600, 259200]。 + 任务超时阈值,以秒为单位。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 + Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 true:模型输出带同步音频的视频。 -false:模型输出无声视频。在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;若音频被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种情况可能间歇性出现。若出现该情况,请发送 `false` 以生成无声视频;只有当被拒绝的模态是音频时这才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求尚无法标识该信息)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 +false:模型输出无声视频。在支持该功能的模型上,已生成的音频轨道会由提供商与视频分开进行内容检查;此处被拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能是间歇性的。如果发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标明为 `refusal_subject: output_audio`(排队中的请求尚不会标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此应改用 `false` 重新创建 Draft。 - 要调用的模型 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。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 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 调用时 MUST 提供它:代理会以 400 拒绝任何其他值以及省略该字段的请求。它不在此 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 + + + + 仅 Seedance 2.5。参考媒体所用于的任务。省略表示 auto:模型会从提示词和参考媒体推断任务,而与其解读相冲突的设置(例如在它解读为编辑的任务上使用 `duration` 或 `ratio`)只会在生成开始之后才被处理,而生成是计费的。 +reference:生成一段新的视频,时长由请求的 `duration` 指定,并由参考图像、视频和音频引导。 +edit:更改已连接的参考视频。输出会保留源片段自身的长度和宽高比,因此请发送 `duration: -1` 并省略 `ratio`(或发送 `adaptive`)。 +extend:延续参考视频。输出仅为新生成的片段,时长由请求的 `duration` 决定;其宽高比跟随该片段。 +显式值会在提交时由提供商校验(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`),因此不符合请求的值会在生成开始之前失败,且不计费;auto 没有此类检查。该检查仅在原生 BytePlus 链路上运行:备用提供商链路(在回退时,或通过 `model_provider` 选择)没有任务类型字段,会丢弃该值,并由该提供商自行推断任务,与 auto 相同。丢弃情况会在 `X-Comfy-Router-Dropped-Params` 中披露,出现在同步运行路由的响应上以及排队提交的 `201` 上。排队路由没有回退,因此只能通过 `model_provider` 到达备用链路。 + + 可能的值:`reference`、`edit`、`extend` - 仅 Seedance 2.5 适用。输出视频的容器格式。 -mp4:通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅 Seedance 2.5。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发前被拒绝并返回 400。Seedance 2.0 在这些模式下接受具体比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。在这些模式下,Seedance 2.0 接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +true:返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 false:不返回已生成视频的最后一帧图像。 @@ -336,55 +348,55 @@ false:不返回已生成视频的最后一帧图像。 - 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` - 已生成视频是否包含水印。 + 已生成的视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前校验调用时使用的文档相同。 +根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用时所依据的同一份文档。 ### 输出 - 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储上;这里的其他每个字段都是 BytePlus 自己的。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在那之后轮询到的已成功文档可能 `content` 缺失或为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及 BytePlus 提供时最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都已重新托管到 Comfy 存储;这里的其他字段均来自 BytePlus 自身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,之后轮询一个已成功的文档时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以之后轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 + 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要从此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游 `Content-Type` 或内容嗅探来确定类型,仅当两者都失败时,才最后回退到 `image/jpeg`。Router 会将最后一帧重新托管到 Comfy 存储并改写此字段,因此它通常是由 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,所以后续轮询可能返回仅剩一小时有效期的 URL。无法执行重新托管时,该字段则保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种方式,链接都会过期,因此请下载该帧,而不是存储 URL。 - 已生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 内。Seedance 模型更常把它作为 `content` 的顶层同级字段返回,见顶层的 `output_format` 字段,Router 会读取两者中存在的那个。 + 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回:请参阅顶层 `output_format` 字段;Router 会读取两者中存在的那个。 - 上游 URL 失效的 RFC 3339 时间:URL 自身携带的最早签名时间加上其有效期;当 `updated_at` 存在时,不会晚于任务的 `updated_at` 加 24 小时(BytePlus 文档中记录的 URL 生存期),否则为任务的 `updated_at` 加 24 小时。仅在 `upstream_video_url` 或 `upstream_last_frame_url` 存在时出现,两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生存期无关。 + RFC 3339 时间,表示上游 URL 停止工作的时间:最早签名时间加上 URL 自身携带的有效期;当存在任务的 `updated_at` 时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 生存期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现;当两个来源都未给出时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生存期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一并原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、在 BytePlus 清除后缺失,并且在 `upstream_expires_at` 之前属于 bearer 凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列按字节原样返回,适用条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前都是 bearer 凭据。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一并原样返回。仅在由服务端选择加入的 Comfy 工作区轮询的 Seedance 2.x 任务中出现(没有可用的请求参数);对其他所有人都不出现,包括无法解析到任何工作区的凭证(例如未绑定工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都能在其过期前下载视频,请把它当作机密对待。它在 `upstream_expires_at` 过期,在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列按字节原样返回。仅对由 Comfy 已在服务器端选择加入的工作区轮询的 Seedance 2.x 任务出现(没有请求参数);其他所有情况均缺失,包括无法解析到任何工作区的凭据(例如未限定到某个工作区的传统 API 密钥),并且 BytePlus 在生成 24 小时后清除其 URL 后也会缺失。它是预签名的对象存储 URL,因此是一种 bearer 凭据:任何持有它的人都能在过期前下载视频,所以请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时按 24 小时签名,并从 23 小时的缓存记录中重放,所以之后轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并改写此字段,因此它通常是由 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时缓存中重放,所以后续轮询可能返回仅剩一小时有效期的 URL。无法执行重新托管时,该字段则保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。 - 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 + 任务创建时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:视频任务曾被观察到返回整数秒,而同系列的其他 BytePlus 接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 + 生成视频的时长,单位为秒。声明为数字而不是整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同类接口会报告小数时长,因此客户端不得假定其为整数值。这是 BytePlus 自己的字段,在已成功的视频任务上返回并原样转发。 @@ -392,7 +404,7 @@ false:不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误响应信封和 HTTP 200 失败任务响应中识别策略系列,同时不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个错误系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 能在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输故障。 @@ -408,17 +420,17 @@ false:不返回已生成视频的最后一帧图像。 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是从这里返回该字段。这是 BytePlus 自有字段,原样透传。 + 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的兄弟字段返回,Seedance 视频任务查询即在此处返回该字段。这是 BytePlus 的自有字段,原样转发。 - 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 生成视频的分辨率,例如 `1080p`。这是 BytePlus 的自有字段,在成功的视频任务中返回,并原样转发。 - 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 该任务实际使用的生成种子。这是 BytePlus 的自有字段,在成功的视频任务中返回,并原样转发。 - Format: `int64` + 格式:`int64` @@ -432,7 +444,7 @@ false:不返回已生成视频的最后一帧图像。 - 本次请求的 token 用量 + 该请求的 token 用量 @@ -440,7 +452,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数,其默认值为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 964757845e..87b2e5081a 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,12 +2,12 @@ title: "使用 Comfy Router 调用 Seedance 1.0 Pro Fast 251015" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-fast-251015:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 5ba64878 +translationSourceHash: cadcf7af translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 2de625f5 + "Schema": db13820d "Examples": 1469ab97 --- @@ -15,6 +15,7 @@ translationBlockHashes: + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedance-1-0-pro-fast-251015.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -183,7 +184,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 输入 - 会被忽略。此项仅为兼容 BytePlus 的请求结构而接受,但在任务提交之前即被移除,因此不会发送任何回调;请改为轮询任务状态路由以获取结果。 + 已忽略。为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` @@ -193,23 +194,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 与 2.0 mini 不能仅使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 张图像或 1 段视频;Seedance 2.5 支持仅音频输入。 - 音频网址、Base64 编码或资产 ID。 -音频网址:音频的公开网址(wav、mp3)。 + 音频 URL、Base64 编码或资产 ID。 +音频 URL:音频的公开 URL(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ - 仅限 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 与 omni_reference_task_type,请勿再次发送这些内容。请在本次请求中为最终视频的输出档位设置分辨率,包括 4k;若省略,则最终视频为 1080p。 + 仅 Seedance 2.5。用于渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些字段。在此请求上设置最终输出档位的分辨率,包括 4k;省略时最终视频为 1080p。 - 创建 Draft 视频时(`draft` 设为 true)返回的任务 ID。 + 当使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 @@ -218,173 +219,176 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:请确保该图片网址可访问。 -Base64 编码内容:格式必须为 data:image/\;base64,\ +图片网址:请确保图片网址可访问。 +Base64 编码的内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ 内容项的角色/位置。 对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能的值:`first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 - -文本提示词(必填):用中英文字符描述要生成的视频。 - -参数(可选):在文本提示词之后添加 --[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)。 -它按字符而非字节计数,因此在传输时,多字节提示词的实际大小可能是该上限的 -数倍。它限制的只是这一个字段,而不是整个请求: -`content` 是数组,整个文档受每次请求的请求体上限约束。 -执行该限制的入口是 Comfy Router(/v2/models/byteplus/\{model});直接调用 v1 /proxy 时, -则由 BytePlus 自己的校验器负责。该值设置得远高于真实流量,因此它永远不会 -判定真实提示词。如果调用方需要更大的长度,可以提高该值。 + 供模型使用的输入文本信息。包括文本提示词和可选参数。 + +文本提示词(必填):使用中英文字符描述要生成的视频。 + +参数(可选):在文本提示词后添加 --[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) + +示例:"美丽的风景 --ratio 16:9 --resolution 720p --duration 5" + +Comfy 侧的防护措施,而非 BytePlus 的限制。BytePlus 未公布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。它按字符计数,而不是按字节计数,因此多字节提示词在传输时可能达到此大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是一个数组,而每个请求的正文限制才约束整个文档。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口;直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器来响应。该值设置得远高于真实流量,因此绝不会拒绝真实提示词;如果调用方需要更多,可以提高该值。 输入内容的类型 - 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持视频输入。 + 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 - 视频网址或资产 ID。 -视频网址:视频的公开网址(mp4、mov)。 + 视频 URL 或资产 ID。 +视频 URL:视频的公开 URL(mp4、mov)。 资产 ID:格式为 asset://\ - 仅限 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 放入 `draft_task` 内容项中,即可渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;若省略分辨率,则最终视频为 1080p。Draft 任务 ID 在 7 天内保持有效。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时,最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 - 视频时长,单位为秒。Seedance 1.0 pro 与 1.0 pro fast:[2,12]。 + 视频时长(秒)。Seedance 1.0 pro 和 1.0 pro fast:[2,12]。 - 可能的值:`2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` + 可能的值:`2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值(秒)。默认值 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 与 1.5 pro 支持此参数。指定生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容检查;若音轨被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频不同,对于提供商原本接受的输入,这种拒绝可能会间歇性出现。如果发生这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其命名为 `refusal_subject: output_audio`(已排队的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 + 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true: 模型输出包含同步音频的视频。 +false: 模型输出无声视频。在支持该功能的模型上,提供商会对生成的音轨单独进行内容检查(与视频分开);若此处被拒绝,会报告为 `content_policy_violation`,并且由于每次运行生成的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能间歇性出现。若发生这种情况,可发送 `false` 以获得无声视频;仅当音频就是被拒绝的模态时这样做才有帮助,同步 Router 响应会将其标记为 `refusal_subject: output_audio`(已排队的请求尚无法识别这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 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 拒绝任何其他值,以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 + 要调用的模型 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 拒绝任何其他值,也会以 400 拒绝省略该字段的调用。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会用 /v2/models/byteplus/\{model} 中的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + + + + 仅限 Seedance 2.5。参考媒体用于的任务类型。省略即表示 auto:模型会根据提示词和参考媒体推断任务,而与其理解相冲突的设置(例如在它判定为编辑时所发送的 `duration` 或 `ratio`)只有在生成开始之后才会被处理,而生成是会计费的。 +reference:生成一段符合所请求 `duration` 的新视频,由参考图像、视频和音频引导。 +edit:修改所连接的参考视频。输出会保留源片段自身的长度和宽高比,因此请发送 `duration: -1` 并省略 `ratio`(或发送 `adaptive`)。 +extend:延续参考视频。输出仅为新生成的片段,长度为所请求的 `duration`;其宽高比跟随该片段。 +显式值会在提交时由提供商校验(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`),因此不符合请求的值会在生成开始之前失败,且不计费;auto 没有此类校验。该校验仅在 BytePlus 原生链路上执行:备用提供商链路(回退时,或通过 `model_provider` 选择)没有任务类型字段,会丢弃该值,由该提供商自行推断任务,与 auto 的情况相同。丢弃行为会通过 `X-Comfy-Router-Dropped-Params` 披露,出现在同步运行路由的响应中,以及已排队提交的 `201` 响应中。排队路由没有回退,因此只能通过 `model_provider` 到达备用链路。 + + 可能的值:`reference`、`edit`、`extend` - 仅适用于 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅限 Seedance 2.5。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件更大。 - 可能的值:`mp4`, `mov` + 可能的值:`mp4`、`mov` - 生成视频的比例。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 的默认值:adaptive。 -Seedance 2.5 的首帧/首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);在调度之前,具体比例会以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前被以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可能的值:`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可能的值:`480p`, `720p`, `1080p`, `4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,你可以通过调用“查询视频生成任务的信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用此参数可以生成多个连续视频:将上一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 +true:返回已生成视频的最后一帧图像。将该参数设为 true 后,可通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以连续生成多段视频:把前一段已生成视频的最后一帧作为下一段视频任务的首帧,从而快速生成多段连续视频。 +false:不返回已生成视频的最后一帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围:`-1` 至 `4294967295` + 范围:`-1` 到 `4294967295` - 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可能的值:`default`, `flex` + 可能的值:`default`、`flex` 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` 提供的 schema 生成,该 schema 也是它在请求到达提供商之前用来验证调用的同一份文档。 +本文档根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他每个字段都是 BytePlus 自己的。可为空:BytePlus 会在任务完成 24 小时后清除 URL,之后轮询到的已成功的文档可能带有缺失或为 null 的 `content`。 + 视频生成任务完成后得到的输出,包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储;这里的其他所有字段都属于 BytePlus 自身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,而在那之后轮询已成功的任务文档时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,仅当请求设置了 `return_last_frame` 时返回。不要根据这个 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会把最后一帧重新托管到 Comfy 存储上并改写这个字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的一次轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况链接都会过期,因此请下载该帧,而不要保存 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是两者都失败时的最后回退。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:生成时签发 24 小时有效期,并从 23 小时缓存中重放,因此稍后轮询可能返回一个仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会改为保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它。无论哪种方式,链接都会过期,因此请下载该帧,而不是存储 URL。 - 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段;Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段,Router 会读取两者中存在的那个。 - RFC 3339 格式的上游 URL 失效时间:取最早的签名时间加上 URL 自身携带的有效期;当存在 `updated_at` 时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档所述的 URL 有效期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,两个来源都不提供时间时则省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + RFC 3339 时间,表示上游 URL 停止工作的时间:URL 自身携带的最早签名时间加上有效期,且当 `updated_at` 存在时绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档说明的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现;当两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 格式:`date-time` - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列、逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,且在 `upstream_expires_at` 之前属于持有即可用的凭证。 + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并排逐字节返回,其条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前是 bearer 凭证。 - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列、逐字节原样返回。仅对由 Comfy 在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务出现(没有对应的请求参数);对其他所有情况都不出现,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后也不出现。它是预签名的对象存储 URL,因此属于持有即可用的凭证:任何持有它的人都能在过期前下载该视频,所以请像对待密钥一样对待它。它在 `upstream_expires_at` 过期,且在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并排逐字节返回。仅对由 Comfy 在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务出现(没有请求参数);对其他所有情况均缺失,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是一个预签名的对象存储 URL,因此也是 bearer 凭证:任何持有它的人都可以在它过期前下载视频,因此请把它当作机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储上并改写这个字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的一次轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况链接都会过期,因此请下载视频,而不要保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:生成时签发 24 小时有效期,并从 23 小时缓存中重放,因此稍后轮询可能返回一个仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会改为保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上将其限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。 - 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 + 任务创建时间。该值是 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为数字而非整数,是因为 BytePlus 在这方面并不一致:已观察到视频任务返回整秒,而同系列的其他 BytePlus 接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在已成功的视频任务上返回并原样转发。 + 已生成视频的时长,单位为秒。之所以声明为数字而不是整数,是因为 BytePlus 对此并不一致:已观察到视频任务返回整数秒,而同属 BytePlus 的其他接口会报告小数时长,因此客户端不得假定它是整数值。这是 BytePlus 自己的字段,在已成功的视频任务上返回并原样转发。 @@ -392,7 +396,7 @@ false: 不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放的字符串,不是枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个错误码族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略错误码族,且不会覆盖传输故障。 @@ -400,29 +404,30 @@ false: 不返回已生成视频的最后一帧图像。 - 视频生成任务的 ID + +The ID of the video generation task - 该任务所使用的模型名称和版本 + 该任务使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 自有字段,原样透传。 + 已生成视频的容器格式(mp4 或 mov),在顶层返回,与 `content` 同级。Seedance 视频任务查询会在这里返回该字段。该字段属于 BytePlus 自有字段,原样转发。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 已生成视频的分辨率,例如 `1080p`。该字段属于 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。 - 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 + 该任务实际使用的生成种子。该字段属于 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。 格式:`int64` - 任务状态 + 任务的状态 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -432,15 +437,15 @@ false: 不返回已生成视频的最后一帧图像。 - 本次请求的 token 用量 + 请求的 token 用量 - 模型生成的 token 数 + 模型生成的 token 数量 - 对于视频生成模型,不计算输入 token 数,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认值为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index 5f2ab074a6..475e8436de 100644 --- a/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -2,13 +2,13 @@ title: "使用 Gemini 2.5 Flash Image 与 Comfy Router" description: "通过 Comfy Router 调用 vertexai/gemini-2.5-flash-image:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Gemini 2.5 Flash Image" -translationSourceHash: 9bd54fc7 +translationSourceHash: f785dde3 translationFrom: development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx translationBlockHashes: "_intro": ac1aef55 "Quick start": 7ec68bbf "Serving providers": beb2dd36 - "Schema": f124875a + "Schema": f53ea977 "Examples": 19258aaa --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-2.5-flash-image.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -197,7 +198,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R ### 输入 - 与模型当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + 与模型当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -213,29 +214,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下这些。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。如需了解更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + `data` 或 `fileUri` 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - 可选值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 以原始字节表示的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可以指定 3000 张图像。 + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 - 要以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要内联包含在提示中的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB - Format: `byte` + 格式:`byte` - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下这些。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。如需了解更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + `data` 或 `fileUri` 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - 可选值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分的视频。设置为 “AGENTIC” 可让模型自行决定检查哪些片段,而不是按固定帧率采样。省略则采用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 + 模型如何读取此部分的视频。设置 "AGENTIC" 可让模型决定要检查哪些片段,而不是使用固定帧率采样。省略则使用默认的固定帧率采样。受 gemini-3.7-flash 及更新的 Flash 模型支持。 @@ -243,19 +244,19 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 表示此部分是来自模型的思考/推理步骤。 + 指示此部分是模型的思考/推理步骤。 - 可选值:`user`, `model` + 可能的值:`user`、`model` - 用于生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时应用该默认值,其余字段则回退到模型自身的行为。 + 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 - 图像生成的配置 + 图像生成配置 @@ -263,7 +264,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 可选。已生成图像的图像输出格式。 + 可选。已生成图像的输出格式。 @@ -271,7 +272,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 可选。在 Vertex AI 路径上,输出应保存为的图像格式:由 Comfy 自有凭据提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径上可接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在请求转发前规范化为小写;任何其他值都会被拒绝,并返回指明此字段的 400。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,如果存在该属性会拒绝整个调用,因此该字段会从请求中移除,而不是被接受或拒绝,输出格式由 AI Studio 自行选择。在所有路径上,都请从返回的响应部分中读取媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时为 `fileData.mimeType`),而不要假定你发送的值。 + 可选。输出应保存为的图像格式,适用于 Vertex AI 路径:由 Comfy 自有凭证提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。那里接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;任何其他值都会被拒绝,并返回一个指明此字段的 400。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,如果存在该属性就会拒绝整个调用,因此该字段会从请求中丢弃,而不是被接受或拒绝,输出格式由 AI Studio 自行选择。在每条路径上,都应从收到的响应部分读回媒体类型(`inlineData.mimeType`,或者在设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假设你发送的值。 @@ -279,7 +280,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 响应中可生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大约对应 60-80 个单词。 + 响应中可以生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个词。 范围:`16` 到 `65536` @@ -289,7 +290,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 当 seed 固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的 seed 值,更改模型或参数设置(例如 temperature)也可能导致响应出现变化。默认情况下,会使用随机 seed 值。适用于以下模型:gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + +当种子固定为特定值时,模型会尽力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,使用随机种子值。适用于以下模型:gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -297,7 +299,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - temperature 用于在响应生成期间进行采样,采样在应用 topP 和 topK 时发生。temperature 控制 token 选择过程中的随机程度。较低的 temperature 适合需要较为封闭或缺乏创造性的响应的提示,而较高的 temperature 则可能带来更多样或更具创造性的结果。temperature 为 0 表示始终选择概率最高的 token。在这种情况下,对于给定提示的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了回退响应,请尝试提高 temperature + 温度用于响应生成期间的采样,这一过程会在应用 topP 和 topK 时发生。温度控制 token 选择中的随机程度。较低的温度适合需要不那么开放或不那么有创造性的响应的提示词,而较高的温度可以带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示词的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出回退响应,请尝试提高温度。 范围:`0` 到 `2` @@ -305,32 +307,32 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R - 可选。思考功能的配置。思考是指模型将复杂任务分解为更小的步骤,以生成更高质量响应的过程。 + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤,以生成更高质量响应的过程。 - 可选。如果为 true,模型会在响应中包含其思考内容。 + 可选。如果为 true,模型将在响应中包含其思考内容。 - 可选。模型思考过程的 token 预算。模型将尽最大努力保持在此预算范围内。 + 可选。模型思考过程的 token 预算。模型会尽力保持在此预算内。 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可能值:`THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K 会改变模型选择输出 token 的方式。Top-K 为 1 表示下一个被选择的 token 是模型词表中所有 token 里概率最高的那个。Top-K 为 3 表示使用 temperature 从概率最高的 3 个 token 中选择下一个 token。 + Top-K 会改变模型为输出选择 token 的方式。Top-K 为 1 表示下一个被选择的 token 是模型词表中所有 token 里概率最高的。Top-K 为 3 表示下一个 token 将从概率最高的 3 个 token 中通过温度进行选择。 范围:`1` 到 `…` - 如果指定,则使用核采样(nucleus sampling)。 -Top-P 会改变模型选择输出 token 的方式。token 按概率从最高(参见 top-K)到最低进行选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B、C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会使用 temperature 选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 + 如果指定,则使用核采样。 +Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高(参见 top-K)到最低进行选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型将使用温度选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 范围:`0` 到 `1` @@ -339,37 +341,37 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 用于阻止不安全内容的逐请求设置。在 GenerateContentResponse.candidates 上强制执行。 + 用于阻止不安全内容的按请求设置。在 GenerateContentResponse.candidates 上强制执行。 - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + 可能值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - 可能的值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + 可能值:`OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` - 用于引导模型获得更好表现的指令。例如,“尽可能简洁地回答”或“回答中不要使用技术术语”。这些文本字符串会计入 token 限额。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,并且每个 part 中的内容应位于单独的段落。 + 用于引导模型获得更好表现的指令。例如,“尽可能简洁地回答”或“不要在响应中使用技术术语”。文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,且不会影响模型的表现。注意:parts 中只应使用文本,每个 part 的内容应放在单独的段落中。 - 构成单条消息的有序 part 列表。不同的 part 可能具有不同的 IANA MIME 类型。有关输入的限制,例如最大 token 数或图像数量,请参阅 Google 模型页面上的模型规格。 + 构成单条消息的有序 parts 列表。不同 parts 可能具有不同的 IANA MIME 类型。有关输入限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规格。 - 文本提示或代码片段。 + 文本提示词或代码片段。 - 创建该消息的实体的身份。支持以下值:user:表示该消息由真人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,使用 model 值可将来自模型的消息插入对话中。对于非多轮对话,此字段可以留空或不设置。 + 创建消息的实体身份。支持以下值:user: 这表示消息由真实的人发送,通常是用户生成的消息。model: 这表示消息由模型生成。在多轮对话中,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或未设置。 - 可能的值:`user`、`model` + 可能值:`user`, `model` - 一段代码,使系统能够与外部系统交互,以执行超出模型知识和范围的某个操作或一组操作。请参阅函数调用。 + 一段代码,使系统能够与外部系统交互,以执行模型知识和范围之外的操作或一组操作。参见函数调用。 @@ -389,11 +391,11 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 如果为 true,已生成图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 + 如果为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 在 24 小时后失效。 - 对于视频输入,以 Duration 格式指定视频的起始和结束偏移量。例如,要指定从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式呈现时,才应指定该元数据。 + 用于视频输入时,指定视频的起始和结束偏移量,使用 Duration 格式。例如,要指定从 1:00 开始的一段 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有在视频数据以 inlineData 或 fileData 形式提供时才应指定该元数据。 @@ -401,13 +403,13 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 以纳秒为单位的带符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数部分的负数秒值,其 nanos 值仍必须为非负数。 范围:`0` 到 `999999999` - 时间跨度的带符号秒数。其值必须介于 -315,576,000,000 到 +315,576,000,000(含)之间。 + 时间段的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 范围:`-315576000000` 到 `315576000000` @@ -417,18 +419,18 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 以纳秒为单位的带符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数部分的负数秒值,其 nanos 值仍必须为非负数。 范围:`0` 到 `999999999` - 时间跨度的带符号秒数。其值必须介于 -315,576,000,000 到 +315,576,000,000(含)之间。 + 时间段的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 范围:`-315576000000` 到 `315576000000` -本页内容由 Router 在 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` 提供的 schema 生成,该文档与 Router 在请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前 Router 用于校验调用的文档相同。 ### 输出 @@ -473,7 +475,7 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 与模型进行当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + 与模型当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -489,37 +491,37 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - data 或 fileUri 字段中指定的文件的媒体类型。可接受的值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 以内联原始字节形式提供的数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可指定 3000 张图像。 + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可指定 3000 张图像。 - 要以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要内联包含在提示词中的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB 格式:`byte` - data 或 fileUri 字段中指定的文件的媒体类型。可接受的值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分中的视频。设为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是采用固定速率的帧采样。省略则使用默认的固定速率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 + 模型如何读取此部分中的视频。设置 "AGENTIC" 可让模型决定要检查哪些片段,而不是采用固定帧率采样。省略此项则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 - 文本提示或代码片段。 + 文本提示词或代码片段。 - 表示此部分是模型的思考/推理步骤。 + 指示此部分来自模型的思考/推理步骤。 @@ -539,7 +541,7 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 内容违反指定安全类别(category)的概率 + 内容违反指定安全类别的概率 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -569,7 +571,7 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 可选值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` @@ -587,7 +589,7 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 仅输出。输入中缓存部分(缓存内容)的 token 数量。 + 仅输出。输入中缓存部分(缓存的内容)的 token 数量。 @@ -609,7 +611,7 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 请求中的 token 数量。设置 cachedContent 时,这仍是有效的提示总大小,也就是说其中包含缓存内容中的 token 数量。 + 请求中的 token 数量。设置 cachedContent 时,这仍然是有效的提示总大小,也就是说它包含缓存内容中的 token 数量。 @@ -627,11 +629,11 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - thoughts 输出中的 token 数量。 + 思考输出中存在的 token 数量。 - 工具使用提示中的 token 数量。 + 工具使用提示中存在的 token 数量。 @@ -653,7 +655,7 @@ Top-P 会改变模型选择输出 token 的方式。token 按概率从最高( - 请求使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 + 用于请求的流量类型(例如 PROVISIONED_THROUGHPUT)。 ## 示例 diff --git a/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index 7090fc1558..037773078f 100644 --- a/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -2,17 +2,18 @@ title: "使用 Gemini 3.1 Flash Lite 与 Comfy Router" description: "通过 Comfy Router 调用 vertexai/gemini-3.1-flash-lite:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Gemini 3.1 Flash Lite" -translationSourceHash: 52b7530c +translationSourceHash: 1a291975 translationFrom: development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx translationBlockHashes: "_intro": 408e9eae "Quick start": 869398cb - "Schema": 1d473fa3 + "Schema": 2859a2da "Examples": 2ebce337 --- + {/* 已生成的文件。由 `pnpm code-pages:gen` 从 router-schemas/vertexai/gemini-3.1-flash-lite.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -185,7 +186,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE ### 输入 - 与模型进行的当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + 与模型当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 @@ -201,29 +202,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为一小时。有关详细信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可以指定 3000 张图像。 + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可指定 3000 张图像。 - 要在提示中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定该数据的媒体类型(mimeType)。大小限制:20MB + 要内联包含在提示中的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB 格式:`byte` - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为一小时。有关详细信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是按固定速率进行帧采样。省略则使用默认的固定速率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 + 模型如何读取此部分的视频。设为 "AGENTIC" 可让模型决定检查哪些片段,而不是采用固定帧率采样。省略时采用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上支持。 @@ -231,27 +232,27 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - 表示此部分来自模型的思考/推理步骤。 + 表示此部分是来自模型的思考/推理步骤。 - Possible values: `user`, `model` + 可能的值:`user`、`model` - 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时采用该默认值,其余字段则回退到模型自身的行为。 + 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 - 图像生成的配置 + 图像生成配置 - 已生成图像的宽高比 + 生成图像的宽高比 - 可选。已生成图像的图像输出格式。 + 可选。生成图像的图像输出格式。 @@ -259,15 +260,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - 可选。输出应保存为的图像格式,适用于 Vertex AI 路径:由 Comfy 自身凭据处理的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求前规范化为小写;任何其他值都会被拒绝,并返回一个指明此字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是个例外:该上游没有此属性,只要该字段存在就会拒绝整个调用,因此该字段会从请求中移除,而不是被采用或被拒绝,输出格式则由 AI Studio 自行决定。在所有路径上,都应从你收到的响应部分中读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时为 `fileData.mimeType`),而不是假定你发送的值。 + 可选。在 Vertex AI 路径上,输出应保存为的图像格式:由 Comfy 自身凭据处理的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。此处接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求前规范化为小写;任何其他值都会被拒绝,并返回 400 错误且指明此字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,如果请求中包含此属性,会拒绝整个调用,因此该字段会从请求中移除,而不是被采纳或拒绝,输出格式由 AI Studio 自行选择。在所有路径上,都应从收到的响应部分读回媒体类型(`inlineData.mimeType`,或在设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假设你发送的值。 - 可选。指定已生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 + 可选。指定生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 - 响应中可以生成的最大 token 数。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个单词。 + 响应中可生成的最大 token 数。一个 token 约等于 4 个字符。100 个 token 大致对应 60-80 个词。 范围:`16` 到 `65536` @@ -277,15 +278,16 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - 当 seed 固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的 seed 值,更改模型或参数设置(例如 temperature)也可能导致响应出现变化。默认情况下,会使用随机 seed 值。适用于以下模型:gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 +当 seed 被固定为某个特定值时,模型会尽最大努力对重复请求给出相同的响应,但不保证输出具有确定性。此外,即使使用相同的 seed 值,更改模型或参数设置(例如 temperature)也可能导致响应发生变化。默认情况下会使用随机 seed 值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + - 温度用于在响应生成期间进行采样,采样在应用 topP 和 topK 时发生。温度控制 token 选择的随机程度。较低的温度适合需要较少开放性回答或创意性较低的场景,而较高的温度则可能带来更多样化或更具创意的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了回退响应,请尝试提高温度 + temperature 用于在生成响应期间进行采样,采样在应用 topP 和 topK 时发生。temperature 控制 token 选择的随机程度。较低的温度适合需要较少开放性、较少创造性响应的提示词,而较高的温度可以带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,针对给定提示词的响应基本是确定性的,但仍可能存在少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了兜底响应,可以尝试提高 temperature。 范围:`0` 到 `2` @@ -293,33 +295,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - 可选。思考功能的配置。思考是指模型将复杂任务拆解为更小的步骤,以生成更高质量响应的过程。 + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤以生成更高质量响应的过程。 - 可选。如果为 true,模型会在响应中包含它的思考内容。 + 可选。如果为 true,模型会在响应中包含其思考内容。 - 可选。模型思考过程的 token 预算。模型会尽力控制在此预算范围内。 + 可选。模型思考过程的 token 预算。模型会尽最大努力保持在该预算之内。 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` - Top-K 会改变模型为输出选择 token 的方式。Top-K 为 1 表示下一个被选择的 token 是模型词表中所有 token 里概率最高的。Top-K 为 3 表示借助温度从 3 个概率最高的 token 中选择下一个 token。 + Top-K 会改变模型选择输出 token 的方式。Top-K 为 1 表示下一个被选择的 token 是模型词表中所有 token 里概率最高的那个。Top-K 为 3 表示使用 temperature 从概率最高的 3 个 token 中选择下一个 token。 范围:`1` 到 `…` 如果指定,则使用核采样。 -Top-P 会改变模型为输出选择 token 的方式。token 从概率最高(参见 top-K)到概率最低依次选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,而 top-P 值为 0.5,那么模型会借助温度选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 -为响应随机性较低的场景指定较低的值,为响应随机性较高的场景指定较高的值。 +Top-P 会改变模型选择输出 token 的方式。token 会按概率从最高(参见 top-K)到最低依次选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B、C 的概率分别为 0.3、0.2、0.1,且 top-P 值为 0.5,则模型会使用 temperature 从 A 或 B 中选择下一个 token,并将 C 排除在候选之外。 +指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 范围:`0` 到 `1` @@ -327,7 +329,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 阻止不安全内容的逐请求设置。在 GenerateContentResponse.candidates 上强制执行。 + 用于阻止不安全内容的逐请求设置。会强制执行于 GenerateContentResponse.candidates。 @@ -339,25 +341,25 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 用于引导模型获得更佳表现的指令。例如,“尽可能简洁地回答”或“不要在回答中使用技术术语”。文本字符串会计入 token 上限。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,并且每个 part 中的内容都应放在单独的段落中。 + 用于引导模型获得更好表现的指令。例如,“尽可能简洁地回答”或“不要在响应中使用技术术语”。文本字符串会计入 token 上限。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,且每个 part 中的内容应放在单独的段落中。 - 构成单条消息的有序 parts 列表。不同的 part 可能具有不同的 IANA MIME 类型。有关输入的限制,例如 token 的最大数量或图像数量,请参阅 Google 模型页面上的模型规格。 + 构成单条消息的有序 part 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入限制的信息(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规格。 - 文本提示或代码片段。 + 文本提示词或代码片段。 - 创建该消息的实体的身份。支持以下值:user:表示消息由真实的人发送,通常是用户生成的消息。model:表示消息由模型生成。model 值用于在多轮对话中把来自模型的消息插入对话。对于非多轮对话,此字段可以留空或保持未设置。 + 创建该消息的实体的身份。支持以下值:user:表示该消息由真实的人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,model 值用于将模型的消息插入到对话中。对于非多轮对话,此字段可以留空或不设置。 可能的值:`user`、`model` - 一段代码,使系统能够与外部系统交互,以执行模型知识和范围之外的一个操作或一组操作。请参阅函数调用。 + 一段代码,使系统能够与外部系统交互,以执行超出模型知识和范围的操作或一组操作。参见函数调用。 @@ -377,7 +379,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 若为 true,已生成的图像会被上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 + 若为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而非内联 base64 数据。这些 URL 在 24 小时后过期。 @@ -385,38 +387,38 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 表示视频时间轴位置的时长偏移。 + 表示视频时间轴位置的一个时长偏移量。 - 以纳秒分辨率表示的秒的带符号小数部分。带小数的负秒数值仍必须具有非负的 nanos 值。 + 以纳秒分辨率表示的有符号秒的小数部分。带小数部分的负秒值,其 nanos 值仍必须为非负。 - Range: `0` to `999999999` + 范围:`0` 到 `999999999` - 该时间段的带符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + 时间段的有符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000(含边界)之间。 - Range: `-315576000000` to `315576000000` + 范围:`-315576000000` 到 `315576000000` - 表示视频时间轴位置的时长偏移。 + 表示视频时间轴位置的一个时长偏移量。 - 以纳秒分辨率表示的秒的带符号小数部分。带小数的负秒数值仍必须具有非负的 nanos 值。 + 以纳秒分辨率表示的有符号秒的小数部分。带小数部分的负秒值,其 nanos 值仍必须为非负。 - Range: `0` to `999999999` + 范围:`0` 到 `999999999` - 该时间段的带符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + 时间段的有符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000(含边界)之间。 - Range: `-315576000000` to `315576000000` + 范围:`-315576000000` 到 `315576000000` -根据 Router 在 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前 Router 用于校验调用的文档完全相同。 +以下内容由 Router 在 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用时所使用的同一份文档。 ### 输出 @@ -461,7 +463,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 与模型当前对话的内容。对于单轮查询,这是一个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + 与模型进行当前对话的内容。对于单轮查询,这是一个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 @@ -477,37 +479,37 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长长度为 8.4 小时,视频文件(不含音频)的最长长度为一小时。更多信息请参阅 Gemini 音频和视频依赖项。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 以原始字节形式内联的数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可通过 inlineData 指定 3000 张图像。 + 以原始字节形式内联的数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可指定 3000 张图像。 - 要在提示中内联的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要在提示词中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB 格式:`byte` - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长长度为 8.4 小时,视频文件(不含音频)的最长长度为一小时。更多信息请参阅 Gemini 音频和视频依赖项。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是按固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型决定要检查哪些片段,而不是使用固定帧率采样。省略则使用默认的固定帧率采样。仅在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 - 文本提示或代码片段。 + 文本提示词或代码片段。 - 表示此部分来自模型的思考/推理步骤。 + 表示此部分是模型的思考/推理步骤。 @@ -563,7 +565,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( 内容违反指定安全类别的概率 - 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + 可选值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -575,7 +577,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 仅输出。输入中缓存部分(缓存内容)的 token 数量。 + 仅限输出。输入中缓存部分(即缓存内容)的 token 数量。 @@ -583,13 +585,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 按模态划分的候选 token 明细。 + 按模态划分的候选 token 数量明细。 输入或输出内容的模态类型。 - 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -597,17 +599,17 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 请求中的 token 数量。设置 cachedContent 时,这仍然是提示的总有效大小,也就是说它包含缓存内容中的 token 数量。 + 请求中的 token 数量。设置 cachedContent 时,这仍然表示有效提示的总大小,即包含缓存内容中的 token 数量。 - 按模态划分的提示 token 明细。 + 按模态划分的提示 token 数量明细。 输入或输出内容的模态类型。 - 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -615,21 +617,21 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 思考输出中存在的 token 数量。 + thoughts 输出中的 token 数量。 - 工具使用提示中存在的 token 数量。 + 工具使用提示中的 token 数量。 - 按模态划分的工具使用提示 token 明细。 + 按模态划分的工具使用提示 token 数量明细。 输入或输出内容的模态类型。 - 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` diff --git a/zh/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/zh/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index 29dddb2e2b..4be1716575 100644 --- a/zh/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -2,17 +2,18 @@ title: "使用 Gemini 3.7 Flash 搭配 Comfy Router" description: "通过 Comfy Router 调用 vertexai/gemini-3.7-flash:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Gemini 3.7 Flash" -translationSourceHash: a5b78a88 +translationSourceHash: 059b025e translationFrom: development/comfy-router/models/google/gemini-3-7-flash/code.mdx translationBlockHashes: "_intro": 8eab9a58 "Quick start": b4872308 - "Schema": b5f16a3c + "Schema": cc4c8104 "Examples": 1da8dd0c --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/vertexai/gemini-3.7-flash.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -185,7 +186,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST ### 输入 - 与模型进行当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + 与模型进行的当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -201,29 +202,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长时长为 8.4 小时,视频文件(不含音频)的最长时长为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可以指定 3000 张图像。 + 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,你可以通过 inlineData 指定最多 3000 张图像。 - 要在提示中以内联方式包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定该数据的媒体类型(mimeType)。大小限制:20MB - Format: `byte` + 格式:`byte` - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长时长为 8.4 小时,视频文件(不含音频)的最长时长为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 @@ -231,15 +232,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 表示此部分是模型的思维/推理步骤。 + 表示此部分是模型的思考/推理步骤。 - Possible values: `user`, `model` + 可能的值:`user`、`model` - 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 + 用于生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时应用该默认值,其余字段则回退到模型自身的行为。 @@ -247,11 +248,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 已生成图像的宽高比 + 已生成图像的宽高比例 - 可选。已生成图像的输出格式。 + 可选。已生成图像的图像输出格式。 @@ -259,7 +260,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 可选。在各 Vertex AI 路径上,输出应保存为的图像格式,这些路径包括:由 Comfy 自有凭据提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;任何其他值都会被拒绝,并返回一个指明此字段的 400。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,如果存在该字段就会拒绝整个调用,因此该字段会从请求中删除,而不是被接受或拒绝,输出格式由 AI Studio 自行选择。在所有路径上,都应从收到的响应部分读回媒体类型(`inlineData.mimeType`;设置了 `uploadImagesToStorage` 时为 `fileData.mimeType`),而不要假定你发送的值。 + 可选。输出应保存为的图像格式,适用于 Vertex AI 路径:由 Comfy 自有凭据处理的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前统一转换为小写;任何其他值都会被拒绝,并返回一个指明此字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,一旦出现就会拒绝整个调用,因此该字段会从请求中移除,既不会被采用也不会被拒绝,输出格式由 AI Studio 自行决定。在所有路径上,都应从返回给你的响应部分读取媒体类型(`inlineData.mimeType`,或者设置了 `uploadImagesToStorage` 时的 `fileData.mimeType`),而不要假定你发送的值。 @@ -267,9 +268,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 响应中可生成的最大 token 数。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个单词。 + 响应中可以生成的最大 token 数。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60 到 80 个单词。 - Range: `16` to `65536` + 范围:`16` 至 `65536` @@ -277,7 +278,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST -当种子固定为特定值时,模型会尽力为重复请求提供相同的响应。无法保证输出具有确定性。此外,更改模型或参数设置(例如温度)也可能导致响应出现变化,即使使用相同的种子值。默认情况下,使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + 当种子固定为某个特定值时,模型会尽力对重复请求给出相同的响应。但不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,会使用随机种子值。适用于以下模型:gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -285,7 +286,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 温度用于在生成响应期间进行采样,该过程在应用 topP 和 topK 时发生。温度控制 token 选择中的随机程度。较低的温度适合需要少一些开放式或创造性回答的提示,而较高的温度可以带来更多样或更具创造性的结果。温度为 0 意味着始终选择概率最高的 token。在这种情况下,给定提示的响应基本上是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了回退响应,请尝试提高温度 + 温度用于生成响应期间的采样,采样在应用 topP 和 topK 时进行。温度控制 token 选择的随机程度。较低的温度适合需要更收敛或更少创意响应的提示,而较高的温度则可能带来更多样或更有创意的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应基本是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了兜底响应,请尝试提高温度 范围:`0` 到 `2` @@ -293,32 +294,32 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 可选。思考功能的配置。思考是指模型将复杂任务拆解为更小的步骤,以生成更高质量响应的过程。 + 可选。思考功能的配置。思考是指模型将复杂任务拆解为更小的步骤,从而生成更高质量响应的过程。 - 可选。如果为 true,模型将在响应中包含其思考内容。 + 可选。如果为是,模型将在响应中包含其思考内容。 - 可选。模型思考过程的 token 预算。模型将尽力不超过该预算。 + 可选。模型思考过程的 token 预算。模型将尽力控制在此预算范围内。 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` - Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示下一个被选择的 token 是模型词汇表中所有 token 里概率最高的那个。top-K 为 3 表示下一个 token 是通过温度从概率最高的 3 个 token 中选出的。 + Top-K 会改变模型为输出选择 token 的方式。Top-K 为 1 表示下一个被选择的 token 是模型词表中所有 token 里概率最高的那个。Top-K 为 3 表示下一个 token 是通过温度从概率最高的 3 个 token 中选择的。 范围:`1` 到 `…` 如果指定,则使用核采样。 -Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高(参见 top-K)到最低依次选取,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,而 top-P 值为 0.5,那么模型会通过温度从 A 或 B 中选择下一个 token,并排除 C 作为候选。 +Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最高(参见 top-K)到最低依次选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,而 top-P 值为 0.5,那么模型将通过温度选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 范围:`0` 到 `1` @@ -339,11 +340,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - 用于引导模型获得更好表现的指令。例如,“尽可能简洁地回答”或“在你的回答中不要使用技术术语”。这些文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,不影响模型的表现。注意:parts 中只应使用文本,并且每个 part 中的内容都应放在单独的段落中。 + 用于引导模型获得更好表现的指令。例如"尽可能简洁地回答"或"不要在响应中使用技术术语"。这些文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,不影响模型的表现。注意:parts 中只应使用文本,且每个 part 中的内容应位于单独的段落中。 - 组成单条消息的有序 part 列表。不同的 part 可能具有不同的 IANA MIME 类型。关于输入的限制(例如最大 token 数或图像数量),请参阅 Google models 页面上的模型规范。 + 构成单条消息的有序 part 列表。不同的 part 可以有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规格。 @@ -351,13 +352,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - 创建消息的实体的身份。支持以下值:user:表示消息由真人发送,通常是用户生成的消息。model:表示消息由模型生成。在多轮对话中,使用 model 值可将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或不设置。 + 创建该消息的实体的身份。支持以下值:user:表示该消息由真实的人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,model 值用于将模型的消息插入对话。对于非多轮对话,该字段可以留空或未设置。 可能的值:`user`、`model` - 一段代码,使系统能够与外部系统交互,以执行模型知识和范围之外的一项或多项操作。请参阅函数调用。 + 一段代码,使系统能够与外部系统交互,以在模型的知识和范围之外执行某项操作或一组操作。参见函数调用。 @@ -377,46 +378,46 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - 如果为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联的 base64 数据。这些 URL 将在 24 小时后过期。 + 如果为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 - 对于视频输入,表示视频起始和结束偏移的时长格式。例如,要指定从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 + 对于视频输入,表示视频在 Duration 格式下的起始和结束偏移量。例如,要指定从 1:00 开始的 10 秒片段,请将 "startOffset" 设为 \{ "seconds": 60 },"endOffset" 设为 \{ "seconds": 70 }。只有在视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 - 表示视频时间轴位置的时长偏移。 + 表示视频时间轴位置的时长偏移量。 - 以纳秒为分辨率的有符号秒的小数部分。带小数部分的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数部分的负秒值仍必须具有非负的 nanos 值。 范围:`0` 到 `999999999` - 时间跨度的有符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + 以秒表示的有符号时间跨度。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 范围:`-315576000000` 到 `315576000000` - 表示视频时间轴位置的时长偏移。 + 表示视频时间轴位置的时长偏移量。 - 以纳秒为分辨率的有符号秒的小数部分。带小数部分的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数部分的负秒值仍必须具有非负的 nanos 值。 范围:`0` 到 `999999999` - 时间跨度的有符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + 以秒表示的有符号时间跨度。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 范围:`-315576000000` 到 `315576000000` -根据 Router 在 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于验证调用的文档相同。 +根据 Router 在 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json` 上提供的 schema 生成,这也是在请求到达提供商之前 Router 用于校验调用的同一份文档。 ### 输出 @@ -461,7 +462,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - 与模型进行当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + 与模型当前对话的内容。对于单轮查询,这是一个单一的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 @@ -477,13 +478,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 以原始字节表示的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,你可以通过 inlineData 指定最多 3000 张图像。 @@ -493,13 +494,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型读取此部分视频的方式。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。gemini-3.7-flash 及更新的 Flash 模型支持此项。 + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型决定检查哪些片段,而不是使用固定速率帧采样。省略此项则使用默认的固定速率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 @@ -507,7 +508,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - 表示此部分是模型的思考/推理步骤。 + 指示此部分是否为模型输出的思考/推理步骤。 @@ -557,6 +558,8 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 + 内容违反的指定安全类别 + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` @@ -593,11 +596,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - 给定模态的 token 数量。 + 指定模态的 token 数量。 - 请求中的 token 数量。设置 cachedContent 时,这仍是有效的提示总大小,也就是说它包含缓存内容中的 token 数量。 + 请求中的 token 数量。设置 cachedContent 后,这仍然是有效的提示总大小,即包含缓存内容中的 token 数量。 @@ -611,11 +614,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - 给定模态的 token 数量。 + 指定模态的 token 数量。 - 思考输出中存在的 token 数量。 + 思维输出中存在的 token 数量。 @@ -633,7 +636,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 按概率从最高 - 给定模态的 token 数量。 + 指定模态的 token 数量。 diff --git a/zh/development/comfy-router/models/google/gemini-3-8-flash/code.mdx b/zh/development/comfy-router/models/google/gemini-3-8-flash/code.mdx index f8a55054e4..a297073815 100644 --- a/zh/development/comfy-router/models/google/gemini-3-8-flash/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-3-8-flash/code.mdx @@ -2,17 +2,18 @@ title: "搭配 Comfy Router 使用 Gemini 3.8 Flash" description: "通过 Comfy Router 调用 vertexai/gemini-3.8-flash:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Gemini 3.8 Flash" -translationSourceHash: 723f1618 +translationSourceHash: aec8f1da translationFrom: development/comfy-router/models/google/gemini-3-8-flash/code.mdx translationBlockHashes: "_intro": c76d5ed4 "Quick start": e986a155 - "Schema": e5173b06 + "Schema": ab7655e4 "Examples": 48b9d5db --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-3.8-flash.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -185,7 +186,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST ### 输入 - 与模型当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + 与模型当前对话的内容。对于单轮查询,这里是单个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -201,29 +202,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会占用 token 限额。图像分辨率无限制。 + data 或 fileUri 字段中指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长时长为 8.4 小时,视频文件(无音频)的最长时长为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可指定 3000 张图像。 - 以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要内联包含在提示中的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB - Format: `byte` + 格式:`byte` - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会占用 token 限额。图像分辨率无限制。 + data 或 fileUri 字段中指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长时长为 8.4 小时,视频文件(无音频)的最长时长为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型读取此部分视频的方式。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。受 gemini-3.7-flash 及更新的 Flash 模型支持。 + 模型如何读取此部分的视频。将其设置为 "AGENTIC",可让模型决定要检查哪些片段,而不是采用固定速率帧采样。省略该字段则使用默认的固定速率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 @@ -231,15 +232,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 表示此部分是模型的一个思考/推理步骤。 + 表示此部分为模型的思考/推理步骤。 - Possible values: `user`, `model` + 可能的值:`user`、`model` - 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时应用该默认值,其余字段则回退到模型自身的行为。 + 生成的采样、长度和输出设置。每个字段都是可选的:下方声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 @@ -259,7 +260,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 可选。输出应保存为的图像格式,适用于 Vertex AI 路径:由 Comfy 自有凭证提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在请求转发之前规范化为小写;任何其他值都会被拒绝,并返回一个指明该字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是个例外:该上游没有这样的属性,只要出现该属性就会拒绝整个调用,因此该字段会从请求中移除,而不是被采用或被拒绝,输出格式则由 AI Studio 自行决定。在每条路径上,都应从你所收到的响应部分读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时为 `fileData.mimeType`),而不要假定你发送的值。 + 可选。在 Vertex AI 路径上,输出图像应采用的保存格式:这些路径包括由 Comfy 自有凭证处理的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径接受的值为 `image/png` 和 `image/jpeg`,在转发请求之前会以不区分大小写的方式匹配并规范化为小写;任何其他值都会被拒绝,并返回一个指明此字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此类属性,如果请求中包含该属性,就会拒绝整个调用,因此该字段会从请求中移除,而不是被采纳或拒绝,输出格式为 AI Studio 所选择的格式。在每条路径上,都应从你收到的响应部分中读回媒体类型(`inlineData.mimeType`,或在设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是直接假定为你发送的值。 @@ -267,9 +268,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 响应中可生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60 到 80 个单词。 + 响应中可生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个词。 - Range: `16` to `65536` + 范围:`16` 到 `65536` @@ -277,7 +278,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 当种子固定为特定值时,模型会尽力为重复请求提供相同的响应。但无法保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,会使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 +当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,更改模型或参数设置(例如温度)即使使用相同的种子值,也可能导致响应发生变化。默认情况下,使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 @@ -285,7 +286,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 温度用于在生成响应期间进行采样,该过程在应用 topP 和 topK 时发生。温度控制 token 选择的随机程度。较低的温度适合需要较为封闭或较少创造性的响应的提示,而较高的温度可能带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应基本上是确定性的,但仍可能存在少量变化。如果模型返回的响应过于宽泛、过短,或者模型给出了回退响应,请尝试提高温度 + 温度用于响应生成过程中的采样,该过程在应用 topP 和 topK 时发生。温度控制 token 选择的随机程度。较低的温度适合需要较少开放性或创造性响应的提示,而较高的温度可能产生更多样或更具创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应大多是确定性的,但仍可能有少量变化。如果模型返回的响应过于通用、过于简短,或者模型给出回退响应,请尝试提高温度 范围:`0` 到 `2` @@ -293,33 +294,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - 可选。思考功能的配置。思考是指模型将复杂任务拆解为更小的步骤,从而生成更高质量响应的过程。 + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤以生成更高质量响应的过程。 - 可选。如果为 true,模型会在响应中包含其思考过程。 + 可选。如果为 true,模型将在响应中包含其思考内容。 - 可选。模型思考过程的 token 预算。模型会尽力保持在该预算范围内。 + 可选。模型思考过程的 token 预算。模型将尽最大努力保持在此预算内。 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` - Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示所选的下一个 token 是模型词汇表中所有 token 里概率最高的一个。top-K 为 3 表示通过使用温度从前 3 个概率最高的 token 中选择下一个 token。 + Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示下一个选中的 token 是模型词汇表中所有 token 里概率最高的。top-K 为 3 表示使用温度从 3 个最可能的 token 中选择下一个 token。 范围:`1` 到 `…` 如果指定,则使用核采样。 -Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最高(参见 top-K)到最低进行选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会通过使用温度选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 -指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 +Top-P 会改变模型为输出选择 token 的方式。从概率最高(参见 top-K)到概率最低的 token 中选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,而 top-P 值为 0.5,则模型将使用温度选择 A 或 B 作为下一个 token,并排除 C 作为候选。 +指定较低的值可获得随机性较低的响应,指定较高的值可获得随机性较高的响应。 范围:`0` 到 `1` @@ -339,11 +340,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 用于引导模型以获得更好表现的指令。例如,"尽可能简洁地回答"或"不要在响应中使用技术术语"。文本字符串会计入 token 上限。systemInstruction 的 role 字段会被忽略,且不会影响模型的表现。注意:parts 中应仅使用文本,且每个 part 中的内容应位于单独的段落中。 + 用于引导模型获得更好性能的指令。例如,“尽可能简洁地回答”或“不要在回答中使用技术术语”。文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,并且不影响模型的性能。注意:parts 中只应使用文本,并且每个 part 中的内容应位于单独的段落中。 - 构成单条消息的有序 part 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入的限制,例如最大 token 数或图像数量,请参阅 Google 模型页面上的模型规格。 + 组成单条消息的有序 parts 列表。不同的 parts 可能具有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规范。 @@ -351,13 +352,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 创建该消息的实体的身份。支持以下值:user:表示该消息由真人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,使用 model 值可将模型的消息插入到对话中。对于非多轮对话,该字段可以留空或不设置。 + 创建消息的实体的身份。支持以下值:user: 这表示消息由真实人员发送,通常是用户生成的消息。model: 这表示消息由模型生成。在多轮对话期间,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或未设置。 可能的值:`user`、`model` - 一段代码,使系统能够与外部系统交互,以执行超出模型知识范围与能力范围的操作或一组操作。请参阅 Function calling。 + 一段代码,使系统能够与外部系统交互,以执行模型知识和范围之外的一个操作或一组操作。请参阅函数调用。 @@ -377,11 +378,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 如果为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 + 若为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联的 base64 数据。这些 URL 在 24 小时后过期。 - 对于视频输入,表示视频的起始和结束偏移量,采用 Duration 格式。例如,要指定一段从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有当视频数据以 inlineData 或 fileData 形式呈现时,才应指定该元数据。 + 对于视频输入,指定视频的起始和结束偏移量,采用时长格式。例如,要指定从 1:00 开始、长 10 秒的片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 @@ -389,13 +390,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 以纳秒分辨率表示的有符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数部分的负秒值其纳秒值仍必须为非负。 范围:`0` 到 `999999999` - 时间跨度的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含端点)。 + 时间段的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 范围:`-315576000000` 到 `315576000000` @@ -405,18 +406,18 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 以纳秒分辨率表示的有符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数部分的负秒值其纳秒值仍必须为非负。 范围:`0` 到 `999999999` - 时间跨度的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含端点)。 + 时间段的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 范围:`-315576000000` 到 `315576000000` -本文档由 Router 在 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前 Router 用来验证调用的同一份文档。 +本内容根据 Router 在 `GET /v2/models/vertexai/gemini-3.8-flash/openapi.json` 提供的 schema 生成,该文档与 Router 在请求到达提供商之前校验调用时所用的文档相同。 ### 输出 @@ -461,7 +462,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 与模型进行的当前对话的内容。对于单轮查询,这是单个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + 与模型当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -477,29 +478,29 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + 可能的值:`application/pdf`,`audio/mpeg`,`audio/mp3`,`audio/wav`,`image/png`,`image/jpeg`,`image/webp`,`text/plain`,`video/mov`,`video/mpeg`,`video/mp4`,`video/mpg`,`video/avi`,`video/wmv`,`video/mpegps`,`video/flv`,`image/heic`,`image/heif`,`audio/flac`,`video/webm` - 以内联方式提供的原始字节数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可指定 3000 张图像。 - 以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要内联包含在提示中的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB 格式:`byte` - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + 可能的值:`application/pdf`,`audio/mpeg`,`audio/mp3`,`audio/wav`,`image/png`,`image/jpeg`,`image/webp`,`text/plain`,`video/mov`,`video/mpeg`,`video/mp4`,`video/mpg`,`video/avi`,`video/wmv`,`video/mpegps`,`video/flv`,`image/heic`,`image/heif`,`audio/flac`,`video/webm` - 模型读取此部分的视频的方式。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。受 gemini-3.7-flash 及更新的 Flash 模型支持。 + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 @@ -507,11 +508,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 指示此部分是模型的思考/推理步骤。 + 表示此部分是来自模型的思考/推理步骤。 - 可能的值:`user`、`model` + 可能的值:`user`,`model` @@ -523,17 +524,17 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`,`HARM_CATEGORY_HATE_SPEECH`,`HARM_CATEGORY_HARASSMENT`,`HARM_CATEGORY_DANGEROUS_CONTENT` 内容违反指定安全类别的概率 - 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + 可能的值:`NEGLIGIBLE`,`LOW`,`MEDIUM`,`HIGH`,`UNKNOWN` - 创建响应时的时间戳。 + 响应创建时的时间戳。 @@ -557,11 +558,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 + 内容违反的安全类别 + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - 内容违反指定安全类别的概率。 + 内容违反指定安全类别的概率 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -575,7 +578,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 仅输出。输入中缓存部分(即缓存内容)的 token 数量。 + 仅输出。输入中缓存部分(缓存内容)的 token 数量。 @@ -597,11 +600,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 请求中的 token 数量。设置 cachedContent 时,这仍然是提示词的有效总大小,也就是说它包含缓存内容中的 token 数量。 + 请求中的 token 数量。当设置了 cachedContent 时,这仍然是有效的提示总大小,也就是说这包括缓存内容中的 token 数量。 - 按模态划分的提示词 token 明细。 + 按模态划分的提示 token 明细。 @@ -615,15 +618,15 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - thoughts 输出中包含的 token 数量。 + 思维输出中存在的 token 数量。 - 工具使用提示词中包含的 token 数量。 + 工具使用提示中存在的 token 数量。 - 按模态划分的工具使用提示词 token 明细。 + 按模态划分的工具使用提示 token 明细。 @@ -637,11 +640,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - token 总数(提示词 + 候选)。 + token 总数(提示 + 候选)。 - 请求使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 + 用于请求的流量类型(例如 PROVISIONED_THROUGHPUT)。 ## 示例 From 0b4fc9ebb4f3ddf00f5a4093960ab3d8652b8248 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Fri, 13 Nov 2026 11:27:44 +0800 Subject: [PATCH 25/36] i18n: add zh/ja/ko pages for the Gemini 4 model family; sync nano-banana-2-1 --- .../models/google/gemini-4-argon/code.mdx | 692 +++++++++++++++++ .../models/google/gemini-4-carbon/code.mdx | 689 +++++++++++++++++ .../models/google/gemini-4-hydrogen/code.mdx | 690 +++++++++++++++++ .../google/gemini-nano-banana-2-1/code.mdx | 137 ++-- .../models/google/gemini-4-argon/code.mdx | 688 +++++++++++++++++ .../models/google/gemini-4-carbon/code.mdx | 691 +++++++++++++++++ .../models/google/gemini-4-hydrogen/code.mdx | 690 +++++++++++++++++ .../google/gemini-nano-banana-2-1/code.mdx | 107 +-- .../models/google/gemini-4-argon/code.mdx | 688 +++++++++++++++++ .../models/google/gemini-4-carbon/code.mdx | 693 +++++++++++++++++ .../models/google/gemini-4-hydrogen/code.mdx | 694 ++++++++++++++++++ .../google/gemini-nano-banana-2-1/code.mdx | 147 ++-- 12 files changed, 6412 insertions(+), 194 deletions(-) create mode 100644 ja/development/comfy-router/models/google/gemini-4-argon/code.mdx create mode 100644 ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx create mode 100644 ja/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx create mode 100644 ko/development/comfy-router/models/google/gemini-4-argon/code.mdx create mode 100644 ko/development/comfy-router/models/google/gemini-4-carbon/code.mdx create mode 100644 ko/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx create mode 100644 zh/development/comfy-router/models/google/gemini-4-argon/code.mdx create mode 100644 zh/development/comfy-router/models/google/gemini-4-carbon/code.mdx create mode 100644 zh/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx diff --git a/ja/development/comfy-router/models/google/gemini-4-argon/code.mdx b/ja/development/comfy-router/models/google/gemini-4-argon/code.mdx new file mode 100644 index 0000000000..4ae0571753 --- /dev/null +++ b/ja/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -0,0 +1,692 @@ +--- +title: "Comfy Router で Gemini 4 Argon を使用する" +description: "Comfy Router 経由で vertexai/gemini-4-argon を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "Gemini 4 Argon" +translationSourceHash: 913b7628 +translationFrom: development/comfy-router/models/google/gemini-4-argon/code.mdx +translationBlockHashes: + "_intro": 37c83dd8 + "Quick start": 9453b03d + "Schema": 1ff628d6 + "Examples": 046e90e1 +--- + +{/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/vertexai/gemini-4-argon.json から生成されています。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`vertexai/gemini-4-argon` の API リファレンスです。Comfy Router が Google から提供しています。 + +**入力:** テキスト、画像、オーディオ、ビデオ · **出力:** テキスト + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しています。cURL のスニペットは、生の HTTP 経由で同じ呼び出しを行います。 + +**モデル ID:** `vertexai/gemini-4-argon` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-argon` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動再試行のために再利用します。 +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-argon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動再試行のために再利用します。 +const { data } = await comfy.models.run("vertexai/gemini-4-argon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備ができた時点で、このプロセスまたは別のプロセスから収集されます。[キューの配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境から COMFY_API_KEY を読み取ります。 +# submit() を呼び出すたびに独自の Idempotency-Key を生成し、自動再試行のために再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-argon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスに必要な情報はこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After を待ちます。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 + # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境から COMFY_API_KEY を読み取ります。 +// submit() を呼び出すたびに独自の Idempotency-Key を生成し、自動再試行のために再利用します。 +const handle = await comfy.models.submit("vertexai/gemini-4-argon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 送信します。Router は 201 と request_id、status_url、response_url、cancel_url を返します。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒を待ちます。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集します。200 はモデルのネイティブ出力、202 は実行中の場合のステータスボディです。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + モデルとの現在の会話のコンテンツ。単一ターンのクエリでは 1 つのインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + + + + + + + + URI ベースのデータ。 + + + + URI + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン上限に算入されます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 生のバイト列によるインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ上限: 20MB + + 形式: `byte` + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン上限に算入されます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + モデルがこのパートのビデオをどのように読み取るか。"AGENTIC" を設定すると、固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを決定できるようになります。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash およびそれ以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペット。 + + + + このパートがモデルによる思考/推論ステップであることを示します。 + + + + 指定可能な値: `user`、`model` + + + + 生成のためのサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値を適用し、それ以外はモデル自身の動作にフォールバックします。 + + + + 画像生成の設定 + + + + 生成画像のアスペクト比 + + + + 任意。生成画像の画像出力形式。 + + + + 任意。出力画像の圧縮品質。 + + + + 任意。出力を保存する画像形式です。Vertex AI の経路、つまり Comfy 自身の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエストに適用されます。そこで受け入れられる値は `image/png` と `image/jpeg` で、大文字と小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。その上流にはそのようなプロパティが存在せず、存在する場合は呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を仮定するのではなく、受け取ったレスポンスのパート(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み戻してください。 + + + + 任意。生成画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値 1K を使用します。 + + + + レスポンスで生成できる最大トークン数。1 トークンは約 4 文字です。100 トークンはおよそ 60~80 語に相当します。 + + 範囲: `16` から `65536` + + + + + + + + +シードを特定の値に固定した場合、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。次のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature は、応答生成中のサンプリングに使用され、topP と topK が適用されるときに実行されます。temperature はトークン選択のランダム性の度合いを制御します。低い temperature は、自由度が低い応答や創造性が低い応答を必要とするプロンプトに適しており、高い temperature はより多様な結果や創造的な結果につながる可能性があります。temperature が 0 の場合、最も確率の高いトークンが常に選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的ですが、少量のばらつきは依然として発生する可能性があります。モデルが一般的すぎる応答や短すぎる応答を返す場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください。 + + 範囲: `0` から `2` + + 形式: `float` + + + + 任意。思考機能の設定。思考とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。 + + + + 任意。true の場合、モデルは応答に思考内容を含めます。 + + + + 任意。モデルの思考プロセスに割り当てるトークン予算。モデルはこの予算内に収まるよう最善を尽くします。 + + + + 任意。モデルの思考レベル。 + + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` + + + + Top-K は、モデルが出力用のトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率が高いものです。Top-K が 3 の場合、次に選択されるトークンは、temperature を使用して、最も確率が高い 3 つのトークンの中から選択されます。 + + 範囲: `1` から `…` + + + + 指定した場合、ニュークリアスサンプリングが使用されます。 +Top-P は、モデルが出力用のトークンを選択する方法を変更します。トークンは、確率の合計が top-P の値に等しくなるまで、最も高い確率(top-K を参照)から最も低い確率へと選択されます。たとえば、トークン A、B、C の確率が 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B を次のトークンとして選択し、C は候補から除外します。 +ランダム性の低い応答には低い値を、ランダム性の高い応答には高い値を指定します。 + + 範囲: `0` から `1` + + 形式: `float` + + + + 安全でないコンテンツをブロックするためのリクエストごとの設定。GenerateContentResponse.candidates に適用されます。 + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + モデルをより良いパフォーマンスへ導くための指示。たとえば、「できるだけ簡潔に答えてください」または「応答に技術用語を使用しないでください」。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part のコンテンツは別々の段落にしてください。 + + + + 単一のメッセージを構成する順序付きの parts のリスト。part ごとに異なる IANA MIME タイプを持つ場合があります。トークンの最大数や画像の数など、入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + + + + テキストプロンプトまたはコードスニペット。 + + + + メッセージを作成するエンティティの識別情報。次の値がサポートされています: user: これはメッセージが実在の人物によって送信されることを示し、通常はユーザーが生成したメッセージです。model: これはメッセージがモデルによって生成されることを示します。model 値は、マルチターン会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンではない会話では、このフィールドは空欄のままにするか、未設定にできます。 + + 指定可能な値: `user`, `model` + + + + システムがモデルの知識と範囲外でアクションまたは一連のアクションを実行するために、外部システムとやり取りできるようにするコード片。Function calling を参照してください。 + + + + + + + + + + + + + + + + 関数のパラメータ用の JSON スキーマ + + + + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 + + + + ビデオ入力の場合、ビデオの開始オフセットと終了オフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒間のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。このメタデータは、ビデオデータが inlineData または fileData で提供されている場合にのみ指定してください。 + + + + ビデオタイムライン上の位置に対する再生時間オフセットを表します。 + + + + ナノ秒解像度での秒の符号付き小数部分。小数部分を含む負の秒値であっても、nanos 値は非負でなければなりません。 + + 範囲: `0` から `999999999` + + + + 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 + + 範囲: `-315576000000` から `315576000000` + + + + ビデオタイムライン上の位置に対する再生時間オフセットを表します。 + + + + ナノ秒解像度での秒の符号付き小数部分。小数部分を含む負の秒値であっても、nanos 値は非負でなければなりません。 + + 範囲: `0` から `999999999` + + + + 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 + + 範囲: `-315576000000` から `315576000000` + + +Router が `GET /v2/models/vertexai/gemini-4-argon/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使うドキュメントと同じものです。 + +### 出力 + + + + + + + + + + + + + + + + + + + + + + + + + + + 形式: `date` + + + + + + + + + + + + + + + + モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + + + + + + + + URI ベースのデータ。 + + + + URI + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像解像度に制限はありません。 + + 可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 生のバイトでのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash の場合、inlineData を使用して最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + + 形式: `byte` + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像解像度に制限はありません。 + + 可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + モデルがこのパートのビデオを読み取る方法。"AGENTIC" を設定すると、固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを決定できます。デフォルトの固定レートサンプリングの場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペット。 + + + + このパートがモデルからの思考/推論ステップであることを示します。 + + + + 可能な値: `user`, `model` + + + + + + + + + + + + 可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全カテゴリに違反する確率 + + 可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + レスポンスが作成されたタイムスタンプ。 + + + + レスポンスの生成に使用されたモデルバージョン。 + + + + + + + + + + + + + + + + + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全性カテゴリに違反する確率 + + 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + レスポンスの一意の識別子。 + + + + + + + + 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 + + + + レスポンス内のトークン数。 + + + + モダリティ別の候補トークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトサイズの合計を表し、キャッシュされたコンテンツ内のトークン数を含みます。 + + + + モダリティ別のプロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + thoughts 出力に含まれるトークン数。 + + + + ツール使用プロンプトに含まれるトークン数。 + + + + モダリティ別のツール使用プロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + トークンの合計数(プロンプト + 候補)。 + + + + リクエストに使用されるトラフィックタイプ(例: PROVISIONED_THROUGHPUT)。 + + +## 例 + +### 入力 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 出力 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-argon", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + diff --git a/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx new file mode 100644 index 0000000000..cc254e3ccd --- /dev/null +++ b/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -0,0 +1,689 @@ +--- +title: "Comfy Router で Gemini 4 Carbon を使用する" +description: "Comfy Router 経由で vertexai/gemini-4-carbon を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "Gemini 4 Carbon" +translationSourceHash: c107edac +translationFrom: development/comfy-router/models/google/gemini-4-carbon/code.mdx +translationBlockHashes: + "_intro": 8eafb327 + "Quick start": a26083eb + "Schema": 1046bf02 + "Examples": b2720522 +--- +{/* 生成済みファイル。router-schemas/vertexai/gemini-4-carbon.json から `pnpm code-pages:gen` によって生成されています。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +Google が提供し、Comfy Router が配信する `vertexai/gemini-4-carbon` の API リファレンスです。 + +**入力:** テキスト、画像、オーディオ、ビデオ · **出力:** テキスト + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しており、cURL のスニペットは同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `vertexai/gemini-4-carbon` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-carbon` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動リトライ時に再利用します。 +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-carbon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動リトライ時に再利用します。 +const { data } = await comfy.models.run("vertexai/gemini-4-carbon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests` に送信します。Router は実行が受け付けられるとすぐに `request_id` とともに `201` を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも取得できます。[キューの配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、取得の流れを説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライ時に再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-carbon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスに必要なのはこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 + # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライ時に再利用します。 +const handle = await comfy.models.submit("vertexai/gemini-4-carbon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 送信。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 取得。モデルのネイティブ出力とともに 200、まだ実行中はステータスボディとともに 202 を返します。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + + + + + + + + URIベースのデータです。 + + + + URI + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 生のバイト列によるインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使って最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコードです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + + 形式: `byte` + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + モデルがこのパートのビデオをどのように読み取るかです。固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを判断できるようにするには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペットです。 + + + + このパートがモデルによる思考/推論のステップであることを示します。 + + + + 指定可能な値: `user`、`model` + + + + 生成のためのサンプリング、長さ、出力の設定です。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。 + + + + 画像生成の設定です + + + + 生成される画像のアスペクト比です + + + + 任意。生成される画像の画像出力形式です。 + + + + 任意。出力画像の圧縮品質です。 + + + + 任意。出力を保存する画像形式で、Vertex AI の経路(Comfy 自身の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエスト)に適用されます。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールド名を示す 400 エラーで拒否されます。省略時は `image/png` がデフォルトになります。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームにはこのプロパティが存在せず、含まれていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を前提とするのではなく、返されたレスポンスのパート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み戻してください。 + + + + 任意。生成される画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 + + + + レスポンスで生成できるトークンの最大数です。1 トークンは約 4 文字に相当します。100 トークンはおおよそ 60~80 語に相当します。 + + 範囲: `16` から `65536` + + + + + + + When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requestsでは、シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じレスポンスを返すよう最善を尽くします。決定的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用していてもレスポンスにばらつきが生じることがあります。デフォルトではランダムなシード値が使用されます。次のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature はレスポンス生成中のサンプリングに使用され、topP と topK が適用される際に作用します。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由度や創造性を必要としないプロンプトに適しており、高い temperature はより多様で創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対するレスポンスはほぼ決定的になりますが、わずかなばらつきが生じる可能性は残ります。モデルが返すレスポンスが一般的すぎる、短すぎる、またはフォールバックのレスポンスを返す場合は、temperature を上げてみてください。 + + 範囲: `0` から `2` + + 形式: `float` + + + + 省略可能。Thinking 機能の設定です。Thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質なレスポンスを生成するプロセスです。 + + + + 省略可能。true の場合、モデルはレスポンスに自身の思考を含めます。 + + + + 省略可能。モデルの Thinking プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + + + + 省略可能。モデルの Thinking レベルです。 + + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` + + + + top-K はモデルが出力用のトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙全体の中で最も確率の高いトークンになります。top-K が 3 の場合、次に選択されるトークンは確率の高い上位 3 個のトークンの中から temperature を用いて選択されます。 + + 範囲: `1` から `…` + + + + 指定した場合、nucleus サンプリングが使用されます。 +top-P はモデルが出力用のトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率が高いもの(top-K を参照)から低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を用いて A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 +ランダム性を抑えたレスポンスにしたい場合は低い値を、よりランダムなレスポンスにしたい場合は高い値を指定してください。 + + 範囲: `0` から `1` + + 形式: `float` + + + + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に対して適用されます。 + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + モデルのパフォーマンスを高めるための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答では専門用語を使わないでください」などがあります。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各パートのコンテンツは個別の段落に入れる必要があります。 + + + + 1 つのメッセージを構成する順序付きのパートのリストです。パートごとに異なる IANA MIME タイプを使用できます。最大トークン数や画像の数などの入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + + + + テキストプロンプトまたはコードスニペット。 + + + + メッセージを作成するエンティティの識別子です。次の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが作成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターン以外の会話では、このフィールドは空のままにするか、未設定にできます。 + + 指定可能な値: `user`, `model` + + + + システムがモデルの知識と範囲の外にあるアクションまたは一連のアクションを実行するために、外部システムとやり取りできるようにするコードです。Function calling を参照してください。 + + + + + + + + + + + + + + + + 関数のパラメータ用の JSON スキーマ + + + + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に失効します。 + + + + ビデオ入力の場合、Duration 形式でのビデオの開始オフセットと終了オフセット。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 + + + + ビデオタイムライン上の位置に対する再生時間オフセットを表します。 + + + + ナノ秒解像度での秒の符号付き小数部。小数を含む負の秒値であっても、nanos 値は非負でなければなりません。 + + 範囲: `0` から `999999999` + + + + 時間スパンの符号付き秒。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + + 範囲: `-315576000000` から `315576000000` + + + + ビデオタイムライン上の位置に対する再生時間オフセットを表します。 + + + + ナノ秒解像度での秒の符号付き小数部。小数を含む負の秒値であっても、nanos 値は非負でなければなりません。 + + 範囲: `0` から `999999999` + + + + 時間スパンの符号付き秒。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + + 範囲: `-315576000000` から `315576000000` + + +Router が `GET /v2/models/vertexai/gemini-4-carbon/openapi.json` で提供するスキーマ、つまりリクエストがプロバイダーに到達する前に呼び出しの検証に使用するのと同じドキュメントから生成されています。 + +### 出力 + + + + + + + + + + + + + + + + + + + + + + + + + + + 形式: `date` + + + + + + + + + + + + + + + + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + + + + + + + + URI ベースのデータ。 + + + + URI + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル (音声なし) の最大長は 1 時間です。詳細は Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 生のバイト列によるインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ (mimeType) も指定する必要があります。サイズ制限: 20MB + + 形式: `byte` + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash の場合、オーディオファイルの最大長は 8.4 時間、ビデオファイル (音声なし) の最大長は 1 時間です。詳細は Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + モデルがこのパートのビデオをどのように読み取るか。固定レートのフレームサンプリングではなく、モデルに検査するセグメントを判断させる場合は "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペット。 + + + + このパートがモデルによる思考/推論のステップであることを示します。 + + + + 指定可能な値: `user`, `model` + + + + + + + + + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全性カテゴリに違反する確率 + + 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 応答が作成されたタイムスタンプ。 + + + + 応答の生成に使用されたモデルのバージョン。 + + + + + + + + + + + + + + + + + + + + Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全性カテゴリに違反する確率 + + Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + レスポンスの一意の識別子。 + + + + + + + + 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 + + + + レスポンス内のトークン数。 + + + + モダリティ別の候補トークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 + + + + モダリティ別のプロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + thoughts 出力に含まれるトークン数。 + + + + ツール使用プロンプトに含まれるトークン数。 + + + + モダリティ別のツール使用プロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + トークンの合計数(プロンプト + 候補)。 + + + + リクエストに使用されるトラフィックタイプ(例: PROVISIONED_THROUGHPUT)。 + + +## 例 + +### 入力 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 出力 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-carbon", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + diff --git a/ja/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx b/ja/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx new file mode 100644 index 0000000000..97cabef00c --- /dev/null +++ b/ja/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx @@ -0,0 +1,690 @@ +--- +title: "Gemini 4 Hydrogen を Comfy Router で使用する" +description: "Comfy Router 経由で vertexai/gemini-4-hydrogen を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "Gemini 4 Hydrogen" +translationSourceHash: 2fc4f945 +translationFrom: development/comfy-router/models/google/gemini-4-hydrogen/code.mdx +translationBlockHashes: + "_intro": 1792fa1e + "Quick start": 6dd0010d + "Schema": 3edab77e + "Examples": 3698dfec +--- +{/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-4-hydrogen.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +Google の Comfy Router が提供する `vertexai/gemini-4-hydrogen` の API リファレンスです。 + +**入力:** テキスト、画像、オーディオ、ビデオ · **出力:** テキスト + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しており、cURL のスニペットは同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `vertexai/gemini-4-hydrogen` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動リトライ時に再利用します。 +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-hydrogen", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動リトライ時に再利用します。 +const { data } = await comfy.models.run("vertexai/gemini-4-hydrogen", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備ができ次第、このプロセスまたは別のプロセスから取得します。[キューの配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、取得の流れを順を追って説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライ時に再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-hydrogen", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスに必要な情報はこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 + # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライ時に再利用します。 +const handle = await comfy.models.submit("vertexai/gemini-4-hydrogen", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 送信。Router は request_id、status_url、response_url、cancel_url を伴う 201 を返します。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 取得。200 はモデルのネイティブ出力、まだ実行中であれば 202 とステータスボディを返します。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは 1 つのインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + + + + + + + + URI ベースのデータ。 + + + + URI + + + + data または fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + + 形式: `byte` + + + + data または fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + モデルがこのパートのビデオを読み取る方法。固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペット。 + + + + このパートがモデルからの思考/推論ステップであることを示します。 + + + + 指定可能な値: `user`、`model` + + + + 生成のためのサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外のフィールドはモデル自身の動作に従います。 + + + + 画像生成の設定 + + + + 生成画像のアスペクト比 + + + + 任意。生成画像の画像出力形式。 + + + + 任意。出力画像の圧縮品質。 + + + + 任意。出力を保存する画像形式です。Vertex AI の経路、すなわち Comfy 自身の認証情報で処理されるリクエストと、GCP サービスアカウントで認証された BYOK リクエストが対象です。そこでの許容値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームにはそのようなプロパティがなく、存在すると呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を前提とせず、受け取ったレスポンスのパート(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 + + + + 任意。生成画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 + + + + レスポンスで生成できるトークンの最大数。1 トークンはおよそ 4 文字です。100 トークンはおよそ 60 ~ 80 語に相当します。 + + 範囲: `16` から `65536` + + + + + + + + シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature は応答生成中のサンプリングに使用され、topP と topK が適用される際に機能します。temperature はトークン選択のランダム性の度合いを制御します。低い temperature は、自由度が低く創造性を要さない応答が求められるプロンプトに適しており、高い temperature ではより多様で創造的な結果が得られます。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定的になりますが、わずかなばらつきが生じる可能性は残ります。モデルの応答が一般的すぎる、短すぎる、またはフォールバック応答が返される場合は、temperature を上げてみてください + + 範囲: `0` から `2` + + 形式: `float` + + + + オプション。思考機能の設定です。思考とは、モデルが複雑なタスクをより小さなステップに分解し、より高品質な応答を生成するプロセスです。 + + + + オプション。true の場合、モデルは応答に自身の思考を含めます。 + + + + オプション。モデルの思考プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + + + + オプション。モデルの思考レベルです。 + + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` + + + + Top-K は、モデルが出力するトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率が高いものになります。Top-K が 3 の場合、次に選択されるトークンは、temperature を用いて確率が上位 3 のトークンの中から選択されます。 + + 範囲: `1` から `…` + + + + 指定した場合、nucleus サンプリングが使用されます。 +Top-P は、モデルが出力するトークンを選択する方法を変更します。トークンは、確率の合計が top-P の値に等しくなるまで、最も確率が高いもの (top-K を参照) から低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を用いて A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 +ランダム性の低い応答には低い値を、ランダム性の高い応答には高い値を指定してください。 + + 範囲: `0` から `1` + + 形式: `float` + + + + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に対して適用されます。 + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 指定可能な値: `OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + + + + モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答では専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各パートのコンテンツは別々の段落にしてください。 + + + + 1 つのメッセージを構成する、順序付けられたパートのリストです。パートごとに異なる IANA MIME タイプを使用できます。トークンの最大数や画像の数などの入力制限については、Google モデルページのモデル仕様を参照してください。 + + + + テキストプロンプトまたはコードスニペット。 + + + + メッセージを作成するエンティティの識別情報です。以下の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空欄または未設定のままにできます。 + + 指定可能な値: `user`、`model` + + + + システムがモデルの知識や範囲の外にあるアクション、またはアクションの集合を実行するために外部システムとやり取りできるようにするコードの断片です。関数呼び出しを参照してください。 + + + + + + + + + + + + + + + + 関数パラメータの JSON スキーマ + + + + true の場合、生成済み画像はクラウドストレージにアップロードされ、インラインの base64 データの代わりに署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 + + + + ビデオ入力の場合、Duration 形式によるビデオの開始オフセットと終了オフセット。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提供される場合にのみ指定してください。 + + + + ビデオタイムライン上の位置に対する再生時間のオフセットを表します。 + + + + ナノ秒解像度での秒の符号付き小数部。小数部を含む負の秒値であっても、nanos 値は非負である必要があります。 + + 範囲: `0` から `999999999` + + + + 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 + + 範囲: `-315576000000` から `315576000000` + + + + ビデオタイムライン上の位置に対する再生時間のオフセットを表します。 + + + + ナノ秒解像度での秒の符号付き小数部。小数部を含む負の秒値であっても、nanos 値は非負である必要があります。 + + 範囲: `0` から `999999999` + + + + 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 + + 範囲: `-315576000000` から `315576000000` + + +スキーマから生成されています。このスキーマは Router が `GET /v2/models/vertexai/gemini-4-hydrogen/openapi.json` で提供しているもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 + +### 出力 + + + + + + + + + + + + + + + + + + + + + + + + + + + 形式: `date` + + + + + + + + + + + + + + + + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは、これは単一のインスタンスになります。マルチターンのクエリでは、これは会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + + + + + + + + URI ベースのデータ。 + + + + URI + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 生バイトのインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + + + + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコードです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ上限: 20MB + + 形式: `byte` + + + + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 + + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + モデルがこのパートのビデオをどのように読み取るか。固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを判断できるようにするには "AGENTIC" を設定します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + + + + テキストプロンプトまたはコードスニペット。 + + + + このパートがモデルからの思考/推論ステップであることを示します。 + + + + 指定可能な値: `user`, `model` + + + + + + + + + + + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全性カテゴリに違反する確率 + + 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + レスポンスが作成されたタイムスタンプ。 + + + + レスポンスの生成に使用されたモデルのバージョン。 + + + + + + + + + + + + + + + + + + + + Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + コンテンツが指定された安全カテゴリに違反する確率 + + 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + レスポンスの一意の識別子。 + + + + + + + + 出力専用。入力のキャッシュ部分 (キャッシュされたコンテンツ) のトークン数。 + + + + レスポンス内のトークン数。 + + + + モダリティ別の候補トークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数を含みます。 + + + + モダリティ別のプロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + 思考の出力に含まれるトークン数。 + + + + ツール使用プロンプトに含まれるトークン数。 + + + + モダリティ別のツール使用プロンプトトークンの内訳。 + + + + 入力または出力コンテンツのモダリティの種類。 + + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 指定されたモダリティのトークン数。 + + + + トークンの合計数 (プロンプト + 候補)。 + + + + リクエストに使用されたトラフィックタイプ (例: PROVISIONED_THROUGHPUT)。 + + +## 例 + +### 入力 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 出力 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-hydrogen", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + diff --git a/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx b/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx index 4a847cec52..60ca78c614 100644 --- a/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx @@ -2,16 +2,17 @@ title: "Comfy RouterでGemini Nano Banana 2.1を使用する" description: "Comfy Router経由でvertexai/gemini-nano-banana-2.1を呼び出す: エンドポイント、リクエストの形状、Routerが返すレスポンスについて説明します。" sidebarTitle: "Gemini Nano Banana 2.1" -translationSourceHash: 6f9161dd +translationSourceHash: 833b248e translationFrom: development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx translationBlockHashes: "_intro": 5cb6762b "Quick start": df454451 "Serving providers": af126fd5 - "Schema": 02b80e67 + "Schema": 2313ddad "Examples": dff3e9f8 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/vertexai/gemini-nano-banana-2.1.json から生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -193,7 +194,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R ### 入力 - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは、これは単一のインスタンスです。マルチターンのクエリでは、これは会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -209,29 +210,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。使用可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオおよびビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細は Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン上限にカウントされます。画像の解像度には制限がありません。 - 使用可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト形式のインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ上限: 20MB - フォーマット: `byte` + 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。使用可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオおよびビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細は Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン上限にカウントされます。画像の解像度には制限がありません。 - 使用可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオを読み取る方法。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを判断できるようにするには "AGENTIC" を設定します。省略した場合はデフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -243,15 +244,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 使用可能な値: `user`, `model` + 指定可能な値: `user`, `model` - 生成のサンプリング、長さ、出力の設定。すべてのフィールドはオプションです。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。 + 生成のサンプリング、長さ、出力に関する設定です。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外のフィールドはモデル固有の動作に従います。 - 画像生成の構成 + 画像生成の設定 @@ -259,25 +260,25 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - オプション。生成画像の画像出力フォーマット。 + 任意。生成画像の出力形式。 - オプション。出力画像の圧縮品質。 + 任意。出力画像の圧縮品質。 - オプション。出力を保存する画像フォーマット。Vertex AI の経路(Comfy 自身の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエスト)で使用されます。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。その上流にはそのようなプロパティがなく、存在すると呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずリクエストから削除され、出力フォーマットは AI Studio が選択するものになります。どの経路でも、送信した値を前提とせず、返された応答パート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 + 任意。出力を保存する画像形式で、Vertex AI のパス(Comfy 独自の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証される BYOK リクエスト)に適用されます。これらのパスで受け付けられる値は `image/png` と `image/jpeg` で、大文字と小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。例外は Google AI Studio の APIキーで認証される BYOK リクエストです。その上流にはこのプロパティが存在せず、含まれていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どのパスでも、送信した値を前提とせず、返されたレスポンスパートからメディアタイプを読み取ってください(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)。 - オプション。生成画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 + 任意。生成画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 - レスポンスで生成できるトークンの最大数。1 トークンはおよそ 4 文字です。100 トークンはおよそ 60〜80 語に相当します。 + レスポンスで生成できるトークンの最大数です。1 トークンはおよそ 4 文字です。100 トークンはおおよそ 60〜80 語に相当します。 - 範囲: `16` 〜 `65536` + 範囲: `16` から `65536` @@ -285,7 +286,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用していても応答が変動することがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで使用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を提供するようできる限り努めます。決定論的な出力は保証されません。また、モデルや、温度などのパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。次のモデルで利用可能です: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -293,7 +294,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - temperature は応答生成中のサンプリングに使用され、これは topP と topK が適用されるときに行われます。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由奔放でない、あるいは創造性を求められない応答が必要なプロンプトに適しており、高い temperature はより多様で創造的な結果につながる可能性があります。temperature が 0 の場合、常に最も確率の高いトークンが選択されることを意味します。この場合、特定のプロンプトに対する応答はほぼ決定的ですが、わずかな変動は依然として起こり得ます。モデルが汎用的すぎる応答や短すぎる応答を返す場合、またはフォールバック応答を返す場合は、temperature を上げてみてください + 温度は、応答生成中のサンプリングに使用され、これは topP と topK が適用されるときに発生します。温度はトークン選択のランダム性の度合いを制御します。低い温度は、より自由度が低く、創造性を求めない応答が必要なプロンプトに適しています。一方、高い温度はより多様または創造的な結果につながる可能性があります。温度が 0 の場合、最も確率の高いトークンが常に選択されます。この場合、特定のプロンプトに対する応答はほとんど決定論的ですが、少量のばらつきが生じる可能性は依然としてあります。モデルが一般的すぎる応答や短すぎる応答を返す場合、またはフォールバック応答を返す場合は、温度を上げてみてください。 範囲: `0` から `2` @@ -301,32 +302,32 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 任意。thinking 機能の設定。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。 + 任意。思考機能の設定。思考とは、モデルが複雑なタスクを小さなステップに分割し、より高品質な応答を生成するプロセスです。 - 任意。true の場合、モデルは自身の思考を応答に含めます。 + 任意。true の場合、モデルは応答に自身の思考を含めます。 - 任意。モデルの thinking プロセスに割り当てるトークン予算。モデルはこの予算内に収まるよう最善を尽くします。 + 任意。モデルの思考プロセス用のトークン予算。モデルはこの予算内に収まるようできる限り努めます。 - 任意。モデルの thinking レベル。 + 任意。モデルの思考レベル。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K は、モデルが出力用のトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙全体の中で最も確率が高いものになります。top-K が 3 の場合、temperature を使用して、確率が上位 3 のトークンの中から次のトークンが選択されます。 + Top-K は、モデルが出力用のトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率が高いものになります。Top-K が 3 の場合、次のトークンは、温度を使用して、最も確率の高い 3 つのトークンの中から選択されます。 範囲: `1` から `…` - 指定した場合、nucleus サンプリングが使用されます。 -Top-P は、モデルが出力用のトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率の高いもの(top-K を参照)から低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 + 指定すると、nucleus サンプリングが使用されます。 +Top-P は、モデルが出力用のトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率が高いもの (top-K を参照) から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは温度を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外します。 ランダム性の低い応答には低い値を、ランダム性の高い応答には高い値を指定します。 範囲: `0` から `1` @@ -335,7 +336,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - 安全でないコンテンツをブロックするためのリクエストごとの設定。GenerateContentResponse.candidates に適用されます。 + 安全でないコンテンツをブロックするためのリクエストごとの設定。GenerateContentResponse.candidates に対して適用されます。 @@ -347,11 +348,11 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - モデルをより良いパフォーマンスへ導くための指示。たとえば「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各パートのコンテンツは別々の段落にしてください。 + モデルをより良いパフォーマンスへと導くための指示。たとえば、「できるだけ簡潔に回答してください」や「応答に専門用語を使用しないでください」などです。テキスト文字列はトークン制限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part の内容は別々の段落にしてください。 - 1 つのメッセージを構成する順序付けられた parts のリスト。parts ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数などの入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + 単一のメッセージを構成する順序付きのパートのリスト。パートごとに異なる IANA MIME タイプを持つ場合があります。トークンの最大数や画像の数など入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 @@ -359,13 +360,13 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - メッセージを作成するエンティティの識別情報。以下の値がサポートされています: user: これは、メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: これは、メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空欄のままにするか、未設定にできます。 + メッセージを作成するエンティティの識別情報。次の値がサポートされています: user: これは、メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: これは、メッセージがモデルによって生成されたことを示します。model 値は、マルチターン会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白のままにするか、未設定にできます。 指定可能な値: `user`, `model` - モデルの知識や適用範囲外でアクション(または一連のアクション)を実行するために、システムが外部システムと対話できるようにするコード。Function calling を参照してください。 + モデルの知識と範囲外でアクションまたは一連のアクションを実行するために、システムが外部システムと対話できるようにするコード。関数呼び出しを参照してください。 @@ -381,50 +382,50 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - 関数のパラメータの JSON スキーマ + 関数パラメータの JSON スキーマ - true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に失効します。 + true の場合、生成済み画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に失効します。 - ビデオ入力の場合、Duration 形式でビデオの開始オフセットと終了オフセットを指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。このメタデータは、ビデオデータが inlineData または fileData で提供されている間だけ指定してください。 + ビデオ入力の場合、ビデオの開始と終了のオフセットを Duration 形式で指定します。たとえば 1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。このメタデータは、ビデオデータが inlineData または fileData で提供されている場合にのみ指定してください。 - ビデオタイムライン上の位置に対する再生時間のオフセットを表します。 + ビデオタイムライン上の位置を表す再生時間のオフセットです。 - ナノ秒解像度での秒の小数部(符号付き)。小数部を持つ負の秒値であっても、nanos 値は非負でなければなりません。 + ナノ秒解像度での秒の符号付き小数部分です。小数を含む負の秒値であっても、nanos の値は非負でなければなりません。 - 範囲: `0` ~ `999999999` + 範囲: `0` から `999999999` - 期間の秒数(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の符号付き秒です。-315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲で指定する必要があります。 - 範囲: `-315576000000` ~ `315576000000` + 範囲: `-315576000000` から `315576000000` - ビデオタイムライン上の位置に対する再生時間のオフセットを表します。 + ビデオタイムライン上の位置を表す再生時間のオフセットです。 - ナノ秒解像度での秒の小数部(符号付き)。小数部を持つ負の秒値であっても、nanos 値は非負でなければなりません。 + ナノ秒解像度での秒の符号付き小数部分です。小数を含む負の秒値であっても、nanos の値は非負でなければなりません。 - 範囲: `0` ~ `999999999` + 範囲: `0` から `999999999` - 期間の秒数(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の符号付き秒です。-315,576,000,000 から +315,576,000,000 まで(両端を含む)の範囲で指定する必要があります。 - 範囲: `-315576000000` ~ `315576000000` + 範囲: `-315576000000` から `315576000000` -`GET /v2/models/vertexai/gemini-nano-banana-2.1/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。 +この内容は、Router が `GET /v2/models/vertexai/gemini-nano-banana-2.1/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使われるドキュメントと同じものです。 ### 出力 @@ -453,7 +454,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - フォーマット: `date` + 形式: `date` @@ -469,7 +470,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -485,29 +486,29 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト形式のインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB - フォーマット: `byte` + 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオをどのように読み取るか。固定レートのフレームサンプリングではなく、検査するセグメントをモデルに判断させるには "AGENTIC" を設定します。省略すると、デフォルトの固定レートサンプリングが使用されます。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るかです。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、検査するセグメントをモデルが決定します。省略した場合はデフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -515,7 +516,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - このパートがモデルによる思考/推論のステップであることを示します。 + このパートがモデルによる思考/推論ステップであることを示します。 @@ -535,7 +536,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - コンテンツが指定された安全性カテゴリに違反する確率 + コンテンツが指定された安全性カテゴリに違反する確率です 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -545,7 +546,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - レスポンスの生成に使用されたモデルのバージョン。 + レスポンスの生成に使用されたモデルバージョン。 @@ -565,17 +566,17 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - 可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全性カテゴリに違反する確率 - 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - レスポンスの一意の識別子。 + レスポンスの一意な識別子。 @@ -583,7 +584,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - 出力のみ。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 + 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 @@ -597,7 +598,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -615,7 +616,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -637,7 +638,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -645,7 +646,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - トークンの合計数(プロンプト + 候補)。 + トークンの総数(プロンプト + 候補)。 diff --git a/ko/development/comfy-router/models/google/gemini-4-argon/code.mdx b/ko/development/comfy-router/models/google/gemini-4-argon/code.mdx new file mode 100644 index 0000000000..5a46e26114 --- /dev/null +++ b/ko/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -0,0 +1,688 @@ +--- +title: "Comfy Router에서 Gemini 4 Argon 사용하기" +description: "Comfy Router를 통해 vertexai/gemini-4-argon을 호출합니다. endpoint, 요청 형태 및 Router가 반환하는 응답을 설명합니다." +sidebarTitle: "Gemini 4 Argon" +translationSourceHash: 913b7628 +translationFrom: development/comfy-router/models/google/gemini-4-argon/code.mdx +translationBlockHashes: + "_intro": 37c83dd8 + "Quick start": 9453b03d + "Schema": 1ff628d6 + "Examples": 046e90e1 +--- +{/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/vertexai/gemini-4-argon.json에서 생성했습니다. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`vertexai/gemini-4-argon`에 대한 API 레퍼런스로, Comfy Router가 Google에서 제공합니다. + +**입력:** 텍스트, 이미지, 오디오, 비디오 · **출력:** 텍스트 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행한 것입니다. + +**모델 ID:** `vertexai/gemini-4-argon` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-argon` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 idempotency key를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-argon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 idempotency key를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("vertexai/gemini-4-argon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests`로 전송합니다. Router는 실행이 접수되는 즉시 `201`과 `request_id`로 응답하며, 결과는 준비가 되면 이 프로세스 또는 다른 프로세스에서 수집합니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-argon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 기다립니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자의 자체 페이로드이며, models.run()이 반환하는 것과 동일한 값입니다. + # 실패했거나 취소된 요청은 여기서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("vertexai/gemini-4-argon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 기다립니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 모델의 네이티브 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202를 반환합니다. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 멀티 턴 쿼리의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 값을 적용하고, 나머지는 모델 자체 동작을 따릅니다. + + + + 이미지 생성을 위한 구성입니다. + + + + 생성된 이미지의 가로세로 비율입니다. + + + + 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. + + + + 선택 사항입니다. 출력 이미지의 압축 품질입니다. + + + + 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력을 저장할 이미지 형식입니다. 여기서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키고 요청을 전달하기 전에 소문자로 정규화합니다. 그 밖의 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없어 이 필드가 있으면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 대로 결정됩니다. 모든 경로에서 보낸 값을 가정하지 말고, 받은 응답 파트에서 미디어 타입(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`)을 다시 읽어 확인하세요. + + + + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + + + + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰 하나는 약 4자에 해당합니다. 100 토큰은 대략 60~80단어에 해당합니다. + + 범위: `16`에서 `65536`까지 + + + + + + + + 시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 모델이나 temperature와 같은 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변화가 생길 수 있습니다. 기본적으로 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature는 응답 생성 중 샘플링에 사용되며, 이는 topP와 topK가 적용될 때 발생합니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 특정 프롬프트에 대한 응답은 대부분 결정적이지만, 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공하는 경우 temperature를 높여 보세요. + + 범위: `0`부터 `2`까지 + + 형식: `float` + + + + 선택 사항입니다. 사고 기능 구성입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + + + + 선택 사항입니다. 참이면 모델이 응답에 자체 사고를 포함합니다. + + + + 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산을 유지하기 위해 최선을 다합니다. + + + + 선택 사항입니다. 모델의 사고 수준입니다. + + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` + + + + Top-K는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중에서 가장 확률이 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 가장 확률이 높은 3개 토큰 중에서 다음 토큰을 선택합니다. + + 범위: `1`부터 `…`까지 + + + + 지정하면 nucleus 샘플링이 사용됩니다. +Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 토큰부터(top-K 참조) 가장 낮은 토큰까지 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 0.3, 0.2, 0.1이고 top-P 값이 0.5이면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +무작위성이 더 낮은 응답에는 낮은 값을, 무작위성이 더 높은 응답에는 높은 값을 지정하세요. + + 범위: `0`부터 `1`까지 + + 형식: `float` + + + + 안전하지 않은 콘텐츠를 차단하기 위한 요청별 설정입니다. GenerateContentResponse.candidates에 적용됩니다. + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 가능한 값: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + 모델이 더 나은 성능을 내도록 유도하기 위한 지침입니다. 예: "가능한 한 간결하게 답하세요" 또는 "응답에 기술 용어를 사용하지 마세요". 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도 단락에 있어야 합니다. + + + + 단일 메시지를 구성하는 순서가 지정된 parts 목록입니다. 서로 다른 part는 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수 또는 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 메시지를 생성하는 주체의 ID입니다. 다음 값이 지원됩니다: user: 메시지가 실제 사람, 일반적으로 사용자가 생성한 메시지임을 나타냅니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 다중 턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 다중 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않을 수 있습니다. + + 가능한 값: `user`, `model` + + + + 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호 작용할 수 있게 하는 코드 조각입니다. Function calling을 참조하세요. + + + + + + + + + + + + + + + + 함수 파라미터에 대한 JSON 스키마 + + + + 참이면 생성된 이미지가 클라우드 스토리지에 업로드되어 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + + + + 비디오 입력의 경우 비디오의 시작 및 종료 오프셋을 Duration 형식으로 지정합니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + +Router가 `GET /v2/models/vertexai/gemini-4-argon/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. + +### 출력 + + + + + + + + + + + + + + + + + + + + + + + + + + + 형식: `date` + + + + + + + + + + + + + + + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리에서는 단일 인스턴스입니다. 다중 턴 쿼리에서는 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 속도 프레임 샘플링 대신 검사할 세그먼트를 모델이 결정하도록 하려면 "AGENTIC"을 설정하세요. 기본 고정 속도 프레임 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + + + + + + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답이 생성된 타임스탬프입니다. + + + + 응답을 생성하는 데 사용된 모델 버전입니다. + + + + + + + + + + + + + + + + + + + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답의 고유 식별자입니다. + + + + + + + + 출력 전용입니다. 입력의 캐시된 부분(캐시된 콘텐츠)에 있는 토큰 수입니다. + + + + 응답의 토큰 수입니다. + + + + 모달리티별 후보 토큰 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 요청의 토큰 수입니다. cachedContent가 설정된 경우에도 이 값은 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + + + + 모달리티별 프롬프트 토큰 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + thoughts 출력에 있는 토큰 수입니다. + + + + 도구 사용 프롬프트에 있는 토큰 수입니다. + + + + 모달리티별 도구 사용 프롬프트 토큰 내역입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 전체 토큰 수입니다(프롬프트 + 후보). + + + + 요청에 사용된 트래픽 유형입니다(예: PROVISIONED_THROUGHPUT). + + +## 예시 + +### 입력 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 출력 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-argon", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + diff --git a/ko/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/ko/development/comfy-router/models/google/gemini-4-carbon/code.mdx new file mode 100644 index 0000000000..6429be161e --- /dev/null +++ b/ko/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -0,0 +1,691 @@ +--- +title: "Comfy Router에서 Gemini 4 Carbon 사용하기" +description: "Comfy Router를 통해 vertexai/gemini-4-carbon을 호출합니다. 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." +sidebarTitle: "Gemini 4 Carbon" +translationSourceHash: c107edac +translationFrom: development/comfy-router/models/google/gemini-4-carbon/code.mdx +translationBlockHashes: + "_intro": 8eafb327 + "Quick start": a26083eb + "Schema": 1046bf02 + "Examples": b2720522 +--- +{/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-4-carbon.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`vertexai/gemini-4-carbon`에 대한 API 레퍼런스이며, Comfy Router가 Google에서 제공합니다. + +**입력:** 텍스트, 이미지, 오디오, 비디오 · **출력:** 텍스트 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 순수 HTTP로 보냅니다. + +**모델 ID:** `vertexai/gemini-4-carbon` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-carbon` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-carbon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("vertexai/gemini-4-carbon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests`로 보냅니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비가 되면 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [대기열 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 방법을 단계별로 설명합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-carbon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 서버가 지정한 Retry-After를 기다리며 요청이 완료될 때까지 폴링합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자의 자체 페이로드이며, models.run()이 반환하는 것과 같은 값입니다. + # 실패했거나 취소된 요청은 여기서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("vertexai/gemini-4-carbon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 기다립니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 완료되면 모델의 네이티브 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202입니다. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하십시오. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하십시오. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 파트의 비디오를 읽는 방식입니다. "AGENTIC"으로 설정하면 고정 속도 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하게 합니다. 기본 고정 속도 샘플링을 사용하려면 생략하십시오. gemini-3.7-flash 및 그보다 새로운 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 조각입니다. + + + + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 기본값을 적용하고, 나머지는 모델 자체 동작을 따릅니다. + + + + 이미지 생성을 위한 구성입니다. + + + + 생성된 이미지의 가로세로 비율입니다. + + + + 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. + + + + 선택 사항입니다. 출력 이미지의 압축 품질입니다. + + + + 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력을 저장해야 하는 이미지 형식입니다. 해당 경로에서 허용되는 값은 `image/png` 및 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키고 요청이 전달되기 전에 소문자로 정규화합니다. 그 외의 값은 이 필드 이름을 명시한 400으로 거부됩니다. 생략하면 기본값은 `image/png`입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이러한 속성이 없으며, 이 속성이 있으면 호출 전체를 거부합니다. 따라서 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며, 출력 형식은 AI Studio가 선택하는 값이 됩니다. 모든 경로에서 보낸 값을 가정하지 말고 제공된 응답 파트에서 미디어 유형을 다시 읽으십시오(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). + + + + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + + + + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 약 4자입니다. 100토큰은 대략 60-80단어에 해당합니다. + + 범위: `16`에서 `65536`까지 + + + + + + + + 시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델 또는 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변화가 발생할 수 있습니다. 기본적으로 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + temperature는 응답 생성 중 샘플링에 사용되며, 이는 topP와 topK가 적용될 때 발생합니다. Temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 덜 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 지정된 프롬프트에 대한 응답은 대부분 결정론적이지만, 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공하는 경우 temperature를 높여 보세요. + + 범위: `0`부터 `2`까지 + + 형식: `float` + + + + 선택 사항. 사고 기능 구성입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + + + + 선택 사항. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. + + + + 선택 사항. 모델의 사고 과정에 대한 토큰 예산입니다. 모델은 이 예산 내에 머물도록 최선을 다합니다. + + + + 선택 사항. 모델의 사고 수준입니다. + + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` + + + + Top-K는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중 가장 확률이 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개 토큰 중에서 다음 토큰을 선택합니다. + + 범위: `1`부터 `…`까지 + + + + 지정하면 뉴클리어스 샘플링이 사용됩니다. +Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 토큰(top-K 참조)부터 확률이 가장 낮은 토큰까지 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5이면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +덜 무작위적인 응답에는 더 낮은 값을, 더 무작위적인 응답에는 더 높은 값을 지정하세요. + + 범위: `0`부터 `1`까지 + + 형식: `float` + + + + 안전하지 않은 콘텐츠를 차단하기 위한 요청별 설정입니다. GenerateContentResponse.candidates에 적용됩니다. + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 가능한 값: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예: "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요". 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며 각 part의 콘텐츠는 별도 단락에 있어야 합니다. + + + + 단일 메시지를 구성하는 순서가 지정된 part의 목록입니다. 서로 다른 part는 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + + + + 텍스트 프롬프트 또는 코드 조각입니다. + + + + 메시지를 생성하는 주체의 식별자입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람이 보낸 것이며 일반적으로 사용자가 생성한 메시지임을 나타냅니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 다중 턴 대화 중 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 다중 턴이 아닌 대화의 경우 이 필드를 비워 두거나 설정하지 않을 수 있습니다. + + 가능한 값: `user`, `model` + + + + 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호 작용할 수 있게 하는 코드 조각입니다. 함수 호출을 참조하세요. + + + + + + + + + + + + + + + + 함수 파라미터에 대한 JSON 스키마 + + + + 참이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + + + + 비디오 입력의 경우, Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 초 단위 소수 부분(부호 있음)입니다. 소수 부분이 있는 네거티브 초 값이라도 나노스 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 시간 범위의 초 단위 값(부호 있음)입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 초 단위 소수 부분(부호 있음)입니다. 소수 부분이 있는 네거티브 초 값이라도 나노스 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 시간 범위의 초 단위 값(부호 있음)입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + +`GET /v2/models/vertexai/gemini-4-carbon/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 이전에 Router가 호출을 검증할 때 사용하는 것과 동일한 문서입니다. + +### 출력 + + + + + + + + + + + + + + + + + + + + + + + + + + + 형식: `date` + + + + + + + + + + + + + + + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 질의의 경우 단일 인스턴스입니다. 멀티 턴 질의의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + + + + + + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답이 생성된 타임스탬프입니다. + + + + 응답을 생성하는 데 사용된 모델 버전입니다. + + + + + + + + + + + + + + + + + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답의 고유 식별자입니다. + + + + + + + + 출력 전용. 입력에서 캐시된 부분(캐시된 콘텐츠)에 있는 토큰 수입니다. + + + + 응답에 있는 토큰 수입니다. + + + + 모달리티별 후보 토큰의 세부 구성입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + + + + 모달리티별 프롬프트 토큰의 세부 구성입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 사고 출력에 포함된 토큰 수입니다. + + + + 도구 사용 프롬프트에 포함된 토큰 수입니다. + + + + 모달리티별 도구 사용 프롬프트 토큰의 세부 구성입니다. + + + + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 총 토큰 수(프롬프트 + 후보)입니다. + + + + 요청에 사용된 트래픽 유형(예: PROVISIONED_THROUGHPUT)입니다. + + +## 예시 + +### 입력 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 출력 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-carbon", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + + diff --git a/ko/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx b/ko/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx new file mode 100644 index 0000000000..e5accb439e --- /dev/null +++ b/ko/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx @@ -0,0 +1,690 @@ +--- +title: "Comfy Router에서 Gemini 4 Hydrogen 사용하기" +description: "Comfy Router를 통해 vertexai/gemini-4-hydrogen을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." +sidebarTitle: "Gemini 4 Hydrogen" +translationSourceHash: 2fc4f945 +translationFrom: development/comfy-router/models/google/gemini-4-hydrogen/code.mdx +translationBlockHashes: + "_intro": 1792fa1e + "Quick start": 6dd0010d + "Schema": 3edab77e + "Examples": 3698dfec +--- +{/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-4-hydrogen.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`vertexai/gemini-4-hydrogen`에 대한 API 레퍼런스이며, Google의 Comfy Router에서 제공합니다. + +**입력:** 텍스트, 이미지, 오디오, 비디오 · **출력:** 텍스트 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행한 것입니다. + +**모델 ID:** `vertexai/gemini-4-hydrogen` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경 변수에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-hydrogen", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경 변수에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("vertexai/gemini-4-hydrogen", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests`로 전송합니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비가 되면 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [대기열 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 단계별로 설명합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경 변수에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-hydrogen", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다. + + # 서버가 지정한 Retry-After만큼 기다리며 요청이 완료될 때까지 폴링합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자 자체의 페이로드이며, models.run()이 반환하는 것과 동일한 값입니다. + # 실패했거나 취소된 요청은 여기서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경 변수에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("vertexai/gemini-4-hydrogen", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 제출. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 명시한 Retry-After 초만큼 기다립니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집. 모델의 네이티브 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202를 반환합니다. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 질의의 경우 단일 인스턴스입니다. 다중 턴 질의의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하십시오. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하십시오. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하십시오. 기본 고정 비율 샘플링을 사용하려면 생략하십시오. gemini-3.7-flash 및 그 이후 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + 생성에 사용할 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 기본값이 적용되고, 나머지는 모델 자체의 동작을 따릅니다. + + + + 이미지 생성 구성 + + + + 생성된 이미지의 가로세로 비율 + + + + 선택 사항. 생성된 이미지의 이미지 출력 형식입니다. + + + + 선택 사항. 출력 이미지의 압축 품질입니다. + + + + 선택 사항. 출력을 저장할 이미지 형식이며, Vertex AI 경로(Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청)에 적용됩니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청을 전달하기 전에 소문자로 정규화합니다. 그 밖의 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없고 이 필드가 존재하면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 값을 따릅니다. 모든 경로에서 보낸 값을 가정하지 말고 제공받은 응답 파트에서 미디어 타입을 다시 읽으십시오(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). + + + + 선택 사항. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + + + + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 대략 4자에 해당합니다. 100 토큰은 대략 60~80단어에 해당합니다. + + 범위: `16` ~ `65536` + + + + + + + + 시드가 특정 값으로 고정되면, 모델은 반복되는 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델 또는 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 차이가 발생할 수 있습니다. 기본적으로는 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + 온도는 topP와 topK가 적용되는 응답 생성 과정에서 샘플링에 사용됩니다. 온도는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 온도는 개방적이거나 창의적인 응답이 필요하지 않은 프롬프트에 적합하고, 높은 온도는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. 온도가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만, 소량의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체(fallback) 응답을 반환한다면 온도를 높여 보세요 + + 범위: `0`부터 `2`까지 + + 형식: `float` + + + + 선택 사항입니다. 사고(thinking) 기능에 대한 설정입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + + + + 선택 사항입니다. 참이면 모델이 응답에 자신의 사고 내용을 포함합니다. + + + + 선택 사항입니다. 모델의 사고 과정에 할당되는 토큰 예산입니다. 모델은 이 예산을 넘지 않도록 최선을 다합니다. + + + + 선택 사항입니다. 모델의 사고 수준입니다. + + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` + + + + Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘 내 모든 토큰 중에서 가장 확률이 높은 토큰입니다. Top-K가 3이면 온도를 사용하여 확률이 가장 높은 3개의 토큰 중에서 다음 토큰이 선택됩니다. + + 범위: `1`부터 `…`까지 + + + + 지정하면 뉴클리어스 샘플링이 사용됩니다. +Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 Top-P 값과 같아질 때까지 확률이 가장 높은 것( Top-K 참고)부터 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 Top-P 값이 0.5라면, 모델은 온도를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +무작위성이 적은 응답을 원하면 낮은 값을, 무작위성이 큰 응답을 원하면 높은 값을 지정하세요. + + 범위: `0`부터 `1`까지 + + 형식: `float` + + + + 안전하지 않은 콘텐츠를 차단하기 위한 요청별 설정입니다. GenerateContentResponse.candidates에 적용됩니다. + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 가능한 값: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + 모델이 더 나은 성능을 내도록 유도하는 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 역할 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 문단에 있어야 합니다. + + + + 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람, 일반적으로 사용자가 생성한 메시지임을 나타냅니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 다중 턴 대화에서 모델의 메시지를 대화에 삽입할 때 사용됩니다. 다중 턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않을 수 있습니다. + + 가능한 값: `user`, `model` + + + + 시스템이 모델의 지식과 범위를 벗어난 작업 또는 작업 집합을 수행하기 위해 외부 시스템과 상호작용할 수 있게 해 주는 코드 조각입니다. 함수 호출(Function calling)을 참조하세요. + + + + + + + + + + + + + + + + 함수 파라미터의 JSON 스키마 + + + + 참이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + + + + 비디오 입력의 경우, Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 부호 있는 초 단위 소수부입니다. 소수부가 있는 네거티브 초 값도 nanos 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 부호 있는 시간 구간의 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + + + 비디오 타임라인 위치에 대한 재생 시간 오프셋을 나타냅니다. + + + + 나노초 해상도의 부호 있는 초 단위 소수부입니다. 소수부가 있는 네거티브 초 값도 nanos 값은 음수가 아니어야 합니다. + + 범위: `0` ~ `999999999` + + + + 부호 있는 시간 구간의 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + + 범위: `-315576000000` ~ `315576000000` + + +Router가 `GET /v2/models/vertexai/gemini-4-hydrogen/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 문서와 동일합니다. + +### 출력 + + + + + + + + + + + + + + + + + + + + + + + + + + + 형식: `date` + + + + + + + + + + + + + + + + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 담고 있는 반복 필드입니다. + + + + + + + + URI 기반 데이터입니다. + + + + URI + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 원시 바이트 형태의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용해 최대 3000개의 이미지를 지정할 수 있습니다. + + + + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 유형(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB + + 형식: `byte` + + + + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + + 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하게 하려면 "AGENTIC"을 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + + + + 텍스트 프롬프트 또는 코드 스니펫입니다. + + + + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. + + + + 가능한 값: `user`, `model` + + + + + + + + + + + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다 + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답이 생성된 시각의 타임스탬프입니다. + + + + 응답을 생성하는 데 사용된 모델 버전입니다. + + + + + + + + + + + + + + + + + + + +Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. + + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + 응답의 고유 식별자입니다. + + + + + + + + 출력 전용입니다. 입력에서 캐시된 부분(캐시된 콘텐츠)에 포함된 토큰 수입니다. + + + + 응답에 포함된 토큰 수입니다. + + + + 모달리티별 후보 토큰의 세부 내역입니다. + + + + 입력 또는 출력 콘텐츠의 모달리티 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 요청에 포함된 토큰 수입니다. cachedContent가 설정된 경우에도 이 값은 전체 유효 프롬프트 크기를 나타내며, 즉 캐시된 콘텐츠의 토큰 수가 포함됩니다. + + + + 모달리티별 프롬프트 토큰의 세부 내역입니다. + + + + 입력 또는 출력 콘텐츠의 모달리티 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 사고(thoughts) 출력에 포함된 토큰 수입니다. + + + + 도구 사용 프롬프트에 포함된 토큰 수입니다. + + + + 모달리티별 도구 사용 프롬프트 토큰의 세부 내역입니다. + + + + 입력 또는 출력 콘텐츠의 모달리티 유형입니다. + + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + 해당 모달리티의 토큰 수입니다. + + + + 전체 토큰 수입니다(프롬프트 + 후보). + + + + 요청에 사용된 트래픽 유형입니다(예: PROVISIONED_THROUGHPUT). + + +## 예제 + +### 입력 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 출력 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-hydrogen", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + diff --git a/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx b/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx index e5c4c72dc7..99a269d3fe 100644 --- a/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Gemini Nano Banana 2.1 사용하기" description: "Comfy Router를 통해 vertexai/gemini-nano-banana-2.1을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Gemini Nano Banana 2.1" -translationSourceHash: 6f9161dd +translationSourceHash: 833b248e translationFrom: development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx translationBlockHashes: "_intro": 5cb6762b "Quick start": df454451 "Serving providers": af126fd5 - "Schema": 02b80e67 + "Schema": 2313ddad "Examples": dff3e9f8 --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/vertexai/gemini-nano-banana-2.1.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -193,7 +194,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R ### 입력 - 모델과의 현재 대화 내용입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. @@ -219,7 +220,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB 형식: `byte` @@ -231,11 +232,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 모델이 이 부분의 비디오를 읽는 방식입니다. "AGENTIC"으로 설정하면 고정 레이트 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정합니다. 기본 고정 레이트 샘플링을 사용하려면 생략합니다. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 생략하면 기본 고정 비율 샘플링이 적용됩니다. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. - 텍스트 프롬프트 또는 코드 조각입니다. + 텍스트 프롬프트 또는 코드 스니펫입니다. @@ -247,31 +248,31 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 생성에 대한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략하면 해당 기본값이 적용되고, 나머지는 모델 자체 동작을 따릅니다. + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다: 아래에서 `default`를 선언한 필드는 생략 시 해당 값을 적용하고, 나머지는 모델 자체 동작으로 대체됩니다. - 이미지 생성을 위한 구성입니다. + 이미지 생성을 위한 구성 - 생성된 이미지의 가로세로 비율입니다. + 생성된 이미지의 가로세로 비율 - 선택 사항. 생성된 이미지의 이미지 출력 형식입니다. + 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. - 선택 사항. 출력 이미지의 압축 품질입니다. + 선택 사항입니다. 출력 이미지의 압축 품질입니다. - 선택 사항. 출력을 저장할 이미지 형식이며, Vertex AI 경로에 해당합니다. 즉, Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청입니다. 여기서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청이 전달되기 전에 소문자로 정규화됩니다. 그 밖의 값은 이 필드를 명시한 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이 속성이 없으며 이 필드가 있으면 전체 호출을 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 대로 결정됩니다. 모든 경로에서 보낸 값을 가정하지 말고, 제공된 응답 파트에서 미디어 유형을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). + 선택 사항입니다. 출력을 저장할 이미지 형식으로, Vertex AI 경로(Comfy 자체 자격 증명으로 처리되는 요청 및 GCP 서비스 계정으로 인증된 BYOK 요청)에 적용됩니다. 해당 경로에서 허용되는 값은 `image/png` 및 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 후 요청이 전달되기 전에 소문자로 정규화됩니다. 그 외의 값은 이 필드를 명시한 400 오류로 거부됩니다. 생략 시 기본값은 `image/png`입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없으며 이 속성이 존재하면 전체 호출을 거부하므로, 필드는 적용되거나 거부되지 않고 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 값이 됩니다. 모든 경로에서 보낸 값을 가정하지 말고, 받은 응답 부분(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`)에서 미디어 유형을 다시 읽으세요. - 선택 사항. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델이 기본값 1K를 사용합니다. @@ -286,7 +287,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R -시드가 특정 값으로 고정되면, 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력이 보장되지는 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로는 무작위 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 +시드를 특정 값으로 고정하면 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변화가 생길 수 있습니다. 기본적으로는 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -294,7 +295,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - temperature는 topP와 topK가 적용될 때 발생하는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만 소량의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공한다면 temperature를 높여 보세요 + temperature는 응답 생성 중 샘플링에 사용되며, topP와 topK가 적용될 때 함께 동작합니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 덜 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만, 약간의 변화는 여전히 발생할 수 있습니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체(fallback) 응답을 반환한다면 temperature를 높여 보세요. 범위: `0`부터 `2`까지 @@ -302,33 +303,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 선택 사항입니다. thinking 기능을 위한 구성입니다. thinking은 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + 선택 사항입니다. 사고(thinking) 기능에 대한 설정입니다. 사고란 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. - 선택 사항입니다. 참이면 모델이 응답에 자신의 생각을 포함합니다. + 선택 사항입니다. 참이면 모델이 자신의 사고 내용을 응답에 포함합니다. - 선택 사항입니다. 모델의 thinking 과정을 위한 토큰 예산입니다. 모델은 이 예산을 넘지 않도록 최선을 다합니다. + 선택 사항입니다. 모델의 사고 과정에 할당할 토큰 예산입니다. 모델은 이 예산 범위를 지키기 위해 최선을 다합니다. - 선택 사항입니다. 모델의 thinking 수준입니다. + 선택 사항입니다. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니다. top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중에서 확률이 가장 높은 토큰입니다. top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개의 토큰 중에서 다음 토큰을 선택합니다. + Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘 전체에서 확률이 가장 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개 토큰 중에서 다음 토큰을 선택합니다. 범위: `1`부터 `…`까지 지정하면 nucleus 샘플링이 사용됩니다. -Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니다. 토큰은 확률이 가장 높은 것(top-K 참조)부터 가장 낮은 것까지 선택되며, 확률의 합이 top-P 값과 같아질 때까지 진행됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. -무작위성이 더 적은 응답을 원하면 낮은 값을, 더 많은 응답을 원하면 높은 값을 지정하세요. +Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률이 가장 높은 것( top-K 참고)부터 가장 낮은 것까지 선택되며, 확률의 합이 top-P 값과 같아질 때까지 진행됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +덜 무작위적인 응답을 원하면 낮은 값을, 더 무작위적인 응답을 원하면 높은 값을 지정하세요. 범위: `0`부터 `1`까지 @@ -348,11 +349,11 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 역할 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. + 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 이 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락으로 구성해야 합니다. - 단일 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + 하나의 메시지를 구성하는 순서가 지정된 part 목록입니다. part마다 서로 다른 IANA MIME 타입을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참고하세요. @@ -360,13 +361,13 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람이 보낸 것임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 멀티턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 멀티턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않아도 됩니다. + 메시지를 생성하는 주체의 정체성입니다. 다음 값을 지원합니다. user: 메시지가 실제 사람이 보낸 것임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 여러 턴으로 이루어진 대화에서 모델의 메시지를 대화에 삽입할 때 사용합니다. 여러 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않아도 됩니다. 가능한 값: `user`, `model` - 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호작용할 수 있게 하는 코드 조각입니다. Function calling을 참조하세요. + 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호작용할 수 있도록 하는 코드 조각입니다. 함수 호출(Function calling)을 참고하세요. @@ -390,7 +391,7 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 비디오 입력의 경우, Duration 형식으로 표현된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 이 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + 비디오 입력의 경우 Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 경우에만 지정해야 합니다. @@ -398,13 +399,13 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 나노초 해상도의 부호 있는 초 단위 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 부호 있는 초의 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 나노스 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지 포함이어야 합니다. + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` @@ -414,18 +415,18 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 나노초 해상도의 부호 있는 초 단위 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 부호 있는 초의 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 나노스 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지 포함이어야 합니다. + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` -`GET /v2/models/vertexai/gemini-nano-banana-2.1/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/vertexai/gemini-nano-banana-2.1/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -470,7 +471,7 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 멀티 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. @@ -486,7 +487,7 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -496,19 +497,19 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정합니다. 기본 고정 비율 샘플링을 사용하려면 생략합니다. gemini-3.7-flash 및 그 이후 Flash 모델에서 지원됩니다. @@ -516,7 +517,7 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. @@ -542,7 +543,7 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 응답이 생성된 시점의 타임스탬프입니다. + 응답이 생성된 타임스탬프입니다. @@ -570,7 +571,7 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 콘텐츠가 지정된 안전 카테고리를 위반할 확률 + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -584,19 +585,19 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 출력 전용. 입력에서 캐시된 부분(캐시된 콘텐츠)의 토큰 수입니다. + 출력 전용. 입력의 캐시된 부분(캐시된 콘텐츠)에 있는 토큰 수입니다. - 응답의 토큰 수입니다. + 응답에 있는 토큰 수입니다. - 모달리티별 후보 토큰 내역입니다. + 모달리티별 후보 토큰의 세부 내역입니다. - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + 입력 또는 출력 콘텐츠의 모달리티 유형입니다. 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -606,15 +607,15 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 요청의 토큰 수입니다. cachedContent가 설정된 경우에도 이 값은 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이는 전체 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. - 모달리티별 프롬프트 토큰 내역입니다. + 모달리티별 프롬프트 토큰의 세부 내역입니다. - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + 입력 또는 출력 콘텐츠의 모달리티 유형입니다. 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -624,19 +625,19 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - thoughts 출력에 포함된 토큰 수입니다. + 사고 출력에 있는 토큰 수입니다. - 도구 사용 프롬프트에 포함된 토큰 수입니다. + 도구 사용 프롬프트에 있는 토큰 수입니다. - 모달리티별 도구 사용 프롬프트 토큰 내역입니다. + 모달리티별 도구 사용 프롬프트 토큰의 세부 내역입니다. - 입력 또는 출력 콘텐츠 모달리티의 유형입니다. + 입력 또는 출력 콘텐츠의 모달리티 유형입니다. 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -646,7 +647,7 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 바꿉니 - 총 토큰 수입니다(프롬프트 + 후보). + 총 토큰 수(프롬프트 + 후보)입니다. diff --git a/zh/development/comfy-router/models/google/gemini-4-argon/code.mdx b/zh/development/comfy-router/models/google/gemini-4-argon/code.mdx new file mode 100644 index 0000000000..8fe3039957 --- /dev/null +++ b/zh/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -0,0 +1,688 @@ +--- +title: "使用 Gemini 4 Argon 搭配 Comfy Router" +description: "通过 Comfy Router 调用 vertexai/gemini-4-argon:端点、请求结构以及 Router 返回的响应。" +sidebarTitle: "Gemini 4 Argon" +translationSourceHash: 913b7628 +translationFrom: development/comfy-router/models/google/gemini-4-argon/code.mdx +translationBlockHashes: + "_intro": 37c83dd8 + "Quick start": 9453b03d + "Schema": 1ff628d6 + "Examples": 046e90e1 +--- +{/* 本文件为生成文件。由 `pnpm code-pages:gen` 从 router-schemas/vertexai/gemini-4-argon.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`vertexai/gemini-4-argon` 的 API 参考,由 Comfy Router 提供,模型来自 Google。 + +**输入:** 文本、图像、音频、视频 · **输出:** 文本 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段是通过原始 HTTP 发出的相同调用。 + +**模型 ID:** `vertexai/gemini-4-argon` + +**端点:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-argon` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境中读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-argon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境中读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("vertexai/gemini-4-argon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests`。运行被接纳后,Router 会立即返回 `201` 和 `request_id`,结果就绪后可从当前进程或其他进程收集。[排队交付](/zh/development/comfy-router/queue)介绍了状态、取消和结果收集。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境中读取 COMFY_API_KEY。 +# 每次调用 submit() 都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-argon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # 加上模型 ID,就是另一个进程所需的全部信息 + + # 轮询直到请求完成,并等待服务器指定的 Retry-After 时间。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自身的载荷,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在这里抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境中读取 COMFY_API_KEY。 +// 每次调用 submit() 都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("vertexai/gemini-4-argon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并带有 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. 轮询直到状态为 COMPLETED,每次响应指定的 Retry-After 秒数都要等待。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。模型原生输出返回 200,仍在运行时返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 与模型当前对话的内容。对于单轮查询,这是单个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + `data` 或 `fileUri` 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + + Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + + + + 要在提示中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + + Format: `byte` + + + + `data` 或 `fileUri` 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + + Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 模型如何读取此部分的视频。设置 "AGENTIC" 可让模型决定检查哪些片段,而不是固定速率帧采样。省略则使用默认的固定速率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 + + + + 文本提示或代码片段。 + + + + 表示此部分是模型的思考/推理步骤。 + + + + 可能的值:`user`、`model` + + + + 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 + + + + 图像生成的配置 + + + + 已生成图像的宽高比 + + + + 可选。已生成图像的图像输出格式。 + + + + 可选。输出图像的压缩质量。 + + + + 可选。输出应保存为的图像格式,适用于 Vertex AI 路径:由 ComfyUI 自身凭据提供的请求,以及使用 GCP 服务账号认证的 BYOK 请求。这些路径接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求前规范化为小写;任何其他值都会以 400 拒绝并指明此字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥认证的 BYOK 请求是例外:该上游没有此属性,如果存在则会拒绝整个调用,因此该字段会从请求中删除,而不是被采纳或拒绝,输出格式由 AI Studio 选择。在所有路径上,请从返回的响应部分读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假设你发送的值。 + + + + 可选。指定已生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 + + + + 响应中可以生成的最大 token 数量。一个 token 大约相当于 4 个字符。100 个 token 大约对应 60-80 个单词。 + + Range: `16` to `65536` + + + + + + + + 当种子固定为特定值时,模型会尽力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,会使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + + + + + + + + 温度用于在响应生成期间进行采样,这一过程在应用 topP 和 topK 时发生。温度控制 token 选择中的随机程度。较低的温度适合需要不那么开放式或创造性响应的提示词,而较高的温度可以带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示词的响应基本是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出回退响应,请尝试提高温度 + + 范围:`0` 至 `2` + + 格式:`float` + + + + 可选。用于思考功能的配置。思考是模型将复杂任务分解为更小步骤以生成更高质量响应的过程。 + + + + 可选。如果为 true,模型将在响应中包含其思考内容。 + + + + 可选。模型思考过程的 token 预算。模型将尽力控制在此预算内。 + + + + 可选。模型的思考级别。 + + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` + + + + Top-K 会改变模型为输出选择 token 的方式。Top-K 为 1 表示下一个已选择的 token 是模型词汇表中所有 token 里概率最高的。Top-K 为 3 表示通过温度从概率最高的 3 个 token 中选择下一个 token。 + + 范围:`1` 至 `…` + + + + 如果指定,则使用核采样。 +Top-P 会改变模型为输出选择 token 的方式。系统会从概率最高(参见 top-K)到最低的 token 中进行选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会通过温度选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 +指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 + + 范围:`0` 至 `1` + + 格式:`float` + + + + 用于阻止不安全内容的按请求设置。对 GenerateContentResponse.candidates 强制执行。 + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 可能的值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + + + + 用于引导模型获得更好表现的指令。例如,“尽可能简洁地回答”或“回答中不要使用技术术语”。文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,并且不影响模型的表现。注意:parts 中只应使用文本,每个 part 中的内容应放在单独段落中。 + + + + 组成单条消息的有序 parts 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入的限制,例如最大 token 数或图像数量,请参阅 Google 模型页面上的模型规格。 + + + + 文本提示词或代码片段。 + + + + 创建消息的实体的身份。支持以下值:user:表示消息由真实人员发送,通常是用户生成的消息。model:表示消息由模型生成。在多轮对话中,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或未设置。 + + 可能的值:`user`、`model` + + + + 一段代码,使系统能够与外部系统交互,以执行模型的知识和范围之外的操作或一组操作。参见函数调用。 + + + + + + + + + + + + + + + + 函数参数的 JSON schema + + + + 如果为 true,生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联的 base64 数据。URL 会在 24 小时后过期。 + + + + 对于视频输入,表示视频的起始和结束偏移量,使用 Duration 格式。例如,要指定从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有在视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 + + + + 表示视频时间轴位置上的时长偏移量。 + + + + 以纳秒精度表示的带符号秒的小数部分。带小数的负秒值其纳秒值仍必须为非负。 + + 范围:`0` 到 `999999999` + + + + 时间跨度的带符号秒数。必须介于 -315,576,000,000 与 +315,576,000,000 之间(含边界)。 + + 范围:`-315576000000` 到 `315576000000` + + + + 表示视频时间轴位置上的时长偏移量。 + + + + 以纳秒精度表示的带符号秒的小数部分。带小数的负秒值其纳秒值仍必须为非负。 + + 范围:`0` 到 `999999999` + + + + 时间跨度的带符号秒数。必须介于 -315,576,000,000 与 +315,576,000,000 之间(含边界)。 + + 范围:`-315576000000` 到 `315576000000` + + +根据 Router 在 `GET /v2/models/vertexai/gemini-4-argon/openapi.json` 处提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 + +### 输出 + + + + + + + + + + + + + + + + + + + + + + + + + + + 格式:`date` + + + + + + + + + + + + + + + + 与模型当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下这些。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长时长为 8.4 小时,视频文件(不含音频)的最长时长为 1 小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率没有限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可以指定 3000 张图像。 + + + + 要在提示中内联包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + + 格式:`byte` + + + + data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下这些。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长时长为 8.4 小时,视频文件(不含音频)的最长时长为 1 小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率没有限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 模型如何读取此部分的视频。设置为“AGENTIC”可让模型决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。受支持于 gemini-3.7-flash 及更新的 Flash 模型。 + + + + 文本提示或代码片段。 + + + + 表示此部分是模型的思考/推理步骤。 + + + + 可能的值:`user`、`model` + + + + + + + + + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应创建时的时间戳。 + + + + 用于生成响应的模型版本。 + + + + + + + + + + + + + + + + + + + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应的唯一标识符。 + + + + + + + + 仅输出。输入中缓存部分(缓存的内容)的 token 数量。 + + + + 响应中的 token 数量。 + + + + 候选 token 按模态的细分统计。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + 请求中的 token 数量。当设置了 cachedContent 时,这仍然是有效的提示总大小,也就是说它包含缓存内容中的 token 数量。 + + + + 提示 token 按模态的细分统计。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + 思考输出中存在的 token 数量。 + + + + 工具使用提示中存在的 token 数量。 + + + + 工具使用提示 token 按模态的细分统计。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + token 总数(提示 + 候选)。 + + + + 用于请求的流量类型(例如 PROVISIONED_THROUGHPUT)。 + + +## 示例 + +### 输入 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 输出 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-argon", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + diff --git a/zh/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/zh/development/comfy-router/models/google/gemini-4-carbon/code.mdx new file mode 100644 index 0000000000..6cf2b3daeb --- /dev/null +++ b/zh/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -0,0 +1,693 @@ +--- +title: "使用 Comfy Router 调用 Gemini 4 Carbon" +description: "通过 Comfy Router 调用 vertexai/gemini-4-carbon:endpoint、请求形状以及 Router 返回的响应。" +sidebarTitle: "Gemini 4 Carbon" +translationSourceHash: c107edac +translationFrom: development/comfy-router/models/google/gemini-4-carbon/code.mdx +translationBlockHashes: + "_intro": 8eafb327 + "Quick start": a26083eb + "Schema": 1046bf02 + "Examples": b2720522 +--- +{/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-4-carbon.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +由 Comfy Router 提供、来自 Google 的 `vertexai/gemini-4-carbon` 的 API 参考。 + +**输入:** 文本、图像、音频、视频 · **输出:** 文本 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 片段则是通过原始 HTTP 发起的同一个调用。 + +**模型 ID:** `vertexai/gemini-4-carbon` + +**端点:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-carbon` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量中读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-carbon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("vertexai/gemini-4-carbon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests`。运行一旦被受理,Router 就会返回 `201` 和 `request_id`;结果就绪后,可从当前进程或其他进程收取。[队列投递](/zh/development/comfy-router/queue)详细介绍了状态、取消与结果收取。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量中读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-carbon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # 配合模型 ID,就是另一个进程所需的全部信息 + + # 轮询直到请求完成,按服务器指定的 Retry-After 等待。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自身的负载,即 models.run() 返回的同一个值。 + # 失败或已取消的请求会在此处抛出带类型的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("vertexai/gemini-4-carbon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并带有 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. 轮询直到 status 为 COMPLETED,每次响应都会指定 Retry-After 秒数,按其等待。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收取。返回 200 表示模型的原始输出;仍在运行时则返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 与模型当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 + + 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 以原始字节表示的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可指定 3000 张图像。 + + + + 要内联包含在提示词中的图像、PDF 或视频的 Base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + + 格式:`byte` + + + + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 + + 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + 模型如何读取此部分的视频。设置 "AGENTIC" 可让模型决定检查哪些片段,而不是采用固定速率帧采样。省略则使用默认的固定速率采样。受 gemini-3.7-flash 及更新的 Flash 模型支持。 + + + + 文本提示词或代码片段。 + + + + 表示此部分来自模型的思考/推理步骤。 + + + + 可能的值:`user`, `model` + + + + 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 + + + + 图像生成配置 + + + + 已生成图像的宽高比 + + + + 可选。已生成图像的图像输出格式。 + + + + 可选。输出图像的压缩质量。 + + + + 可选。输出应保存成的图像格式,适用于 Vertex AI 的各条路径:由 Comfy 自身凭据提供服务的请求,以及使用 GCP 服务账号认证的 BYOK 请求。此处接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;任何其他值都会被拒绝,并返回一个指明此字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥认证的 BYOK 请求是例外:该上游没有此属性,如果存在此字段会拒绝整个调用,因此该字段会从请求中丢弃,而不是被采纳或拒绝,输出格式则由 AI Studio 自行选择。在每条路径上,都应从收到的响应部分中读回媒体类型(`inlineData.mimeType`,或在设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假定你发送的值。 + + + + 可选。指定已生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 + + + + 响应中可生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大约对应 60-80 个词。 + + 范围:`16` 到 `65536` + + + + + + + + When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. 不保证输出具有确定性。此外,更改模型或参数设置(例如温度)即使在种子值相同的情况下也可能导致响应发生变化。默认使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + + + + + + + + 温度用于响应生成过程中的采样,而该采样在应用 topP 和 topK 时发生。温度控制 token 选择的随机程度。较低温度适合需要较少开放性、较少创造性的提示;较高温度则可能带来更多样或更具创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过短,或模型给出回退响应,请尝试提高温度。 + + 范围:`0` 到 `2` + + 格式:`float` + + + + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤,以生成更高质量响应的过程。 + + + + 可选。如果为 true,模型将在响应中包含其思考内容。 + + + + 可选。模型思考过程的 token 预算。模型将尽力保持在此预算范围内。 + + + + 可选。模型的思考级别。 + + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` + + + + Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示下一个选中的 token 是模型词表中所有 token 里概率最高的。top-K 为 3 表示根据温度从概率最高的 3 个 token 中选择下一个 token。 + + 范围:`1` 到 `…` + + + + 如果指定,则使用核采样。 +Top-P 会改变模型为输出选择 token 的方式。从概率最高(参见 top-K)到最低选择 token,直到其概率之和等于 top-P 值。例如,如果 token A、B、C 的概率分别为 0.3、0.2、0.1,且 top-P 值为 0.5,那么模型将根据温度选择 A 或 B 作为下一个 token,并排除 C 作为候选。 +指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 + + 范围:`0` 到 `1` + + 格式:`float` + + + + 用于阻止不安全内容的按请求设置。对 GenerateContentResponse.candidates 强制执行。 + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 可能的值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + + + + 用于引导模型取得更好表现的指令。例如,“尽可能简洁地回答”或“不要在回复中使用技术术语”。文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,且不会影响模型的性能。注意:parts 中只应使用文本,并且每个 part 中的内容应位于单独的段落中。 + + + + 构成单条消息的有序 parts 列表。不同 part 可能具有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规范。 + + + + 文本提示或代码片段。 + + + + 创建该消息的实体的身份。支持以下值:user: 这表示消息由真实人员发送,通常是用户生成的消息。model: 这表示消息由模型生成。在多轮对话期间,model 值用于将来自模型的消息插入对话中。对于非多轮对话,此字段可以留空或未设置。 + + 可能的值:`user`、`model` + + + + 一段代码,使系统能够与外部系统交互,以执行模型知识和范围之外的一个操作或一组操作。参见函数调用。 + + + + + + + + + + + + + + + + 函数参数的 JSON schema + + + + 如果为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联的 base64 数据。这些 URL 在 24 小时后过期。 + + + + 对于视频输入,视频的起始和结束偏移量,采用 Duration 格式。例如,要指定从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 + + + + 表示视频时间轴位置的时长偏移量。 + + + + 以纳秒分辨率表示的有符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + + 范围:`0` 到 `999999999` + + + + 时间段的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 + + 范围:`-315576000000` 到 `315576000000` + + + + 表示视频时间轴位置的时长偏移量。 + + + + 以纳秒分辨率表示的有符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + + 范围:`0` 到 `999999999` + + + + 时间段的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 + + 范围:`-315576000000` 到 `315576000000` + + +根据 Router 在 `GET /v2/models/vertexai/gemini-4-carbon/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前 Router 用于校验调用的同一份文档。 + +### 输出 + + + + + + + + + + + + + + + + + + + + + + + + + + + 格式:`date` + + + + + + + + + + + + + + + + 与模型进行的当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史记录和最新的请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 以原始字节形式内联的数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + + + + 要在提示词中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定该数据的媒体类型(mimeType)。大小限制:20MB + + 格式:`byte` + + + + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 模型如何读取此部分中的视频。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是采用固定帧率采样。省略该字段则使用默认的固定帧率采样。受 gemini-3.7-flash 及更新的 Flash 模型支持。 + + + + 文本提示词或代码片段。 + + + + 指示此部分是否为模型的思考/推理步骤。 + + + + 可能的值:`user`、`model` + + + + + + + + + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应创建时的时间戳。 + + + + 用于生成响应的模型版本。 + + + + + + + + + + + + + + + + + + + + 内容违反的安全类别 + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应的唯一标识符。 + + + + + + + + 仅输出。输入中缓存部分(缓存内容)的 token 数。 + + + + 响应中的 token 数。 + + + + 按模态划分的候选 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数。 + + + + 请求中的 token 数。设置 cachedContent 时,这仍是有效的提示总大小,也就是说其中包含缓存内容中的 token 数。 + + + + 按模态划分的提示 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数。 + + + + 思考输出中的 token 数。 + + + + 工具使用提示中的 token 数。 + + + + 按模态划分的工具使用提示 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数。 + + + + token 总数(提示 + 候选)。 + + + + 用于请求的流量类型(例如 PROVISIONED_THROUGHPUT)。 + + +## 示例 + +### 输入 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 输出 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-carbon", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + + diff --git a/zh/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx b/zh/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx new file mode 100644 index 0000000000..27aec713a7 --- /dev/null +++ b/zh/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx @@ -0,0 +1,694 @@ +--- +title: "将 Gemini 4 Hydrogen 与 Comfy Router 配合使用" +description: "通过 Comfy Router 调用 vertexai/gemini-4-hydrogen:端点、请求形状以及 Router 返回的响应。" +sidebarTitle: "Gemini 4 Hydrogen" +translationSourceHash: 2fc4f945 +translationFrom: development/comfy-router/models/google/gemini-4-hydrogen/code.mdx +translationBlockHashes: + "_intro": 1792fa1e + "Quick start": 6dd0010d + "Schema": 3edab77e + "Examples": 3698dfec +--- +{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/vertexai/gemini-4-hydrogen.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`vertexai/gemini-4-hydrogen` 的 API 参考文档,由 Comfy Router 从 Google 提供。 + +**输入:** 文本、图像、音频、视频 · **输出:** 文本 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建一个密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段则是通过原始 HTTP 发出的相同调用。 + +**模型 ID:** `vertexai/gemini-4-hydrogen` + +**端点:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量中读取 COMFY_API_KEY。 +# SDK 会自动创建一个幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-hydrogen", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// SDK 会自动创建一个幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("vertexai/gemini-4-hydrogen", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +同一个请求体,发送到 `POST https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests`。一旦运行被受理,Router 就会返回 `201` 和一个 `request_id`;结果就绪后即可收集,可由当前进程或另一个进程进行。[排队交付](/zh/development/comfy-router/queue)会讲解状态、取消和收集的流程。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量中读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-hydrogen", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # 加上模型 ID,就是另一个进程所需的全部 + + # 轮询直到请求完成,按服务器指定的 Retry-After 等待。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自身的载荷,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在此处抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("vertexai/gemini-4-hydrogen", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并附带 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. 轮询直到状态为 COMPLETED,每次响应按指定的 Retry-After 秒数等待。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。返回 200 及模型的原生输出;若仍在运行,则返回 202 及状态正文。 +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 与模型当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可以指定 3000 张图像。 + + + + 要在提示中内联包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + + 格式:`byte` + + + + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 模型如何读取该部分中的视频。将该项设置为 “AGENTIC”,可让模型决定检查哪些片段,而不是采用固定帧率采样。省略该项则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 + + + + 文本提示或代码片段。 + + + + 表示该部分是模型的思考/推理步骤。 + + + + 可能的值:`user`、`model` + + + + 用于生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 + + + + 图像生成配置 + + + + 已生成图像的宽高比 + + + + 可选。已生成图像的图像输出格式。 + + + + 可选。输出图像的压缩质量。 + + + + 可选。在 Vertex AI 路径上输出应保存为的图像格式,这些路径包括由 Comfy 自有凭据处理的请求,以及使用 GCP 服务账号完成身份验证的 BYOK 请求。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;其他任何值都会被拒绝,并返回指明该字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥完成身份验证的 BYOK 请求是例外:该上游没有此属性,只要该属性存在就会拒绝整个调用,因此该字段会从请求中移除,而不是被采用或拒绝,输出格式由 AI Studio 决定。在所有路径上,都应从返回给你的响应部分读回媒体类型(`inlineData.mimeType`,或在设置了 `uploadImagesToStorage` 时读取 `fileData.mimeType`),而不是假定你发送的值。 + + + + 可选。指定已生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 + + + + 响应中可生成的最大 token 数。一个 token 约为 4 个字符。100 个 token 大致相当于 60 至 80 个单词。 + + 范围:`16` 到 `65536` + + + + + + + + +当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + + + + + + + + 温度用于响应生成期间的采样,而采样会在应用 topP 和 topK 时发生。温度控制 token 选择的随机程度。较低的温度适合要求响应不那么开放或创意性较低的提示词,而较高的温度可能带来更多样或更有创意的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,对于给定提示词,响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出回退响应,请尝试提高温度。 + + 范围:`0` 到 `2` + + 格式:`float` + + + + 可选。思考功能的配置。思考是指模型将复杂任务分解为更小步骤以生成更高质量响应的过程。 + + + + 可选。若为 true,模型会在响应中包含其思考内容。 + + + + 可选。模型思考过程的 token 预算。模型会尽最大努力保持在此预算范围内。 + + + + 可选。模型的思考级别。 + + 可能值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` + + + + Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示下一个选中的 token 是模型词表中所有 token 里概率最高的。top-K 为 3 表示通过温度从概率最高的 3 个 token 中选择下一个 token。 + + 范围:`1` 到 `…` + + + + 如果指定,则使用核采样。 +Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最高(参见 top-K)到最低进行选择,直到其概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,则模型会使用温度选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 +指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 + + 范围:`0` 到 `1` + + 格式:`float` + + + + 用于阻止不安全内容的请求级设置。在 GenerateContentResponse.candidates 上强制执行。 + + + + 可能值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 可能值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + + + + 用于引导模型获得更好表现的指令。例如,“尽可能简洁地回答”或“回答中不要使用技术术语”。文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,且不会影响模型的表现。注意:parts 中只应使用文本,每个 part 中的内容应放在单独段落中。 + + + + 组成单条消息的有序部分列表。不同部分可能具有不同的 IANA MIME 类型。有关输入限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规范。 + + + + 文本提示词或代码片段。 + + + + 创建消息的实体的身份。支持以下值:user:表示消息由真实人员发送,通常是用户生成的消息。model:表示消息由模型生成。在多轮对话中,model 值用于将来自模型的消息插入对话中。对于非多轮对话,此字段可以留空或未设置。 + + 可能值:`user`、`model` + + + + 一段代码,使系统能够与外部系统交互,以执行超出模型知识和范围的操作或一组操作。请参阅函数调用。 + + + + + + + + + + + + + + + + 函数参数的 JSON schema + + + + 如果设为 true,已生成的图像将上传到云端存储,并以签名 URL 返回,而不是以内联 base64 数据返回。这些 URL 会在 24 小时后过期。 + + + + 对于视频输入,指定视频的起始和结束偏移量,以 Duration 格式表示。例如,要指定从 1:00 开始的一段 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有在视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 + + + + 表示视频时间轴位置的一个时长偏移量。 + + + + 以纳秒精度表示的带符号秒的小数部分。秒值为负数且带小数部分时,其 nanos 值仍必须为非负数。 + + Range: `0` 到 `999999999` + + + + 带符号的秒数,表示时间跨度。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 + + Range: `-315576000000` 到 `315576000000` + + + + 表示视频时间轴位置的一个时长偏移量。 + + + + 以纳秒精度表示的带符号秒的小数部分。秒值为负数且带小数部分时,其 nanos 值仍必须为非负数。 + + Range: `0` 到 `999999999` + + + + 带符号的秒数,表示时间跨度。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 + + Range: `-315576000000` 到 `315576000000` + + +该内容由 Router 在 `GET /v2/models/vertexai/gemini-4-hydrogen/openapi.json` 处提供的 schema 生成,它也是请求到达提供商之前 Router 用来校验调用的同一份文档。 + +### 输出 + + + + + + + + + + + + + + + + + + + + + + + + + + + 格式:`date` + + + + + + + + + + + + + + + + 与模型的当前对话内容。对于单轮查询,这是一个单个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + + + + + + + + 基于 URI 的数据。 + + + + URI + + + + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 以内联原始字节形式提供的数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可指定 3000 张图像。 + + + + 要在提示中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + + 格式:`byte` + + + + data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + + + + 模型如何读取此部分的视频。设置为“AGENTIC”可让模型决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 + + + + 文本提示或代码片段。 + + + + 表示此部分是模型的思考/推理步骤。 + + + + 可能的值:`user`、`model` + + + + + + + + + + + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应创建时的时间戳。 + + + + 用于生成该响应的模型版本。 + + + + + + + + + + + + + + + + + + + + 内容所违反的安全类别 + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + + + + 内容违反指定安全类别的概率 + + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + + + + 响应的唯一标识符。 + + + + + + + + 仅输出。输入中缓存部分(缓存内容)的 token 数量。 + + + + 响应中的 token 数量。 + + + + 按模态划分的候选 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + 请求中的 token 数量。设置 cachedContent 时,这仍是有效的提示总大小,也就是说它包含缓存内容中的 token 数量。 + + + + 按模态划分的提示 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + 思考输出中存在的 token 数量。 + + + + 工具使用提示中存在的 token 数量。 + + + + 按模态划分的工具使用提示 token 明细。 + + + + 输入或输出内容的模态类型。 + + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + + + + 给定模态的 token 数量。 + + + + token 总数(提示 + 候选)。 + + + + 用于请求的流量类型(例如 PROVISIONED_THROUGHPUT)。 + + +## 示例 + +### 输入 + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### 输出 + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-hydrogen", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + + diff --git a/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx b/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx index 061cc851e5..770fc90ef5 100644 --- a/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx @@ -2,16 +2,17 @@ title: "将 Gemini Nano Banana 2.1 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 vertexai/gemini-nano-banana-2.1:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Gemini Nano Banana 2.1" -translationSourceHash: 6f9161dd +translationSourceHash: 833b248e translationFrom: development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx translationBlockHashes: "_intro": 5cb6762b "Quick start": df454451 "Serving providers": af126fd5 - "Schema": 02b80e67 + "Schema": 2313ddad "Examples": dff3e9f8 --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-nano-banana-2.1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -193,7 +194,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R ### 输入 - 与模型当前对话的内容。对于单轮查询,这是一个单独实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + 与模型当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -209,29 +210,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下这些。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长时长为 8.4 小时,视频文件(无音频)的最长时长为 1 小时。更多信息请参阅 Gemini 音频和视频依赖项。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - 可选值: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可以指定 3000 张图像。 + 以原始字节表示的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可以指定 3000 张图像。 - 内联包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定该数据的媒体类型(mimeType)。大小限制:20MB + 要在提示中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB - 格式: `byte` + 格式:`byte` - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下这些。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最长时长为 8.4 小时,视频文件(无音频)的最长时长为 1 小时。更多信息请参阅 Gemini 音频和视频依赖项。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - 可选值: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是使用固定帧率的采样。省略则使用默认的固定帧率采样。gemini-3.7-flash 及更新的 Flash 模型支持此功能。 + 模型如何读取此部分中的视频。设置为 "AGENTIC" 可让模型决定检查哪些片段,而不是采用固定帧率采样。省略该字段则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 @@ -239,11 +240,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 表示此部分是来自模型的一个思考/推理步骤。 + 表示此部分是模型的思考/推理步骤。 - 可选值: `user`, `model` + 可能值:`user`、`model` @@ -251,7 +252,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 图像生成的配置 + 图像生成配置 @@ -267,7 +268,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 可选。在 Vertex AI 路径上,输出应保存为的图像格式:即由 Comfy 自有凭据提供的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径上可接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在请求转发之前规范化为小写;任何其他值都会被拒绝,并返回指出此字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,若该属性存在会拒绝整个调用,因此该字段会从请求中移除,而不是被采纳或拒绝,输出格式则为 AI Studio 所选择的格式。在所有路径上,都应从返回给你的响应部分中读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时读取 `fileData.mimeType`),而不要假定你发送的值。 + 可选。在 Vertex AI 路径上,输出应保存为的图像格式:由 Comfy 自有凭据提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;任何其他值都会被拒绝,并返回一个指明此字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,如果存在该字段就会拒绝整个调用,因此该字段会从请求中删除,而不是被接受或拒绝,输出格式由 AI Studio 选择。在所有路径上,都应从返回给你的响应部分读回媒体类型(`inlineData.mimeType`,或在设置了 `uploadImagesToStorage` 时读取 `fileData.mimeType`),而不是假定你发送的值。 @@ -275,9 +276,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 响应中可生成的最大 token 数。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60 至 80 个单词。 + 响应中可以生成的最大 token 数。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个词。 - 范围: `16` 到 `65536` + 范围:`16` 到 `65536` @@ -285,7 +286,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 当种子固定为特定值时,模型会尽最大努力对重复请求给出相同的响应。无法保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如 temperature)也可能导致响应出现变化。默认情况下会使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + 当种子固定为特定值时,模型会尽力为重复请求提供相同的响应。不保证输出具有确定性。此外,更改模型或参数设置(例如温度)可能会导致响应发生变化,即使使用相同的种子值也是如此。默认情况下,使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 @@ -293,7 +294,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - temperature 用于在响应生成过程中进行采样,采样发生在应用 topP 和 topK 时。temperature 控制 token 选择过程中的随机程度。较低的温度适合需要不太开放或不太有创意响应的提示词,而较高的温度可以带来更多样或更有创意的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示词的响应基本是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了回退响应,请尝试提高 temperature + 温度用于响应生成过程中的采样,采样会在应用 topP 和 topK 时进行。温度控制 token 选择中的随机程度。较低的温度适合需要不那么开放式或创造性响应的提示词,而较高的温度可以产生更多样或更具创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示词的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过短,或模型给出回退响应,请尝试提高温度 范围:`0` 到 `2` @@ -301,7 +302,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤,以生成更高质量响应的过程。 + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤以生成更高质量响应的过程。 @@ -309,24 +310,24 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-nano-banana-2.1/requests/$R - 可选。模型思考过程的 token 预算。模型会尽最大努力保持在该预算范围内。 + 可选。模型思考过程的 token 预算。模型会尽力保持在该预算范围内。 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` - Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示下一个被选择的 token 是模型词表中所有 token 里概率最高的那个。top-K 为 3 表示下一个 token 会借助 temperature 从概率最高的 3 个 token 中选出。 + Top-K 会改变模型选择 token 进行输出的方式。top-K 为 1 表示下一个选中的 token 是模型词表中所有 token 里概率最高的。top-K 为 3 表示通过使用温度从概率最高的 3 个 token 中选择下一个 token。 范围:`1` 到 `…` 如果指定,则使用核采样。 -Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高(参见 top-K)到概率最低依次被选中,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,而 top-P 值为 0.5,那么模型会借助 temperature 选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 +Top-P 会改变模型选择 token 进行输出的方式。token 会按概率从最高(参见 top-K)到最低进行选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B、C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,则模型会通过使用温度选择 A 或 B 作为下一个 token,并排除 C 作为候选。 指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 范围:`0` 到 `1` @@ -335,7 +336,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 用于阻止不安全内容的按请求设置。在 GenerateContentResponse.candidates 上强制执行。 + 用于阻止不安全内容的每次请求设置。在 GenerateContentResponse.candidates 上强制执行。 @@ -347,11 +348,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 用于引导模型以获得更好表现的指令。例如,"尽可能简洁地回答" 或 "在回复中不要使用技术术语"。文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,且每个 part 中的内容应位于单独的段落中。 + 用于引导模型获得更好性能的指令。例如,“尽可能简洁地回答”或“响应中不要使用技术术语”。文本字符串会计入 token 上限。systemInstruction 的 role 字段会被忽略,且不会影响模型的性能。注意:parts 中只应使用文本,且每个 part 中的内容应位于单独的段落中。 - 构成单条消息的有序 parts 列表。不同的 part 可以具有不同的 IANA MIME 类型。关于输入的限额,例如最大 token 数或图像数量,请参阅 Google 模型页面上的模型规格。 + 组成单条消息的有序 parts 列表。不同的 part 可能具有不同的 IANA MIME 类型。有关输入限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规格。 @@ -359,13 +360,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 创建消息的实体的身份。支持以下值:user:表示消息由真人发送,通常是用户生成的消息。model:表示消息由模型生成。在多轮对话期间,使用 model 值将来自模型的消息插入对话中。对于非多轮对话,该字段可以留空或不设置。 + 创建消息的实体的身份。支持以下值:user 表示消息由真人发送,通常是用户生成的消息。model 表示消息由模型生成。model 值用于在多轮对话期间将来自模型的消息插入对话中。对于非多轮对话,此字段可以留空或未设置。 可能的值:`user`、`model` - 一段代码,使系统能够与外部系统交互,以执行模型知识和范围之外的一个或多个操作。参见函数调用。 + 一段代码,使系统能够与外部系统交互,以执行超出模型知识和范围的操作或一组操作。请参阅函数调用。 @@ -385,46 +386,46 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 如果为是,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是以内联 base64 数据返回。这些 URL 会在 24 小时后过期。 + 如果为 true,已生成的图像将上传到云端存储,并作为签名 URL 返回,而不是以内联 base64 数据返回。这些 URL 会在 24 小时后过期。 - 对于视频输入,表示视频的起始和结束偏移量,采用 Duration 格式。例如要指定从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 + 用于视频输入,表示视频的起始和结束偏移量,采用 Duration 格式。例如,要指定从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有在视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 - 表示视频时间线位置的一个时长偏移量。 + 表示视频时间轴位置的一种时长偏移量。 - 以纳秒分辨率表示的有符号秒的小数部分。带有小数部分的负秒值,其 nanos 值仍必须为非负数。 + 以纳秒精度表示的带符号秒的小数部分。带小数部分的负秒值仍必须具有非负的 nanos 值。 范围:`0` 到 `999999999` - 时间段的有符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000(含两端)之间。 + 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 范围:`-315576000000` 到 `315576000000` - 表示视频时间线位置的一个时长偏移量。 + 表示视频时间轴位置的一种时长偏移量。 - 以纳秒分辨率表示的有符号秒的小数部分。带有小数部分的负秒值,其 nanos 值仍必须为非负数。 + 以纳秒精度表示的带符号秒的小数部分。带小数部分的负秒值仍必须具有非负的 nanos 值。 范围:`0` 到 `999999999` - 时间段的有符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000(含两端)之间。 + 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 范围:`-315576000000` 到 `315576000000` -本内容由 Router 在 `GET /v2/models/vertexai/gemini-nano-banana-2.1/openapi.json` 提供的 schema 生成,与请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/vertexai/gemini-nano-banana-2.1/openapi.json` 处提供的 schema 生成,该文档与 Router 在请求到达提供商之前用于校验调用的文档相同。 ### 输出 @@ -469,7 +470,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 与模型当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史记录和最新请求。 + 与模型的当前对话内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 @@ -485,41 +486,41 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + 由 data 或 fileUri 字段指定的文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - 可选值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 以原始字节表示的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可指定 3000 张图像。 - 要在提示中内联包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要在提示词中以内联方式包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB 格式:`byte` - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 + 由 data 或 fileUri 字段指定的文件的媒体类型。可接受的值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - 可选值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。支持 gemini-3.7-flash 及更新的 Flash 模型。 + 模型如何读取此部分的视频。设置为 “AGENTIC” 可让模型自行决定要检查哪些片段,而不是按固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 - 文本提示或代码片段。 + 文本提示词或代码片段。 - 表示此部分是模型的思考/推理步骤。 + 表示此部分来自模型的思考/推理步骤。 - 可选值:`user`, `model` + 可能的值:`user`, `model` @@ -531,21 +532,21 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 可选值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - 内容违反所指定安全类别的概率 + 内容违反指定安全类别的概率 - 可选值:`NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 可能的值:`NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - 响应创建时的时间戳。 + 响应创建的时间戳。 - 用于生成响应的模型版本。 + 用于生成该响应的模型版本。 @@ -565,13 +566,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 可选值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` 内容违反指定安全类别的概率 - 可选值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -583,7 +584,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 仅输出。输入中缓存部分(即缓存内容)的 token 数量。 + 仅输出。输入中缓存部分(缓存内容)的 token 数量。 @@ -595,61 +596,61 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 输入或输出内容的模态类型。 + 输入或输出内容模态的类型。 - 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` - 指定模态的 token 数量。 + 给定模态的 token 数量。 - 请求中的 token 数量。设置 cachedContent 后,该值仍表示提示的总有效大小,也就是说其中包含缓存内容中的 token 数量。 + 请求中的 token 数量。设置 cachedContent 时,这仍是提示词的总有效大小,意味着其中包含缓存内容中的 token 数量。 - 按模态划分的提示 token 明细。 + 按模态划分的提示词 token 明细。 - 输入或输出内容的模态类型。 + 输入或输出内容模态的类型。 - 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` - 指定模态的 token 数量。 + 给定模态的 token 数量。 - 思维输出中的 token 数量。 + thoughts 输出中的 token 数量。 - 工具使用提示中的 token 数量。 + 工具使用提示词中的 token 数量。 - 按模态划分的工具使用提示 token 明细。 + 按模态划分的工具使用提示词 token 明细。 - 输入或输出内容的模态类型。 + 输入或输出内容模态的类型。 - 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` - 指定模态的 token 数量。 + 给定模态的 token 数量。 - token 总数(提示 + 候选)。 + token 总数(提示词 + 候选)。 - 用于该请求的流量类型(例如 PROVISIONED_THROUGHPUT)。 + 用于请求的流量类型(例如 PROVISIONED_THROUGHPUT)。 ## 示例 From fbdc0d13b424cc8ec991a0461a03be1445db3691 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Fri, 13 Nov 2026 11:52:58 +0800 Subject: [PATCH 26/36] i18n: resync the remaining router pages for zh/ja/ko after the 2026-11-12 cloud sync --- ja/development/comfy-router/limitations.mdx | 42 +- ja/development/comfy-router/models.mdx | 73 +++- .../anthropic/claude-sonnet-5-5/code.mdx | 7 +- .../models/google/gemini/code.mdx | 6 +- .../models/google/nano-banana-2-lite/code.mdx | 127 +++--- .../models/google/nano-banana-2/code.mdx | 138 +++--- .../models/google/nano-banana-pro/code.mdx | 137 +++--- .../models/kling/kling-v2-5-turbo/code.mdx | 93 ++-- .../models/kling/kling-v2-6/code.mdx | 82 ++-- .../models/kling/kling-v3-omni/code.mdx | 23 +- .../models/kling/kling-v3/code.mdx | 77 ++-- .../models/kling/kling-video-o1/code.mdx | 17 +- .../models/ltx/ltx-video-alpha-gen/code.mdx | 222 ++++++++++ .../ltx/ltx-video-to-video-hdr/code.mdx | 232 ++++++++++ .../ltx/ltx-video-to-video-reframe/code.mdx | 261 ++++++++++++ .../models/ltx/ltx-video-upscale/code.mdx | 227 ++++++++++ .../openai/gpt-image-2-6-flare/code.mdx | 50 ++- .../openai/gpt-image-2-6-sunburst/code.mdx | 47 ++- .../models/pixverse/v3-5/code.mdx | 309 ++++++++++++++ .../models/pixverse/v6-max/code.mdx | 308 ++++++++++++++ .../comfy-router/models/pixverse/v6/code.mdx | 308 ++++++++++++++ .../models/pruna/p-video-2/code.mdx | 39 +- .../models/quiver/arrow-2-telos/code.mdx | 283 +++++++++++++ .../models/quiver/arrow-2/code.mdx | 283 +++++++++++++ .../veo/veo-3-1-fast-generate-001/code.mdx | 16 +- .../models/veo/veo-3-1-generate-001/code.mdx | 16 +- .../veo/veo-3-1-lite-generate-001/code.mdx | 21 +- ja/development/comfy-router/pricing.mdx | 84 ++-- ja/development/comfy-router/quickstart.mdx | 28 +- ja/development/comfy-router/reference.mdx | 389 ++++++++--------- ko/development/comfy-router/limitations.mdx | 36 +- ko/development/comfy-router/models.mdx | 264 ++++++------ .../anthropic/claude-sonnet-5-5/code.mdx | 7 +- .../google/gemini-3-1-flash-lite/code.mdx | 112 ++--- .../models/google/gemini/code.mdx | 6 +- .../models/google/nano-banana-2-lite/code.mdx | 115 +++-- .../models/google/nano-banana-2/code.mdx | 157 ++++--- .../models/google/nano-banana-pro/code.mdx | 107 +++-- .../models/kling/kling-v2-5-turbo/code.mdx | 73 ++-- .../models/kling/kling-v2-6/code.mdx | 85 ++-- .../models/kling/kling-v3-omni/code.mdx | 21 +- .../models/kling/kling-v3/code.mdx | 69 +-- .../models/kling/kling-video-o1/code.mdx | 27 +- .../models/ltx/ltx-video-alpha-gen/code.mdx | 222 ++++++++++ .../ltx/ltx-video-to-video-hdr/code.mdx | 233 +++++++++++ .../ltx/ltx-video-to-video-reframe/code.mdx | 261 ++++++++++++ .../models/ltx/ltx-video-upscale/code.mdx | 227 ++++++++++ .../openai/gpt-image-2-6-flare/code.mdx | 49 ++- .../openai/gpt-image-2-6-sunburst/code.mdx | 60 ++- .../models/pixverse/v3-5/code.mdx | 309 ++++++++++++++ .../models/pixverse/v6-max/code.mdx | 308 ++++++++++++++ .../comfy-router/models/pixverse/v6/code.mdx | 309 ++++++++++++++ .../models/pruna/p-video-2/code.mdx | 33 +- .../models/quiver/arrow-2-telos/code.mdx | 283 +++++++++++++ .../models/quiver/arrow-2/code.mdx | 283 +++++++++++++ .../veo/veo-3-1-fast-generate-001/code.mdx | 21 +- .../models/veo/veo-3-1-generate-001/code.mdx | 34 +- .../veo/veo-3-1-lite-generate-001/code.mdx | 18 +- ko/development/comfy-router/pricing.mdx | 84 ++-- ko/development/comfy-router/quickstart.mdx | 28 +- ko/development/comfy-router/reference.mdx | 73 ++-- zh/development/comfy-router/limitations.mdx | 43 +- zh/development/comfy-router/models.mdx | 396 ++++++++++-------- .../anthropic/claude-sonnet-5-5/code.mdx | 7 +- .../models/google/gemini/code.mdx | 6 +- .../models/google/nano-banana-2-lite/code.mdx | 131 +++--- .../models/google/nano-banana-2/code.mdx | 119 +++--- .../models/google/nano-banana-pro/code.mdx | 125 +++--- .../models/kling/kling-v2-5-turbo/code.mdx | 51 +-- .../models/kling/kling-v2-6/code.mdx | 61 +-- .../models/kling/kling-v3-omni/code.mdx | 75 ++-- .../models/kling/kling-v3/code.mdx | 85 ++-- .../models/kling/kling-video-o1/code.mdx | 61 +-- .../models/ltx/ltx-video-alpha-gen/code.mdx | 222 ++++++++++ .../ltx/ltx-video-to-video-hdr/code.mdx | 232 ++++++++++ .../ltx/ltx-video-to-video-reframe/code.mdx | 261 ++++++++++++ .../models/ltx/ltx-video-upscale/code.mdx | 228 ++++++++++ .../openai/gpt-image-2-6-flare/code.mdx | 85 ++-- .../openai/gpt-image-2-6-sunburst/code.mdx | 86 ++-- .../models/pixverse/v3-5/code.mdx | 309 ++++++++++++++ .../models/pixverse/v6-max/code.mdx | 309 ++++++++++++++ .../comfy-router/models/pixverse/v6/code.mdx | 311 ++++++++++++++ .../models/pruna/p-video-2/code.mdx | 33 +- .../models/quiver/arrow-2-telos/code.mdx | 284 +++++++++++++ .../models/quiver/arrow-2/code.mdx | 284 +++++++++++++ .../veo/veo-3-1-fast-generate-001/code.mdx | 30 +- .../models/veo/veo-3-1-generate-001/code.mdx | 26 +- .../veo/veo-3-1-lite-generate-001/code.mdx | 36 +- zh/development/comfy-router/pricing.mdx | 84 ++-- zh/development/comfy-router/quickstart.mdx | 32 +- zh/development/comfy-router/reference.mdx | 387 ++++++++--------- 91 files changed, 9996 insertions(+), 2262 deletions(-) create mode 100644 ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx create mode 100644 ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx create mode 100644 ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx create mode 100644 ja/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx create mode 100644 ja/development/comfy-router/models/pixverse/v3-5/code.mdx create mode 100644 ja/development/comfy-router/models/pixverse/v6-max/code.mdx create mode 100644 ja/development/comfy-router/models/pixverse/v6/code.mdx create mode 100644 ja/development/comfy-router/models/quiver/arrow-2-telos/code.mdx create mode 100644 ja/development/comfy-router/models/quiver/arrow-2/code.mdx create mode 100644 ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx create mode 100644 ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx create mode 100644 ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx create mode 100644 ko/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx create mode 100644 ko/development/comfy-router/models/pixverse/v3-5/code.mdx create mode 100644 ko/development/comfy-router/models/pixverse/v6-max/code.mdx create mode 100644 ko/development/comfy-router/models/pixverse/v6/code.mdx create mode 100644 ko/development/comfy-router/models/quiver/arrow-2-telos/code.mdx create mode 100644 ko/development/comfy-router/models/quiver/arrow-2/code.mdx create mode 100644 zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx create mode 100644 zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx create mode 100644 zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx create mode 100644 zh/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx create mode 100644 zh/development/comfy-router/models/pixverse/v3-5/code.mdx create mode 100644 zh/development/comfy-router/models/pixverse/v6-max/code.mdx create mode 100644 zh/development/comfy-router/models/pixverse/v6/code.mdx create mode 100644 zh/development/comfy-router/models/quiver/arrow-2-telos/code.mdx create mode 100644 zh/development/comfy-router/models/quiver/arrow-2/code.mdx diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index 5adfa761a0..1ab95a4e35 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -2,20 +2,20 @@ title: "Comfy Router の機能と制限" sidebarTitle: "機能と制限" description: "Comfy Router とパートナープロキシのどちらを選ぶか、長時間実行される呼び出しへの備え、リカバリ・レート制限・アセット保存について説明します。" -translationSourceHash: a81b3bd9 +translationSourceHash: 04575573 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 "What Router supports": 2cc63403 - "Queued submission": d0798008 + "Queued submission": bcbb1f7c "Calls are cut off at a server deadline": c8724f59 "Recovery depends on the provider": da9d8904 "Request bodies are capped": 675b77c8 "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": e7d7524a - "Router does not cover every partner operation": 786c0fb2 + "Models without a pre-flight estimate": 789d46e5 + "Router does not cover every partner operation": 11621b39 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -31,6 +31,7 @@ translationBlockHashes: + Router はパートナーモデルを、1回の同期 HTTP 呼び出し、または送信して後で結果を取得するキュー中のリクエストを通じて実行します。アプリケーションが完了した結果を待つことができ、あるいは後で結果を取得でき、さらにモデル自身の入力フィールドと出力フィールドを処理できる場合に使用します。 ## Router がサポートするもの @@ -51,11 +52,13 @@ Router はパートナーモデルを、1回の同期 HTTP 呼び出し、また 同期ルートは、モデルの実行中も接続を開いたまま保持します。非同期プロバイダーの場合、Router はジョブを送信し、内部的にポーリングします。代替となるのはキューによる配信(送信し、`request_id` を取得し、ポーリングし、収集する)です。詳しくは[キュー配信](/ja/development/comfy-router/queue)を参照してください。これは認証情報の背後にあるワークスペースにスコープされるため、Comfy ワークスペースで作成したキーが必要です。ワークスペースを持たないレガシーキー、bring-your-own-key リクエスト、またはキューで実行できないモデルは、送信ルートで `not_enabled` とともに `403` を返します。どちらのモードもコールバックや Webhook は提供しません。 -リクエストを十分な時間開いたままにできない場合は、キューに投入してください。プロバイダー自身の送信とポーリングの制御が必要な場合は、[パートナープロキシ](#routerはすべてのパートナー操作をカバーしていない)を使用してください。 +リクエストを十分な時間開いたままにできない場合は、キューに投入してください。プロバイダー自身の送信とポーリングの制御が必要な場合は、[パートナープロキシ](#router-はすべてのパートナー操作をカバーするわけではない)を使用してください。 現在、4 つのモデルが同期専用であり、キューに送信すると `403` / `not_enabled` で拒否されます。`elevenlabs/eleven_sfx_v2`、`elevenlabs/eleven_v3`、`elevenlabs/eleven_v4`、`elevenlabs/eleven_v4_turbo` です。これらは JSON の結果ドキュメントではなく生のオーディオバイト列を返すため、キューによる配信にはそれを保存する場所がありません。同期ルートで実行してください。同期ルートはこれらのバイト列を通常どおり返します。 -LTX v1 のテキストから動画へ、および画像から動画への操作も同じ理由で生のビデオバイト列を返すため、キューによる配信ではそれらを保存できません。ただし、これらに到達できるのは `/proxy/ltx/v1/…` の[パートナープロキシ](#routerはすべてのパートナー操作をカバーしていない)経由のみであり、Router のモデル id からは到達できません。すべての `ltx/*` カタログモデルは、キューに投入可能な v2 の送信とポーリングの操作に解決されるためです。 +4 つのモデルはキュー専用であり、同期ルートでは `403` / `not_enabled` で拒否されます。`ltx/ltx-video-alpha-gen`、`ltx/ltx-video-to-video-hdr`、`ltx/ltx-video-to-video-reframe`、`ltx/ltx-video-upscale` です。これらのジョブは、同期呼び出しが保持される時間を超えて実行されることがあります。同じボディを `POST /v2/models/ltx/{model}/requests` に送信し、結果をキューから収集してください。 + +LTX v1 のテキストから動画へ、および画像から動画への操作も同じ理由で生のビデオバイト列を返すため、キューによる配信ではそれらを保存できません。ただし、これらに到達できるのは `/proxy/ltx/v1/…` の[パートナープロキシ](#router-はすべてのパートナー操作をカバーするわけではない)経由のみであり、Router のモデル id からは到達できません。すべての `ltx/*` カタログモデルは、キューに投入可能な v2 の送信とポーリングの操作に解決されるためです。 ## サーバーのデッドラインで呼び出しが打ち切られます @@ -123,34 +126,41 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kelly**: `kelly/kelly-seedance-2.0`, `kelly/kelly-seedance-2.0-fast`, `kelly/kelly-seedance-2.5` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` +- **ltx**: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe`, `ltx/ltx-video-upscale` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` +- **pixverse**: `pixverse/v3.5`, `pixverse/v6`, `pixverse/v6-max` +- **quiver**: `quiver/arrow-2`, `quiver/arrow-2-telos` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` - **synclabs**: `synclabs/sync-3` +- **veed**: `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` - **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} `openai/gpt-image-2`、`openai/gpt-image-2.5-flare`、`openai/gpt-image-2.5-sunburst`、`openai/gpt-image-2.6-flare`、`openai/gpt-image-2.6-sunburst` での編集にも事前見積もりはありません。これらのモデルへの編集呼び出し、または入力画像を伴う生成呼び出しは `source: unknown` を返します。これらのモデルへのテキストのみの生成呼び出しは見積もりされるため、上記のリストには含まれていません。 -## Routerはすべてのパートナー操作をカバーしていない +## Router はすべてのパートナー操作をカバーするわけではない -Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があります。これらはRouterの外部にあり、そのコントラクトには記述されていません。Router自体のサーフェスは [Comfy Router specification](/router-openapi.yaml) です。サポートはプロバイダーによって異なります。 +Router はモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があり、これらは Router の外側にあり、そのコントラクトでは説明されていません。Router 自身のサーフェスは [Comfy Router 仕様](/ja/router-openapi.yaml)です。サポートはプロバイダーによって異なります。 -### Krea 3の参照画像:先にアップロードするか、公開https URLを使用する +### Krea 3 の参照画像: 先にアップロードするか、公開 https URL を使用する -`krea/krea-3` の `image_urls` では、`POST /proxy/krea/assets` が返す `image_url`(`https://app-uploads.krea.ai/...` 形式のURL)は常に受け付けられます。他のリンクが受け付けられるかどうかは環境によって異なります。api.comfy.org では現在受け付けられています。 +`krea/krea-3` の `image_urls` では、`POST /proxy/krea/assets` が返す `image_url`(`https://app-uploads.krea.ai/...` の URL)は常に受け付けられます。他のリンクが受け付けられるかどうかは環境によって異なります。api.comfy.org では現在受け付けられます。8 件を超えるエントリは、リクエストのスキーマチェックにより、フェッチが行われる前に `422` で拒否されます。 -- **他のリンクが受け付けられる場合**、公開された `https` の画像URLであればどれでも機能します。Routerはモデルの実行前に各画像のサイズを読み取ります。ホストが公開されて到達できない、または存在しないリンク、`408` と `429` 以外の `4xx` を返すリンク、画像でないリンクは、そのホスト名を示して `400` `invalid_input` で拒否されます。一時的なDNS、TLS、接続の失敗、タイムアウト、またはオリジンからの `408` や `429` は `502` エラーになります。実際のアップロードではない `app-uploads.krea.ai` のリンクは、他の到達できない参照と同様に `400` で拒否されます。サーバーの起動直後、どのルールが適用されるかをまだ学習していない段階では、`app-uploads.krea.ai` のリンクではない公開 `https` URLが、再試行しても安全な `503` で失敗する可能性があります。 -- **他のリンクが受け付けられない場合**、すべてのエントリはアップロードの `image_url` である必要があります。Routerがチェックするのは、リンクが `https` URLとしてパースでき、ホストが厳密に `app-uploads.krea.ai` であること(他のホストや明示的なポートは不可)だけです。それ以外のリンクは、自分でホストしている公開 `https` URLであっても、モデルの実行前に `400` `invalid_input` で拒否されます。このチェックを通過しても実際のアップロードではないリンク(期限切れ、削除済み、入力ミス)はそのまま通ってしまい、Routerは画像のサイズを読み取れずに `400` ではなく `5xx` エラーを返します。 +- **他のリンクが受け付けられる場合**、公開された任意の `https` 画像 URL が使用できます。Router はモデルを実行する前に、各参照を自身でフェッチしてサイズを読み取ります。修正が必要な参照は、そのホスト名を示す `400` `invalid_input` で拒否されます。対象は、存在しないホストまたは公開到達できないホスト、`408` または `429` 以外の `4xx` を返すオリジン、リダイレクトが多すぎる場合、`https` でないリンクまたは公開到達できないホストへのリダイレクト、サポートされていない画像であるコンテンツ、画像のサイズヘッダーの前に終了してしまう長さのないレスポンス、サイズヘッダーが最初の 2 MiB 以内にない画像(下記参照)です。それ以外のフェッチ失敗は代わりに `5xx` エラーになります(Router では `500` `internal_error`)。これらの一部は自然に解消されます(DNS リゾルバーのエラー、タイムアウト、切断された接続、`5xx`、`408`、`429` を返すオリジン、または Router のホストチェックと接続の間に DNS 応答が非公開アドレスに切り替わるホストで、再試行時には成功するか非公開ホストに対する `400` で拒否される場合があります)。そのため、後で再試行してください。その他のものは毎回同じように失敗します。たとえば、フェッチが信頼しない TLS 証明書(自己署名、期限切れ、または誤ったホスト名に対するもの)、または `200` 以外の `2xx` やフェッチがフォローしない `3xx`(`204`、`206`、`300`、`304`、`305`、または `Location` のない `301`、`302`、`303`、`307`、`308` など)を返すオリジンです。再試行が同じように失敗する場合は、まず画像をアップロードしてください。`POST /v2/models/krea/krea-3/requests` でキューに入れられたリクエストは、そのリンクのいずれかが `app-uploads.krea.ai` のリンクでない場合、そのような `5xx` では再試行されないため、原因が解消し得るならご自身で再送信してください。実際のアップロードではない `app-uploads.krea.ai` のリンクは、他の到達不能な参照と同様に `400` で拒否されます。キューに入れられたリクエストの `400` は汎用的な `invalid_input` の詳細のみを含むため、ホスト名を示しません。また、キューはそれを再試行しません。キューに入れられた `400` は `image_urls` だけでなく任意のフィールド(たとえばサポートされていない `resolution` や `thinking_mode`)に起因する可能性があるため、まず他のフィールドを確認してください。それらが有効であれば、各画像を `POST /proxy/krea/assets` でアップロードし、それらの `image_url` 値と新しい `Idempotency-Key`(またはなし)で再送信してください。変更されたボディでキーを再利用すると `409` `invalid_input` で拒否されますが、これは画像について何も示しません。同じボディで再利用すると、元の `request_id` と `Idempotent-Replayed: true` を伴う `201` で応答されるため、新しい実行は開始されず、その結果 URL(`GET /v2/models/krea/krea-3/requests/{request_id}`)は同じ `400` を返します(そのステータス URL は `error_type` `invalid_input` を伴う `200` で応答します)。その再送信も `400` で失敗する場合、問題は画像自体にあります(たとえば、サポートされていない画像である、またはそのサイズヘッダーが最初の 2 MiB 以内にない)。 +- **他のリンクが受け付けられない場合**、すべてのエントリはアップロードが返した `image_url` でなければなりません。Router は、そのリンクがホストが正確に `app-uploads.krea.ai` である `https` URL としてパースできることのみをチェックします(他のホストや明示的なポートは不可)。他のリンク、たとえばご自身でホストする公開 `https` URL は、モデルを実行する前に「image_urls must be image_url values returned by POST /proxy/krea/assets」と述べる `400` `invalid_input` で拒否されるため、代わりに画像をアップロードしてください。そのチェックを通過しても実際のアップロードではないリンク(期限切れ、削除済み、または誤記)は依然として通過し、Router は画像のサイズを読み取れずに `5xx` エラーで応答します(`400` ではありません)。Router が読み取れないアップロード済みの画像(たとえば、サポートされていない画像である、またはそのサイズヘッダーが最初の 2 MiB 以内にない)も、ここでは `400` ではなく `5xx`(Router では `500` `internal_error`)で失敗し、問題は依然として画像にあるため、再度アップロードしても役に立ちません。 +- **サーバーの起動直後**、どのルールが適用されるかを学習する前は、`app-uploads.krea.ai` のリンクでない任意の `https` URL が `503`(Router では `service_unavailable`)で失敗する可能性があり、これは再試行しても安全です(キューに入れられたリクエストは自動的に再試行されます)。 -アップロードはどの環境でも機能するため、移植性の高い選択肢です。`image_url` は必ずアップロードが返したとおりに渡してください。 +Router は各参照のサイズを見つけるために最初の 2 MiB のみを読み取るため、そのウィンドウ内でサイズ情報を読み取り完了できない画像(たとえば、2 MiB を超える埋め込みメタデータを含む JPEG、または透過データ、それがなければ最初の画像データチャンクの先頭が 2 MiB を超えた位置にあるパレット PNG。たとえば 2 MiB を超えるテキストやカラープロファイルチャンクの後など)は、サイズヘッダーが最初の 2 MiB 以内にないと述べる `400` で拒否され、アップロードしても役に立ちません。まず大きなメタデータを含めずに再保存するか、パレット PNG を非パレット(トゥルーカラー)PNG として保存してください。国際化されたホスト名は ASCII(punycode)形式で送信してください。たとえば `bücher.de` ではなく `xn--bcher-kva.de` です。Router は記述されたとおりにホストを検索し、非 ASCII の名前は存在しないホストとして拒否されます。 -1. 各参照画像を `multipart/form-data` としてアップロードし、画像はフォームフィールド `file` に入れます(JPEG、PNG、WebP、最大75 MB)。認証はRouterの場合と同じく、`X-API-Key` または `Authorization: Bearer` を使用します。 +アップロードはすべての環境で機能するため、移植性のある選択肢です。常にアップロードが返したとおりに `image_url` を渡してください。画像がまだ公開 `https` URL にない場合は、まずアップロードしてください:1. 各参照画像を `multipart/form-data` としてアップロードします。画像はフォームフィールド `file` に含めます(JPEG、PNG、または WebP、最大 75 MB)。Router と同じ方法で、`X-API-Key` または `Authorization: Bearer` を使用して認証します。 ```bash curl -X POST https://api.comfy.org/proxy/krea/assets \ @@ -158,7 +168,7 @@ Routerはモデルを実行します。ファイルのアップロード、ア -F "file=@reference.png" ``` -2. JSONレスポンスから `image_url` を読み取り、`image_urls` で渡します。 +2. JSON レスポンスから `image_url` を読み取り、`image_urls` に渡します: ```json { @@ -168,7 +178,7 @@ Routerはモデルを実行します。ファイルのアップロード、ア } ``` -テキストから画像への呼び出しでは `image_urls` を省略するため、アップロードは不要です。 +テキストから画像への呼び出しでは `image_urls` を省略し、アップロードは不要です。 ## モデルの出力と保存されたアセット diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index 152c86c775..99253ba0fd 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -2,27 +2,27 @@ title: "Comfy Router モデル" sidebarTitle: "すべてのモデル" description: "Comfy Router で利用できるすべてのモデルを、各モデルの入力と出力のモダリティとあわせて、プロバイダー別にまとめています。" -translationSourceHash: df7e65a1 +translationSourceHash: 4bd95744 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 4d100975 + "Find by output": 23c1048d "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 - "BytePlus": 0767a672 + "BytePlus": 97340104 "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 "Gemini Interactions": 38163caf - "Google": 4932820b + "Google": 77d668ec "HeyGen": 76fe1a0d "Higgsfield": 0ce2b918 "Ideogram": c22a0e5e "Kling": aec38bcd "Krea": 16b83e5e - "LTX": 32595bf9 + "LTX": 413dd527 "Luma": 8cd2a7ce "Luma 2": 585eb637 "Meshy": 67e26a17 @@ -31,7 +31,9 @@ translationBlockHashes: "OpenAI": 8652024f "Openrouter": a4f6806b "Pika": 0cc24098 + "Pixverse": 195092d8 "Pruna": 903d76ee + "Quiver": 34eaad49 "Qwen": b3ef78a1 "Recraft": 02b7d9cd "Runway": be098f8c @@ -50,6 +52,7 @@ translationBlockHashes: + {/* 生成済みファイル。Router カタログから `pnpm code-pages:gen` によって生成されます。 */} 以下に挙げるすべてのモデルは、同じルート `POST /v2/models/{provider}/{model}` で提供され、それぞれのモデル固有の JSON ボディを使用します。各ページには、Python、TypeScript、cURL で動作するリクエスト例を掲載しています。ディスカバリー、スキーマ、エラー、リトライ、課金については、[Comfy Router API の使用](/ja/development/comfy-router/api) を参照してください。 @@ -59,7 +62,7 @@ translationBlockHashes: ## 出力から探す - + - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [FLUX 3 ビデオ](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` @@ -75,7 +78,6 @@ translationBlockHashes: - [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seedance 1.0 Pro 250528](/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code): `byteplus/seedance-1-0-pro-250528` - [Seedance 1.0 Pro Fast 251015](/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code): `byteplus/seedance-1-0-pro-fast-251015` -- [Seedance 1.5 Pro 251215](/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` - [Crystal ビデオアップスケーラー](/ja/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` - [FLUX 3 Max](/ja/development/comfy-router/models/fal/flux-3-max/code): `fal/flux-3-max` - [H3 Max Turbo](/ja/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo` @@ -95,6 +97,10 @@ translationBlockHashes: - [ビデオ リップシンク](/ja/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` - [LTX 2.5 Fast](/ja/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ja/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` +- [LTX ビデオ アルファ生成](/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code): `ltx/ltx-video-alpha-gen` +- [LTX ビデオからビデオへ HDR](/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code): `ltx/ltx-video-to-video-hdr` +- [LTX ビデオからビデオへ リフレーム](/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code): `ltx/ltx-video-to-video-reframe` +- [LTX ビデオアップスケール](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code): `ltx/ltx-video-upscale` - [Ray 3.2](/ja/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` - [MiniMax H3](/ja/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [画像から動画へ](/ja/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` @@ -106,11 +112,13 @@ translationBlockHashes: - [Pika H3 Flex 参照から動画](/ja/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` - [Pika H3 Flex テキストから動画へ](/ja/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika サウンドトラック](/ja/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` +- [V3.5](/ja/development/comfy-router/models/pixverse/v3-5/code): `pixverse/v3.5` +- [V6 Max](/ja/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max`- [V6](/ja/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` - [P Video 2](/ja/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/ja/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/ja/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ja/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` -- [オーディオとビデオをクリーン化](/ja/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` +- [Clean Audio Video](/ja/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` - [Fabric 1.0](/ja/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` - [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ja/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` @@ -144,7 +152,7 @@ translationBlockHashes: - [Grok Imagine Video](/ja/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/ja/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -162,8 +170,7 @@ translationBlockHashes: - [Image Edit Erase Foreground](/ja/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` - [Image Edit Erase](/ja/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` - [Image Edit Expand](/ja/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` -- [Image Edit Gen Fill](/ja/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` -- [Image Edit Increase Resolution](/ja/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` +- [Image Edit Gen Fill](/ja/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill`- [Image Edit Increase Resolution](/ja/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/ja/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/ja/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` - [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` @@ -212,9 +219,10 @@ translationBlockHashes: - [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` -- [GPT Image 2.6 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare` -- [GPT Image 2.6 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` +- [GPT Image 2.6 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare`- [GPT Image 2.6 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` - [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` +- [Arrow 2 Telos](/ja/development/comfy-router/models/quiver/arrow-2-telos/code): `quiver/arrow-2-telos` +- [Arrow 2](/ja/development/comfy-router/models/quiver/arrow-2/code): `quiver/arrow-2` - [Qwen Image 3.0 Pro](/ja/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/ja/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/ja/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` @@ -261,8 +269,7 @@ translationBlockHashes: - [Wan 2.5 T2I Preview](/ja/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` - [Seedvr 2](/ja/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` - [Ultimate Image Upscaler](/ja/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` -- [Grok Imagine Image 2.0](/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0` -- [Grok Imagine Image Pro](/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` +- [Grok Imagine Image 2.0](/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0`- [Grok Imagine Image Pro](/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` - [Grok Imagine Image Quality](/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code): `xai/grok-imagine-image-quality` - [Grok Imagine Image](/ja/development/comfy-router/models/xai/grok-imagine-image/code): `xai/grok-imagine-image` @@ -276,7 +283,6 @@ translationBlockHashes: - [Dreamina Seedance 2.5 260628](/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/ja/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/ja/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` -- [Seedance 1.5 Pro 251215](/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` - [Eleven Multilingual V2](/ja/development/comfy-router/models/elevenlabs/eleven-multilingual-v2/code): `elevenlabs/eleven_multilingual_v2` - [Eleven Sfx V2](/ja/development/comfy-router/models/elevenlabs/eleven-sfx-v2/code): `elevenlabs/eleven_sfx_v2` - [Eleven V3](/ja/development/comfy-router/models/elevenlabs/eleven-v3/code): `elevenlabs/eleven_v3` @@ -292,6 +298,7 @@ translationBlockHashes: - [Higgsfield Kling 3 Pro](/ja/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` - [LTX 2.5 Fast](/ja/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ja/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` +- [LTX Video Upscale](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code): `ltx/ltx-video-upscale` - [MiniMax H3](/ja/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [Pika H3 Flex Image To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` - [Pika H3 Flex Reference To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` @@ -322,8 +329,7 @@ translationBlockHashes: - [Animations](/ja/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/ja/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` -- [Meshy 7.1](/ja/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` -- [Meshy 7](/ja/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` +- [Meshy 7.1](/ja/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1`- [Meshy 7](/ja/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` - [Remesh](/ja/development/comfy-router/models/meshy/remesh/code): `meshy/remesh` - [Rigging](/ja/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/ja/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` @@ -334,7 +340,7 @@ translationBlockHashes: - [Hunyuan 3D Uv](/ja/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/ja/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/ja/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -358,6 +364,9 @@ translationBlockHashes: - [Gemini 3.1 Flash Lite](/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code): `vertexai/gemini-3.1-flash-lite` - [Gemini 3.7 Flash](/ja/development/comfy-router/models/google/gemini-3-7-flash/code): `vertexai/gemini-3.7-flash` - [Gemini 3.8 Flash](/ja/development/comfy-router/models/google/gemini-3-8-flash/code): `vertexai/gemini-3.8-flash` +- [Gemini 4 Argon](/ja/development/comfy-router/models/google/gemini-4-argon/code): `vertexai/gemini-4-argon` +- [Gemini 4 Carbon](/ja/development/comfy-router/models/google/gemini-4-carbon/code): `vertexai/gemini-4-carbon` +- [Gemini 4 Hydrogen](/ja/development/comfy-router/models/google/gemini-4-hydrogen/code): `vertexai/gemini-4-hydrogen` - [Gemini Nano Banana 2.1](/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code): `vertexai/gemini-nano-banana-2.1` - [Google Gemini](/ja/development/comfy-router/models/google/gemini/code): `vertexai/gemini-3.1-pro-preview` - [Nano Banana 2 Lite](/ja/development/comfy-router/models/google/nano-banana-2-lite/code): `vertexai/gemini-3.1-flash-lite-image` @@ -375,8 +384,7 @@ translationBlockHashes: - [GPT 5 Nano](/ja/development/comfy-router/models/openai/gpt-5-nano/code): `openai/gpt-5-nano` - [GPT 5](/ja/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6.1 Sol](/ja/development/comfy-router/models/openai/gpt-6-1-sol/code): `openai/gpt-6.1-sol` -- [GPT 6.1 Terra](/ja/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra` -- [GPT 6 Astra](/ja/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` +- [GPT 6.1 Terra](/ja/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra`- [GPT 6 Astra](/ja/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ja/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` - [o3](/ja/development/comfy-router/models/openai/o3/code): `openai/o3` @@ -467,7 +475,6 @@ translationBlockHashes: | [Seed Audio 1.0](/ja/development/comfy-router/models/byteplus/seed-audio-1-0/code) | `byteplus/seed-audio-1.0` | テキスト | オーディオ | | [Seedance 1.0 Pro 250528](/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code) | `byteplus/seedance-1-0-pro-250528` | テキスト, 画像 | ビデオ | | [Seedance 1.0 Pro Fast 251015](/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code) | `byteplus/seedance-1-0-pro-fast-251015` | テキスト, 画像 | ビデオ | -| [Seedance 1.5 Pro 251215](/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code) | `byteplus/seedance-1-5-pro-251215` | テキスト, 画像 | ビデオ + オーディオ | | [Seedream 4.0 250828](/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code) | `byteplus/seedream-4-0-250828` | テキスト, 画像 | 画像 | | [Seedream 4.5 251128](/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code) | `byteplus/seedream-4-5-251128` | テキスト, 画像 | 画像 | | [Seedream 5.0 260128](/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | テキスト, 画像 | 画像 | @@ -521,6 +528,9 @@ translationBlockHashes: | [Gemini 3.1 Flash Lite](/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | テキスト, 画像, オーディオ, ビデオ | テキスト | | [Gemini 3.7 Flash](/ja/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | テキスト, 画像, オーディオ, ビデオ | テキスト | | [Gemini 3.8 Flash](/ja/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | テキスト, 画像, オーディオ, ビデオ | テキスト | +| [Gemini 4 Argon](/ja/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | テキスト, 画像, オーディオ, ビデオ | テキスト | +| [Gemini 4 Carbon](/ja/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | テキスト, 画像, オーディオ, ビデオ | テキスト | +| [Gemini 4 Hydrogen](/ja/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | テキスト, 画像, オーディオ, ビデオ | テキスト | | [Gemini Nano Banana 2.1](/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | `vertexai/gemini-nano-banana-2.1` | テキスト, 画像, ビデオ | 画像 + テキスト | | [Google Gemini](/ja/development/comfy-router/models/google/gemini/code) | `vertexai/gemini-3.1-pro-preview` | テキスト, 画像, オーディオ, ビデオ | テキスト | | [Nano Banana 2 Lite](/ja/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | テキスト, 画像, ビデオ | 画像 + テキスト | @@ -581,6 +591,10 @@ translationBlockHashes: | --- | --- | --- | --- | | [LTX 2.5 Fast](/ja/development/comfy-router/models/ltx/ltx-2-5-fast/code) | `ltx/ltx-2-5-fast` | テキスト | ビデオ + オーディオ | | [LTX 2.5 Pro](/ja/development/comfy-router/models/ltx/ltx-2-5-pro/code) | `ltx/ltx-2-5-pro` | テキスト | ビデオ + オーディオ | +| [LTX Video Alpha Gen](/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | ビデオ | ビデオ | +| [LTX Video To Video Hdr](/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | ビデオ | ビデオ | +| [LTX Video To Video Reframe](/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | ビデオ | ビデオ | +| [LTX Video Upscale](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | ビデオ | ビデオ + オーディオ | ## Luma @@ -671,12 +685,27 @@ translationBlockHashes: | [Pika Sfx](/ja/development/comfy-router/models/pika/pika-sfx/code) | `pika/pika-sfx` | テキスト | オーディオ | | [Pika Soundtrack](/ja/development/comfy-router/models/pika/pika-soundtrack/code) | `pika/pika-soundtrack` | ビデオ、テキスト | ビデオ + オーディオ | +## Pixverse + +| モデル | ID | 入力 | 出力 | +| --- | --- | --- | --- | +| [V3.5](/ja/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | テキスト | ビデオ | +| [V6 Max](/ja/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | テキスト | ビデオ | +| [V6](/ja/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | テキスト | ビデオ | + ## Pruna | モデル | ID | 入力 | 出力 | | --- | --- | --- | --- | | [P Video 2](/ja/development/comfy-router/models/pruna/p-video-2/code) | `pruna/p-video-2` | テキスト, 画像, オーディオ | ビデオ + オーディオ | +## Quiver + +| モデル | ID | 入力 | 出力 | +| --- | --- | --- | --- | +| [Arrow 2 Telos](/ja/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | テキスト、画像 | 画像 | +| [Arrow 2](/ja/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | テキスト、画像 | 画像 | + ## Qwen | モデル | ID | 入力 | 出力 | diff --git a/ja/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx b/ja/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx index a8a91e1cae..1f0f78aa48 100644 --- a/ja/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router で Claude Sonnet 5.5 を使う" description: "Comfy Router 経由で anthropic/claude-sonnet-5-5 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Claude Sonnet 5.5" -translationSourceHash: 021cc189 +translationSourceHash: f0a03fa9 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx translationBlockHashes: "_intro": f09ded46 "Quick start": b8433ece - "Schema": 3a226e7f + "Schema": e5d10df7 "Examples": f08878ed --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-5-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -191,7 +192,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-5-5/requests/$REQUE - true の場合、レスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。 + Comfy Router のルート `POST /v2/models/anthropic/{model}` では、`stream` は無効(INERT)です。Router はディスパッチ前にこれを `false` に確定させ、完了したメッセージを常に 1 つの JSON ドキュメントとして返します。v1 の `POST /proxy/anthropic/v1/messages` ルートでは、`true` を指定するとレスポンスは単一の JSON ボディではなく、Anthropic のメッセージイベントの `text/event-stream` になります。Router では `stream` に false を指定するか省略してください。`/proxy/` オペレーションの 200 が持つ `text/event-stream` の部分には、Router 側に対応するものがありません。 diff --git a/ja/development/comfy-router/models/google/gemini/code.mdx b/ja/development/comfy-router/models/google/gemini/code.mdx index 24e0f24922..93faff7d05 100644 --- a/ja/development/comfy-router/models/google/gemini/code.mdx +++ b/ja/development/comfy-router/models/google/gemini/code.mdx @@ -2,7 +2,7 @@ title: "Comfy Router で Google Gemini を使用する" description: "Comfy Router 経由で HTTP を使って Google Gemini のテキストモデルを呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Google Gemini" -translationSourceHash: ccf669d3 +translationSourceHash: 0958828b translationFrom: development/comfy-router/models/google/gemini/code.mdx --- @@ -326,7 +326,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests/$R オプション。モデルの thinking レベルです。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -1017,7 +1017,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST オプション。モデルの thinking レベルです。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` diff --git a/ja/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/ja/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index 076395c09b..4c9ff0d7ab 100644 --- a/ja/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/ja/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Nano Banana 2 Lite を使用する" description: "Comfy Router を通じて HTTP で Nano Banana 2 Lite (Gemini 3.1 Flash-Lite Image) による画像を生成するための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Nano Banana 2 Lite" -translationSourceHash: 6381740d +translationSourceHash: 75deda90 translationFrom: development/comfy-router/models/google/nano-banana-2-lite/code.mdx translationBlockHashes: "_intro": 9a5badea "Quick start": 0622ad83 - "Schema": ededaa40 + "Schema": 3b274fc9 "Examples": d294783d --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -217,7 +218,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques ### 入力 - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは 1 つのインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -233,29 +234,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。使用できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度には制限がありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル (音声なし) の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 生のバイト形式のインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト形式のインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、データのメディアタイプ (mimeType) も指定する必要があります。サイズ制限: 20MB - Format: `byte` + 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。使用できる値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度には制限がありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル (音声なし) の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - モデルがこのパートのビデオをどのように読み取るか。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断できるようになります。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るか。固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -267,11 +268,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - Possible values: `user`, `model` + 指定可能な値: `user`、`model` - 生成のためのサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にそれが適用され、それ以外はモデル自身の動作にフォールバックします。 + 生成のためのサンプリング、長さ、出力の設定です。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外のフィールドはモデル自体の動作に従います。 @@ -283,7 +284,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 任意。生成される画像の画像出力フォーマット。 + 任意。生成される画像の出力形式。 @@ -291,7 +292,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 任意。出力を保存する画像形式。Vertex AI の経路(Comfy 自身の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエスト)で使用されます。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。その上流にはそのようなプロパティが存在せず、含まれていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を前提とせず、返されたレスポンスパート(`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み取ってください。 + 任意。出力を保存する画像形式です。対象は Vertex AI の経路、つまり Comfy 自身の認証情報で処理されるリクエストと、GCP サービスアカウントで認証される BYOK リクエストです。これらの経路で受け付けられる値は `image/png` と `image/jpeg` で、大文字と小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールド名を示す 400 エラーで拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証される BYOK リクエストは例外です。この上流にはそのようなプロパティが存在せず、指定されていると呼び出し全体が拒否されるため、このフィールドは反映も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どの経路でも、送信した値を前提とせず、返されたレスポンスのパート (`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`) からメディアタイプを読み取ってください。 @@ -299,9 +300,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおよそ 60~80 語に相当します。 + レスポンスで生成できるトークンの最大数です。1 トークンは約 4 文字です。100 トークンはおよそ 60〜80 語に相当します。 - Range: `16` to `65536` + 範囲: `16` から `65536` @@ -309,7 +310,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - seed を特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じ seed 値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムな seed 値が使用されます。次のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Available for the following models:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -317,7 +318,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - temperature は、topP と topK が適用されるときに発生する、応答生成中のサンプリングに使用されます。temperature はトークン選択のランダム性の度合いを制御します。低い temperature は、あまり自由すぎない、あるいは創造的でない応答が求められるプロンプトに適しており、高い temperature はより多様で創造的な結果につながる可能性があります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、わずかなばらつきが生じる可能性は依然としてあります。モデルが返す応答が一般的すぎる、短すぎる、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください + temperature は、topP と topK が適用される応答生成時のサンプリングに使用されます。temperature はトークン選択のランダム性の度合いを制御します。低い temperature は、自由度の低い応答や創造性を必要としないプロンプトに適しており、高い temperature はより多様な、または創造的な結果につながります。temperature が 0 の場合、常に確率が最も高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定的になりますが、わずかなばらつきが生じる可能性はあります。モデルが返す応答が一般的すぎる、短すぎる、またはフォールバック応答を返す場合は、temperature を上げてみてください 範囲: `0` ~ `2` @@ -325,33 +326,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。 + 省略可能。思考機能の設定。思考とは、モデルが複雑なタスクをより小さなステップに分解し、より高品質な応答を生成するプロセスです。 - オプション。true の場合、モデルはその思考内容を応答に含めます。 + 省略可能。true の場合、モデルは応答に自身の思考を含めます。 - オプション。モデルの thinking プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + 省略可能。モデルの思考プロセスに割り当てるトークン予算。モデルはこの予算内に収まるよう最善を尽くします。 - オプション。モデルの thinking レベルです。 + 省略可能。モデルの思考レベル。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K は、モデルが出力するトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率の高いものになります。top-K が 3 の場合、temperature を使用して、最も確率の高い 3 つのトークンの中から次のトークンが選択されます。 + Top-K は、モデルが出力用のトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンはモデルの語彙全体の中で最も確率が高いものです。Top-K が 3 の場合、次に選択されるトークンは、temperature を用いて確率が上位 3 のトークンの中から選択されます。 範囲: `1` ~ `…` 指定した場合、nucleus サンプリングが使用されます。 -Top-P は、モデルが出力するトークンを選択する方法を変更します。トークンは、確率の合計が top-P 値に等しくなるまで、最も確率の高いもの (top-K を参照) から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P 値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 -ランダム性の少ない応答には低い値を、よりランダムな応答には高い値を指定します。 +Top-P は、モデルが出力用のトークンを選択する方法を変更します。トークンは、確率の合計が top-P の値に等しくなるまで、最も確率が高いもの(top-K を参照)から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を用いて A または B を次のトークンとして選択し、C は候補から除外されます。 +ランダム性の低い応答を得たい場合は低い値、ランダム性の高い応答を得たい場合は高い値を指定してください。 範囲: `0` ~ `1` @@ -359,37 +360,37 @@ Top-P は、モデルが出力するトークンを選択する方法を変更 - 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に対して適用されます。 + 安全でないコンテンツをブロックするためのリクエストごとの設定。GenerateContentResponse.candidates に適用されます。 - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - 指定可能な値: `OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` - モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン制限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各部分のコンテンツは別々の段落にしてください。 + モデルをより良いパフォーマンスへと導くための指示。たとえば「できるだけ簡潔に答えてください」「応答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part の content は別々の段落にしてください。 - 1 つのメッセージを構成する順序付けられた parts のリストです。parts ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数など入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + 1 つのメッセージを構成する順序付けられた part のリスト。part ごとに異なる IANA MIME タイプを使用できます。トークンの最大数や画像の枚数など入力の上限については、Google のモデルページにあるモデルの仕様を参照してください。 - テキストプロンプトまたはコードスニペットです。 + テキストプロンプトまたはコードスニペット。 - メッセージを作成するエンティティの identity です。次の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空のままにするか、未設定にできます。 + メッセージを作成するエンティティの識別情報。以下の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空のままにするか未設定にできます。 - 指定可能な値: `user`、`model` + 指定可能な値: `user`, `model` - システムがモデルの知識や範囲の外にあるアクションまたはアクション群を実行するために、外部システムと連携できるようにするコードです。Function calling を参照してください。 + システムがモデルの知識や适用范围外で 1 つまたは複数のアクションを実行するために、外部システムとやり取りできるようにするコード。関数呼び出しを参照してください。 @@ -409,46 +410,46 @@ Top-P は、モデルが出力するトークンを選択する方法を変更 - true の場合、生成された画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL の有効期限は 24 時間です。 + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に期限切れになります。 - ビデオ入力の場合、Duration 形式で表したビデオの開始オフセットと終了オフセット。たとえば、1:00 から始まる 10 秒のクリップを指定するには、`"startOffset": \{ "seconds": 60 }` と `"endOffset": \{ "seconds": 70 }` を設定します。このメタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 + ビデオ入力の場合、Duration 形式でのビデオの開始と終了のオフセット。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 - ビデオタイムライン上の位置に対する Duration オフセットを表します。 + ビデオタイムライン上の位置に対する再生時間オフセットを表します。 - ナノ秒精度で表した符号付きの秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。 + ナノ秒精度での秒の小数部分(符号付き)。小数部を含むネガティブな秒値でも、nanos 値は非ネガティブでなければなりません。 範囲: `0` から `999999999` - 期間の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 範囲: `-315576000000` から `315576000000` - ビデオタイムライン上の位置に対する Duration オフセットを表します。 + ビデオタイムライン上の位置に対する再生時間オフセットを表します。 - ナノ秒精度で表した符号付きの秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。 + ナノ秒精度での秒の小数部分(符号付き)。小数部を含むネガティブな秒値でも、nanos 値は非ネガティブでなければなりません。 範囲: `0` から `999999999` - 期間の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 範囲: `-315576000000` から `315576000000` -Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。 +Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 @@ -493,7 +494,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになり、マルチターンのクエリでは会話履歴と最新のリクエストを含む繰り返しフィールドになります。 + モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。 @@ -509,13 +510,13 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は以下のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生のバイト形式のインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生バイトのインラインデータです。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 @@ -525,13 +526,13 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は以下のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオを読み取る方法です。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、検査するセグメントをモデルが判断します。省略すると、デフォルトの固定レートサンプリングが使用されます。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオを読み取る方法です。固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -539,7 +540,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - このパートがモデルによる思考/推論ステップであることを示します。 + このパートがモデルによる思考/推論のステップであることを示します。 @@ -559,7 +560,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - コンテンツが指定された安全カテゴリに違反する確率です + コンテンツが指定された安全性カテゴリに違反する確率 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -593,9 +594,9 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - コンテンツが指定された安全性カテゴリに違反する確率 + コンテンツが指定された安全カテゴリに違反する確率 - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -607,11 +608,11 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - 出力専用。入力内のキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 + 出力のみ。入力のキャッシュ部分(キャッシュされたコンテンツ)に含まれるトークン数。 - レスポンス内のトークン数。 + レスポンスに含まれるトークン数。 @@ -621,7 +622,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -629,7 +630,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの総サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 + リクエストに含まれるトークン数。cachedContent が設定されている場合でも、これは実効的なプロンプトサイズの合計であり、キャッシュされたコンテンツ内のトークン数も含みます。 @@ -639,7 +640,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -647,7 +648,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - 思考出力に含まれるトークン数。 + 思考(thoughts)の出力に含まれるトークン数。 @@ -661,7 +662,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -669,11 +670,11 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - トークンの総数(プロンプト + 候補)。 + トークンの合計数(プロンプト + 候補)。 - リクエストに使用されたトラフィックタイプ(例: PROVISIONED_THROUGHPUT)。 + リクエストに使用されたトラフィックの種類(例: PROVISIONED_THROUGHPUT)。 ## 例 diff --git a/ja/development/comfy-router/models/google/nano-banana-2/code.mdx b/ja/development/comfy-router/models/google/nano-banana-2/code.mdx index e72424dcf6..793a0a6c08 100644 --- a/ja/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/ja/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で Nano Banana 2 を使う" description: "Comfy Router 経由で HTTP を使って Nano Banana 2 (Gemini 3.1 Flash Image) で画像を生成するための Python、TypeScript、cURL スニペット、およびリクエストのフィールドと結果の形状" sidebarTitle: "Nano Banana 2" -translationSourceHash: f8c4ed89 +translationSourceHash: 8183f2d5 translationFrom: development/comfy-router/models/google/nano-banana-2/code.mdx translationBlockHashes: "_intro": e6f85ac2 "Quick start": 7fb17070 "Serving providers": a9deb946 - "Schema": 63c93920 + "Schema": a266962e "Examples": d294783d --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 生成されたファイルです。このディレクトリの code.yaml を編集し、`pnpm code-pages:gen` を実行してください。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -233,7 +234,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R ### 入力 - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは、これは単一のインスタンスです。マルチターンのクエリでは、これは会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 @@ -249,29 +250,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。使用可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - 可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 使用可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生のバイト列によるインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、そのデータのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB - Format: `byte` + 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。使用可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - 可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 使用可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオをどのように読み取るか。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオを読み取る方法。"AGENTIC" を設定すると、固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを決定できます。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -279,15 +280,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - このパートがモデルによる思考/推論のステップであることを示します。 + このパートがモデルからの思考/推論ステップであることを示します。 - 可能な値: `user`, `model` + 使用可能な値: `user`, `model` - 生成のためのサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。 + 生成のサンプリング、長さ、出力の設定。すべてのフィールドはオプションです。以下で `default` を宣言しているフィールドは省略時にそれを適用し、残りはモデル自身の動作にフォールバックします。 @@ -295,29 +296,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 生成される画像のアスペクト比 + 生成画像のアスペクト比 - 任意。生成される画像の画像出力形式。 + オプション。生成画像の出力形式。 - 任意。出力画像の圧縮品質。 + オプション。出力画像の圧縮品質。 - 任意。出力を保存する際の画像形式。これは Vertex AI のパス(Comfy 自身の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエスト)で使用されます。そこでの受け入れ値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しする 400 で拒否されます。省略時は `image/png` が既定です。例外は Google AI Studio の APIキーで認証された BYOK リクエストです。そのアップストリームにはこのようなプロパティが存在せず、含まれていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どのパスでも、送信した値を前提とするのではなく、返されたレスポンスパートからメディアタイプを読み取ってください(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)。 + オプション。出力を保存する画像形式。Vertex AI の経路、つまり Comfy 自身の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエストで使用されます。そこで受け入れられる値は `image/png` と `image/jpeg` で、大文字と小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールド名を含む 400 エラーで拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。その上流にはそのようなプロパティがなく、存在する場合は呼び出し全体を拒否するため、このフィールドは尊重されたり拒否されたりするのではなくリクエストから削除され、出力形式は AI Studio が選択するものになります。どの経路でも、送信した値を仮定するのではなく、受け取ったレスポンスのパートからメディアタイプを読み戻してください(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)。 - 任意。生成される画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 + オプション。生成画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値 1K を使用します。 - レスポンスで生成できるトークンの最大数。1 トークンはおよそ 4 文字です。100 トークンはおよそ 60~80 語に相当します。 + レスポンスで生成できるトークンの最大数。トークンは約 4 文字です。100 トークンはおよそ 60-80 語に相当します。 - 範囲: `16` から `65536` + 範囲: `16` ~ `65536` @@ -325,7 +326,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R -seed を特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じ seed 値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムな seed 値が使用されます。以下のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返せるよう最善を尽くします。決定的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。次のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -333,7 +334,7 @@ seed を特定の値に固定すると、モデルは繰り返しのリクエス - temperature は応答生成中のサンプリングに使用され、これは topP と topK が適用されるときに発生します。temperature はトークン選択のランダム性の度合いを制御します。低い temperature は、あまり自由奔放でない、あるいは創造的でない応答が求められるプロンプトに適しており、高い temperature はより多様で創造的な結果につながる可能性があります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定的ですが、わずかな変動は依然として起こり得ます。モデルが返す応答が一般的すぎる、短すぎる、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください + temperature は、topP と topK が適用される応答生成時のサンプリングに使用されます。temperature は、トークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由奔放でない回答や創造性を必要としないプロンプトに適しており、高い temperature はより多様な、または創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定的になりますが、少量のばらつきは依然として発生する可能性があります。モデルの応答が一般的すぎる、短すぎる、またはフォールバック応答が返される場合は、temperature を上げてみてください。 範囲: `0` から `2` @@ -341,33 +342,33 @@ seed を特定の値に固定すると、モデルは繰り返しのリクエス - 任意。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解し、より高品質な応答を生成するプロセスです。 + オプション。思考機能の設定です。思考とは、モデルが複雑なタスクをより小さなステップに分解し、より高品質な応答を生成するプロセスです。 - 任意。true の場合、モデルは応答に自身の思考を含めます。 + オプション。true の場合、モデルは応答に自身の思考を含めます。 - 任意。モデルの thinking プロセスに割り当てるトークン予算です。モデルはこの予算内に収めるよう最善を尽くします。 + オプション。モデルの思考プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 - 任意。モデルの thinking レベルです。 + オプション。モデルの思考レベルです。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` - top-K はモデルが出力するトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率が高いものになります。top-K が 3 の場合、次のトークンは最も確率が高い 3 つのトークンの中から temperature を用いて選択されます。 + Top-K は、モデルが出力のためにトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率の高いものになります。Top-K が 3 の場合、次に選択されるトークンは、temperature を使用して確率の高い上位 3 つのトークンの中から選択されます。 範囲: `1` から `…` 指定した場合、nucleus サンプリングが使用されます。 -top-P はモデルが出力するトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、確率の高いもの(top-K を参照)から低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を用いて A または B のいずれかを次のトークンとして選択し、C は候補から除外します。 -ランダム性の低い応答にはより低い値を、ランダム性の高い応答にはより高い値を指定してください。 +Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率の高いもの (top-K を参照) から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 +ランダム性の低い応答には低い値を、ランダム性の高い応答には高い値を指定してください。 範囲: `0` から `1` @@ -375,23 +376,23 @@ top-P はモデルが出力するトークンを選択する方法を変更し - 安全でないコンテンツをブロックするためのリクエストごとの設定。GenerateContentResponse.candidates に対して適用されます。 + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に対して適用されます。 - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + 指定可能な値: `OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` - モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に答えてください」や「回答に技術用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各パートのコンテンツは別々の段落にしてください。 + モデルのパフォーマンスを向上させるための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part 内のコンテンツは個別の段落にしてください。 - 1 つのメッセージを構成する、順序付けられたパートのリスト。パートごとに異なる IANA MIME タイプを持つ場合があります。トークンの最大数や画像の数など入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + 1 つのメッセージを構成する順序付けされた part のリストです。part ごとに異なる IANA MIME タイプを指定できます。トークンの最大数や画像の数などの入力の制限については、Google のモデルページにあるモデルの仕様を参照してください。 @@ -399,13 +400,13 @@ top-P はモデルが出力するトークンを選択する方法を変更し - メッセージを作成するエンティティの識別情報。次の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model 値は、マルチターン会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空のままにするか、未設定にできます。 + メッセージを作成するエンティティの識別子です。次の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空のままにするか、未設定にできます。 - 指定可能な値: `user`, `model` + 指定可能な値: `user`、`model` - システムがモデルの知識と範囲の外にあるアクションまたは一連のアクションを実行するために、外部システムと対話できるようにするコードの一部です。関数呼び出しを参照してください。 + システムがモデルの知識と範囲外のアクションまたはアクション群を実行するために、外部システムと連携できるようにするコードです。関数呼び出しを参照してください。 @@ -425,46 +426,46 @@ top-P はモデルが出力するトークンを選択する方法を変更し - true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。 + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に失効します。 - ビデオ入力の場合、Duration 形式でビデオの開始と終了のオフセットを指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 + ビデオ入力の場合、ビデオの開始と終了のオフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提供されている場合にのみ指定してください。 - ビデオタイムライン上の位置に対する再生時間のオフセットを表します。 + ビデオのタイムライン位置に対する再生時間オフセットを表します。 - ナノ秒解像度での秒の符号付き小数部。小数を含む負の秒値であっても、nanos 値は非負でなければなりません。 + ナノ秒精度の符号付き秒未満の端数。小数を含む負の秒値であっても、nanos 値は非負である必要があります。 - 範囲: `0` ~ `999999999` + 範囲: `0` ~ `999999999` - 期間の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 - 範囲: `-315576000000` ~ `315576000000` + 範囲: `-315576000000` ~ `315576000000` - ビデオタイムライン上の位置に対する再生時間のオフセットを表します。 + ビデオのタイムライン位置に対する再生時間オフセットを表します。 - ナノ秒解像度での秒の符号付き小数部。小数を含む負の秒値であっても、nanos 値は非負でなければなりません。 + ナノ秒精度の符号付き秒未満の端数。小数を含む負の秒値であっても、nanos 値は非負である必要があります。 - 範囲: `0` ~ `999999999` + 範囲: `0` ~ `999999999` - 期間の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間幅の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 - 範囲: `-315576000000` ~ `315576000000` + 範囲: `-315576000000` ~ `315576000000` -Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる同じドキュメントです。 +このスキーマは Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提供するスキーマから生成されたものであり、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 @@ -493,7 +494,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - フォーマット: `date` + 形式: `date` @@ -517,7 +518,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - URI ベースのデータ。 + URIベースのデータ。 @@ -525,29 +526,29 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + dataフィールドまたはfileUriフィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-liteおよびgemini-2.0-flashでは、オーディオファイルの最大長は8.4時間、ビデオファイル(オーディオなし)の最大長は1時間です。詳細については、Geminiのオーディオとビデオの要件を参照してください。テキストファイルはUTF-8でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 生バイト形式のインラインデータ。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイトデータによるインラインデータ。gemini-2.0-flash-liteおよびgemini-2.0-flashでは、inlineDataを使用して最大3000枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオのbase64エンコード。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB - フォーマット: `byte` + 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + dataフィールドまたはfileUriフィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-liteおよびgemini-2.0-flashでは、オーディオファイルの最大長は8.4時間、ビデオファイル(オーディオなし)の最大長は1時間です。詳細については、Geminiのオーディオとビデオの要件を参照してください。テキストファイルはUTF-8でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオを読み取る方法。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、検査するセグメントをモデルが判断します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオを読み取る方法。"AGENTIC"を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定できます。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash以降のFlashモデルでサポートされています。 @@ -555,7 +556,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - このパートがモデルによる思考/推論ステップであることを示します。 + このパートがモデルからの思考/推論ステップであることを示します。 @@ -605,8 +606,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - 可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - +Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全カテゴリに違反する確率 @@ -623,7 +623,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - 出力専用。入力のうちキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 + 出力専用。入力のキャッシュ部分(キャッシュされたコンテンツ)内のトークン数。 @@ -635,7 +635,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - 入力または出力コンテンツのモダリティの種類。 + 入力コンテンツまたは出力コンテンツのモダリティのタイプ。 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -645,7 +645,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。 + リクエスト内のトークン数。cachedContent が設定されている場合でも、これはキャッシュされたコンテンツ内のトークン数を含む、有効なプロンプトサイズの合計です。 @@ -653,7 +653,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - 入力または出力コンテンツのモダリティの種類。 + 入力コンテンツまたは出力コンテンツのモダリティのタイプ。 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -675,7 +675,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - 入力または出力コンテンツのモダリティの種類。 + 入力コンテンツまたは出力コンテンツのモダリティのタイプ。 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -685,7 +685,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` で提 - トークンの総数(プロンプト + 候補)。 + トークンの合計数(プロンプト + 候補)。 diff --git a/ja/development/comfy-router/models/google/nano-banana-pro/code.mdx b/ja/development/comfy-router/models/google/nano-banana-pro/code.mdx index 8a7df62ce6..b8ebca987a 100644 --- a/ja/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/ja/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で Nano Banana Pro を使う" description: "Comfy Router 経由の HTTP で Nano Banana Pro(Gemini 3 Pro Image)を使って画像を生成するための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "Nano Banana Pro" -translationSourceHash: 48881f72 +translationSourceHash: 63f6b907 translationFrom: development/comfy-router/models/google/nano-banana-pro/code.mdx translationBlockHashes: "_intro": 34f7de08 "Quick start": b78c780a "Serving providers": caff9b45 - "Schema": b9a919e8 + "Schema": 9094176d "Examples": 54f56549 --- @@ -17,6 +17,7 @@ translationBlockHashes: + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -234,7 +235,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE ### 入力 - モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 + モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。複数ターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。 @@ -242,7 +243,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - URI ベースのデータ。 + URIベースのデータ。 @@ -250,7 +251,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルのコンテンツはトークン制限に含まれます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -266,13 +267,13 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。指定できる値は以下のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルのコンテンツはトークン制限に含まれます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルのコンテンツはトークン制限にカウントされます。画像の解像度に制限はありません。 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - モデルがこのパートのビデオをどのように読み取るか。`"AGENTIC"` を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオを読み取る方法。"AGENTIC" を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを決定できます。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -288,7 +289,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 生成のサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作に従います。 + 生成のためのサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル固有の動作にフォールバックします。 @@ -296,11 +297,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 生成画像のアスペクト比 + 生成される画像のアスペクト比 - 任意。生成画像の画像出力形式。 + 任意。生成される画像の出力形式。 @@ -308,15 +309,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 任意。出力を保存する画像形式。Vertex AI のパス、つまり Comfy 自身の認証情報で処理されるリクエストと、GCP サービスアカウントで認証される BYOK リクエストが対象です。そこでの許容値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールドを名指しした 400 で拒否されます。省略時のデフォルトは `image/png` です。Google AI Studio の APIキーで認証される BYOK リクエストは例外です。その上流にはこのプロパティが存在せず、含まれていると呼び出し全体が拒否されるため、このフィールドは尊重も拒否もされずリクエストから削除され、出力形式は AI Studio が選択したものになります。どのパスでも、送信した値を前提とせず、渡されたレスポンスのパート(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み戻してください。 + 任意。Vertex AI のパス(Comfy 自身の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエスト)で、出力を保存する際の画像形式。そこで受け入れられる値は `image/png` と `image/jpeg` で、大文字と小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。その他の値は、このフィールドを名指しした 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームには該当するプロパティがなく、存在する場合は呼び出し全体を拒否します。そのため、このフィールドは尊重または拒否されるのではなくリクエストから削除され、出力形式は AI Studio が選択するものになります。どのパスでも、送信した値を前提とするのではなく、与えられたレスポンスのパート(`inlineData.mimeType`、または `uploadImagesToStorage` が設定されている場合は `fileData.mimeType`)からメディアタイプを読み戻してください。 - 任意。生成画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 + 任意。生成される画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値の 1K を使用します。 - レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおよそ 60~80 語に相当します。 + レスポンスで生成できるトークンの最大数。トークンは約 4 文字に相当します。100 トークンはおおよそ 60-80 語に相当します。 範囲: `16` から `65536` @@ -326,7 +327,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - seed を特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じ seed 値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムな seed 値が使用されます。以下のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Available for the following models:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -334,7 +335,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - temperature は、応答生成中にサンプリングのために使用されます。これは topP と topK が適用されるときに行われます。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、より限定的で創造性の低い応答が求められるプロンプトに適しており、高い temperature はより多様で創造的な結果につながる可能性があります。temperature が 0 の場合は、常に最も確率の高いトークンが選択されることを意味します。この場合、特定のプロンプトに対する応答はほぼ決定論的ですが、わずかなばらつきが生じる可能性はまだあります。モデルが返す応答が一般的すぎる、短すぎる、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください。 + temperature はレスポンス生成中のサンプリングに使用され、これは topP と topK が適用されるときに行われます。temperature はトークン選択のランダム性の度合いを制御します。低い温度は、よりオープンエンドでない、または創造的なレスポンスを必要とするプロンプトに適しており、高い温度はより多様で創造的な結果につながる可能性があります。温度 0 は、常に最も確率の高いトークンが選択されることを意味します。この場合、特定のプロンプトに対するレスポンスはほぼ決定的ですが、少量のばらつきは依然として発生する可能性があります。モデルが汎用的すぎる、短すぎるレスポンスを返す場合、またはモデルがフォールバックレスポンスを返す場合は、temperature を上げてみてください 範囲: `0` から `2` @@ -342,33 +343,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 任意。Thinking 機能の設定です。Thinking とは、モデルが複雑なタスクをより小さなステップに分解し、より高品質な応答を生成するプロセスです。 + オプション。シンキング機能の設定です。シンキングとは、モデルが複雑なタスクをより小さなステップに分解して、より高品質なレスポンスを生成するプロセスです。 - 任意。true の場合、モデルは自身の思考を応答に含めます。 + オプション。true の場合、モデルはレスポンスにその思考を含めます。 - 任意。モデルの思考プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 + オプション。モデルのシンキングプロセスのトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。 - 任意。モデルの思考レベルです。 + オプション。モデルのシンキングレベルです。 - 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K は、モデルが出力のためにトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率の高いものになります。Top-K が 3 の場合、次のトークンは、temperature を使用して、最も確率の高い 3 つのトークンの中から選択されます。 + Top-K は、モデルが出力のためにトークンを選択する方法を変更します。Top-K が 1 の場合、次に選択されるトークンはモデルの語彙内のすべてのトークンの中で最も確率が高いものになります。Top-K が 3 の場合、次のトークンは temperature を使用して、確率の高い上位 3 つのトークンの中から選択されます。 範囲: `1` から `…` 指定した場合、nucleus サンプリングが使用されます。 -Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値に等しくなるまで、最も確率の高いもの(top-K を参照)から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。 -ランダム性の低い応答には低い値、ランダム性の高い応答には高い値を指定します。 +Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、最も確率が高いもの(top-K を参照)から最も低いものへと、それらの確率の合計が top-P の値に等しくなるまで選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C を候補から除外します。 +ランダム性の低いレスポンスには低い値を、ランダム性の高いレスポンスには高い値を指定します。 範囲: `0` から `1` @@ -376,37 +377,37 @@ Top-P は、モデルが出力のためにトークンを選択する方法を - 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に対して適用されます。 + 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に適用されます。 - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - 指定可能な値: `OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` - モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に回答してください」や「回答に専門用語を使わないでください」などです。テキスト文字列はトークン制限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part のコンテンツは別々の段落にしてください。 + モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に答えてください」や「レスポンスに技術用語を使わないでください」などです。テキスト文字列はトークン制限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part のコンテンツは別々の段落にしてください。 - 単一のメッセージを構成する、順序付けられた parts のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。トークンの最大数や画像の数など、入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 + 単一のメッセージを構成する順序付けられた part のリストです。異なる part は異なる IANA MIME タイプを持つことがあります。最大トークン数や画像数などの入力の制限については、Google のモデルページにあるモデル仕様を参照してください。 - テキストプロンプトまたはコードスニペット。 + テキストプロンプトまたはコードスニペットです。 - メッセージを作成するエンティティの識別情報です。次の値がサポートされています: user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターン会話の途中でモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空欄または未設定のままにできます。 + メッセージを作成するエンティティの識別情報です。以下の値がサポートされています: user: メッセージが実際の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model 値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白または未設定のままにできます。 - 指定可能な値: `user`、`model` + 指定可能な値: `user`, `model` - モデルの知識や範囲外でアクションまたは一連のアクションを実行するために、システムが外部システムと連携できるようにするコードです。Function calling を参照してください。 + システムがモデルの知識と範囲外でアクションまたは一連のアクションを実行するために外部システムと対話できるようにするコードの断片です。Function calling を参照してください。 @@ -422,50 +423,50 @@ Top-P は、モデルが出力のためにトークンを選択する方法を - 関数パラメータの JSON スキーマ + 関数パラメータのJSONスキーマ - true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間で期限切れになります。 + true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間で失効します。 - ビデオ入力の場合、ビデオの開始と終了のオフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData として提示されている場合にのみ指定してください。 + ビデオ入力の場合、ビデオの開始と終了のオフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } と "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。 - ビデオのタイムライン上の位置に対する再生時間のオフセットを表します。 + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 - ナノ秒精度の秒の小数部(符号付き)。小数部を持つ負の秒値であっても、nanos 値は非負でなければなりません。 + ナノ秒分解能での秒の符号付き小数部。小数を含む負の秒値であっても、nanos 値は非負である必要があります。 - 範囲: `0` ~ `999999999` + 範囲: `0` から `999999999` - 時間幅の秒数(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間範囲の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 - 範囲: `-315576000000` ~ `315576000000` + 範囲: `-315576000000` から `315576000000` - ビデオのタイムライン上の位置に対する再生時間のオフセットを表します。 + ビデオのタイムライン位置に対する再生時間のオフセットを表します。 - ナノ秒精度の秒の小数部(符号付き)。小数部を持つ負の秒値であっても、nanos 値は非負でなければなりません。 + ナノ秒分解能での秒の符号付き小数部。小数を含む負の秒値であっても、nanos 値は非負である必要があります。 - 範囲: `0` ~ `999999999` + 範囲: `0` から `999999999` - 時間幅の秒数(符号付き)。-315,576,000,000 から +315,576,000,000 まで(両端を含む)でなければなりません。 + 時間範囲の符号付き秒数。-315,576,000,000 から +315,576,000,000 まで(両端を含む)である必要があります。 - 範囲: `-315576000000` ~ `315576000000` + 範囲: `-315576000000` から `315576000000` -Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供しているスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に対象とするドキュメントと同じものです。 +Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 ### 出力 @@ -518,7 +519,7 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 - URI ベースのデータ。 + URI ベースのデータです。 @@ -526,29 +527,29 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。使用できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 生バイトのインラインデータです。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 + 生のバイト形式のインラインデータです。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。 - プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコードです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB + プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、データのメディアタイプ(mimeType)も指定する必要があります。サイズ制限: 20MB 形式: `byte` - data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。使用できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(オーディオなし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードする必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 + data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定可能な値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル(音声なし)の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。 - 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 指定可能な値: `application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングの代わりに、モデルに検査するセグメントを判断させるには "AGENTIC" を設定します。デフォルトの固定レートサンプリングを使用する場合は省略します。gemini-3.7-flash およびそれ以降の Flash モデルでサポートされています。 + モデルがこのパートのビデオをどのように読み取るかです。固定レートのフレームサンプリングの代わりに、モデルが検査するセグメントを決定できるようにするには "AGENTIC" を設定します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。 @@ -556,11 +557,11 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 - このパートがモデルによる思考/推論ステップであることを示します。 + このパートがモデルによる思考/推論のステップであることを示します。 - 指定可能な値: `user`, `model` + 指定可能な値: `user`、`model` @@ -572,21 +573,21 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - コンテンツが指定された安全カテゴリに違反する確率です + コンテンツが指定された安全性カテゴリに違反する確率です - 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` - レスポンスが作成されたタイムスタンプ。 + レスポンスが作成されたタイムスタンプです。 - レスポンスの生成に使用されたモデルバージョン。 + レスポンスの生成に使用されたモデルのバージョンです。 @@ -606,17 +607,17 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 -可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - コンテンツが指定された安全性カテゴリに違反している確率 + コンテンツが指定された安全カテゴリに違反する確率 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - レスポンスの一意な識別子。 + レスポンスの一意の識別子。 @@ -624,7 +625,7 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 - 出力専用。入力内のキャッシュ部分(キャッシュされたコンテンツ)のトークン数。 + 出力専用。入力のうちキャッシュされた部分(キャッシュされたコンテンツ)のトークン数。 @@ -646,7 +647,7 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 - リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズのままであり、キャッシュされたコンテンツ内のトークン数も含まれます。 + リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの総サイズを表し、キャッシュされたコンテンツ内のトークン数を含みます。 @@ -664,7 +665,7 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 - 思考の出力に含まれるトークン数。 + 思考(thoughts)出力に含まれるトークン数。 @@ -686,7 +687,7 @@ Router が `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` で提供 - トークンの合計数(プロンプト + 候補)。 + トークンの総数(プロンプト + 候補)。 diff --git a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index 7fab3ca53b..e3c559f57c 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,15 +2,16 @@ title: "Kling V2.5 Turbo を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-v2-5-turbo を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 06b3d8e9 +translationSourceHash: 3bbe1969 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 785eeca2 "Quick start": dc63b3ac - "Schema": e36b5646 + "Schema": a24874ef "Examples": 8623c725 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v2-5-turbo.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -161,11 +162,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID ビデオのアスペクト比 - 取り得る値: `16:9`, `9:16`, `1:1` + 指定可能な値: `16:9`, `9:16`, `1:1` - コールバック通知先のアドレス。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router がユーザーに代わってポーリングします。 + コールバック通知先アドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 形式: `uri` @@ -179,49 +180,49 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - カメラの水平軸(x軸)に沿った動きを制御します。負の値は左、正の値は右を示します。 + カメラの水平軸(x 軸)に沿った移動を制御します。負の値は左、正の値は右を示します。 範囲: `-10` から `10` - 垂直面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。 + カメラの垂直面内での回転(x 軸)を制御します。負の値は下方向への回転、正の値は上方向への回転を示します。 範囲: `-10` から `10` - カメラのロール量(z軸)を制御します。負の値は反時計回り、正の値は時計回りを示します。 + カメラのロール量(z 軸)を制御します。負の値は反時計回り、正の値は時計回りを示します。 範囲: `-10` から `10` - 水平面内でのカメラの回転(y軸)を制御します。負の値は左回転、正の値は右回転を示します。 + カメラの水平面内での回転(y 軸)を制御します。負の値は左への回転、正の値は右への回転を示します。 範囲: `-10` から `10` - カメラの垂直軸(y軸)に沿った動きを制御します。負の値は下、正の値は上を示します。 + カメラの垂直軸(y 軸)に沿った移動を制御します。負の値は下方向、正の値は上方向を示します。 範囲: `-10` から `10` - カメラの焦点距離の変化を制御します。負の値は狭い視野、正の値は広い視野を示します。 + カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。 範囲: `-10` から `10` - 定義済みのカメラの動きの種類。simple: カスタマイズ可能なカメラの動き。down_back: カメラが下降して後退します。forward_up: カメラが前進して上に傾きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 + 事前定義されたカメラ移動タイプ。simple: カスタマイズ可能なカメラ移動。down_back: カメラが下降して後退します。forward_up: カメラが前進して上に傾きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 - 取り得る値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` + 指定可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - ビデオ生成における柔軟性。値が高いほどモデルの柔軟性が低くなり、ユーザーのプロンプトとの関連性が強くなります。 + ビデオ生成における柔軟性。値が高いほど、モデルの柔軟性の度合いが低くなり、ユーザーのプロンプトとの関連性が強くなります。 範囲: `0` から `1` @@ -229,31 +230,25 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - ビデオの長さ(秒) + ビデオの長さ(秒) - 取り得る値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 指定可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - カスタマイズされたタスク ID。無視されます。comfy-api は転送前にこのフィールドを破棄し、Comfy Router がユーザーに代わってポーリングします。 - - - - ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロモード。より長い再生時間のビデオを高品質な出力で生成します。 - - 取り得る値: `std`, `pro` + カスタマイズされたタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。 + モデル名。Comfy Router を使用する場合は省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。 - 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大 6 つのストーリーボードをサポートし、最小は 1 です。multi_shot が true かつ shot_type が customize の場合に必須です。 + 各ストーリーボードのプロンプトや再生時間などの情報。最大 6 個、最小 1 個のストーリーボードをサポートします。multi_shot が true かつ shot_type が customize の場合に必須です。 - このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 + このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 @@ -261,39 +256,39 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - このストーリーボードのプロンプト。最大長は 512 文字です。 + このストーリーボードのプロンプト。最大長 512 文字。 - マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type と multi_prompt パラメータは無効です。 + マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type および multi_prompt パラメータは無効です。 - ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接否定文で補足することが推奨されます。 + ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブ文を記述して補足することが推奨されます。 - ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには \<\<\>> を使用します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 + ポジティブテキストプロンプト。voice_list パラメータの順序に一致する音声を指定するには、\<\<\>> を使用します。タスクは最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 - ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。 + ストーリーボード方法。multi_shot パラメータが true に設定されている場合に必須です。 - 取り得る値: `customize`, `intelligence` + 指定可能な値: `customize`, `intelligence` - ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のモデルのみです。 + ビデオ生成時にサウンドを同時に生成するかどうか。このパラメータをサポートするのは V2.6 以降のモデルバージョンのみです。 - 取り得る値: `on`, `off` + 指定可能な値: `on`, `off` - ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順序に従って `prompt` 内で \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これをサポートするのは V2.6 以降のモデルのみです。それ以前のモデルの場合、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。 + ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リスト順に `prompt` 内で \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があり、この設定は V2.6 以降のモデルバージョンのみがサポートします。それより前のモデルでは、または `sound` をデフォルトの "off" のままにした場合、音声は適用されません。 - 音声カスタマイズ API を通じて返される音声 ID、またはシステムプリセットの音声 ID。 + 音声カスタマイズ API を通じて返された音声 ID、またはシステムプリセットの音声 ID。 @@ -305,14 +300,20 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 参照画像 - URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 + 参照画像: URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 - 参照画像 - 終了フレームの制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。 + 参照画像: 終了フレームの制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。 + + + + ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間のビデオを生成しますが、出力品質は高くなります。 + + 指定可能な値: `std`、`pro` -Router が `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 +Router が `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。 ### 出力 @@ -325,11 +326,11 @@ Router が `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で提供する - タスクの作成時間(Unix タイムスタンプ、ミリ秒単位) + タスク作成時間、Unix タイムスタンプ(ミリ秒) - タスクの控除ユニット数 + タスクの控除単位数 @@ -353,7 +354,7 @@ Router が `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で提供する - ビデオの合計再生時間(秒単位) + ビデオの合計再生時間(秒) @@ -367,23 +368,23 @@ Router が `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で提供する - ウォーターマーク付きで生成されたビデオの URL(ホットリンク防止形式) + ウォーターマーク付きの生成されたビデオの URL(ホットリンク保護形式) 形式: `uri` - タスクのステータス + タスクステータス - 取り得る値: `submitted`、`processing`、`succeed`、`failed` + 指定可能な値: `submitted`、`processing`、`succeed`、`failed` - タスクのステータス情報。タスクが失敗した場合は失敗理由が表示されます + タスクステータス情報。タスクが失敗した場合は失敗理由を表示します - タスクの更新時間(Unix タイムスタンプ、ミリ秒単位) + タスク更新時間、Unix タイムスタンプ(ミリ秒) diff --git a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx index 3e6eed5a07..a5e7e6fbe3 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router で Kling V2.6 を使用する" description: "Comfy Router 経由で kling/kling-v2-6 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V2.6" -translationSourceHash: 94eb0863 +translationSourceHash: c9a8a551 translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": c2065202 "Quick start": 48a3d970 - "Schema": cd52808d + "Schema": e0deb97e "Examples": 8623c725 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v2-6.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -159,13 +160,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ ### 入力 - ビデオのアスペクト比率 + ビデオのアスペクト比 指定可能な値: `16:9`, `9:16`, `1:1` - コールバック通知のアドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 + コールバック通知先のアドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 形式: `uri` @@ -179,49 +180,49 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - カメラの水平軸 (x軸) に沿った移動を制御します。負の値は左、正の値は右を示します。 + カメラの水平軸 (x 軸) 方向の動きを制御します。負の値は左、正の値は右を表します。 範囲: `-10` から `10` - 垂直面内でのカメラの回転 (x軸) を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。 + 垂直面内でのカメラの回転 (x 軸) を制御します。負の値は下向きの回転、正の値は上向きの回転を表します。 範囲: `-10` から `10` - カメラのロール量 (z軸) を制御します。負の値は反時計回り、正の値は時計回りを示します。 + カメラのロール量 (z 軸) を制御します。負の値は反時計回り、正の値は時計回りを表します。 範囲: `-10` から `10` - 水平面内でのカメラの回転 (y軸) を制御します。負の値は左回転、正の値は右回転を示します。 + 水平面内でのカメラの回転 (y 軸) を制御します。負の値は左回転、正の値は右回転を表します。 範囲: `-10` から `10` - カメラの垂直軸 (y軸) に沿った移動を制御します。負の値は下、正の値は上を示します。 + カメラの垂直軸 (y 軸) 方向の動きを制御します。負の値は下方向、正の値は上方向を表します。 範囲: `-10` から `10` - カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。 + カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを表します。 範囲: `-10` から `10` - 定義済みのカメラワークの種類。simple: カスタマイズ可能なカメラワーク。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上に傾きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 + 定義済みのカメラの動きの種類。simple: カスタマイズ可能なカメラの動き。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 指定可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - ビデオ生成における柔軟性。値が高いほどモデルの柔軟性が低くなり、ユーザーのプロンプトとの関連性が強くなります。 + ビデオ生成における柔軟性。値が高いほどモデルの柔軟性の度合いが低くなり、ユーザーのプロンプトとの関連性が強くなります。 範囲: `0` から `1` @@ -235,13 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - - - - ビデオ生成モード。std: スタンダードモードで、コスト効率に優れています。pro: プロフェッショナルモードで、より長い再生時間で高品質なビデオを生成します。 - - 指定可能な値: `std`, `pro` + カスタマイズされたタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 @@ -249,15 +244,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 各ストーリーボードのプロンプトや再生時間などの情報。最大 6 つのストーリーボードをサポートし、最小で 1 つです。multi_shot が true かつ shot_type が customize の場合に必須です。 + プロンプトや再生時間など、各ストーリーボードの情報。最大 6 個のストーリーボードをサポートし、最小で 1 個です。multi_shot が true かつ shot_type が customize の場合に必須です。 - このストーリーボードの再生時間 (秒)。タスク全体の再生時間を超えてはならず、1 未満にすることもできません。すべてのストーリーボードの再生時間の合計がタスク全体の再生時間と等しくなります。 + このストーリーボードの再生時間 (秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 - ショットの順序番号 + ショットのシーケンス番号 @@ -265,15 +260,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type と multi_prompt パラメータは無効です。 + マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type および multi_prompt パラメータは無効です。 - ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接否定的な文で補うことが推奨されます。 + ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接否定的な文で補うことを推奨します。 - ポジティブテキストプロンプト。\< \<\>> を使用して voice_list パラメータの順序に対応する音声を指定します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 + ポジティブテキストプロンプト。\>> を使用して、voice_list パラメータの順序に対応する音声を指定します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 @@ -283,17 +278,17 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - ビデオ生成時に同時にサウンドを生成するかどうか。V2.6 以降のモデルのみがこのパラメータをサポートします。 + ビデオ生成時に同時にサウンドを生成するかどうか。モデルの V2.6 以降のバージョンのみがこのパラメータをサポートします。 指定可能な値: `on`, `off` - ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順に `prompt` 内で \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これは V2.6 以降のモデルのみがサポートします。それ以前のモデルの場合、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。 + ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順序に従って `prompt` 内で \>> および \>> として参照します。`sound` を "on" に設定する必要があり、これをサポートするのはモデルの V2.6 以降のバージョンのみです。それ以前のモデル、または `sound` をデフォルトの "off" のままにした場合、音声は適用されません。 - 音声カスタマイズ API から返された音声 ID、またはシステムプリセットの音声 ID。 + 音声カスタマイズ API から返される音声 ID、またはシステムプリセットの音声 ID。 @@ -305,14 +300,21 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 参照画像: URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 + +参照画像:URL または Base64 エンコード文字列。10MB を超えることはできません。解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 - 参照画像: 終了フレーム制御。URL または Base64 エンコード文字列で、10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。 + 参照画像:終了フレームの制御。URL または Base64 エンコード文字列。10MB を超えることはできません。解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask またはカメラコントロールと同時に使用することはできません。 + + + + ビデオ生成モード。std:スタンダードモード。コスト効率に優れています。pro:プロフェッショナルモード。より長い再生時間のビデオを、より高い品質で生成します。 + + 指定可能な値: `std`、`pro` -これは Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるのと同じドキュメントです。 +`GET /v2/models/kling/kling-v2-6/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するものと同じドキュメントです。 ### 出力 @@ -325,7 +327,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - タスク作成時間、Unixタイムスタンプ(ミリ秒) + タスクの作成時間、Unix タイムスタンプ(ミリ秒) @@ -333,7 +335,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - タスクID + タスク ID @@ -357,17 +359,17 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 生成済みビデオID + 生成されたビデオの ID - 生成済みビデオのURL + 生成されたビデオの URL 形式: `uri` - ウォーターマーク付き生成済みビデオのURL、ホットリンク保護形式 + ウォーターマーク付きの生成されたビデオの URL(ホットリンク保護形式) 形式: `uri` @@ -375,15 +377,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ タスクステータス - 可能な値: `submitted`、`processing`、`succeed`、`failed` + 取り得る値: `submitted`、`processing`、`succeed`、`failed` - タスクステータス情報。タスクが失敗した場合は失敗理由を表示します + タスクステータス情報。タスクが失敗した場合は失敗理由が表示されます - タスク更新時間、Unixタイムスタンプ(ミリ秒) + タスクの更新時間、Unix タイムスタンプ(ミリ秒) @@ -399,7 +401,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - リクエストID + リクエスト ID ## 例 diff --git a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx index 765878b269..30e4b4f8dd 100644 --- a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,16 +2,17 @@ title: "Kling V3 Omni を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-v3-omni を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V3 Omni" -translationSourceHash: 29d1799c +translationSourceHash: 7fdb91b8 translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": 68bd0500 + "Schema": 6d7cb727 "Examples": 6c2642d6 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v3-omni.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -205,12 +206,6 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ 取り得る値: `first_frame`, `end_frame` - - ビデオ生成モード。std: スタンダードモード、720Pビデオを生成、コスト効率が良い。pro: プロフェッショナルモード、1080Pビデオを生成、より高品質なビデオ出力。 - - 取り得る値: `pro`, `std` - - モデル名。Comfy Routerを使用する場合は省略するかnullを送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致する必要があります。 @@ -252,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 参照ビデオリスト。特徴の参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトでは編集対象のビデオです。 + 参照ビデオリスト。フィーチャーの参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトでは編集対象のビデオです。 @@ -262,7 +257,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 参照ビデオタイプ。feature は特徴参照ビデオ、base は編集対象のビデオです。 + 参照ビデオタイプ。feature はフィーチャー参照ビデオ、base は編集対象のビデオです。 取り得る値: `feature`, `base` @@ -279,6 +274,12 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ true はウォーターマークを生成、false は生成しないことを意味します。 + + ビデオ生成モード。std: スタンダードモード、720Pビデオを生成、コスト効率が良い。pro: プロフェッショナルモード、1080Pビデオを生成、より高品質なビデオ出力。4k: ウルトラHDモード、4K解像度のビデオを生成。4k をサポートするのは kling-v3-omni のみです。kling-video-o1 は pro/std のみに対応します。 + + 取り得る値: `pro`, `std`, `4k` + + Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するスキーマから生成されており、これはリクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 @@ -334,7 +335,7 @@ Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するス - ウォーターマーク付きの生成されたビデオのURL、直リンク防止形式 + ウォーターマーク付きで生成されたビデオのURL(直リンク防止形式) 形式: `uri` diff --git a/ja/development/comfy-router/models/kling/kling-v3/code.mdx b/ja/development/comfy-router/models/kling/kling-v3/code.mdx index e5ce98e2fb..d179602d02 100644 --- a/ja/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,16 +2,18 @@ title: "Comfy Router で Kling V3 を使用する" description: "Comfy Router 経由で kling/kling-v3 を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling V3" -translationSourceHash: f5127eab +translationSourceHash: d84a12f2 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 6b9cddba "Quick start": 09c0a41a "Serving providers": b4093d36 - "Schema": 2fce4523 + "Schema": 605a654d "Examples": 8623c725 --- + + {/* GENERATED FILE. Generated from router-schemas/kling/kling-v3.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -175,11 +177,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ ビデオのアスペクト比 - 指定可能な値: `16:9`, `9:16`, `1:1` + 指定可能な値: `16:9`、`9:16`、`1:1` - コールバック通知のアドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 + コールバック通知先のアドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 形式: `uri` @@ -193,13 +195,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - カメラの水平軸(x軸)方向の移動を制御します。負の値は左、正の値は右を示します。 + カメラの水平軸(x軸)に沿った移動を制御します。負の値は左、正の値は右を示します。 範囲: `-10` から `10` - 垂直平面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。 + 垂直面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。 範囲: `-10` から `10` @@ -211,31 +213,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 水平平面内でのカメラの回転(y軸)を制御します。負の値は左への回転、正の値は右への回転を示します。 + 水平面内でのカメラの回転(y軸)を制御します。負の値は左への回転、正の値は右への回転を示します。 範囲: `-10` から `10` - カメラの垂直軸(y軸)方向の移動を制御します。負の値は下方向、正の値は上方向を示します。 + カメラの垂直軸(y軸)に沿った移動を制御します。負の値は下方向、正の値は上方向を示します。 範囲: `-10` から `10` - カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。 + カメラの焦点距離の変化を制御します。負の値はより狭い視野、正の値はより広い視野を示します。 範囲: `-10` から `10` - 定義済みのカメラ移動タイプ。simple: カスタマイズ可能なカメラ移動。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上方向にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 + 定義済みのカメラ動作タイプ。simple: カスタマイズ可能なカメラ動作。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上方向にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。 - 指定可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` + 指定可能な値: `simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` - ビデオ生成における柔軟性。値が高いほどモデルの柔軟性は低くなり、ユーザーのプロンプトとの関連性が強くなります。 + ビデオ生成における柔軟性。値が高いほどモデルの柔軟性の度合いが低くなり、ユーザーのプロンプトへの関連性が強くなります。 範囲: `0` から `1` @@ -245,29 +247,23 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ ビデオの長さ(秒) - 指定可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 指定可能な値: `3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` カスタマイズされたタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。 - - ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間で高品質な出力のビデオを生成します。 - - 指定可能な値: `std`, `pro` - - - モデル名。Comfy Router を使用する場合は省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。 + モデル名。Comfy Router を使用する場合は、省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。 - 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大 6 個のストーリーボードをサポートし、最小 1 個です。multi_shot が true かつ shot_type が customize の場合に必須です。 + プロンプトや再生時間など、各ストーリーボードに関する情報。最大6個、最小1個のストーリーボードをサポートします。multi_shot が true かつ shot_type が customize の場合に必須です。 - このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にはできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 + このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にすることもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。 @@ -283,27 +279,27 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接否定文を記述して補うことが推奨されます。 + ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文を記述して補足することが推奨されます。 - ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには、\<\<\>> を使用します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 + ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには、\<\<\>> を使用します。1つのタスクで最大2つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。 - 指定可能な値: `customize`, `intelligence` + 指定可能な値: `customize`、`intelligence` - ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータはモデルの V2.6 以降のバージョンのみがサポートします。 + ビデオを生成するときに同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のモデルのみです。 - 指定可能な値: `on`, `off` + 指定可能な値: `on`、`off` - ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順序に従って `prompt` 内で \<\<\>> と \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これはモデルの V2.6 以降のバージョンのみがサポートします。それ以前のモデルでは、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。 + ビデオ生成時に参照する音声のリスト。最大2つの音声をサポートします。リストの順に `prompt` 内で \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があります。これをサポートするのは V2.6 以降のモデルのみです。以前のモデルの場合、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。 @@ -311,7 +307,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - ウォーターマーク付きの結果を同時に生成するかどうか。現時点ではカスタムウォーターマークはサポートされていません。 + 透かし入りの結果を同時に生成するかどうか。現時点ではカスタム透かしはサポートされていません。 @@ -319,14 +315,21 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 参照画像: URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 + +Reference Image - URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 - 参照画像: 終了フレーム制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。 + Reference Image - 終了フレーム制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control とは同時に使用できません。 + + + + 動画生成モード。std: コスト効率に優れたスタンダードモード。pro: プロフェッショナルモード。より長い再生時間の動画を、より高品質な出力で生成します。4k: 4K解像度の動画を生成するウルトラHDモード。このモデルファミリーで 4k をサポートするのは kling-v3 のみです。その他の Kling テキストから動画へのモデルは pro/std のみに対応します。 + + 指定可能な値: `std`, `pro`, `4k` -`GET /v2/models/kling/kling-v3/openapi.json` で Router が提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。 +これは Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。 ### 出力 @@ -339,11 +342,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - タスクの作成時間。Unix タイムスタンプ(ミリ秒) + タスクの作成時間、Unix タイムスタンプ(ミリ秒) - タスクの消費ユニット数 + タスクの控除ユニット数 @@ -381,7 +384,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - ウォーターマーク付きの生成されたビデオの URL(ホットリンク防止形式) + ウォーターマーク付きの生成されたビデオの URL(ホットリンク保護形式) 形式: `uri` @@ -389,7 +392,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ タスクのステータス - 取りうる値: `submitted`、`processing`、`succeed`、`failed` + 取り得る値: `submitted`、`processing`、`succeed`、`failed` @@ -397,7 +400,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - タスクの更新時間。Unix タイムスタンプ(ミリ秒) + タスクの更新時間、Unix タイムスタンプ(ミリ秒) diff --git a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx index ef2e832725..5a1f714381 100644 --- a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,16 +2,17 @@ title: "Kling Video O1 を Comfy Router で使用する" description: "Comfy Router 経由で kling/kling-video-o1 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Kling Video O1" -translationSourceHash: 892ccf77 +translationSourceHash: 8870f379 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": f693e2ef + "Schema": e4a41688 "Examples": 6c2642d6 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-video-o1.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -205,12 +206,6 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ 指定可能な値: `first_frame`, `end_frame` - - ビデオ生成モード。std: スタンダードモード。720P のビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモード。1080P のビデオを生成し、より高品質なビデオを出力します。 - - 指定可能な値: `pro`, `std` - - モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。 @@ -279,6 +274,12 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ true はウォーターマークを生成、false は生成しないことを意味します。 + + ビデオ生成モード。std: スタンダードモード。720P のビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモード。1080P のビデオを生成し、より高品質なビデオを出力します。 + + 指定可能な値: `pro`, `std` + + `GET /v2/models/kling/kling-video-o1/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。 ### 出力 diff --git a/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx b/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx new file mode 100644 index 0000000000..eb21388415 --- /dev/null +++ b/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx @@ -0,0 +1,222 @@ +--- +title: "Comfy Router で LTX Video Alpha Gen を使用する" +description: "Comfy Router 経由で ltx/ltx-video-alpha-gen を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "LTX Video Alpha Gen" +translationSourceHash: 9ad35117 +translationFrom: development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx +translationBlockHashes: + "_intro": 99d9f21c + "Quick start": 3fae9114 + "Schema": 2e86e846 + "Examples": 68527b2e +--- +{/* GENERATED FILE. router-schemas/ltx/ltx-video-alpha-gen.json から `pnpm code-pages:gen` により生成済み。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-alpha-gen` の API リファレンスです。Comfy Router が LTX から提供しています。 + +**入力:** ビデオ · **出力:** ビデオ + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK を使用しており(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)、cURL スニペットは同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `ltx/ltx-video-alpha-gen` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-alpha-gen", + { + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +const { data } = await comfy.models.run("ltx/ltx-video-alpha-gen", { + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests` に送信します。Router は実行が受け付けられるとすぐに `request_id` を含む `201` を返し、結果は準備ができ次第、このプロセスまたは別のプロセスから収集します。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集について順を追って説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-alpha-gen", + { + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスに必要な情報はこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の時間だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 + # 失敗またはキャンセル済みのリクエストでは、ここで型付きの Router エラーが発生します。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +const handle = await comfy.models.submit("ltx/ltx-video-alpha-gen", { + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 送信。Router は request_id、status_url、response_url、cancel_url を含む 201 を返します。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. status が COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集。モデルのネイティブ出力を含む 200、実行中はステータスボディを含む 202 を返します。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + 入力ビデオは、一般にアクセス可能な HTTPS URL または base64 データ URI として指定します。形式は MP4、MOV、MKV のいずれかで、コーデックは H.264 または HEVC、URL 経由の場合は最大 200 MB です。長辺は最大 3840 ピクセル、短辺は最大 2160 ピクセルです。 + + +Router が `GET /v2/models/ltx/ltx-video-alpha-gen/openapi.json` で配信するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じです。 + +### 出力 + + + ジョブの完了タイムスタンプ(ISO 8601) + + + + ジョブの作成タイムスタンプ(ISO 8601) + + + + status が失敗の場合に存在します + + + + + + + + + + + + 一意のジョブ識別子 + + + + status が完了の場合に存在します。出力 URL は完了から 24 時間後に失効します + + + + マットをアルファチャンネルとして持つ入力ビデオの URL(ProRes 4444 MOV) + + + + グレースケールのアルファマットの URL(白が前景となる MP4) + + + + ジョブのステータス(保留中、処理中、完了、失敗) + + +## 例 + +### 入力 + +```json +{ + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 出力 + +```json +{ + "completed_at": "2026-01-01T00:00:50Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "cutout_video_url": "https://example.invalid/ltx/cutout.mov", + "matte_video_url": "https://example.invalid/ltx/matte.mp4" + }, + "status": "completed" +} +``` + + + diff --git a/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx b/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx new file mode 100644 index 0000000000..32b331394a --- /dev/null +++ b/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx @@ -0,0 +1,232 @@ +--- +title: "Comfy Router で LTX Video To Video Hdr を使用する" +description: "Comfy Router 経由で ltx/ltx-video-to-video-hdr を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "LTX Video To Video Hdr" +translationSourceHash: 42a210ab +translationFrom: development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx +translationBlockHashes: + "_intro": 73aee58d + "Quick start": 0cc37810 + "Schema": 511ed3d7 + "Examples": 2bedcca6 +--- +{/* GENERATED FILE. `router-schemas/ltx/ltx-video-to-video-hdr.json` から `pnpm code-pages:gen` によって生成されたファイルです。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-to-video-hdr` の API リファレンスです。Comfy Router が LTX から提供しています。 + +**入力:** ビデオ · **出力:** ビデオ + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用します。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `ltx/ltx-video-to-video-hdr` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動再試行のために再利用します。 +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-to-video-hdr", + { + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動再試行のために再利用します。 +const { data } = await comfy.models.run("ltx/ltx-video-to-video-hdr", { + output_colorspace: "acescg", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"output_colorspace\": \"acescg\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備ができ次第、このプロセスまたは別のプロセスから収集されます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動再試行のために再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-to-video-hdr", + { + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # モデル ID とともに、別のプロセスに必要なのはこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の時間だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。 + # 失敗した、またはキャンセルされたリクエストは、ここで型付きの Router エラーを送出します。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動再試行のために再利用します。 +const handle = await comfy.models.submit("ltx/ltx-video-to-video-hdr", { + output_colorspace: "acescg", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 送信します。Router は request_id、status_url、response_url、cancel_url を含む 201 を返します。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"output_colorspace\": \"acescg\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集します。200 はモデルのネイティブ出力、202 はまだ実行中の場合のステータスボディです。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + `result.exr_frames_url` にある OpenEXR フレームシーケンスの色空間。`result.video_url` には影響しません。 + + 取り得る値: `acescg`、`acescct`、`srgb_linear`、`aces2065-1` + + + + 公開アクセス可能な HTTPS URL または base64 データ URI としての入力ビデオ。MP4、MOV、MKV の H.264 または HEVC で、URL 経由の場合最大 200 MB。幅と高さは、縦横いずれの向きでも 3840x2160 以内に収まる必要があります。 + + +Router が `GET /v2/models/ltx/ltx-video-to-video-hdr/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するドキュメントと同じです。 + +### 出力 + + + ジョブの完了タイムスタンプ (ISO 8601) + + + + ジョブの作成タイムスタンプ (ISO 8601) + + + + status が failed の場合に存在 + + + + + + + + + + + + 一意のジョブ識別子 + + + + status が completed の場合に存在。出力 URL は完了から 24 時間後に失効します + + + + 指定した色空間のフレームごとの OpenEXR 画像をまとめた ZIP の URL + + + + HDR ビデオの URL。10 ビット HEVC BT.2020/HLG の MP4 + + + + ジョブのステータス (pending、processing、completed、failed) + + +## 例 + +### 入力 + +```json +{ + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 出力 + +```json +{ + "completed_at": "2026-01-01T00:00:45Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "exr_frames_url": "https://example.invalid/ltx/exr_frames.zip", + "video_url": "https://example.invalid/ltx/hdr.mp4" + }, + "status": "completed" +} +``` + + diff --git a/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx b/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx new file mode 100644 index 0000000000..c33d724f0f --- /dev/null +++ b/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx @@ -0,0 +1,261 @@ +--- +title: "Comfy Router で LTX Video To Video Reframe を使用する" +description: "Comfy Router 経由で ltx/ltx-video-to-video-reframe を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "LTX Video To Video Reframe" +translationSourceHash: a82950a2 +translationFrom: development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx +translationBlockHashes: + "_intro": 06c6f3d9 + "Quick start": a6026b27 + "Schema": 4d231f97 + "Examples": 846aabe4 +--- +{/* GENERATED FILE. Generated from router-schemas/ltx/ltx-video-to-video-reframe.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-to-video-reframe` の API リファレンスです。Comfy Router が LTX から提供しています。 + +**入力:** ビデオ · **出力:** ビデオ + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK (`pip install comfy-sdk` と `npm install @comfyorg/sdk`) を使用しており、cURL スニペットは同じ呼び出しを raw HTTP で行います。 + +**モデル ID:** `ltx/ltx-video-to-video-reframe` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動再試行のために再利用します。 +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-to-video-reframe", + { + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動再試行のために再利用します。 +const { data } = await comfy.models.run("ltx/ltx-video-to-video-reframe", { + resolution: "720x1280", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"720x1280\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests` に送信します。Router は実行が受け入れられるとすぐに `request_id` とともに `201` を返し、結果は準備ができ次第、このプロセスまたは別のプロセスから収集されます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動再試行のために再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-to-video-reframe", + { + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスに必要なすべての情報 + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。 + # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動再試行のために再利用します。 +const handle = await comfy.models.submit("ltx/ltx-video-to-video-reframe", { + resolution: "720x1280", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 送信。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"720x1280\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集。モデル本来の出力とともに 200、まだ実行中の場合はステータスボディとともに 202。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + ソースビデオを出力フレーム内のどこに配置するか。`anchor` を指定するか、`x` と `y` に `width`、`height`、またはその両方を組み合わせて指定します。`placement` を省略すると、収まる最大サイズでビデオが中央に配置されます。 + + + + ビデオを配置する出力フレームの辺または角。 + + 指定可能な値: `center`、`top`、`bottom`、`left`、`right`、`top_left`、`top_right`、`bottom_left`、`bottom_right` + + + + 配置するビデオの高さ。出力の高さに対する比率で指定します。 + + 形式: `double` + + + + 配置するビデオの幅。出力の幅に対する比率で指定します。 + + 形式: `double` + + + + 配置するビデオの左端。出力の幅に対する比率で指定します。 + + 形式: `double` + + + + 配置するビデオの上端。出力の高さに対する比率で指定します。 + + 形式: `double` + + + + 目標とする出力解像度。ソースビデオはこのフレームを埋めるように拡張されます。 + + 指定可能な値: `720x720`、`1080x1080`、`720x900`、`1080x1350`、`900x720`、`1350x1080`、`720x1280`、`1080x1920`、`1280x720`、`1920x1080` + + + + 入力ビデオ。公開アクセス可能な HTTPS URL または base64 データ URI で指定します。MP4、MOV、MKV 形式の H.264 または HEVC に対応し、URL 指定の場合は最大 200 MB です。最大 60 秒、1800 フレームまでで、幅と高さはそれぞれ 64 から 4096 ピクセルの範囲です。 + + +スキーマから生成されており、Router が `GET /v2/models/ltx/ltx-video-to-video-reframe/openapi.json` で提供する内容と同じです。リクエストがプロバイダーに到達する前に、Router はこの同じドキュメントに照らして呼び出しを検証します。 + +### 出力 + + + ジョブの完了日時 (ISO 8601) + + + + ジョブの作成日時 (ISO 8601) + + + + status が failed の場合に存在します + + + + + + + + + + + + ジョブの一意な識別子 + + + + status が completed の場合に存在します。出力 URL は完了から 24 時間後に失効します + + + + 生成されたビデオの URL + + + + ジョブのステータス (pending、processing、completed、failed) + + +## 例 + +### 入力 + +```json +{ + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 出力 + +```json +{ + "completed_at": "2026-01-01T00:00:20Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "video_url": "https://example.invalid/ltx/output.mp4" + }, + "status": "completed" +} +``` + + diff --git a/ja/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx b/ja/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx new file mode 100644 index 0000000000..1c6faf63e2 --- /dev/null +++ b/ja/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx @@ -0,0 +1,227 @@ +--- +title: "Comfy Router で LTX Video Upscale を使用する" +description: "Comfy Router 経由で ltx/ltx-video-upscale を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "LTX Video Upscale" +translationSourceHash: 00a8b2b0 +translationFrom: development/comfy-router/models/ltx/ltx-video-upscale/code.mdx +translationBlockHashes: + "_intro": 8ef040a0 + "Quick start": e19118f2 + "Schema": b6e43e38 + "Examples": a6d53aaa +--- +{/* GENERATED FILE. router-schemas/ltx/ltx-video-upscale.json から `pnpm code-pages:gen` により生成済み。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-upscale` の API リファレンスです。Comfy Router が LTX から提供します。 + +**入力:** ビデオ · **出力:** ビデオ + オーディオ + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しています。cURL のスニペットは同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `ltx/ltx-video-upscale` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-upscale` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-upscale", + { + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +const { data } = await comfy.models.run("ltx/ltx-video-upscale", { + resolution: "1080p", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"1080p\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests` に送信します。Router は実行が受け付けられるとすぐに `request_id` を伴う `201` を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを順に説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-upscale", + { + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせれば、別のプロセスに必要なものはこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。 + # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +const handle = await comfy.models.submit("ltx/ltx-video-upscale", { + resolution: "1080p", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 送信。Router は request_id、status_url、response_url、cancel_url を伴う 201 を返します。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"1080p\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. status が COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集。実行中はステータスボディを伴う 202、完了後はモデルのネイティブ出力を伴う 200 を返します。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + 出力サイズ。アスペクト比は維持されます。 + + 指定可能な値: `1080p`、`4k`、`8k` + + + + 入力ビデオを、公開アクセス可能な HTTPS URL または base64 データ URI として指定します。MP4、MOV、MKV の H.264 または HEVC に対応し、URL 経由の場合の上限は 200 MB です。短辺は 480 ピクセル以上である必要があります。 + + +Router が `GET /v2/models/ltx/ltx-video-upscale/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 + +### 出力 + + + ジョブ完了タイムスタンプ (ISO 8601) + + + + ジョブ作成タイムスタンプ (ISO 8601) + + + + status が failed の場合に含まれます + + + + + + + + + + + + 一意のジョブ識別子 + + + + status が completed の場合に含まれます。出力 URL は完了から 24 時間後に失効します + + + + 生成済みビデオの URL + + + + ジョブステータス (pending, processing, completed, failed) + + +## 例 + +### 入力 + +```json +{ + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 出力 + +```json +{ + "completed_at": "2026-01-01T00:00:20Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "video_url": "https://example.invalid/ltx/output.mp4" + }, + "status": "completed" +} +``` + + diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 4fc693c8e7..75dc51e86a 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router で GPT Image 2.6 Flare を使用する" description: "Comfy Router 経由で openai/gpt-image-2.6-flare を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2.6 Flare" -translationSourceHash: 9f6b894f +translationSourceHash: 82634d88 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx translationBlockHashes: "_intro": 1693e80a "Quick start": 8222d9f4 - "Schema": 78f788c9 + "Schema": 85f18947 "Examples": c73859ec --- + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.6-flare.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -159,6 +160,18 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES 指定可能な値: `transparent`、`opaque`、`auto` + + アニメーション GIF のフレーム数(2〜16、OpenAI 自身の範囲)。`output_format: "gif"` の場合にのみ意味を持ち、他の `output_format` と併用すると拒否されます。GIF リクエストで省略した場合は OpenAI 自身の既定値である 9 になります。ただし Comfy は環境ごとにこのフィールドを追加で制限します(ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES、このフィールド自体の最大値 16 を超えることはありません)。設定された上限を超える値は拒否され、既定値の 9 自体が設定された上限を超える場合は、省略された `frame_count` が黙って引き下げられるのではなく拒否されます。そのため呼び出し元は、OpenAI の既定値より静かに小さいアニメーションを受け取るのではなく、`frame_count` を明示的に設定するよう告げられます。フレーム数は事前見積もりと 64 MiB の結果上限も左右し、どちらもフレーム数に比例してスケールします。 + + 範囲: `2` から `16` + + + + 各フレームが表示されるミリ秒(OpenAI 自身の範囲は 20〜2000 で、10 ms 単位に丸められます)。`output_format: "gif"` の場合にのみ意味を持ち、他の `output_format` と併用すると拒否されます。GIF リクエストで省略した場合は OpenAI 自身の既定値である 200 になります。 + + 範囲: `20` から `2000` + + 編集対象のソース画像。このフィールドが存在すると編集操作が選択されます。テキストから画像への生成では完全に省略してください。 モデルが公開している例は生成の呼び出しで、このフィールドを省略しています。`image` を追加することが 2 つのモードの違いのすべてです(同じエンドポイント、同じモデル ID)。ただし編集用のプロンプトはシーンではなく望む変更を記述するため、構造的に新しいのはこのフィールドだけでも、下記の編集用ボディは生成の例とは異なって見えます。 @@ -180,56 +193,61 @@ URL は認証情報なしで解決できる必要があります。Router はサ 各画像は 25 MiB、1 リクエストの画像は合計 64 MiB までです。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用可能な場合です。その場合、各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1 リクエストの画像は合計 128 MiB までです。 +一致するのはプロバイダーではなく、ホスト名の形式です。そのため、上記でプロバイダーを指定しても、そのプロバイダーが発行できるすべての URL が受け入れられるわけではありません。また、呼び出し元がそれぞれを無理なく使い得るため、紛らわしい 3 つの非対応形式を明示しておく価値があります。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限されたデバッグ用ホスト名として文書化しており、本番トラフィックは代わりにカスタムドメインに向けるよう案内しています。しかし、カスタムドメインのホスト名には R2 であることを示す情報が何も含まれていないため、Router は他のホストと区別できず、拒否します。`.r2.cloudflarestorage.com` エンドポイントの署名付き URL を生成するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 デュアルスタックエンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョンエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が記載されているため、ここに来て読む必要はありません。 +上記の `` と `pub-` プレースホルダーは、通常使用する形式を示しています。これらは階層の深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下にあるより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって名前空間自体が広がるわけではありません。サフィックスは依然として一覧に示されたものの 1 つでなければなりません。 +以下の例は形状のみを示しています。実際の値には署名クエリパラメータも含まれますが、公開された例は仕様に永久に残り、実際の署名は漏洩した認証情報であると同時に機能しなくなるリンクでもあるため、ここでは意図的に省略しています。 +各画像は 25 MiB に、1 回のリクエストの画像は合計 64 MiB に制限されます。唯一の例外は、`context_window` が利用可能な ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)です。そこでは各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセルまで可能で、1 回のリクエストの画像は合計最大 128 MiB です。 + - 実行する gpt-image モデル。Router がアドレス指定されたモデル id を挿入するため、/v2/models/openai/gpt-image-2 をアドレス指定する呼び出し元はこれを送信しません。 + 実行する gpt-image モデル。Router はアドレス指定されたモデル ID を挿入するため、/v2/models/openai/gpt-image-2.6-flare をアドレス指定する呼び出し元はこれを送信しません。 - コンテンツモデレーションの設定 + コンテンツモデレーション設定 - 指定可能な値: `low`, `auto` + 可能な値: `low`, `auto` - 生成する画像数(1〜10)。 + 生成する画像の数(1〜10)。GIF リクエスト(`output_format` を参照)は 1 以外の値を拒否します。OpenAI 自身の説明では、GIF リクエストにおける `n` を「アニメーションの数」と呼んでおり、Router は v1 ではこれの料金を計算しません。 範囲: `1` から `10` - JPEG または WebP の圧縮レベル(0〜100) + JPEG または WebP の圧縮レベル(0〜100)。GIF リクエストでは拒否されます。OpenAI はアニメーション出力の圧縮レベルを受け付けません。 範囲: `0` から `100` - 出力画像の形式 + 出力画像の形式。`gif` はさらに、`mask`、1 以外の `n`、`size` の省略、`auto`、不正な形式の `size`、`stream: true`、0 より大きい `partial_images`、および `output_compression` を拒否します(各フィールドの説明を参照してください)。また、Comfy がこの環境で有効にしていない限り、`gif` は一律に拒否されます。 - 指定可能な値: `png`, `webp`, `jpeg` + 可能な値: `png`, `webp`, `jpeg`, `gif` - ライブストリームと併用する場合にのみ意味を持ちますが、このサーフェスでは提供できません。`stream` は送信しても `false` に確定されます。生成時には、リクエストが `stream: true` も送信するかどうかに関わらず、`0` または `null` 以外の値は 400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 + このサーフェスでは提供できないライブストリームと併用する場合にのみ意味を持ち、OpenAIImageRouterRequest の場合とまったく同じです(そのフィールドの説明を参照してください)。GIF リクエストでは 0 より大きい値は拒否されます。`stream: true` が拒否されるのと同じ理由です。0 は受け入れられます。 範囲: `0` から `3` - 生成する画像、または `image` に加える編集のテキスト記述。 + 生成する画像、または `image` に加える編集のテキスト説明。 - 生成または編集された画像の品質。`xhigh` と `max` は gpt-image-2.5-flare と gpt-image-2.5-sunburst のために追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、認められたどのモデルも読み取りません。 + 生成または編集された画像の品質。`xhigh` と `max` は、gpt-image-2.5-flare と gpt-image-2.5-sunburst が追加された対象である 2 つの階層です。`standard` と `hd` は、受け入れられるどのモデルも解釈しない dall-e 時代の表記です。 - 指定可能な値: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` + 可能な値: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` - 画像のサイズ(例: 1024x1024、1536x1024、auto) + 画像のサイズ(例: 1024x1024、1536x1024、auto)。GIF リクエスト(`output_format` を参照)は `auto` を拒否し、このフィールドの省略も拒否します。明示的なサイズが、フレーム数によって乗算される前に、プリフライト見積もりと 64 MiB の結果上限を有限に保つためです。 - 送信する呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。これは `text/event-stream` を中継するのではなくプロバイダーの応答をキャプチャするためです(`image` を含むリクエストでは、編集がそれを伴わずに再エンコードされるため、このフィールドは破棄されます)。gpt-image の partial-image ストリーミングを提供する Comfy のサーフェスはありません。v1 の `POST /proxy/openai/images/generations` イングレスは `stream: true` を 400 で拒否し、リクエストをアップストリームへ転送することはありません。そのため、このフィールドは省略し、完了した応答を 1 つの JSON ボディとして読み取ってください。ストリームが開かれることはないため、`stream: true` と 1 より大きい `n` の併用に関する OpenAI の制限はここでは適用されません。`n` は送信されたとおりに転送されます。 + 送信する呼び出し元が拒否されないように宣言されていますが、OpenAIImageRouterRequest の場合とまったく同じく、このサーフェスでは無効です(そのフィールドの説明を参照してください)。GIF リクエストでは `true` は拒否されます(OpenAI のガイドでは、GIF 出力はストリーミングをサポートしないと述べられています)。`false` は受け入れられます。 @@ -297,7 +315,7 @@ URL は認証情報なしで解決できる必要があります。Router はサ - 生成された画像の背景が `opaque` か `transparent` か。OpenAI がこの生成のために解決した値です。リクエストパラメータのデフォルトは `auto` なので、明示的に指定しなかった呼び出し元はここでどちらが生成されたかを確認できます。 + 生成された画像の背景が `opaque` か `transparent` か。OpenAI がこの生成のために解決した値です。リクエストパラメータのデフォルトは `auto` なので、この値をピンしなかった呼び出し元はここでどちらが生成されたかを確認できます。 diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 4d1d427a9f..2ade359414 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router で GPT Image 2.6 Sunburst を使用する" description: "Comfy Router 経由で openai/gpt-image-2.6-sunburst を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2.6 Sunburst" -translationSourceHash: e71f1905 +translationSourceHash: 4e6d4ec0 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx translationBlockHashes: "_intro": 280b9c93 "Quick start": 2d3cb42c - "Schema": 2a71e1a8 + "Schema": 5296621a "Examples": c73859ec --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/openai/gpt-image-2.6-sunburst.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -159,6 +160,18 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ 指定可能な値: `transparent`、`opaque`、`auto` + + アニメーション GIF のフレーム数(2〜16、OpenAI 自身の範囲)です。`output_format: "gif"` の場合にのみ意味を持ち、他の `output_format` と併用すると拒否されます。GIF リクエストで省略した場合は OpenAI 自身のデフォルトである 9 になります。ただし Comfy は環境ごとにこのフィールドへ追加の上限を設定します(ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES、このフィールド自体の最大値 16 を超えることはありません)。設定された上限を超える値は拒否され、デフォルトの 9 自体が設定された上限を超える場合は、省略された `frame_count` が黙って引き下げられるのではなく拒否されます。そのため呼び出し元は、OpenAI のデフォルトより静かに小さいアニメーションを受け取るのではなく、`frame_count` を明示的に設定するよう告げられます。フレーム数はプリフライト見積もりと 64 MiB の結果上限も制約し、そのどちらもフレーム数に応じてスケールします。 + + 範囲: `2` から `16` + + + + 各フレームが表示される時間(ミリ秒、OpenAI 自身の範囲は 20〜2000 で 10 ms 単位に丸められます)。`output_format: "gif"` の場合にのみ意味を持ち、他の `output_format` と併用すると拒否されます。GIF リクエストで省略した場合は OpenAI 自身のデフォルトである 200 になります。 + + 範囲: `20` から `2000` + + 編集対象のソース画像。このフィールドの有無によって編集操作が選択されます。テキストから画像への生成では完全に省略してください。 モデルが公開している例は GENERATION 呼び出しであり、このフィールドを省略しています。`image` を追加することが 2 つのモードの違いのすべてです(同じエンドポイント、同じモデル ID)。ただし編集プロンプトはシーンではなく、実現したい変更を記述するため、構造的に新しいのはこのフィールドだけであっても、下記の編集用ボディは生成の例とは異なる読み方になります。 @@ -180,8 +193,16 @@ URL は認証情報なしで解決できる必要があります。Router はサ 各画像は 25 MiB、1 回のリクエストの画像は合計 64 MiB に制限されます。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用可能な場合です。その場合、各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1 回のリクエストの画像は合計で最大 128 MiB となります。 +一致するのはホスト名の形式であり、プロバイダーではありません。したがって、上でプロバイダーを指定しても、そのプロバイダーが発行できるすべての URL が受け入れられるわけではありません。また、3 つの紛らわしい非対応形式は明示する価値があります。呼び出し元がそれぞれの形式で到達するのは妥当だからです。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限付きのデバッグ用ホスト名として文書化しており、本番トラフィックは代わりにカスタムドメインに向けます。しかし、カスタムドメインのホスト名には R2 であることを示す情報がないため、Router は他のホストと区別できず、拒否します。`.r2.cloudflarestorage.com` エンドポイントの署名付き URL を生成するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も受け入れられません。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が記載されているため、それらを読むためにここへ来る必要はありません。 + +上記の `` と `pub-` は、通常使用する形式を示すプレースホルダーであり、階層の深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下にあるより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって名前空間自体が広がるわけではありません。サフィックスは依然として一覧にあるもののいずれかでなければなりません。 + +以下の例は形状のみを示しています。実際の値には署名クエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例は仕様に永久に残り、実際の署名は漏えいした認証情報であると同時に、機能しなくなるリンクでもあるためです。 + +各画像は 25 MiB、1 つのリクエストの画像は合計 64 MiB に制限されます。唯一の例外は、`context_window` が利用可能な ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)です。この場合、各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1 つのリクエストの画像は合計最大 128 MiB です。 + - 実行する gpt-image モデル。Router が指定されたモデル ID を挿入するため、/v2/models/openai/gpt-image-2 を指定する呼び出し元はこれを送信しません。 + 実行する gpt-image モデル。Router はアドレス指定されたモデル ID を挿入するため、/v2/models/openai/gpt-image-2.6-flare をアドレス指定する呼び出し元はこれを送信しません。 @@ -191,52 +212,52 @@ URL は認証情報なしで解決できる必要があります。Router はサ - 生成する画像の数(1-10)。 + 生成する画像の数(1〜10)。GIF リクエスト(`output_format` を参照)は 1 以外の値を拒否します。OpenAI 自身の説明では、GIF リクエストの `n` を「アニメーションの数」と呼んでいますが、Router は v1 ではこの料金を計算しません。 範囲: `1` から `10` - JPEG または WebP の圧縮レベル(0-100) + JPEG または WebP の圧縮レベル(0〜100)。GIF リクエストでは拒否されます。OpenAI はアニメーション出力の圧縮レベルを受け付けません。 範囲: `0` から `100` - 出力画像の形式 + 出力画像の形式。`gif` はさらに、`mask`、1 以外の `n`、`size` の省略、`auto`、不正な形式の `size`、`stream: true`、0 より大きい `partial_images`、および `output_compression` を拒否します(各フィールドの説明を参照)。また、Comfy がこの環境で有効化していない限り、一律に拒否されます。 - 指定可能な値: `png`, `webp`, `jpeg` + 指定可能な値: `png`, `webp`, `jpeg`, `gif` - ライブストリームと併用した場合にのみ意味を持ちますが、このサーフェスでは提供できません。`stream` は送信した場合でも `false` に確定されます。生成時には、リクエストで `stream: true` も送信されるかどうかに関係なく、`0` または `null` 以外の値は 400 で拒否されます。`image` を含むリクエストでは、このフィールドは転送されずに破棄されます。省略してください。 + ライブストリームと併用する場合にのみ意味を持ちますが、このサーフェスはライブストリームを提供できません。これは OpenAIImageRouterRequest の場合とまったく同じです(そのフィールドの説明を参照)。GIF リクエストでは 0 より大きい値は拒否されます。理由は `stream: true` の場合と同じです。0 は受け入れられます。 範囲: `0` から `3` - 生成する画像、または `image` に対して行う編集のテキストによる説明。 + 生成する画像のテキスト説明、または `image` に加える編集のテキスト説明。 - 生成または編集された画像の品質。`xhigh` と `max` は gpt-image-2.5-flare と gpt-image-2.5-sunburst のために追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、採用されているどのモデルも解釈しません。 + 生成済みまたは編集済みの画像の品質。`xhigh` と `max` は、gpt-image-2.5-flare と gpt-image-2.5-sunburst が追加された 2 つのティアです。`standard` と `hd` は dall-e 時代の表記であり、受け入れ対象のどのモデルも解釈しません。 指定可能な値: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` - 画像のサイズ(例: 1024x1024、1536x1024、auto) + 画像のサイズ(例: 1024x1024、1536x1024、auto)。GIF リクエスト(`output_format` を参照)は `auto` を拒否し、このフィールドの省略も拒否します。明示的なサイズは、それらを乗算するフレーム数より前に、事前見積もりと 64 MiB の結果上限を有限に保つためのものです。 - 送信する呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効です。Router はディスパッチ前にこれを `false` に確定します。これは `text/event-stream` を中継するのではなく、プロバイダーの応答をキャプチャするためです(`image` を含むリクエストでは、編集がそれなしで再エンコードされるため、代わりにフィールドが破棄されます)。Comfy のどのサーフェスも gpt-image の partial-image ストリーミングを提供しません。v1 の `POST /proxy/openai/images/generations` イングレスは `stream: true` を 400 で拒否し、リクエストをアップストリームに転送することはありません。そのため、このフィールドは省略し、完了した応答を 1 つの JSON ボディとして読み取ってください。ストリームが開かれることはないため、`stream: true` と 1 より大きい `n` の併用に対する OpenAI の制限はここでは適用されません。`n` は送信されたとおりに転送されます。 + 送信する呼び出し元が拒否されないように宣言されていますが、このサーフェスでは OpenAIImageRouterRequest の場合とまったく同様に無効です(そのフィールドの説明を参照)。GIF リクエストでは `true` は拒否されます(OpenAI のガイドでは、GIF 出力はストリーミングをサポートしないと記載されています)。`false` は受け入れられます。 エンドユーザー監視用の一意の識別子 -これは Router が `GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 +Router が `GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 diff --git a/ja/development/comfy-router/models/pixverse/v3-5/code.mdx b/ja/development/comfy-router/models/pixverse/v3-5/code.mdx new file mode 100644 index 0000000000..b63429d367 --- /dev/null +++ b/ja/development/comfy-router/models/pixverse/v3-5/code.mdx @@ -0,0 +1,309 @@ +--- +title: "Comfy Router で V3.5 を使用する" +description: "Comfy Router 経由で pixverse/v3.5 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" +sidebarTitle: "V3.5" +translationSourceHash: c6a6b3a8 +translationFrom: development/comfy-router/models/pixverse/v3-5/code.mdx +translationBlockHashes: + "_intro": 2772d5c1 + "Quick start": dc3a1030 + "Schema": 48bf7abc + "Examples": 0600cc10 +--- +{/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/pixverse/v3.5.json から生成済み。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`pixverse/v3.5` の API リファレンスです。Pixverse から Comfy Router が提供しています。 + +**入力:** テキスト · **出力:** ビデオ + +## クイックスタート {#quick-start} + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しています。cURL のスニペットは同じ呼び出しを raw HTTP で行うものです。 + +**モデル ID:** `pixverse/v3.5` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/pixverse/v3.5` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +with Comfy() as client: + result = client.models.run( + "pixverse/v3.5", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +const { data } = await comfy.models.run("pixverse/v3.5", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v3.5 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/pixverse/v3.5/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを順に説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v3.5", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせれば、別のプロセスに必要なものはこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定した Retry-After だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 + # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +const handle = await comfy.models.submit("pixverse/v3.5", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 送信。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。 +curl https://api.comfy.org/v2/models/pixverse/v3.5/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v3.5/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集。モデル固有の出力とともに 200、まだ実行中ならステータスボディとともに 202 を返します。 +curl https://api.comfy.org/v2/models/pixverse/v3.5/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`2:3`、`3:2`、`21:9` + + + + 範囲: `1` から `15` + + + + + + + + PixVerse のテキストから動画へのモデル識別子。Comfy Router のルート `POST /v2/models/pixverse/{model}` では、このフィールドはパスから供給されるため省略できます。 + + + + 指定可能な値: `normal`、`fast` + + + + + + + + + + + + 指定可能な値: `360p`、`540p`、`720p`、`1080p` + + + + + + + + 指定可能な値: `anime`、`3d_animation`、`clay`、`comic`、`cyberpunk` + + + + + + + + + + +Router が `GET /v2/models/pixverse/v3.5/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに届く前に Router が呼び出しを検証する際に用いるドキュメントと同じものです。 + +### 出力 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 指定可能な値: `1`、`5`、`6`、`7`、`8` + + + + + + + + + + +## 例 + +### 入力 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 出力 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + + diff --git a/ja/development/comfy-router/models/pixverse/v6-max/code.mdx b/ja/development/comfy-router/models/pixverse/v6-max/code.mdx new file mode 100644 index 0000000000..9029601633 --- /dev/null +++ b/ja/development/comfy-router/models/pixverse/v6-max/code.mdx @@ -0,0 +1,308 @@ +--- +title: "Comfy Router で V6 Max を使用する" +description: "Comfy Router 経由で pixverse/v6-max を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "V6 Max" +translationSourceHash: fe910720 +translationFrom: development/comfy-router/models/pixverse/v6-max/code.mdx +translationBlockHashes: + "_intro": 79517cb6 + "Quick start": 3197f978 + "Schema": 982f249f + "Examples": 0600cc10 +--- +{/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/pixverse/v6-max.json から生成されています。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +Comfy Router が Pixverse から提供する `pixverse/v6-max` の API リファレンスです。 + +**入力:** テキスト · **出力:** ビデオ + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `pixverse/v6-max` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/pixverse/v6-max` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は冪等キーを自動的に作成し、自動リトライ時に再利用します。 +with Comfy() as client: + result = client.models.run( + "pixverse/v6-max", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は冪等キーを自動的に作成し、自動リトライ時に再利用します。 +const { data } = await comfy.models.run("pixverse/v6-max", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v6-max \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/pixverse/v6-max/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを説明します。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# submit() の呼び出しごとに独自の Idempotency-Key を発行し、自動リトライ時に再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v6-max", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスが必要とするすべての情報 + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の分だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 + # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// submit() の呼び出しごとに独自の Idempotency-Key を発行し、自動リトライ時に再利用します。 +const handle = await comfy.models.submit("pixverse/v6-max", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 送信します。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。 +curl https://api.comfy.org/v2/models/pixverse/v6-max/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v6-max/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集します。200 の場合はモデル固有の出力、まだ実行中の場合は 202 とステータスボディが返ります。 +curl https://api.comfy.org/v2/models/pixverse/v6-max/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` + + + + 範囲: `1` から `15` + + + + + + + + PixVerse のテキストから動画へのモデル識別子です。Comfy Router のルート `POST /v2/models/pixverse/{model}` では、このフィールドはパスから供給されるため省略できます。 + + + + 指定可能な値: `normal`, `fast` + + + + + + + + + + + + 指定可能な値: `360p`, `540p`, `720p`, `1080p` + + + + + + + + 指定可能な値: `anime`, `3d_animation`, `clay`, `comic`, `cyberpunk` + + + + + + + + + + +Router が `GET /v2/models/pixverse/v6-max/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同じドキュメントです。 + +### 出力 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 指定可能な値: `1`, `5`, `6`, `7`, `8` + + + + + + + + + + +## 例 + +### 入力 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 出力 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + diff --git a/ja/development/comfy-router/models/pixverse/v6/code.mdx b/ja/development/comfy-router/models/pixverse/v6/code.mdx new file mode 100644 index 0000000000..c9db10839c --- /dev/null +++ b/ja/development/comfy-router/models/pixverse/v6/code.mdx @@ -0,0 +1,308 @@ +--- +title: "Comfy Router で V6 を使用する" +description: "Comfy Router 経由で pixverse/v6 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "V6" +translationSourceHash: a19e855d +translationFrom: development/comfy-router/models/pixverse/v6/code.mdx +translationBlockHashes: + "_intro": f933db97 + "Quick start": cbf8e767 + "Schema": f1b3a5fb + "Examples": 0600cc10 +--- +{/* GENERATED FILE. Generated from router-schemas/pixverse/v6.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`pixverse/v6` の API リファレンスです。Pixverse から Comfy Router が提供します。 + +**入力:** テキスト · **出力:** ビデオ + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `pixverse/v6` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/pixverse/v6` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +with Comfy() as client: + result = client.models.run( + "pixverse/v6", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +const { data } = await comfy.models.run("pixverse/v6", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v6 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/pixverse/v6/requests` に送信します。Router は実行が受け付けられるとすぐに `request_id` とともに `201` を返し、結果は準備ができ次第、このプロセスまたは別のプロセスから収集されます。[キューの配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集について説明しています。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v6", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # モデル ID とあわせて、別プロセスが必要とするすべての情報 + + # リクエストが完了するまでポーリングし、サーバーが示す Retry-After だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。 + # 失敗またはキャンセル済みのリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライで再利用します。 +const handle = await comfy.models.submit("pixverse/v6", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 送信。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。 +curl https://api.comfy.org/v2/models/pixverse/v6/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. status が COMPLETED になるまでポーリングし、各レスポンスが示す Retry-After 秒だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v6/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集。モデル本来の出力とともに 200、まだ実行中は status ボディとともに 202 を返します。 +curl https://api.comfy.org/v2/models/pixverse/v6/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`2:3`、`3:2`、`21:9` + + + + 範囲: `1` から `15` + + + + + + + + PixVerse テキストから動画へのモデル識別子。Comfy Router のルート `POST /v2/models/pixverse/{model}` では、このフィールドはパスから供給されるため省略できます。 + + + + 指定可能な値: `normal`、`fast` + + + + + + + + + + + + 指定可能な値: `360p`、`540p`、`720p`、`1080p` + + + + + + + + 指定可能な値: `anime`、`3d_animation`、`clay`、`comic`、`cyberpunk` + + + + + + + + + + +Router が `GET /v2/models/pixverse/v6/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 + +### 出力 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 指定可能な値: `1`、`5`、`6`、`7`、`8` + + + + + + + + + + +## 例 + +### 入力 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 出力 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + diff --git a/ja/development/comfy-router/models/pruna/p-video-2/code.mdx b/ja/development/comfy-router/models/pruna/p-video-2/code.mdx index 1899c7cdb1..f9decf371f 100644 --- a/ja/development/comfy-router/models/pruna/p-video-2/code.mdx +++ b/ja/development/comfy-router/models/pruna/p-video-2/code.mdx @@ -2,16 +2,17 @@ title: "P Video 2 を Comfy Router で使用する" description: "pruna/p-video-2 を Comfy Router 経由で呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "P Video 2" -translationSourceHash: adc4bb77 +translationSourceHash: b7aa4ce2 translationFrom: development/comfy-router/models/pruna/p-video-2/code.mdx translationBlockHashes: "_intro": 7b513d6b "Quick start": 9d47988e - "Schema": 51d0cc63 + "Schema": 4bd9bf87 "Examples": 0d85c9fe --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/pruna/p-video-2.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -176,7 +177,7 @@ curl https://api.comfy.org/v2/models/pruna/p-video-2/requests/$REQUEST_ID \ ### 入力 - P-Video-2 の生成パラメータ。生成は完成したビデオの秒数に応じて課金され、返却されたファイルを基準に、`resolution` と `draft` で決まるレートで計算されます。セーフティフィルタは常に有効で、リクエスト内の `disable_safety_filter` の値は無視されます。 + P-Video-2 の生成パラメータ。課金は完成したビデオの秒単位で行われ、返却されたファイルを基準に計測され、レートは `resolution` と `draft` によって決まります。セーフティフィルタは常に有効で、リクエスト内の `disable_safety_filter` の値は無視されます。 @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/pruna/p-video-2/requests/$REQUEST_ID \ - 生成を条件付ける入力オーディオの URI(flac、mp3 または wav)。出力の長さはオーディオに従います。 + 生成の条件付けに使用する入力オーディオの URI(flac、mp3 または wav)。出力の長さはオーディオに従います。 @@ -202,7 +203,7 @@ curl https://api.comfy.org/v2/models/pruna/p-video-2/requests/$REQUEST_ID \ - 画像から動画へ生成するための入力画像の URI(jpg、jpeg、png または webp)。 + 画像から動画への生成に使用する入力画像の URI(jpg、jpeg、png または webp)。 @@ -245,6 +246,34 @@ curl https://api.comfy.org/v2/models/pruna/p-video-2/requests/$REQUEST_ID \ 人間が読める進捗メッセージ。 + + Pruna のセーフティチェッカーによる判定。コンテンツモデレーションによって予測がブロックされた場合、status が失敗のときに含まれます。 + + + + セーフティチェッカーが予測をブロックしたかどうか。 + + + + そのブロックが、リクエスト側で無効にできるセーフティフィルタに由来するかどうか。 + + + + ブロックの原因となったコンテンツポリシーのカテゴリ(例: sexual)。 + + + + ブロックの内容を人間が読める形でまとめたもの。 + + + + スクリーニングの対象: input(送信されたリクエスト)または output(生成されたビデオ)。 + + + + ブロックの理由を人間が読める形で示したもの。 + + 予測ステータス: starting、processing、succeeded、failed または canceled。 diff --git a/ja/development/comfy-router/models/quiver/arrow-2-telos/code.mdx b/ja/development/comfy-router/models/quiver/arrow-2-telos/code.mdx new file mode 100644 index 0000000000..b7551a5742 --- /dev/null +++ b/ja/development/comfy-router/models/quiver/arrow-2-telos/code.mdx @@ -0,0 +1,283 @@ +--- +title: "Comfy Router で Arrow 2 Telos を使用する" +description: "Comfy Router 経由で quiver/arrow-2-telos を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "Arrow 2 Telos" +translationSourceHash: 38ec271d +translationFrom: development/comfy-router/models/quiver/arrow-2-telos/code.mdx +translationBlockHashes: + "_intro": 7e87a52d + "Quick start": 63ad01e1 + "Schema": 76a21cd4 + "Examples": 36e915ba +--- +{/* GENERATED FILE. router-schemas/quiver/arrow-2-telos.json から `pnpm code-pages:gen` で生成されたファイルです。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`quiver/arrow-2-telos` の API リファレンスです。Quiver から Comfy Router が提供します。 + +**入力:** テキスト、画像 · **出力:** 画像 + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `quiver/arrow-2-telos` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/quiver/arrow-2-telos` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK はべき等キーを自動的に作成し、自動リトライのために再利用します。 +with Comfy() as client: + result = client.models.run( + "quiver/arrow-2-telos", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK はべき等キーを自動的に作成し、自動リトライのために再利用します。 +const { data } = await comfy.models.run("quiver/arrow-2-telos", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも収集できます。[キューの配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集について説明しています。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# submit() の呼び出しごとに独自の Idempotency-Key を発行し、自動リトライのために再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "quiver/arrow-2-telos", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせれば、別のプロセスに必要なのはこれだけです + + # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の時間だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 + # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// submit() の呼び出しごとに独自の Idempotency-Key を発行し、自動リトライのために再利用します。 +const handle = await comfy.models.submit("quiver/arrow-2-telos", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 送信。Router は 201 とともに request_id、status_url、response_url、cancel_url を返します。 +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" + +# 2. status が COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After の秒数だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集。200 はモデルのネイティブ出力、実行中は 202 とステータスボディを返します。 +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + 追加のスタイルやフォーマットのガイダンス + + + + 出力トークンの最大数 + + 範囲: `1` から `131072` + + + + SVG 生成用のモデル識別子 + + + + 生成する SVG の数 + + 範囲: `1` から `16` + + + + 先行する出力にすでに存在するトークンに対するペナルティ。`arrow-2-telos` では無視されます。このモデルはサンプリングパラメータを受け付けません。フィールドは転送前にリクエストから削除され、エラーにはなりません。 + + 範囲: `-2` から `2` + + + + 生成したい SVG 出力のテキスト記述 + + + + スタイルや構図を導くための任意の参照画像。URL オブジェクト、base64 オブジェクト、または URL 文字列の省略形を受け付けます。実行時の制限はモデルごとに異なります。 + + + + サンプリング温度。`arrow-2-telos` では無視されます。このモデルはサンプリングパラメータを受け付けません。フィールドは転送前にリクエストから削除され、エラーにはなりません。 + + 範囲: `0` から `2` + + + + ニュークリアスサンプリングの確率。`arrow-2-telos` では無視されます。このモデルはサンプリングパラメータを受け付けません。フィールドは転送前にリクエストから削除され、エラーにはなりません。 + + 範囲: `0` から `1` + + +Router が `GET /v2/models/quiver/arrow-2-telos/openapi.json` で提供するスキーマから生成されています。これはリクエストがプロバイダーに到達する前に呼び出しを検証するのと同じドキュメントです。 + +### 出力 + + + 作成時の Unix タイムスタンプ + + + + arrow-1.1 のような固定クレジットモデルのクレジットコスト。arrow-2 のようなトークン課金モデルでは省略され、代わりに usage に計測されたトークン合計が報告されます。 + + 範囲: `0` から `…` + + + + + + + + 出力の MIME タイプ + + 可能な値: `image/svg+xml` + + + + 生の SVG マークアップ + + + + 生成の一意の識別子 + + + + arrow-2 のようなトークン課金モデルのトークン合計。固定クレジットモデルではここに 0 が報告される場合があります。 + + + + トークン課金モデルの入力トークン数。 + + 範囲: `0` から `…` + + + + トークン課金モデルの出力トークン数。 + + 範囲: `0` から `…` + + + + トークン課金モデルのトークン合計。 + + 範囲: `0` から `…` + + +## 例 + +### 入力 + +```json +{ + "n": 1, + "prompt": "A single red maple leaf on a plain white background." +} +``` + +### 出力 + +```json +{ + "created": 1767225600, + "data": [ + { + "mime_type": "image/svg+xml", + "svg": "" + } + ], + "id": "svg_018f2c7a4b1e7c3d9a056e2f8b41d0c9", + "usage": { + "input_tokens": 180, + "output_tokens": 240, + "total_tokens": 420 + } +} +``` + + diff --git a/ja/development/comfy-router/models/quiver/arrow-2/code.mdx b/ja/development/comfy-router/models/quiver/arrow-2/code.mdx new file mode 100644 index 0000000000..76b4e4ec0c --- /dev/null +++ b/ja/development/comfy-router/models/quiver/arrow-2/code.mdx @@ -0,0 +1,283 @@ +--- +title: "Comfy Router で Arrow 2 を使用する" +description: "quiver/arrow-2 を Comfy Router 経由で呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" +sidebarTitle: "Arrow 2" +translationSourceHash: e78a6b9f +translationFrom: development/comfy-router/models/quiver/arrow-2/code.mdx +translationBlockHashes: + "_intro": ef6a6611 + "Quick start": c39331bc + "Schema": d3c8d579 + "Examples": 36e915ba +--- +{/* 生成済みファイル。router-schemas/quiver/arrow-2.json から `pnpm code-pages:gen` によって生成されました。 */} + +import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; + +`quiver/arrow-2` の API リファレンス。Comfy Router が Quiver から提供しています。 + +**入力:** テキスト、画像 · **出力:** 画像 + +## クイックスタート + +[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm install @comfyorg/sdk`)を使用しており、cURL のスニペットは同じ呼び出しを生の HTTP で行うものです。 + +**モデル ID:** `quiver/arrow-2` + +**エンドポイント:** `POST https://api.comfy.org/v2/models/quiver/arrow-2` + + + + +```python Python +from comfy_sdk import Comfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +with Comfy() as client: + result = client.models.run( + "quiver/arrow-2", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// SDK は自動的に冪等性キーを作成し、自動リトライで再利用します。 +const { data } = await comfy.models.run("quiver/arrow-2", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/quiver/arrow-2 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" +``` + + + +同じボディを `POST https://api.comfy.org/v2/models/quiver/arrow-2/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも収集できます。[キューの配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、収集の流れを説明しています。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 環境変数から COMFY_API_KEY を読み取ります。 +# 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライで再利用します。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "quiver/arrow-2", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # モデル ID と合わせれば、別のプロセスに必要なものはこれだけです + + # リクエストが完了するまでポーリングし、サーバーが示す Retry-After の秒数だけ待機します。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。 + # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 環境変数から COMFY_API_KEY を読み取ります。 +// 各 submit() 呼び出しは独自の Idempotency-Key を生成し、自動リトライで再利用します。 +const handle = await comfy.models.submit("quiver/arrow-2", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 送信します。Router は request_id、status_url、response_url、cancel_url とともに 201 を返します。 +curl https://api.comfy.org/v2/models/quiver/arrow-2/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" + +# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが示す Retry-After の秒数だけ待機します。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/quiver/arrow-2/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 収集します。モデルのネイティブ出力とともに 200、まだ実行中はステータスボディとともに 202 を返します。 +curl https://api.comfy.org/v2/models/quiver/arrow-2/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## スキーマ + +### 入力 + + + 追加のスタイルまたは書式設定のガイダンス + + + + 出力トークンの最大数 + + 範囲: `1` から `131072` + + + + SVG 生成用のモデル識別子 + + + + 生成する SVG の数 + + 範囲: `1` から `16` + + + + 以前の出力に既に存在するトークンに対するペナルティ。`arrow-2-telos` では無視されます。これはサンプリングパラメータを受け付けないためです。このフィールドは転送前にリクエストから削除され、エラーは発生しません。 + + 範囲: `-2` から `2` + + + + 希望する SVG 出力のテキスト説明 + + + + スタイルや構図を導くための任意の参照画像。URL オブジェクト、base64 オブジェクト、または URL 文字列の省略形を受け付けます。実行時の制限はモデルごとに異なります。 + + + + サンプリング温度。`arrow-2-telos` では無視されます。これはサンプリングパラメータを受け付けないためです。このフィールドは転送前にリクエストから削除され、エラーは発生しません。 + + 範囲: `0` から `2` + + + + Nucleus サンプリング確率。`arrow-2-telos` では無視されます。これはサンプリングパラメータを受け付けないためです。このフィールドは転送前にリクエストから削除され、エラーは発生しません。 + + 範囲: `0` から `1` + + +Router が `GET /v2/models/quiver/arrow-2/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使われるのと同じドキュメントです。 + +### 出力 + + + 作成の Unix タイムスタンプ + + + + arrow-1.1 のような固定クレジットモデルのクレジットコスト。arrow-2 のようなトークン課金モデルでは省略され、その場合は計測されたトークン合計が usage で報告されます。 + + 範囲: `0` から `…` + + + + + + + + 出力の MIME タイプ + + 可能な値: `image/svg+xml` + + + + 生の SVG マークアップ + + + + 生成の一意の識別子 + + + + arrow-2 のようなトークン課金モデルのトークン合計。固定クレジットモデルではここにゼロが報告される場合があります。 + + + + トークン課金モデルの入力トークン数。 + + 範囲: `0` から `…` + + + + トークン課金モデルの出力トークン数。 + + 範囲: `0` から `…` + + + + トークン課金モデルのトークン合計数。 + + 範囲: `0` から `…` + + +## 例 + +### 入力 + +```json +{ + "n": 1, + "prompt": "A single red maple leaf on a plain white background." +} +``` + +### 出力 + +```json +{ + "created": 1767225600, + "data": [ + { + "mime_type": "image/svg+xml", + "svg": "" + } + ], + "id": "svg_018f2c7a4b1e7c3d9a056e2f8b41d0c9", + "usage": { + "input_tokens": 180, + "output_tokens": 240, + "total_tokens": 420 + } +} +``` + + diff --git a/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx b/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx index 3d6a5e17fd..e64c9b24ef 100644 --- a/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx +++ b/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Veo 3.1 Fast Generate 001 を使う" description: "Comfy Router 経由で veo/veo-3.1-fast-generate-001 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Veo 3.1 Fast Generate 001" -translationSourceHash: f5553980 +translationSourceHash: 436f69a6 translationFrom: development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx translationBlockHashes: "_intro": 2dd8ad2f "Quick start": 4f13f7f7 - "Schema": e44aea6d + "Schema": 2b639366 "Examples": 88e27039 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/veo/veo-3.1-fast-generate-001.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -337,7 +338,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ - プロンプトを自動的に改善して品質を高めます。デフォルトは true。 + プロンプトを自動的に改善して品質を高めます。デフォルトは true です。 @@ -345,17 +346,18 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ - ビデオと一緒にオーディオを生成するかどうか。デフォルトは true。Veo 3.0 以降のモデルでサポートされています。 + ビデオと一緒にオーディオを生成するかどうか。デフォルトは true です。Veo 3.0 以降のモデルでサポートされています。 - 生成されるビデオで避けるべき内容を記述したテキスト + 生成されるビデオで避けるべき内容を説明するテキスト - 生成されるビデオ内の人物を制御します。デフォルト: allow_adult + 生成されるビデオに登場する人物を制御します。デフォルト: allow_adult。 +`ALLOW` と `BLOCK` も受け付けられます。これは Veo2GenVidRequest の personGeneration enum がこれらを持っているのと同じ互換性上の理由によるものです(そのコンポーネントの注記を参照)。ComfyUI の Veo 3 パートナーノード(comfy_api_nodes/nodes_veo2.py)は、veo-3.1-generate-001、veo-3.1-fast-generate-001、veo-3.1-lite-generate-001 に対して `/proxy/veo/{model}/generate` へ、常にこれら2つの綴りのいずれかを送信し、Vertex 自身の綴りを送ることはありません。これら3つの ID は、このコンポーネントが Router の入力スキーマとなっているものです。これらの ID のいずれかに対する Router のディスパッチ(`model_provider=veo`)では、同期でもキュー中でも(`/v2/models/veo/{model}/requests`)、リクエストが Vertex に到達する前に `ALLOW` は `allow_adult` に、`BLOCK` は `dont_allow` にマッピングされます(routerVeoMapPersonGeneration、server/middleware/router_veo_person_generation.go)。これは Vertex 自身がどちらの綴りも受け付けないためです。直接の v1 `/proxy/veo/:modelId/generate` 呼び出し元はどちらでも影響を受けません。comfy-api は `/proxy/*` にリクエストバリデータをインストールしないため、この enum はそこではもともと強制されないドキュメントであり、Router 専用のマッピングもそこでは実行されません。 - 指定可能な値: `dont_allow`、`allow_adult`、`allowAll` + 指定可能な値: `dont_allow`、`allow_adult`、`allowAll`、`ALLOW`、`BLOCK` diff --git a/ja/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx b/ja/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx index 220e0ccd26..c4c02a1d1a 100644 --- a/ja/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx +++ b/ja/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router で Veo 3.1 Generate 001 を使う" description: "Comfy Router 経由で veo/veo-3.1-generate-001 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Veo 3.1 Generate 001" -translationSourceHash: 0fab4eef +translationSourceHash: 9721a315 translationFrom: development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx translationBlockHashes: "_intro": cba04c2d "Quick start": cd500ec3 - "Schema": 5618a5b3 + "Schema": afe36175 "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -337,7 +338,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - プロンプトを自動的に改善して品質を高めます。デフォルト: true。 + 高品質化のためにプロンプトを自動的に改善します。デフォルトは true です。 @@ -345,17 +346,18 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - ビデオと一緒にオーディオを生成するかどうか。デフォルト: true。Veo 3.0 以降のモデルでサポートされています。 + ビデオと一緒にオーディオを生成するかどうか。デフォルトは true です。Veo 3.0 以降のモデルでサポートされています。 - 生成されるビデオで避けるべき内容を説明するテキスト + 生成されるビデオで避けるべき内容を記述したテキスト - 生成されるビデオに登場する人物を制御します。デフォルト: allow_adult + 生成されるビデオに登場する人物を制御します。デフォルト: allow_adult。 +互換性の理由から `ALLOW` と `BLOCK` も受け付けられます。これは Veo2GenVidRequest の personGeneration enum がこれらを保持しているのと同じ理由です(そのコンポーネントの注記を参照)。ComfyUI の Veo 3 パートナーノード(comfy_api_nodes/nodes_veo2.py)は、veo-3.1-generate-001、veo-3.1-fast-generate-001、veo-3.1-lite-generate-001 に対して `/proxy/veo/{model}/generate` へ常にこの 2 つの綴りのいずれかを送信し、Vertex 自身の綴りを送ることはありません。この 3 つの ID が、このコンポーネントが Router の入力スキーマとなる対象です。これらの ID のいずれかに対する Router のディスパッチ(`model_provider=veo`)では、同期でもキュー中(`/v2/models/veo/{model}/requests`)でも、リクエストが Vertex に到達する前に `ALLOW` は `allow_adult` に、`BLOCK` は `dont_allow` にマッピングされます(routerVeoMapPersonGeneration、server/middleware/router_veo_person_generation.go)。Vertex 自身はどちらの綴りも受け付けないためです。v1 の `/proxy/veo/:modelId/generate` を直接呼び出す場合はどちらでも影響を受けません。comfy-api は `/proxy/*` にリクエストバリデータをインストールしないため、この enum はそこではもともと強制されないドキュメントであり、Router 専用のマッピングも実行されません。 - 指定可能な値: `dont_allow`、`allow_adult`、`allowAll` + 指定可能な値: `dont_allow`、`allow_adult`、`allowAll`、`ALLOW`、`BLOCK` diff --git a/ja/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx b/ja/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx index 4008756ed4..ea7dd737e7 100644 --- a/ja/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx +++ b/ja/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router で Veo 3.1 Lite Generate 001 を使用する" description: "Comfy Router 経由で veo/veo-3.1-lite-generate-001 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Veo 3.1 Lite Generate 001" -translationSourceHash: 6526c1c6 +translationSourceHash: 8ad7346c translationFrom: development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx translationBlockHashes: "_intro": 8110da35 "Quick start": 7f826038 - "Schema": 647d02c5 + "Schema": 25c8331a "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-lite-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -290,7 +291,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 参照画像のタイプ + 参照画像の種類 取り得る値: `asset`, `style` @@ -339,12 +340,13 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ より高品質にするためにプロンプトを自動的に改善します。デフォルトは true です。 + - 生成されるビデオのフレームレート (1 秒あたりのフレーム数) + 生成されるビデオのフレームレート(1 秒あたりのフレーム数) - ビデオとともにオーディオを生成するかどうか。デフォルトは true です。Veo 3.0+ モデルでサポートされています。 + ビデオと一緒にオーディオを生成するかどうか。デフォルトは true。Veo 3.0+ モデルでサポートされています。 @@ -352,9 +354,10 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 生成されるビデオに登場する人物を制御します。デフォルト: allow_adult + 生成されるビデオ内の人物を制御します。デフォルト: allow_adult。 +`ALLOW` と `BLOCK` も受け付けられます。これは Veo2GenVidRequest の personGeneration enum がこれらを保持しているのと同じ互換性の理由によるものです(そのコンポーネントの注記を参照)。ComfyUI の Veo 3 パートナーノード(comfy_api_nodes/nodes_veo2.py)は、veo-3.1-generate-001、veo-3.1-fast-generate-001、veo-3.1-lite-generate-001 に対して `/proxy/veo/{model}/generate` へ、常にこの 2 つの綴りのいずれかを送信し、Vertex 自身の綴りを送ることはありません。これら 3 つの ID が、このコンポーネントが Router 入力スキーマとなる対象です。これらの ID のいずれかに対する Router ディスパッチ(`model_provider=veo`)では、同期でもキュー中でも(`/v2/models/veo/{model}/requests`)、リクエストが Vertex に到達する前に `ALLOW` は `allow_adult` に、`BLOCK` は `dont_allow` にマッピングされます(routerVeoMapPersonGeneration、server/middleware/router_veo_person_generation.go)。これは Vertex 自身がどちらの綴りも受け付けないためです。v1 の `/proxy/veo/:modelId/generate` を直接呼び出す場合はどちらでも影響を受けません。comfy-api は `/proxy/*` にリクエストバリデーターをインストールしないため、この enum はそこではもともと強制されないドキュメントであり、Router 専用のマッピングもその呼び出しでは実行されません。 - 取り得る値: `dont_allow`, `allow_adult`, `allowAll` + 取り得る値: `dont_allow`, `allow_adult`, `allowAll`, `ALLOW`, `BLOCK` @@ -387,13 +390,13 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ 生成されたビデオの保存先となる省略可能な Cloud Storage の場所(`gs://` URI)。 -自分自身のバケットを指定する必要があります。bring-your-own-key 以外では、このルートは自分のものではなく Comfy 自身の Google Cloud 認証情報で実行されるため、Comfy が所有するバケット内の保存先は、Comfy のサービスアカウントが共有レイアウトに実行し、Comfy のプロジェクトに課金される書き込みになります。そのような値を指定したリクエストは 400 で拒否され、何も生成されません。例外は 1 つだけで、プラットフォームストレージが有効な同期 Comfy Router 呼び出し(`POST /v2/models/{provider}/{model}`)です。この場合、Router 自身の Veo または Gemini アセットバケットを指す値は、その呼び出しのために Router が自分のプラットフォームプレフィックス配下で発行する保存先に置き換えられ、その Router が発行した正確な保存先だけが通されます。キューに入れた Router 送信(`POST /v2/models/{provider}/{model}/requests`)ではそのような置き換えは行われないため、他の Comfy 所有バケットと同様にその値を 400 で拒否します。それ以外の保存先は変更されずに Vertex へ転送され、アクセス権の付与は自分の責任です。bring-your-own-key の呼び出しは自分のプロジェクトで実行され、送信されたまま転送されます。 +自分自身のバケットを指定する必要があります。bring-your-own-key 以外では、このルートは自分のものではなく Comfy 自身の Google Cloud 認証情報で実行されるため、Comfy が所有するバケット内の保存先は、Comfy のサービスアカウントが共有レイアウトに対して実行し、Comfy のプロジェクトに課金される書き込みになります。そのような値を指定したリクエストは 400 で拒否され、何も生成されません。例外は 1 つだけで、プラットフォームストレージが有効な同期 Comfy Router 呼び出し(`POST /v2/models/{provider}/{model}`)です。この場合、Router 自身の Veo または Gemini アセットバケットを指す値は、その呼び出しのために Router が自分のプラットフォームプレフィックス配下で発行する保存先に置き換えられ、その Router が発行した正確な保存先だけが通されます。キュー中の Router 送信(`POST /v2/models/{provider}/{model}/requests`)ではそのような置き換えは行われないため、他の Comfy 所有バケットと同様にその値を 400 で拒否します。それ以外の保存先は変更されずに Vertex へ転送され、アクセス権の付与は自分の責任です。bring-your-own-key の呼び出しは自分のプロジェクトで実行され、送信されたまま転送されます。 ビデオ生成リクエストの操作タイプ - 指定可能な値: `textToVideo`、`imageToVideo`、`referenceToVideo`、`edit`、`extend`、`upscale` + 取り得る値: `textToVideo`, `imageToVideo`, `referenceToVideo`, `edit`, `extend`, `upscale` Router が `GET /v2/models/veo/veo-3.1-lite-generate-001/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 diff --git a/ja/development/comfy-router/pricing.mdx b/ja/development/comfy-router/pricing.mdx index 4c771e7ab4..76c48ab09e 100644 --- a/ja/development/comfy-router/pricing.mdx +++ b/ja/development/comfy-router/pricing.mdx @@ -148,10 +148,10 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | 名前 | モデル ID | オプション | クレジット | | --- | --- | --- | ---: | -| [Arrow 2](/ja/development/comfy-router/models) | `quiver/arrow-2` | 入力 | 1206.92 / 1M トークン | -| [Arrow 2](/ja/development/comfy-router/models) | `quiver/arrow-2` | 出力 | 6034.6 / 1M トークン | -| [Arrow 2 Telos](/ja/development/comfy-router/models) | `quiver/arrow-2-telos` | 入力 | 1810.38 / 1M トークン | -| [Arrow 2 Telos](/ja/development/comfy-router/models) | `quiver/arrow-2-telos` | 出力 | 9051.9 / 1M トークン | +| [Arrow 2](/ja/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 入力 | 1206.92 / 1M トークン | +| [Arrow 2](/ja/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 出力 | 6034.6 / 1M トークン | +| [Arrow 2 Telos](/ja/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 入力 | 1810.38 / 1M トークン | +| [Arrow 2 Telos](/ja/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 出力 | 9051.9 / 1M トークン | #### 未公開 @@ -441,17 +441,17 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | --- | --- | --- | ---: | | [Aleph 2](/ja/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | 84.4844 / s | | [Gen 4 Turbo](/ja/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | 15.0865 / s | -| [LTX Video Alpha Gen](/ja/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1080p | 30.173 / s | -| [LTX Video Alpha Gen](/ja/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1440p | 75.4325 / s | -| [LTX Video Alpha Gen](/ja/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 2160p | 301.73 / s | -| [LTX Video To Video Hdr](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1080p | 120.692 / s | -| [LTX Video To Video Hdr](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1440p | 241.384 / s | -| [LTX Video To Video Hdr](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 2160p | 482.768 / s | -| [LTX Video To Video Reframe](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 720p | 30.173 / s | -| [LTX Video To Video Reframe](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 1080p | 60.346 / s | -| [LTX Video Upscale](/ja/development/comfy-router/models) | `ltx/ltx-video-upscale` | 1080p | 24.1384 / s | -| [LTX Video Upscale](/ja/development/comfy-router/models) | `ltx/ltx-video-upscale` | 4K | 90.519 / s | -| [LTX Video Upscale](/ja/development/comfy-router/models) | `ltx/ltx-video-upscale` | 8K | 362.076 / s | +| [LTX Video Alpha Gen](/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1080p | 30.173 / s | +| [LTX Video Alpha Gen](/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1440p | 75.4325 / s | +| [LTX Video Alpha Gen](/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 2160p | 301.73 / s | +| [LTX Video To Video Hdr](/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1080p | 120.692 / s | +| [LTX Video To Video Hdr](/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1440p | 241.384 / s | +| [LTX Video To Video Hdr](/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 2160p | 482.768 / s | +| [LTX Video To Video Reframe](/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 720p | 30.173 / s | +| [LTX Video To Video Reframe](/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 1080p | 60.346 / s | +| [LTX Video Upscale](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 1080p | 24.1384 / s | +| [LTX Video Upscale](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 4K | 90.519 / s | +| [LTX Video Upscale](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 8K | 362.076 / s | | [Pika H3 Flex Image To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | 3.0173 / s | | [Pika H3 Flex Image To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | 6.0346 / s | | [Pika H3 Flex Image To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | 10.56055 / s | @@ -519,9 +519,9 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | 名前 | モデル ID | クレジット | | --- | --- | ---: | -| [V3.5](/ja/development/comfy-router/models) | `pixverse/v3.5` | 3.0173 / PixVerse クレジット | -| [V6](/ja/development/comfy-router/models) | `pixverse/v6` | 1.025882 / PixVerse クレジット | -| [V6 Max](/ja/development/comfy-router/models) | `pixverse/v6-max` | 1.34102316 / PixVerse クレジット | +| [V3.5](/ja/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | 3.0173 / PixVerse クレジット | +| [V6](/ja/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | 1.025882 / PixVerse クレジット | +| [V6 Max](/ja/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | 1.34102316 / PixVerse クレジット | #### リクエストあたりの料金 @@ -676,9 +676,9 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | [Claude Sonnet 5](/ja/development/comfy-router/models/anthropic/claude-sonnet-5/code) | `anthropic/claude-sonnet-5` | 読み取り: 60.346
書き込み(1 時間): 1206.92
書き込み(5 分): 754.325 | テキスト: 603.46 | テキスト: 3017.3 | | [Claude Sonnet 4.6](/ja/development/comfy-router/models/anthropic/claude-sonnet-4-6/code) | `anthropic/claude-sonnet-4-6` | 読み取り: 63.3
書き込み(1 時間): 1266
書き込み(5 分): 791.25 | テキスト: 633 | テキスト: 3165 | | [Claude Sonnet 4.5](/ja/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code) | `anthropic/claude-sonnet-4-5-20250929` | 読み取り: 63.3
書き込み(1 時間): 1266
書き込み(5 分): 791.25 | テキスト: 633 | テキスト: 3165 | -| [Gemini 4 Argon](/ja/development/comfy-router/models) | `vertexai/gemini-4-argon` | - | 音声 / 画像 / テキスト / 動画: 1206.92 | テキスト / 推論: 6034.6 | -| [Gemini 4 Carbon](/ja/development/comfy-router/models) | `vertexai/gemini-4-carbon` | - | 音声 / 画像 / テキスト / 動画: 1206.92 | テキスト / 推論: 6034.6 | -| [Gemini 4 Hydrogen](/ja/development/comfy-router/models) | `vertexai/gemini-4-hydrogen` | - | 音声 / 画像 / テキスト / 動画: 452.595 | テキスト / 推論: 2262.975 | +| [Gemini 4 Argon](/ja/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | - | 音声 / 画像 / テキスト / 動画: 1206.92 | テキスト / 推論: 6034.6 | +| [Gemini 4 Carbon](/ja/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | - | 音声 / 画像 / テキスト / 動画: 1206.92 | テキスト / 推論: 6034.6 | +| [Gemini 4 Hydrogen](/ja/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | - | 音声 / 画像 / テキスト / 動画: 452.595 | テキスト / 推論: 2262.975 | | [Gemini 3.8 Flash](/ja/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | 音声 / 画像 / テキスト / 動画: 452.595 | テキスト / 推論: 2262.975 | | [Gemini 3.7 Flash](/ja/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | 音声 / 画像 / テキスト / 動画: 452.595 | テキスト / 推論: 2262.975 | | [Gemini 3.1 Flash Lite](/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | 画像 / テキスト / 動画: 52.75
音声: 105.5 | テキスト / 推論: 316.5 | @@ -933,10 +933,10 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | 名前 | モデル ID | オプション | USD | | --- | --- | --- | ---: | -| [Arrow 2](/ja/development/comfy-router/models) | `quiver/arrow-2` | 入力 | $5.72 / 1M トークン | -| [Arrow 2](/ja/development/comfy-router/models) | `quiver/arrow-2` | 出力 | $28.60 / 1M トークン | -| [Arrow 2 Telos](/ja/development/comfy-router/models) | `quiver/arrow-2-telos` | 入力 | $8.58 / 1M トークン | -| [Arrow 2 Telos](/ja/development/comfy-router/models) | `quiver/arrow-2-telos` | 出力 | $42.90 / 1M トークン | +| [Arrow 2](/ja/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 入力 | $5.72 / 1M トークン | +| [Arrow 2](/ja/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 出力 | $28.60 / 1M トークン | +| [Arrow 2 Telos](/ja/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 入力 | $8.58 / 1M トークン | +| [Arrow 2 Telos](/ja/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 出力 | $42.90 / 1M トークン | #### 未公開 @@ -1226,17 +1226,17 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | --- | --- | --- | ---: | | [Aleph 2](/ja/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | $0.4004 / s | | [Gen 4 Turbo](/ja/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | $0.0715 / s | -| [LTX Video Alpha Gen](/ja/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1080p | $0.143 / s | -| [LTX Video Alpha Gen](/ja/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1440p | $0.3575 / s | -| [LTX Video Alpha Gen](/ja/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 2160p | $1.43 / s | -| [LTX Video To Video Hdr](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1080p | $0.572 / s | -| [LTX Video To Video Hdr](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1440p | $1.144 / s | -| [LTX Video To Video Hdr](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 2160p | $2.288 / s | -| [LTX Video To Video Reframe](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 720p | $0.143 / s | -| [LTX Video To Video Reframe](/ja/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 1080p | $0.286 / s | -| [LTX Video Upscale](/ja/development/comfy-router/models) | `ltx/ltx-video-upscale` | 1080p | $0.1144 / s | -| [LTX Video Upscale](/ja/development/comfy-router/models) | `ltx/ltx-video-upscale` | 4K | $0.429 / s | -| [LTX Video Upscale](/ja/development/comfy-router/models) | `ltx/ltx-video-upscale` | 8K | $1.716 / s | +| [LTX Video Alpha Gen](/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1080p | $0.143 / s | +| [LTX Video Alpha Gen](/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1440p | $0.3575 / s | +| [LTX Video Alpha Gen](/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 2160p | $1.43 / s | +| [LTX Video To Video Hdr](/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1080p | $0.572 / s | +| [LTX Video To Video Hdr](/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1440p | $1.144 / s | +| [LTX Video To Video Hdr](/ja/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 2160p | $2.288 / s | +| [LTX Video To Video Reframe](/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 720p | $0.143 / s | +| [LTX Video To Video Reframe](/ja/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 1080p | $0.286 / s | +| [LTX Video Upscale](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 1080p | $0.1144 / s | +| [LTX Video Upscale](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 4K | $0.429 / s | +| [LTX Video Upscale](/ja/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 8K | $1.716 / s | | [Pika H3 Flex Image To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | $0.0143 / s | | [Pika H3 Flex Image To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | $0.0286 / s | | [Pika H3 Flex Image To Video](/ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | $0.05005 / s | @@ -1304,9 +1304,9 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | 名前 | モデル ID | USD | | --- | --- | ---: | -| [V3.5](/ja/development/comfy-router/models) | `pixverse/v3.5` | $0.0143 / PixVerse クレジット | -| [V6](/ja/development/comfy-router/models) | `pixverse/v6` | $0.004862 / PixVerse クレジット | -| [V6 Max](/ja/development/comfy-router/models) | `pixverse/v6-max` | $0.00635556 / PixVerse クレジット | +| [V3.5](/ja/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | $0.0143 / PixVerse クレジット | +| [V6](/ja/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | $0.004862 / PixVerse クレジット | +| [V6 Max](/ja/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | $0.00635556 / PixVerse クレジット | #### リクエストあたりの料金 @@ -1461,9 +1461,9 @@ Ray 3.2 の EXR エクスポートはまだ利用できません。HDR リクエ | [Claude Sonnet 5](/ja/development/comfy-router/models/anthropic/claude-sonnet-5/code) | `anthropic/claude-sonnet-5` | 読み取り: $0.286
書き込み(1 時間): $5.72
書き込み(5 分): $3.575 | テキスト: $2.86 | テキスト: $14.30 | | [Claude Sonnet 4.6](/ja/development/comfy-router/models/anthropic/claude-sonnet-4-6/code) | `anthropic/claude-sonnet-4-6` | 読み取り: $0.30
書き込み(1 時間): $6.00
書き込み(5 分): $3.75 | テキスト: $3.00 | テキスト: $15.00 | | [Claude Sonnet 4.5](/ja/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code) | `anthropic/claude-sonnet-4-5-20250929` | 読み取り: $0.30
書き込み(1 時間): $6.00
書き込み(5 分): $3.75 | テキスト: $3.00 | テキスト: $15.00 | -| [Gemini 4 Argon](/ja/development/comfy-router/models) | `vertexai/gemini-4-argon` | - | 音声 / 画像 / テキスト / 動画: $5.72 | テキスト / 推論: $28.60 | -| [Gemini 4 Carbon](/ja/development/comfy-router/models) | `vertexai/gemini-4-carbon` | - | 音声 / 画像 / テキスト / 動画: $5.72 | テキスト / 推論: $28.60 | -| [Gemini 4 Hydrogen](/ja/development/comfy-router/models) | `vertexai/gemini-4-hydrogen` | - | 音声 / 画像 / テキスト / 動画: $2.145 | テキスト / 推論: $10.725 | +| [Gemini 4 Argon](/ja/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | - | 音声 / 画像 / テキスト / 動画: $5.72 | テキスト / 推論: $28.60 | +| [Gemini 4 Carbon](/ja/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | - | 音声 / 画像 / テキスト / 動画: $5.72 | テキスト / 推論: $28.60 | +| [Gemini 4 Hydrogen](/ja/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | - | 音声 / 画像 / テキスト / 動画: $2.145 | テキスト / 推論: $10.725 | | [Gemini 3.8 Flash](/ja/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | 音声 / 画像 / テキスト / 動画: $2.145 | テキスト / 推論: $10.725 | | [Gemini 3.7 Flash](/ja/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | 音声 / 画像 / テキスト / 動画: $2.145 | テキスト / 推論: $10.725 | | [Gemini 3.1 Flash Lite](/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | 画像 / テキスト / 動画: $0.25
音声: $0.50 | テキスト / 推論: $1.50 | diff --git a/ja/development/comfy-router/quickstart.mdx b/ja/development/comfy-router/quickstart.mdx index 06c17dfddf..af8e99a0ff 100644 --- a/ja/development/comfy-router/quickstart.mdx +++ b/ja/development/comfy-router/quickstart.mdx @@ -2,14 +2,15 @@ title: "Comfy Router クイックスタート" sidebarTitle: "クイックスタート" description: "最新のフロンティアメディアモデルを使って、数分で画像とビデオを生成します。" -translationSourceHash: ea087f5c +translationSourceHash: ea722f9a translationFrom: development/comfy-router/quickstart.mdx translationBlockHashes: "_intro": 201b5b50 - "Image-to-video and reference-to-video": 8ac90191 + "Image-to-video and reference-to-video": e7a93779 "Next steps": ed466781 --- +
Comfy Router は、`https://api.comfy.org` でホスト型の画像モデルとビデオモデルを利用するための単一の API を提供します。[Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)で API キーを作成し、公式の [Python および TypeScript SDK](/ja/development/api-development/sdks) か、通常の HTTP 経由で任意のモデルを呼び出せます。課金は従量制です。デフォルトでは、各リクエストがワークスペースの残高からクレジットを消費し、サブスクリプションはありません。料金とその他の課金オプションについては、[Router の料金](/ja/development/comfy-router/pricing)を参照してください。 @@ -172,6 +173,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"}, {"type": "image_url", "image_url": {"url": "https://example.com/outfit.png"}, "role": "reference_image"} ], + "omni_reference_task_type": "reference", "duration": 5, "ratio": "16:9", "resolution": "720p" @@ -180,6 +182,28 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque Seedance 2.5 では、最初のフレームと最初と最後のフレームのリクエストは、出力のアスペクト比を最初のフレームから取得します。具体的な比率は `400` で拒否されるため、`ratio` を省略するか `adaptive` を送信してください。リクエストスキーマは Seedance ファミリーで共有されており、モデルが無視する role が含まれることがあるため、各モデルの[入力スキーマ](/ja/development/comfy-router/models) の `x-comfy-router-input-modalities` フィールドで、そのモデルが受け付ける入力種別を確認してください。たとえば、`reference_video` と `reference_audio` には、そこで `video` または `audio` を列挙しているモデルが必要です。 +### 参照ビデオを編集または延長する + +Seedance 2.5 では、`omni_reference_task_type` が参照メディアをどう扱うかをモデルに指示します。`reference` はそれをガイドとして新しいビデオを作成し、`edit` は `reference_video` クリップを変更し、`extend` はそのクリップを延長します。フィールドがない場合、モデルはプロンプトからタスクを選択します。また、編集はクリップ自体の長さとアスペクト比を維持し、`duration` と `ratio` を無視します。BytePlus のネイティブ経路では、リクエストに適合しない明示的な値は生成開始前に拒否されるため、課金されません。フォールバック時に使用されるか、`model_provider` で選択される代替プロバイダー経路には、タスク種別フィールドがありません。その経路は値を破棄し、フィールドが省略された場合と同様に、そのプロバイダーにタスクを推測させます。この破棄は、同期実行ルートのレスポンスと、キューへの送信の `201` で、`X-Comfy-Router-Dropped-Params` によって通知されます。キュー経由のルートにはフォールバックがないため、代替経路に到達するのは `model_provider` を介する場合だけです。 + +```bash Edit a reference video +curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d '{ + "content": [ + {"type": "text", "text": "Make the fox bright red"}, + {"type": "video_url", "video_url": {"url": "https://example.com/fox.mp4"}, "role": "reference_video"} + ], + "omni_reference_task_type": "edit", + "duration": -1, + "resolution": "720p" + }' +``` + +編集はソースクリップの長さを維持するため、`"duration": -1` を送信し、`ratio` を省略してください。`extend` リクエストは、送信した `duration` の長さで、新しく生成されたセグメントのみを返します。 + ## 次のステップ diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index c93c86a5ec..3acae39963 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -2,11 +2,11 @@ title: "Comfy Router API リファレンス" description: "Comfy API 契約から生成済みの、Comfy Router のすべてのエンドポイント、パラメータ、レスポンスボディ、エラーバケット。" sidebarTitle: "API リファレンス" -translationSourceHash: e8d9375f +translationSourceHash: 64fd0a10 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": e6679d4b + "Endpoints": 5e27b6a1 "Error buckets": 02a09cb4 "Response headers": 3ac389bd "Pre-flight cost estimates": 7405db0d @@ -31,6 +31,8 @@ translationBlockHashes: + + {/* 生成済みファイル: 手動で編集しないでください。 @@ -62,11 +64,11 @@ Comfy API キーは Bearer トークンとして送信することもできま 不透明なページネーションカーソル。 - 型: [`RouterPageCursor`](#routerpagecursor):`next_cursor` として返される不透明なカーソル、1~512 文字 + 型: [`RouterPageCursor`](#routerpagecursor)。`next_cursor` として返される不透明なカーソルで、1〜512 文字です。 - 1 ページで返すモデル数。 + 1 ページで返すモデルの数。 最大 100、デフォルト: 20 @@ -80,63 +82,63 @@ Comfy API キーは Bearer トークンとして送信することもできま OK - モデルカタログの 1 ページ。 - ボディ: [`RouterModelListResponse`](#routermodellistresponse)、ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 本文: [`RouterModelListResponse`](#routermodellistresponse)。ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` - Not Modified - 呼び出し元が `If-None-Match` で送信した `ETag` 以降、ページは変更されていません。 + Not Modified - `If-None-Match` で呼び出し元が送信した `ETag` 以降、ページは変更されていません。 ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` - 無効なリクエストです。エラータイプとリクエストボディを確認してください。 + 無効なリクエストです。エラータイプとリクエスト本文を確認してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` 認証情報が不足しているか無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` この呼び出し元またはモデルでは、このリクエストは許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`: 呼び出し元のリクエスト許容量を使い切っています。次にリクエストを送る前に `Retry-After` 秒待ってください。 + `rate_limited`: 呼び出し元ごとのリクエスト許可数を使い切っています。次のリクエストを送信する前に `Retry-After` を待ってください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` Router は一時的に利用できません。バックオフして再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}` -**正規のモデル ID で 1 つのパートナーモデルのカタログエントリを取得します。** +**正規のモデルIDで、1つのパートナーモデルのカタログエントリを読み取ります。** -カタログ全体を一覧せずに、1 つのモデルの詳細を取得します。 +カタログ全体を一覧表示せずに、1つのモデルの詳細を読み取ります。 **パラメータ** - 正規の `{provider}/{model}` モデル ID のプロバイダー部分。 + 正規の `{provider}/{model}` モデルIDのプロバイダー部分。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大64文字 - 正規の `{provider}/{model}` モデル ID のモデル部分。 + 正規の `{provider}/{model}` モデルIDのモデル部分。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字 @@ -148,35 +150,35 @@ Comfy API キーは Bearer トークンとして送信することもできま OK - モデルのカタログエントリ。 - ボディ: [`RouterModelDetail`](#routermodeldetail) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` + ボディ: [`RouterModelDetail`](#routermodeldetail) -- ヘッダー: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Not Modified - `If-None-Match` で呼び出し元が送信した `ETag` 以降、エントリは変更されていません。 + Not Modified - 呼び出し元が `If-None-Match` で送信した `ETag` 以降、エントリは変更されていません。 - ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` + ヘッダー: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` 認証情報が不足しているか無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - この呼び出し元またはモデルでは、このリクエストは許可されていません。 + このリクエストは、この呼び出し元またはモデルに対して許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - モデル ID が見つかりませんでした。 + モデルIDが見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `rate_limited`: 呼び出し元のリクエスト許容量を使い切っています。次にリクエストを送る前に `Retry-After` 秒待ってください。 + `rate_limited`: 呼び出し元ごとのリクエスト許容量を使い果たしました。次のリクエストを送信する前に `Retry-After` を待ってください。 ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` @@ -184,9 +186,8 @@ Comfy API キーは Bearer トークンとして送信することもできま Router は一時的に利用できません。バックオフして再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - ### `POST /v2/models/{provider}/{model}` **正規のモデル ID を指定してパートナーモデルを同期的に実行します。** @@ -208,27 +209,27 @@ Comfy API キーは Bearer トークンとして送信することもできま - 呼び出し元が生成するキーで、1 つの論理的な呼び出しの再試行を安全にします。 + 呼び出し側が生成するキーで、1 つの論理的な呼び出しを安全に再試行できるようにします。 1〜255 文字 - このモデルを現在のデフォルトの代わりに処理する代替プロバイダーを選択します。`fal`、`wavespeed`、`runware`、`higgsfield` が代替プロバイダーであり、`GET /v2/models/{provider}/{model}` は、あるモデルがそのうちどれをサポートしているかを報告します。拒否は固定された順序でチェックされ、前段のチェックは後段のチェックの結果に関係なく応答します。未認識の値、つまり登録済みプロバイダーでないものは `400` で拒否されます。次に、ボディがマルチパート操作(編集)を選択するリクエストで代替プロバイダーを指定した場合、`detail` が「this request's `image` selects the edit operation」で始まる `409` で拒否されます。ただし、そのプロバイダーのこのモデル用トランスレーターがその操作を処理できない場合に限ります。メディアを扱えるトランスレーターを持つレッグは通常どおり処理されます。次に、bring-your-own-key 認証情報が解決されたリクエストでは、そのプロバイダーがこのモデルを処理するかどうかに関係なく、代替プロバイダーは `detail` が `this request resolved a BYOK credential` で始まる `409` で拒否されます(そのレスポンスを参照)。次に、指定されたプロバイダー自身のゲートがあり、そのプロバイダーがあなたに対して有効化されていない場合は `error_type: not_enabled` を伴う `403` で、ゲートを評価できない場合は `error_type: service_unavailable` を伴う `503` で拒否します。そして、これら 4 つすべてを通過した後にのみ、このモデル用のレッグを持たない実在のプロバイダーが `error_type: invalid_input` を伴う `400` で拒否されます。これは未認識の値と同じ応答です。`fallback_provider` は、bring-your-own-key リクエスト、ボディがマルチパート操作を選択するリクエスト、および `strict_mode=true` の場合には、拒否されるのではなく無効になります。 + このモデルを現在のデフォルトの代わりに提供する代替プロバイダーを選択します。代替プロバイダーは `fal`、`wavespeed`、`runware`、`higgsfield` で、`GET /v2/models/{provider}/{model}` はあるモデルがそれらのどれをサポートしているかを報告します。拒否は固定の順序でチェックされ、先のものは後のものが該当するかどうかに関係なく応答します: 認識されない値(そもそも登録済みプロバイダーではないもの)は `400` で拒否されます。次に、ボディがマルチパート操作(編集)を選択するリクエストで代替プロバイダーを指定すると、`detail` が "this request's `image` selects the edit operation" で始まる `409` で拒否されますが、それはそのプロバイダーのこのモデル用トランスレーターがその操作を処理できない場合に限られます。トランスレーターがメディアを扱えるレッグは通常どおり処理されます。次に、BYOK(bring-your-own-key)認証情報が解決されたリクエストで任意の代替プロバイダーを指定すると、そのプロバイダーがこのモデルを提供するかどうかに関係なく、`detail` が `this request resolved a BYOK credential` で始まる `409` で拒否されます(そのレスポンスを参照)。次に、指定されたプロバイダー自身のゲートがあり、そのプロバイダーがあなたに対して有効化されていない場合は `error_type: not_enabled` を伴う `403` で、ゲートを評価できない場合は `error_type: service_unavailable` を伴う `503` で拒否します。そして、これら 4 つすべてを通過した場合にのみ、このモデル用のレッグを持たない実在のプロバイダーが `error_type: invalid_input` を伴う `400` で拒否されます。これは認識されない値と同じ応答です。`fallback_provider` は、BYOK リクエスト、ボディがマルチパート操作を選択するリクエスト、および `strict_mode=true` の場合には、拒否されるのではなく無効になります。 - `model_provider` と組み合わせた場合にのみ意味を持ちます。 + `model_provider` と併用した場合にのみ意味を持ちます。 デフォルト: False - 最初の試行が Router または試行したプロバイダーに起因する理由で失敗した場合に、Router がこの呼び出しをモデルの他の登録済みプロバイダーに対して再試行するかどうかを制御します。省略した場合、または `false` 以外の値の場合はフォールバックが有効のままです。`false` で無効になります。フォールバックが成功したレスポンスには `X-Comfy-Router-Fallback-Provider` が付与されます。bring-your-own-key 認証情報が解決されたリクエストでは、このパラメータの値に関係なくフォールバックは利用できません。試行は単に行われず、最初の失敗がそのまま返されます。これは拒否ではなく無効であり、ここから `409` が発生することはありません。同じ理由で、ボディがマルチパート操作を選択するリクエストおよび `strict_mode=true` の場合も同様です。いずれも呼び出しを 1 つのプロバイダーに結び付け、別のプロバイダーに対して忠実に再生することはできないため、フォールバックは拒否されるのではなく単にスキップされます。その `409` で拒否されるのは明示的な `model_provider` のみであり、この無条件のスキップとは異なり、マルチパートの `409` はトランスレーターがその操作を処理できないレッグにのみ適用されます。 + 最初の試行が Router または試行したプロバイダーに起因する理由で失敗したときに、Router がこの呼び出しをそのモデルの他の登録済みプロバイダーに対して再試行するかどうかを制御します。省略した場合、または `false` 以外の値の場合はフォールバックは有効のままです。`false` で無効になります。フォールバックが成功したレスポンスには `X-Comfy-Router-Fallback-Provider` が付与されます。BYOK 認証情報が解決されたリクエストでは、このパラメータの内容に関係なくフォールバックは利用できません。試行は単に行われず、最初の失敗がそのまま返ります。これは拒否ではなく無効であり、ここから `409` が発生することはありません。同じ理由で、ボディがマルチパート操作を選択するリクエストおよび `strict_mode=true` の場合も同様です。それぞれが呼び出しを 1 つのプロバイダーに結び付け、別のプロバイダーに対して忠実に再現することはできないため、フォールバックは拒否されるのではなく単にスキップされます。その `409` で拒否されるのは明示的な `model_provider` のみであり、この無条件のスキップとは異なり、そのマルチパート `409` はトランスレーターがその操作を処理できないレッグにのみ適用されます。 - このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否することをオプトインします。ネストされたフィールドはチェックされません。スキーマが未宣言のフィールドを許可しているモデル、または作成済みのスキーマを持たないモデルでは何も拒否されず、`strict_mode=true` で送信されたキュー中の送信でも同様です。 + このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを受け入れるのではなく拒否することを選択します。ネストされたフィールドはチェックされず、スキーマが未宣言のフィールドを許可しているモデルや作成済みスキーマを持たないモデルでは何も拒否されません。また、`strict_mode=true` で送信されたキュー中の送信でも拒否されません。 デフォルト: False @@ -237,198 +238,198 @@ Comfy API キーは Bearer トークンとして送信することもできま `application/json` -- [`RouterModelInput`](#routermodelinput)(必須) -パートナーモデルのネイティブ JSON 入力です。`model_provider` を指定しない場合、リクエストはモデルのデフォルトプロバイダー上でネイティブディスパッチを実行し、このボディはモデル自身のネイティブスキーマとなって、そのまま転送されます(`strict_mode` はそこでは意味を持たず、何も変わりません)。`model_provider` が代替プロバイダーを選択し、`strict_mode=false`(デフォルト)の場合、ボディは送信前にそのプロバイダーの実際のスキーマへ変換されます。正確に表現できないネイティブフィールドはドロップされ、レスポンスの `X-Comfy-Router-Dropped-Params` ヘッダーで開示されます。暗黙に破棄されることはありません。`model_provider` が代替プロバイダーを選択し、`strict_mode=true` の場合、変換は実行されません。ボディはすでにその代替プロバイダー自身の実際のスキーマである必要があり(このモデルのネイティブなものではありません。`strict_mode` を参照)、そのまま転送されます。ボディのフィールド自体も、複数の操作をサポートするモデルで Router が実行する操作を選択します。編集可能な画像モデルの場合、入力画像を含めるとテキストから画像への操作から画像から画像へ(編集)の操作に切り替わり、これには独自のレートが適用される場合があります。Seedance ビデオモデルの場合、`content[].role` が操作を選択します(最初のフレーム画像は画像から動画へを選択し、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance の課金は役割ではなく `content` 内のメディア種別に従います。動画入力が含まれるリクエストは動画から動画へとして課金され、そうでなければ画像が含まれるものは画像から動画へとして、それ以外はテキストから動画へとして課金されます。ただし、`draft_task` アイテムからの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルではテキストから動画へと画像から動画へが同じレートで課金されます。`model_provider` が代替プロバイダーを選択する場合、条件付けされた各操作にはそのプロバイダー独自のレートが適用される場合があります。 +パートナーモデルのネイティブ JSON 入力。`model_provider` がない場合、リクエストはモデルのデフォルトプロバイダーでネイティブディスパッチを実行し、このボディはモデル自身のネイティブスキーマであり、変更されずに転送されます(そこで `strict_mode` は意味を持たず、何も変わりません)。`model_provider` が代替プロバイダーを選択し、`strict_mode=false`(デフォルト)の場合、ボディは送信前にそのプロバイダーの実際のスキーマへ変換されます。正確に表現できないネイティブフィールドは破棄され、レスポンスの `X-Comfy-Router-Dropped-Params` ヘッダーを介して開示されます。暗黙に処理されることは決してありません。`model_provider` が代替プロバイダーを選択し、`strict_mode=true` の場合、変換は実行されません。ボディはすでにその代替プロバイダー自身の実際のスキーマである必要があり(このモデルのネイティブなものではなく、`strict_mode` を参照)、変更されずに転送されます。ボディ自身のフィールドは、複数の操作をサポートするモデルで Router が実行する操作も選択します。編集可能な画像モデルの場合、入力画像を含めると、テキストから画像への操作から画像から画像へ(編集)の操作に切り替わり、これは独自のレートで課金される場合があります。Seedance ビデオモデルの場合、`content[].role` が操作を選択します(最初のフレーム画像は画像から動画への操作を選択し、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance の課金は役割ではなく `content` 内のメディア種別に従います。ビデオ入力があるリクエストは動画から動画へとして課金され、そうでなければ画像があるものは画像から動画へ、さらにそうでなければテキストから動画へとして課金されます。ただし、`draft_task` 項目からの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルはテキストから動画へと画像から動画へで同じレートを課金します。`model_provider` が代替プロバイダーを選択している場合、条件付けされた各操作はそのプロバイダー独自のレートで課金される場合があります。 **レスポンス** - OK - `model_provider` なしの場合、または `model_provider` ありで `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブな契約に変換して返し、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログに記録され、サイレントにはなりません)の場合、形状はこのモデル自身のネイティブな出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスが変更されずにそのまま返されます。パートナーが生成結果をバイト列として直接返すモデルでは、ボディは `application/json` ではなく、パートナー自身の `Content-Type` に基づくそのバイト列になります。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると想定しないでください。 + OK: `model_provider` を指定しない場合、または `model_provider` を指定して `strict_mode=false` の場合(デフォルト。可能な場合はこのモデルのネイティブ契約に変換し直し、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。これはログに記録され、サイレントになることはありません)、レスポンスの形状はこのモデル自身のネイティブ出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスが変更されずに返されます。パートナーが生成リクエストに直接バイトで応答するモデルの場合、ボディは、`application/json` ではなく、パートナー自身の `Content-Type` に従ったそれらのバイトです。レスポンスの `Content-Type` に基づいて分岐し、JSON ドキュメントであると仮定しないでください。 - Body: [`RouterModelOutput`](#routermodeloutput) または生のバイト列 (`*/*`) -- ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` + ボディ: [`RouterModelOutput`](#routermodeloutput) または生のバイト (`*/*`)。ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `X-Comfy-Credits-Used`, `Idempotent-Replayed` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `X-Comfy-Credits-Used`, `Idempotent-Replayed` 認証情報が不足しているか、無効です。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、このリクエストは許可されていません。 + この呼び出し元またはモデルに対して、リクエストは許可されていません。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用してください。`invalid_input` は新しいキーが必要です。このルートにおける 2 つの `invalid_input` 競合はキーに関するものではなく、新しいキーでもどちらも解消されません。`model_provider` が代替プロバイダーを指定している場合、リクエストボディが、そのプロバイダーのこのモデル用トランスレーターでは対応できないマルチパート操作(編集)を選択しているときに拒否され、その `detail` は「this request's `image` selects the edit operation」で始まります。また、その後にチェックされるものとして、リクエストがパス内のプロバイダーに対する BYOK 認証情報をすでに解決している場合にも拒否され、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで(マルチパートの場合は編集もなしで)リクエストを送信してください。 + `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は元の呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用します。`invalid_input` の場合は新しいキーが必要です。このルートでの 2 つの `invalid_input` 競合はキーとはまったく関係がなく、新しいキーでもどちらも解消されません。`model_provider` で代替プロバイダーを指定している場合、リクエストボディが、そのプロバイダーのこのモデル用トランスレーターでは処理できないマルチパート操作(編集)を選択していると拒否され、その `detail` は "this request's `image` selects the edit operation" で始まります。また、その後で確認されるものとして、リクエストがパス内のプロバイダー用の bring-your-own-key 認証情報をすでに解決している場合にも拒否され、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで、かつ(マルチパートの場合は)編集なしでリクエストを送信してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded` の場合) + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded` の場合) リクエストボディが大きすぎます。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - リクエストの内容がモデルのスキーマに照らして拒否されました。 + リクエストの内容がモデルのスキーマに対して拒否されました。 - Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` + ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は実行中の呼び出しを減らすことを意味し、`rate_limited` は `Retry-After` が示す時間だけ待つことを意味します。 + `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は実行中の呼び出しを減らすことを意味します。`rate_limited` は `Retry-After` を待つことを意味します。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining`, `Retry-After` (`rate_limited` の場合) + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining`, `Retry-After` (`rate_limited` の場合) プロバイダー自身のレスポンスを結果に変換できませんでした (`provider_error`)。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status` - Router は一時的に利用できません。バックオフしながら再試行してください。 + Router は一時的に利用できません。バックオフして再試行してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (容量拒否の場合のみ) + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(容量拒否の場合のみ) リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After` ### `POST /v2/models/{provider}/{model}/estimate` -**モデル呼び出しを実行する前に、実行せずに価格を見積もります。** +**モデル呼び出しの価格を、実行せずに事前に見積もります。** -このボディをこのモデルで実行した場合のコストを米ドルで事前に見積もって返します。価格は Comfy の標準定価に基づきます(ベンダーが報告するコストで請求されるモデルは、代わりにベンダーの公開価格表から見積もられます)。契約料金や顧客固有の料金は反映されません。交渉済みの価格を持つワークスペースには定価が提示され、契約料金が請求されます。その場合、`source: exact` は定価に対して正確であることを意味し、そのワークスペースの請求額を意味するわけではありません。これは見積もりであり、最終請求額ではありません。実際に支払うのは、ワークスペースの使用量と請求の記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。これはデフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が検証するのと同じです。そのため、モデルのスキーマ検証に失敗するボディは、ここでも実行時と同じ `422` になります。プロバイダーには何もディスパッチされず、何も請求されません。この応答は価格を固定するものではありません。`pricing_as_of` 時点で有効な料金で価格設定され、実行は、レート適用時点で有効な料金で請求されます。デプロイメントで見積もりが無効になっている場合、このルートは `403` を `error_type: not_enabled` とともに返します。Router がまだ実行できないモデルは、実行ルート独自の `detail` を伴う同じ `403` を返すため、両者を区別するには `detail` を読んでください。ボディは Router がディスパッチするのと同じ方法で価格設定されます。ボディが指定する `model_provider` レッグ向けに変換され、実行されるオペレーションに再ターゲットされます。順序は、キュー中の送信の `201` にある `estimate` と同じです。ただし、その `estimate` は事前価格ではありません。実行が受け入れられてキューに入った後にのみ到着し、その実行は、ディスパッチ前にキャンセルされない限り請求されます。 +このボディをこのモデルで実行した場合のコストの事前見積もりを米ドルで返します。価格は Comfy の標準リスト価格に基づきます(ベンダーが報告するコストで請求されるモデルは、代わりにベンダーの公開価格表から見積もられます)。契約料金や顧客固有の料金は反映されません。個別交渉された価格を持つワークスペースにはリスト価格が提示され、契約料金が請求されます。その場合、`source: exact` はリスト価格において正確であることを意味し、そのワークスペースへの請求額が正確であることを意味しません。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの使用量および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。これは、デフォルト実行(`strict_mode` なし、`reject_unknown_fields` なし)が検証するのと同じ方法です。そのため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーには何もディスパッチされず、課金も発生しません。この回答は価格のロックではありません。`pricing_as_of` 時点で有効な料金で価格付けされ、実行は、料金が算出される時点で有効な料金で請求されます。デプロイメントで見積もりが無効になっている場合、このルートは `error_type: not_enabled` を伴う `403` を返します。Router がまだ実行できないモデルは、実行ルート独自の `detail` を伴う同じ `403` を返すため、両者を区別するには `detail` を読んでください。ボディの価格は、Router がディスパッチする方法で計算されます。つまり、指定された `model_provider` のレッグ向けに変換され、実行するオペレーションに再ターゲットされます。これは、キュー中の送信の `201` にある `estimate` と同じ順序で行われます。ただし、その `estimate` は事前価格ではありません。実行が受け入れられてキューに入った後にのみ返され、その実行はディスパッチ前にキャンセルされない限り請求されます。 **パラメータ** 正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment)。英数字スラッグ(例: `anthropic`)、最大 64 文字 正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment)。英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字 - 現在のデフォルトの代わりに、このモデルを提供する別のプロバイダーを選択します。 + このモデルを提供する代替プロバイダーを、現在のデフォルトの代わりに選択します。 **リクエストボディ** `application/json` -- [`RouterModelInput`](#routermodelinput)(必須) -パートナーモデルのネイティブな JSON 入力で、このモデルに対して同期ルートが受け付けるボディと同じものです。デフォルトの実行が検証するのと同様に、モデル自身の入力スキーマに対して検証され(このルートは `strict_mode` や `reject_unknown_fields` を受け付けません)、そのボディ自身のフィールド(出力数、入力画像が選択する操作)が何の価格を算出するかを決めます。 +パートナーモデルのネイティブ JSON 入力で、このモデルに対して同期ルートが受け付けるボディと同じものです。モデル自身の入力スキーマに対して、デフォルト実行が検証するのと同じ方法で検証されます(このルートは `strict_mode` や `reject_unknown_fields` を受け付けません)。価格計算の対象は、そのボディ自身のフィールド(出力数、入力画像によって選択されるオペレーション)によって決まります。 **レスポンス** - 見積もり結果。 + 見積もり。 - ボディ: [`RouterCostEstimate`](#routercostestimate) -- ヘッダー: `X-Comfy-Request-Id` + ボディ: [`RouterCostEstimate`](#routercostestimate)。ヘッダー: `X-Comfy-Request-Id` 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` 認証情報が不足しているか無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルに対してリクエストは許可されていません。 + この呼び出し元またはモデルでは、このリクエストは許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` リクエストボディが大きすぎます。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` 見積もりのボディがモデルのスキーマに対して拒否されたか、パスとは異なるモデルが指定されました。 - ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`: 呼び出し元のリクエスト許容量を使い切っています。次にリクエストを送る前に `Retry-After` 秒待ってください。 + `rate_limited`: 呼び出し元ごとのリクエスト許容量を使い果たしました。次のリクエストを送信する前に `Retry-After` を待ってください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` Router は一時的に利用できません。バックオフを伴って再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(容量拒否の場合のみ) + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(容量拒否時のみ) リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/openapi.json` -**1つのパートナーモデルの入力スキーマと出力スキーマを OpenAPI ドキュメントとして読み取ります。** +**パートナーモデル1件の入力スキーマと出力スキーマをOpenAPIドキュメントとして読み取ります。** -1つのモデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして読み取ります。 +1つのモデルの入力スキーマと出力スキーマを、単体のOpenAPIドキュメントとして読み取ります。 **パラメータ** - 正規の `{provider}/{model}` モデル ID のプロバイダー部分。 + 正規の `{provider}/{model}` モデルIDのプロバイダー部分。 - 型: [`RouterProviderSegment`](#routerprovidersegment)(英数字のスラッグ、例: `anthropic`、最大64文字) + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大64文字 - 正規の `{provider}/{model}` モデル ID のモデル部分。 + 正規の `{provider}/{model}` モデルIDのモデル部分。 - 型: [`RouterModelSegment`](#routermodelsegment)(英数字のスラッグ、例: `claude-opus-4-6`、最大128文字) + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字 @@ -438,9 +439,9 @@ Comfy API キーは Bearer トークンとして送信することもできま **レスポンス** - OK - モデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして返します。 + OK - モデルの入力スキーマと出力スキーマを、単体のOpenAPIドキュメントとして返します。 - 本文: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` + ボディ: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -450,67 +451,67 @@ Comfy API キーは Bearer トークンとして送信することもできま - 認証情報が不足しているか、無効です。 + 認証情報が不足しているか無効です。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、リクエストは許可されていません。 + この呼び出し元またはモデルでは、このリクエストは許可されていません。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - モデル ID が見つかりませんでした。 + モデルIDが見つかりませんでした。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router はリクエストを完了できませんでした。 + Routerがリクエストを完了できませんでした。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`: 呼び出し元のリクエスト許容量を使い切っています。次にリクエストを送る前に `Retry-After` 秒待ってください。 + `rate_limited`: 呼び出し元ごとのリクエスト許容量を使い切りました。次のリクエストを送信する前に `Retry-After` を待ってください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` - Router は一時的に利用できません。バックオフを伴って再試行してください。 + Routerは一時的に利用できません。バックオフを挟んで再試行してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}/requests` -**パートナーモデルの実行をキューに送信し、すぐに戻ります。** +**パートナーモデルの実行をキューに送信し、即座に返します。** -Comfy Router のキュー配信モードです。リクエストボディは、`POST /v2/models/{provider}/{model}` がこのモデルに対して受け付けるものと同じパートナーネイティブの JSON 入力です(1つのボディ形状、モデルごとに1つのスキーマ、2つの配信モード)。ただし、このルートは結果のために接続を保持しません。実行を受け付け、ハンドルとともに `201` を返し、呼び出し元は後で以下の3つの読み取りによって結果を取得します。 +Comfy Router のキュー配信モードです。リクエストボディは、`POST /v2/models/{provider}/{model}` がこのモデルに対して受け付けるものと同じパートナーネイティブの JSON 入力です。ボディ形状は1つ、モデルごとのスキーマは1つ、配信モードは2つありますが、このルートは結果のために接続を保持しません。実行を受け付けてハンドル付きで `201` を返し、呼び出し元は後で以下の3つの読み取りを通じて結果を取得します。 **パラメータ** - 正規の `{provider}/{model}` モデル ID の小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment)、英数字スラッグ(例: `anthropic`)、最大64文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大64文字 - 正規の `{provider}/{model}` モデル ID の小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment)、英数字スラッグ(例: `claude-opus-4-6`)、最大128文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字 - 現在のデフォルトの代わりに、このモデルを提供する代替プロバイダーを選択します。 + このモデルを提供する代替プロバイダーを、現在のデフォルトの代わりに選択します。 - `model_provider` と併用した場合のみ意味を持ちます。 + `model_provider` と併用した場合にのみ意味があります。 デフォルト: False @@ -518,295 +519,295 @@ Comfy Router のキュー配信モードです。リクエストボディは、` 1つの論理的な呼び出しを安全に再試行できるようにする、呼び出し元が生成するキー。 - 1〜255文字 + 1~255文字 - このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを受け入れるのではなく、拒否することを選択します。ネストされたフィールドはチェックされず、宣言されていないフィールドを許可するスキーマを持つモデル、または作成されたスキーマを持たないモデルの場合、および `strict_mode=true` で送信されたキューへの送信では、何も拒否されません。 + このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否するようにオプトインします。ネストされたフィールドはチェックされず、未宣言のフィールドを許可するスキーマを持つモデル、または作成済みスキーマを持たないモデルでは何も拒否されません。また、`strict_mode=true` で送信されたキューへの送信でも何も拒否されません。 デフォルト: False **リクエストボディ** -`application/json`: [`RouterModelInput`](#routermodelinput)(必須) +`application/json` -- [`RouterModelInput`](#routermodelinput)(必須) -パートナーモデルのネイティブ JSON 入力で、同期ルートがこのモデルに対して受け付けるボディと同じものです。また、操作を選択し、同じ方法で課金されます。ボディ自身のフィールドが、複数の操作をサポートするモデルで Router が実行する操作を選択します(入力画像は編集可能な画像モデルを画像から画像へ切り替え、それには独自のレートで課金される場合があります。Seedance の最初のフレーム画像は画像から動画へを選択し、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance リクエストはロールではなく `content` 内のメディア種別で課金されます。ビデオ入力があれば動画から動画へとして課金され、そうでなければ画像があれば画像から動画へ、それもなければテキストから動画へとして課金されます。ただし、`draft_task` 項目からの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルではテキストから動画へと画像から動画へに同じレートを請求します。`model_provider` で代替プロバイダーを選択する場合、条件付けされた各操作はそのプロバイダー独自のレートで課金される場合があります。同じプロバイダー選択の契約がディスパッチ時に適用されます。`model_provider` を指定しない場合、または `model_provider` を指定して `strict_mode=false`(デフォルト)の場合、ボディはモデルのネイティブドキュメントであり、実行が受け付けられる前にモデル自身の入力スキーマに対して検証されます。そのため、モデルが拒否するようなボディは、数分後に失敗するキュー中のリクエストではなく、ここで `422` になります。非厳格な代替プロバイダーのボディは、さらにディスパッチ時にそのプロバイダーの実際のスキーマへ変換されます。`strict_mode=true` の場合、ボディはすでに代替プロバイダー自身のスキーマである必要があり、変更されずに転送されます。ネイティブスキーマの検証は、同期ルートとまったく同じようにスキップされます(`model_provider` と `strict_mode` を参照)。 +パートナーモデルのネイティブ JSON 入力で、同期ルートがこのモデルに対して受け付けるボディと同一です。また、操作を選択し、同じ方法で課金されます。ボディ自体のフィールドが、複数の操作をサポートするモデルで Router が実行する操作を選択します(入力画像があると編集可能な画像モデルは画像から画像へ切り替わり、独自のレートで課金される場合があります。Seedance では、最初のフレーム画像が画像から動画へを選択し、参照画像またはクリップが参照から動画を選択します)。ネイティブディスパッチでは、Seedance リクエストはロールではなく `content` 内のメディア種別で課金されます。動画入力があれば動画から動画へとして課金され、なければ画像があれば画像から動画へとして、それもなければテキストから動画へとして課金されます。ただし、`draft_task` 項目からの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルはテキストから動画へと画像から動画へで同じレートを請求します。`model_provider` で代替プロバイダーを選択した場合、条件付きの各操作はそのプロバイダー独自のレートで課金される場合があります。同じプロバイダー選択の契約がディスパッチ時にも適用されます。`model_provider` を指定しない場合、または `model_provider` を指定して `strict_mode=false`(デフォルト)の場合は、ボディはモデルのネイティブドキュメントであり、実行が受け付けられる前にモデル自身の入力スキーマに対して検証されます。そのため、モデルが拒否するボディは、数分後に失敗するキュー中のリクエストではなく、ここで `422` になります。非 strict の代替プロバイダーのボディは、さらにディスパッチ時にそのプロバイダーの実際のスキーマへ変換されます。`strict_mode=true` の場合、ボディはすでに代替プロバイダー自身のスキーマである必要があり、変更されずに転送されます。ネイティブスキーマの検証はスキップされ、同期ルートとまったく同じです(`model_provider` と `strict_mode` を参照)。 **レスポンス** - 作成済み。実行がキューに受け付けられました。 + 作成済み - 実行がキューに受け付けられました。 - ボディ: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse)、ヘッダー: `X-Comfy-Request-Id`、`Idempotent-Replayed` + ボディ: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- ヘッダー: `X-Comfy-Request-Id`, `Idempotent-Replayed`, `X-Comfy-Router-Dropped-Params` - 認証情報が不足しているか無効です。 + 認証情報が不足しているか、無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` リクエストボディが大きすぎます。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗 - リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - この呼び出し元またはモデルに対してリクエストは許可されていません。パートナーが生成結果を直接バイトとして返すモデルはまだキューに投入できず、`not_enabled` で拒否されます。代わりに同期ルートで実行してください。 + この呼び出し元またはモデルに対してリクエストは許可されていません。パートナーが生成結果をバイトとして直接返すモデルはまだキューに投入できず、`not_enabled` で拒否されます。代わりに同期ルートで実行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` -`X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用してください。`invalid_input` の場合は新しいキーが必要です。このルートにおける 2 つの `invalid_input` 競合はキーとはまったく関係がなく、新しいキーでもどちらも解消されません。1 つ目は `model_provider` で代替プロバイダーを指定した場合で、リクエストボディが、このモデルに対するそのプロバイダーのトランスレーターでは処理できないマルチパート操作(編集)を選択していると拒否され、その `detail` は「this request's `image` selects the edit operation」で始まります。2 つ目はその後チェックされるもので、リクエストがすでにパス内のプロバイダーに対する BYOK 認証情報を解決済みの場合に拒否され、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで(マルチパートの場合は編集もなしで)リクエストを送信してください。 + `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` の時間だけ待って同じキーを再利用してください。`invalid_input` の場合は新しいキーが必要です。このルートで発生する 2 つの `invalid_input` 競合はキーに関するものではなく、新しいキーでもどちらも解消されません。1 つは、リクエストボディがそのプロバイダーのこのモデル向けトランスレーターでは処理できないマルチパート操作(編集)を選択しているときに、別のプロバイダーを指定する `model_provider` が拒否されるケースで、`detail` は "this request's `image` selects the edit operation" で始まります。もう 1 つはその後でチェックされるもので、リクエストがすでにパス内のプロバイダーに対する BYOK 認証情報を解決している場合で、`detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで、かつ(マルチパートの場合は)編集なしでリクエストを送信してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(`concurrency_limit_exceeded` の場合) + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded` の場合) - リクエストの内容がモデルのスキーマに対して拒否されました。 + リクエストの内容がモデルのスキーマに照らして拒否されました。 - ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` + Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - `X-Comfy-Error-Type` を確認してください。`queue_backlog_full` は、許可されている数まで未完了のキュー中リクエストをすでに保持していることを意味するため、そのうちの 1 つが完了したら再度送信してください。`rate_limited` は `Retry-After` に示された秒数だけ待つことを意味します。 + `X-Comfy-Error-Type` を確認してください。`queue_backlog_full` は、すでに許可された数まで未完了のキュー中のリクエストを保持していることを意味するため、そのうち 1 つが完了したら再度送信してください。`rate_limited` は `Retry-After` に示された秒数だけ待つことを意味します。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` (`rate_limited` の場合) + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`rate_limited` の場合) - ルーターは一時的に利用できません。バックオフしながら再試行してください。 + Router は一時的に利用できません。バックオフしながら再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(容量拒否の場合のみ) + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (容量拒否の場合のみ) リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}` -**送信された 1 件のリクエストの結果を取得します。** +**送信済みリクエスト1件の結果を取得します。** -結果収集エンドポイントです。正常に完了したリクエストに対しては、パートナーモデル自身のネイティブ出力を、同じモデル・同じ入力に対して同期ルートの `200` が返す内容とバイト単位で同一のまま返します。これにより 2 つの配信モードは 1 つの結果形状を生成し、呼び出し元は別のパーサーを用意することなく両者を切り替えられます。 +結果取得エンドポイントです。正常に完了したリクエストに対しては、パートナーモデル自身のネイティブ出力をそのまま返します。これは同じモデルと同じ入力に対して同期ルートの `200` が返す内容とバイト単位で同一であり、2つの配信モードが単一の結果形状を生み出すため、呼び出し元は別のパーサーを用意せずに両者を行き来できます。 **パラメータ** - 正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大64文字 - 正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大128文字 - 対象となるキュー中のリクエスト。送信時にレスポンス本文で返された `request_id` です。 + 対象とするキュー中のリクエスト。送信時にボディで返された `request_id` です。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 **レスポンス** - OK: 結果を生成したリクエストに対して保存された結果です。正常に完了したリクエスト、または記録済みの課金と保存済みの結果の両方を持つターミナル状態のリクエストが該当します。パートナー自身のメディアタイプのまま、同期ルートの `200` が返すのとまったく同じ形で、また送信時に受け入れたのと同じプロバイダー選択契約のもとで、変更されずに返されます。`model_provider` がない場合、または `model_provider` があり `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブ契約に変換され、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログに記録され、決して黙って処理されることはありません)の場合は、形状はこのモデル自身のネイティブ出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスが変更されずにそのまま返されます。パートナーが生成結果を直接バイトとして返すモデルの場合、本文は `application/json` ではなくパートナー自身の `Content-Type` を持つそれらのバイト列です。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると決めつけないでください。 + OK - 結果を生成したリクエストのために保存された結果です。正常に完了したリクエスト、または記録された課金と保存された結果の両方を持つターミナル状態のリクエストが該当し、パートナー自身のメディアタイプのまま変更されずに返されます。同期ルートの `200` が返す場合とまったく同じであり、また送信時に受け入れたのと同じプロバイダー選択の契約に従います。`model_provider` を指定しない場合、または `model_provider` を指定して `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブ契約に変換し、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログには記録され、黙って処理されることはありません)の場合、形状はこのモデル自身のネイティブ出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスが変更されずに返されます。パートナーが生成結果を直接バイトとして返すモデルの場合、ボディは `application/json` ではなくパートナー自身の `Content-Type` を持つそのバイト列になります。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると仮定しないでください。 - 本文: [`RouterModelOutput`](#routermodeloutput) または生のバイト列(`*/*`) -- ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` + ボディ: [`RouterModelOutput`](#routermodeloutput) または生のバイト列 (`*/*`) -- ヘッダー: `X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Credits-Used` - 受理済み: リクエストはまだ完了していません。 + Accepted - リクエストはまだ完了していません。 - 本文: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`, `Retry-After` + ボディ: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`、`Retry-After` 認証情報が不足しているか無効です。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、リクエストは許可されていません。 + この呼び出し元またはモデルに対してリクエストは許可されていません。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`: 呼び出し元のリクエスト許容量を使い切っています。次にリクエストを送る前に `Retry-After` 秒待ってください。 + `rate_limited`: 呼び出し元ごとのリクエスト許可量を使い切りました。次のリクエストを送信する前に `Retry-After` の時間だけ待ってください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` Router は一時的に利用できません。バックオフを伴って再試行してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - リクエストは操作と競合する状態にあります。エラータイプを確認してください。 + リクエストが操作と競合する状態にあります。エラータイプを確認してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 - 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` -**送信済みのリクエストを 1 件キャンセルするよう要求します。** +**送信済みの1件のリクエストにキャンセルを要求します。** -まだ完了していないリクエストを停止するよう Comfy に要求します。これは要求であり保証ではないため、`202` はまさにそのことを示します。`CANCELLATION_REQUESTED` は要求が受け付けられたという意味であり、実行が停止したという意味ではありません。パートナー側ですでに送信済みの実行はそのまま完了する可能性があります。そして完了したパートナーでの生成は、誰が結果を取得したかに関係なく課金されます。そのため、実際に何が起きたかを知る必要がある呼び出し元は、後からステータスエンドポイントを参照します。そこでは、有効になったキャンセルは他のすべての終端結果と同様に `COMPLETED` となり、`error_type` を持ちます。 +まだ完了していないリクエストを停止するよう Comfy に要求します。これは要求であり保証ではなく、`202` はまさにそのことを示しています。`CANCELLATION_REQUESTED` は要求が受け付けられたことを意味し、実行が停止したことを意味するものではありません。パートナー側ですでに処理中の実行は、そのまま完了する可能性があります。そして完了したパートナーでの生成は、誰が結果を取得したかに関係なく課金されます。そのため、実際に何が起きたかを知る必要がある呼び出し元は、後でステータスエンドポイントを参照します。そこで、キャンセルが実際に反映された場合は `COMPLETED` となり、他のすべてのターミナルな結果と同様に `error_type` が付与されます。 **パラメータ** - 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。実行するモデルを提供するパートナーです。 + 正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。 - 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大64文字 - 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。 - 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字 対象とするキュー中のリクエスト。送信時にレスポンスボディで返された `request_id` です。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大 36 文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 **レスポンス** - 受け付け済み - `CANCELLATION_REQUESTED`。 + 受理: `CANCELLATION_REQUESTED`。 - ボディ: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- ヘッダー: `X-Comfy-Request-Id` + 本文: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- ヘッダー: `X-Comfy-Request-Id` - 競合 - `ALREADY_COMPLETED`。 + 競合: `ALREADY_COMPLETED`。 - ボディ: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- ヘッダー: `X-Comfy-Request-Id` + 本文: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- ヘッダー: `X-Comfy-Request-Id` 無効なリクエストです。エラータイプとリクエストボディを確認してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 認証情報が不足しているか無効です。 + 認証情報が不足しているか、無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - この呼び出し元またはモデルでは、そのリクエストは許可されていません。 + この呼び出し元またはモデルに対して、このリクエストは許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`: 呼び出し元のリクエスト許容量を使い切っています。次にリクエストを送る前に `Retry-After` 秒待ってください。 + `rate_limited`: 呼び出し元ごとのリクエスト許容量を使い切りました。次のリクエストを送信する前に `Retry-After` を待ってください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` - Router は一時的に利用できません。バックオフしながらリトライしてください。 + Router は一時的に利用できません。バックオフしながら再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。 + Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` -**送信済みの1件のリクエストのキュー状態を読み取ります。** +**送信済みの 1 件のリクエストのキュー状態を読み取ります。** -ポーリング用のエンドポイントです。リクエストの現在の状態を返し、結果は決して返しません。そのためクライアントは、ポーリングのたびに出力を転送することなく、長時間の生成を監視できます。結果は、ここで `COMPLETED` が返されたときに、後述の読み取りから一度だけ取得します。 +ポーリング用のエンドポイントです。リクエストの現在の状態を返し、結果は返しません。そのためクライアントは、ポーリングのたびに出力を転送することなく、長時間の生成を監視できます。結果は、このエンドポイントが `COMPLETED` を返した時点で、後述の読み取りから一度だけ取得します。 **パラメータ** - 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。モデルを実行するパートナーを指します。 - 型: [`RouterProviderSegment`](#routerprovidersegment)。英数字のスラッグ(例: `anthropic`)、最大64文字 + 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字 - 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。 + 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルを指します。 - 型: [`RouterModelSegment`](#routermodelsegment)。英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字 + 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字 対象とするキュー中のリクエスト。送信時にレスポンスボディで返された `request_id` です。 - 型: [`RouterQueueRequestId`](#routerqueuerequestid)。`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 **レスポンス** @@ -814,52 +815,52 @@ Comfy Router のキュー配信モードです。リクエストボディは、` OK - リクエストの現在のキュー状態。 - ボディ: [`RouterQueueStatusResponse`](#routerqueuestatusresponse)。ヘッダー: `X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` + ボディ: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Credits-Used`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` - 認証情報が不足しているか、無効です。 + 認証情報が不足しているか無効です。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - この呼び出し元またはモデルに対して、このリクエストは許可されていません。 + この呼び出し元またはモデルでは、このリクエストは許可されていません。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` モデル ID が見つかりませんでした。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `rate_limited`: 呼び出し元のリクエスト許容量を使い切っています。次にリクエストを送る前に `Retry-After` 秒待ってください。 + `rate_limited`: 呼び出し元ごとのリクエスト許容量を使い切りました。次のリクエストを送信する前に `Retry-After` だけ待ってください。 ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - Router は一時的に利用できません。バックオフしながら再試行してください。 + Router は一時的に利用できません。バックオフを伴って再試行してください。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。 - ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` -ここでの説明は簡潔にしています。モデルの選択、検証、再試行、課金については [Comfy Router API の使用](/ja/development/comfy-router/api) を、ヘッダーの動作については [ヘッダー](/ja/development/comfy-router/headers) を参照してください。 +ここでの説明は簡潔です。モデルの選択、検証、再試行、課金については [Comfy Router API の使用](/ja/development/comfy-router/api) を、ヘッダーの動作については [ヘッダー](/ja/development/comfy-router/headers) を参照してください。 ## エラーバケット diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index b83ca623ad..9d9dea9039 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -2,20 +2,20 @@ title: "Comfy Router 기능과 한계" sidebarTitle: "기능과 한계" description: "Comfy Router 또는 파트너 프록시 선택, 장시간 실행되는 호출 대비, 복구, 속도 제한 및 자산 저장에 대해 설명합니다." -translationSourceHash: a81b3bd9 +translationSourceHash: 04575573 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 "What Router supports": 2cc63403 - "Queued submission": d0798008 + "Queued submission": bcbb1f7c "Calls are cut off at a server deadline": c8724f59 "Recovery depends on the provider": da9d8904 "Request bodies are capped": 675b77c8 "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": e7d7524a - "Router does not cover every partner operation": 786c0fb2 + "Models without a pre-flight estimate": 789d46e5 + "Router does not cover every partner operation": 11621b39 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -31,6 +31,7 @@ translationBlockHashes: + Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나, 제출한 뒤 나중에 수집하는 대기 중 요청을 통해 실행합니다. 애플리케이션이 완료된 결과를 기다리거나 나중에 결과를 수집할 수 있고, 모델 자체의 입력 및 출력 필드를 처리할 수 있는 경우에 사용하십시오. ## Router가 지원하는 기능 @@ -55,7 +56,9 @@ Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나 현재 네 개의 모델이 동기 전용이며, 실행 대기열에 제출하면 `403` / `not_enabled`로 거부됩니다: `elevenlabs/eleven_sfx_v2`, `elevenlabs/eleven_v3`, `elevenlabs/eleven_v4`, `elevenlabs/eleven_v4_turbo`. 이들은 JSON 결과 문서가 아닌 원시 오디오 바이트를 응답하며, 대기 중 전달은 이를 저장할 곳이 없습니다. 동기 경로에서 실행하세요. 이 경로는 해당 바이트를 정상적으로 반환합니다. -LTX v1 텍스트 기반 비디오 생성 및 이미지 기반 비디오 생성 연산도 같은 이유로 원시 비디오 바이트를 응답하며, 대기 중 전달은 이를 저장할 수 없습니다. 하지만 이들은 Router 모델 id가 아니라 `/proxy/ltx/v1/…`의 [파트너 프록시](#router는-모든-파트너-작업을-다루지-않습니다)를 통해서만 접근할 수 있습니다. 모든 `ltx/*` 카탈로그 모델은 대기열에 넣을 수 있는 v2 제출 및 폴링 연산으로 해석됩니다. +네 개의 모델은 실행 대기열 전용이며, 동기 경로에서는 `403` / `not_enabled`로 거부됩니다: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe`, `ltx/ltx-video-upscale`. 이들의 작업은 동기 호출이 유지되는 시간보다 오래 지속될 수 있습니다. 동일한 본문을 `POST /v2/models/ltx/{model}/requests`에 제출하고 실행 대기열에서 결과를 수집하세요. + +LTX v1 텍스트 기반 비디오 생성 및 이미지 기반 비디오 생성 연산도 같은 이유로 원시 비디오 바이트를 응답하며, 대기 중 전달도 이를 저장할 수 없습니다. 하지만 이들은 Router 모델 id를 통해서가 아니라 `/proxy/ltx/v1/…`의 [파트너 프록시](#router는-모든-파트너-작업을-다루지-않습니다)를 통해서만 접근할 수 있습니다. 모든 `ltx/*` 카탈로그 모델은 실행 대기열에 넣을 수 있는 v2 제출 및 폴링 연산으로 해석됩니다. ## 서버 데드라인에 도달하면 호출이 끊깁니다 @@ -112,7 +115,7 @@ Router는 최종 응답만 반환하며, 스트리밍되는 토큰, 서버 전 ## 사전 견적이 없는 모델 -Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정적으로 산정할 수 없으므로, 이들 모델에 대해서는 `/estimate`와 대기 중인 제출의 `estimate`가 `source: unknown`으로 응답할 것으로 예상해야 합니다. 다만 특정 요청 본문에 대해서는 값을 반환할 수도 있습니다. `unknown`은 실행이 무료라는 뜻이 아니라, 값이 제시되지 않았다는 뜻입니다. [Comfy 요금 및 사용량](#comfy-요금-및-사용량) 규칙은 여전히 적용됩니다. 자체 공급자 키로 실행한 경우 Comfy에서 과금하지 않으며, `X-Comfy-Credits-Used`는 선택 사항이므로 헤더가 누락되었다면 비용이 보고되지 않았다는 뜻입니다. 여기에 나열되지 않은 모델도 특정 요청 본문에 대해 `unknown`으로 응답할 수 있으므로, 모든 견적에서 `source`를 확인하세요. +Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정적으로 산정할 수 없으므로, 이들 모델에 대해서는 `/estimate`와 대기 중인 제출의 `estimate`가 `source: unknown`으로 응답할 것으로 예상해야 합니다. 다만 일부 모델은 특정 요청 본문에 대해서는 값을 반환할 수도 있습니다. `unknown`은 실행이 무료라는 뜻이 아니라, 값이 제시되지 않았다는 뜻입니다. [Comfy 요금 및 사용량](#comfy-요금-및-사용량) 규칙은 여전히 적용됩니다. 자체 공급자 키로 실행한 경우 Comfy에서 과금하지 않으며, `X-Comfy-Credits-Used`는 선택 사항이므로 헤더가 누락되었다면 비용이 보고되지 않았다는 뜻입니다. 여기에 나열되지 않은 모델도 특정 요청 본문에 대해 `unknown`으로 응답할 수 있으므로, 모든 견적에서 `source`를 확인하세요. 이 목록은 견적 적용 범위가 늘어나면 줄어듭니다. 이 목록은 Router 자체의 가격 책정 코드에서 생성되며, 공개적으로 사용할 수 없는 모델은 나열되지 않습니다. @@ -123,14 +126,20 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kelly**: `kelly/kelly-seedance-2.0`, `kelly/kelly-seedance-2.0-fast`, `kelly/kelly-seedance-2.5` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` +- **ltx**: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe`, `ltx/ltx-video-upscale` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` +- **pixverse**: `pixverse/v3.5`, `pixverse/v6`, `pixverse/v6-max` +- **quiver**: `quiver/arrow-2`, `quiver/arrow-2-telos` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` - **synclabs**: `synclabs/sync-3` +- **veed**: `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` - **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} @@ -139,18 +148,19 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 ## Router는 모든 파트너 작업을 다루지 않습니다 -Router는 모델을 실행합니다. 파일 업로드, 계정 읽기, 에셋 관리, 스트리밍, 공급자 작업 제어에는 Router 외부에 있고 그 계약에서 설명되지 않는 `/proxy/…` 아래의 파트너 프록시 라우트가 필요할 수 있습니다. Router 자체의 표면은 [Comfy Router 명세](/router-openapi.yaml)이며, 지원 여부는 공급자마다 다릅니다. - ### Krea 3 참조 이미지: 먼저 업로드하거나 공개 https URL 사용 -`krea/krea-3`의 `image_urls`에서 `POST /proxy/krea/assets`가 반환한 `image_url`(`https://app-uploads.krea.ai/...` URL)은 항상 허용됩니다. 다른 링크가 허용되는지는 환경에 따라 다르며, api.comfy.org에서는 현재 허용됩니다. +`krea/krea-3`의 `image_urls`에서 `POST /proxy/krea/assets`가 반환한 `image_url`(`https://app-uploads.krea.ai/...` URL)은 항상 허용됩니다. 다른 링크가 허용되는지는 환경에 따라 다릅니다. api.comfy.org에서는 현재 허용됩니다. 8개를 초과하는 항목은 요청의 스키마 검사에 의해 가져오기 전에 `422`로 거부됩니다. + +- **다른 링크가 허용되는 경우**, 공개 `https` 이미지 URL이면 모두 작동합니다. Router는 모델이 실행되기 전에 각 참조 이미지를 직접 가져와 크기를 읽습니다. 수정해야 하는 참조 이미지는 호스트 이름을 명시한 `400` `invalid_input`으로 거부됩니다. 즉, 존재하지 않거나 공개적으로 접근할 수 없는 호스트, `408` 또는 `429`가 아닌 `4xx`로 응답하는 오리진, 리디렉션이 너무 많은 경우, `https`가 아닌 링크 또는 공개적으로 접근할 수 없는 호스트로의 리디렉션, 지원되는 이미지가 아닌 콘텐츠, 길이 정보 없이 이미지 크기 헤더 전에 끝나는 응답, 또는 크기 헤더가 처음 2 MiB 이내에 없는 이미지(아래 참조)입니다. 다른 가져오기 실패는 대신 `5xx` 오류입니다(Router에서는 `500` `internal_error`). 그중 일부는 저절로 해결되므로(DNS 리졸버 오류, 시간 초과, 끊어진 연결, `5xx`, `408` 또는 `429`로 응답하는 오리진, 또는 Router의 호스트 검사와 연결 사이에 DNS 응답이 비공개 주소로 바뀌는 호스트. 이 경우 재시도 시 성공할 수도 있고 비공개 호스트에 대한 `400`으로 거부될 수도 있습니다) 나중에 다시 시도하세요. 다른 실패는 매번 같은 방식으로 실패합니다. 예를 들어 가져오기가 신뢰하지 않는 TLS 인증서(자체 서명됨, 만료됨 또는 잘못된 호스트 이름 대상) 또는 가져오기가 따르지 않는 `200`이 아닌 `2xx`나 `3xx`로 응답하는 오리진(예: `204`, `206`, `300`, `304`, `305`, 또는 `Location`이 없는 `301`, `302`, `303`, `307`, `308`)입니다. 재시도해도 같은 방식으로 실패하면 먼저 이미지를 업로드하세요. `POST /v2/models/krea/krea-3/requests`로 대기 중인 요청은 링크 중 하나라도 `app-uploads.krea.ai` 링크가 아니면 이러한 `5xx`에서 재시도되지 않으므로 원인이 해결될 수 있다면 직접 다시 제출하세요. 유효한 업로드가 아닌 `app-uploads.krea.ai` 링크는 다른 접근 불가능한 참조 이미지와 마찬가지로 `400`으로 거부됩니다. 대기 중인 요청의 `400`에는 일반적인 `invalid_input` 세부 정보만 포함되므로 호스트 이름을 명시하지 않으며, 실행 대기열은 이를 재시도하지 않습니다. 대기 중인 `400`은 `image_urls`뿐 아니라 모든 필드(예: 지원되지 않는 `resolution` 또는 `thinking_mode`)에서 발생할 수 있으므로 다른 필드를 먼저 확인하세요. 다른 필드가 유효하다면 `POST /proxy/krea/assets`로 각 이미지를 업로드하고 해당 `image_url` 값과 새 `Idempotency-Key`(또는 키 없음)로 다시 제출하세요. 변경된 본문으로 키를 재사용하면 `409` `invalid_input`으로 거부되며, 이는 이미지에 대한 어떤 정보도 제공하지 않습니다. 동일한 본문으로 키를 재사용하면 원본 `request_id`와 `Idempotent-Replayed: true`와 함께 `201`로 응답되므로 새 실행이 시작되지 않으며, 해당 결과 URL(`GET /v2/models/krea/krea-3/requests/{request_id}`)은 동일한 `400`을 반환합니다(해당 상태 URL은 `error_type` `invalid_input`과 함께 `200`으로 응답합니다). 그 재제출도 `400`으로 실패하면 이미지 자체가 문제입니다(예: 지원되는 이미지가 아니거나 크기 헤더가 처음 2 MiB 이내에 없음). +- **다른 링크가 허용되지 않는 경우**, 모든 항목은 업로드에서 반환된 `image_url`이어야 합니다. Router는 링크가 호스트가 정확히 `app-uploads.krea.ai`인 `https` URL로 구문 분석되는지만 확인합니다(다른 호스트 없음, 명시적 포트 없음). 그 밖의 링크는 직접 호스팅하는 공개 `https` URL을 포함해 모델이 실행되기 전에 `400` `invalid_input`과 함께 "image_urls must be image_url values returned by POST /proxy/krea/assets"라는 메시지로 거부되므로 대신 이미지를 업로드하세요. 해당 검사를 통과했지만 유효한 업로드가 아닌 링크(만료됨, 삭제됨 또는 잘못 입력됨)는 여전히 검사를 통과하며, 그러면 Router가 이미지 크기를 읽지 못하고 `400`이 아닌 `5xx` 오류로 응답합니다. Router가 읽을 수 없는 업로드된 이미지(예: 지원되는 이미지가 아니거나 크기 헤더가 처음 2 MiB 이내에 없음)도 여기서는 `400`이 아니라 `5xx`(Router에서는 `500` `internal_error`)로 실패하며, 여전히 이미지 자체가 문제이므로 다시 업로드해도 도움이 되지 않습니다. +- **서버가 시작된 직후**, 어떤 규칙이 적용되는지 파악하기 전에는 `app-uploads.krea.ai` 링크가 아닌 모든 `https` URL이 `503`(Router에서는 `service_unavailable`)으로 실패할 수 있으며, 이는 재시도해도 안전합니다(대기 중인 요청은 이 오류에서 자동으로 재시도됩니다). -- **다른 링크가 허용되는 환경**에서는 공개 `https` 이미지 URL이면 무엇이든 작동합니다. Router는 모델이 실행되기 전에 각 이미지의 크기를 읽습니다. 호스트가 공개적으로 접근 가능하지 않거나 존재하지 않는 링크, `408` 또는 `429`가 아닌 `4xx`로 응답하는 링크, 이미지가 아닌 링크는 해당 호스트 이름을 명시한 `400` `invalid_input`으로 거부됩니다. 일시적인 DNS, TLS 또는 연결 실패, 타임아웃, 원본의 `408` 또는 `429`는 `502` 오류로 실패합니다. 실제 업로드가 아닌 `app-uploads.krea.ai` 링크는 다른 접근 불가 참조와 마찬가지로 `400`으로 거부됩니다. 서버가 시작된 직후, 어떤 규칙이 적용되는지 파악하기 전에는 `app-uploads.krea.ai` 링크가 아닌 공개 `https` URL이 `503`으로 실패할 수 있으며, 이 경우 재시도해도 안전합니다. -- **다른 링크가 허용되지 않는 환경**에서는 모든 항목이 업로드의 `image_url`이어야 합니다. Router는 링크가 호스트가 정확히 `app-uploads.krea.ai`인 `https` URL로 파싱되는지만 확인합니다(다른 호스트도, 명시적 포트도 허용되지 않음). 직접 호스팅한 공개 `https` URL을 포함해 그 밖의 링크는 모델이 실행되기 전에 `400` `invalid_input`으로 거부됩니다. 이 검사를 통과했지만 실제 업로드가 아닌 링크(만료됨, 삭제됨 또는 잘못 입력됨)는 여전히 통과하며, 그러면 Router가 이미지 크기를 읽지 못해 `400`이 아닌 `5xx` 오류로 응답합니다. +Router는 크기를 찾기 위해 각 참조 이미지의 처음 2 MiB만 읽습니다. 따라서 해당 창 안에서 크기 정보를 끝까지 읽지 못하는 이미지, 예를 들어 2 MiB가 넘는 임베디드 메타데이터를 담은 JPEG, 또는 팔레트 PNG로서 투명도 데이터가 있거나 없는 경우 첫 이미지 데이터 청크의 시작이 2 MiB를 넘어 위치하는 경우(예: 2 MiB가 넘는 텍스트 또는 색상 프로필 청크 뒤)는 크기 헤더가 처음 2 MiB 이내에 없다는 메시지와 함께 `400`으로 거부되며, 업로드해도 도움이 되지 않습니다. 먼저 큰 메타데이터 없이 다시 저장하거나, 팔레트 PNG를 비팔레트(트루컬러) PNG로 저장하세요. 국제화 호스트 이름은 ASCII(퓨니코드) 형식으로 보내세요. 예를 들어 `bücher.de` 대신 `xn--bcher-kva.de`를 사용하세요. Router는 호스트를 적힌 그대로 조회하며, ASCII가 아닌 이름은 존재하지 않는 호스트로 거부됩니다. -업로드는 모든 환경에서 작동하므로 이식성 있는 선택입니다. 항상 업로드가 반환한 그대로의 `image_url`을 전달하세요. +업로드는 모든 환경에서 작동하므로 이식 가능한 선택입니다. 항상 업로드가 반환한 그대로 `image_url`을 전달하세요. 이미지가 아직 공개 `https` URL에 없다면 먼저 업로드하세요: -1. 각 참조 이미지를 `multipart/form-data`로 업로드하고, 이미지는 폼 필드 `file`에 담습니다(JPEG, PNG 또는 WebP, 최대 75 MB). Router와 동일한 방식으로 `X-API-Key` 또는 `Authorization: Bearer`를 사용해 인증합니다. +1. 각 참조 이미지를 `multipart/form-data`로 업로드하며, 이미지는 폼 필드 `file`에 담습니다 (JPEG, PNG 또는 WebP, 최대 75 MB). Router와 동일한 방식으로 `X-API-Key` 또는 `Authorization: Bearer`를 사용해 인증합니다. ```bash curl -X POST https://api.comfy.org/proxy/krea/assets \ diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index fc191d85f0..8875bea725 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -2,27 +2,27 @@ title: "Comfy Router 모델" sidebarTitle: "모든 모델" description: "Comfy Router에서 사용할 수 있는 모든 모델을 제공자별로 정리하고, 각 모델의 입력 및 출력 모달리티를 함께 표시합니다." -translationSourceHash: df7e65a1 +translationSourceHash: 4bd95744 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 4d100975 + "Find by output": 23c1048d "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 - "BytePlus": 0767a672 + "BytePlus": 97340104 "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 "Gemini Interactions": 38163caf - "Google": 4932820b + "Google": 77d668ec "HeyGen": 76fe1a0d "Higgsfield": 0ce2b918 "Ideogram": c22a0e5e "Kling": aec38bcd "Krea": 16b83e5e - "LTX": 32595bf9 + "LTX": 413dd527 "Luma": 8cd2a7ce "Luma 2": 585eb637 "Meshy": 67e26a17 @@ -31,7 +31,9 @@ translationBlockHashes: "OpenAI": 8652024f "Openrouter": a4f6806b "Pika": 0cc24098 + "Pixverse": 195092d8 "Pruna": 903d76ee + "Quiver": 34eaad49 "Qwen": b3ef78a1 "Recraft": 02b7d9cd "Runway": be098f8c @@ -50,6 +52,7 @@ translationBlockHashes: + {/* GENERATED FILE. Generated from the Router catalog by `pnpm code-pages:gen`. */} 아래의 모든 모델은 동일한 라우트인 `POST /v2/models/{provider}/{model}`를 통해 제공되며, 각 모델 고유의 JSON 본문을 사용합니다. 각 페이지에는 Python, TypeScript, cURL로 작성된 실제 동작하는 요청 예시가 있습니다. 검색, 스키마, 오류, 재시도, 청구에 대해서는 [Comfy Router API 사용하기](/ko/development/comfy-router/api)를 참고하세요. @@ -59,29 +62,28 @@ translationBlockHashes: ## 출력으로 찾기 - + - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` -- [FLUX 3 비디오](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` -- [FLUX 비디오 업스케일](/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code): `bfl/video-upscale-v1` -- [비디오 편집 V1](/ko/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1` -- [비디오 편집 지우기](/ko/development/comfy-router/models/bria/video-edit-erase/code): `bria/video-edit-erase` -- [비디오 편집 그린 스크린](/ko/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` -- [비디오 편집 배경 제거](/ko/development/comfy-router/models/bria/video-edit-remove-background/code): `bria/video-edit-remove-background` -- [비디오 편집 배경 교체](/ko/development/comfy-router/models/bria/video-edit-replace-background/code): `bria/video-edit-replace-background` +- [FLUX 3 Video](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` +- [FLUX Video Upscale](/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code): `bfl/video-upscale-v1` +- [Video Edit V1](/ko/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1` +- [Video Edit Erase](/ko/development/comfy-router/models/bria/video-edit-erase/code): `bria/video-edit-erase` +- [Video Edit Green Screen](/ko/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` +- [Video Edit Remove Background](/ko/development/comfy-router/models/bria/video-edit-remove-background/code): `bria/video-edit-remove-background` +- [Video Edit Replace Background](/ko/development/comfy-router/models/bria/video-edit-replace-background/code): `bria/video-edit-replace-background` - [Dreamina Seedance 2.0 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` - [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seedance 1.0 Pro 250528](/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code): `byteplus/seedance-1-0-pro-250528` - [Seedance 1.0 Pro Fast 251015](/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code): `byteplus/seedance-1-0-pro-fast-251015` -- [Seedance 1.5 Pro 251215](/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` -- [Crystal 비디오 업스케일러](/ko/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` +- [Crystal Video Upscaler](/ko/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` - [FLUX 3 Max](/ko/development/comfy-router/models/fal/flux-3-max/code): `fal/flux-3-max` - [H3 Max Turbo](/ko/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo` - [H3 Max](/ko/development/comfy-router/models/fal/h3-max/code): `fal/h3-max` - [Gemini Omni 1.2 Flash](/ko/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code): `gemini-interactions/gemini-omni-1.2-flash` -- [Higgsfield Genjutsu 모션 전송 V1.0](/ko/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` +- [Higgsfield Genjutsu Motion Transfer V1.0](/ko/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` - [Higgsfield Kling 3.4k](/ko/development/comfy-router/models/higgsfield/higgsfield-kling-3-4k/code): `higgsfield/higgsfield-kling-3-4k` - [Higgsfield Kling 3 Pro](/ko/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` - [Kling 3.0 Turbo](/ko/development/comfy-router/models/kling/kling-3-0-turbo/code): `kling/kling-3.0-turbo` @@ -90,102 +92,108 @@ translationBlockHashes: - [Kling V2.6](/ko/development/comfy-router/models/kling/kling-v2-6/code): `kling/kling-v2-6` - [Kling V3 Omni](/ko/development/comfy-router/models/kling/kling-v3-omni/code): `kling/kling-v3-omni` - [Kling V3](/ko/development/comfy-router/models/kling/kling-v3/code): `kling/kling-v3` -- [Kling 비디오 O1](/ko/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1` -- [비디오 아바타 이미지 2video](/ko/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` -- [비디오 립 싱크](/ko/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` +- [Kling Video O1](/ko/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1` +- [Videos Avatar Image 2video](/ko/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` +- [Videos Lip Sync](/ko/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` - [LTX 2.5 Fast](/ko/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ko/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` +- [LTX Video Alpha Gen](/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code): `ltx/ltx-video-alpha-gen` +- [LTX Video To Video Hdr](/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code): `ltx/ltx-video-to-video-hdr` +- [LTX Video To Video Reframe](/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code): `ltx/ltx-video-to-video-reframe` +- [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code): `ltx/ltx-video-upscale` - [Ray 3.2](/ko/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` - [MiniMax H3](/ko/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` -- [이미지 기반 비디오 생성](/ko/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` -- [텍스트 기반 비디오 생성](/ko/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` -- [비디오 기반 비디오 생성](/ko/development/comfy-router/models/moonvalley/video-to-video/code): `moonvalley/video-to-video` -- [Pika 2.5 이미지 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-2-5-image-to-video/code): `pika/pika-2.5-image-to-video` -- [Pika 2.5 텍스트 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-2-5-text-to-video/code): `pika/pika-2.5-text-to-video` -- [Pika H3 Flex 이미지 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` -- [Pika H3 Flex 레퍼런스 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` -- [Pika H3 Flex 텍스트 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` -- [Pika 사운드트랙](/ko/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` -- [P 비디오 2](/ko/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` +- [Image To Video](/ko/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` +- [Text To Video](/ko/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` +- [Video To Video](/ko/development/comfy-router/models/moonvalley/video-to-video/code): `moonvalley/video-to-video` +- [Pika 2.5 Image To Video](/ko/development/comfy-router/models/pika/pika-2-5-image-to-video/code): `pika/pika-2.5-image-to-video` +- [Pika 2.5 Text To Video](/ko/development/comfy-router/models/pika/pika-2-5-text-to-video/code): `pika/pika-2.5-text-to-video` +- [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` +- [Pika H3 Flex Reference To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` +- [Pika H3 Flex Text To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` +- [Pika Soundtrack](/ko/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` +- [V3.5](/ko/development/comfy-router/models/pixverse/v3-5/code): `pixverse/v3.5` +- [V6 Max](/ko/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max` +- [V6](/ko/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` +- [P Video 2](/ko/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/ko/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/ko/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` - [Sync 3](/ko/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` -- [오디오 비디오 정리](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` +- [Clean Audio Video](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` - [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [립싱크 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` -- [비디오 배경 제거 Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` -- [비디오 배경 제거 초록색 스크린](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` -- [비디오 배경 제거](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` -- [Veo 3.1 Fast 생성 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` -- [Veo 3.1 생성 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` -- [Veo 3.1 Lite 생성 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` +- [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Video Background Removal Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` +- [Video Background Removal Green Screen](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` +- [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` +- [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` +- [Veo 3.1 Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` +- [Veo 3.1 Lite Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` - [HappyHorse 1.0 R2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code): `wan/happyhorse-1.0-r2v` - [HappyHorse 1.0 T2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code): `wan/happyhorse-1.0-t2v` -- [HappyHorse 1.0 비디오 편집](/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code): `wan/happyhorse-1.0-video-edit` +- [HappyHorse 1.0 Video Edit](/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code): `wan/happyhorse-1.0-video-edit` - [HappyHorse 1.1 I2V](/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code): `wan/happyhorse-1.1-i2v` - [HappyHorse 1.1 R2V](/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code): `wan/happyhorse-1.1-r2v` - [HappyHorse 1.1 T2V](/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code): `wan/happyhorse-1.1-t2v` -- [Wan 2.5 I2V 미리보기](/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code): `wan/wan2.5-i2v-preview` -- [Wan 2.5 T2V 미리보기](/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` +- [Wan 2.5 I2V Preview](/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code): `wan/wan2.5-i2v-preview` +- [Wan 2.5 T2V Preview](/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/ko/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/ko/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` - [Wan 2.6 T2V](/ko/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` - [Wan 2.7 I2V](/ko/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 R2V](/ko/development/comfy-router/models/wan/wan2-7-r2v/code): `wan/wan2.7-r2v` - [Wan 2.7 T2V](/ko/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` -- [Wan 2.7 비디오 편집](/ko/development/comfy-router/models/wan/wan2-7-videoedit/code): `wan/wan2.7-videoedit` -- [Wan 3.0 비디오 Prime](/ko/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` -- [Wan 3.0 비디오](/ko/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` +- [Wan 2.7 Video Edit](/ko/development/comfy-router/models/wan/wan2-7-videoedit/code): `wan/wan2.7-videoedit` +- [Wan 3.0 Video Prime](/ko/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` +- [Wan 3.0 Video](/ko/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - [Flashvsr](/ko/development/comfy-router/models/wavespeed/flashvsr/code): `wavespeed/flashvsr` -- [Grok Imagine 비디오 1.5 Lite](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code): `xai/grok-imagine-video-1.5-lite` -- [Grok Imagine 비디오 1.5 미리보기](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code): `xai/grok-imagine-video-1.5-preview` -- [Grok Imagine 비디오 1.5](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5/code): `xai/grok-imagine-video-1.5` -- [Grok Imagine 비디오](/ko/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` +- [Grok Imagine Video 1.5 Lite](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code): `xai/grok-imagine-video-1.5-lite` +- [Grok Imagine Video 1.5 Preview](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code): `xai/grok-imagine-video-1.5-preview` +- [Grok Imagine Video 1.5](/ko/development/comfy-router/models/xai/grok-imagine-video-1-5/code): `xai/grok-imagine-video-1.5` +- [Grok Imagine Video](/ko/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` -- [지우기 V1](/ko/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` -- [FLUX 1.1 Pro Ultra 이미지](/ko/development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code): `bfl/flux-pro-1.1-ultra` +- [Erase V1](/ko/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` +- [Flux 1.1 Pro Ultra Image](/ko/development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code): `bfl/flux-pro-1.1-ultra` - [FLUX.1 Kontext](/ko/development/comfy-router/models/black-forest-labs/flux-1-kontext/code): `bfl/flux-kontext-pro` - [FLUX 2 Max](/ko/development/comfy-router/models/black-forest-labs/flux-2-max/code): `bfl/flux-2-max` - [FLUX 2 Pro](/ko/development/comfy-router/models/black-forest-labs/flux-2-pro/code): `bfl/flux-2-pro` -- [FLUX 3 이미지](/ko/development/comfy-router/models/black-forest-labs/flux-3-image/code): `bfl/flux-3-image` -- [FLUX Pro 1.0 확장](/ko/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code): `bfl/flux-pro-1.0-expand` -- [FLUX Pro 1.0 채우기](/ko/development/comfy-router/models/black-forest-labs/flux-pro-1-0-fill/code): `bfl/flux-pro-1.0-fill` +- [FLUX 3 Image](/ko/development/comfy-router/models/black-forest-labs/flux-3-image/code): `bfl/flux-3-image` +- [FLUX Pro 1.0 Expand](/ko/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code): `bfl/flux-pro-1.0-expand` +- [FLUX Pro 1.0 Fill](/ko/development/comfy-router/models/black-forest-labs/flux-pro-1-0-fill/code): `bfl/flux-pro-1.0-fill` - [VTO V1](/ko/development/comfy-router/models/black-forest-labs/vto-v1/code): `bfl/vto-v1` - [Fibo](/ko/development/comfy-router/models/bria/fibo/code): `bria/fibo` -- [이미지 편집 텍스트로 오브젝트 추가](/ko/development/comfy-router/models/bria/image-edit-add-object-by-text/code): `bria/image-edit-add-object-by-text` -- [이미지 편집 텍스트로 지우기](/ko/development/comfy-router/models/bria/image-edit-erase-by-text/code): `bria/image-edit-erase-by-text` -- [이미지 편집 전경 지우기](/ko/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` -- [이미지 편집 지우기](/ko/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` -- [이미지 편집 확장](/ko/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` -- [이미지 편집 생성 채우기](/ko/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` -- [이미지 편집 해상도 높이기](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` +- [Image Edit Add Object By Text](/ko/development/comfy-router/models/bria/image-edit-add-object-by-text/code): `bria/image-edit-add-object-by-text` +- [Image Edit Erase By Text](/ko/development/comfy-router/models/bria/image-edit-erase-by-text/code): `bria/image-edit-erase-by-text` +- [Image Edit Erase Foreground](/ko/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` +- [Image Edit Erase](/ko/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` +- [Image Edit Expand](/ko/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` +- [Image Edit Gen Fill](/ko/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill`- [이미지 편집 해상도 높이기](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [이미지 편집 제품 들기](/ko/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [이미지 편집 제품 가상 착용](/ko/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` -- [이미지 편집 Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` -- [Image Edit Remove Background Guided](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` -- [Image Edit Remove Background](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` -- [Image Edit Replace Background](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` -- [Image Edit Restore](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` -- [Image](/ko/development/comfy-router/models/bria/image/code): `bria/image` +- [이미지 편집 조명 변경](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` +- [이미지 편집 가이드 기반 배경 제거](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` +- [이미지 편집 배경 제거](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` +- [이미지 편집 배경 교체](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` +- [이미지 편집 텍스트로 객체 교체](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` +- [이미지 편집 계절 변경](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [이미지 편집 복원](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` +- [이미지](/ko/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` - [Seedream 4.5 251128](/ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code): `byteplus/seedream-4-5-251128` - [Seedream 5.0 260128](/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code): `byteplus/seedream-5-0-260128` - [Seedream 5.0 Flash 260915](/ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code): `byteplus/seedream-5-0-flash-260915` - [Seedream 5.0 Pro 260628](/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code): `byteplus/seedream-5-0-pro-260628` - [Seedream 5.5 261028](/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code): `byteplus/seedream-5-5-261028` -- [Crystal Upscaler](/ko/development/comfy-router/models/fal/crystal-upscaler/code): `fal/crystal-upscaler` +- [Crystal 업스케일러](/ko/development/comfy-router/models/fal/crystal-upscaler/code): `fal/crystal-upscaler` - [Patina](/ko/development/comfy-router/models/fal/patina/code): `fal/patina` -- [AI Image Upscaler Precision V2](/ko/development/comfy-router/models/freepik/ai-image-upscaler-precision-v2/code): `freepik/ai-image-upscaler-precision-v2` -- [AI Skin Enhancer Creative](/ko/development/comfy-router/models/freepik/ai-skin-enhancer-creative/code): `freepik/ai-skin-enhancer-creative` -- [AI Skin Enhancer Faithful](/ko/development/comfy-router/models/freepik/ai-skin-enhancer-faithful/code): `freepik/ai-skin-enhancer-faithful` -- [AI Skin Enhancer Flexible](/ko/development/comfy-router/models/freepik/ai-skin-enhancer-flexible/code): `freepik/ai-skin-enhancer-flexible` +- [AI 이미지 업스케일러 Precision V2](/ko/development/comfy-router/models/freepik/ai-image-upscaler-precision-v2/code): `freepik/ai-image-upscaler-precision-v2` +- [AI 피부 보정 Creative](/ko/development/comfy-router/models/freepik/ai-skin-enhancer-creative/code): `freepik/ai-skin-enhancer-creative` +- [AI 피부 보정 Faithful](/ko/development/comfy-router/models/freepik/ai-skin-enhancer-faithful/code): `freepik/ai-skin-enhancer-faithful` +- [AI 피부 보정 Flexible](/ko/development/comfy-router/models/freepik/ai-skin-enhancer-flexible/code): `freepik/ai-skin-enhancer-flexible` - [Gemini Omni 1.1 Flash](/ko/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code): `gemini-interactions/gemini-omni-1.1-flash` - [Gemini Omni Flash Preview](/ko/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code): `gemini-interactions/gemini-omni-flash-preview` - [Gemini 2.5 Flash Image](/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code): `vertexai/gemini-2.5-flash-image` @@ -212,11 +220,12 @@ translationBlockHashes: - [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` -- [GPT Image 2.6 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare` -- [GPT Image 2.6 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` -- [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` -- [Qwen Image 3.0 Pro](/ko/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` -- [Qwen Image 3.0](/ko/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` +- [GPT Image 2.6 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare`- [GPT 이미지 2.6 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` +- [GPT 이미지 2](/ko/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` +- [화살표 2 Telos](/ko/development/comfy-router/models/quiver/arrow-2-telos/code): `quiver/arrow-2-telos` +- [화살표 2](/ko/development/comfy-router/models/quiver/arrow-2/code): `quiver/arrow-2` +- [qwen 이미지 3.0 Pro](/ko/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` +- [qwen 이미지 3.0](/ko/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/ko/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` - [Recraft V3](/ko/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` - [Recraft V4.1 Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` @@ -233,36 +242,35 @@ translationBlockHashes: - [Recraft V4 Styles Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/ko/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` - [Recraft V4](/ko/development/comfy-router/models/recraft/recraftv4/code): `recraft/recraftv4` -- [Gen 4 Image](/ko/development/comfy-router/models/runway/gen4-image/code): `runway/gen4_image` -- [Control Sketch](/ko/development/comfy-router/models/stability/control-sketch/code): `stability/control-sketch` -- [Control Structure](/ko/development/comfy-router/models/stability/control-structure/code): `stability/control-structure` -- [Control Style Transfer](/ko/development/comfy-router/models/stability/control-style-transfer/code): `stability/control-style-transfer` -- [Control Style](/ko/development/comfy-router/models/stability/control-style/code): `stability/control-style` -- [Edit Erase](/ko/development/comfy-router/models/stability/edit-erase/code): `stability/edit-erase` -- [Edit Inpaint](/ko/development/comfy-router/models/stability/edit-inpaint/code): `stability/edit-inpaint` -- [Edit Outpaint](/ko/development/comfy-router/models/stability/edit-outpaint/code): `stability/edit-outpaint` -- [Edit Remove Background](/ko/development/comfy-router/models/stability/edit-remove-background/code): `stability/edit-remove-background` -- [Edit Replace Background And Relight](/ko/development/comfy-router/models/stability/edit-replace-background-and-relight/code): `stability/edit-replace-background-and-relight` -- [Edit Search And Recolor](/ko/development/comfy-router/models/stability/edit-search-and-recolor/code): `stability/edit-search-and-recolor` -- [Edit Search And Replace](/ko/development/comfy-router/models/stability/edit-search-and-replace/code): `stability/edit-search-and-replace` -- [Generate Core](/ko/development/comfy-router/models/stability/generate-core/code): `stability/generate-core` -- [Generate Ultra](/ko/development/comfy-router/models/stability/generate-ultra/code): `stability/generate-ultra` +- [Gen 4 이미지](/ko/development/comfy-router/models/runway/gen4-image/code): `runway/gen4_image` +- [Control 스케치](/ko/development/comfy-router/models/stability/control-sketch/code): `stability/control-sketch` +- [Control 구조](/ko/development/comfy-router/models/stability/control-structure/code): `stability/control-structure` +- [Control 스타일 전송](/ko/development/comfy-router/models/stability/control-style-transfer/code): `stability/control-style-transfer` +- [Control 스타일](/ko/development/comfy-router/models/stability/control-style/code): `stability/control-style` +- [편집 지우기](/ko/development/comfy-router/models/stability/edit-erase/code): `stability/edit-erase` +- [편집 Inpaint](/ko/development/comfy-router/models/stability/edit-inpaint/code): `stability/edit-inpaint` +- [편집 Outpaint](/ko/development/comfy-router/models/stability/edit-outpaint/code): `stability/edit-outpaint` +- [편집 배경 제거](/ko/development/comfy-router/models/stability/edit-remove-background/code): `stability/edit-remove-background` +- [편집 배경 교체 및 재조명](/ko/development/comfy-router/models/stability/edit-replace-background-and-relight/code): `stability/edit-replace-background-and-relight` +- [편집 검색 및 색상 변경](/ko/development/comfy-router/models/stability/edit-search-and-recolor/code): `stability/edit-search-and-recolor` +- [편집 검색 및 교체](/ko/development/comfy-router/models/stability/edit-search-and-replace/code): `stability/edit-search-and-replace` +- [생성 Core](/ko/development/comfy-router/models/stability/generate-core/code): `stability/generate-core` +- [생성 Ultra](/ko/development/comfy-router/models/stability/generate-ultra/code): `stability/generate-ultra` - [Sd3.5 Flash](/ko/development/comfy-router/models/stability/sd3-5-flash/code): `stability/sd3.5-flash` - [Sd3.5 Large Turbo](/ko/development/comfy-router/models/stability/sd3-5-large-turbo/code): `stability/sd3.5-large-turbo` - [Sd3.5 Large](/ko/development/comfy-router/models/stability/sd3-5-large/code): `stability/sd3.5-large` - [Sd3.5 Medium](/ko/development/comfy-router/models/stability/sd3-5-medium/code): `stability/sd3.5-medium` -- [Sdxl 1.0 Image To Image](/ko/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code): `stability/sdxl-1.0-image-to-image` -- [Sdxl 1.0 Masking](/ko/development/comfy-router/models/stability/sdxl-1-0-masking/code): `stability/sdxl-1.0-masking` -- [Sdxl 1.0 Text To Image](/ko/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code): `stability/sdxl-1.0-text-to-image` +- [Sdxl 1.0 이미지 기반 이미지 생성](/ko/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code): `stability/sdxl-1.0-image-to-image` +- [Sdxl 1.0 마스킹](/ko/development/comfy-router/models/stability/sdxl-1-0-masking/code): `stability/sdxl-1.0-masking` +- [Sdxl 1.0 텍스트 기반 이미지 생성](/ko/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code): `stability/sdxl-1.0-text-to-image` - [Upscale Conservative](/ko/development/comfy-router/models/stability/upscale-conservative/code): `stability/upscale-conservative` - [Upscale Creative](/ko/development/comfy-router/models/stability/upscale-creative/code): `stability/upscale-creative` - [Upscale Fast](/ko/development/comfy-router/models/stability/upscale-fast/code): `stability/upscale-fast` -- [Wan 2.5 I2I Preview](/ko/development/comfy-router/models/wan/wan2-5-i2i-preview/code): `wan/wan2.5-i2i-preview` -- [Wan 2.5 T2I Preview](/ko/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` +- [Wan 2.5 I2I 미리보기](/ko/development/comfy-router/models/wan/wan2-5-i2i-preview/code): `wan/wan2.5-i2i-preview` +- [Wan 2.5 T2I 미리보기](/ko/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` - [Seedvr 2](/ko/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` -- [Ultimate Image Upscaler](/ko/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` -- [Grok Imagine Image 2.0](/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0` -- [Grok Imagine Image Pro](/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` +- [Ultimate 이미지 Upscaler](/ko/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` +- [Grok Imagine 이미지 2.0](/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0`- [Grok Imagine Image Pro](/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` - [Grok Imagine Image Quality](/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code): `xai/grok-imagine-image-quality` - [Grok Imagine Image](/ko/development/comfy-router/models/xai/grok-imagine-image/code): `xai/grok-imagine-image` @@ -274,10 +282,9 @@ translationBlockHashes: - [Dreamina Seedance 2.0 Fast 260128](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` - [Dreamina Seedance 2.0 Mini](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` - [Dreamina Seedance 2.5 260628](/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` -- [Seed Audio 1.0 다국어](/ko/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` +- [Seed Audio 1.0 Multilingual](/ko/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/ko/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` -- [Seedance 1.5 Pro 251215](/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` -- [Eleven 다국어 V2](/ko/development/comfy-router/models/elevenlabs/eleven-multilingual-v2/code): `elevenlabs/eleven_multilingual_v2` +- [Eleven Multilingual V2](/ko/development/comfy-router/models/elevenlabs/eleven-multilingual-v2/code): `elevenlabs/eleven_multilingual_v2` - [Eleven Sfx V2](/ko/development/comfy-router/models/elevenlabs/eleven-sfx-v2/code): `elevenlabs/eleven_sfx_v2` - [Eleven V3](/ko/development/comfy-router/models/elevenlabs/eleven-v3/code): `elevenlabs/eleven_v3` - [Eleven V4 Turbo](/ko/development/comfy-router/models/elevenlabs/eleven-v4-turbo/code): `elevenlabs/eleven_v4_turbo` @@ -292,18 +299,19 @@ translationBlockHashes: - [Higgsfield Kling 3 Pro](/ko/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` - [LTX 2.5 Fast](/ko/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ko/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` +- [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code): `ltx/ltx-video-upscale` - [MiniMax H3](/ko/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` -- [Pika H3 Flex 이미지 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` -- [Pika H3 Flex 레퍼런스 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` -- [Pika H3 Flex 텍스트 기반 비디오 생성](/ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` +- [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` +- [Pika H3 Flex Reference To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` +- [Pika H3 Flex Text To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika Music](/ko/development/comfy-router/models/pika/pika-music/code): `pika/pika-music` - [Pika Sfx](/ko/development/comfy-router/models/pika/pika-sfx/code): `pika/pika-sfx` - [Pika Soundtrack](/ko/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` - [P Video 2](/ko/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` -- [오디오 비디오 정리](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` -- [오디오 정리](/ko/development/comfy-router/models/veed/clean-audio/code): `veed/clean-audio` +- [Clean Audio Video](/ko/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` +- [Clean Audio](/ko/development/comfy-router/models/veed/clean-audio/code): `veed/clean-audio` - [Fabric 1.0](/ko/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` -- [립싱크 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` @@ -320,12 +328,11 @@ translationBlockHashes: -- [애니메이션](/ko/development/comfy-router/models/meshy/animations/code): `meshy/animations` +- [Animations](/ko/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/ko/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` -- [Meshy 7.1](/ko/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` -- [Meshy 7](/ko/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` +- [Meshy 7.1](/ko/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1`- [Meshy 7](/ko/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` - [Remesh](/ko/development/comfy-router/models/meshy/remesh/code): `meshy/remesh` -- [리깅](/ko/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` +- [Rigging](/ko/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/ko/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` - [Stable Point Aware 3D](/ko/development/comfy-router/models/stability/stable-point-aware-3d/code): `stability/stable-point-aware-3d` - [Hunyuan 3D Part](/ko/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part` @@ -334,7 +341,7 @@ translationBlockHashes: - [Hunyuan 3D Uv](/ko/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/ko/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/ko/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -358,6 +365,9 @@ translationBlockHashes: - [Gemini 3.1 Flash Lite](/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code): `vertexai/gemini-3.1-flash-lite` - [Gemini 3.7 Flash](/ko/development/comfy-router/models/google/gemini-3-7-flash/code): `vertexai/gemini-3.7-flash` - [Gemini 3.8 Flash](/ko/development/comfy-router/models/google/gemini-3-8-flash/code): `vertexai/gemini-3.8-flash` +- [Gemini 4 Argon](/ko/development/comfy-router/models/google/gemini-4-argon/code): `vertexai/gemini-4-argon` +- [Gemini 4 Carbon](/ko/development/comfy-router/models/google/gemini-4-carbon/code): `vertexai/gemini-4-carbon` +- [Gemini 4 Hydrogen](/ko/development/comfy-router/models/google/gemini-4-hydrogen/code): `vertexai/gemini-4-hydrogen` - [Gemini Nano Banana 2.1](/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code): `vertexai/gemini-nano-banana-2.1` - [Google Gemini](/ko/development/comfy-router/models/google/gemini/code): `vertexai/gemini-3.1-pro-preview` - [Nano Banana 2 Lite](/ko/development/comfy-router/models/google/nano-banana-2-lite/code): `vertexai/gemini-3.1-flash-lite-image` @@ -375,8 +385,7 @@ translationBlockHashes: - [GPT 5 Nano](/ko/development/comfy-router/models/openai/gpt-5-nano/code): `openai/gpt-5-nano` - [GPT 5](/ko/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6.1 Sol](/ko/development/comfy-router/models/openai/gpt-6-1-sol/code): `openai/gpt-6.1-sol` -- [GPT 6.1 Terra](/ko/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra` -- [GPT 6 Astra](/ko/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` +- [GPT 6.1 Terra](/ko/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra`- [GPT 6 Astra](/ko/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ko/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` - [o3](/ko/development/comfy-router/models/openai/o3/code): `openai/o3` @@ -467,7 +476,6 @@ translationBlockHashes: | [Seed Audio 1.0](/ko/development/comfy-router/models/byteplus/seed-audio-1-0/code) | `byteplus/seed-audio-1.0` | 텍스트 | 오디오 | | [Seedance 1.0 Pro 250528](/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code) | `byteplus/seedance-1-0-pro-250528` | 텍스트, 이미지 | 비디오 | | [Seedance 1.0 Pro Fast 251015](/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code) | `byteplus/seedance-1-0-pro-fast-251015` | 텍스트, 이미지 | 비디오 | -| [Seedance 1.5 Pro 251215](/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code) | `byteplus/seedance-1-5-pro-251215` | 텍스트, 이미지 | 비디오 + 오디오 | | [Seedream 4.0 250828](/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code) | `byteplus/seedream-4-0-250828` | 텍스트, 이미지 | 이미지 | | [Seedream 4.5 251128](/ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code) | `byteplus/seedream-4-5-251128` | 텍스트, 이미지 | 이미지 | | [Seedream 5.0 260128](/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | 텍스트, 이미지 | 이미지 | @@ -521,6 +529,9 @@ translationBlockHashes: | [Gemini 3.1 Flash Lite](/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | 텍스트, 이미지, 오디오, 비디오 | 텍스트 | | [Gemini 3.7 Flash](/ko/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | 텍스트, 이미지, 오디오, 비디오 | 텍스트 | | [Gemini 3.8 Flash](/ko/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | 텍스트, 이미지, 오디오, 비디오 | 텍스트 | +| [Gemini 4 Argon](/ko/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | 텍스트, 이미지, 오디오, 비디오 | 텍스트 | +| [Gemini 4 Carbon](/ko/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | 텍스트, 이미지, 오디오, 비디오 | 텍스트 | +| [Gemini 4 Hydrogen](/ko/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | 텍스트, 이미지, 오디오, 비디오 | 텍스트 | | [Gemini Nano Banana 2.1](/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | `vertexai/gemini-nano-banana-2.1` | 텍스트, 이미지, 비디오 | 이미지 + 텍스트 | | [Google Gemini](/ko/development/comfy-router/models/google/gemini/code) | `vertexai/gemini-3.1-pro-preview` | 텍스트, 이미지, 오디오, 비디오 | 텍스트 | | [Nano Banana 2 Lite](/ko/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | 텍스트, 이미지, 비디오 | 이미지 + 텍스트 | @@ -581,6 +592,10 @@ translationBlockHashes: | --- | --- | --- | --- | | [LTX 2.5 Fast](/ko/development/comfy-router/models/ltx/ltx-2-5-fast/code) | `ltx/ltx-2-5-fast` | 텍스트 | 비디오 + 오디오 | | [LTX 2.5 Pro](/ko/development/comfy-router/models/ltx/ltx-2-5-pro/code) | `ltx/ltx-2-5-pro` | 텍스트 | 비디오 + 오디오 | +| [LTX Video Alpha Gen](/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 비디오 | 비디오 | +| [LTX Video To Video Hdr](/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 비디오 | 비디오 | +| [LTX Video To Video Reframe](/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 비디오 | 비디오 | +| [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 비디오 | 비디오 + 오디오 | ## Luma @@ -671,12 +686,27 @@ translationBlockHashes: | [Pika Sfx](/ko/development/comfy-router/models/pika/pika-sfx/code) | `pika/pika-sfx` | 텍스트 | 오디오 | | [Pika Soundtrack](/ko/development/comfy-router/models/pika/pika-soundtrack/code) | `pika/pika-soundtrack` | 비디오, 텍스트 | 비디오 + 오디오 | +## Pixverse + +| 모델 | ID | 입력 | 출력 | +| --- | --- | --- | --- | +| [V3.5](/ko/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | 텍스트 | 비디오 | +| [V6 Max](/ko/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | 텍스트 | 비디오 | +| [V6](/ko/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | 텍스트 | 비디오 | + ## Pruna | 모델 | ID | 입력 | 출력 | | --- | --- | --- | --- | | [P Video 2](/ko/development/comfy-router/models/pruna/p-video-2/code) | `pruna/p-video-2` | 텍스트, 이미지, 오디오 | 비디오 + 오디오 | +## Quiver + +| 모델 | ID | 입력 | 출력 | +| --- | --- | --- | --- | +| [Arrow 2 Telos](/ko/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 텍스트, 이미지 | 이미지 | +| [Arrow 2](/ko/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 텍스트, 이미지 | 이미지 | + ## Qwen | 모델 | ID | 입력 | 출력 | diff --git a/ko/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx b/ko/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx index 688f7e037c..348b90226a 100644 --- a/ko/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router로 Claude Sonnet 5.5 사용하기" description: "Comfy Router를 통해 anthropic/claude-sonnet-5-5 호출: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." sidebarTitle: "Claude Sonnet 5.5" -translationSourceHash: 021cc189 +translationSourceHash: f0a03fa9 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx translationBlockHashes: "_intro": f09ded46 "Quick start": b8433ece - "Schema": 3a226e7f + "Schema": e5d10df7 "Examples": f08878ed --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-5-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -192,7 +193,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-5-5/requests/$REQUE - true이면 응답은 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`입니다. + Comfy Router 경로 `POST /v2/models/anthropic/{model}`에서 `stream`은 아무 효과가 없습니다(INERT). Router는 디스패치 이전에 이를 `false`로 확정하며, 항상 완료된 메시지를 하나의 JSON 문서로 반환합니다. v1 `POST /proxy/anthropic/v1/messages` 경로에서는 `true`이면 응답이 단일 JSON 본문 대신 Anthropic 메시지 이벤트의 `text/event-stream`이 됩니다. Router에서는 `stream`에 false를 보내거나 생략하세요. `/proxy/` 오퍼레이션의 200 응답 중 `text/event-stream` 부분에는 Router에 대응하는 동작이 없습니다. diff --git a/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index 46c02ef969..f12eab8ea3 100644 --- a/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Gemini 3.1 Flash Lite 사용하기" description: "Comfy Router를 통해 vertexai/gemini-3.1-flash-lite를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Gemini 3.1 Flash Lite" -translationSourceHash: 52b7530c +translationSourceHash: 1a291975 translationFrom: development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx translationBlockHashes: "_intro": 408e9eae "Quick start": 869398cb - "Schema": 1d473fa3 + "Schema": 2859a2da "Examples": 2ebce337 --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-3.1-flash-lite.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -201,33 +202,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하십시오. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 산입됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash에서는 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + 원시 바이트의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하십시오. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 산입됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 레이트 프레임 샘플링 대신 검사할 세그먼트를 모델이 직접 결정하도록 하려면 "AGENTIC"으로 설정하십시오. 생략하면 기본 고정 레이트 샘플링이 사용됩니다. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. - 텍스트 프롬프트 또는 코드 조각입니다. + 텍스트 프롬프트 또는 코드 스니펫입니다. @@ -239,35 +240,35 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 값을 적용하고, 나머지 필드는 모델 자체 동작을 따릅니다. + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 값을 적용하고, 나머지는 모델 자체 동작으로 대체됩니다. - 이미지 생성 구성 + 이미지 생성을 위한 구성 - 생성된 이미지의 가로세로 비율 + 생성된 이미지의 가로 세로 비율 - 선택 사항. 생성된 이미지의 이미지 출력 형식입니다. + 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. - 선택 사항. 출력 이미지의 압축 품질입니다. + 선택 사항입니다. 출력 이미지의 압축 품질입니다. - 선택 사항. 출력을 저장할 이미지 형식으로, Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에 적용됩니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청을 전달하기 전에 소문자로 정규화합니다. 다른 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 그런 속성이 없고 이 필드가 있으면 호출 전체를 거부하므로, 이 필드는 반영되거나 거부되는 대신 요청에서 제거되며, 출력 형식은 AI Studio가 선택하는 값을 따릅니다. 모든 경로에서 보낸 값을 가정하지 말고, 주어진 응답 파트(`inlineData.mimeType`, `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`)에서 미디어 타입을 다시 읽으십시오. + 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력을 저장할 이미지 형식입니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치하며 요청이 전달되기 전에 소문자로 정규화됩니다. 다른 값은 이 필드를 명시한 400 오류로 거부됩니다. 생략하면 `image/png`로 기본 설정됩니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이러한 속성이 없으며 이 속성이 있으면 전체 호출을 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거됩니다. 출력 형식은 AI Studio가 선택하는 값입니다. 모든 경로에서 보낸 값을 가정하지 말고, 제공받은 응답 부분에서 미디어 유형을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). - 선택 사항. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델이 기본값 1K를 사용합니다. - 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 대략 4자에 해당합니다. 100 토큰은 대략 60~80 단어에 해당합니다. + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰 하나는 대략 4자입니다. 100토큰은 대략 60-80단어에 해당합니다. 범위: `16` ~ `65536` @@ -277,8 +278,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - -seed가 특정 값으로 고정되면, 모델은 반복되는 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 seed 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로는 임의의 seed 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 +When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Available for the following models:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -286,7 +286,7 @@ seed가 특정 값으로 고정되면, 모델은 반복되는 요청에 대해 - temperature는 응답 생성 중 샘플링에 사용되며, topP와 topK가 적용될 때 발생합니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하고 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정적이지만 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공한다면 temperature를 높여 보세요. + temperature는 응답 생성 중 샘플링에 사용되며, topP와 topK가 적용될 때 발생합니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정적이지만, 소량의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공하는 경우 temperature를 높여 보세요. 범위: `0` ~ `2` @@ -294,33 +294,33 @@ seed가 특정 값으로 고정되면, 모델은 반복되는 요청에 대해 - 선택 사항입니다. 사고(thinking) 기능에 대한 구성입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + 선택 사항입니다. 사고 기능에 대한 설정입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. - 선택 사항입니다. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. + 선택 사항입니다. 참이면 모델이 응답에 자신의 사고 내용을 포함합니다. - 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산을 지키기 위해 최선을 다합니다. + 선택 사항입니다. 모델의 사고 과정에 대한 토큰 예산입니다. 모델은 이 예산 범위를 유지하기 위해 최선을 다합니다. 선택 사항입니다. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K는 모델이 출력을 위해 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음으로 선택되는 토큰은 모델 어휘의 모든 토큰 중에서 가장 확률이 높은 토큰입니다. Top-K가 3이면 다음 토큰은 temperature를 사용하여 가장 확률이 높은 3개 토큰 중에서 선택됩니다. + Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중에서 가장 확률이 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개의 토큰 중에서 다음 토큰이 선택됩니다. 범위: `1` ~ `…` 지정하면 nucleus 샘플링이 사용됩니다. -Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 것(top-K 참조)부터 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. -더 무작위성이 적은 응답을 원하면 낮은 값을, 더 무작위성이 큰 응답을 원하면 높은 값을 지정하세요. +Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 것(see top-K)부터 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5이면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +무작위성이 낮은 응답을 원하면 낮은 값을, 무작위성이 높은 응답을 원하면 높은 값을 지정하세요. 범위: `0` ~ `1` @@ -340,11 +340,11 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 변경합 - 모델이 더 나은 성능을 내도록 유도하기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며 각 part의 content는 별도의 문단에 있어야 합니다. + 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "Answer as concisely as possible" 또는 "Don't use technical terms in your response"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 문단에 있어야 합니다. - 하나의 메시지를 구성하는 순서가 지정된 part의 목록입니다. part마다 서로 다른 IANA MIME 타입을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한에 대해서는 Google 모델 페이지의 모델 사양을 참조하세요. + 하나의 메시지를 구성하는 순서가 지정된 part 목록입니다. part마다 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. @@ -352,13 +352,13 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 변경합 - 메시지를 생성하는 주체의 정체성입니다. 다음 값을 지원합니다. user: 실제 사람이 보낸 메시지임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 모델이 생성한 메시지임을 나타냅니다. model 값은 멀티턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 멀티턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않을 수 있습니다. + 메시지를 생성하는 엔터티의 정체성입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람, 일반적으로 사용자가 생성한 메시지임을 나타냅니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 멀티턴 대화 중에 모델의 메시지를 대화에 삽입할 때 사용됩니다. 멀티턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않아도 됩니다. 가능한 값: `user`, `model` - 시스템이 모델의 지식과 범위를 벗어난 작업 또는 작업 집합을 수행하기 위해 외부 시스템과 상호 작용할 수 있게 해 주는 코드 조각입니다. 함수 호출(Function calling)을 참조하세요. + 시스템이 모델의 지식과 범위 밖에서 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호 작용할 수 있게 해주는 코드 조각입니다. Function calling을 참조하세요. @@ -378,11 +378,11 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 변경합 - true이면 생성된 이미지가 클라우드 스토리지에 업로드되며, 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + 참이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. - 비디오 입력의 경우, Duration 형식으로 표시된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 이 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + 비디오 입력의 경우, Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. @@ -390,13 +390,13 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 변경합 - 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 네거티브 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 초 단위 소수 부분(부호 있음)입니다. 소수 부분이 있는 음수 초 값이라도 나노 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + 시간 범위의 초 단위 값(부호 있음)입니다. -315,576,000,000에서 +315,576,000,000까지(포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` @@ -406,18 +406,18 @@ Top-P는 모델이 출력을 위해 토큰을 선택하는 방식을 변경합 - 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 네거티브 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 초 단위 소수 부분(부호 있음)입니다. 소수 부분이 있는 음수 초 값이라도 나노 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + 시간 범위의 초 단위 값(부호 있음)입니다. -315,576,000,000에서 +315,576,000,000까지(포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` -Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 기준이 되는 동일한 문서입니다. +Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -478,13 +478,13 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 오디오가 없는 비디오 파일의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash에서는 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. @@ -494,17 +494,17 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 오디오가 없는 비디오 파일의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 속도 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 속도 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. - 텍스트 프롬프트 또는 코드 스니펫입니다. + 텍스트 프롬프트 또는 코드 조각입니다. @@ -528,13 +528,13 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다 + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - 응답이 생성된 시각입니다. + 응답이 생성된 시점의 타임스탬프입니다. @@ -557,8 +557,10 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + 콘텐츠가 위반한 안전 카테고리입니다. + + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` @@ -576,7 +578,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - 출력 전용. 입력의 캐시된 부분(캐시된 콘텐츠)에 있는 토큰 수입니다. + 출력 전용. 입력의 캐시된 부분(캐시된 콘텐츠)에 포함된 토큰 수입니다. @@ -584,7 +586,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - 모달리티별 후보 토큰의 내역입니다. + 모달리티별 후보 토큰의 세부 내역입니다. @@ -594,15 +596,15 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - 해당 모달리티의 토큰 수입니다. + 지정된 모달리티의 토큰 수입니다. - 요청에 포함된 토큰 수입니다. cachedContent가 설정된 경우에도 이는 전체 유효 프롬프트 크기이며, 따라서 캐시된 콘텐츠의 토큰 수를 포함합니다. + 요청에 포함된 토큰 수입니다. cachedContent가 설정된 경우에도 이 값은 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. - 모달리티별 프롬프트 토큰의 내역입니다. + 모달리티별 프롬프트 토큰의 세부 내역입니다. @@ -612,7 +614,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - 해당 모달리티의 토큰 수입니다. + 지정된 모달리티의 토큰 수입니다. @@ -624,7 +626,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - 모달리티별 도구 사용 프롬프트 토큰의 내역입니다. + 모달리티별 도구 사용 프롬프트 토큰의 세부 내역입니다. @@ -634,11 +636,11 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`에서 제 - 해당 모달리티의 토큰 수입니다. + 지정된 모달리티의 토큰 수입니다. - 전체 토큰 수(프롬프트 + 후보)입니다. + 총 토큰 수(프롬프트 + 후보)입니다. diff --git a/ko/development/comfy-router/models/google/gemini/code.mdx b/ko/development/comfy-router/models/google/gemini/code.mdx index 5434f7fc2c..7cf6b085de 100644 --- a/ko/development/comfy-router/models/google/gemini/code.mdx +++ b/ko/development/comfy-router/models/google/gemini/code.mdx @@ -2,7 +2,7 @@ title: "Comfy Router로 Google Gemini 사용하기" description: "Comfy Router를 통해 HTTP로 Google Gemini 텍스트 모델을 호출하는 Python, TypeScript, cURL 코드 조각과 요청 필드 및 결과 형태" sidebarTitle: "Google Gemini" -translationSourceHash: ccf669d3 +translationSourceHash: 0958828b translationFrom: development/comfy-router/models/google/gemini/code.mdx --- @@ -326,7 +326,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests/$R 선택 사항입니다. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -1017,7 +1017,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST 선택 사항입니다. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` diff --git a/ko/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/ko/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index e3f3cc7555..4c938ab294 100644 --- a/ko/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/ko/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Nano Banana 2 Lite 사용하기" description: "Comfy Router를 통해 HTTP로 Nano Banana 2 Lite(Gemini 3.1 Flash-Lite Image)로 이미지를 생성하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Nano Banana 2 Lite" -translationSourceHash: 6381740d +translationSourceHash: 75deda90 translationFrom: development/comfy-router/models/google/nano-banana-2-lite/code.mdx translationBlockHashes: "_intro": 9a5badea "Quick start": 0622ad83 - "Schema": ededaa40 + "Schema": 3b274fc9 "Examples": d294783d --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -217,7 +218,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques ### 입력 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. @@ -233,7 +234,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -249,13 +250,13 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 레이트 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하게 하려면 "AGENTIC"을 설정하세요. 기본 고정 레이트 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"을 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. @@ -271,15 +272,15 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 생성에 사용할 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략하면 그 값을 적용하고, 나머지는 모델 자체 동작으로 대체됩니다. + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 값을 적용하고, 나머지는 모델 자체 동작으로 대체됩니다. - 이미지 생성을 위한 구성 + 이미지 생성을 위한 구성입니다. - 생성된 이미지의 가로세로 비율 + 생성된 이미지의 가로세로 비율입니다. @@ -291,7 +292,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력을 어떤 이미지 형식으로 저장할지 지정합니다. 여기서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청이 전달되기 전에 소문자로 정규화됩니다. 다른 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 기본값은 `image/png`입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없고 이 필드가 있으면 호출 전체를 거부하므로, 이 필드는 반영되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 값이 됩니다. 모든 경로에서 보낸 값을 가정하지 말고 제공받은 응답 부분에서 미디어 유형을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). + 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력을 저장할 이미지 형식입니다. 여기서 허용되는 값은 `image/png` 및 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키며 요청이 전달되기 전에 소문자로 정규화됩니다. 다른 값은 이 필드를 지목하는 400 오류로 거부됩니다. 생략하면 기본값은 `image/png`입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 그러한 속성이 없으며 이 속성이 있으면 전체 호출을 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 값이 됩니다. 모든 경로에서 보낸 값을 가정하지 말고 제공된 응답 부분에서 미디어 유형을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). @@ -299,7 +300,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰 하나는 대략 4자입니다. 100 토큰은 대략 60-80 단어에 해당합니다. + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 대략 4자입니다. 100토큰은 대략 60~80단어에 해당합니다. 범위: `16` ~ `65536` @@ -309,7 +310,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 시드가 특정 값으로 고정되면 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적인 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변화가 생길 수 있습니다. 기본적으로 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 +시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델 또는 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변형이 발생할 수 있습니다. 기본적으로 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -317,7 +318,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - temperature는 topP와 topK가 적용될 때 발생하는, 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만, 약간의 변동은 여전히 발생할 수 있습니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 폴백 응답을 제공하는 경우 temperature를 높여 보세요. + temperature는 topP와 topK가 적용될 때 발생하는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과를 만들 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 특정 프롬프트에 대한 응답은 대부분 결정론적이지만 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공하는 경우 temperature를 높여 보세요. 범위: `0` ~ `2` @@ -325,33 +326,33 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 선택 사항. 사고(thinking) 기능에 대한 설정입니다. 사고란 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + 선택 사항입니다. 사고 기능에 대한 구성입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. - 선택 사항. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. + 선택 사항입니다. true이면 모델이 응답에 자신의 사고를 포함합니다. - 선택 사항. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산 내에서 유지하기 위해 최선을 다합니다. + 선택 사항입니다. 모델의 사고 과정에 대한 토큰 예산입니다. 모델은 이 예산 내에서 유지하기 위해 최선을 다합니다. - 선택 사항. 모델의 사고 수준입니다. + 선택 사항입니다. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중 확률이 가장 높은 토큰입니다. Top-K가 3이면 temperature를 사용해 확률이 가장 높은 3개 토큰 중에서 다음 토큰이 선택됩니다. + Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중에서 가장 확률이 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 가장 확률이 높은 3개의 토큰 중에서 다음 토큰이 선택됩니다. 범위: `1` ~ `…` - 지정하면 뉴클리어스 샘플링이 사용됩니다. -Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은(top-K 참고) 토큰부터 가장 낮은 토큰까지 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5이면, 모델은 temperature를 사용해 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. -무작위성이 낮은 응답을 원하면 더 낮은 값을, 무작위성이 높은 응답을 원하면 더 높은 값을 지정하세요. + 지정하면 nucleus 샘플링이 사용됩니다. +Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 가장 확률이 높은 것(top-K 참조)에서 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5이면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +덜 무작위적인 응답에는 낮은 값을, 더 무작위적인 응답에는 높은 값을 지정하세요. 범위: `0` ~ `1` @@ -359,7 +360,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 안전하지 않은 콘텐츠를 차단하기 위한 요청별 설정입니다. GenerateContentResponse.candidates에 적용됩니다. + 요청별로 안전하지 않은 콘텐츠를 차단하기 위한 설정입니다. GenerateContentResponse.candidates에 적용됩니다. @@ -371,11 +372,11 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 모델이 더 나은 성능을 내도록 이끄는 지침입니다. 예를 들어 "가능한 한 간결하게 답하세요" 또는 "응답에 전문 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. + 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예: "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요". 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. - 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참고하세요. + 단일 메시지를 구성하는 순서가 있는 parts 목록입니다. part마다 IANA MIME 유형이 다를 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. @@ -383,13 +384,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람에 의해 전송되었음을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 다중 턴 대화에서 모델의 메시지를 대화에 삽입할 때 사용됩니다. 다중 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않을 수 있습니다. + 메시지를 생성하는 엔터티의 ID입니다. 다음 값이 지원됩니다: user: 실제 사람이 보낸 메시지임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 모델이 생성한 메시지임을 나타냅니다. model 값은 다중 턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 다중 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않을 수 있습니다. 가능한 값: `user`, `model` - 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 시스템이 외부 시스템과 상호 작용할 수 있게 하는 코드 조각입니다. 함수 호출을 참고하세요. + 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호 작용할 수 있게 하는 코드 조각입니다. Function calling을 참조하세요. @@ -409,11 +410,11 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - true이면 생성된 이미지가 클라우드 스토리지에 업로드되고, 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 이후에 만료됩니다. + true이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. - 비디오 입력의 경우, 비디오의 시작 및 종료 오프셋을 Duration 형식으로 지정합니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공될 때만 지정해야 합니다. + 비디오 입력의 경우 비디오의 시작 및 종료 오프셋을 재생 시간 형식으로 나타냅니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData에 표시되는 동안에만 지정해야 합니다. @@ -421,13 +422,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도로 표현된 초의 부호 있는 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. + 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 음수 초 값도 여전히 음수가 아닌 nanos 값을 가져야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000 이상 +315,576,000,000 이하이어야 합니다. + 시간 범위의 부호 있는 초입니다. -315,576,000,000부터 +315,576,000,000까지(경계값 포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` @@ -437,18 +438,18 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도로 표현된 초의 부호 있는 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 나노초 값은 음수가 아니어야 합니다. + 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 음수 초 값도 여전히 음수가 아닌 nanos 값을 가져야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000 이상 +315,576,000,000 이하이어야 합니다. + 시간 범위의 부호 있는 초입니다. -315,576,000,000부터 +315,576,000,000까지(경계값 포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` -`GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -493,7 +494,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 질의의 경우 단일 인스턴스입니다. 다중 턴 질의의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. @@ -509,7 +510,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 산입됩니다. 이미지 해상도에는 제한 없음입니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -519,23 +520,23 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 산입됩니다. 이미지 해상도에는 제한 없음입니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하게 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 그 이후 Flash 모델에서 지원됩니다. - 텍스트 프롬프트 또는 코드 조각입니다. + 텍스트 프롬프트 또는 코드 스니펫입니다. @@ -565,7 +566,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 응답이 생성된 시점의 타임스탬프입니다. + 응답이 생성된 타임스탬프입니다. @@ -589,13 +590,11 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - + 콘텐츠가 지정된 안전 카테고리를 위반할 확률 - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -615,13 +614,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 모달리티별 후보 토큰의 내역입니다. + 후보 토큰을 모달리티별로 분류한 내역입니다. - 입력 또는 출력 콘텐츠의 모달리티 유형입니다. + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -629,17 +628,17 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠에 있는 토큰 수를 포함합니다. + 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. - 모달리티별 프롬프트 토큰의 내역입니다. + 프롬프트 토큰을 모달리티별로 분류한 내역입니다. - 입력 또는 출력 콘텐츠의 모달리티 유형입니다. + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -647,21 +646,21 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 사고(thoughts) 출력에 있는 토큰 수입니다. + 사고 출력에 포함된 토큰 수입니다. - 도구 사용 프롬프트에 있는 토큰 수입니다. + 도구 사용 프롬프트에 포함된 토큰 수입니다. - 모달리티별 도구 사용 프롬프트 토큰의 내역입니다. + 도구 사용 프롬프트 토큰을 모달리티별로 분류한 내역입니다. - 입력 또는 출력 콘텐츠의 모달리티 유형입니다. + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -669,7 +668,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 총 토큰 수입니다(프롬프트 + 후보). + 총 토큰 수(프롬프트 + 후보)입니다. diff --git a/ko/development/comfy-router/models/google/nano-banana-2/code.mdx b/ko/development/comfy-router/models/google/nano-banana-2/code.mdx index 4ec7b69050..5d80843774 100644 --- a/ko/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/ko/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Nano Banana 2 사용하기" description: "Comfy Router를 통해 HTTP로 Nano Banana 2(Gemini 3.1 Flash Image)로 이미지를 생성하기 위한 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Nano Banana 2" -translationSourceHash: f8c4ed89 +translationSourceHash: 8183f2d5 translationFrom: development/comfy-router/models/google/nano-banana-2/code.mdx translationBlockHashes: "_intro": e6f85ac2 "Quick start": 7fb17070 "Serving providers": a9deb946 - "Schema": 63c93920 + "Schema": a266962e "Examples": d294783d --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 생성된 파일입니다. 이 디렉터리의 code.yaml을 편집한 뒤 `pnpm code-pages:gen`을 실행하세요. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -233,7 +234,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R ### 입력 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스이고, 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. + 모델과의 현재 대화 내용입니다. 단일 턴 질의에서는 하나의 인스턴스입니다. 다중 턴 질의에서는 대화 기록과 최신 요청을 포함하는 반복 필드입니다. @@ -249,7 +250,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -259,19 +260,19 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 유형(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 part의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. @@ -279,7 +280,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 이 part가 모델의 사고/추론 단계임을 나타냅니다. + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. @@ -287,37 +288,37 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 생성에 대한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 기본값이 적용되고, 나머지는 모델 자체의 동작을 따릅니다. + 생성에 대한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 기본값이 적용되고, 나머지는 모델 자체 동작으로 대체됩니다. - 이미지 생성을 위한 구성 + 이미지 생성을 위한 구성입니다. - 생성된 이미지의 가로세로 비율 + 생성된 이미지의 가로세로 비율입니다. - 선택 사항. 생성된 이미지의 이미지 출력 형식입니다. + 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. - 선택 사항. 출력 이미지의 압축 품질입니다. + 선택 사항입니다. 출력 이미지의 압축 품질입니다. - 선택 사항. 출력을 저장할 이미지 형식으로, Vertex AI 경로에 해당합니다. 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청입니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청을 전달하기 전에 소문자로 정규화합니다. 그 밖의 값은 이 필드를 지목하는 400 오류와 함께 거부됩니다. 생략하면 기본값은 `image/png`입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없어 이 필드가 있으면 호출 전체를 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 대로 결정됩니다. 모든 경로에서 전송한 값을 가정하지 말고, 제공받은 응답 part에서 미디어 유형을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). + 선택 사항입니다. 출력이 저장되어야 하는 이미지 형식이며, Vertex AI 경로에 적용됩니다. 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청입니다. 해당 경로에서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시킨 뒤 요청이 전달되기 전에 소문자로 정규화됩니다. 그 밖의 값은 이 필드를 지목한 400 오류와 함께 거부됩니다. 생략 시 기본값은 `image/png`입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없으며 이 속성이 존재하면 전체 호출을 거부하므로, 이 필드는 존중되거나 거부되는 대신 요청에서 제거되며, 출력 형식은 AI Studio가 선택하는 값이 됩니다. 모든 경로에서 보낸 값을 가정하지 말고, 제공받은 응답 파트에서 미디어 유형을 다시 읽어 확인하세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). - 선택 사항. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. - 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰 하나는 약 4자에 해당합니다. 100토큰은 대략 60~80단어에 해당합니다. + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰 하나는 약 4자에 해당합니다. 100 토큰은 대략 60~80단어에 해당합니다. - 범위: `16` ~ `65536` + 범위: `16`~`65536` @@ -325,7 +326,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 시드가 특정 값으로 고정되면, 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 매개변수 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 +시드가 특정 값으로 고정되면, 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 발생할 수 있습니다. 기본적으로는 무작위 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -333,43 +334,43 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - temperature는 topP와 topK가 적용되는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 열린 결말이거나 창의적인 응답이 필요하지 않은 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정적이지만, 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공한다면 temperature를 높여 보세요. + temperature는 topP와 topK가 적용되는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정적이지만, 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체 응답을 제공하는 경우 temperature를 높여 보세요 - 범위: `0`부터 `2`까지 + 범위: `0` ~ `2` 형식: `float` - 선택 사항입니다. 사고 기능에 대한 설정입니다. 사고란 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + 선택 사항. 사고 기능에 대한 설정입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. - 선택 사항입니다. true이면 모델이 응답에 자신의 사고 내용을 포함합니다. + 선택 사항. 참이면 모델이 응답에 자신의 사고 내용을 포함합니다. - 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산 내에 머무르기 위해 최선을 다합니다. + 선택 사항. 모델의 사고 과정에 대한 토큰 예산입니다. 모델은 이 예산을 넘지 않도록 최선을 다합니다. - 선택 사항입니다. 모델의 사고 수준입니다. + 선택 사항. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중에서 가장 확률이 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 가장 확률이 높은 3개의 토큰 중에서 다음 토큰을 선택합니다. + Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중 가장 확률이 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개의 토큰 중에서 다음 토큰이 선택됩니다. - 범위: `1`부터 `…`까지 + 범위: `1` ~ `…` 지정하면 nucleus 샘플링이 사용됩니다. -Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. 토큰은 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 것( top-K 참조)부터 가장 낮은 것 순으로 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. -무작위성이 낮은 응답을 원하면 더 낮은 값을, 무작위성이 높은 응답을 원하면 더 높은 값을 지정하세요. +Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 확률의 합이 top-P 값과 같아질 때까지 확률이 가장 높은 토큰(top-K 참조)부터 가장 낮은 토큰까지 선택됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5이면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +무작위성이 낮은 응답에는 더 낮은 값을, 무작위성이 높은 응답에는 더 높은 값을 지정하세요. - 범위: `0`부터 `1`까지 + 범위: `0` ~ `1` 형식: `float` @@ -387,25 +388,25 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 역할 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. + 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예: "Answer as concisely as possible" 또는 "Don't use technical terms in your response". 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 문단으로 구성해야 합니다. - 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. + 하나의 메시지를 구성하는 순서가 지정된 part 목록입니다. part마다 서로 다른 IANA MIME 타입을 가질 수 있습니다. 최대 토큰 수나 이미지 수 같은 입력 제한은 Google 모델 페이지의 모델 사양을 참조하세요. - 텍스트 프롬프트 또는 코드 조각입니다. + 텍스트 프롬프트 또는 코드 스니펫입니다. - 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람이 보낸 것으로, 일반적으로 사용자가 생성한 메시지임을 나타냅니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 멀티 턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 멀티 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않을 수 있습니다. + 메시지를 생성하는 주체의 식별자입니다. 다음 값이 지원됩니다: user: 메시지가 실제 사람에 의해 전송되었음을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 다중 턴 대화 중에 모델의 메시지를 대화에 삽입할 때 사용됩니다. 다중 턴이 아닌 대화에서는 이 필드를 비워 두거나 설정하지 않아도 됩니다. 가능한 값: `user`, `model` - 시스템이 모델의 지식과 범위를 벗어난 작업 또는 작업 집합을 수행하기 위해 외부 시스템과 상호 작용할 수 있게 해 주는 코드 조각입니다. Function calling을 참조하세요. + 시스템이 모델의 지식과 범위를 벗어난 동작 또는 일련의 동작을 수행하기 위해 외부 시스템과 상호작용할 수 있게 하는 코드 조각입니다. 함수 호출을 참조하세요. @@ -421,11 +422,11 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 함수 파라미터에 대한 JSON 스키마 + 함수 파라미터의 JSON 스키마 - true이면 생성된 이미지가 클라우드 스토리지에 업로드되고, 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + 참이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. @@ -437,15 +438,15 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도의 부호 있는 초의 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 나노스 값은 0 이상이어야 합니다. + 나노초 해상도의 초 단위 소수 부분(부호 있음). 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. - 범위: `0` ~ `999999999` + 범위: `0`부터 `999999999`까지 - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + 시간 범위의 초(부호 있음). -315,576,000,000부터 +315,576,000,000까지 포함이어야 합니다. - 범위: `-315576000000` ~ `315576000000` + 범위: `-315576000000`부터 `315576000000`까지 @@ -453,18 +454,18 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도의 부호 있는 초의 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 나노스 값은 0 이상이어야 합니다. + 나노초 해상도의 초 단위 소수 부분(부호 있음). 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. - 범위: `0` ~ `999999999` + 범위: `0`부터 `999999999`까지 - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + 시간 범위의 초(부호 있음). -315,576,000,000부터 +315,576,000,000까지 포함이어야 합니다. - 범위: `-315576000000` ~ `315576000000` + 범위: `-315576000000`부터 `315576000000`까지 -Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 제공하는 스키마로부터 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -509,7 +510,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 질의의 경우 단일 인스턴스입니다. 멀티 턴 질의의 경우 대화 기록과 최신 요청을 담는 반복 필드입니다. @@ -525,7 +526,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩해야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -535,19 +536,19 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 유형(mimeType)도 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 데이터의 미디어 타입(mimeType)도 함께 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩해야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고, 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정합니다. 기본 고정 비율 샘플링을 사용하려면 생략합니다. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식을 지정합니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정하도록 하려면 "AGENTIC"으로 설정합니다. 기본 고정 비율 샘플링을 사용하려면 생략합니다. gemini-3.7-flash 및 그 이후 Flash 모델에서 지원됩니다. @@ -555,7 +556,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - 이 부분이 모델의 사고/추론 단계임을 나타냅니다. + 이 파트가 모델의 사고/추론 단계임을 나타냅니다. @@ -575,7 +576,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - 콘텐츠가 지정된 안전 카테고리를 위반할 확률 + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -585,7 +586,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - 응답을 생성하는 데 사용된 모델 버전입니다. + 응답 생성에 사용된 모델 버전입니다. @@ -605,19 +606,17 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - - -가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - 콘텐츠가 지정된 안전 카테고리를 위반할 확률 + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. - 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - 응답의 고유 식별자. + 응답의 고유 식별자입니다. @@ -625,73 +624,73 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - 출력 전용. 입력에서 캐시된 부분(캐시된 콘텐츠)의 토큰 수. + 출력 전용입니다. 입력에서 캐시된 부분(캐시된 콘텐츠)에 있는 토큰 수입니다. - 응답의 토큰 수. + 응답에 있는 토큰 수입니다. - 모달리티별 후보 토큰 분석. + 모달리티별 후보 토큰 내역입니다. - 입력 또는 출력 콘텐츠 모달리티의 유형. + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` - 지정된 모달리티의 토큰 수. + 해당 모달리티의 토큰 수입니다. - 요청의 토큰 수. cachedContent가 설정된 경우에도 이 값은 여전히 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + 요청에 있는 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. - 모달리티별 프롬프트 토큰 분석. + 모달리티별 프롬프트 토큰 내역입니다. - 입력 또는 출력 콘텐츠 모달리티의 유형. + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` - 지정된 모달리티의 토큰 수. + 해당 모달리티의 토큰 수입니다. - 생각(thoughts) 출력에 포함된 토큰 수. + thoughts 출력에 있는 토큰 수입니다. - 도구 사용 프롬프트에 포함된 토큰 수. + 도구 사용 프롬프트에 있는 토큰 수입니다. - 모달리티별 도구 사용 프롬프트 토큰 분석. + 모달리티별 도구 사용 프롬프트 토큰 내역입니다. - 입력 또는 출력 콘텐츠 모달리티의 유형. + 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` - 지정된 모달리티의 토큰 수. + 해당 모달리티의 토큰 수입니다. - 총 토큰 수(프롬프트 + 후보). + 총 토큰 수(프롬프트 + 후보)입니다. - 요청에 사용된 트래픽 유형(예: PROVISIONED_THROUGHPUT). + 요청에 사용된 트래픽 유형입니다(예: PROVISIONED_THROUGHPUT). ## 예시 diff --git a/ko/development/comfy-router/models/google/nano-banana-pro/code.mdx b/ko/development/comfy-router/models/google/nano-banana-pro/code.mdx index caf17819e4..fdf739b696 100644 --- a/ko/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/ko/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 Nano Banana Pro 사용하기" description: "Comfy Router를 통해 HTTP로 Nano Banana Pro(Gemini 3 Pro Image)로 이미지를 생성하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "Nano Banana Pro" -translationSourceHash: 48881f72 +translationSourceHash: 63f6b907 translationFrom: development/comfy-router/models/google/nano-banana-pro/code.mdx translationBlockHashes: "_intro": 34f7de08 "Quick start": b78c780a "Serving providers": caff9b45 - "Schema": b9a919e8 + "Schema": 9094176d "Examples": 54f56549 --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -249,13 +250,13 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite와 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 원시 바이트 형식의 인라인 데이터입니다. gemini-2.0-flash-lite와 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. + 원시 바이트 단위의 인라인 데이터입니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 inlineData를 사용하여 최대 3000개의 이미지를 지정할 수 있습니다. @@ -265,17 +266,17 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite와 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 유형입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 콘텐츠는 토큰 제한에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 부분의 비디오를 읽는 방식입니다. "AGENTIC"으로 설정하면 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정합니다. 생략하면 기본 고정 비율 샘플링이 사용됩니다. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 부분의 비디오를 읽는 방식입니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. - 텍스트 프롬프트 또는 코드 스니펫입니다. + 텍스트 프롬프트 또는 코드 조각입니다. @@ -287,35 +288,35 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. 아래에서 `default`를 선언한 필드는 생략 시 해당 값을 적용하고, 나머지는 모델 자체 동작을 따릅니다. + 생성을 위한 샘플링, 길이 및 출력 설정입니다. 모든 필드는 선택 사항입니다. `default`를 선언하는 아래 필드는 생략 시 해당 값을 적용하고, 나머지는 모델 자체 동작으로 대체됩니다. - 이미지 생성 구성 + 이미지 생성을 위한 구성입니다. - 생성된 이미지의 가로세로 비율 + 생성된 이미지의 가로세로 비율입니다. - 선택 사항. 생성된 이미지의 이미지 출력 형식입니다. + 선택 사항입니다. 생성된 이미지의 이미지 출력 형식입니다. - 선택 사항. 출력 이미지의 압축 품질입니다. + 선택 사항입니다. 출력 이미지의 압축 품질입니다. - 선택 사항. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력을 저장할 이미지 형식입니다. 여기서 허용되는 값은 `image/png`와 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키고 요청을 전달하기 전에 소문자로 정규화합니다. 그 밖의 값은 이 필드를 명시한 400 오류와 함께 거부됩니다. 생략하면 `image/png`가 기본값입니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 이런 속성이 없고 이 필드가 있으면 전체 호출을 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 값이 됩니다. 모든 경로에서 보낸 값을 가정하지 말고, 제공된 응답 부분(`inlineData.mimeType`, `uploadImagesToStorage`가 설정된 경우에는 `fileData.mimeType`)에서 미디어 유형을 다시 읽으세요. + 선택 사항입니다. Vertex AI 경로, 즉 Comfy 자체 자격 증명으로 처리되는 요청과 GCP 서비스 계정으로 인증된 BYOK 요청에서 출력을 저장할 이미지 형식입니다. 해당 경로에서 허용되는 값은 `image/png` 및 `image/jpeg`이며, 대소문자를 구분하지 않고 일치시키며 요청이 전달되기 전에 소문자로 정규화됩니다. 다른 값은 이 필드를 지목하는 400 오류로 거부됩니다. 생략 시 `image/png`로 기본 설정됩니다. Google AI Studio API 키로 인증된 BYOK 요청은 예외입니다. 해당 업스트림에는 그러한 속성이 없으며 속성이 있으면 전체 호출을 거부하므로, 이 필드는 적용되거나 거부되는 대신 요청에서 제거되며 출력 형식은 AI Studio가 선택하는 대로 됩니다. 모든 경로에서 보낸 값을 가정하지 말고, 제공된 응답 부분에서 미디어 유형을 다시 읽으세요(`inlineData.mimeType`, 또는 `uploadImagesToStorage`가 설정된 경우 `fileData.mimeType`). - 선택 사항. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. + 선택 사항입니다. 생성된 이미지의 크기를 지정합니다. 지원되는 값은 1K, 2K, 4K입니다. 지정하지 않으면 모델은 기본값 1K를 사용합니다. - 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰 하나는 약 4자에 해당합니다. 100 토큰은 대략 60~80단어에 해당합니다. + 응답에서 생성할 수 있는 최대 토큰 수입니다. 토큰은 대략 4자입니다. 100개 토큰은 대략 60-80단어에 해당합니다. 범위: `16` ~ `65536` @@ -325,7 +326,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 시드가 특정 값으로 고정되면, 모델은 반복된 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로 무작위 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + 시드가 특정 값으로 고정되면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델 또는 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 차이가 생길 수 있습니다. 기본적으로 임의의 시드 값이 사용됩니다. 다음 모델에서 사용할 수 있습니다:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -333,7 +334,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - temperature는 topP와 topK가 적용되는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하거나 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 확률이 가장 높은 토큰이 항상 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정적이지만, 약간의 변동은 여전히 가능합니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 폴백 응답을 제공하는 경우 temperature를 높여 보세요 + temperature는 topP와 topK가 적용되는 응답 생성 중 샘플링에 사용됩니다. temperature는 토큰 선택의 무작위성 정도를 제어합니다. 낮은 temperature는 덜 개방적이거나 덜 창의적인 응답이 필요한 프롬프트에 적합하고, 높은 temperature는 더 다양하고 창의적인 결과로 이어질 수 있습니다. temperature가 0이면 항상 확률이 가장 높은 토큰이 선택됩니다. 이 경우 주어진 프롬프트에 대한 응답은 대부분 결정론적이지만, 약간의 변동은 여전히 발생할 수 있습니다. 모델이 너무 일반적이거나 너무 짧은 응답을 반환하거나 대체(fallback) 응답을 반환한다면 temperature를 높여 보세요 범위: `0` ~ `2` @@ -341,7 +342,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 선택 사항입니다. 사고(thinking) 기능에 대한 설정입니다. 사고란 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. + 선택 사항입니다. 사고(thinking) 기능에 대한 설정입니다. 사고는 모델이 복잡한 작업을 더 작은 단계로 나누어 더 높은 품질의 응답을 생성하는 과정입니다. @@ -349,25 +350,25 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 선택 사항입니다. 모델의 사고 과정을 위한 토큰 예산입니다. 모델은 이 예산을 넘지 않도록 최선을 다합니다. + 선택 사항입니다. 모델의 사고 과정에 할당할 토큰 예산입니다. 모델은 이 예산을 넘지 않도록 최선을 다합니다. 선택 사항입니다. 모델의 사고 수준입니다. - 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 가능한 값: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. Top-K가 1이면 다음에 선택되는 토큰은 모델 어휘에 있는 모든 토큰 중에서 가장 확률이 높은 토큰입니다. Top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개의 토큰 중에서 다음 토큰을 선택합니다. + Top-K는 모델이 출력에 사용할 토큰을 선택하는 방식을 변경합니다. top-K가 1이면 다음에 선택되는 토큰은 모델 어휘의 모든 토큰 중에서 가장 확률이 높은 토큰입니다. top-K가 3이면 temperature를 사용하여 확률이 가장 높은 3개의 토큰 중에서 다음 토큰을 선택합니다. 범위: `1` ~ `…` 지정하면 nucleus 샘플링이 사용됩니다. -Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 토큰은 (top-K 참조) 확률이 가장 높은 것부터 가장 낮은 것까지 선택되며, 그 확률의 합이 top-P 값과 같아질 때까지 진행합니다. 예를 들어 토큰 A, B, C의 확률이 0.3, 0.2, 0.1이고 top-P 값이 0.5라면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. -무작위성이 낮은 응답을 원하면 더 낮은 값을, 무작위성이 높은 응답을 원하면 더 높은 값을 지정하세요. +Top-P는 모델이 출력에 사용할 토큰을 선택하는 방식을 변경합니다. 토큰은 확률이 가장 높은 것(top-K 참조)부터 가장 낮은 것까지 선택되며, 확률의 합이 top-P 값과 같아질 때까지 진행됩니다. 예를 들어 토큰 A, B, C의 확률이 각각 0.3, 0.2, 0.1이고 top-P 값이 0.5이면, 모델은 temperature를 사용하여 A 또는 B를 다음 토큰으로 선택하고 C는 후보에서 제외합니다. +덜 무작위적인 응답을 원하면 낮은 값을, 더 무작위적인 응답을 원하면 높은 값을 지정하세요. 범위: `0` ~ `1` @@ -387,11 +388,11 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 모델을 더 나은 성능으로 이끌기 위한 지침입니다. 예를 들어 "가능한 한 간결하게 답하세요" 또는 "응답에 전문 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. + 모델이 더 나은 성능을 내도록 유도하는 지침입니다. 예를 들어 "Answer as concisely as possible" 또는 "Don't use technical terms in your response"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 단락에 있어야 합니다. - 하나의 메시지를 구성하는 순서가 있는 parts 목록입니다. part마다 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한에 대해서는 Google 모델 페이지의 모델 사양을 참조하세요. + 하나의 메시지를 구성하는 순서가 있는 part 목록입니다. part마다 서로 다른 IANA MIME 유형을 가질 수 있습니다. 최대 토큰 수나 이미지 수와 같은 입력 제한에 대해서는 Google 모델 페이지의 모델 사양을 참조하세요. @@ -399,13 +400,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다: user: 메시지가 실제 사람이 보낸 것임을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 다중 턴 대화 중에 모델의 메시지를 대화에 삽입하는 데 사용됩니다. 다중 턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않을 수 있습니다. + 메시지를 생성하는 주체의 정체성입니다. 다음 값이 지원됩니다. user: 메시지가 실제 사람에 의해 전송되었음을 나타내며, 일반적으로 사용자가 생성한 메시지입니다. model: 메시지가 모델에 의해 생성되었음을 나타냅니다. model 값은 멀티턴 대화 중에 모델의 메시지를 대화에 삽입할 때 사용됩니다. 멀티턴 대화가 아닌 경우 이 필드는 비워 두거나 설정하지 않을 수 있습니다. 가능한 값: `user`, `model` - 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호 작용할 수 있게 해주는 코드 조각입니다. 함수 호출을 참조하세요. + 시스템이 모델의 지식과 범위를 벗어난 작업 또는 일련의 작업을 수행하기 위해 외부 시스템과 상호작용할 수 있도록 하는 코드 조각입니다. Function calling을 참조하세요. @@ -421,15 +422,15 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 함수 파라미터의 JSON 스키마 + 함수 파라미터에 대한 JSON 스키마 - true이면 생성된 이미지가 인라인 base64 데이터 대신 클라우드 스토리지에 업로드되고 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + 참이면 생성된 이미지가 클라우드 스토리지에 업로드되고 인라인 base64 데이터 대신 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. - 비디오 입력의 경우, Duration 형식으로 된 비디오의 시작 및 종료 오프셋입니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 이 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공되는 동안에만 지정해야 합니다. + 비디오 입력의 경우 비디오의 시작 및 종료 오프셋을 Duration 형식으로 지정합니다. 예를 들어 1:00에서 시작하는 10초 클립을 지정하려면 "startOffset": \{ "seconds": 60 } 및 "endOffset": \{ "seconds": 70 }으로 설정합니다. 메타데이터는 비디오 데이터가 inlineData 또는 fileData로 제공될 때만 지정해야 합니다. @@ -437,13 +438,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 음수 초 값도 나노 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` @@ -453,18 +454,18 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 음수 초 값이라도 nanos 값은 음수가 아니어야 합니다. + 나노초 해상도의 부호 있는 초 소수 부분입니다. 소수 부분이 있는 음수 초 값도 나노 값은 음수가 아니어야 합니다. 범위: `0` ~ `999999999` - 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(양 끝 포함)여야 합니다. + 시간 범위의 부호 있는 초입니다. -315,576,000,000에서 +315,576,000,000까지(포함)여야 합니다. 범위: `-315576000000` ~ `315576000000` -Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 이전에 Router가 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -509,7 +510,7 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 다중 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. + 모델과의 현재 대화 콘텐츠입니다. 단일 턴 쿼리의 경우 단일 인스턴스입니다. 멀티 턴 쿼리의 경우 대화 기록과 최신 요청을 포함하는 반복 필드입니다. @@ -525,7 +526,7 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 token 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` @@ -535,19 +536,19 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때에는 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB + 프롬프트에 인라인으로 포함할 이미지, PDF 또는 비디오의 base64 인코딩입니다. 미디어를 인라인으로 포함할 때는 해당 데이터의 미디어 타입(mimeType)도 지정해야 합니다. 크기 제한: 20MB 형식: `byte` - data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 사용 가능한 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 token 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. + data 또는 fileUri 필드에 지정된 파일의 미디어 타입입니다. 허용되는 값은 다음과 같습니다. gemini-2.0-flash-lite 및 gemini-2.0-flash의 경우 오디오 파일의 최대 길이는 8.4시간이고 비디오 파일(오디오 없음)의 최대 길이는 1시간입니다. 자세한 내용은 Gemini 오디오 및 비디오 요구 사항을 참조하세요. 텍스트 파일은 UTF-8로 인코딩되어야 합니다. 텍스트 파일의 내용은 토큰 한도에 포함됩니다. 이미지 해상도에는 제한이 없습니다. 가능한 값: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 모델이 이 파트의 비디오를 읽는 방식입니다. "AGENTIC"으로 설정하면 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 직접 결정합니다. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. + 모델이 이 파트의 비디오를 읽는 방식을 지정합니다. 고정 비율 프레임 샘플링 대신 모델이 검사할 세그먼트를 결정하도록 하려면 "AGENTIC"으로 설정하세요. 기본 고정 비율 샘플링을 사용하려면 생략하세요. gemini-3.7-flash 및 최신 Flash 모델에서 지원됩니다. @@ -575,17 +576,17 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다 + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` - 응답이 생성된 시점의 타임스탬프입니다. + 응답이 생성된 타임스탬프입니다. - 응답을 생성하는 데 사용된 모델 버전입니다. + 응답 생성에 사용된 모델 버전입니다. @@ -605,11 +606,9 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - - 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다 + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -627,11 +626,11 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - 응답에 포함된 토큰 수입니다. + 응답의 토큰 수입니다. - 모달리티별 후보 토큰의 내역입니다. + 후보 토큰을 모달리티별로 분류한 내역입니다. @@ -645,11 +644,11 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - 요청에 포함된 토큰 수입니다. cachedContent가 설정된 경우에도 이는 총 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. + 요청의 토큰 수입니다. cachedContent가 설정된 경우에도 이는 전체 유효 프롬프트 크기이며, 캐시된 콘텐츠의 토큰 수를 포함합니다. - 모달리티별 프롬프트 토큰의 내역입니다. + 프롬프트 토큰을 모달리티별로 분류한 내역입니다. @@ -663,7 +662,7 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - thoughts 출력에 포함된 토큰 수입니다. + 사고 출력에 포함된 토큰 수입니다. @@ -671,7 +670,7 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - 모달리티별 도구 사용 프롬프트 토큰의 내역입니다. + 도구 사용 프롬프트 토큰을 모달리티별로 분류한 내역입니다. @@ -685,7 +684,7 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 - 총 토큰 수(프롬프트 + 후보)입니다. + 총 토큰 수입니다(프롬프트 + 후보). diff --git a/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index c1bdec8983..837f9db517 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router로 Kling V2.5 Turbo 사용하기" description: "Comfy Router를 통해 kling/kling-v2-5-turbo를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 06b3d8e9 +translationSourceHash: 3bbe1969 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 785eeca2 "Quick start": dc63b3ac - "Schema": e36b5646 + "Schema": a24874ef "Examples": 8623c725 --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/kling/kling-v2-5-turbo.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -165,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 콜백 알림 주소입니다. 무시됨: comfy-api가 전달 전에 이 필드를 삭제하며, Comfy Router가 대신 폴링합니다. + 콜백 알림 주소입니다. 무시됩니다: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -179,49 +180,49 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 수평 축(x축)을 따른 카메라의 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 나타냅니다. + 카메라의 수평축(x축) 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 의미합니다. 범위: `-10` ~ `10` - 수직 평면(x축)에서의 카메라 회전을 제어합니다. 음수는 아래쪽 회전, 양수는 위쪽 회전을 나타냅니다. + 수직 평면에서의 카메라 회전(x축)을 제어합니다. 음수는 아래 방향 회전, 양수는 위 방향 회전을 의미합니다. 범위: `-10` ~ `10` - 카메라의 롤링 정도(z축)를 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 나타냅니다. + 카메라의 롤링 정도(z축)를 제어합니다. 음수는 시계 반대 방향, 양수는 시계 방향을 의미합니다. 범위: `-10` ~ `10` - 수평 평면(y축)에서의 카메라 회전을 제어합니다. 음수는 왼쪽으로 회전, 양수는 오른쪽으로 회전을 나타냅니다. + 수평 평면에서의 카메라 회전(y축)을 제어합니다. 음수는 왼쪽 회전, 양수는 오른쪽 회전을 의미합니다. 범위: `-10` ~ `10` - 수직 축(y축)을 따른 카메라의 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 나타냅니다. + 카메라의 수직축(y축) 이동을 제어합니다. 음수는 아래, 양수는 위를 의미합니다. 범위: `-10` ~ `10` - 카메라 초점 거리의 변화를 제어합니다. 음수는 좁은 화각, 양수는 넓은 화각을 나타냅니다. + 카메라 초점 거리의 변화를 제어합니다. 음수는 좁은 화각, 양수는 넓은 화각을 의미합니다. 범위: `-10` ~ `10` - 미리 정의된 카메라 이동 유형입니다. simple: 사용자 정의 가능한 카메라 이동. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하며 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하며 앞으로 이동합니다. + 미리 정의된 카메라 무브먼트 유형입니다. simple: 사용자 정의 가능한 카메라 무브먼트. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하며 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하며 앞으로 이동합니다. 가능한 값: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - 비디오 생성에서의 유연성입니다. 값이 높을수록 모델의 유연성 정도가 낮아지고 사용자 프롬프트에 대한 관련성이 강해집니다. + 비디오 생성 시의 유연성입니다. 값이 높을수록 모델의 유연성 정도가 낮아지고 사용자 프롬프트와의 관련성이 강해집니다. 범위: `0` ~ `1` @@ -235,21 +236,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 사용자 지정 작업 ID입니다. 무시됨: comfy-api가 전달 전에 이 필드를 삭제하며, Comfy Router가 대신 폴링합니다. - - - - 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드입니다. pro: 더 긴 재생 시간과 더 높은 품질의 출력을 생성하는 전문가 모드입니다. - - 가능한 값: `std`, `pro` + 사용자 지정 작업 ID입니다. 무시됩니다: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. - 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내십시오. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. + 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내세요. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. - 프롬프트와 재생 시간 등 각 스토리보드에 대한 정보입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize인 경우 필수입니다. + 각 스토리보드의 정보(프롬프트, 재생 시간 등)입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize인 경우 필수입니다. @@ -265,15 +260,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 멀티 샷 비디오를 생성할지 여부입니다. true이면 prompt 파라미터가 무효입니다. false이면 shot_type 및 multi_prompt 파라미터가 무효입니다. + 멀티 샷 비디오를 생성할지 여부입니다. true이면 prompt 파라미터가 무효화됩니다. false이면 shot_type 및 multi_prompt 파라미터가 무효화됩니다. - 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 긍정 프롬프트 내에서 네거티브 문장으로 직접 보충하는 것을 권장합니다. + 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 긍정 프롬프트 안에 부정문으로 직접 보충하는 것을 권장합니다. - 긍정 텍스트 프롬프트입니다. \<\<\>>을 사용하여 voice_list 파라미터 순서에 맞는 음성을 지정할 수 있습니다. 하나의 작업은 최대 2개의 톤을 참조할 수 있습니다. 톤을 지정할 때는 sound 파라미터 값이 on이어야 합니다. + 긍정 텍스트 프롬프트입니다. \<\<\>>를 사용하여 voice_list 파라미터 순서에 맞는 음성을 지정하세요. 하나의 작업은 최대 2개의 톤을 참조할 수 있습니다. 톤을 지정할 때는 sound 파라미터 값이 on이어야 합니다. @@ -283,36 +278,42 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 비디오 생성 시 사운드를 함께 생성할지 여부입니다. V2.6 및 이후 버전의 모델만 이 파라미터를 지원합니다. + 비디오 생성 시 사운드를 함께 생성할지 여부입니다. V2.6 이상 모델만 이 파라미터를 지원합니다. 가능한 값: `on`, `off` - 비디오 생성 시 참조되는 음성 목록입니다. 최대 2개의 음성을 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>>로 참조합니다. `sound`가 "on"으로 설정되어야 하며, 이는 V2.6 및 이후 버전의 모델만 지원합니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 음성이 적용되지 않습니다. + 비디오 생성 시 참조되는 음성 목록입니다. 최대 2개의 음성을 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>>로 참조하세요. `sound`를 "on"으로 설정해야 하며, 이는 V2.6 이상 모델만 지원합니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 음성은 적용되지 않습니다. - 음성 사용자 정의 API를 통해 반환된 음성 ID 또는 시스템 사전 설정 음성 ID입니다. + 음성 사용자 정의 API를 통해 반환된 음성 ID 또는 시스템 프리셋 음성 ID입니다. - 워터마크가 적용된 결과를 함께 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. + 워터마크가 있는 결과물을 함께 생성할지 여부입니다. 사용자 정의 워터마크는 현재 지원되지 않습니다. - true는 워터마크를 생성함을 의미하고, false는 생성하지 않음을 의미합니다. + true는 워터마크를 생성하고, false는 생성하지 않음을 의미합니다. - 참조 이미지: URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. + 참조 이미지 - URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상이어야 하며, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사를 포함하면 안 됩니다. - 참조 이미지: 종료 프레임 제어. URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. dynamic_masks/static_mask 또는 camera_control과 동시에 사용할 수 없습니다. + 참조 이미지 - 종료 프레임 제어입니다. URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하면 안 됩니다. dynamic_masks/static_mask 또는 camera_control(카메라 제어)과 동시에 사용할 수 없습니다. + + + + 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드입니다. pro: 전문가 모드로, 더 긴 재생 시간의 비디오를 생성하지만 출력 품질이 더 높습니다. + + 가능한 값: `std`, `pro` -`GET /v2/models/kling/kling-v2-5-turbo/openapi.json`에서 Router가 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이 스키마는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. ### 출력 @@ -325,7 +326,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 작업 생성 시간, Unix 타임스탬프(밀리초) + 작업 생성 시간, 밀리초 단위의 Unix 타임스탬프 @@ -353,7 +354,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 총 비디오 재생 시간(초) + 비디오 총 재생 시간(초) @@ -367,7 +368,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 워터마크가 포함된 생성된 비디오의 URL, 핫링크 방지 형식 + 워터마크가 포함된 생성된 비디오의 URL, 핫링크 보호 형식 형식: `uri` @@ -379,11 +380,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 작업 상태 정보로, 작업이 실패하면 실패 사유를 표시합니다 + 작업 상태 정보로, 작업이 실패할 경우 실패 사유를 표시합니다 - 작업 업데이트 시간, Unix 타임스탬프(밀리초) + 작업 업데이트 시간, 밀리초 단위의 Unix 타임스탬프 diff --git a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx index df16fa460a..8d3cfe6957 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router로 Kling V2.6 사용하기" description: "Comfy Router를 통해 kling/kling-v2-6을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답." sidebarTitle: "Kling V2.6" -translationSourceHash: 94eb0863 +translationSourceHash: c9a8a551 translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": c2065202 "Quick start": 48a3d970 - "Schema": cd52808d + "Schema": e0deb97e "Examples": 8623c725 --- + {/* 생성됨 파일. `pnpm code-pages:gen`이 router-schemas/kling/kling-v2-6.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -165,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 콜백 알림 주소입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. + 콜백 알림 주소입니다. 무시됩니다: comfy-api가 전달하기 전에 이 필드를 삭제하며, Comfy Router가 사용자를 대신해 폴링합니다. 형식: `uri` @@ -179,77 +180,71 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 수평 축(x축)을 따른 카메라의 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 나타냅니다. + 수평축(x축)을 따른 카메라 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 나타냅니다. - 범위: `-10`부터 `10`까지 + 범위: `-10` ~ `10` 수직 평면(x축)에서의 카메라 회전을 제어합니다. 음수는 아래쪽 회전, 양수는 위쪽 회전을 나타냅니다. - 범위: `-10`부터 `10`까지 + 범위: `-10` ~ `10` - 카메라의 롤링 정도(z축)를 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 나타냅니다. + 카메라의 롤링 수량(z축)을 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 나타냅니다. - 범위: `-10`부터 `10`까지 + 범위: `-10` ~ `10` 수평 평면(y축)에서의 카메라 회전을 제어합니다. 음수는 왼쪽으로 회전, 양수는 오른쪽으로 회전을 나타냅니다. - 범위: `-10`부터 `10`까지 + 범위: `-10` ~ `10` - 수직 축(y축)을 따른 카메라의 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 나타냅니다. + 수직축(y축)을 따른 카메라 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 나타냅니다. - 범위: `-10`부터 `10`까지 + 범위: `-10` ~ `10` 카메라 초점 거리의 변화를 제어합니다. 음수는 좁은 화각, 양수는 넓은 화각을 나타냅니다. - 범위: `-10`부터 `10`까지 + 범위: `-10` ~ `10` - 미리 정의된 카메라 이동 유형입니다. simple: 사용자 정의 가능한 카메라 이동. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전하고 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전하고 앞으로 이동합니다. + 미리 정의된 카메라 이동 유형입니다. simple: 사용자 정의 가능한 카메라 이동. down_back: 카메라가 하강하며 뒤로 이동합니다. forward_up: 카메라가 앞으로 이동하며 위로 기울어집니다. right_turn_forward: 오른쪽으로 회전한 뒤 앞으로 이동합니다. left_turn_forward: 왼쪽으로 회전한 뒤 앞으로 이동합니다. 가능한 값: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` - 비디오 생성의 유연성입니다. 값이 높을수록 모델의 유연성 정도가 낮아지고 사용자 프롬프트와의 관련성이 강해집니다. + 비디오 생성 시의 유연성입니다. 값이 높을수록 모델의 유연성 정도가 낮아지고 사용자 프롬프트와의 관련성이 강해집니다. - 범위: `0`부터 `1`까지 + 범위: `0` ~ `1` 형식: `float` - 비디오 길이(초) + 비디오 재생 시간(초) 가능한 값: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 사용자 지정 작업 ID입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. - - - - 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드입니다. pro: 더 긴 재생 시간의 비디오를 생성하지만 출력 품질이 더 높은 전문가 모드입니다. - - 가능한 값: `std`, `pro` + 사용자 정의 작업 ID입니다. 무시됩니다: comfy-api가 전달하기 전에 이 필드를 삭제하며, Comfy Router가 사용자를 대신해 폴링합니다. - 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내십시오. 모델은 요청 경로로 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. + 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내세요. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. - 프롬프트와 재생 시간 등 각 스토리보드에 대한 정보입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize인 경우 필수입니다. + 프롬프트와 재생 시간 등 각 스토리보드에 대한 정보입니다. 최대 6개의 스토리보드를 지원하며 최소 1개가 필요합니다. multi_shot이 true이고 shot_type이 customize일 때 필수입니다. @@ -261,19 +256,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 이 스토리보드의 프롬프트 단어입니다. 최대 길이는 512자입니다. + 이 스토리보드의 프롬프트입니다. 최대 길이는 512자입니다. - 멀티 샷 비디오를 생성할지 여부입니다. true인 경우 prompt 파라미터는 유효하지 않습니다. false인 경우 shot_type 및 multi_prompt 파라미터는 유효하지 않습니다. + 멀티 샷 비디오를 생성할지 여부입니다. true이면 prompt 파라미터가 유효하지 않습니다. false이면 shot_type 및 multi_prompt 파라미터가 유효하지 않습니다. - 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 긍정 프롬프트 안에 부정문으로 직접 보충하는 것이 권장됩니다. + 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 긍정 프롬프트 안에 부정문을 직접 넣어 보충하는 것이 권장됩니다. - 긍정 텍스트 프롬프트입니다. \<\<\>>을 사용하여 voice_list 파라미터 순서에 맞는 목소리를 지정할 수 있습니다. 하나의 작업은 최대 2개의 목소리를 참조할 수 있습니다. 목소리를 지정할 때는 sound 파라미터 값이 on이어야 합니다. + 긍정 텍스트 프롬프트입니다. \<\<\>>을 사용하여 voice_list 파라미터 순서에 맞는 음성을 지정하세요. 하나의 작업에서 최대 2개의 음색을 참조할 수 있습니다. 음색을 지정할 때는 sound 파라미터 값이 on이어야 합니다. @@ -283,36 +278,42 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 비디오 생성 시 사운드를 함께 생성할지 여부입니다. V2.6 및 이후 버전의 모델만 이 파라미터를 지원합니다. + 비디오를 생성할 때 사운드도 함께 생성할지 여부입니다. V2.6 이후 버전의 모델만 이 파라미터를 지원합니다. 가능한 값: `on`, `off` - 비디오 생성 시 참조되는 목소리 목록입니다. 최대 2개의 목소리를 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>>로 참조할 수 있습니다. `sound`를 "on"으로 설정해야 하며, 이는 V2.6 및 이후 버전의 모델만 지원합니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 목소리는 적용되지 않습니다. + 비디오 생성 시 참조할 음성 목록입니다. 최대 2개의 음성을 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>>로 참조하세요. `sound`를 "on"으로 설정해야 하며, 이를 지원하는 것은 V2.6 이후 버전의 모델뿐입니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 음성은 적용되지 않습니다. - 목소리 사용자 정의 API를 통해 반환된 목소리 ID 또는 시스템 사전 설정 목소리 ID입니다. + 음성 사용자 정의 API를 통해 반환된 음성 ID 또는 시스템 프리셋 음성 ID입니다. - 워터마크가 있는 결과를 함께 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. + 워터마크가 표시된 결과물도 함께 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. - true는 워터마크를 생성함을 의미하고, false는 생성하지 않음을 의미합니다. + true는 워터마크 생성, false는 생성하지 않음을 의미합니다. - 참조 이미지 - URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사가 포함되어서는 안 됩니다. + 참조 이미지: URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고 해상도는 300*300px 이상, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. - 참조 이미지 - 종료 프레임 제어. URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사가 포함되어서는 안 됩니다. dynamic_masks/static_mask 또는 camera_control과 동시에 사용할 수 없습니다. + 참조 이미지: 종료 프레임 제어. URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. dynamic_masks/static_mask 또는 카메라 제어와 동시에 사용할 수 없습니다. + + + + 비디오 생성 모드. std: 비용 효율적인 표준 모드입니다. pro: 더 긴 재생 시간의 비디오를 생성하지만 출력 품질이 더 높은 프로페셔널 모드입니다. + + 가능한 값: `std`, `pro` -Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 기준이 되는 것과 동일한 문서입니다. +Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스키마에서 생성되며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -325,11 +326,11 @@ Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스 - 작업 생성 시간, 밀리초 단위의 Unix 타임스탬프 + 작업 생성 시간, Unix 타임스탬프(밀리초) - 작업의 차감 단위 수 + 작업의 차감 단위 @@ -367,7 +368,7 @@ Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스 - 워터마크가 포함된 생성 비디오의 URL, 핫링크 보호 형식 + 워터마크가 포함된 생성된 비디오의 URL, 핫링크 방지 형식 형식: `uri` @@ -379,11 +380,11 @@ Router가 `GET /v2/models/kling/kling-v2-6/openapi.json`에서 제공하는 스 - 작업 상태 정보로, 작업이 실패할 때 실패 사유를 표시합니다 + 작업 상태 정보로, 작업이 실패할 경우 실패 원인을 표시합니다 - 작업 업데이트 시간, 밀리초 단위의 Unix 타임스탬프 + 작업 업데이트 시간, Unix 타임스탬프(밀리초) diff --git a/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx index 0c0b5cdd04..11f4b9483a 100644 --- a/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Kling V3 Omni 사용하기" description: "Comfy Router를 통해 kling/kling-v3-omni를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Kling V3 Omni" -translationSourceHash: 29d1799c +translationSourceHash: 7fdb91b8 translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": 68bd0500 + "Schema": 6d7cb727 "Examples": 6c2642d6 --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/kling/kling-v3-omni.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -205,12 +206,6 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ 가능한 값: `first_frame`, `end_frame` - - 비디오 생성 모드입니다. std: 표준 모드로 720P 비디오를 생성하며 비용 효율적입니다. pro: 전문가 모드로 1080P 비디오를 생성하며 더 높은 품질의 비디오를 출력합니다. - - 가능한 값: `pro`, `std` - - 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 전송하세요. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. @@ -279,6 +274,12 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ true는 워터마크 생성, false는 생성하지 않음을 의미합니다. + + 비디오 생성 모드입니다. std: 표준 모드로 720P 비디오를 생성하며 비용 효율적입니다. pro: 전문가 모드로 1080P 비디오를 생성하며 더 높은 품질의 비디오를 출력합니다. 4k: 울트라 HD 모드로 4K 해상도의 비디오를 생성합니다. 4k는 kling-v3-omni만 지원하며, kling-video-o1은 pro/std에만 응답합니다. + + 가능한 값: `pro`, `std`, `4k` + + Router가 `GET /v2/models/kling/kling-v3-omni/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -328,13 +329,13 @@ Router가 `GET /v2/models/kling/kling-v3-omni/openapi.json`에서 제공하는 - 생성된 비디오 URL + 생성된 비디오의 URL 형식: `uri` - 워터마크가 포함된 생성된 비디오 URL, 핫링크 보호 형식 + 워터마크가 포함된 생성된 비디오의 URL, 핫링크 보호 형식 형식: `uri` diff --git a/ko/development/comfy-router/models/kling/kling-v3/code.mdx b/ko/development/comfy-router/models/kling/kling-v3/code.mdx index 6010d60f36..26b444eaef 100644 --- a/ko/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Kling V3 사용하기" description: "Comfy Router를 통해 kling/kling-v3 호출하기: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling V3" -translationSourceHash: f5127eab +translationSourceHash: d84a12f2 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 6b9cddba "Quick start": 09c0a41a "Serving providers": b4093d36 - "Schema": 2fce4523 + "Schema": 605a654d "Examples": 8623c725 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/kling/kling-v3.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -179,7 +180,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 콜백 알림 주소입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 사용자를 대신해 폴링합니다. + 콜백 알림 주소입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. 형식: `uri` @@ -193,37 +194,37 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 카메라의 수평축(x축) 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 의미합니다. + 수평 축(x축)을 따른 카메라 이동을 제어합니다. 음수는 왼쪽, 양수는 오른쪽을 의미합니다. 범위: `-10` ~ `10` - 수직 평면에서의 카메라 회전(x축)을 제어합니다. 음수는 아래쪽 회전, 양수는 위쪽 회전을 의미합니다. + 수직 평면(x축)에서의 카메라 회전을 제어합니다. 음수는 아래쪽 회전, 양수는 위쪽 회전을 의미합니다. 범위: `-10` ~ `10` - 카메라의 롤링 양(z축)을 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 의미합니다. + 카메라의 롤링 수량(z축)을 제어합니다. 음수는 반시계 방향, 양수는 시계 방향을 의미합니다. 범위: `-10` ~ `10` - 수평 평면에서의 카메라 회전(y축)을 제어합니다. 음수는 왼쪽으로 회전, 양수는 오른쪽으로 회전을 의미합니다. + 수평 평면(y축)에서의 카메라 회전을 제어합니다. 음수는 왼쪽 회전, 양수는 오른쪽 회전을 의미합니다. 범위: `-10` ~ `10` - 카메라의 수직축(y축) 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 의미합니다. + 수직 축(y축)을 따른 카메라 이동을 제어합니다. 음수는 아래쪽, 양수는 위쪽을 의미합니다. 범위: `-10` ~ `10` - 카메라 초점 거리의 변화를 제어합니다. 음수는 좁은 시야각, 양수는 넓은 시야각을 의미합니다. + 카메라 초점 거리의 변화를 제어합니다. 음수는 좁은 화각, 양수는 넓은 화각을 의미합니다. 범위: `-10` ~ `10` @@ -243,23 +244,17 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 비디오 길이(초) + 비디오 재생 시간(초) 가능한 값: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - 사용자 지정 작업 ID입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 사용자를 대신해 폴링합니다. - - - - 비디오 생성 모드입니다. std: 표준 모드로 비용 효율적입니다. pro: 전문가 모드로, 더 긴 재생 시간의 비디오를 더 높은 품질로 생성합니다. - - 가능한 값: `std`, `pro` + 사용자 정의 작업 ID입니다. 무시됨: comfy-api가 전달 전에 이 필드를 제거하며, Comfy Router가 대신 폴링합니다. - 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내십시오. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. + 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 보내세요. 모델은 요청 경로에 의해 선택되며, 이름을 제공하는 경우 해당 경로와 일치해야 합니다. @@ -267,7 +262,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 이 스토리보드의 재생 시간(초)입니다. 전체 작업 재생 시간을 초과할 수 없으며 1보다 작을 수 없습니다. 모든 스토리보드 재생 시간의 합은 전체 작업 재생 시간과 같아야 합니다. + 이 스토리보드의 재생 시간(초)입니다. 전체 작업 재생 시간을 초과할 수 없으며 1보다 작을 수 없습니다. 모든 스토리보드 재생 시간의 합은 전체 작업 재생 시간과 같습니다. @@ -279,31 +274,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 멀티 샷 비디오를 생성할지 여부입니다. true일 때 prompt 파라미터는 유효하지 않습니다. false일 때 shot_type 및 multi_prompt 파라미터는 유효하지 않습니다. + 다중 샷 비디오를 생성할지 여부입니다. true이면 prompt 파라미터가 무효가 됩니다. false이면 shot_type 및 multi_prompt 파라미터가 무효가 됩니다. - 네거티브 텍스트 프롬프트입니다. 포지티브 프롬프트 안에 직접 부정 문장을 넣어 네거티브 프롬프트 정보를 보완하는 것을 권장합니다. + 네거티브 텍스트 프롬프트입니다. 네거티브 프롬프트 정보는 포지티브 프롬프트 안에 부정문으로 직접 보완하는 것을 권장합니다. - 포지티브 텍스트 프롬프트입니다. \<\<\>> 을 사용해 voice_list 파라미터 순서에 맞는 음성을 지정할 수 있습니다. 작업 하나에서 최대 2개의 톤을 참조할 수 있습니다. 톤을 지정할 때는 sound 파라미터 값이 on이어야 합니다. + 포지티브 텍스트 프롬프트입니다. \<\<\>>을 사용하여 voice_list 파라미터 순서에 맞는 음성을 지정합니다. 하나의 작업은 최대 2개의 음색을 참조할 수 있습니다. 음색을 지정할 때 sound 파라미터 값은 on이어야 합니다. - 스토리보드 방법입니다. multi_shot 파라미터가 true로 설정된 경우 필수입니다. + 스토리보드 방식입니다. multi_shot 파라미터가 true로 설정된 경우 필수입니다. 가능한 값: `customize`, `intelligence` - 비디오 생성 시 사운드를 동시에 생성할지 여부입니다. 모델 V2.6 이상 버전만 이 파라미터를 지원합니다. + 비디오를 생성할 때 사운드도 동시에 생성할지 여부입니다. V2.6 이상 버전의 모델만 이 파라미터를 지원합니다. 가능한 값: `on`, `off` - 비디오 생성 시 참조하는 음성 목록입니다. 최대 2개의 음성을 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>> 로 참조하십시오. `sound`를 "on"으로 설정해야 하며, 이는 모델 V2.6 이상 버전만 지원합니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 음성은 적용되지 않습니다. + 비디오 생성 시 참조되는 음성 목록입니다. 최대 2개의 음성을 지원하며, 목록 순서대로 `prompt`에서 \<\<\>> 및 \<\<\>>로 참조합니다. `sound`를 "on"으로 설정해야 하며, 이는 V2.6 이상 버전의 모델만 지원합니다. 이전 모델이거나 `sound`가 기본값인 "off"로 남아 있으면 음성이 적용되지 않습니다. @@ -311,22 +306,28 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 워터마크가 있는 결과물을 동시에 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. + 워터마크가 있는 결과를 동시에 생성할지 여부입니다. 현재 사용자 정의 워터마크는 지원되지 않습니다. - true는 워터마크를 생성한다는 의미이고, false는 생성하지 않는다는 의미입니다. + true는 워터마크를 생성함, false는 생성하지 않음을 의미합니다. - 참조 이미지: URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. + 참조 이미지 - URL 또는 Base64 인코딩 문자열입니다. 10MB를 초과할 수 없으며, 해상도는 300*300px 이상, 가로세로 비율은 1:2.5 ~ 2.5:1 사이여야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. - 참조 이미지: 종료 프레임 제어. URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고, 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. dynamic_masks/static_mask 또는 카메라 제어와 동시에 사용할 수 없습니다. + 참조 이미지 - 종료 프레임 제어입니다. URL 또는 Base64 인코딩 문자열이며, 10MB를 초과할 수 없고 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. dynamic_masks/static_mask 또는 카메라 제어와 동시에 사용할 수 없습니다. + + + + 비디오 생성 모드입니다. std: 비용 효율적인 표준 모드입니다. pro: 전문가 모드로, 더 긴 재생 시간의 비디오를 생성하지만 출력 품질이 더 높습니다. 4k: 초고화질 모드로, 4K 해상도 비디오를 생성합니다. 이 제품군에서 4k를 지원하는 모델은 kling-v3뿐이며, 다른 모든 Kling 텍스트 기반 비디오 생성 모델은 pro/std만 응답합니다. + + 가능한 값: `std`, `pro`, `4k` -Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 문서와 동일합니다. +Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키마를 기반으로 생성되며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -367,7 +368,7 @@ Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키 - 비디오 총 재생 시간(초) + 총 비디오 재생 시간(초) @@ -375,13 +376,13 @@ Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키 - 생성된 비디오 URL + 생성된 비디오의 URL 형식: `uri` - 워터마크가 적용된 생성된 비디오 URL, 핫링크 방지 형식 + 워터마크가 포함된 생성된 비디오의 URL, 핫링크 방지 형식 형식: `uri` @@ -393,7 +394,7 @@ Router가 `GET /v2/models/kling/kling-v3/openapi.json`에서 제공하는 스키 - 작업 상태 정보로, 작업 실패 시 실패 이유를 표시합니다 + 작업 상태 정보로, 작업이 실패할 때 실패 사유를 표시합니다 diff --git a/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx b/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx index dacb6a13f1..8fb5605e25 100644 --- a/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Kling Video O1 사용하기" description: "Comfy Router를 통해 kling/kling-video-o1 호출: endpoint, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Kling Video O1" -translationSourceHash: 892ccf77 +translationSourceHash: 8870f379 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": f693e2ef + "Schema": e4a41688 "Examples": 6c2642d6 --- + {/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/kling/kling-video-o1.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -172,7 +173,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 비디오 길이(초)입니다. 비디오 편집 기능(refer_type: base)을 사용하는 경우 출력 재생 시간은 입력 비디오와 동일하며 이 파라미터는 무효입니다. + 비디오 재생 시간(초)입니다. 비디오 편집 기능(refer_type: base)을 사용하는 경우 출력 재생 시간은 입력 비디오와 동일하며 이 파라미터는 무효입니다. 사용 가능한 값: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` @@ -200,17 +201,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 이미지가 첫 프레임인지 마지막 프레임인지 여부입니다. first_frame은 첫 프레임, end_frame은 마지막 프레임입니다. 현재 마지막 프레임만 사용하는 것은 지원되지 않습니다. + 이미지가 첫 프레임인지 마지막 프레임인지 여부입니다. first_frame은 첫 프레임, end_frame은 마지막 프레임입니다. 현재 종료 프레임만 사용하는 것은 지원되지 않습니다. 사용 가능한 값: `first_frame`, `end_frame` - - 비디오 생성 모드입니다. std: 표준 모드로 720P 비디오를 생성하며 비용 효율적입니다. pro: 전문가 모드로 1080P 비디오를 생성하며 더 높은 품질의 비디오를 출력합니다. - - 사용 가능한 값: `pro`, `std` - - 모델 이름입니다. Comfy Router를 사용할 때는 생략하거나 null을 전송하세요. 모델은 요청 경로에 의해 선택됩니다. 이름을 제공하는 경우 해당 경로와 일치해야 합니다. @@ -236,7 +231,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 텍스트 프롬프트 단어로, 긍정 및 부정 설명을 포함할 수 있습니다. 2,500자를 초과할 수 없습니다. \<\<\<>>> 형식으로 요소, 이미지 또는 비디오를 지정할 수 있습니다. 예: \<\>, \<\<\>>, \<\<\>>. + 텍스트 프롬프트 단어로, 긍정 및 네거티브 설명을 포함할 수 있습니다. 2,500자를 초과할 수 없습니다. 요소, 이미지 또는 비디오를 \<\<\<>>> 형식으로 지정할 수 있습니다. 예: \<\>, \<\<\>>, \<\<\>>. @@ -256,7 +251,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 비디오 원본 사운드를 유지할지 여부입니다. yes는 유지, no는 유지를 하지 않음을 나타냅니다. + 비디오 원본 사운드를 유지할지 여부입니다. yes는 유지, no는 유지하지 않음을 나타냅니다. 사용 가능한 값: `yes`, `no` @@ -279,7 +274,13 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ true는 워터마크 생성, false는 생성을 하지 않음을 나타냅니다. -`GET /v2/models/kling/kling-video-o1/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. + + 비디오 생성 모드입니다. std: 표준 모드로 720P 비디오를 생성하며 비용 효율적입니다. pro: 전문가 모드로 1080P 비디오를 생성하며 더 높은 품질의 비디오를 출력합니다. + + 사용 가능한 값: `pro`, `std` + + +`GET /v2/models/kling/kling-video-o1/openapi.json`에서 Router가 제공하는 스키마에서 생성되었습니다. 이 문서는 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 데 사용하는 문서와 동일합니다. ### 출력 diff --git a/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx b/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx new file mode 100644 index 0000000000..1882ac6885 --- /dev/null +++ b/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx @@ -0,0 +1,222 @@ +--- +title: "Comfy Router로 LTX Video Alpha Gen 사용하기" +description: "Comfy Router를 통해 ltx/ltx-video-alpha-gen을 호출합니다. 엔드포인트, 요청 형태 및 Router가 반환하는 응답을 설명합니다." +sidebarTitle: "LTX Video Alpha Gen" +translationSourceHash: 9ad35117 +translationFrom: development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx +translationBlockHashes: + "_intro": 99d9f21c + "Quick start": 3fae9114 + "Schema": 2e86e846 + "Examples": 68527b2e +--- +{/* GENERATED FILE. Generated from router-schemas/ltx/ltx-video-alpha-gen.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-alpha-gen`의 API 레퍼런스이며, LTX에서 Comfy Router를 통해 제공됩니다. + +**입력:** 비디오 · **출력:** 비디오 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용합니다. cURL 스니펫은 원시 HTTP를 통한 동일한 호출입니다. + +**모델 ID:** `ltx/ltx-video-alpha-gen` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-alpha-gen", + { + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("ltx/ltx-video-alpha-gen", { + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests`로 전송합니다. Router는 실행이 승인되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비되면 이 프로세스 또는 다른 프로세스에서 수집됩니다. [대기열 전달](/ko/development/comfy-router/queue)은 상태, 취소 및 수집 과정을 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-alpha-gen", + { + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 기다립니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자의 자체 페이로드이며, models.run()이 반환하는 것과 동일한 값입니다. + # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("ltx/ltx-video-alpha-gen", { + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 기다립니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 모델의 네이티브 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202입니다. +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 공개적으로 접근 가능한 HTTPS URL 또는 base64 데이터 URI로 입력 비디오를 제공합니다. MP4, MOV 또는 MKV 형식의 H.264 또는 HEVC를 지원하며, URL 기준 최대 200 MB까지 가능합니다. 긴 변은 최대 3840 픽셀, 짧은 변은 최대 2160 픽셀입니다. + + +`GET /v2/models/ltx/ltx-video-alpha-gen/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. + +### 출력 + + + 작업 완료 타임스탬프 (ISO 8601) + + + + 작업 생성 타임스탬프 (ISO 8601) + + + + status가 failed일 때 존재합니다 + + + + + + + + + + + + 고유한 작업 식별자 + + + + status가 completed일 때 존재합니다. 출력 URL은 완료 후 24시간 뒤에 만료됩니다 + + + + 매트를 알파 채널로 사용하는 입력 비디오의 URL이며, ProRes 4444 MOV입니다 + + + + 회색조 알파 매트의 URL이며, 흰색이 전경인 MP4입니다 + + + + 작업 상태 (pending, processing, completed, failed) + + +## Examples + +### 입력 + +```json +{ + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 출력 + +```json +{ + "completed_at": "2026-01-01T00:00:50Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "cutout_video_url": "https://example.invalid/ltx/cutout.mov", + "matte_video_url": "https://example.invalid/ltx/matte.mp4" + }, + "status": "completed" +} +``` + + + diff --git a/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx b/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx new file mode 100644 index 0000000000..1fe8483037 --- /dev/null +++ b/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx @@ -0,0 +1,233 @@ +--- +title: "Comfy Router로 LTX Video To Video Hdr 사용하기" +description: "Comfy Router를 통해 ltx/ltx-video-to-video-hdr을 호출하세요: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." +sidebarTitle: "LTX Video To Video Hdr" +translationSourceHash: 42a210ab +translationFrom: development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx +translationBlockHashes: + "_intro": 73aee58d + "Quick start": 0cc37810 + "Schema": 511ed3d7 + "Examples": 2bedcca6 +--- +{/* GENERATED FILE. Generated from router-schemas/ltx/ltx-video-to-video-hdr.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-to-video-hdr`의 API 레퍼런스로, LTX에서 Comfy Router를 통해 제공됩니다. + +**입력:** 비디오 · **출력:** 비디오 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다. + +**모델 ID:** `ltx/ltx-video-to-video-hdr` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 멱등성 키를 자동으로 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-to-video-hdr", + { + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 멱등성 키를 자동으로 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("ltx/ltx-video-to-video-hdr", { + output_colorspace: "acescg", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"output_colorspace\": \"acescg\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests`로 전송합니다. Router는 실행이 승인되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비되면 이 프로세스에서든 다른 프로세스에서든 수집됩니다. [대기열 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 살펴봅니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-to-video-hdr", + { + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자의 자체 페이로드로, models.run()이 반환하는 것과 동일한 값입니다. + # 실패했거나 취소된 요청은 여기서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("ltx/ltx-video-to-video-hdr", { + output_colorspace: "acescg", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"output_colorspace\": \"acescg\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 완료되면 모델의 원본 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202를 반환합니다. +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + `result.exr_frames_url`에 있는 OpenEXR 프레임 시퀀스의 색상 공간입니다. `result.video_url`에는 영향을 주지 않습니다. + + 가능한 값: `acescg`, `acescct`, `srgb_linear`, `aces2065-1` + + + + 공개적으로 접근 가능한 HTTPS URL 또는 base64 데이터 URI로 전달하는 입력 비디오입니다. MP4, MOV 또는 MKV 형식의 H.264 또는 HEVC이며, URL 기준 최대 200 MB입니다. 너비와 높이는 방향에 관계없이 3840x2160 이내여야 합니다. + + +Router가 `GET /v2/models/ltx/ltx-video-to-video-hdr/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. + +### 출력 + + + 작업 완료 타임스탬프 (ISO 8601) + + + + 작업 생성 타임스탬프 (ISO 8601) + + + + status가 failed일 때 존재합니다 + + + + + + + + + + + + 고유 작업 식별자 + + + + status가 completed일 때 존재하며, 출력 URL은 완료 후 24시간 뒤에 만료됩니다 + + + + 요청한 색상 공간의 프레임별 OpenEXR 이미지를 담은 ZIP 파일의 URL + + + + HDR 비디오의 URL이며, 10비트 HEVC BT.2020/HLG MP4입니다 + + + + 작업 상태 (pending, processing, completed, failed) + + +## 예시 + +### 입력 + +```json +{ + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 출력 + +```json +{ + "completed_at": "2026-01-01T00:00:45Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "exr_frames_url": "https://example.invalid/ltx/exr_frames.zip", + "video_url": "https://example.invalid/ltx/hdr.mp4" + }, + "status": "completed" +} +``` + + + diff --git a/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx b/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx new file mode 100644 index 0000000000..fa7f6c4f02 --- /dev/null +++ b/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx @@ -0,0 +1,261 @@ +--- +title: "Comfy Router로 LTX Video To Video Reframe 사용하기" +description: "Comfy Router를 통해 ltx/ltx-video-to-video-reframe을 호출합니다. 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." +sidebarTitle: "LTX Video To Video Reframe" +translationSourceHash: a82950a2 +translationFrom: development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx +translationBlockHashes: + "_intro": 06c6f3d9 + "Quick start": a6026b27 + "Schema": 4d231f97 + "Examples": 846aabe4 +--- +{/* GENERATED FILE. Generated from router-schemas/ltx/ltx-video-to-video-reframe.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-to-video-reframe`에 대한 API 레퍼런스로, LTX에서 Comfy Router를 통해 제공됩니다. + +**입력:** 비디오 · **출력:** 비디오 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행한 것입니다. + +**모델 ID:** `ltx/ltx-video-to-video-reframe` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-to-video-reframe", + { + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("ltx/ltx-video-to-video-reframe", { + resolution: "720x1280", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"720x1280\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests`로 전송합니다. Router는 실행이 승인되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비되는 대로 이 프로세스 또는 다른 프로세스에서 수집합니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-to-video-reframe", + { + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자 자체의 페이로드이며, models.run()이 반환하는 것과 같은 값입니다. + # 실패했거나 취소된 요청은 여기서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("ltx/ltx-video-to-video-reframe", { + resolution: "720x1280", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 제출. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"720x1280\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집. 모델의 원본 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202입니다. +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 출력 프레임 안에서 소스 비디오가 위치하는 곳입니다. `anchor`를 보내거나, `x`와 `y`에 `width`, `height` 중 하나 또는 둘 다를 함께 보내세요. `placement`를 생략하면 비디오가 들어갈 수 있는 최대 크기로 중앙에 배치됩니다. + + + + 비디오를 배치할 출력 프레임의 모서리 또는 변입니다. + + 가능한 값: `center`, `top`, `bottom`, `left`, `right`, `top_left`, `top_right`, `bottom_left`, `bottom_right` + + + + 배치된 비디오의 높이로, 출력 높이에 대한 비율입니다. + + 형식: `double` + + + + 배치된 비디오의 너비로, 출력 너비에 대한 비율입니다. + + 형식: `double` + + + + 배치된 비디오의 왼쪽 가장자리로, 출력 너비에 대한 비율입니다. + + 형식: `double` + + + + 배치된 비디오의 위쪽 가장자리로, 출력 높이에 대한 비율입니다. + + 형식: `double` + + + + 대상 출력 해상도입니다. 소스 비디오는 이 프레임을 채우도록 확장됩니다. + + 가능한 값: `720x720`, `1080x1080`, `720x900`, `1080x1350`, `900x720`, `1350x1080`, `720x1280`, `1080x1920`, `1280x720`, `1920x1080` + + + + 공개적으로 접근 가능한 HTTPS URL 또는 base64 데이터 URI로 된 입력 비디오입니다. MP4, MOV 또는 MKV 형식의 H.264 또는 HEVC를 지원하며, URL 기준 최대 200 MB입니다. 최대 60초 및 1800 프레임이며, 너비와 높이는 64~4096 픽셀입니다. + + +Router가 `GET /v2/models/ltx/ltx-video-to-video-reframe/openapi.json`에서 제공하는 스키마로부터 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 Router가 호출을 검증하는 것과 동일한 문서입니다. + +### 출력 + + + 작업 완료 타임스탬프 (ISO 8601) + + + + 작업 생성 타임스탬프 (ISO 8601) + + + + 상태가 failed일 때 존재합니다 + + + + + + + + + + + + 고유한 작업 식별자 + + + + 상태가 completed일 때 존재합니다. 출력 URL은 완료 후 24시간 뒤에 만료됩니다 + + + + 생성된 비디오의 URL + + + + 작업 상태 (pending, processing, completed, failed) + + +## 예시 + +### 입력 + +```json +{ + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 출력 + +```json +{ + "completed_at": "2026-01-01T00:00:20Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "video_url": "https://example.invalid/ltx/output.mp4" + }, + "status": "completed" +} +``` + + diff --git a/ko/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx b/ko/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx new file mode 100644 index 0000000000..24dd02320b --- /dev/null +++ b/ko/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx @@ -0,0 +1,227 @@ +--- +title: "Comfy Router에서 LTX Video Upscale 사용하기" +description: "Comfy Router를 통해 ltx/ltx-video-upscale를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." +sidebarTitle: "LTX Video Upscale" +translationSourceHash: 00a8b2b0 +translationFrom: development/comfy-router/models/ltx/ltx-video-upscale/code.mdx +translationBlockHashes: + "_intro": 8ef040a0 + "Quick start": e19118f2 + "Schema": b6e43e38 + "Examples": a6d53aaa +--- +{/* 생성됨 파일. router-schemas/ltx/ltx-video-upscale.json에서 `pnpm code-pages:gen`으로 생성되었습니다. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-upscale`에 대한 API 레퍼런스이며, Comfy Router에서 LTX로 제공합니다. + +**입력:** 비디오 · **출력:** 비디오 + 오디오 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 전송합니다. + +**모델 ID:** `ltx/ltx-video-upscale` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-upscale` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경 변수에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-upscale", + { + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경 변수에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("ltx/ltx-video-upscale", { + resolution: "1080p", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"1080p\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests`로 전송합니다. Router는 실행이 승인되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비되면 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 단계별로 설명합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경 변수에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-upscale", + { + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자의 원본 페이로드이며, models.run()이 반환하는 것과 같은 값입니다. + # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경 변수에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("ltx/ltx-video-upscale", { + resolution: "1080p", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 제출. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"1080p\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집. 모델의 원본 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202입니다. +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 출력 크기입니다. 가로세로 비율은 유지됩니다. + + 가능한 값: `1080p`, `4k`, `8k` + + + + 공개적으로 접근 가능한 HTTPS URL 또는 base64 데이터 URI로 된 입력 비디오입니다. MP4, MOV 또는 MKV 형식의 H.264 또는 HEVC이며, URL 기준 최대 200 MB입니다. 짧은 변은 최소 480픽셀이어야 합니다. + + +Router가 `GET /v2/models/ltx/ltx-video-upscale/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. + +### 출력 + + + 작업 완료 타임스탬프 (ISO 8601) + + + + 작업 생성 타임스탬프 (ISO 8601) + + + + status가 failed일 때 존재합니다 + + + + + + + + + + + + 고유한 작업 식별자 + + + + status가 completed일 때 존재합니다. 출력 URL은 완료 후 24시간 뒤에 만료됩니다 + + + + 생성된 비디오의 URL + + + + 작업 상태 (pending, processing, completed, failed) + + +## 예시 + +### 입력 + +```json +{ + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 출력 + +```json +{ + "completed_at": "2026-01-01T00:00:20Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "video_url": "https://example.invalid/ltx/output.mp4" + }, + "status": "completed" +} +``` + + diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 4c45ac6433..e0cce685b0 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -2,14 +2,16 @@ title: "Comfy Router에서 GPT Image 2.6 Flare 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2.6-flare를 호출합니다: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." sidebarTitle: "GPT Image 2.6 Flare" -translationSourceHash: 9f6b894f +translationSourceHash: 82634d88 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx translationBlockHashes: "_intro": 1693e80a "Quick start": 8222d9f4 - "Schema": 78f788c9 + "Schema": 85f18947 "Examples": c73859ec --- + + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.6-flare.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -159,6 +161,18 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES 가능한 값: `transparent`, `opaque`, `auto` + + 애니메이션 GIF의 프레임 수입니다(2-16, OpenAI 자체 범위). `output_format: "gif"`인 경우에만 의미가 있으며, 다른 `output_format`과 함께 사용하면 거부됩니다. GIF 요청에서 생략하면 OpenAI 자체 기본값인 9가 적용됩니다. 단, Comfy는 환경별로 이 필드에 상한을 추가로 적용합니다(ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES, 이 필드 자체의 최댓값인 16을 넘지 않음). 설정된 상한을 초과하는 값은 거부되며, 기본값 9 자체가 설정된 상한을 초과하는 경우에는 생략된 `frame_count`가 조용히 낮춰지지 않고 거부됩니다. 따라서 호출자는 OpenAI 기본값보다 조용히 더 작은 애니메이션을 받는 대신 `frame_count`를 명시적으로 설정하라는 안내를 받습니다. 프레임 수는 사전 견적과 64 MiB 결과 상한도 제한하며, 두 값 모두 프레임 수에 비례해 커집니다. + + 범위: `2` ~ `16` + + + + 각 프레임이 표시되는 시간(밀리초)입니다(OpenAI 자체 범위는 20-2000이며 10 ms 단위로 반올림됨). `output_format: "gif"`인 경우에만 의미가 있으며, 다른 `output_format`과 함께 사용하면 거부됩니다. GIF 요청에서 생략하면 OpenAI 자체 기본값인 200이 적용됩니다. + + 범위: `20` ~ `2000` + + 편집할 소스 이미지입니다. 이 필드의 존재 여부가 편집 작업을 선택합니다. 텍스트 기반 이미지 생성을 위해서는 이 필드를 완전히 생략하세요. 모델의 공개된 예시는 이 필드를 생략한 GENERATION 호출입니다. `image`를 추가하는 것이 두 모드 사이의 차이 전부입니다. 엔드포인트도 같고 모델 id도 같습니다. 다만 편집 프롬프트는 장면이 아니라 원하는 변경을 설명하므로, 구조적으로 새로 추가된 것은 이 필드뿐인데도 아래의 편집 본문은 생성 예시와 다르게 읽힙니다. @@ -180,8 +194,9 @@ URL은 자격 증명 없이 접근 가능해야 합니다. Router는 서버 측 각 이미지는 25 MiB로 제한되며, 한 요청의 이미지 전체는 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 전송하는 호출)로, 이 경우 각 이미지는 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀이고 한 요청의 이미지 전체는 최대 128 MiB입니다. + - 실행할 gpt-image 모델입니다. Router가 지정된 모델 id를 끼워 넣으므로, /v2/models/openai/gpt-image-2를 지정하는 호출자는 이 필드를 보내지 않습니다. + 실행할 gpt-image 모델입니다. Router가 주소 지정된 모델 id를 삽입하므로, /v2/models/openai/gpt-image-2.6-flare를 주소 지정하는 호출자는 이 값을 보내지 않습니다. @@ -191,45 +206,45 @@ URL은 자격 증명 없이 접근 가능해야 합니다. Router는 서버 측 - 생성할 이미지 수(1-10). + 생성할 이미지 수입니다(1-10). GIF 요청(`output_format` 참조)은 1 이외의 값을 거부합니다. OpenAI 자체 설명에서는 GIF 요청의 `n`을 "애니메이션 수"라고 부르지만, Router는 v1에서 이에 대한 가격을 책정하지 않습니다. - 범위: `1` ~ `10` + 범위: `1`부터 `10`까지 - JPEG 또는 WebP의 압축 수준(0-100) + JPEG 또는 WebP의 압축 수준입니다(0-100). GIF 요청에서는 거부됩니다. OpenAI는 애니메이션 출력에 압축 수준을 허용하지 않습니다. - 범위: `0` ~ `100` + 범위: `0`부터 `100`까지 - 출력 이미지의 형식 + 출력 이미지의 형식입니다. `gif`는 추가로 `mask`, 1이 아닌 `n`, 생략되었거나 `auto`이거나 형식이 잘못된 `size`, `stream: true`, 0보다 큰 `partial_images`, `output_compression`을 거부합니다. 각 필드의 설명을 참조하세요. 또한 Comfy가 이 환경에서 이를 활성화하지 않은 경우에는 전면 거부됩니다. - 가능한 값: `png`, `webp`, `jpeg` + 가능한 값: `png`, `webp`, `jpeg`, `gif` - 라이브 스트림과 함께일 때만 의미가 있지만, 이 표면은 스트림을 제공할 수 없습니다. `stream`은 보내더라도 `false`로 확정됩니다. 생성 시에는 `0` 또는 `null`이 아닌 값이면 요청이 `stream: true`를 함께 보내는지와 무관하게 400으로 거부되며, `image`를 포함한 요청에서는 이 필드가 전달되지 않고 삭제됩니다. 생략하십시오. + 라이브 스트림과 함께 사용할 때만 의미가 있으며, 이 표면은 OpenAIImageRouterRequest에서와 똑같이 해당 스트림을 제공할 수 없습니다. 해당 필드의 설명을 참조하세요. GIF 요청에서는 `stream: true`와 같은 이유로 0보다 큰 값이 거부되며, 0은 허용됩니다. - 범위: `0` ~ `3` + 범위: `0`부터 `3`까지 - 생성할 이미지에 대한 설명 텍스트 또는 `image`에 적용할 편집 내용에 대한 설명입니다. + 생성할 이미지 또는 `image`에 수행할 편집에 대한 텍스트 설명입니다. - 생성 또는 편집된 이미지의 품질입니다. `xhigh`와 `max`는 gpt-image-2.5-flare와 gpt-image-2.5-sunburst가 추가된 두 등급이며, `standard`와 `hd`는 허용된 어떤 모델도 읽지 않는 dall-e 시대의 표기입니다. + 생성되거나 편집된 이미지의 품질입니다. `xhigh`와 `max`는 gpt-image-2.5-flare 및 gpt-image-2.5-sunburst가 추가된 두 등급이며, `standard`와 `hd`는 허용된 어떤 모델도 인식하지 않는 dall-e 시대의 표기입니다. 가능한 값: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` - 이미지 크기(예: 1024x1024, 1536x1024, auto) + 이미지 크기입니다(예: 1024x1024, 1536x1024, auto). GIF 요청(`output_format` 참조)은 `auto`를 거부하고 이 필드를 생략하는 것도 거부합니다. 명시적인 크기는 프레임 수가 이 값들을 곱하기 전에 사전 견적과 64 MiB 결과 상한을 유한하게 유지하는 역할을 합니다. - 보내는 호출자가 거부되지 않도록 선언되어 있지만, 이 표면에서는 무효(INERT)입니다. Router는 `text/event-stream`을 중계하는 대신 공급자 응답을 캡처하기 때문에 디스패치 전에 이 값을 `false`로 확정(SETTLE)합니다(`image`를 포함한 요청에서는 편집이 해당 필드 없이 재인코딩되므로 필드가 삭제됩니다). 어떤 Comfy 표면도 gpt-image의 부분 이미지 스트리밍을 제공하지 않습니다. v1 `POST /proxy/openai/images/generations` 인그레스는 `stream: true`를 400으로 거부하고 요청을 업스트림으로 전달하지 않으므로, 이 필드를 생략하고 완료된 응답을 하나의 JSON 본문으로 읽으십시오. 스트림이 열리지 않으므로 `stream: true`와 1보다 큰 `n`을 함께 쓰는 것에 대한 OpenAI의 제한은 여기에 적용되지 않으며, `n`은 보낸 그대로 전달됩니다. + 이 값을 보내는 호출자가 거부되지 않도록 선언되어 있지만, 이 표면에서는 OpenAIImageRouterRequest에서와 똑같이 무효(INERT)입니다. 해당 필드의 설명을 참조하세요. GIF 요청에서는 `true`가 거부되며(OpenAI 가이드에서는 GIF 출력이 스트리밍을 지원하지 않는다고 명시), `false`는 허용됩니다. @@ -297,7 +312,7 @@ Router가 `GET /v2/models/openai/gpt-image-2.6-flare/openapi.json`에서 제공 - 생성된 이미지의 배경이 `opaque`인지 `transparent`인지로, OpenAI가 이번 생성에 대해 확정한 값입니다. 요청 매개변수의 기본값은 `auto`이므로, 이를 고정하지 않은 호출자는 여기에서 어떤 값이 생성되었는지 알 수 있습니다. + 생성된 이미지의 배경이 `opaque`인지 `transparent`인지로, OpenAI가 이번 생성에 대해 확정한 값입니다. 요청 매개변수의 기본값은 `auto`이므로, 이 값을 고정하지 않은 호출자는 여기에서 어떤 값이 생성되었는지 알 수 있습니다. @@ -307,7 +322,7 @@ Router가 `GET /v2/models/openai/gpt-image-2.6-flare/openapi.json`에서 제공 - `data[].b64_json`에 있는 바이트의 인코딩으로, `png`, `webp` 또는 `jpeg`입니다. OpenAI가 실제로 인코딩한 형식이며, 요청에 `output_format`이 전송된 경우에는 해당 값이고 전송되지 않은 경우에는 `png`이므로, 디코더는 요청에서 형식을 다시 도출하지 않고 이 값을 기준으로 삼을 수 있습니다. + `data[].b64_json`에 있는 바이트의 인코딩으로, `png`, `webp` 또는 `jpeg`입니다. OpenAI가 실제로 인코딩한 형식이며, 요청에 `output_format`이 전송된 경우에는 그 값이고 전송되지 않은 경우에는 `png`이므로, 디코더는 요청에서 형식을 다시 도출하지 않고 이 값을 기준으로 삼을 수 있습니다. diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 4bbaf2adb8..ec1f2b159e 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router로 GPT Image 2.6 Sunburst 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2.6-sunburst를 호출하는 방법: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "GPT Image 2.6 Sunburst" -translationSourceHash: e71f1905 +translationSourceHash: 4e6d4ec0 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx translationBlockHashes: "_intro": 280b9c93 "Quick start": 2d3cb42c - "Schema": 2a71e1a8 + "Schema": 5296621a "Examples": c73859ec --- + {/* 생성된 파일. router-schemas/openai/gpt-image-2.6-sunburst.json에서 `pnpm code-pages:gen`으로 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -159,6 +160,18 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ 가능한 값: `transparent`, `opaque`, `auto` + + 애니메이션 GIF의 프레임 수입니다(2-16, OpenAI 자체 범위). `output_format: "gif"`인 경우에만 의미가 있으며, 다른 `output_format`과 함께 사용하면 거부됩니다. GIF 요청에서 생략하면 OpenAI 자체 기본값인 9가 적용됩니다. 단, Comfy는 환경별로 이 필드에 추가 상한을 적용합니다(ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES, 이 필드 자체의 최댓값 16을 넘을 수 없음). 설정된 상한을 초과하는 값은 거부되며, 기본값 9 자체가 설정된 상한을 초과하는 경우에는 생략된 `frame_count`를 조용히 낮추는 대신 거부합니다. 따라서 호출자는 OpenAI 기본값보다 조용히 더 작은 애니메이션을 받는 대신 `frame_count`를 명시적으로 설정하라는 안내를 받습니다. 프레임 수는 사전 견적과 64 MiB 결과 상한의 기준이 되며, 둘 다 이 값에 비례해 커집니다. + + 범위: `2`부터 `16`까지 + + + + 각 프레임이 표시되는 시간(밀리초)입니다(OpenAI 자체 범위는 20-2000이며 10 ms 단위로 반올림됨). `output_format: "gif"`인 경우에만 의미가 있으며, 다른 `output_format`과 함께 사용하면 거부됩니다. GIF 요청에서 생략하면 OpenAI 자체 기본값인 200이 적용됩니다. + + 범위: `20`부터 `2000`까지 + + 편집할 소스 이미지입니다. 이 필드가 있으면 편집 작업이 선택됩니다. 텍스트 기반 이미지 생성에는 이 필드를 완전히 생략하십시오. 모델의 공개 예시는 이 필드를 생략하는 GENERATION 호출입니다. `image`를 추가하는 것이 두 모드 사이의 차이 전부입니다: 엔드포인트도 같고 모델 id도 같습니다. 다만 편집 프롬프트는 장면이 아니라 원하는 변경을 설명하므로, 구조적으로 새로 추가되는 필드는 이것 하나뿐인데도 아래의 편집 본문은 생성 예시와 다르게 읽힙니다. @@ -174,14 +187,15 @@ URL은 자격 증명 없이 접근할 수 있어야 합니다. Router는 이를 두 가지 확장이 롤아웃 중이며 현재 둘 다 기본적으로 꺼져 있습니다. 이들은 하나의 전환 뒤에서 제공되며 함께 활성화되므로, 아래의 모든 내용은 아직 구축 대상으로 삼을 것이 아니라 향후 제공될 예정인 것으로 취급하십시오. 둘 중 하나에 의존하기 전에 문의하십시오. 첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 롤아웃이 사용자 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기에서 거부됩니다. 버킷은 Comfy 자체의 것이고 호스트도 동일한데도 그렇습니다. 따라서 "Comfy에 업로드한 다음 URL을 전달"하는 방식은 아직 작동하지 않으며, 작동하는 형식은 `/api/assets/{id}/content`가 리다이렉트하는 서명된 URL입니다. 두 번째는 모든 사용자에게 한꺼번에 적용되는 것이 아니라 계정별로 활성화됩니다. 이 호스트 뒤의 버킷이 우리 것이 아니라 사용자의 것이기 때문입니다. 위의 전환이 켜져 있더라도 제3자 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 안내 대신 그 표현 그대로 안내받습니다. 사용자의 계정에 대해 활성화하려면 Comfy 담당자에게 문의하십시오. 또한 버킷이 사용자 소유이고 Router가 이에 대해 소유권을 주장하지 않는 다음 제3자 오브젝트 스토리지 호스트를 추가로 허용합니다: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` 및 `s3..amazonaws.com`, 경로 스타일 또는 `.` 접두사 형식 모두), Azure Blob Storage (`.blob.core.windows.net`) 및 Alibaba Cloud OSS (`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함). 이들은 특히 오브젝트 스토리지 엔드포인트입니다: 같은 공급자 도메인의 범용 엔드포인트, 예를 들어 Alibaba Function Compute 트리거는 목록에 없으며 거부됩니다. -일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 해당 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아니며, 호출자가 합리적으로 각각에 도달할 수 있는 세 가지 유사 사례를 분명히 언급할 가치가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다: Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보냅니다. 그러나 사용자 지정 도메인은 호스트 이름에 R2임을 식별하는 정보가 없으므로 Router는 이를 다른 호스트와 구분할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트에 presign하거나 `pub-.r2.dev` 형식을 사용하십시오. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하십시오. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 허용되지 않습니다. `.blob.core.windows.net`을 사용하십시오. 돌려받는 거부 메시지에는 이와 동일한 형식이 명시되므로 이를 읽기 위해 여기로 올 필요는 없습니다. -`` 및 `pub-` 자리 표시자는 일반적으로 도착하게 될 형태를 보여 줍니다. 이는 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사에서 이루어지므로, 같은 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그로 인해 확장되지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. -아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 포함되어 있는데, 여기서는 의도적으로 생략했습니다. 게시된 예시는 명세에 영구히 남고, 실제 서명은 유출된 자격 증명이자 작동이 중단되는 링크이기 때문입니다. -각 이미지는 25 MiB로 제한되며, 한 요청의 이미지들은 총 64 MiB로 제한됩니다. 유일한 예외는 `image`를 보내는 호출이면서 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit입니다. 여기서는 각 이미지가 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀까지 가능하고, 한 요청의 이미지들은 총 128 MiB까지 가능합니다. +일치되는 대상은 공급자가 아니라 호스트 이름 형태입니다. 따라서 위에서 공급자를 지정했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아니며, 호출자가 각각을 합리적으로 사용할 수 있는 세 가지 유사 사례를 분명히 밝혀 둘 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보냅니다. 그러나 사용자 지정 도메인은 호스트 이름에 R2임을 식별할 수 있는 어떤 것도 담고 있지 않으므로 Router는 다른 호스트와 구별할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 미리 서명하거나 `pub-.r2.dev` 형태를 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 돌려받는 거부 메시지에 바로 이 형태들이 명시되므로, 이를 읽기 위해 이 문서를 찾아올 필요는 없습니다. +위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형태를 보여 줄 뿐, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 하므로 같은 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그것으로 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. +아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 포함되는데, 게시된 예시는 스펙에 영구히 남고 실제 서명은 유출된 자격 증명이자 작동이 중단되는 링크이기 때문에 여기서는 의도적으로 생략했습니다. +각 이미지는 25 MiB로 제한되며, 한 요청의 이미지 총합은 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 보내는 호출)로, 여기서는 각 이미지가 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀, 한 요청의 이미지 총합이 최대 128 MiB까지 가능합니다. + - 실행할 gpt-image 모델입니다. Router가 주소 지정된 모델 id를 끼워 넣으므로, /v2/models/openai/gpt-image-2를 주소로 지정하는 호출자는 이 값을 보내지 않습니다. + 실행할 gpt-image 모델입니다. Router가 주소 지정된 모델 id를 삽입하므로, /v2/models/openai/gpt-image-2.6-flare로 주소를 지정하는 호출자는 이 값을 보내지 않습니다. @@ -191,52 +205,52 @@ URL은 자격 증명 없이 접근할 수 있어야 합니다. Router는 이를 - 생성할 이미지 수입니다(1-10). + 생성할 이미지 수(1-10)입니다. GIF 요청(`output_format` 참조)은 1이 아닌 모든 값을 거부합니다. OpenAI 자체 설명에서는 GIF 요청의 `n`을 "애니메이션 수"라고 부르는데, Router는 v1에서 이에 대한 가격을 책정하지 않습니다. - 범위: `1`부터 `10`까지 + 범위: `1` ~ `10` - JPEG 또는 WebP의 압축 수준입니다(0-100). + JPEG 또는 WebP의 압축 수준(0-100)입니다. GIF 요청에서는 거부됩니다. OpenAI는 애니메이션 출력에 대한 압축 수준을 허용하지 않습니다. - 범위: `0`부터 `100`까지 + 범위: `0` ~ `100` - 출력 이미지의 형식입니다. + 출력 이미지의 형식입니다. `gif`는 추가로 `mask`, 1이 아닌 `n`, 생략되었거나 `auto`이거나 잘못된 형식의 `size`, `stream: true`, 0보다 큰 `partial_images`, `output_compression`을 거부하며(각 필드의 설명 참조), Comfy가 이 환경에서 이를 활성화하지 않은 경우에는 아예 거부됩니다. - 가능한 값: `png`, `webp`, `jpeg` + 가능한 값: `png`, `webp`, `jpeg`, `gif` - 라이브 스트림과 함께 사용할 때만 의미가 있지만, 이 API에서는 라이브 스트림을 제공할 수 없습니다. `stream`은 보내더라도 `false`로 확정됩니다. 생성 요청에서는 요청이 `stream: true`를 함께 보내는지와 관계없이 `0` 또는 `null` 이외의 값은 400과 함께 거부됩니다. `image`를 포함한 요청에서는 이 필드가 전달되지 않고 삭제됩니다. 이 필드는 생략하세요. + 라이브 스트림과 함께일 때만 의미가 있는데, 이 API 표면은 OpenAIImageRouterRequest에서와 마찬가지로 라이브 스트림을 제공할 수 없습니다. 해당 필드의 설명을 참조하세요. GIF 요청에서는 `stream: true`와 같은 이유로 0보다 큰 값이 거부되며, 0은 허용됩니다. - 범위: `0`부터 `3`까지 + 범위: `0` ~ `3` - 생성할 이미지에 대한 텍스트 설명 또는 `image`에 적용할 편집에 대한 설명입니다. + 생성할 이미지 또는 `image`에 적용할 편집 내용에 대한 텍스트 설명입니다. - 생성되거나 편집된 이미지의 품질입니다. `xhigh`와 `max`는 gpt-image-2.5-flare와 gpt-image-2.5-sunburst가 추가된 두 등급입니다. `standard`와 `hd`는 허용된 모델이 인식하지 않는 dall-e 시대의 표기입니다. + 생성되거나 편집된 이미지의 품질입니다. `xhigh`와 `max`는 gpt-image-2.5-flare와 gpt-image-2.5-sunburst가 추가된 두 등급이며, `standard`와 `hd`는 허용된 어떤 모델도 읽지 않는 dall-e 시대의 표기입니다. 가능한 값: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` - 이미지 크기입니다(예: 1024x1024, 1536x1024, auto). + 이미지 크기(예: 1024x1024, 1536x1024, auto)입니다. GIF 요청(`output_format` 참조)은 `auto`를 거부하고 이 필드를 생략하는 것도 거부합니다. 명시적인 크기가 있어야 사전 견적과 64 MiB 결과 상한이, 이 값들을 배로 늘리는 프레임 수보다 앞선 단계에서 유한하게 유지되기 때문입니다. - 이 필드는 보내는 호출자가 거부되지 않도록 선언되어 있지만, 이 API에서는 아무 효과가 없습니다. Router는 디스패치 전에 이 값을 `false`로 확정합니다. Router가 `text/event-stream`을 중계하는 대신 공급자 응답을 캡처하기 때문입니다(`image`를 포함한 요청에서는 편집이 이 필드 없이 다시 인코딩되므로 대신 이 필드를 삭제합니다). 어떤 Comfy 인터페이스도 gpt-image 부분 이미지 스트리밍을 제공하지 않습니다. v1 `POST /proxy/openai/images/generations` 인그레스는 `stream: true`를 400으로 거부하고 요청을 업스트림으로 전혀 전달하지 않습니다. 따라서 이 필드를 생략하고 완료된 응답을 하나의 JSON 본문으로 읽으세요. 스트림이 열리지 않으므로 `stream: true`와 1보다 큰 `n`을 함께 사용하는 것에 대한 OpenAI의 제한은 여기에 적용되지 않습니다. `n`은 보낸 그대로 전달됩니다. + 이 값을 보내는 호출자가 거부되지 않도록 선언되어 있지만, OpenAIImageRouterRequest에서와 마찬가지로 이 API 표면에서는 아무 효과가 없습니다. 해당 필드의 설명을 참조하세요. GIF 요청에서는 `true`가 거부되며(OpenAI 가이드에 GIF 출력은 스트리밍을 지원하지 않는다고 명시되어 있음), `false`는 허용됩니다. 최종 사용자 모니터링을 위한 고유 식별자입니다. -`GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. +`GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 @@ -297,17 +311,17 @@ URL은 자격 증명 없이 접근할 수 있어야 합니다. Router는 이를 - 생성된 이미지의 배경이 `opaque`인지 `transparent`인지로, OpenAI가 이번 생성에서 확정한 값입니다. 요청 파라미터의 기본값은 `auto`이므로, 값을 고정하지 않은 호출자는 여기에서 어떤 배경이 생성되었는지 확인할 수 있습니다. + 생성된 이미지의 배경이 `opaque`인지 `transparent`인지를 OpenAI가 이번 생성에서 확정한 값입니다. 요청 파라미터의 기본값은 `auto`이므로, 값을 고정하지 않은 호출자는 여기에서 어떤 배경이 생성되었는지 확인할 수 있습니다. - 생성이 완료된 시각을 나타내는 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언한 유일한 멤버이므로, OpenAI가 생성 주체일 때는 항상 존재합니다. alt 기반 id 중 fal-, pika-, wavespeed-, runware-가 처리한 응답에서는 다른 네 개의 확정된 파라미터 멤버와 마찬가지로 이 필드가 완전히 생략됩니다. 현재의 epoch 값이 2^31에 충분히 가까워서, `integer`로 서식 없이 선언하면 많은 SDK 생성기에서 32비트 필드가 만들어지기 때문에 `int64`로 선언되었습니다. + 생성이 완료된 시각을 나타내는 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언한 유일한 멤버이므로, OpenAI가 생성 주체일 때는 항상 존재합니다. alt 기반 id 중 fal-, pika-, wavespeed-, runware-가 처리한 응답에서는 다른 네 개의 확정된 파라미터 멤버와 마찬가지로 이 필드가 완전히 생략됩니다. 현재의 epoch 값이 2^31에 충분히 가까워서, 서식을 지정하지 않은 `integer`로 선언하면 많은 SDK 생성기에서 32비트 필드가 만들어지기 때문에 `int64`로 선언되었습니다. 형식: `int64` - `data[].b64_json`에 담긴 바이트의 인코딩으로, `png`, `webp`, `jpeg` 중 하나입니다. 요청에 `output_format`이 전송되었으면 그 값이고 전송되지 않았으면 `png`인, OpenAI가 실제로 인코딩한 형식입니다. 따라서 디코더는 요청에서 형식을 다시 추론하지 않고 이 값을 기준으로 처리할 수 있습니다. + `data[].b64_json`에 담긴 바이트의 인코딩으로, `png`, `webp`, `jpeg` 중 하나입니다. OpenAI가 실제로 인코딩한 형식이며, 요청에 `output_format`이 전송되었으면 그 값이고 전송되지 않았으면 `png`입니다. 따라서 디코더는 요청에서 형식을 다시 추론하지 않고 이 값을 기준으로 처리할 수 있습니다. diff --git a/ko/development/comfy-router/models/pixverse/v3-5/code.mdx b/ko/development/comfy-router/models/pixverse/v3-5/code.mdx new file mode 100644 index 0000000000..ab9b1ac257 --- /dev/null +++ b/ko/development/comfy-router/models/pixverse/v3-5/code.mdx @@ -0,0 +1,309 @@ +--- +title: "Comfy Router에서 V3.5 사용하기" +description: "Comfy Router를 통해 pixverse/v3.5를 호출합니다: 엔드포인트, 요청 형태 및 Router가 반환하는 응답입니다." +sidebarTitle: "V3.5" +translationSourceHash: c6a6b3a8 +translationFrom: development/comfy-router/models/pixverse/v3-5/code.mdx +translationBlockHashes: + "_intro": 2772d5c1 + "Quick start": dc3a1030 + "Schema": 48bf7abc + "Examples": 0600cc10 +--- +{/* 생성됨 파일. `pnpm code-pages:gen`에 의해 router-schemas/pixverse/v3.5.json에서 생성되었습니다. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`pixverse/v3.5`의 API 레퍼런스로, Pixverse에서 Comfy Router를 통해 제공됩니다. + +**입력:** 텍스트 · **출력:** 비디오 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 이를 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 보낸 것입니다. + +**모델 ID:** `pixverse/v3.5` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/pixverse/v3.5` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "pixverse/v3.5", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("pixverse/v3.5", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v3.5 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/pixverse/v3.5/requests`로 보냅니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비가 되면 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v3.5", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 것은 이것뿐입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자 자체의 페이로드이며, models.run()이 반환하는 것과 같은 값입니다. + # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("pixverse/v3.5", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 제출. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/pixverse/v3.5/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v3.5/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집. 완료되면 모델의 네이티브 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202. +curl https://api.comfy.org/v2/models/pixverse/v3.5/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` + + + + 범위: `1`~`15` + + + + + + + + PixVerse 텍스트 기반 비디오 생성 모델 식별자입니다. Comfy Router 경로 `POST /v2/models/pixverse/{model}`에서는 이 필드가 경로에서 제공되므로 생략할 수 있습니다. + + + + 가능한 값: `normal`, `fast` + + + + + + + + + + + + 가능한 값: `360p`, `540p`, `720p`, `1080p` + + + + + + + + 가능한 값: `anime`, `3d_animation`, `clay`, `comic`, `cyberpunk` + + + + + + + + + + +Router가 `GET /v2/models/pixverse/v3.5/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. + +### 출력 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 가능한 값: `1`, `5`, `6`, `7`, `8` + + + + + + + + + + +## 예제 + +### 입력 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 출력 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + + diff --git a/ko/development/comfy-router/models/pixverse/v6-max/code.mdx b/ko/development/comfy-router/models/pixverse/v6-max/code.mdx new file mode 100644 index 0000000000..7ff464ebd1 --- /dev/null +++ b/ko/development/comfy-router/models/pixverse/v6-max/code.mdx @@ -0,0 +1,308 @@ +--- +title: "Comfy Router에서 V6 Max 사용하기" +description: "Comfy Router를 통해 pixverse/v6-max 호출: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." +sidebarTitle: "V6 Max" +translationSourceHash: fe910720 +translationFrom: development/comfy-router/models/pixverse/v6-max/code.mdx +translationBlockHashes: + "_intro": 79517cb6 + "Quick start": 3197f978 + "Schema": 982f249f + "Examples": 0600cc10 +--- +{/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/pixverse/v6-max.json에서 생성됨. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +Pixverse에서 Comfy Router를 통해 제공하는 `pixverse/v6-max`의 API 레퍼런스입니다. + +**입력:** 텍스트 · **출력:** 비디오 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python과 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다. + +**모델 ID:** `pixverse/v6-max` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/pixverse/v6-max` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경 변수에서 COMFY_API_KEY를 읽습니다. +# SDK는 멱등성 키를 자동으로 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "pixverse/v6-max", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경 변수에서 COMFY_API_KEY를 읽습니다. +// SDK는 멱등성 키를 자동으로 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("pixverse/v6-max", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v6-max \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/pixverse/v6-max/requests`로 전송합니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비되었을 때 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 방법을 단계별로 설명합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경 변수에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v6-max", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 서버가 지정한 Retry-After만큼 기다리며 요청이 완료될 때까지 폴링합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자의 원본 페이로드이며, models.run()이 반환하는 것과 같은 값입니다. + # 실패하거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경 변수에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("pixverse/v6-max", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/pixverse/v6-max/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 기다립니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v6-max/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 모델의 원본 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202를 반환합니다. +curl https://api.comfy.org/v2/models/pixverse/v6-max/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` + + + + 범위: `1`부터 `15`까지 + + + + + + + + PixVerse 텍스트 기반 비디오 생성 모델 식별자입니다. Comfy Router 경로 `POST /v2/models/pixverse/{model}`에서는 이 필드가 경로에서 제공되므로 생략할 수 있습니다. + + + + 가능한 값: `normal`, `fast` + + + + + + + + + + + + 가능한 값: `360p`, `540p`, `720p`, `1080p` + + + + + + + + 가능한 값: `anime`, `3d_animation`, `clay`, `comic`, `cyberpunk` + + + + + + + + + + +`GET /v2/models/pixverse/v6-max/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 기준으로 사용하는 동일한 문서입니다. + +### 출력 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 가능한 값: `1`, `5`, `6`, `7`, `8` + + + + + + + + + + +## 예시 + +### 입력 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 출력 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + diff --git a/ko/development/comfy-router/models/pixverse/v6/code.mdx b/ko/development/comfy-router/models/pixverse/v6/code.mdx new file mode 100644 index 0000000000..22db70b285 --- /dev/null +++ b/ko/development/comfy-router/models/pixverse/v6/code.mdx @@ -0,0 +1,309 @@ +--- +title: "Comfy Router로 V6 사용하기" +description: "Comfy Router를 통해 pixverse/v6를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." +sidebarTitle: "V6" +translationSourceHash: a19e855d +translationFrom: development/comfy-router/models/pixverse/v6/code.mdx +translationBlockHashes: + "_intro": f933db97 + "Quick start": cbf8e767 + "Schema": f1b3a5fb + "Examples": 0600cc10 +--- +{/* GENERATED FILE. Generated from router-schemas/pixverse/v6.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`pixverse/v6`의 API 레퍼런스로, Pixverse에서 Comfy Router가 제공합니다. + +**입력:** 텍스트 · **출력:** 비디오 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 보낸 것입니다. + +**모델 ID:** `pixverse/v6` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/pixverse/v6` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "pixverse/v6", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("pixverse/v6", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v6 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/pixverse/v6/requests`로 보냅니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비가 되면 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v6", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 기다립니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자의 자체 페이로드이며, models.run()이 반환하는 것과 같은 값입니다. + # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("pixverse/v6", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/pixverse/v6/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 기다립니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v6/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집합니다. 아직 실행 중이면 상태 본문과 함께 202, 완료되면 모델의 원본 출력과 함께 200입니다. +curl https://api.comfy.org/v2/models/pixverse/v6/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` + + + + 범위: `1` ~ `15` + + + + + + + + PixVerse 텍스트 기반 비디오 생성 모델 식별자입니다. Comfy Router 경로 `POST /v2/models/pixverse/{model}`에서는 이 필드가 경로에서 제공되므로 생략할 수 있습니다. + + + + 가능한 값: `normal`, `fast` + + + + + + + + + + + + 가능한 값: `360p`, `540p`, `720p`, `1080p` + + + + + + + + 가능한 값: `anime`, `3d_animation`, `clay`, `comic`, `cyberpunk` + + + + + + + + + + +Router가 `GET /v2/models/pixverse/v6/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 요청이 공급자에 도달하기 이전에 호출을 검증하는 데에도 동일한 문서가 사용됩니다. + +### 출력 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 가능한 값: `1`, `5`, `6`, `7`, `8` + + + + + + + + + + +## 예제 + +### 입력 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 출력 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + + diff --git a/ko/development/comfy-router/models/pruna/p-video-2/code.mdx b/ko/development/comfy-router/models/pruna/p-video-2/code.mdx index 9b0253932e..4da961c416 100644 --- a/ko/development/comfy-router/models/pruna/p-video-2/code.mdx +++ b/ko/development/comfy-router/models/pruna/p-video-2/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 P Video 2 사용하기" description: "Comfy Router를 통해 pruna/p-video-2를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "P Video 2" -translationSourceHash: adc4bb77 +translationSourceHash: b7aa4ce2 translationFrom: development/comfy-router/models/pruna/p-video-2/code.mdx translationBlockHashes: "_intro": 7b513d6b "Quick start": 9d47988e - "Schema": 51d0cc63 + "Schema": 4bd9bf87 "Examples": 0d85c9fe --- + {/* 생성된 파일. `pnpm code-pages:gen`이 router-schemas/pruna/p-video-2.json에서 생성했습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -245,6 +246,34 @@ Router가 `GET /v2/models/pruna/p-video-2/openapi.json`에서 제공하는 스 사람이 읽을 수 있는 진행 상황 메시지입니다. + + Pruna의 안전 검사기 판정입니다. 콘텐츠 검열로 인해 예측이 차단된 경우 실패 상태에서 표시됩니다. + + + + 안전 검사기가 예측을 차단했는지 여부입니다. + + + + 차단이 요청에서 비활성화할 수 있는 안전 필터로 인한 것인지 여부입니다. + + + + 차단을 유발한 콘텐츠 정책 카테고리입니다. 예: sexual. + + + + 차단에 대한 사람이 읽을 수 있는 요약입니다. + + + + 검사 대상: input(제출된 요청) 또는 output(생성된 비디오)입니다. + + + + 차단에 대한 사람이 읽을 수 있는 사유입니다. + + 예측 상태: starting, processing, succeeded, failed 또는 canceled입니다. diff --git a/ko/development/comfy-router/models/quiver/arrow-2-telos/code.mdx b/ko/development/comfy-router/models/quiver/arrow-2-telos/code.mdx new file mode 100644 index 0000000000..5c4eff5096 --- /dev/null +++ b/ko/development/comfy-router/models/quiver/arrow-2-telos/code.mdx @@ -0,0 +1,283 @@ +--- +title: "Comfy Router에서 Arrow 2 Telos 사용하기" +description: "Comfy Router를 통해 quiver/arrow-2-telos를 호출하는 방법을 설명합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답." +sidebarTitle: "Arrow 2 Telos" +translationSourceHash: 38ec271d +translationFrom: development/comfy-router/models/quiver/arrow-2-telos/code.mdx +translationBlockHashes: + "_intro": 7e87a52d + "Quick start": 63ad01e1 + "Schema": 76a21cd4 + "Examples": 36e915ba +--- +{/* 생성된 파일. `router-schemas/quiver/arrow-2-telos.json`에서 `pnpm code-pages:gen`으로 생성되었습니다. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +Quiver가 Comfy Router를 통해 제공하는 `quiver/arrow-2-telos`에 대한 API 레퍼런스입니다. + +**입력:** 텍스트, 이미지 · **출력:** 이미지 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 수행합니다. + +**모델 ID:** `quiver/arrow-2-telos` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/quiver/arrow-2-telos` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 idempotency key를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "quiver/arrow-2-telos", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 idempotency key를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("quiver/arrow-2-telos", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests`로 전송합니다. Router는 실행이 접수되는 즉시 `201`과 `request_id`로 응답하며, 결과는 준비되면 이 프로세스에서든 다른 프로세스에서든 수집할 수 있습니다. [대기 중 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 단계별로 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "quiver/arrow-2-telos", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 대기합니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자 자체의 페이로드로, models.run()이 반환하는 것과 동일한 값입니다. + # 실패했거나 취소된 요청은 여기서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("quiver/arrow-2-telos", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 제출. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 대기합니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집. 모델의 원본 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202를 반환합니다. +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 추가 스타일 또는 서식 가이드입니다. + + + + 최대 출력 토큰 수입니다. + + 범위: `1` ~ `131072` + + + + SVG 생성용 모델 식별자입니다. + + + + 생성할 SVG 수입니다. + + 범위: `1` ~ `16` + + + + 이전 출력에 이미 포함된 토큰에 대한 페널티입니다. `arrow-2-telos`에서는 무시됩니다. 이 모델은 샘플링 파라미터를 허용하지 않으므로, 요청이 전달되기 전에 해당 필드가 오류 없이 제거됩니다. + + 범위: `-2` ~ `2` + + + + 원하는 SVG 출력에 대한 텍스트 설명입니다. + + + + 스타일/구성을 가이드하기 위한 선택적 참조 이미지입니다. URL 객체, base64 객체 또는 URL 문자열 축약형을 허용합니다. 런타임 제한은 모델마다 다릅니다. + + + + 샘플링 온도입니다. `arrow-2-telos`에서는 무시됩니다. 이 모델은 샘플링 파라미터를 허용하지 않으므로, 요청이 전달되기 전에 해당 필드가 오류 없이 제거됩니다. + + 범위: `0` ~ `2` + + + + 누클리어스 샘플링 확률입니다. `arrow-2-telos`에서는 무시됩니다. 이 모델은 샘플링 파라미터를 허용하지 않으므로, 요청이 전달되기 전에 해당 필드가 오류 없이 제거됩니다. + + 범위: `0` ~ `1` + + +Router가 `GET /v2/models/quiver/arrow-2-telos/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. + +### 출력 + + + 생성 시각의 Unix 타임스탬프입니다. + + + + arrow-1.1과 같은 고정 크레딧 모델의 크레딧 비용입니다. usage에 측정된 토큰 합계를 보고하는 arrow-2와 같은 토큰 가격 책정 모델에서는 생략됩니다. + + 범위: `0` ~ `…` + + + + + + + + 출력의 MIME 유형입니다. + + 가능한 값: `image/svg+xml` + + + + 원시 SVG 마크업입니다. + + + + 생성에 대한 고유 식별자입니다. + + + + arrow-2와 같은 토큰 가격 책정 모델의 토큰 합계입니다. 고정 크레딧 모델은 여기에 0을 보고할 수 있습니다. + + + + 토큰 가격 책정 모델의 입력 토큰 수입니다. + + 범위: `0` ~ `…` + + + + 토큰 가격 책정 모델의 출력 토큰 수입니다. + + 범위: `0` ~ `…` + + + + 토큰 가격 책정 모델의 총 토큰 수입니다. + + 범위: `0` ~ `…` + + +## 예시 + +### 입력 + +```json +{ + "n": 1, + "prompt": "A single red maple leaf on a plain white background." +} +``` + +### 출력 + +```json +{ + "created": 1767225600, + "data": [ + { + "mime_type": "image/svg+xml", + "svg": "" + } + ], + "id": "svg_018f2c7a4b1e7c3d9a056e2f8b41d0c9", + "usage": { + "input_tokens": 180, + "output_tokens": 240, + "total_tokens": 420 + } +} +``` + + diff --git a/ko/development/comfy-router/models/quiver/arrow-2/code.mdx b/ko/development/comfy-router/models/quiver/arrow-2/code.mdx new file mode 100644 index 0000000000..467c747b60 --- /dev/null +++ b/ko/development/comfy-router/models/quiver/arrow-2/code.mdx @@ -0,0 +1,283 @@ +--- +title: "Comfy Router로 Arrow 2 사용하기" +description: "Comfy Router를 통해 quiver/arrow-2를 호출하는 방법: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." +sidebarTitle: "Arrow 2" +translationSourceHash: e78a6b9f +translationFrom: development/comfy-router/models/quiver/arrow-2/code.mdx +translationBlockHashes: + "_intro": ef6a6611 + "Quick start": c39331bc + "Schema": d3c8d579 + "Examples": 36e915ba +--- +{/* GENERATED FILE. Generated from router-schemas/quiver/arrow-2.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; + +`quiver/arrow-2`의 API 레퍼런스이며, Quiver에서 Comfy Router를 통해 제공됩니다. + +**입력:** 텍스트, 이미지 · **출력:** 이미지 + +## 빠른 시작 + +[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 원시 HTTP로 보낸 것입니다. + +**모델 ID:** `quiver/arrow-2` + +**엔드포인트:** `POST https://api.comfy.org/v2/models/quiver/arrow-2` + + + + +```python Python +from comfy_sdk import Comfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +with Comfy() as client: + result = client.models.run( + "quiver/arrow-2", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. +const { data } = await comfy.models.run("quiver/arrow-2", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/quiver/arrow-2 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" +``` + + + +동일한 본문을 `POST https://api.comfy.org/v2/models/quiver/arrow-2/requests`로 보냅니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`로 응답하며, 결과는 준비가 되면 이 프로세스 또는 다른 프로세스에서 수집합니다. [대기열 전달](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 안내합니다. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 환경에서 COMFY_API_KEY를 읽습니다. +# 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "quiver/arrow-2", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # 모델 ID와 함께면 다른 프로세스에 필요한 전부입니다 + + # 요청이 완료될 때까지 폴링하며, 서버가 지정한 Retry-After만큼 기다립니다. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 공급자 자체의 페이로드이며, models.run()이 반환하는 것과 동일한 값입니다. + # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 환경에서 COMFY_API_KEY를 읽습니다. +// 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. +const handle = await comfy.models.submit("quiver/arrow-2", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 제출. Router는 request_id, status_url, response_url, cancel_url과 함께 201로 응답합니다. +curl https://api.comfy.org/v2/models/quiver/arrow-2/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" + +# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 지정한 Retry-After 초만큼 기다립니다. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/quiver/arrow-2/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 수집. 모델의 기본 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202. +curl https://api.comfy.org/v2/models/quiver/arrow-2/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## 스키마 + +### 입력 + + + 추가적인 스타일 또는 서식 가이드 + + + + 최대 출력 토큰 수 + + 범위: `1` ~ `131072` + + + + SVG 생성을 위한 모델 식별자 + + + + 생성할 SVG 수 + + 범위: `1` ~ `16` + + + + 이전 출력에 이미 존재하는 토큰에 대한 페널티입니다. 샘플링 파라미터를 허용하지 않는 `arrow-2-telos`에서는 무시됩니다. 이 필드는 요청이 전달되기 전에 오류 없이 제거됩니다. + + 범위: `-2` ~ `2` + + + + 원하는 SVG 출력에 대한 텍스트 설명 + + + + 스타일이나 구도를 안내하는 선택적 참조 이미지입니다. URL 객체, base64 객체 또는 URL 문자열 축약형을 허용합니다. 런타임 제한은 모델마다 다릅니다. + + + + 샘플링 온도입니다. 샘플링 파라미터를 허용하지 않는 `arrow-2-telos`에서는 무시됩니다. 이 필드는 요청이 전달되기 전에 오류 없이 제거됩니다. + + 범위: `0` ~ `2` + + + + 누클리어스 샘플링 확률입니다. 샘플링 파라미터를 허용하지 않는 `arrow-2-telos`에서는 무시됩니다. 이 필드는 요청이 전달되기 전에 오류 없이 제거됩니다. + + 범위: `0` ~ `1` + + +Router가 `GET /v2/models/quiver/arrow-2/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. + +### 출력 + + + 생성 시각의 Unix 타임스탬프 + + + + arrow-1.1과 같은 고정 크레딧 모델의 크레딧 비용입니다. arrow-2와 같이 토큰 기반으로 가격이 책정된 모델에서는 생략되며, 대신 usage에 측정된 토큰 총계를 보고합니다. + + 범위: `0` ~ `…` + + + + + + + + 출력의 MIME 타입 + + 가능한 값: `image/svg+xml` + + + + 원시 SVG 마크업 + + + + 생성에 대한 고유 식별자 + + + + arrow-2와 같이 토큰 기반으로 가격이 책정된 모델의 토큰 총계입니다. 고정 크레딧 모델은 여기에 0을 보고할 수 있습니다. + + + + 토큰 기반 가격 모델의 입력 토큰 수입니다. + + 범위: `0` ~ `…` + + + + 토큰 기반 가격 모델의 출력 토큰 수입니다. + + 범위: `0` ~ `…` + + + + 토큰 기반 가격 모델의 총 토큰 수입니다. + + 범위: `0` ~ `…` + + +## 예제 + +### 입력 + +```json +{ + "n": 1, + "prompt": "A single red maple leaf on a plain white background." +} +``` + +### 출력 + +```json +{ + "created": 1767225600, + "data": [ + { + "mime_type": "image/svg+xml", + "svg": "" + } + ], + "id": "svg_018f2c7a4b1e7c3d9a056e2f8b41d0c9", + "usage": { + "input_tokens": 180, + "output_tokens": 240, + "total_tokens": 420 + } +} +``` + + diff --git a/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx b/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx index 6b5e73b949..e884cc0a18 100644 --- a/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx +++ b/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Veo 3.1 Fast Generate 001 사용하기" description: "Comfy Router를 통해 veo/veo-3.1-fast-generate-001을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Veo 3.1 Fast Generate 001" -translationSourceHash: f5553980 +translationSourceHash: 436f69a6 translationFrom: development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx translationBlockHashes: "_intro": 2dd8ad2f "Quick start": 4f13f7f7 - "Schema": e44aea6d + "Schema": 2b639366 "Examples": 88e27039 --- + {/* 생성된 파일. `pnpm code-pages:gen`으로 router-schemas/veo/veo-3.1-fast-generate-001.json에서 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -336,26 +337,26 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ 생성된 비디오의 목표 재생 시간(초)입니다. Veo 2: 5-8. Veo 3/3.1: 4, 6 또는 8. 기본값: 8 - - 더 높은 품질을 위해 프롬프트를 자동으로 개선합니다. 기본값은 참입니다. + 더 높은 품질을 위해 프롬프트를 자동으로 개선합니다. 기본값은 true입니다. - 생성된 비디오의 프레임 레이트(초당 프레임 수) + 생성된 비디오의 프레임 레이트(초당 프레임 수)입니다. - 비디오와 함께 오디오를 생성할지 여부입니다. 기본값은 참입니다. Veo 3.0+ 모델에서 지원됩니다. + 비디오와 함께 오디오를 생성할지 여부입니다. 기본값은 true입니다. Veo 3.0+ 모델에서 지원됩니다. - 생성된 비디오에서 피하고자 하는 내용을 설명하는 텍스트입니다. + 생성된 비디오에서 피해야 할 내용을 설명하는 텍스트입니다. - 생성된 비디오에 등장하는 사람을 제어합니다. 기본값: allow_adult + 생성된 비디오에 등장하는 사람을 제어합니다. 기본값: allow_adult. +`ALLOW`와 `BLOCK`도 허용되는데, Veo2GenVidRequest의 personGeneration enum이 이 두 값을 포함하는 것과 같은 호환성 이유 때문입니다(해당 컴포넌트의 참고 사항을 보세요). ComfyUI의 Veo 3 파트너 노드(comfy_api_nodes/nodes_veo2.py)는 veo-3.1-generate-001, veo-3.1-fast-generate-001, veo-3.1-lite-generate-001에 대해 `/proxy/veo/{model}/generate`로 이 두 표기 중 하나를 항상 보내며, Vertex 자체의 표기는 절대 보내지 않습니다. 이 세 ID가 바로 이 컴포넌트가 Router 입력 스키마로 삼는 대상입니다. 해당 ID 중 하나에 대한 Router 디스패치(`model_provider=veo`)에서, 동기 호출이든 대기 중인 호출이든(`/v2/models/veo/{model}/requests`), 요청이 Vertex에 도달하기 이전에 `ALLOW`는 `allow_adult`로, `BLOCK`은 `dont_allow`로 매핑됩니다(routerVeoMapPersonGeneration, server/middleware/router_veo_person_generation.go). Vertex 자체는 두 표기를 모두 허용하지 않기 때문입니다. v1 `/proxy/veo/:modelId/generate`를 직접 호출하는 경우에는 어느 쪽이든 영향을 받지 않습니다. comfy-api는 `/proxy/*`에 요청 검증기를 설치하지 않으므로 이 enum은 그곳에서 이미 강제되지 않는 문서였고, Router 전용 매핑도 이 경우에는 실행되지 않습니다. - 가능한 값: `dont_allow`, `allow_adult`, `allowAll` + 가능한 값: `dont_allow`, `allow_adult`, `allowAll`, `ALLOW`, `BLOCK` @@ -377,7 +378,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ 생성할 비디오 수입니다. 지정하지 않으면 비디오 1개가 생성됩니다. - Range: `1` to `4` + 범위: `1`부터 `4`까지 diff --git a/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx b/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx index bee90086fe..e5b87df636 100644 --- a/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx +++ b/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 Veo 3.1 Generate 001 사용하기" description: "Comfy Router를 통해 veo/veo-3.1-generate-001을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Veo 3.1 Generate 001" -translationSourceHash: 0fab4eef +translationSourceHash: 9721a315 translationFrom: development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx translationBlockHashes: "_intro": cba04c2d "Quick start": cd500ec3 - "Schema": 5618a5b3 + "Schema": afe36175 "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -204,7 +205,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 이미지의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성이 사용자를 위해 기록한 비디오인 경우는 예외입니다. + 이미지의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성 작업이 사용자를 위해 기록한 비디오인 경우는 예외입니다. @@ -224,7 +225,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 이미지의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성이 사용자를 위해 기록한 비디오인 경우는 예외입니다. + 이미지의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성 작업이 사용자를 위해 기록한 비디오인 경우는 예외입니다. @@ -244,7 +245,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 마스크 파일의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성이 사용자를 위해 기록한 비디오인 경우는 예외입니다. + 마스크 파일의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성 작업이 사용자를 위해 기록한 비디오인 경우는 예외입니다. @@ -276,7 +277,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 이미지의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성이 사용자를 위해 기록한 비디오인 경우는 예외입니다. + 이미지의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성 작업이 사용자를 위해 기록한 비디오인 경우는 예외입니다. @@ -296,7 +297,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 비디오 확장 또는 편집을 위한 선택적 입력 비디오. image 및 referenceImages와 호환되지 않습니다. + 비디오 확장 또는 편집을 위한 선택적 입력 비디오. image 및 referenceImages와 함께 사용할 수 없습니다. @@ -306,7 +307,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 입력 비디오의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성이 사용자를 위해 기록한 비디오인 경우는 예외입니다. + 입력 비디오의 Cloud Storage URI. BYOK가 아닌 요청에서는 Comfy 소유 버킷을 가리키는 `gs://` URI(또는 그 `https://storage.googleapis.com` 형식)가 400으로 거부됩니다. 단, 해당 객체가 자신의 `POST /customers/storage` 접두사 아래에 있거나 이전 Veo 생성 작업이 사용자를 위해 기록한 비디오인 경우는 예외입니다. @@ -336,15 +337,15 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 더 높은 품질을 위해 프롬프트를 자동으로 개선합니다. 기본값은 true입니다. + 더 높은 품질을 위해 프롬프트를 자동으로 개선합니다. 기본값: true. - 생성된 비디오의 프레임 레이트(초당 프레임 수) + 생성된 비디오의 프레임 속도(초당 프레임 수) - 비디오와 함께 오디오를 생성할지 여부입니다. 기본값은 true입니다. Veo 3.0+ 모델에서 지원됩니다. + 비디오와 함께 오디오를 생성할지 여부입니다. 기본값: true. Veo 3.0+ 모델에서 지원됩니다. @@ -352,13 +353,14 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 생성된 비디오의 인물을 제어합니다. 기본값: allow_adult + 생성된 비디오에 등장하는 사람을 제어합니다. 기본값: allow_adult. +`ALLOW`와 `BLOCK`도 허용됩니다. 이는 Veo2GenVidRequest의 personGeneration 열거형이 이 값들을 포함하는 것과 동일한 호환성 이유입니다(해당 컴포넌트의 참고 사항 참조). ComfyUI의 Veo 3 파트너 노드(comfy_api_nodes/nodes_veo2.py)는 veo-3.1-generate-001, veo-3.1-fast-generate-001, veo-3.1-lite-generate-001에 대해 `/proxy/veo/{model}/generate`로 이 두 표기 중 하나를 항상 전송하며, Vertex 자체의 표기는 절대 전송하지 않습니다. 이 세 ID가 바로 이 컴포넌트가 Router 입력 스키마를 제공하는 대상입니다. 해당 ID 중 하나에 대한 Router 디스패치(`model_provider=veo`)에서 동기 호출이든 대기 중 제출이든(`/v2/models/veo/{model}/requests`)인 경우, `ALLOW`는 `allow_adult`로, `BLOCK`은 `dont_allow`로 매핑되어 요청이 Vertex에 도달하기 전에 적용됩니다(routerVeoMapPersonGeneration, server/middleware/router_veo_person_generation.go). Vertex 자체는 두 표기 중 어느 것도 허용하지 않기 때문입니다. 직접 v1 `/proxy/veo/:modelId/generate`를 호출하는 쪽은 어느 경우에도 영향을 받지 않습니다. comfy-api는 `/proxy/*`에 요청 검증기를 설치하지 않으므로 이 열거형은 이미 그곳에서 강제되지 않는 문서였고, Router 전용 매핑은 그 호출에 대해 실행되지 않습니다. - 가능한 값: `dont_allow`, `allow_adult`, `allowAll` + 가능한 값: `dont_allow`, `allow_adult`, `allowAll`, `ALLOW`, `BLOCK` - 진행 상황 업데이트를 위한 Cloud Pub/Sub 주제입니다 (projects/\{project}/topics/\{topic}). Comfy 자격 증명(non-BYOK) 요청에서는 허용되지 않습니다. 이 값이 포함되어 있으면 generate 라우트가 400을 반환합니다. 작업이 Comfy 프로젝트에서 실행되고 Vertex가 Comfy의 서비스 에이전트로 게시하기 때문입니다. bring-your-own-key 요청에서만 허용되며, 이 경우 Vertex는 자신의 프로젝트에서 주제 권한을 평가합니다. + 진행 상황 업데이트를 위한 Cloud Pub/Sub 주제입니다(projects/\{project}/topics/\{topic}). Comfy 자격 증명(non-BYOK) 요청에서는 허용되지 않습니다. 이 값이 있으면 generate 라우트가 400으로 응답합니다. 작업이 Comfy 프로젝트에서 실행되고 Vertex가 Comfy의 서비스 에이전트로 게시되기 때문입니다. bring-your-own-key 요청에서만 허용되며, 이 경우 Vertex는 사용자의 프로젝트에서 주제 권한을 평가합니다. @@ -387,7 +389,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ 생성된 비디오를 저장할 선택적 Cloud Storage 대상 위치이며 `gs://` URI입니다. -반드시 자신의 버킷을 지정해야 합니다. bring-your-own-key가 아니면 이 라우트는 사용자의 자격 증명이 아니라 Comfy 자체의 Google Cloud 자격 증명으로 실행되므로, Comfy 소유 버킷 안의 대상 위치는 Comfy 서비스 계정이 공유 레이아웃에 수행하고 Comfy 프로젝트에 청구되는 쓰기가 됩니다. 그런 값을 지정한 요청은 400으로 거부되고 아무것도 생성되지 않습니다. 예외는 하나뿐이며, 플랫폼 스토리지가 활성화된 동기 Comfy Router 호출(`POST /v2/models/{provider}/{model}`)입니다. 이 경우 Router 자체의 Veo 또는 Gemini 에셋 버킷을 가리키는 값은 해당 호출을 위해 Router가 사용자의 플랫폼 접두사 아래에서 발급하는 대상 위치로 대체되며, Router가 발급한 바로 그 대상 위치만 통과합니다. 큐에 넣은 Router 제출(`POST /v2/models/{provider}/{model}/requests`)은 그러한 대체를 하지 않으므로 다른 Comfy 소유 버킷과 마찬가지로 그 값을 400으로 거부합니다. 그 밖의 대상 위치는 변경 없이 Vertex로 전달되며 액세스 권한 부여는 사용자 몫입니다. bring-your-own-key 호출은 자신의 프로젝트에서 실행되며 전송된 그대로 전달됩니다. +반드시 본인의 버킷을 지정해야 합니다. bring-your-own-key가 아니면 이 라우트는 사용자의 자격 증명이 아니라 Comfy 자체의 Google Cloud 자격 증명으로 실행되므로, Comfy 소유 버킷 안의 대상 위치는 Comfy 서비스 계정이 공유 레이아웃으로 수행하며 Comfy 프로젝트에 청구하는 쓰기가 됩니다. 그런 값을 지정한 요청은 400으로 거부되고 아무것도 생성되지 않습니다. 예외가 하나 있습니다. 플랫폼 스토리지가 활성화된 동기 Comfy Router 호출(`POST /v2/models/{provider}/{model}`)에서는 Router 자체의 Veo 또는 Gemini 에셋 버킷을 가리키는 값이 해당 호출을 위해 Router가 사용자의 플랫폼 접두사 아래에서 발급하는 대상 위치로 대체되며(Router Veo 라우트 참조), Router가 발급한 바로 그 대상 위치만 통과합니다. 대기 중인 Router 제출(`POST /v2/models/{provider}/{model}/requests`)은 그러한 대체를 하지 않으므로 다른 Comfy 소유 버킷과 마찬가지로 그 값을 400으로 거부합니다. 그 밖의 대상 위치는 변경 없이 Vertex로 전달되며 액세스 권한 부여는 사용자 몫입니다. bring-your-own-key 호출은 사용자의 프로젝트에서 실행되며 전송된 그대로 전달됩니다. @@ -396,7 +398,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ 가능한 값: `textToVideo`, `imageToVideo`, `referenceToVideo`, `edit`, `extend`, `upscale` -Router가 `GET /v2/models/veo/veo-3.1-generate-001/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에게 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/veo/veo-3.1-generate-001/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 diff --git a/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx b/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx index bbbd73fc7f..46fdee14e6 100644 --- a/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx +++ b/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx @@ -2,17 +2,18 @@ title: "Comfy Router로 Veo 3.1 Lite Generate 001 사용하기" description: "Comfy Router를 통해 veo/veo-3.1-lite-generate-001을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Veo 3.1 Lite Generate 001" -translationSourceHash: 6526c1c6 +translationSourceHash: 8ad7346c translationFrom: development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx translationBlockHashes: "_intro": 8110da35 "Quick start": 7f826038 - "Schema": 647d02c5 + "Schema": 25c8331a "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-lite-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -337,11 +338,11 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 더 높은 품질을 위해 프롬프트를 자동으로 개선합니다. 기본값: true. +품질 향상을 위해 프롬프트를 자동으로 개선합니다. 기본값: true. - 생성된 비디오의 프레임 레이트(초당 프레임 수)입니다. + 생성된 비디오의 초당 프레임 수입니다. @@ -353,13 +354,14 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 생성된 비디오에 등장하는 사람을 제어합니다. 기본: allow_adult + 생성된 비디오에 등장하는 사람을 제어합니다. 기본: allow_adult. +`ALLOW`와 `BLOCK`도 허용됩니다. 이는 Veo2GenVidRequest의 personGeneration 열거형이 이들을 포함하는 것과 같은 호환성 이유입니다(해당 컴포넌트의 참고 사항 참조). ComfyUI의 Veo 3 파트너 노드(comfy_api_nodes/nodes_veo2.py)는 이 컴포넌트가 Router 입력 스키마인 세 가지 ID(veo-3.1-generate-001, veo-3.1-fast-generate-001, veo-3.1-lite-generate-001)에 대해 `/proxy/veo/{model}/generate`로 항상 이 두 표기 중 하나를 전송하며, Vertex 자체의 표기는 절대 전송하지 않습니다. 해당 ID 중 하나에 대한 Router 디스패치(`model_provider=veo`)에서는 동기식이든 대기 중이든(`/v2/models/veo/{model}/requests`) 요청이 Vertex에 도달하기 전에 `ALLOW`는 `allow_adult`로, `BLOCK`은 `dont_allow`로 매핑됩니다(routerVeoMapPersonGeneration, server/middleware/router_veo_person_generation.go). Vertex 자체는 어느 표기도 허용하지 않기 때문입니다. 직접 v1 `/proxy/veo/:modelId/generate` 호출자는 어느 경우에도 영향을 받지 않습니다. comfy-api는 `/proxy/*`에 요청 검증기를 설치하지 않으므로 이 열거형은 이미 그곳에서 강제되지 않는 문서였으며, Router 전용 매핑은 이 호출에 대해 실행되지 않습니다. - 가능한 값: `dont_allow`, `allow_adult`, `allowAll` + 가능한 값: `dont_allow`, `allow_adult`, `allowAll`, `ALLOW`, `BLOCK` - 진행 상황 업데이트를 위한 Cloud Pub/Sub 토픽입니다(projects/\{project}/topics/\{topic}). Comfy 자격 증명(비 BYOK) 요청에서는 허용되지 않습니다. 이 파라미터가 있으면 generate 라우트가 400으로 응답하는데, 작업이 Comfy의 프로젝트에서 실행되고 Vertex가 Comfy의 서비스 에이전트로 게시하게 되기 때문입니다. Vertex가 자신의 프로젝트에서 토픽 권한을 평가하는 bring-your-own-key 요청에서만 허용됩니다. + 진행 상황 업데이트를 위한 Cloud Pub/Sub 토픽입니다(projects/\{project}/topics/\{topic}). Comfy 자격 증명(비 BYOK) 요청에서는 허용되지 않습니다. 이 파라미터가 있으면 generate 라우트가 400으로 응답하는데, 작업이 Comfy의 프로젝트에서 실행되고 Vertex가 Comfy의 서비스 에이전트로 게시하게 되기 때문입니다. Vertex가 사용자의 프로젝트에서 토픽 권한을 평가하는 bring-your-own-key 요청에서만 허용됩니다. @@ -388,7 +390,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ 생성된 비디오를 저장할 선택적 Cloud Storage 대상 위치이며 `gs://` URI입니다. -반드시 자신의 버킷을 지정해야 합니다. bring-your-own-key가 아니면 이 라우트는 사용자의 자격 증명이 아니라 Comfy 자체의 Google Cloud 자격 증명으로 실행되므로, Comfy 소유 버킷 안의 대상 위치는 Comfy 서비스 계정이 공유 레이아웃에 수행하고 Comfy 프로젝트에 청구되는 쓰기가 됩니다. 그런 값을 지정한 요청은 400으로 거부되고 아무것도 생성되지 않습니다. 예외는 하나뿐이며, 플랫폼 스토리지가 활성화된 동기 Comfy Router 호출(`POST /v2/models/{provider}/{model}`)입니다. 이 경우 Router 자체의 Veo 또는 Gemini 에셋 버킷을 가리키는 값은 해당 호출을 위해 Router가 사용자의 플랫폼 접두사 아래에서 발급하는 대상 위치로 대체되며, Router가 발급한 바로 그 대상 위치만 통과합니다. 큐에 넣은 Router 제출(`POST /v2/models/{provider}/{model}/requests`)은 그러한 대체를 하지 않으므로 다른 Comfy 소유 버킷과 마찬가지로 그 값을 400으로 거부합니다. 그 밖의 대상 위치는 변경 없이 Vertex로 전달되며 액세스 권한 부여는 사용자 몫입니다. bring-your-own-key 호출은 자신의 프로젝트에서 실행되며 전송된 그대로 전달됩니다. +반드시 자신의 버킷을 지정해야 합니다. bring-your-own-key가 아니면 이 라우트는 사용자의 자격 증명이 아니라 Comfy 자체의 Google Cloud 자격 증명으로 실행되므로, Comfy 소유 버킷 안의 대상 위치는 Comfy 서비스 계정이 공유 레이아웃에 수행하는 쓰기가 되고, 비용은 Comfy 프로젝트에 청구됩니다. 그런 값을 지정한 요청은 400으로 거부되고 아무것도 생성되지 않습니다. 예외는 하나뿐이며, 플랫폼 스토리지가 활성화된 동기 Comfy Router 호출(`POST /v2/models/{provider}/{model}`)입니다. 이 경우 Router 자체의 Veo 또는 Gemini 에셋 버킷을 가리키는 값은 해당 호출을 위해 Router가 사용자의 플랫폼 접두사 아래에서 발급하는 대상 위치로 대체되며, Router가 발급한 바로 그 대상 위치만 통과합니다. 대기 중인 Router 제출(`POST /v2/models/{provider}/{model}/requests`)은 그러한 대체를 하지 않으므로 다른 Comfy 소유 버킷과 마찬가지로 그 값을 400으로 거부합니다. 그 밖의 대상 위치는 변경 없이 Vertex로 전달되며 액세스 권한 부여는 사용자 몫입니다. bring-your-own-key 호출은 사용자의 프로젝트에서 실행되며 전송된 그대로 전달됩니다. diff --git a/ko/development/comfy-router/pricing.mdx b/ko/development/comfy-router/pricing.mdx index 584dbcdf77..84e20234e6 100644 --- a/ko/development/comfy-router/pricing.mdx +++ b/ko/development/comfy-router/pricing.mdx @@ -148,10 +148,10 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | 이름 | 모델 ID | 옵션 | 크레딧 | | --- | --- | --- | ---: | -| [Arrow 2](/ko/development/comfy-router/models) | `quiver/arrow-2` | 입력 | 1206.92 / 1M 토큰 | -| [Arrow 2](/ko/development/comfy-router/models) | `quiver/arrow-2` | 출력 | 6034.6 / 1M 토큰 | -| [Arrow 2 Telos](/ko/development/comfy-router/models) | `quiver/arrow-2-telos` | 입력 | 1810.38 / 1M 토큰 | -| [Arrow 2 Telos](/ko/development/comfy-router/models) | `quiver/arrow-2-telos` | 출력 | 9051.9 / 1M 토큰 | +| [Arrow 2](/ko/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 입력 | 1206.92 / 1M 토큰 | +| [Arrow 2](/ko/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 출력 | 6034.6 / 1M 토큰 | +| [Arrow 2 Telos](/ko/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 입력 | 1810.38 / 1M 토큰 | +| [Arrow 2 Telos](/ko/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 출력 | 9051.9 / 1M 토큰 | #### 게시되지 않음 @@ -441,17 +441,17 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | --- | --- | --- | ---: | | [Aleph 2](/ko/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | 84.4844 / s | | [Gen 4 Turbo](/ko/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | 15.0865 / s | -| [LTX Video Alpha Gen](/ko/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1080p | 30.173 / s | -| [LTX Video Alpha Gen](/ko/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1440p | 75.4325 / s | -| [LTX Video Alpha Gen](/ko/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 2160p | 301.73 / s | -| [LTX Video To Video Hdr](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1080p | 120.692 / s | -| [LTX Video To Video Hdr](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1440p | 241.384 / s | -| [LTX Video To Video Hdr](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 2160p | 482.768 / s | -| [LTX Video To Video Reframe](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 720p | 30.173 / s | -| [LTX Video To Video Reframe](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 1080p | 60.346 / s | -| [LTX Video Upscale](/ko/development/comfy-router/models) | `ltx/ltx-video-upscale` | 1080p | 24.1384 / s | -| [LTX Video Upscale](/ko/development/comfy-router/models) | `ltx/ltx-video-upscale` | 4K | 90.519 / s | -| [LTX Video Upscale](/ko/development/comfy-router/models) | `ltx/ltx-video-upscale` | 8K | 362.076 / s | +| [LTX Video Alpha Gen](/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1080p | 30.173 / s | +| [LTX Video Alpha Gen](/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1440p | 75.4325 / s | +| [LTX Video Alpha Gen](/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 2160p | 301.73 / s | +| [LTX Video To Video Hdr](/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1080p | 120.692 / s | +| [LTX Video To Video Hdr](/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1440p | 241.384 / s | +| [LTX Video To Video Hdr](/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 2160p | 482.768 / s | +| [LTX Video To Video Reframe](/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 720p | 30.173 / s | +| [LTX Video To Video Reframe](/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 1080p | 60.346 / s | +| [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 1080p | 24.1384 / s | +| [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 4K | 90.519 / s | +| [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 8K | 362.076 / s | | [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | 3.0173 / s | | [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | 6.0346 / s | | [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | 10.56055 / s | @@ -519,9 +519,9 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | 이름 | 모델 ID | 크레딧 | | --- | --- | ---: | -| [V3.5](/ko/development/comfy-router/models) | `pixverse/v3.5` | 3.0173 / PixVerse 크레딧 | -| [V6](/ko/development/comfy-router/models) | `pixverse/v6` | 1.025882 / PixVerse 크레딧 | -| [V6 Max](/ko/development/comfy-router/models) | `pixverse/v6-max` | 1.34102316 / PixVerse 크레딧 | +| [V3.5](/ko/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | 3.0173 / PixVerse 크레딧 | +| [V6](/ko/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | 1.025882 / PixVerse 크레딧 | +| [V6 Max](/ko/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | 1.34102316 / PixVerse 크레딧 | #### 요청당 요금 @@ -676,9 +676,9 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | [Claude Sonnet 5](/ko/development/comfy-router/models/anthropic/claude-sonnet-5/code) | `anthropic/claude-sonnet-5` | 읽기: 60.346
쓰기(1시간): 1206.92
쓰기(5분): 754.325 | 텍스트: 603.46 | 텍스트: 3017.3 | | [Claude Sonnet 4.6](/ko/development/comfy-router/models/anthropic/claude-sonnet-4-6/code) | `anthropic/claude-sonnet-4-6` | 읽기: 63.3
쓰기(1시간): 1266
쓰기(5분): 791.25 | 텍스트: 633 | 텍스트: 3165 | | [Claude Sonnet 4.5](/ko/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code) | `anthropic/claude-sonnet-4-5-20250929` | 읽기: 63.3
쓰기(1시간): 1266
쓰기(5분): 791.25 | 텍스트: 633 | 텍스트: 3165 | -| [Gemini 4 Argon](/ko/development/comfy-router/models) | `vertexai/gemini-4-argon` | - | 오디오 / 이미지 / 텍스트 / 동영상: 1206.92 | 텍스트 / 추론: 6034.6 | -| [Gemini 4 Carbon](/ko/development/comfy-router/models) | `vertexai/gemini-4-carbon` | - | 오디오 / 이미지 / 텍스트 / 동영상: 1206.92 | 텍스트 / 추론: 6034.6 | -| [Gemini 4 Hydrogen](/ko/development/comfy-router/models) | `vertexai/gemini-4-hydrogen` | - | 오디오 / 이미지 / 텍스트 / 동영상: 452.595 | 텍스트 / 추론: 2262.975 | +| [Gemini 4 Argon](/ko/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | - | 오디오 / 이미지 / 텍스트 / 동영상: 1206.92 | 텍스트 / 추론: 6034.6 | +| [Gemini 4 Carbon](/ko/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | - | 오디오 / 이미지 / 텍스트 / 동영상: 1206.92 | 텍스트 / 추론: 6034.6 | +| [Gemini 4 Hydrogen](/ko/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | - | 오디오 / 이미지 / 텍스트 / 동영상: 452.595 | 텍스트 / 추론: 2262.975 | | [Gemini 3.8 Flash](/ko/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | 오디오 / 이미지 / 텍스트 / 동영상: 452.595 | 텍스트 / 추론: 2262.975 | | [Gemini 3.7 Flash](/ko/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | 오디오 / 이미지 / 텍스트 / 동영상: 452.595 | 텍스트 / 추론: 2262.975 | | [Gemini 3.1 Flash Lite](/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | 이미지 / 텍스트 / 동영상: 52.75
오디오: 105.5 | 텍스트 / 추론: 316.5 | @@ -933,10 +933,10 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | 이름 | 모델 ID | 옵션 | USD | | --- | --- | --- | ---: | -| [Arrow 2](/ko/development/comfy-router/models) | `quiver/arrow-2` | 입력 | $5.72 / 1M 토큰 | -| [Arrow 2](/ko/development/comfy-router/models) | `quiver/arrow-2` | 출력 | $28.60 / 1M 토큰 | -| [Arrow 2 Telos](/ko/development/comfy-router/models) | `quiver/arrow-2-telos` | 입력 | $8.58 / 1M 토큰 | -| [Arrow 2 Telos](/ko/development/comfy-router/models) | `quiver/arrow-2-telos` | 출력 | $42.90 / 1M 토큰 | +| [Arrow 2](/ko/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 입력 | $5.72 / 1M 토큰 | +| [Arrow 2](/ko/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 출력 | $28.60 / 1M 토큰 | +| [Arrow 2 Telos](/ko/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 입력 | $8.58 / 1M 토큰 | +| [Arrow 2 Telos](/ko/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 출력 | $42.90 / 1M 토큰 | #### 게시되지 않음 @@ -1226,17 +1226,17 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | --- | --- | --- | ---: | | [Aleph 2](/ko/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | $0.4004 / s | | [Gen 4 Turbo](/ko/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | $0.0715 / s | -| [LTX Video Alpha Gen](/ko/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1080p | $0.143 / s | -| [LTX Video Alpha Gen](/ko/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1440p | $0.3575 / s | -| [LTX Video Alpha Gen](/ko/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 2160p | $1.43 / s | -| [LTX Video To Video Hdr](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1080p | $0.572 / s | -| [LTX Video To Video Hdr](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1440p | $1.144 / s | -| [LTX Video To Video Hdr](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 2160p | $2.288 / s | -| [LTX Video To Video Reframe](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 720p | $0.143 / s | -| [LTX Video To Video Reframe](/ko/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 1080p | $0.286 / s | -| [LTX Video Upscale](/ko/development/comfy-router/models) | `ltx/ltx-video-upscale` | 1080p | $0.1144 / s | -| [LTX Video Upscale](/ko/development/comfy-router/models) | `ltx/ltx-video-upscale` | 4K | $0.429 / s | -| [LTX Video Upscale](/ko/development/comfy-router/models) | `ltx/ltx-video-upscale` | 8K | $1.716 / s | +| [LTX Video Alpha Gen](/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1080p | $0.143 / s | +| [LTX Video Alpha Gen](/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1440p | $0.3575 / s | +| [LTX Video Alpha Gen](/ko/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 2160p | $1.43 / s | +| [LTX Video To Video Hdr](/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1080p | $0.572 / s | +| [LTX Video To Video Hdr](/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1440p | $1.144 / s | +| [LTX Video To Video Hdr](/ko/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 2160p | $2.288 / s | +| [LTX Video To Video Reframe](/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 720p | $0.143 / s | +| [LTX Video To Video Reframe](/ko/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 1080p | $0.286 / s | +| [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 1080p | $0.1144 / s | +| [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 4K | $0.429 / s | +| [LTX Video Upscale](/ko/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 8K | $1.716 / s | | [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | $0.0143 / s | | [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | $0.0286 / s | | [Pika H3 Flex Image To Video](/ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | $0.05005 / s | @@ -1304,9 +1304,9 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | 이름 | 모델 ID | USD | | --- | --- | ---: | -| [V3.5](/ko/development/comfy-router/models) | `pixverse/v3.5` | $0.0143 / PixVerse 크레딧 | -| [V6](/ko/development/comfy-router/models) | `pixverse/v6` | $0.004862 / PixVerse 크레딧 | -| [V6 Max](/ko/development/comfy-router/models) | `pixverse/v6-max` | $0.00635556 / PixVerse 크레딧 | +| [V3.5](/ko/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | $0.0143 / PixVerse 크레딧 | +| [V6](/ko/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | $0.004862 / PixVerse 크레딧 | +| [V6 Max](/ko/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | $0.00635556 / PixVerse 크레딧 | #### 요청당 요금 @@ -1461,9 +1461,9 @@ Ray 3.2의 EXR 내보내기는 아직 제공되지 않습니다. HDR 요청에 | [Claude Sonnet 5](/ko/development/comfy-router/models/anthropic/claude-sonnet-5/code) | `anthropic/claude-sonnet-5` | 읽기: $0.286
쓰기(1시간): $5.72
쓰기(5분): $3.575 | 텍스트: $2.86 | 텍스트: $14.30 | | [Claude Sonnet 4.6](/ko/development/comfy-router/models/anthropic/claude-sonnet-4-6/code) | `anthropic/claude-sonnet-4-6` | 읽기: $0.30
쓰기(1시간): $6.00
쓰기(5분): $3.75 | 텍스트: $3.00 | 텍스트: $15.00 | | [Claude Sonnet 4.5](/ko/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code) | `anthropic/claude-sonnet-4-5-20250929` | 읽기: $0.30
쓰기(1시간): $6.00
쓰기(5분): $3.75 | 텍스트: $3.00 | 텍스트: $15.00 | -| [Gemini 4 Argon](/ko/development/comfy-router/models) | `vertexai/gemini-4-argon` | - | 오디오 / 이미지 / 텍스트 / 동영상: $5.72 | 텍스트 / 추론: $28.60 | -| [Gemini 4 Carbon](/ko/development/comfy-router/models) | `vertexai/gemini-4-carbon` | - | 오디오 / 이미지 / 텍스트 / 동영상: $5.72 | 텍스트 / 추론: $28.60 | -| [Gemini 4 Hydrogen](/ko/development/comfy-router/models) | `vertexai/gemini-4-hydrogen` | - | 오디오 / 이미지 / 텍스트 / 동영상: $2.145 | 텍스트 / 추론: $10.725 | +| [Gemini 4 Argon](/ko/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | - | 오디오 / 이미지 / 텍스트 / 동영상: $5.72 | 텍스트 / 추론: $28.60 | +| [Gemini 4 Carbon](/ko/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | - | 오디오 / 이미지 / 텍스트 / 동영상: $5.72 | 텍스트 / 추론: $28.60 | +| [Gemini 4 Hydrogen](/ko/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | - | 오디오 / 이미지 / 텍스트 / 동영상: $2.145 | 텍스트 / 추론: $10.725 | | [Gemini 3.8 Flash](/ko/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | 오디오 / 이미지 / 텍스트 / 동영상: $2.145 | 텍스트 / 추론: $10.725 | | [Gemini 3.7 Flash](/ko/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | 오디오 / 이미지 / 텍스트 / 동영상: $2.145 | 텍스트 / 추론: $10.725 | | [Gemini 3.1 Flash Lite](/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | 이미지 / 텍스트 / 동영상: $0.25
오디오: $0.50 | 텍스트 / 추론: $1.50 | diff --git a/ko/development/comfy-router/quickstart.mdx b/ko/development/comfy-router/quickstart.mdx index 07c8fca8eb..b6882110ed 100644 --- a/ko/development/comfy-router/quickstart.mdx +++ b/ko/development/comfy-router/quickstart.mdx @@ -2,14 +2,15 @@ title: "Comfy Router 빠른 시작" sidebarTitle: "빠른 시작" description: "최신 프런티어 미디어 모델로 몇 분 만에 이미지와 비디오를 생성하세요." -translationSourceHash: ea087f5c +translationSourceHash: ea722f9a translationFrom: development/comfy-router/quickstart.mdx translationBlockHashes: "_intro": 201b5b50 - "Image-to-video and reference-to-video": 8ac90191 + "Image-to-video and reference-to-video": e7a93779 "Next steps": ed466781 --- +
Comfy Router는 `https://api.comfy.org`에서 호스팅되는 이미지 및 비디오 모델을 위한 단일 API를 제공합니다. [Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 API 키를 생성한 다음, 공식 [Python 및 TypeScript SDK](/ko/development/api-development/sdks)나 일반 HTTP로 모든 모델을 호출하세요. 과금은 사용량 기반입니다. 기본적으로 각 요청은 구독 없이 워크스페이스 잔액에서 크레딧을 차감합니다. 요금과 기타 결제 옵션은 [Router 가격](/ko/development/comfy-router/pricing)을 참고하세요. @@ -174,6 +175,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"}, {"type": "image_url", "image_url": {"url": "https://example.com/outfit.png"}, "role": "reference_image"} ], + "omni_reference_task_type": "reference", "duration": 5, "ratio": "16:9", "resolution": "720p" @@ -182,6 +184,28 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque Seedance 2.5에서 첫 프레임 요청과 첫 프레임 및 마지막 프레임 요청은 첫 프레임에서 출력 화면 비율을 가져옵니다. 구체적인 비율을 지정하면 `400`으로 거부되므로 `ratio`를 생략하거나 `adaptive`를 전송하세요. 요청 스키마는 Seedance 제품군 전체가 공유하며 모델이 무시하는 역할도 나열할 수 있으므로, 각 모델의 [입력 스키마](/ko/development/comfy-router/models)에서 `x-comfy-router-input-modalities` 필드를 확인해 해당 모델이 허용하는 입력 종류를 파악하세요. 예를 들어 `reference_video`와 `reference_audio`는 여기에 `video` 또는 `audio`를 나열하는 모델이 필요합니다. +### 레퍼런스 비디오 편집 또는 확장 + +Seedance 2.5에서 `omni_reference_task_type`은 레퍼런스 미디어로 무엇을 할지 모델에 알려줍니다. `reference`는 이를 바탕으로 새 비디오를 만들고, `edit`는 `reference_video` 클립을 변경하며, `extend`는 클립을 이어서 연장합니다. 이 필드가 없으면 모델이 프롬프트에서 작업을 선택하며, 편집은 클립 자체의 길이와 화면 비율을 유지하고 `duration`과 `ratio`를 무시합니다. 네이티브 BytePlus 레그에서는 요청에 맞지 않는 명시적 값이 생성 시작 전에 거부되므로 과금되지 않습니다. 대체 공급자 레그는 폴백으로 사용되거나 `model_provider`로 선택되는데, 작업 유형 필드가 없습니다. 이 레그는 값을 삭제하고 해당 공급자가 필드를 생략한 것처럼 작업을 추론하도록 합니다. 이 삭제는 동기 실행 경로 응답과 대기 중 제출의 `201`에서 `X-Comfy-Router-Dropped-Params`에 공개됩니다. 대기 중 경로는 폴백이 없으므로 `model_provider`를 통해서만 대체 레그에 도달합니다. + +```bash Edit a reference video +curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d '{ + "content": [ + {"type": "text", "text": "Make the fox bright red"}, + {"type": "video_url", "video_url": {"url": "https://example.com/fox.mp4"}, "role": "reference_video"} + ], + "omni_reference_task_type": "edit", + "duration": -1, + "resolution": "720p" + }' +``` + +편집은 소스 클립의 길이를 유지하므로 `"duration": -1`을 전송하고 `ratio`는 생략하세요. `extend` 요청은 전송한 `duration` 길이의 새로 생성된 세그먼트만 반환합니다. + ## 다음 단계 diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index 78636aabfd..acba2df505 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -2,11 +2,11 @@ title: "Comfy Router API 레퍼런스" description: "Comfy API 계약에서 생성된 모든 Comfy Router 엔드포인트, 매개변수, 응답 본문 및 오류 버킷." sidebarTitle: "API 레퍼런스" -translationSourceHash: e8d9375f +translationSourceHash: 64fd0a10 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": e6679d4b + "Endpoints": 5e27b6a1 "Error buckets": 02a09cb4 "Response headers": 3ac389bd "Pre-flight cost estimates": 7405db0d @@ -31,6 +31,7 @@ translationBlockHashes: + {/* 생성된 파일: 손으로 편집하지 마십시오. @@ -55,7 +56,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 **Comfy Router가 실행할 수 있는 모델을 나열합니다.** -사용 가능한 모델 ID와 청구 정보를 나열합니다. `has_more`가 true인 동안 `next_cursor`를 사용하세요. +사용 가능한 모델 ID와 청구 정보를 나열합니다. `has_more`가 참인 동안 `next_cursor`를 사용하세요. **파라미터** @@ -108,9 +109,9 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`초만큼 기다리세요. + `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`를 기다리세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` @@ -176,7 +177,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`초만큼 기다리세요. + `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`만큼 기다리세요. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` @@ -214,7 +215,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - 이 모델을 현재 기본값 대신 다른 공급자가 처리하도록 선택합니다. `fal`, `wavespeed`, `runware`, `higgsfield`가 대체 공급자이며, `GET /v2/models/{provider}/{model}`은 주어진 모델이 이 중 어떤 공급자를 지원하는지 보고합니다. 거부 사유는 정해진 순서로 검사되며, 앞선 사유는 나중 사유의 해당 여부와 관계없이 응답합니다. 인식할 수 없는 값, 즉 등록된 공급자가 전혀 아닌 값은 `400`으로 거부됩니다. 그다음, 본문이 멀티파트 작업(편집)을 선택하는 요청에서 대체 공급자는 `detail`이 "this request's `image` selects the edit operation"로 시작하는 `409`로 거부되지만, 이는 해당 공급자의 이 모델용 변환기가 그 작업을 처리할 수 없을 때만이며, 변환기가 미디어를 지원하는 경로는 정상적으로 진행됩니다. 그다음, 자체 키(BYOK) 자격 증명이 확인된 요청에서는 해당 공급자가 이 모델을 처리하는지와 무관하게 모든 대체 공급자가 `detail`이 `this request resolved a BYOK credential`로 시작하는 `409`로 거부됩니다(해당 응답 참조). 그다음, 지명된 공급자 자체의 게이트가 적용되며, 해당 공급자가 사용자에게 활성화되어 있지 않으면 `error_type: not_enabled`와 함께 `403`으로, 게이트를 평가할 수 없으면 `error_type: service_unavailable`와 함께 `503`으로 거부합니다. 이 네 가지를 모두 통과한 뒤에야, 이 모델에 대한 경로가 없는 실제 공급자가 `error_type: invalid_input`와 함께 `400`으로 거부되며, 이는 인식할 수 없는 값과 같은 응답입니다. `fallback_provider`는 자체 키 요청, 본문이 멀티파트 작업을 선택하는 요청, 그리고 `strict_mode=true`에서 거부되지 않고 아무 효과도 없습니다. + 이 모델을 현재 기본 공급자 대신 다른 공급자가 처리하도록 선택합니다. `fal`, `wavespeed`, `runware`, `higgsfield`가 대체 공급자이며, `GET /v2/models/{provider}/{model}`은 주어진 모델이 이 중 어떤 공급자를 지원하는지 보고합니다. 거부 사유는 정해진 순서로 검사되며, 앞선 사유는 나중 사유의 해당 여부와 무관하게 응답으로 이어집니다. 인식할 수 없는 값, 즉 등록된 공급자가 전혀 아닌 값은 `400`으로 거부됩니다. 그다음, 본문이 멀티파트 작업(편집)을 선택하는 요청에 대체 공급자를 지정하면 `detail`이 "this request's `image` selects the edit operation"로 시작하는 `409`로 거부되지만, 이는 해당 공급자의 이 모델용 변환기가 그 작업을 처리할 수 없을 때만이며, 변환기가 미디어를 처리할 수 있는 경로는 정상적으로 진행됩니다. 그다음, 자체 키(BYOK) 자격 증명이 확인된 요청에서는 해당 공급자가 이 모델을 처리하는지와 무관하게 모든 대체 공급자가 `detail`이 `this request resolved a BYOK credential`로 시작하는 `409`로 거부됩니다(해당 응답 참조). 그다음, 지정된 공급자 자체의 게이트가 적용되며, 해당 공급자가 사용자에게 활성화되어 있지 않으면 `error_type: not_enabled`와 함께 `403`으로, 게이트를 평가할 수 없으면 `error_type: service_unavailable`과 함께 `503`으로 거부합니다. 이 네 가지를 모두 통과한 뒤에야, 이 모델에 대한 경로가 없는 실제 공급자가 `error_type: invalid_input`와 함께 `400`으로 거부되며, 이는 인식할 수 없는 값과 같은 응답입니다. `fallback_provider`는 자체 키 요청, 본문이 멀티파트 작업을 선택하는 요청, 그리고 `strict_mode=true`에서 거부되지 않고 아무 효과도 없습니다. @@ -224,7 +225,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - 첫 시도가 Router 또는 시도한 공급자에게 귀속되는 이유로 실패했을 때, Router가 이 호출을 모델의 다른 등록 공급자에 대해 재시도할지 여부를 제어합니다. 생략하거나 `false`가 아닌 값을 지정하면 폴백이 켜진 상태로 유지되고, `false`는 이를 끕니다. 폴백이 성공한 응답에는 `X-Comfy-Router-Fallback-Provider`가 포함됩니다. 자체 키(BYOK) 자격 증명이 확인된 요청에서는 이 파라미터의 값과 무관하게 폴백을 사용할 수 없습니다. 재시도는 그저 수행되지 않고 첫 실패가 그대로 전달되며, 이는 거부가 아니라 아무 효과도 없는 것입니다. 여기서 `409`가 발생하지는 않습니다. 같은 이유로 본문이 멀티파트 작업을 선택하는 요청과 `strict_mode=true`에서도 마찬가지입니다. 각각은 호출을 다른 공급자에 대해 충실히 재현할 수 없는 하나의 공급자에 묶으므로, 폴백은 거부되지 않고 그저 건너뜁니다. 명시적인 `model_provider`만이 그 `409`로 거부되며, 이 무조건적인 건너뜀과 달리 그 멀티파트 `409`는 변환기가 해당 작업을 처리할 수 없는 경로에만 적용됩니다. + 첫 시도가 Router 또는 시도한 공급자에 기인한 이유로 실패했을 때, Router가 이 호출을 모델의 다른 등록 공급자에 대해 재시도할지 여부를 제어합니다. 생략하거나 `false`가 아닌 값을 지정하면 폴백이 켜진 상태로 유지되고, `false`는 이를 끕니다. 폴백이 성공하면 응답에 `X-Comfy-Router-Fallback-Provider`가 포함됩니다. 자체 키(BYOK) 자격 증명이 확인된 요청에서는 이 파라미터의 값과 무관하게 폴백을 사용할 수 없습니다. 재시도는 그저 수행되지 않고 첫 실패가 그대로 전달되며, 이는 거부가 아니라 아무 효과도 없는 동작입니다. 여기서 `409`가 발생하지는 않습니다. 같은 이유로 본문이 멀티파트 작업을 선택하는 요청과 `strict_mode=true`에서도 마찬가지입니다. 각각은 호출을 다른 공급자에 대해 충실히 재현할 수 없는 하나의 공급자에 묶으므로, 폴백은 거부되지 않고 그저 건너뜁니다. 오직 명시적인 `model_provider`만 그 `409`로 거부되며, 이 무조건적인 건너뜀과 달리 그 멀티파트 `409`는 변환기가 해당 작업을 처리할 수 없는 경로에만 적용됩니다. @@ -237,12 +238,10 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 `application/json` -- [`RouterModelInput`](#routermodelinput) (필수) -파트너 모델의 기본 JSON 입력입니다. `model_provider`가 없으면 요청은 모델의 기본 공급자에서 네이티브 디스패치를 실행하며, 이 본문은 모델 자체의 네이티브 스키마이고 그대로 전달됩니다(이 경우 `strict_mode`는 의미가 없고 아무것도 바꾸지 않습니다). `model_provider`가 대체 공급자를 선택하고 `strict_mode=false`(기본값)인 경우, 본문은 전송되기 이전에 해당 공급자의 실제 스키마로 변환됩니다. 정확히 표현할 수 없는 네이티브 필드는 버려지고 응답의 `X-Comfy-Router-Dropped-Params` 헤더를 통해 알려지며, 결코 조용히 처리되지 않습니다. `model_provider`가 대체 공급자를 선택하고 `strict_mode=true`이면 변환이 실행되지 않습니다. 본문은 이 모델의 네이티브 스키마가 아니라 이미 그 대체 공급자 자체의 실제 스키마여야 하며(`strict_mode` 참조), 그대로 전달됩니다. 본문의 필드 자체가 둘 이상의 작업을 지원하는 모델에서 Router가 실행할 작업을 선택하기도 합니다. 편집 가능한 이미지 모델의 경우 입력 이미지를 포함하면 텍스트 기반 이미지 생성에서 이미지 기반 이미지 생성(편집) 작업으로 전환되며, 이 작업은 별도의 요율로 과금될 수 있습니다. Seedance 비디오 모델의 경우 `content[].role`이 작업을 선택합니다(첫 프레임 이미지는 이미지 기반 비디오 생성을, 레퍼런스 이미지 또는 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 과금은 역할이 아니라 `content`의 미디어 종류를 따릅니다. 비디오 입력이 하나라도 있는 요청은 비디오 기반 비디오 생성으로, 그렇지 않고 이미지가 하나라도 있으면 이미지 기반 비디오 생성으로, 그 외에는 텍스트 기반 비디오 생성으로 과금됩니다. 다만 `draft_task` 항목에서 나온 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금됩니다. 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성을 같은 요율로 과금합니다. `model_provider`가 대체 공급자를 선택하는 경우, 조건이 적용된 각 작업은 해당 공급자 자체의 요율로 과금될 수 있습니다. +파트너 모델의 네이티브 JSON 입력입니다. `model_provider`가 없으면 요청은 모델의 기본 공급자에서 네이티브 디스패치를 실행하며, 이 본문은 모델 자체의 네이티브 스키마이고 그대로 전달됩니다(이 경우 `strict_mode`는 의미가 없고 아무것도 바꾸지 않습니다). `model_provider`가 대체 공급자를 선택하고 `strict_mode=false`(기본값)인 경우, 본문은 전송되기 전에 해당 공급자의 실제 스키마로 변환됩니다. 정확히 표현할 수 없는 네이티브 필드는 버려지고 응답의 `X-Comfy-Router-Dropped-Params` 헤더를 통해 알려지며, 결코 조용히 넘어가지 않습니다. `model_provider`가 대체 공급자를 선택하고 `strict_mode=true`이면 변환이 실행되지 않습니다. 본문은 이 모델의 네이티브 스키마가 아니라 이미 그 대체 공급자 자체의 실제 스키마여야 하며(`strict_mode` 참조), 그대로 전달됩니다. 본문의 필드 자체가 둘 이상의 작업을 지원하는 모델에서 Router가 실행할 작업을 선택하기도 합니다. 편집 가능한 이미지 모델의 경우 입력 이미지가 포함되면 텍스트 기반 이미지 생성에서 이미지 기반 이미지 생성(편집) 작업으로 전환되며, 이 작업은 별도의 요율로 과금될 수 있습니다. Seedance 비디오 모델의 경우 `content[].role`이 작업을 선택합니다(첫 프레임 이미지는 이미지 기반 비디오 생성을, 레퍼런스 이미지 또는 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 과금은 역할이 아니라 `content`의 미디어 종류를 따릅니다. 비디오 입력이 하나라도 있는 요청은 비디오 기반 비디오 생성으로, 그렇지 않고 이미지가 하나라도 있으면 이미지 기반 비디오 생성으로, 그 외에는 텍스트 기반 비디오 생성으로 과금됩니다. 다만 `draft_task` 항목에서 나온 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금됩니다. 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성을 같은 요율로 과금합니다. `model_provider`가 대체 공급자를 선택하는 경우, 조건이 적용된 각 작업은 해당 공급자 자체의 요율로 과금될 수 있습니다. -**응답** - - - OK - `model_provider`가 없거나, `model_provider`가 있고 `strict_mode=false`(기본값, 가능한 경우 이 모델의 네이티브 계약으로 다시 변환되며, 변환에 실패하면 대체 공급자 자체의 원시 응답으로 폴백합니다. 이는 기록되며 결코 조용히 넘어가지 않습니다)인 경우 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`이면 대체 공급자의 응답이 변경 없이 그대로 반환됩니다. 파트너가 생성을 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type` 아래에 있는 해당 바이트입니다. 응답 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. +**응답** + OK - `model_provider`가 없거나, `model_provider`와 `strict_mode=false`(기본값)를 함께 사용하는 경우, 가능하면 이 모델의 네이티브 계약으로 다시 변환하며 변환에 실패하면 대체 공급자 자체의 원시 응답으로 폴백합니다(로그에 기록되며, 결코 조용히 넘어가지 않습니다). 이때 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`이면 대체 공급자의 응답이 변경 없이 그대로 반환됩니다. 파트너가 생성 요청에 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type`으로 반환되는 해당 바이트입니다. 응답의 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. 본문: [`RouterModelOutput`](#routermodeloutput) 또는 원시 바이트 (`*/*`) -- 헤더: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` @@ -260,13 +259,13 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나, 모델 자체가 보고하지 않은 이유로 실패했습니다. + Router 요청 수준의 실패입니다. 요청이 모델에 도달하지 않았거나 모델 자체가 보고하지 않은 이유로 실패했습니다. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 이 호출자 또는 모델에 대해 요청이 허용되지 않습니다. + 이 호출자 또는 모델에 대해서는 요청이 허용되지 않습니다. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -278,7 +277,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - `X-Comfy-Error-Type`을 확인하세요. `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`를 기다린 뒤 동일한 키를 재사용하세요. `invalid_input`은 새 키가 필요합니다. 이 경로에서 발생하는 두 가지 `invalid_input` 충돌은 키와 전혀 무관하며 어떤 새 키로도 해결되지 않습니다. `model_provider`가 대체 공급자를 지정한 경우, 요청 본문이 해당 공급자의 이 모델용 번역기가 처리할 수 없는 멀티파트 작업(편집)을 선택하면 거부되며 `detail`은 "this request's `image` selects the edit operation"로 시작합니다. 그리고 그 이후에 확인되는 것으로, 요청이 이미 경로에 있는 공급자에 대한 BYOK(bring-your-own-key) 자격 증명을 확인한 경우에는 `detail`이 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이 (멀티파트의 경우) 편집 없이 요청을 보내세요. + `X-Comfy-Error-Type`을 확인하세요. `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`를 기다린 뒤 동일한 키를 재사용하세요. `invalid_input`은 새 키가 필요합니다. 이 경로에서 발생하는 두 가지 `invalid_input` 충돌은 키와 전혀 무관하며 새 키로도 어느 쪽도 해결되지 않습니다. 대체 공급자를 지정하는 `model_provider`는 요청 본문이 해당 공급자의 이 모델용 번역기가 처리할 수 없는 멀티파트 작업(편집)을 선택할 때 거부됩니다. 이때 `detail`은 "this request's `image` selects the edit operation"로 시작합니다. 그리고 그 이후에 확인되는 충돌로, 요청이 경로에 있는 공급자에 대해 BYOK(bring-your-own-key) 자격 증명을 이미 확인한 경우에는 `detail`이 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이, 멀티파트의 경우에는 편집 없이 요청을 보내세요. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded`인 경우) @@ -290,7 +289,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - 요청 내용이 모델의 스키마에 대해 거부되었습니다. + 요청 콘텐츠가 모델의 스키마에 맞지 않아 거부되었습니다. 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` @@ -394,9 +393,9 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`초만큼 기다리세요. + `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`를 기다리세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` @@ -408,7 +407,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/openapi.json` @@ -474,9 +473,9 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 - `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`초만큼 기다리세요. + `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`에 지정된 시간만큼 기다리세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` @@ -487,7 +486,7 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 ### `POST /v2/models/{provider}/{model}/requests` -**파트너 모델 실행을 실행 대기열에 제출하고 즉시 반환합니다.** +**파트너 모델 실행 요청을 실행 대기열에 제출하고 즉시 반환합니다.** Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/models/{provider}/{model}`이 이 모델에 대해 받아들이는 파트너 네이티브 JSON 입력과 동일합니다. 하나의 본문 형태, 모델별 하나의 스키마, 두 가지 전달 모드가 있습니다. 다만 이 경로는 결과를 위해 연결을 유지하지 않습니다. 실행을 접수하고 핸들과 함께 `201`로 응답하며, 호출자는 아래 세 가지 조회를 통해 나중에 결과를 수집합니다. @@ -538,7 +537,7 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod 생성됨 - 실행이 실행 대기열에 접수되었습니다. - 본문: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- 헤더: `X-Comfy-Request-Id`, `Idempotent-Replayed` + 본문: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- 헤더: `X-Comfy-Request-Id`, `Idempotent-Replayed`, `X-Comfy-Router-Dropped-Params` @@ -578,33 +577,33 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod - `X-Comfy-Error-Type`을 확인하세요. `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`만큼 기다린 뒤 같은 키를 재사용하세요. `invalid_input`은 새 키가 필요합니다. 이 라우트의 두 가지 `invalid_input` 충돌은 키와 전혀 무관하며 새 키로도 어느 쪽도 해소되지 않습니다. `model_provider`로 대체 공급자를 지정한 경우, 요청 본문이 그 공급자의 이 모델용 변환기가 처리할 수 없는 멀티파트 작업(편집)을 선택하면 거부되며, `detail`은 "this request's `image` selects the edit operation"으로 시작합니다. 그리고 그 이후에 검사되는 것으로, 요청이 경로에 있는 공급자에 대한 BYOK(bring-your-own-key) 자격 증명을 이미 확인한 경우에도 거부되며, `detail`은 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이 그리고 (멀티파트의 경우) 편집 없이 요청을 보내세요. + `X-Comfy-Error-Type`을 확인하세요: `concurrency_limit_exceeded`는 원본 호출이 아직 실행 중이라는 뜻이므로 `Retry-After`에 지정된 시간만큼 기다린 뒤 동일한 키를 재사용하세요. `invalid_input`은 새 키가 필요하다는 뜻입니다. 이 라우트의 두 가지 `invalid_input` 충돌은 키와 전혀 관련이 없으며, 새 키로도 어느 쪽도 해결되지 않습니다: `model_provider`가 대체 공급자를 지정하는 경우, 요청 본문이 해당 공급자의 이 모델용 변환기가 처리할 수 없는 multipart 작업(편집)을 선택하면 거부되며, 이때 `detail`은 "this request's `image` selects the edit operation"로 시작합니다. 그 이후에 확인되는 경우로, 요청이 경로에 있는 공급자에 대해 이미 BYOK 자격 증명을 확인한 경우에도 거부되며, 이때 `detail`은 `this request resolved a BYOK credential`로 시작합니다. `model_provider`를 제거하거나, BYOK 자격 증명 없이, 그리고 (multipart인 경우) 편집 없이 요청을 보내세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded`인 경우) + 본문: [`RouterErrorResponse`](#routererrorresponse); 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded`일 때) - 요청 내용이 모델의 스키마에 맞지 않아 거부되었습니다. + 요청 내용이 모델의 스키마에 따라 거부되었습니다. - 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` + 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse); 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - `X-Comfy-Error-Type`을 확인하세요. `queue_backlog_full`은 허용된 만큼의 미완료 대기 중 요청을 이미 보유하고 있다는 뜻이므로, 그중 하나가 끝난 뒤 다시 제출하세요. `rate_limited`는 `Retry-After`에 지정된 시간만큼 기다리라는 뜻입니다. + `X-Comfy-Error-Type`을 확인하세요: `queue_backlog_full`은 허용된 개수만큼 아직 끝나지 않은 대기 중 요청을 이미 보유하고 있다는 뜻이므로, 그중 하나가 완료되면 다시 제출하세요. `rate_limited`는 `Retry-After`에 있는 초 수만큼 기다리라는 뜻입니다. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`rate_limited`인 경우) + 본문: [`RouterErrorResponse`](#routererrorresponse); 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`rate_limited`일 때) - Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요. + Router가 일시적으로 사용할 수 없는 상태입니다. 백오프를 두고 재시도하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse). 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부의 경우에만) + 본문: [`RouterErrorResponse`](#routererrorresponse); 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부 시에만) 요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요. - 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse); 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}` @@ -636,7 +635,7 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod **응답** - OK - 결과를 생성한 요청, 즉 성공적으로 완료된 요청이거나 기록된 과금과 저장된 결과를 모두 가진 터미널 요청에 대해 저장된 결과를, 파트너 자체의 미디어 타입으로 변경 없이 반환합니다. 동기 라우트의 `200`이 반환하는 것과 정확히 같으며, 제출이 수락한 것과 동일한 공급자 선택 계약을 따릅니다: `model_provider` 없이, 또는 `model_provider`와 함께 `strict_mode=false`(기본값, 가능한 경우 이 모델의 네이티브 계약으로 다시 변환되고, 변환에 실패하면 대체 공급자의 원시 응답으로 폴백하며 이는 로그에 남고 결코 조용히 넘어가지 않습니다)인 경우 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`이면 변경되지 않은 대체 공급자의 응답입니다. 파트너가 생성 결과를 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type`을 따르는 해당 바이트입니다. 응답의 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. + OK - 결과를 생성한 요청, 즉 성공적으로 완료된 요청이거나 기록된 과금과 저장된 결과를 모두 가진 터미널 요청에 대해 저장된 결과를, 파트너 자체의 미디어 타입으로 변경 없이 반환합니다. 동기 라우트의 `200`이 반환하는 것과 정확히 같으며, 제출이 수락한 것과 동일한 공급자 선택 계약을 따릅니다: `model_provider` 없이, 또는 `model_provider`와 함께 `strict_mode=false`(기본값, 가능한 경우 이 모델의 네이티브 계약으로 다시 변환되고, 변환에 실패하면 대체 공급자의 원시 응답으로 폴백하며 이는 로그에 남고 결코 조용히 넘어가지 않습니다)인 경우 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`이면 대체 공급자의 응답이 변경 없이 반환됩니다. 파트너가 생성 결과를 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type`을 따르는 해당 바이트입니다. 응답의 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. 본문: [`RouterModelOutput`](#routermodeloutput) 또는 원시 바이트 (`*/*`) -- 헤더: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` @@ -672,7 +671,7 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod - `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`초만큼 기다리세요. + `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`만큼 기다리세요. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` @@ -766,7 +765,7 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod - `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`초만큼 기다리세요. + `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`를 기다리세요. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` @@ -842,7 +841,7 @@ Comfy Router의 대기열 전달 모드입니다. 요청 본문은 `POST /v2/mod - `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`초만큼 기다리세요. + `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`만큼 기다리십시오. 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index 351d18613a..3f054dd929 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -2,20 +2,20 @@ title: "Comfy Router 的能力与限制" sidebarTitle: "能力与限制" description: "选择 Comfy Router 还是合作伙伴代理,为长时间运行的调用做好规划,并了解恢复、速率限制与资产存储。" -translationSourceHash: a81b3bd9 +translationSourceHash: 04575573 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 "What Router supports": 2cc63403 - "Queued submission": d0798008 + "Queued submission": bcbb1f7c "Calls are cut off at a server deadline": c8724f59 "Recovery depends on the provider": da9d8904 "Request bodies are capped": 675b77c8 "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": e7d7524a - "Router does not cover every partner operation": 786c0fb2 + "Models without a pre-flight estimate": 789d46e5 + "Router does not cover every partner operation": 11621b39 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -31,6 +31,8 @@ translationBlockHashes: + + Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个已排队的请求运行:你提交请求,稍后再收集结果。当你的应用能够等待一个已完成的结果,或稍后收集结果,并且能够处理模型自身的输入和输出字段时,就使用它。 ## Router 支持的功能 @@ -49,13 +51,15 @@ Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个 ## 队列提交 -同步路由在模型运行期间会一直保持连接;对于异步提供商,Router 会提交任务并在内部轮询。排队式投递(提交、获取 `request_id`、轮询、收集)则是另一种选择:参见[队列投递](/zh/development/comfy-router/queue)。它的作用域限定在凭据所属的工作区内,因此需要使用在你的 Comfy 工作区中创建的密钥。没有工作区的传统密钥、自带密钥的请求,或队列无法运行的模型,都会在提交路由上返回 `403` 和 `not_enabled`。两种模式都不提供回调或 webhook。 +同步路由会在模型运行期间保持连接;对于异步提供商,Router 会提交任务并在内部轮询。队列投递(提交、获取 `request_id`、轮询、收集)是另一种选择:参见[队列投递](/zh/development/comfy-router/queue)。它的作用域限定在凭据所属的工作区内,因此需要使用在你的 Comfy 工作区中创建的密钥。没有工作区的传统密钥、自带密钥的请求,或队列无法运行的模型,都会在提交路由上返回 `403` 和 `not_enabled`。两种模式都不提供回调或 webhook。 -如果你的请求无法保持打开足够长的时间,就把它放入队列。当你需要使用提供商自己的提交与轮询控制时,请使用[合作伙伴代理](#router-并不覆盖每一项合作伙伴操作)。 +如果你的请求无法保持连接足够长的时间,就将其加入队列。当你需要使用提供商自己的提交与轮询控制时,请使用[合作伙伴代理](#router-并不覆盖所有合作伙伴操作)。 目前有四个模型仅支持同步方式,若将它们提交到队列,会被以 `403` / `not_enabled` 拒绝:`elevenlabs/eleven_sfx_v2`、`elevenlabs/eleven_v3`、`elevenlabs/eleven_v4` 和 `elevenlabs/eleven_v4_turbo`。它们返回的是原始音频字节,而不是 JSON 结果文档,队列投递无处存储这些内容。请在同步路由上运行它们,该路由会正常返回这些字节。 -LTX v1 的文生视频和图生视频操作出于同样的原因返回原始视频字节,队列投递同样无法存储它们,但它们只能通过位于 `/proxy/ltx/v1/…` 的[合作伙伴代理](#router-并不覆盖每一项合作伙伴操作)访问,而不能通过 Router 模型 ID 访问:每个 `ltx/*` 目录模型都会解析为可排队的 v2 提交与轮询操作。 +有四个模型仅支持队列方式,在同步路由上会被以 `403` / `not_enabled` 拒绝:`ltx/ltx-video-alpha-gen`、`ltx/ltx-video-to-video-hdr`、`ltx/ltx-video-to-video-reframe` 和 `ltx/ltx-video-upscale`。它们的任务持续时间可能超过同步调用保持连接的时间。将相同的请求体提交到 `POST /v2/models/ltx/{model}/requests`,然后从队列中收集结果。 + +LTX v1 的文生视频和图生视频操作出于同样的原因返回原始视频字节,队列投递同样无法存储它们,但它们只能通过位于 `/proxy/ltx/v1/…` 的[合作伙伴代理](#router-并不覆盖所有合作伙伴操作)访问,而不能通过 Router 模型 ID 访问:每个 `ltx/*` 目录模型都会解析为可加入队列的 v2 提交与轮询操作。 ## 调用会在服务器截止时间被中断 @@ -123,34 +127,41 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kelly**: `kelly/kelly-seedance-2.0`, `kelly/kelly-seedance-2.0-fast`, `kelly/kelly-seedance-2.5` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` +- **ltx**: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe`, `ltx/ltx-video-upscale` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` +- **pixverse**: `pixverse/v3.5`, `pixverse/v6`, `pixverse/v6-max` +- **quiver**: `quiver/arrow-2`, `quiver/arrow-2-telos` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` - **synclabs**: `synclabs/sync-3` +- **veed**: `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` - **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} 对 `openai/gpt-image-2`、`openai/gpt-image-2.5-flare`、`openai/gpt-image-2.5-sunburst`、`openai/gpt-image-2.6-flare` 和 `openai/gpt-image-2.6-sunburst` 的编辑操作同样没有预先估算。对这些模型发起编辑调用,或发起携带输入图像的生成调用,都会返回 `source: unknown`。对它们发起仅含文本的生成调用则可以估算,这就是它们未出现在上述列表中的原因。 -## Router 并不覆盖每一项合作伙伴操作 +## Router 并不覆盖所有合作伙伴操作 -Router 负责运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由,这些路由处在 Router 之外,Router 的契约也不涵盖它们。Router 自身对外提供的接口以 [Comfy Router 规范](/router-openapi.yaml) 为准;支持情况因提供商而异。 +Router 运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由,这些路由不在 Router 范围内,其契约也未描述它们。Router 自身的接口面是 [Comfy Router 规范](/zh/router-openapi.yaml);支持情况因提供商而异。 -### Krea 3 参考图像:先上传,或使用公共 https URL +### Krea 3 参考图像:先上传,或使用公开的 https 网址 -在 `krea/krea-3` 的 `image_urls` 中,由 `POST /proxy/krea/assets` 返回的 `image_url`(即 `https://app-uploads.krea.ai/...` 形式的 URL)始终会被接受。其他链接是否被接受取决于环境;在 api.comfy.org 上,目前是接受的。 +在 `krea/krea-3` 的 `image_urls` 中,由 `POST /proxy/krea/assets` 返回的 `image_url`(一个 `https://app-uploads.krea.ai/...` 网址)始终会被接受。其他链接是否被接受取决于环境;在 api.comfy.org 上目前是接受的。超过 8 个条目会在任何抓取发生之前,被请求的 schema 校验以 `422` 拒绝。 -- **在接受其他链接的环境中**,任何公共 `https` 图片网址都可以使用。Router 会在模型运行前读取每张图像的尺寸:主机无法公开访问或不存在、返回除 `408` 或 `429` 之外的 `4xx`、或者本身并非图像的链接,会被拒绝并返回 `400` `invalid_input`,同时指出其主机名。临时的 DNS、TLS 或连接故障、超时,或源站返回 `408` 或 `429`,会以 `502` 错误失败。并非有效上传的 `app-uploads.krea.ai` 链接,会像其他任何无法访问的引用一样被拒绝并返回 `400`。服务器刚启动之后、尚未确定适用哪条规则之前,不是 `app-uploads.krea.ai` 链接的公共 `https` URL 可能会失败并返回 `503`,该错误可以安全重试。 -- **在不接受其他链接的环境中**,每一项都必须是某次上传得到的 `image_url`。Router 只检查该链接能否解析为 `https` URL,且其主机名恰好是 `app-uploads.krea.ai`(不能是其他主机,也不能带显式端口):任何其他链接,包括你自己托管的公共 `https` URL,都会在模型运行前被拒绝并返回 `400` `invalid_input`。通过了该检查但并非有效上传(已过期、已删除或输入有误)的链接仍会通过,随后 Router 无法读取图像尺寸,并返回 `5xx` 错误,而不是 `400`。 +- **在其他链接被接受的环境中**,任何公开的 `https` 图像网址都可以使用。Router 会在模型运行之前自行抓取每个参考,以读取其大小。需要修复的参考会被拒绝,返回 `400` `invalid_input` 并指明其主机:不存在或无法公开访问的主机、以 `4xx`(`408` 或 `429` 除外)响应的源、重定向过多、重定向到非 `https` 的链接或无法公开访问的主机、内容不是受支持的图像、没有长度信息且在图像大小头部之前就结束的响应,或者大小头部不在前 2 MiB 之内的图像(见下文)。任何其他抓取失败则是 `5xx` 错误(Router 上为 `500` `internal_error`)。其中有些会自行消失(DNS 解析器错误、超时、连接中断、以 `5xx`、`408` 或 `429` 响应的源,或者在 Router 的主机检查与其建立连接之间 DNS 应答切换为非公开地址的主机,重试时可能成功,也可能因主机非公开而被 `400` 拒绝),因此请稍后重试。其他错误则每次都同样失败,例如抓取不信任的 TLS 证书(自签名、已过期或主机名不匹配),或者以 `200` 以外的 `2xx` 响应的源,或抓取不会跟随的 `3xx`(例如 `204`、`206`、`300`、`304` 或 `305`,或者没有 `Location` 的 `301`、`302`、`303`、`307` 或 `308`)。如果重试仍以同样方式失败,请先上传图像。通过 `POST /v2/models/krea/krea-3/requests` 排队的请求,当其任何链接不是 `app-uploads.krea.ai` 链接时,遇到此类 `5xx` 不会重试,因此如果原因可以消失,请自行重新提交。不是有效上传的 `app-uploads.krea.ai` 链接会像其他任何不可达的参考一样被 `400` 拒绝。已排队请求的 `400` 只带有通用的 `invalid_input` 详情,因此不会指明主机,队列也不会重试它。已排队的 `400` 可能来自任何字段,而不只是 `image_urls`(例如不受支持的 `resolution` 或 `thinking_mode`),因此请先检查其他字段。如果它们有效,请用 `POST /proxy/krea/assets` 上传每张图像,并用这些 `image_url` 值以及新的 `Idempotency-Key`(或不用)重新提交:用更改后的请求体复用该键会被 `409` `invalid_input` 拒绝,这并不能说明图像有什么问题;用相同请求体复用它则返回 `201` 以及原始的 `request_id` 和 `Idempotent-Replayed: true`,因此不会启动新的运行,其结果网址(`GET /v2/models/krea/krea-3/requests/{request_id}`)返回同样的 `400`(其状态网址返回 `200`,`error_type` 为 `invalid_input`)。如果该次重新提交也以 `400` 失败,那么问题出在图像本身(例如它不是受支持的图像,或其大小头部不在前 2 MiB 之内)。 +- **在其他链接不被接受的环境中**,每个条目都必须是某次上传的 `image_url`。Router 只检查该链接是否解析为 `https` 网址,且其主机恰好是 `app-uploads.krea.ai`(不允许其他主机,也不允许显式端口):任何其他链接,包括你自己托管的公开 `https` 网址,都会在模型运行之前被 `400` `invalid_input` 拒绝,提示 “image_urls must be image_url values returned by POST /proxy/krea/assets”,因此请改为上传图像。通过该检查但并非有效上传的链接(已过期、已删除或输入有误)仍能通过检查,随后 Router 读取图像大小失败,会返回 `5xx` 错误而不是 `400`。Router 无法读取的上传图像(例如它不是受支持的图像,或其大小头部不在前 2 MiB 之内)在这里也会以 `5xx`(Router 上为 `500` `internal_error`)失败,而不是 `400`,问题仍出在图像本身,因此重新上传也无济于事。 +- **服务器刚刚启动之后**,在它得知适用哪条规则之前,任何不是 `app-uploads.krea.ai` 链接的 `https` 网址都可能以 `503`(Router 上为 `service_unavailable`)失败,该错误可以安全重试(已排队的请求会自动重试)。 -上传在所有环境中都可用,因此是可移植的选择;请始终原样传入上传返回的 `image_url`。 +Router 只读取每个参考的前 2 MiB 来查找其大小,因此如果某张图像的大小信息无法在该窗口内读取完(例如一个 JPEG 携带超过 2 MiB 的嵌入元数据,或一个调色板 PNG,其透明度数据,或在没有透明度数据时其第一个图像数据块的起始位置,位于 2 MiB 之后,比如在超过 2 MiB 的文本块或颜色配置文件块之后),就会被 `400` 拒绝,提示其大小头部不在前 2 MiB 之内,上传它也无济于事:请先在不含大型元数据的情况下重新保存它,或者把调色板 PNG 保存为非调色板(真彩色)PNG。国际化主机名请用其 ASCII(punycode)形式发送,例如 `xn--bcher-kva.de` 而不是 `bücher.de`:Router 会按原样查询主机,非 ASCII 名称会被当作不存在的主机拒绝。 -1. 将每张参考图像以 `multipart/form-data` 上传,图像放在表单字段 `file` 中(JPEG、PNG 或 WebP,最大 75 MB)。使用与 Router 相同的方式进行身份验证,即使用 `X-API-Key` 或 `Authorization: Bearer`。 +上传在每个环境中都可用,因此它是可移植的选择;请始终按上传返回的原样传入 `image_url`。如果你的图像还不在公开的 `https` 网址上,请先上传它:1. 将每张参考图像以 `multipart/form-data` 上传,图像放在表单字段 `file` 中(JPEG、PNG 或 WebP,最大 75 MB)。使用与 Router 相同的方式进行身份验证,即通过 `X-API-Key` 或 `Authorization: Bearer`。 ```bash curl -X POST https://api.comfy.org/proxy/krea/assets \ @@ -158,7 +169,7 @@ Router 负责运行模型。文件上传、账户读取、资产管理、流式 -F "file=@reference.png" ``` -2. 从 JSON 响应中读取 `image_url`,并将其传入 `image_urls`: +2. 从 JSON 响应中读取 `image_url`,并在 `image_urls` 中传入: ```json { diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index ae9eb4d5d7..e37c105668 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -2,27 +2,27 @@ title: "Comfy Router 模型" sidebarTitle: "所有模型" description: "Comfy Router 提供的全部模型,按提供方分组,并列出每个模型的输入和输出模态。" -translationSourceHash: df7e65a1 +translationSourceHash: 4bd95744 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 4d100975 + "Find by output": 23c1048d "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 - "BytePlus": 0767a672 + "BytePlus": 97340104 "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 "Gemini Interactions": 38163caf - "Google": 4932820b + "Google": 77d668ec "HeyGen": 76fe1a0d "Higgsfield": 0ce2b918 "Ideogram": c22a0e5e "Kling": aec38bcd "Krea": 16b83e5e - "LTX": 32595bf9 + "LTX": 413dd527 "Luma": 8cd2a7ce "Luma 2": 585eb637 "Meshy": 67e26a17 @@ -31,7 +31,9 @@ translationBlockHashes: "OpenAI": 8652024f "Openrouter": a4f6806b "Pika": 0cc24098 + "Pixverse": 195092d8 "Pruna": 903d76ee + "Quiver": 34eaad49 "Qwen": b3ef78a1 "Recraft": 02b7d9cd "Runway": be098f8c @@ -50,6 +52,7 @@ translationBlockHashes: + {/* 已生成文件。由 `pnpm code-pages:gen` 从 Router 目录生成。 */} 以下每个模型都由同一条路由提供服务:`POST /v2/models/{provider}/{model}`,并使用该模型自身的 JSON 请求体。每个页面都会展示在 Python、TypeScript 和 cURL 中可用的请求示例。关于模型发现、schema、错误、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api)。 @@ -59,121 +62,126 @@ translationBlockHashes: ## 按输出查找 - - -- [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code):`beeble/switchx` -- [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code):`bfl/flux-3-video` -- [FLUX Video Upscale](/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code):`bfl/video-upscale-v1` -- [Video Edit V1](/zh/development/comfy-router/models/black-forest-labs/video-edit-v1/code):`bfl/video-edit-v1` -- [Video Edit Erase](/zh/development/comfy-router/models/bria/video-edit-erase/code):`bria/video-edit-erase` -- [Video Edit Green Screen](/zh/development/comfy-router/models/bria/video-edit-green-screen/code):`bria/video-edit-green-screen` -- [Video Edit Remove Background](/zh/development/comfy-router/models/bria/video-edit-remove-background/code):`bria/video-edit-remove-background` -- [Video Edit Replace Background](/zh/development/comfy-router/models/bria/video-edit-replace-background/code):`bria/video-edit-replace-background` -- [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code):`byteplus/dreamina-seedance-2-0-260128` -- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code):`byteplus/dreamina-seedance-2-0-fast-260128` -- [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code):`byteplus/dreamina-seedance-2-0-mini` -- [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code):`byteplus/dreamina-seedance-2-5-260628` -- [Seedance 1.0 Pro 250528](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code):`byteplus/seedance-1-0-pro-250528` -- [Seedance 1.0 Pro Fast 251015](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code):`byteplus/seedance-1-0-pro-fast-251015` -- [Seedance 1.5 Pro 251215](/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code):`byteplus/seedance-1-5-pro-251215` -- [Crystal Video Upscaler](/zh/development/comfy-router/models/fal/crystal-video-upscaler/code):`fal/crystal-video-upscaler` -- [FLUX 3 Max](/zh/development/comfy-router/models/fal/flux-3-max/code):`fal/flux-3-max` -- [H3 Max Turbo](/zh/development/comfy-router/models/fal/h3-max-turbo/code):`fal/h3-max-turbo` -- [H3 Max](/zh/development/comfy-router/models/fal/h3-max/code):`fal/h3-max` -- [Gemini Omni 1.2 Flash](/zh/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code):`gemini-interactions/gemini-omni-1.2-flash` -- [Higgsfield Genjutsu Motion Transfer V1.0](/zh/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code):`higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` -- [Higgsfield Kling 3.4k](/zh/development/comfy-router/models/higgsfield/higgsfield-kling-3-4k/code):`higgsfield/higgsfield-kling-3-4k` -- [Higgsfield Kling 3 Pro](/zh/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code):`higgsfield/higgsfield-kling-3-pro` -- [Kling 3.0 Turbo](/zh/development/comfy-router/models/kling/kling-3-0-turbo/code):`kling/kling-3.0-turbo` -- [Kling 4.0](/zh/development/comfy-router/models/kling/kling-4-0/code):`kling/kling-4.0` -- [Kling V2.5 Turbo](/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code):`kling/kling-v2-5-turbo` -- [Kling V2.6](/zh/development/comfy-router/models/kling/kling-v2-6/code):`kling/kling-v2-6` -- [Kling V3 Omni](/zh/development/comfy-router/models/kling/kling-v3-omni/code):`kling/kling-v3-omni` -- [Kling V3](/zh/development/comfy-router/models/kling/kling-v3/code):`kling/kling-v3` -- [Kling Video O1](/zh/development/comfy-router/models/kling/kling-video-o1/code):`kling/kling-video-o1` -- [Videos Avatar Image 2video](/zh/development/comfy-router/models/kling/videos-avatar-image2video/code):`kling/videos-avatar-image2video` -- [Videos Lip Sync](/zh/development/comfy-router/models/kling/videos-lip-sync/code):`kling/videos-lip-sync` -- [LTX 2.5 Fast](/zh/development/comfy-router/models/ltx/ltx-2-5-fast/code):`ltx/ltx-2-5-fast` -- [LTX 2.5 Pro](/zh/development/comfy-router/models/ltx/ltx-2-5-pro/code):`ltx/ltx-2-5-pro` -- [Ray 3.2](/zh/development/comfy-router/models/luma_2/ray-3-2/code):`luma_2/ray-3.2` -- [MiniMax H3](/zh/development/comfy-router/models/minimax/minimax-h3/code):`minimax/minimax-h3` -- [Image To Video](/zh/development/comfy-router/models/moonvalley/image-to-video/code):`moonvalley/image-to-video` -- [Text To Video](/zh/development/comfy-router/models/moonvalley/text-to-video/code):`moonvalley/text-to-video` -- [Video To Video](/zh/development/comfy-router/models/moonvalley/video-to-video/code):`moonvalley/video-to-video` -- [Pika 2.5 Image To Video](/zh/development/comfy-router/models/pika/pika-2-5-image-to-video/code):`pika/pika-2.5-image-to-video` -- [Pika 2.5 Text To Video](/zh/development/comfy-router/models/pika/pika-2-5-text-to-video/code):`pika/pika-2.5-text-to-video` -- [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code):`pika/pika-h3-flex-image-to-video` -- [Pika H3 Flex Reference To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code):`pika/pika-h3-flex-reference-to-video` -- [Pika H3 Flex Text To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code):`pika/pika-h3-flex-text-to-video` -- [Pika Soundtrack](/zh/development/comfy-router/models/pika/pika-soundtrack/code):`pika/pika-soundtrack` -- [P Video 2](/zh/development/comfy-router/models/pruna/p-video-2/code):`pruna/p-video-2` -- [Aleph 2](/zh/development/comfy-router/models/runway/aleph2/code):`runway/aleph2` -- [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code):`runway/gen4_turbo` -- [Sync 3](/zh/development/comfy-router/models/synclabs/sync-3/code):`synclabs/sync-3` -- [Clean Audio Video](/zh/development/comfy-router/models/veed/clean-audio-video/code):`veed/clean-audio-video` -- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code):`veed/fabric-1.0` -- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` -- [Video Background Removal Fast](/zh/development/comfy-router/models/veed/video-background-removal-fast/code):`veed/video-background-removal-fast` -- [Video Background Removal Green Screen](/zh/development/comfy-router/models/veed/video-background-removal-green-screen/code):`veed/video-background-removal-green-screen` -- [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal` -- [Veo 3.1 Fast Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code):`veo/veo-3.1-fast-generate-001` -- [Veo 3.1 Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code):`veo/veo-3.1-generate-001` -- [Veo 3.1 Lite Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code):`veo/veo-3.1-lite-generate-001` -- [HappyHorse 1.0 I2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code):`wan/happyhorse-1.0-i2v` -- [HappyHorse 1.0 R2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code):`wan/happyhorse-1.0-r2v` -- [HappyHorse 1.0 T2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code):`wan/happyhorse-1.0-t2v` -- [HappyHorse 1.0 视频编辑](/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code):`wan/happyhorse-1.0-video-edit` -- [HappyHorse 1.1 I2V](/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code):`wan/happyhorse-1.1-i2v` -- [HappyHorse 1.1 R2V](/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code):`wan/happyhorse-1.1-r2v` -- [HappyHorse 1.1 T2V](/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code):`wan/happyhorse-1.1-t2v` -- [Wan 2.5 I2V 预览](/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code):`wan/wan2.5-i2v-preview` -- [Wan 2.5 T2V 预览](/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code):`wan/wan2.5-t2v-preview` -- [Wan 2.6 I2V](/zh/development/comfy-router/models/wan/wan2-6-i2v/code):`wan/wan2.6-i2v` -- [Wan 2.6 R2V](/zh/development/comfy-router/models/wan/wan2-6-r2v/code):`wan/wan2.6-r2v` -- [Wan 2.6 T2V](/zh/development/comfy-router/models/wan/wan2-6-t2v/code):`wan/wan2.6-t2v` -- [Wan 2.7 I2V](/zh/development/comfy-router/models/wan/wan2-7-i2v/code):`wan/wan2.7-i2v` -- [Wan 2.7 R2V](/zh/development/comfy-router/models/wan/wan2-7-r2v/code):`wan/wan2.7-r2v` -- [Wan 2.7 T2V](/zh/development/comfy-router/models/wan/wan2-7-t2v/code):`wan/wan2.7-t2v` -- [Wan 2.7 视频编辑](/zh/development/comfy-router/models/wan/wan2-7-videoedit/code):`wan/wan2.7-videoedit` -- [Wan 3.0 Video Prime](/zh/development/comfy-router/models/wan/wan3-0-video-prime/code):`wan/wan3.0-video-prime` -- [Wan 3.0 视频](/zh/development/comfy-router/models/wan/wan3-0-video/code):`wan/wan3.0-video` -- [Flashvsr](/zh/development/comfy-router/models/wavespeed/flashvsr/code):`wavespeed/flashvsr` -- [Grok Imagine Video 1.5 Lite](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code):`xai/grok-imagine-video-1.5-lite` -- [Grok Imagine Video 1.5 预览](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code):`xai/grok-imagine-video-1.5-preview` -- [Grok Imagine Video 1.5](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5/code):`xai/grok-imagine-video-1.5` -- [Grok Imagine Video](/zh/development/comfy-router/models/xai/grok-imagine-video/code):`xai/grok-imagine-video` + + +- [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` +- [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` +- [FLUX Video Upscale](/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code): `bfl/video-upscale-v1` +- [Video Edit V1](/zh/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1` +- [Video Edit Erase](/zh/development/comfy-router/models/bria/video-edit-erase/code): `bria/video-edit-erase` +- [Video Edit Green Screen](/zh/development/comfy-router/models/bria/video-edit-green-screen/code): `bria/video-edit-green-screen` +- [Video Edit Remove Background](/zh/development/comfy-router/models/bria/video-edit-remove-background/code): `bria/video-edit-remove-background` +- [Video Edit Replace Background](/zh/development/comfy-router/models/bria/video-edit-replace-background/code): `bria/video-edit-replace-background` +- [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code): `byteplus/dreamina-seedance-2-0-260128` +- [Dreamina Seedance 2.0 Fast 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code): `byteplus/dreamina-seedance-2-0-fast-260128` +- [Dreamina Seedance 2.0 Mini](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code): `byteplus/dreamina-seedance-2-0-mini` +- [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` +- [Seedance 1.0 Pro 250528](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code): `byteplus/seedance-1-0-pro-250528` +- [Seedance 1.0 Pro Fast 251015](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code): `byteplus/seedance-1-0-pro-fast-251015` +- [Crystal Video Upscaler](/zh/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` +- [FLUX 3 Max](/zh/development/comfy-router/models/fal/flux-3-max/code): `fal/flux-3-max` +- [H3 Max Turbo](/zh/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo` +- [H3 Max](/zh/development/comfy-router/models/fal/h3-max/code): `fal/h3-max` +- [Gemini Omni 1.2 Flash](/zh/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code): `gemini-interactions/gemini-omni-1.2-flash` +- [Higgsfield Genjutsu Motion Transfer V1.0](/zh/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code): `higgsfield/higgsfield-genjutsu-motion-transfer-v1.0` +- [Higgsfield Kling 3.4k](/zh/development/comfy-router/models/higgsfield/higgsfield-kling-3-4k/code): `higgsfield/higgsfield-kling-3-4k` +- [Higgsfield Kling 3 Pro](/zh/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` +- [Kling 3.0 Turbo](/zh/development/comfy-router/models/kling/kling-3-0-turbo/code): `kling/kling-3.0-turbo` +- [Kling 4.0](/zh/development/comfy-router/models/kling/kling-4-0/code): `kling/kling-4.0` +- [Kling V2.5 Turbo](/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code): `kling/kling-v2-5-turbo` +- [Kling V2.6](/zh/development/comfy-router/models/kling/kling-v2-6/code): `kling/kling-v2-6` +- [Kling V3 Omni](/zh/development/comfy-router/models/kling/kling-v3-omni/code): `kling/kling-v3-omni` +- [Kling V3](/zh/development/comfy-router/models/kling/kling-v3/code): `kling/kling-v3` +- [Kling Video O1](/zh/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1` +- [Videos Avatar Image 2video](/zh/development/comfy-router/models/kling/videos-avatar-image2video/code): `kling/videos-avatar-image2video` +- [Videos Lip Sync](/zh/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` +- [LTX 2.5 Fast](/zh/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` +- [LTX 2.5 Pro](/zh/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` +- [LTX Video Alpha Gen](/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code): `ltx/ltx-video-alpha-gen` +- [LTX Video To Video Hdr](/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code): `ltx/ltx-video-to-video-hdr` +- [LTX Video To Video Reframe](/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code): `ltx/ltx-video-to-video-reframe` +- [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code): `ltx/ltx-video-upscale` +- [Ray 3.2](/zh/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` +- [MiniMax H3](/zh/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` +- [Image To Video](/zh/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` +- [Text To Video](/zh/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` +- [Video To Video](/zh/development/comfy-router/models/moonvalley/video-to-video/code): `moonvalley/video-to-video` +- [Pika 2.5 Image To Video](/zh/development/comfy-router/models/pika/pika-2-5-image-to-video/code): `pika/pika-2.5-image-to-video` +- [Pika 2.5 Text To Video](/zh/development/comfy-router/models/pika/pika-2-5-text-to-video/code): `pika/pika-2.5-text-to-video` +- [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` +- [Pika H3 Flex Reference To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` +- [Pika H3 Flex Text To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` +- [Pika Soundtrack](/zh/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` +- [V3.5](/zh/development/comfy-router/models/pixverse/v3-5/code): `pixverse/v3.5` +- [V6 Max](/zh/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max`- [V6](/zh/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` +- [P Video 2](/zh/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` +- [Aleph 2](/zh/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` +- [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` +- [Sync 3](/zh/development/comfy-router/models/synclabs/sync-3/code): `synclabs/sync-3` +- [Clean Audio Video](/zh/development/comfy-router/models/veed/clean-audio-video/code): `veed/clean-audio-video` +- [Fabric 1.0](/zh/development/comfy-router/models/veed/fabric-1-0/code): `veed/fabric-1.0` +- [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` +- [Video Background Removal Fast](/zh/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` +- [Video Background Removal Green Screen](/zh/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` +- [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` +- [Veo 3.1 Fast Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` +- [Veo 3.1 Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` +- [Veo 3.1 Lite Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` +- [HappyHorse 1.0 I2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` +- [HappyHorse 1.0 R2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code): `wan/happyhorse-1.0-r2v` +- [HappyHorse 1.0 T2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code): `wan/happyhorse-1.0-t2v` +- [HappyHorse 1.0 Video Edit](/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code): `wan/happyhorse-1.0-video-edit` +- [HappyHorse 1.1 I2V](/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code): `wan/happyhorse-1.1-i2v` +- [HappyHorse 1.1 R2V](/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code): `wan/happyhorse-1.1-r2v` +- [HappyHorse 1.1 T2V](/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code): `wan/happyhorse-1.1-t2v` +- [Wan 2.5 I2V Preview](/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code): `wan/wan2.5-i2v-preview` +- [Wan 2.5 T2V Preview](/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` +- [Wan 2.6 I2V](/zh/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` +- [Wan 2.6 R2V](/zh/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` +- [Wan 2.6 T2V](/zh/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` +- [Wan 2.7 I2V](/zh/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.7 R2V](/zh/development/comfy-router/models/wan/wan2-7-r2v/code): `wan/wan2.7-r2v` +- [Wan 2.7 T2V](/zh/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` +- [Wan 2.7 Video Edit](/zh/development/comfy-router/models/wan/wan2-7-videoedit/code): `wan/wan2.7-videoedit` +- [Wan 3.0 Video Prime](/zh/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` +- [Wan 3.0 Video](/zh/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` +- [Flashvsr](/zh/development/comfy-router/models/wavespeed/flashvsr/code): `wavespeed/flashvsr` +- [Grok Imagine Video 1.5 Lite](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5-lite/code): `xai/grok-imagine-video-1.5-lite` +- [Grok Imagine Video 1.5 Preview](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code): `xai/grok-imagine-video-1.5-preview` +- [Grok Imagine Video 1.5](/zh/development/comfy-router/models/xai/grok-imagine-video-1-5/code): `xai/grok-imagine-video-1.5` +- [Grok Imagine Video](/zh/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - - -- [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code):`beeble/switchx` -- [Erase V1](/zh/development/comfy-router/models/black-forest-labs/erase-v1/code):`bfl/erase-v1` -- [Flux 1.1 Pro Ultra 图像](/zh/development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code):`bfl/flux-pro-1.1-ultra` -- [FLUX.1 Kontext](/zh/development/comfy-router/models/black-forest-labs/flux-1-kontext/code):`bfl/flux-kontext-pro` -- [FLUX 2 Max](/zh/development/comfy-router/models/black-forest-labs/flux-2-max/code):`bfl/flux-2-max` -- [FLUX 2 Pro](/zh/development/comfy-router/models/black-forest-labs/flux-2-pro/code):`bfl/flux-2-pro` -- [FLUX 3 图像](/zh/development/comfy-router/models/black-forest-labs/flux-3-image/code):`bfl/flux-3-image` -- [FLUX Pro 1.0 展开](/zh/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code):`bfl/flux-pro-1.0-expand` -- [FLUX Pro 1.0 Fill](/zh/development/comfy-router/models/black-forest-labs/flux-pro-1-0-fill/code):`bfl/flux-pro-1.0-fill` -- [VTO V1](/zh/development/comfy-router/models/black-forest-labs/vto-v1/code):`bfl/vto-v1` -- [Fibo](/zh/development/comfy-router/models/bria/fibo/code):`bria/fibo` -- [图像编辑:按文本添加对象](/zh/development/comfy-router/models/bria/image-edit-add-object-by-text/code):`bria/image-edit-add-object-by-text` -- [图像编辑:按文本擦除](/zh/development/comfy-router/models/bria/image-edit-erase-by-text/code):`bria/image-edit-erase-by-text` -- [图像编辑:擦除前景](/zh/development/comfy-router/models/bria/image-edit-erase-foreground/code):`bria/image-edit-erase-foreground` -- [图像编辑:擦除](/zh/development/comfy-router/models/bria/image-edit-erase/code):`bria/image-edit-erase` -- [图像编辑:展开](/zh/development/comfy-router/models/bria/image-edit-expand/code):`bria/image-edit-expand` -- [图像编辑:生成式填充](/zh/development/comfy-router/models/bria/image-edit-gen-fill/code):`bria/image-edit-gen-fill` -- [图像编辑:提升分辨率](/zh/development/comfy-router/models/bria/image-edit-increase-resolution/code):`bria/image-edit-increase-resolution` -- [图像编辑:产品手持](/zh/development/comfy-router/models/bria/image-edit-product-holding/code):`bria/image-edit-product-holding` -- [图像编辑:产品虚拟试穿](/zh/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code):`bria/image-edit-product-virtual-tryon` -- [图像编辑:重新打光](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight` -- [图像编辑:移除背景(引导)](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` -- [图像编辑:移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background/code):`bria/image-edit-remove-background` -- [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background` -- [图像编辑:按文本替换对象](/zh/development/comfy-router/models/bria/image-edit-replace-object-by-text/code):`bria/image-edit-replace-object-by-text` -- [图像编辑:Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` -- [图像编辑:恢复](/zh/development/comfy-router/models/bria/image-edit-restore/code):`bria/image-edit-restore` -- [图像](/zh/development/comfy-router/models/bria/image/code):`bria/image` + + +- [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` +- [Erase V1](/zh/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` +- [Flux 1.1 Pro Ultra Image](/zh/development/comfy-router/models/black-forest-labs/flux-1-1-pro-ultra-image/code): `bfl/flux-pro-1.1-ultra` +- [FLUX.1 Kontext](/zh/development/comfy-router/models/black-forest-labs/flux-1-kontext/code): `bfl/flux-kontext-pro` +- [FLUX 2 Max](/zh/development/comfy-router/models/black-forest-labs/flux-2-max/code): `bfl/flux-2-max` +- [FLUX 2 Pro](/zh/development/comfy-router/models/black-forest-labs/flux-2-pro/code): `bfl/flux-2-pro` +- [FLUX 3 Image](/zh/development/comfy-router/models/black-forest-labs/flux-3-image/code): `bfl/flux-3-image` +- [FLUX Pro 1.0 Expand](/zh/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code): `bfl/flux-pro-1.0-expand` +- [FLUX Pro 1.0 Fill](/zh/development/comfy-router/models/black-forest-labs/flux-pro-1-0-fill/code): `bfl/flux-pro-1.0-fill` +- [VTO V1](/zh/development/comfy-router/models/black-forest-labs/vto-v1/code): `bfl/vto-v1` +- [Fibo](/zh/development/comfy-router/models/bria/fibo/code): `bria/fibo` +- [Image Edit Add Object By Text](/zh/development/comfy-router/models/bria/image-edit-add-object-by-text/code): `bria/image-edit-add-object-by-text` +- [Image Edit Erase By Text](/zh/development/comfy-router/models/bria/image-edit-erase-by-text/code): `bria/image-edit-erase-by-text` +- [Image Edit Erase Foreground](/zh/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` +- [Image Edit Erase](/zh/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` +- [Image Edit Expand](/zh/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` +- [Image Edit Gen Fill](/zh/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` +- [Image Edit Increase Resolution](/zh/development/comfy-router/models/bria/image-edit-increase-resolution/code):`bria/image-edit-increase-resolution` +- [Image Edit Product Holding](/zh/development/comfy-router/models/bria/image-edit-product-holding/code):`bria/image-edit-product-holding` +- [Image Edit Product Virtual Tryon](/zh/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code):`bria/image-edit-product-virtual-tryon` +- [Image Edit Relight](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight` +- [Image Edit Remove Background Guided](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` +- [Image Edit Remove Background](/zh/development/comfy-router/models/bria/image-edit-remove-background/code):`bria/image-edit-remove-background` +- [Image Edit Replace Background](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background` +- [Image Edit Replace Object By Text](/zh/development/comfy-router/models/bria/image-edit-replace-object-by-text/code):`bria/image-edit-replace-object-by-text` +- [Image Edit Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` +- [Image Edit Restore](/zh/development/comfy-router/models/bria/image-edit-restore/code):`bria/image-edit-restore` +- [Image](/zh/development/comfy-router/models/bria/image/code):`bria/image` - [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code):`byteplus/seedream-4-0-250828` - [Seedream 4.5 251128](/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code):`byteplus/seedream-4-5-251128` - [Seedream 5.0 260128](/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code):`byteplus/seedream-5-0-260128` @@ -187,7 +195,7 @@ translationBlockHashes: - [AI Skin Enhancer Faithful](/zh/development/comfy-router/models/freepik/ai-skin-enhancer-faithful/code):`freepik/ai-skin-enhancer-faithful` - [AI Skin Enhancer Flexible](/zh/development/comfy-router/models/freepik/ai-skin-enhancer-flexible/code):`freepik/ai-skin-enhancer-flexible` - [Gemini Omni 1.1 Flash](/zh/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code):`gemini-interactions/gemini-omni-1.1-flash` -- [Gemini Omni Flash 预览](/zh/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code):`gemini-interactions/gemini-omni-flash-preview` +- [Gemini Omni Flash Preview](/zh/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code):`gemini-interactions/gemini-omni-flash-preview` - [Gemini 2.5 Flash Image](/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code):`vertexai/gemini-2.5-flash-image` - [Gemini Nano Banana 2.1](/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code):`vertexai/gemini-nano-banana-2.1` - [Nano Banana 2 Lite](/zh/development/comfy-router/models/google/nano-banana-2-lite/code):`vertexai/gemini-3.1-flash-lite-image` @@ -212,62 +220,62 @@ translationBlockHashes: - [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code):`openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code):`openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code):`openai/gpt-image-2.5-sunburst` -- [GPT Image 2.6 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code):`openai/gpt-image-2.6-flare` -- [GPT Image 2.6 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code):`openai/gpt-image-2.6-sunburst` -- [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code):`openai/gpt-image-2` -- [Qwen Image 3.0 Pro](/zh/development/comfy-router/models/qwen/qwen-image-3-0-pro/code):`qwen/qwen-image-3.0-pro` -- [Qwen Image 3.0](/zh/development/comfy-router/models/qwen/qwen-image-3-0/code):`qwen/qwen-image-3.0` -- [Recraft V2](/zh/development/comfy-router/models/recraft/recraftv2/code):`recraft/recraftv2` -- [Recraft V3](/zh/development/comfy-router/models/recraft/recraftv3/code):`recraft/recraftv3` -- [Recraft V4.1 Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code):`recraft/recraftv4_1_pro_vector` -- [Recraft V4.1 Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-pro/code):`recraft/recraftv4_1_pro` -- [Recraft V4.1 Utility Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code):`recraft/recraftv4_1_utility_pro_vector` -- [Recraft V4.1 Utility Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code):`recraft/recraftv4_1_utility_pro` -- [Recraft V4.1 Utility Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code):`recraft/recraftv4_1_utility_vector` -- [Recraft V4.1 Utility](/zh/development/comfy-router/models/recraft/recraftv4-1-utility/code):`recraft/recraftv4_1_utility` -- [Recraft V4.1 Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-vector/code):`recraft/recraftv4_1_vector` -- [Recraft V4.1](/zh/development/comfy-router/models/recraft/recraftv4-1/code):`recraft/recraftv4_1` -- [Recraft V4 Pro](/zh/development/comfy-router/models/recraft/recraftv4-pro/code):`recraft/recraftv4_pro` -- [Recraft V4 Styles Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code):`recraft/recraftv4_styles_pro_vector` -- [Recraft V4 Styles Pro](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro/code):`recraft/recraftv4_styles_pro` -- [Recraft V4 Styles Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-vector/code):`recraft/recraftv4_styles_vector` -- [Recraft V4 Styles](/zh/development/comfy-router/models/recraft/recraftv4-styles/code):`recraft/recraftv4_styles` -- [Recraft V4](/zh/development/comfy-router/models/recraft/recraftv4/code):`recraft/recraftv4` -- [Gen 4 Image](/zh/development/comfy-router/models/runway/gen4-image/code):`runway/gen4_image` -- [Control Sketch](/zh/development/comfy-router/models/stability/control-sketch/code):`stability/control-sketch` -- [Control Structure](/zh/development/comfy-router/models/stability/control-structure/code):`stability/control-structure` -- [Control Style Transfer](/zh/development/comfy-router/models/stability/control-style-transfer/code):`stability/control-style-transfer` -- [Control Style](/zh/development/comfy-router/models/stability/control-style/code):`stability/control-style` -- [Edit Erase](/zh/development/comfy-router/models/stability/edit-erase/code):`stability/edit-erase` -- [Edit Inpaint](/zh/development/comfy-router/models/stability/edit-inpaint/code):`stability/edit-inpaint` -- [Edit Outpaint](/zh/development/comfy-router/models/stability/edit-outpaint/code):`stability/edit-outpaint` -- [Edit Remove Background](/zh/development/comfy-router/models/stability/edit-remove-background/code):`stability/edit-remove-background` -- [Edit Replace Background And Relight](/zh/development/comfy-router/models/stability/edit-replace-background-and-relight/code):`stability/edit-replace-background-and-relight` -- [Edit Search And Recolor](/zh/development/comfy-router/models/stability/edit-search-and-recolor/code):`stability/edit-search-and-recolor` -- [Edit Search And Replace](/zh/development/comfy-router/models/stability/edit-search-and-replace/code):`stability/edit-search-and-replace` -- [Generate Core](/zh/development/comfy-router/models/stability/generate-core/code):`stability/generate-core` -- [Generate Ultra](/zh/development/comfy-router/models/stability/generate-ultra/code):`stability/generate-ultra` -- [Sd3.5 Flash](/zh/development/comfy-router/models/stability/sd3-5-flash/code):`stability/sd3.5-flash` -- [Sd3.5 Large Turbo](/zh/development/comfy-router/models/stability/sd3-5-large-turbo/code):`stability/sd3.5-large-turbo` -- [Sd3.5 Large](/zh/development/comfy-router/models/stability/sd3-5-large/code):`stability/sd3.5-large` -- [Sd3.5 Medium](/zh/development/comfy-router/models/stability/sd3-5-medium/code):`stability/sd3.5-medium` -- [Sdxl 1.0 Image To Image](/zh/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code):`stability/sdxl-1.0-image-to-image` -- [Sdxl 1.0 Masking](/zh/development/comfy-router/models/stability/sdxl-1-0-masking/code):`stability/sdxl-1.0-masking` -- [Sdxl 1.0 Text To Image](/zh/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code):`stability/sdxl-1.0-text-to-image` -- [Upscale Conservative](/zh/development/comfy-router/models/stability/upscale-conservative/code):`stability/upscale-conservative` -- [Upscale Creative](/zh/development/comfy-router/models/stability/upscale-creative/code):`stability/upscale-creative` -- [Upscale Fast](/zh/development/comfy-router/models/stability/upscale-fast/code):`stability/upscale-fast` -- [Wan 2.5 I2I Preview](/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code):`wan/wan2.5-i2i-preview` -- [Wan 2.5 T2I Preview](/zh/development/comfy-router/models/wan/wan2-5-t2i-preview/code):`wan/wan2.5-t2i-preview` -- [Seedvr 2](/zh/development/comfy-router/models/wavespeed/seedvr2/code):`wavespeed/seedvr2` -- [Ultimate Image Upscaler](/zh/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code):`wavespeed/ultimate-image-upscaler` -- [Grok Imagine Image 2.0](/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code):`xai/grok-imagine-image-2.0` -- [Grok Imagine Image Pro](/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code):`xai/grok-imagine-image-pro` +- [GPT Image 2.6 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code):`openai/gpt-image-2.6-flare`- [GPT Image 2.6 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` +- [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` +- [Arrow 2 Telos](/zh/development/comfy-router/models/quiver/arrow-2-telos/code): `quiver/arrow-2-telos` +- [Arrow 2](/zh/development/comfy-router/models/quiver/arrow-2/code): `quiver/arrow-2` +- [Qwen Image 3.0 Pro](/zh/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` +- [Qwen Image 3.0](/zh/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` +- [Recraft V2](/zh/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` +- [Recraft V3](/zh/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3` +- [Recraft V4.1 Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code): `recraft/recraftv4_1_pro_vector` +- [Recraft V4.1 Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-pro/code): `recraft/recraftv4_1_pro` +- [Recraft V4.1 Utility Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code): `recraft/recraftv4_1_utility_pro_vector` +- [Recraft V4.1 Utility Pro](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code): `recraft/recraftv4_1_utility_pro` +- [Recraft V4.1 Utility Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code): `recraft/recraftv4_1_utility_vector` +- [Recraft V4.1 Utility](/zh/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` +- [Recraft V4.1 Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-vector/code): `recraft/recraftv4_1_vector` +- [Recraft V4.1](/zh/development/comfy-router/models/recraft/recraftv4-1/code): `recraft/recraftv4_1` +- [Recraft V4 Pro](/zh/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro` +- [Recraft V4 Styles Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` +- [Recraft V4 Styles Pro](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro/code): `recraft/recraftv4_styles_pro` +- [Recraft V4 Styles Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` +- [Recraft V4 Styles](/zh/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` +- [Recraft V4](/zh/development/comfy-router/models/recraft/recraftv4/code): `recraft/recraftv4` +- [Gen 4 Image](/zh/development/comfy-router/models/runway/gen4-image/code): `runway/gen4_image` +- [Control Sketch](/zh/development/comfy-router/models/stability/control-sketch/code): `stability/control-sketch` +- [Control Structure](/zh/development/comfy-router/models/stability/control-structure/code): `stability/control-structure` +- [Control Style Transfer](/zh/development/comfy-router/models/stability/control-style-transfer/code): `stability/control-style-transfer` +- [Control Style](/zh/development/comfy-router/models/stability/control-style/code): `stability/control-style` +- [Edit Erase](/zh/development/comfy-router/models/stability/edit-erase/code): `stability/edit-erase` +- [Edit Inpaint](/zh/development/comfy-router/models/stability/edit-inpaint/code): `stability/edit-inpaint` +- [Edit Outpaint](/zh/development/comfy-router/models/stability/edit-outpaint/code): `stability/edit-outpaint` +- [Edit Remove Background](/zh/development/comfy-router/models/stability/edit-remove-background/code): `stability/edit-remove-background` +- [Edit Replace Background And Relight](/zh/development/comfy-router/models/stability/edit-replace-background-and-relight/code): `stability/edit-replace-background-and-relight` +- [Edit Search And Recolor](/zh/development/comfy-router/models/stability/edit-search-and-recolor/code): `stability/edit-search-and-recolor` +- [Edit Search And Replace](/zh/development/comfy-router/models/stability/edit-search-and-replace/code): `stability/edit-search-and-replace` +- [Generate Core](/zh/development/comfy-router/models/stability/generate-core/code): `stability/generate-core` +- [Generate Ultra](/zh/development/comfy-router/models/stability/generate-ultra/code): `stability/generate-ultra` +- [Sd3.5 Flash](/zh/development/comfy-router/models/stability/sd3-5-flash/code): `stability/sd3.5-flash` +- [Sd3.5 Large Turbo](/zh/development/comfy-router/models/stability/sd3-5-large-turbo/code): `stability/sd3.5-large-turbo` +- [Sd3.5 Large](/zh/development/comfy-router/models/stability/sd3-5-large/code): `stability/sd3.5-large` +- [Sd3.5 Medium](/zh/development/comfy-router/models/stability/sd3-5-medium/code): `stability/sd3.5-medium` +- [Sdxl 1.0 Image To Image](/zh/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code): `stability/sdxl-1.0-image-to-image` +- [Sdxl 1.0 Masking](/zh/development/comfy-router/models/stability/sdxl-1-0-masking/code): `stability/sdxl-1.0-masking` +- [Sdxl 1.0 Text To Image](/zh/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code): `stability/sdxl-1.0-text-to-image` +- [Upscale Conservative](/zh/development/comfy-router/models/stability/upscale-conservative/code): `stability/upscale-conservative` +- [Upscale Creative](/zh/development/comfy-router/models/stability/upscale-creative/code): `stability/upscale-creative` +- [Upscale Fast](/zh/development/comfy-router/models/stability/upscale-fast/code): `stability/upscale-fast` +- [Wan 2.5 I2I Preview](/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code): `wan/wan2.5-i2i-preview` +- [Wan 2.5 T2I Preview](/zh/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` +- [Seedvr 2](/zh/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` +- [Ultimate Image Upscaler](/zh/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` +- [Grok Imagine Image 2.0](/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0`- [Grok Imagine Image Pro](/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code):`xai/grok-imagine-image-pro` - [Grok Imagine Image Quality](/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code):`xai/grok-imagine-image-quality` - [Grok Imagine Image](/zh/development/comfy-router/models/xai/grok-imagine-image/code):`xai/grok-imagine-image` - + - [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code):`bfl/flux-3-video` - [Dreamina Seedance 2.0 260128](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code):`byteplus/dreamina-seedance-2-0-260128` @@ -276,7 +284,6 @@ translationBlockHashes: - [Dreamina Seedance 2.5 260628](/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code):`byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/zh/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code):`byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/zh/development/comfy-router/models/byteplus/seed-audio-1-0/code):`byteplus/seed-audio-1.0` -- [Seedance 1.5 Pro 251215](/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code):`byteplus/seedance-1-5-pro-251215` - [Eleven Multilingual V2](/zh/development/comfy-router/models/elevenlabs/eleven-multilingual-v2/code):`elevenlabs/eleven_multilingual_v2` - [Eleven Sfx V2](/zh/development/comfy-router/models/elevenlabs/eleven-sfx-v2/code):`elevenlabs/eleven_sfx_v2` - [Eleven V3](/zh/development/comfy-router/models/elevenlabs/eleven-v3/code):`elevenlabs/eleven_v3` @@ -292,6 +299,7 @@ translationBlockHashes: - [Higgsfield Kling 3 Pro](/zh/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code):`higgsfield/higgsfield-kling-3-pro` - [LTX 2.5 Fast](/zh/development/comfy-router/models/ltx/ltx-2-5-fast/code):`ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/zh/development/comfy-router/models/ltx/ltx-2-5-pro/code):`ltx/ltx-2-5-pro` +- [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code):`ltx/ltx-video-upscale` - [MiniMax H3](/zh/development/comfy-router/models/minimax/minimax-h3/code):`minimax/minimax-h3` - [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code):`pika/pika-h3-flex-image-to-video` - [Pika H3 Flex Reference To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code):`pika/pika-h3-flex-reference-to-video` @@ -318,23 +326,22 @@ translationBlockHashes: - [Wan 3.0 Video](/zh/development/comfy-router/models/wan/wan3-0-video/code):`wan/wan3.0-video` - + - [Animations](/zh/development/comfy-router/models/meshy/animations/code):`meshy/animations` - [Meshy 6](/zh/development/comfy-router/models/meshy/meshy-6/code):`meshy/meshy-6` -- [Meshy 7.1](/zh/development/comfy-router/models/meshy/meshy-7-1/code):`meshy/meshy-7.1` -- [Meshy 7](/zh/development/comfy-router/models/meshy/meshy-7/code):`meshy/meshy-7` +- [Meshy 7.1](/zh/development/comfy-router/models/meshy/meshy-7-1/code):`meshy/meshy-7.1`- [Meshy 7](/zh/development/comfy-router/models/meshy/meshy-7/code):`meshy/meshy-7` - [Remesh](/zh/development/comfy-router/models/meshy/remesh/code):`meshy/remesh` - [Rigging](/zh/development/comfy-router/models/meshy/rigging/code):`meshy/rigging` - [Stable Fast 3D](/zh/development/comfy-router/models/stability/stable-fast-3d/code):`stability/stable-fast-3d` - [Stable Point Aware 3D](/zh/development/comfy-router/models/stability/stable-point-aware-3d/code):`stability/stable-point-aware-3d` -- [Hunyuan 3D Part](/zh/development/comfy-router/models/tencent/hunyuan-3d-part/code):`tencent/hunyuan-3d-part` -- [Hunyuan 3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology` -- [Hunyuan 3D Texture Edit](/zh/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code):`tencent/hunyuan-3d-texture-edit` -- [Hunyuan 3D Uv](/zh/development/comfy-router/models/tencent/hunyuan-3d-uv/code):`tencent/hunyuan-3d-uv` +- [混元3D Part](/zh/development/comfy-router/models/tencent/hunyuan-3d-part/code):`tencent/hunyuan-3d-part` +- [混元3D Smart Topology](/zh/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code):`tencent/hunyuan-3d-smart-topology` +- [混元3D Texture Edit](/zh/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code):`tencent/hunyuan-3d-texture-edit` +- [混元3D Uv](/zh/development/comfy-router/models/tencent/hunyuan-3d-uv/code):`tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/zh/development/comfy-router/models/anthropic/claude-fable-5-1/code):`anthropic/claude-fable-5-1` - [Claude Fable 5](/zh/development/comfy-router/models/anthropic/claude-fable-5/code):`anthropic/claude-fable-5` @@ -358,6 +365,9 @@ translationBlockHashes: - [Gemini 3.1 Flash Lite](/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code):`vertexai/gemini-3.1-flash-lite` - [Gemini 3.7 Flash](/zh/development/comfy-router/models/google/gemini-3-7-flash/code):`vertexai/gemini-3.7-flash` - [Gemini 3.8 Flash](/zh/development/comfy-router/models/google/gemini-3-8-flash/code):`vertexai/gemini-3.8-flash` +- [Gemini 4 Argon](/zh/development/comfy-router/models/google/gemini-4-argon/code):`vertexai/gemini-4-argon` +- [Gemini 4 Carbon](/zh/development/comfy-router/models/google/gemini-4-carbon/code):`vertexai/gemini-4-carbon` +- [Gemini 4 Hydrogen](/zh/development/comfy-router/models/google/gemini-4-hydrogen/code):`vertexai/gemini-4-hydrogen` - [Gemini Nano Banana 2.1](/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code):`vertexai/gemini-nano-banana-2.1` - [Google Gemini](/zh/development/comfy-router/models/google/gemini/code):`vertexai/gemini-3.1-pro-preview` - [Nano Banana 2 Lite](/zh/development/comfy-router/models/google/nano-banana-2-lite/code):`vertexai/gemini-3.1-flash-lite-image` @@ -375,8 +385,7 @@ translationBlockHashes: - [GPT 5 Nano](/zh/development/comfy-router/models/openai/gpt-5-nano/code):`openai/gpt-5-nano` - [GPT 5](/zh/development/comfy-router/models/openai/gpt-5/code):`openai/gpt-5` - [GPT 6.1 Sol](/zh/development/comfy-router/models/openai/gpt-6-1-sol/code):`openai/gpt-6.1-sol` -- [GPT 6.1 Terra](/zh/development/comfy-router/models/openai/gpt-6-1-terra/code):`openai/gpt-6.1-terra` -- [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code):`openai/gpt-6-astra` +- [GPT 6.1 Terra](/zh/development/comfy-router/models/openai/gpt-6-1-terra/code):`openai/gpt-6.1-terra`- [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code):`openai/gpt-6-astra` - [GPT 6 Luna](/zh/development/comfy-router/models/openai/gpt-6-luna/code):`openai/gpt-6-luna` - [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code):`openai/gpt-6-sol` - [o3](/zh/development/comfy-router/models/openai/o3/code):`openai/o3` @@ -467,7 +476,6 @@ translationBlockHashes: | [Seed Audio 1.0](/zh/development/comfy-router/models/byteplus/seed-audio-1-0/code) | `byteplus/seed-audio-1.0` | 文本 | 音频 | | [Seedance 1.0 Pro 250528](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code) | `byteplus/seedance-1-0-pro-250528` | 文本、图像 | 视频 | | [Seedance 1.0 Pro Fast 251015](/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code) | `byteplus/seedance-1-0-pro-fast-251015` | 文本、图像 | 视频 | -| [Seedance 1.5 Pro 251215](/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code) | `byteplus/seedance-1-5-pro-251215` | 文本、图像 | 视频 + 音频 | | [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code) | `byteplus/seedream-4-0-250828` | 文本、图像 | 图像 | | [Seedream 4.5 251128](/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code) | `byteplus/seedream-4-5-251128` | 文本、图像 | 图像 | | [Seedream 5.0 260128](/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | 文本、图像 | 图像 | @@ -521,6 +529,9 @@ translationBlockHashes: | [Gemini 3.1 Flash Lite](/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | 文本, 图像, 音频, 视频 | 文本 | | [Gemini 3.7 Flash](/zh/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | 文本, 图像, 音频, 视频 | 文本 | | [Gemini 3.8 Flash](/zh/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | 文本, 图像, 音频, 视频 | 文本 | +| [Gemini 4 Argon](/zh/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | 文本, 图像, 音频, 视频 | 文本 | +| [Gemini 4 Carbon](/zh/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | 文本, 图像, 音频, 视频 | 文本 | +| [Gemini 4 Hydrogen](/zh/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | 文本, 图像, 音频, 视频 | 文本 | | [Gemini Nano Banana 2.1](/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | `vertexai/gemini-nano-banana-2.1` | 文本, 图像, 视频 | 图像 + 文本 | | [Google Gemini](/zh/development/comfy-router/models/google/gemini/code) | `vertexai/gemini-3.1-pro-preview` | 文本, 图像, 音频, 视频 | 文本 | | [Nano Banana 2 Lite](/zh/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | 文本, 图像, 视频 | 图像 + 文本 | @@ -581,6 +592,10 @@ translationBlockHashes: | --- | --- | --- | --- | | [LTX 2.5 Fast](/zh/development/comfy-router/models/ltx/ltx-2-5-fast/code) | `ltx/ltx-2-5-fast` | 文本 | 视频 + 音频 | | [LTX 2.5 Pro](/zh/development/comfy-router/models/ltx/ltx-2-5-pro/code) | `ltx/ltx-2-5-pro` | 文本 | 视频 + 音频 | +| [LTX Video Alpha Gen](/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 视频 | 视频 | +| [LTX Video To Video Hdr](/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 视频 | 视频 | +| [LTX Video To Video Reframe](/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 视频 | 视频 | +| [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 视频 | 视频 + 音频 | ## Luma @@ -671,12 +686,27 @@ translationBlockHashes: | [Pika Sfx](/zh/development/comfy-router/models/pika/pika-sfx/code) | `pika/pika-sfx` | 文本 | 音频 | | [Pika Soundtrack](/zh/development/comfy-router/models/pika/pika-soundtrack/code) | `pika/pika-soundtrack` | 视频、文本 | 视频 + 音频 | +## Pixverse + +| 模型 | ID | 输入 | 输出 | +| --- | --- | --- | --- | +| [V3.5](/zh/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | 文本 | 视频 | +| [V6 Max](/zh/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | 文本 | 视频 | +| [V6](/zh/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | 文本 | 视频 | + ## Pruna | 模型 | ID | 输入 | 输出 | | --- | --- | --- | --- | | [P Video 2](/zh/development/comfy-router/models/pruna/p-video-2/code) | `pruna/p-video-2` | 文本, 图像, 音频 | 视频 + 音频 | +## Quiver + +| 模型 | ID | 输入 | 输出 | +| --- | --- | --- | --- | +| [Arrow 2 Telos](/zh/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 文本、图像 | 图像 | +| [Arrow 2](/zh/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 文本、图像 | 图像 | + ## Qwen | 模型 | ID | 输入 | 输出 | diff --git a/zh/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx b/zh/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx index 556f598014..39b0f8049b 100644 --- a/zh/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx +++ b/zh/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx @@ -2,15 +2,16 @@ title: "结合 Comfy Router 使用 Claude Sonnet 5.5" description: "通过 Comfy Router 调用 anthropic/claude-sonnet-5-5:端点、请求结构与 Router 返回的响应。" sidebarTitle: "Claude Sonnet 5.5" -translationSourceHash: 021cc189 +translationSourceHash: f0a03fa9 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx translationBlockHashes: "_intro": f09ded46 "Quick start": b8433ece - "Schema": 3a226e7f + "Schema": e5d10df7 "Examples": f08878ed --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-5-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -191,7 +192,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-5-5/requests/$REQUE - 当该值为 true 时,响应是 Anthropic 消息事件的 `text/event-stream`,而不是单个 JSON 正文。 + 在 Comfy Router 路由 `POST /v2/models/anthropic/{model}` 上,`stream` 是无效的:Router 会在派发请求之前将其固定为 `false`,并且始终把已完成的消息作为一个 JSON 文档返回。在 v1 的 `POST /proxy/anthropic/v1/messages` 路由上,`true` 会让响应变成由 Anthropic 消息事件组成的 `text/event-stream`,而不是单个 JSON 正文。在 Router 上请将 `stream` 发送为 false 或直接省略;`/proxy/` 操作返回 200 时涉及的 `text/event-stream` 这一部分在 Router 上没有对应实现。 diff --git a/zh/development/comfy-router/models/google/gemini/code.mdx b/zh/development/comfy-router/models/google/gemini/code.mdx index 3e453395b1..4598b3c516 100644 --- a/zh/development/comfy-router/models/google/gemini/code.mdx +++ b/zh/development/comfy-router/models/google/gemini/code.mdx @@ -2,7 +2,7 @@ title: "通过 Comfy Router 使用 Google Gemini" description: "通过 Comfy Router 以 HTTP 方式调用 Google Gemini 文本模型的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果的结构" sidebarTitle: "Google Gemini" -translationSourceHash: ccf669d3 +translationSourceHash: 0958828b translationFrom: development/comfy-router/models/google/gemini/code.mdx --- @@ -326,7 +326,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests/$R 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` @@ -1017,7 +1017,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` diff --git a/zh/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/zh/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index b0464573f6..b6d3a911fd 100644 --- a/zh/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/zh/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -2,17 +2,18 @@ title: "将 Nano Banana 2 Lite 与 Comfy Router 配合使用" description: "通过 Comfy Router 以 HTTP 方式调用 Nano Banana 2 Lite(Gemini 3.1 Flash-Lite Image)生成图像的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果的结构" sidebarTitle: "Nano Banana 2 Lite" -translationSourceHash: 6381740d +translationSourceHash: 75deda90 translationFrom: development/comfy-router/models/google/nano-banana-2-lite/code.mdx translationBlockHashes: "_intro": 9a5badea "Quick start": 0622ad83 - "Schema": ededaa40 + "Schema": 3b274fc9 "Examples": d294783d --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -217,7 +218,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques ### 输入 - 与模型当前对话的内容。对于单轮查询,这是单个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + 当前与模型对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -233,29 +234,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为 1 小时。更多信息,请参阅 Gemini 音频和视频依赖项。文本文件必须使用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 以内联原始字节形式提供的数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,通过 inlineData 最多可指定 3000 张图像。 - 要在提示中以内联方式包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要在提示中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB - Format: `byte` + 格式:`byte` - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(无音频)的最大长度为 1 小时。更多信息,请参阅 Gemini 音频和视频依赖项。文本文件必须使用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容会计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分的视频。设置 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是按固定帧率采样。省略则采用默认的固定帧率采样。受 gemini-3.7-flash 及更新的 Flash 模型支持。 + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。受支持于 gemini-3.7-flash 及更新的 Flash 模型。 @@ -267,7 +268,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - Possible values: `user`, `model` + 可能的值:`user`、`model` @@ -275,11 +276,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 图像生成的配置 + 图像生成配置 - 已生成图像的宽高比例 + 已生成图像的宽高比 @@ -291,7 +292,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 可选。在 Vertex AI 路径上,输出应保存为的图像格式:这些路径包括由 Comfy 自身凭据提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。在那里可接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在请求转发之前规范化为小写;任何其他值都会被拒绝,并返回一个指明该字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,并且只要该属性存在就会拒绝整个调用,因此该字段会从请求中移除,而不是被采用或被拒绝,输出格式由 AI Studio 自行决定。在所有路径上,都应从返回给你的响应部分中读取媒体类型(`inlineData.mimeType`,或在设置了 `uploadImagesToStorage` 时读取 `fileData.mimeType`),而不是假定你发送的值。 + 可选。在 Vertex AI 路径上,输出应保存为的图像格式;这些路径包括由 Comfy 自己的凭证提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径上接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;任何其他值都会被拒绝,并返回指明此字段的 400。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此类属性,如果存在该字段就会拒绝整个调用,因此该字段会从请求中丢弃,而不是被接受或拒绝,输出格式为 AI Studio 选择的任何格式。在所有路径上,都应从收到的响应部分读回媒体类型(`inlineData.mimeType`,或者在设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假定你发送的值。 @@ -299,9 +300,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 响应中可以生成的最大 token 数量。一个 token 大约相当于 4 个字符。100 个 token 大约对应 60-80 个单词。 + 响应中可生成的 token 最大数量。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个词。 - Range: `16` to `65536` + 范围:`16` 到 `65536` @@ -309,15 +310,17 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 当种子固定为特定值时,模型会尽力为重复的请求提供相同的响应。无法保证输出是确定性的。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应出现变化。默认情况下会使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + +当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出完全确定。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,使用随机种子值。适用于以下模型:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + - 温度用于响应生成期间的采样,采样在应用 topP 和 topK 时进行。温度控制 token 选择的随机程度。较低的温度适合需要较为明确或不太具创造性的响应的提示词,而较高的温度则可能带来更多样或更具创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示词的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了回退响应,请尝试提高温度 + 温度用于在响应生成过程中进行采样,采样在应用 topP 和 topK 时发生。温度控制 token 选择过程中的随机程度。较低的温度适合需要较少开放性或创造性的提示词,而较高的温度可以产生更多样或更具创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示词的响应基本上是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了兜底响应,请尝试提高温度 范围:`0` 到 `2` @@ -325,7 +328,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤,以生成更高质量响应的过程。 + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤以生成更高质量响应的过程。 @@ -333,25 +336,25 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - 可选。模型思考过程的 token 预算。模型会尽力控制在此预算范围内。 + 可选。模型思考过程的 token 预算。模型会尽最大努力保持在此预算范围内。 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` - Top-K 会改变模型为输出选择 token 的方式。Top-K 为 1 表示下一个被选择的 token 是模型词汇表中所有 token 里概率最高的。Top-K 为 3 表示使用温度从概率最高的 3 个 token 中选择下一个 token。 + Top-K 会改变模型选择输出 token 的方式。Top-K 为 1 表示下一个选中的 token 是模型词表中所有 token 里概率最高的。Top-K 为 3 表示下一个 token 通过温度从概率最高的 3 个 token 中选择。 范围:`1` 到 `…` 如果指定,则使用核采样。 -Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高(参见 top-K)到最低依次选取,直到其概率之和等于 top-P 值。例如,如果 token A、B、C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会使用温度选择 A 或 B 作为下一个 token,并排除 C 作为候选。 -指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 +Top-P 会改变模型选择输出 token 的方式。token 会按概率从高(参见 top-K)到低依次选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,则模型会通过温度选择 A 或 B 作为下一个 token,并排除 C 作为候选。 +指定较低的值可获得随机性更小的响应,指定较高的值可获得随机性更大的响应。 范围:`0` 到 `1` @@ -359,7 +362,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 用于阻止不安全内容的逐请求设置。在 GenerateContentResponse.candidates 上强制执行。 + 用于拦截不安全内容的按请求设置。在 GenerateContentResponse.candidates 上强制执行。 @@ -371,11 +374,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 用于引导模型获得更好表现的指令。例如,“尽可能简洁地回答”或“回答中不要使用专业术语”。这些文本字符串会计入 token 上限。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,且每个 part 中的内容应单独成段。 + 用于引导模型获得更好表现的指令。例如,"尽可能简洁地回答"或"不要在响应中使用技术术语"。文本字符串会计入 token 限额。systemInstruction 的 role 字段会被忽略,不影响模型的表现。注意:parts 中只应使用文本,每个 part 中的内容应单独成段。 - 构成单条消息的有序 parts 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数量或图像数量),请参阅 Google 模型页面上的模型规格。 + 构成单条消息的有序 part 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规格。 @@ -383,13 +386,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 创建该消息的实体的身份。支持以下值:user:表示该消息由真实的人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,model 值用于将模型的消息插入对话。对于非多轮对话,此字段可以留空或不设置。 + 创建该消息的实体的身份。支持以下值:user:表示该消息由真实的人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或不设置。 可能的值:`user`、`model` - 一段代码,使系统能够与外部系统交互,以执行模型的知识和范围之外的一项或一组操作。请参阅函数调用。 + 一段代码,使系统能够与外部系统交互,以执行模型知识和范围之外的一个或多个操作。参见 Function calling。 @@ -409,11 +412,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 如果为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 + 如果为 true,已生成的图像将上传到云端存储,并作为签名 URL 返回,而不是以内联 base64 数据返回。这些 URL 会在 24 小时后过期。 - 对于视频输入,表示视频起始和结束偏移量,采用 Duration 格式。例如,要指定一段从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 + 对于视频输入,指定视频的起始和结束偏移量,使用 Duration 格式。例如,要指定一段从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 @@ -421,13 +424,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 以纳秒为单位解析的带符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数部分的负秒值仍必须具有非负的 nanos 值。 范围:`0` 到 `999999999` - 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + 时间跨度的有符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 范围:`-315576000000` 到 `315576000000` @@ -437,18 +440,18 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 以纳秒为单位解析的带符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数部分的负秒值仍必须具有非负的 nanos 值。 范围:`0` 到 `999999999` - 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + 时间跨度的有符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 范围:`-315576000000` 到 `315576000000` -该内容根据 Router 在 `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` 上提供的 schema 生成,它也是请求到达提供商之前 Router 用于校验调用的同一份文档。 +本页面根据 Router 在 `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 @@ -477,7 +480,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 格式: `date` + 格式:`date` @@ -493,7 +496,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 与模型当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,其中包含对话历史和最新的请求。 + 与模型当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 @@ -509,33 +512,33 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 - 可能的取值: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的取值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可指定 3000 张图像。 - 要以行内方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制: 20MB + 要内联包含在提示词中的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定该数据的媒体类型(mimeType)。大小上限:20MB - 格式: `byte` + 格式:`byte` - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值包括以下几种。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 - 可能的取值: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的取值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 - 文本提示或代码片段。 + 文本提示词或代码片段。 @@ -543,7 +546,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 可能的取值: `user`, `model` + 可能的取值:`user`、`model` @@ -555,13 +558,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 可能的取值: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的取值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` 内容违反指定安全类别的概率 - 可能的取值: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 可能的取值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -569,7 +572,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 用于生成响应的模型版本。 + 用于生成该响应的模型版本。 @@ -607,11 +610,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 仅供输出。输入中缓存部分(缓存内容)的 token 数量。 + 仅输出。输入中缓存部分(缓存的内容)的 token 数。 - 响应中的 token 数量。 + 响应中的 token 数。 @@ -619,17 +622,17 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 输入或输出内容的模态类型。 + 输入或输出内容模态的类型。 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` - 给定模态的 token 数量。 + 给定模态的 token 数。 - 请求中的 token 数量。设置 cachedContent 后,这仍是有效的提示总大小,也就是说其中包含缓存内容中的 token 数量。 + 请求中的 token 数。当设置了 cachedContent 时,这仍然是有效的提示总大小,即包含缓存内容中的 token 数。 @@ -637,21 +640,21 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 输入或输出内容的模态类型。 + 输入或输出内容模态的类型。 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` - 给定模态的 token 数量。 + 给定模态的 token 数。 - 思考输出中存在的 token 数量。 + thoughts 输出中的 token 数。 - 工具使用提示中存在的 token 数量。 + 工具使用提示中的 token 数。 @@ -659,13 +662,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 输入或输出内容的模态类型。 + 输入或输出内容模态的类型。 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` - 给定模态的 token 数量。 + 给定模态的 token 数。 @@ -673,7 +676,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 - 用于请求的流量类型(例如 PROVISIONED_THROUGHPUT)。 + 请求使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 ## 示例 diff --git a/zh/development/comfy-router/models/google/nano-banana-2/code.mdx b/zh/development/comfy-router/models/google/nano-banana-2/code.mdx index 3d8cc0559a..c86059e4a3 100644 --- a/zh/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/zh/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -2,13 +2,13 @@ title: "将 Nano Banana 2 与 Comfy Router 配合使用" description: "通过 Comfy Router 以 HTTP 方式调用 Nano Banana 2(Gemini 3.1 Flash Image)生成图像的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果结构" sidebarTitle: "Nano Banana 2" -translationSourceHash: f8c4ed89 +translationSourceHash: 8183f2d5 translationFrom: development/comfy-router/models/google/nano-banana-2/code.mdx translationBlockHashes: "_intro": e6f85ac2 "Quick start": 7fb17070 "Serving providers": a9deb946 - "Schema": 63c93920 + "Schema": a266962e "Examples": d294783d --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* 生成文件。请编辑此目录中的 code.yaml 并运行 `pnpm code-pages:gen`。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -233,7 +234,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R ### 输入 - 与模型当前对话的内容。对于单轮查询,这是一个单独实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + 与模型进行当前对话的内容。对于单轮查询,这是单个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 @@ -249,9 +250,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参见 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 - 可选值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` @@ -259,31 +260,31 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 要在提示中以内联方式包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要在提示词中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB 格式:`byte` - 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值如下。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参见 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容会计入 token 上限。图像分辨率无限制。 - 可选值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` - 模型如何读取此部分中的视频。设置 "AGENTIC" 可让模型自行决定检查哪些片段,而不是按固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 + 模型如何读取此部分中的视频。设置为 "AGENTIC" 可让模型自行决定检查哪些片段,而不是按固定帧率采样。省略则使用默认的固定帧率采样。受支持于 gemini-3.7-flash 及更新的 Flash 模型。 - 文本提示或代码片段。 + 文本提示词或代码片段。 - 表示此部分是模型的思考/推理步骤。 + 表示此部分是来自模型的思考/推理步骤。 - 可选值:`user`, `model` + 可能的值:`user`、`model` @@ -307,7 +308,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 可选。在 Vertex AI 路径上(由 Comfy 自有凭据提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求),输出应保存为的图像格式。这些路径接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;任何其他值都会被拒绝,并返回指明此字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,一旦出现该属性就会拒绝整个调用,因此该字段会从请求中删除,而不是被接受或拒绝,输出格式为 AI Studio 所选择的格式。在所有路径上,都应从返回的响应部分读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假定你发送的值。 + 可选。输出应保存为的图像格式,适用于 Vertex AI 路径:由 Comfy 自有凭据处理的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。这些路径上接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;其他任何值都会被拒绝并返回 400 并指明此字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,一旦出现就会拒绝整个调用,因此该字段会从请求中移除,而不是被采用或被拒绝,输出格式则由 AI Studio 自行决定。在所有路径上,都应从返回给你的响应部分读回媒体类型(`inlineData.mimeType`;当设置了 `uploadImagesToStorage` 时则为 `fileData.mimeType`),而不是假设你发送的值。 @@ -315,9 +316,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 响应中可以生成的最大 token 数。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个单词。 + 响应中可生成的最大 token 数。一个 token 大约相当于 4 个字符。100 个 token 大致对应 60-80 个单词。 - 范围:`16` 到 `65536` + 范围:`16` 至 `65536` @@ -325,7 +326,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 当种子固定为特定值时,模型会尽力为重复请求提供相同的响应。但无法保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,会使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 +当种子固定为某个特定值时,模型会尽力对重复请求给出相同的响应。但不保证输出完全确定。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 @@ -333,7 +334,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 温度用于响应生成期间的采样,采样在应用 topP 和 topK 时进行。温度控制 token 选择过程中的随机程度。较低的温度适合那些要求回答不太开放或更具确定性的提示词,而较高的温度则可能带来更多样或更具创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示词的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于泛泛、过短,或者模型给出了兜底响应,请尝试提高温度。 + 温度用于响应生成过程中的采样,该过程在应用 topP 和 topK 时发生。温度控制 token 选择的随机程度。较低的温度适合需要较少开放性、较少创造性响应的提示,而较高的温度则可能带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应基本是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了回退响应,请尝试提高温度 范围:`0` 到 `2` @@ -341,7 +342,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 可选。思考功能的配置。思考是指模型将复杂任务分解为更小的步骤,从而生成更高质量响应的过程。 + 可选。思考功能的配置。思考是模型将复杂任务拆解为更小步骤以生成更高质量响应的过程。 @@ -349,25 +350,25 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests/$R - 可选。模型思考过程的 token 预算。模型会尽力控制在此预算范围内。 + 可选。模型思考过程的 token 预算。模型会尽力控制在该预算之内。 可选。模型的思考级别。 - 可能的值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL` + 可选值:`THINKING_LEVEL_UNSPECIFIED`、`LOW`、`MEDIUM`、`HIGH`、`MINIMAL`、`XHIGH` - Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示下一个被选中的 token 是模型词表中所有 token 里概率最高的那个。top-K 为 3 表示通过温度从 3 个概率最高的 token 中选择下一个 token。 + Top-K 改变模型选择输出 token 的方式。top-K 为 1 表示下一个被选中的 token 是模型词表中所有 token 里概率最高的那个。top-K 为 3 表示下一个 token 通过温度从概率最高的 3 个 token 中选出。 范围:`1` 到 `…` - 如果指定了该值,则使用核采样。 -Top-P 会改变模型为输出选择 token 的方式。token 从概率最高(参见 top-K)到最低依次选取,直到它们的概率之和等于 top-P 值。例如,如果 token A、B、C 的概率分别为 0.3、0.2 和 0.1,而 top-P 值为 0.5,那么模型会通过温度从 A 或 B 中选择下一个 token,并排除 C 作为候选。 -指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 + 如果指定,则使用核采样。 +Top-P 改变模型选择输出 token 的方式。token 按概率从高(参见 top-K)到低依次被选中,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会通过温度选择 A 或 B 作为下一个 token,并排除 C 作为候选。 +指定较低的值可获得随机性更低的响应,较高的值可获得随机性更高的响应。 范围:`0` 到 `1` @@ -379,33 +380,33 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + 可选值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - 可能的值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` + 可选值:`OFF`、`BLOCK_NONE`、`BLOCK_LOW_AND_ABOVE`、`BLOCK_MEDIUM_AND_ABOVE`、`BLOCK_ONLY_HIGH` - 用于引导模型获得更佳表现的指令。例如,“尽可能简洁地回答”或“回答中不要使用技术术语”。这些文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,不影响模型的表现。注意:各部分中只应使用文本,且每个部分中的内容应放在单独的段落中。 + 用于引导模型获得更好表现的指令。例如“尽可能简洁地回答”或“回答中不要使用技术术语”。文本字符串会计入 token 上限。systemInstruction 的 role 字段会被忽略,不会影响模型的表现。注意:parts 中只应使用文本,且每个 part 中的内容应位于单独段落中。 - 构成单条消息的有序部分列表。不同的部分可以有不同的 IANA MIME 类型。有关输入的限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规格说明。 + 构成单条消息的有序 parts 列表。不同 part 可以具有不同的 IANA MIME 类型。有关输入的限值,例如最大 token 数或图像数量,请参阅 Google 模型页面上的模型规格。 - 文本提示词或代码片段。 + 文本提示或代码片段。 - 创建该消息的实体的身份。支持以下值:user:表示该消息由真实的人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,使用 model 值可将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或不设置。 + 创建该消息的实体的身份。支持以下值:user:表示该消息由真人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或不设置。 - 可能的值:`user`、`model` + 可选值:`user`、`model` - 一段代码,使系统能够与外部系统交互,以执行模型知识和范围之外的操作或一组操作。参见函数调用。 + 一段代码,使系统能够与外部系统交互,以执行模型的知识和范围之外的一个或多个操作。参见函数调用。 @@ -425,11 +426,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 若为 true,已生成的图像将上传至云端存储,并以签名 URL 的形式返回,而不是内联的 base64 数据。这些 URL 在 24 小时后过期。 + 若为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 - 对于视频输入,表示视频起始和结束偏移量,采用 Duration 格式。例如,要指定从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式呈现时,才应指定该元数据。 + 对于视频输入,视频的起始和结束偏移量,采用 Duration 格式。例如,若要指定从 1:00 开始的一段 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。只有当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 @@ -437,15 +438,15 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 以纳秒分辨率表示的带符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数的负秒值其 nanos 值仍必须为非负数。 - 范围:`0` 到 `999999999` + Range: `0` 至 `999999999` - 时间跨度的带符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 + 时间跨度的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 - 范围:`-315576000000` 到 `315576000000` + Range: `-315576000000` 至 `315576000000` @@ -453,18 +454,18 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 以纳秒分辨率表示的带符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒精度表示的有符号秒的小数部分。带小数的负秒值其 nanos 值仍必须为非负数。 - 范围:`0` 到 `999999999` + Range: `0` 至 `999999999` - 时间跨度的带符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 + 时间跨度的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 - 范围:`-315576000000` 到 `315576000000` + Range: `-315576000000` 至 `315576000000` -由 Router 在 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 +生成自 Router 在 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` 提供的 schema,与它在请求到达提供商之前校验调用时所使用的是同一份文档。 ### 输出 @@ -509,7 +510,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 当前与模型对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新的请求。 + 模型当前对话的内容。对于单轮查询,这是单个实例。对于多轮查询,这是一个重复字段,包含对话历史以及最新的请求。 @@ -525,29 +526,29 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可以使用 inlineData 指定 3000 张图像。 + 以原始字节形式提供的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可通过 inlineData 指定 3000 张图像。 - 要以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定该数据的媒体类型(mimeType)。大小限制:20MB + 要在提示中以内联方式包含的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB 格式:`byte` - data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 模型如何读取此部分中的视频。设置 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是按固定帧率采样。省略则使用默认的固定帧率采样。gemini-3.7-flash 及更新的 Flash 模型支持此功能。 + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型决定检查哪些片段,而不再按固定帧率采样。省略则使用默认的固定帧率采样。仅在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 @@ -604,14 +605,16 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - - 可选值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + 内容所属的安全类别 + + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` 内容违反指定安全类别的概率 - 可选值:`NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -637,7 +640,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -645,7 +648,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 请求中的 token 数量。设置 cachedContent 后,这仍然是有效提示的总大小,也就是说它包含缓存内容中的 token 数量。 + 请求中的 token 数量。设置 cachedContent 时,这仍然是有效的提示总大小,也就是说其中包含缓存内容中的 token 数量。 @@ -655,7 +658,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -663,7 +666,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 思维输出中存在的 token 数量。 + 思考输出中存在的 token 数量。 @@ -677,7 +680,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -689,7 +692,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 从概率最高( - 请求使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 + 请求所使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 ## 示例 diff --git a/zh/development/comfy-router/models/google/nano-banana-pro/code.mdx b/zh/development/comfy-router/models/google/nano-banana-pro/code.mdx index 17e3c9f343..07dc50daab 100644 --- a/zh/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/zh/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -2,13 +2,13 @@ title: "搭配 Comfy Router 使用 Nano Banana Pro" description: "通过 Comfy Router 以 HTTP 方式使用 Nano Banana Pro(Gemini 3 Pro Image)生成图像的 Python、TypeScript 和 cURL 代码片段,以及请求字段和返回结果结构" sidebarTitle: "Nano Banana Pro" -translationSourceHash: 48881f72 +translationSourceHash: 63f6b907 translationFrom: development/comfy-router/models/google/nano-banana-pro/code.mdx translationBlockHashes: "_intro": 34f7de08 "Quick start": b78c780a "Serving providers": caff9b45 - "Schema": b9a919e8 + "Schema": 9094176d "Examples": 54f56549 --- @@ -16,6 +16,7 @@ translationBlockHashes: + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -233,7 +234,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE ### 输入 - 与模型当前对话的内容。对于单轮查询,这是一个单独的实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 + 与模型当前对话的内容。对于单轮查询,这是一个单一实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -249,29 +250,29 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频相关要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 以原始字节形式提供的行内数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 + 原始字节形式的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 张图像。 - 要以内联方式包含在提示中的图像、PDF 或视频的 base64 编码。以内联方式包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB + 要内联包含在提示中的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB 格式:`byte` - data 或 fileUri 字段中所指定文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频相关要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 + 在 data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。受支持于 gemini-3.7-flash 及更新的 Flash 模型。 + 模型如何读取此部分的视频。设置为 "AGENTIC" 可让模型决定检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型上受支持。 @@ -283,11 +284,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 可能的值:`user`、`model` + 可能的值:`user`, `model` - 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时会应用该默认值,其余字段则回退到模型自身的行为。 + 生成的采样、长度和输出设置。每个字段都是可选的:下面声明了 `default` 的字段在省略时应用该默认值,其余字段则回退到模型自身的行为。 @@ -295,11 +296,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 生成图像的宽高比 + 已生成图像的宽高比 - 可选。生成图像的图像输出格式。 + 可选。已生成图像的图像输出格式。 @@ -307,11 +308,11 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 可选。在 Vertex AI 路径上,输出图像应保存为的图像格式,这些路径包括:由 Comfy 自有凭证提供服务的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。在这些路径上可接受的值为 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在请求转发之前规范化为小写;任何其他值都会被拒绝,并返回一个指明此字段的 400 错误。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是个例外:该上游没有此属性,只要它存在就会拒绝整个调用,因此该字段会从请求中移除,而不是被采纳或被拒绝,输出格式则由 AI Studio 自行决定。在所有路径上,都应从你收到的响应部分中读回媒体类型(`inlineData.mimeType`,如果设置了 `uploadImagesToStorage`,则为 `fileData.mimeType`),而不要假设你发送的值。 + 可选。在 Vertex AI 路径上,输出应保存为的图像格式:由 Comfy 自身凭证提供的请求,以及使用 GCP 服务账号进行身份验证的 BYOK 请求。那里接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求之前规范化为小写;任何其他值都会被拒绝,并返回 400 并指名此字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥进行身份验证的 BYOK 请求是例外:该上游没有此属性,如果存在则会拒绝整个调用,因此该字段会从请求中删除,而不是被接受或拒绝,输出格式由 AI Studio 选择。在所有路径上,请从收到的响应部分读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假设你发送的值。 - 可选。指定生成图像的尺寸。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 + 可选。指定已生成图像的大小。支持的值为 1K、2K、4K。如果未指定,模型将使用默认值 1K。 @@ -325,15 +326,17 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 当种子固定为特定值时,模型会尽力为重复请求提供相同的响应。但无法保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,会使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + +当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,会使用随机种子值。适用于以下模型:gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + - 温度用于在生成响应期间进行采样,该过程在应用 topP 和 topK 时发生。温度控制 token 选择的随机程度。较低的温度适合需要较为封闭或较少创造性的响应的提示,而较高的温度可能带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,给定提示的响应基本上是确定性的,但仍可能存在少量变化。如果模型返回的响应过于宽泛、过短,或者模型给出了回退响应,请尝试提高温度 + 温度用于在响应生成期间进行采样,这一过程会在应用 topP 和 topK 时发生。温度控制 token 选择中的随机程度。较低温度适合需要不那么开放式或创造性回答的提示词,而较高温度可能带来更多样或更有创造性的结果。温度为 0 表示始终选择概率最高的 token。在这种情况下,对于给定提示词的响应大多是确定性的,但仍可能出现少量变化。如果模型返回的响应过于笼统、过于简短,或者模型给出了回退响应,请尝试提高温度。 范围:`0` 到 `2` @@ -341,32 +344,32 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - 可选。思考功能的配置。思考是指模型将复杂任务拆解为更小的步骤,从而生成更高质量响应的过程。 + 可选。思考功能的配置。思考是模型将复杂任务分解为更小步骤以生成更高质量响应的过程。 - 可选。如果为 true,模型会在响应中包含其思考过程。 + 可选。如果为 true,模型将在响应中包含其思考内容。 - 可选。模型思考过程的 token 预算。模型会尽力保持在该预算范围内。 + 可选。模型思考过程的 token 预算。模型会尽最大努力控制在该预算内。 可选。模型的思考级别。 - 可选值:`THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + 可能的值:`THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示所选的下一个 token 是模型词汇表中所有 token 里概率最高的一个。top-K 为 3 表示通过使用温度从前 3 个概率最高的 token 中选择下一个 token。 + Top-K 会改变模型为输出选择 token 的方式。top-K 为 1 表示下一个被选择的 token 是模型词汇表中所有 token 里最可能的那个。top-K 为 3 表示借助温度从最可能的 3 个 token 中选择下一个 token。 范围:`1` 到 `…` 如果指定,则使用核采样。 -Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最高(参见 top-K)到最低进行选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会通过使用温度选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 +Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高(参见 top-K)到最低依次选择,直到它们的概率之和等于 top-P 值。例如,如果 token A、B 和 C 的概率分别为 0.3、0.2 和 0.1,且 top-P 值为 0.5,那么模型会借助温度选择 A 或 B 作为下一个 token,并将 C 排除在候选之外。 指定较低的值可获得随机性更低的响应,指定较高的值可获得随机性更高的响应。 范围:`0` 到 `1` @@ -375,37 +378,37 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 用于阻止不安全内容的按请求设置。在 GenerateContentResponse.candidates 上强制执行。 + 用于阻止不安全内容的每请求设置。在 GenerateContentResponse.candidates 上强制执行。 - 可选值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - 可选值:`OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + 可能的值:`OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` - 用于引导模型以获得更好表现的指令。例如,"尽可能简洁地回答"或"不要在响应中使用技术术语"。文本字符串会计入 token 上限。systemInstruction 的 role 字段会被忽略,且不会影响模型的表现。注意:parts 中应仅使用文本,且每个 part 中的内容应位于单独的段落中。 + 用于引导模型获得更好表现的指令。例如,“尽可能简洁地回答”或“不要在回答中使用技术术语”。文本字符串会计入 token 限制。systemInstruction 的 role 字段会被忽略,且不会影响模型的性能。注意:parts 中只应使用文本,每个 part 中的内容应放在单独段落中。 - 构成单条消息的有序 part 列表。不同的 part 可以具有不同的 IANA MIME 类型。有关输入的限制,例如最大 token 数或图像数量,请参阅 Google 模型页面上的模型规格。 + 组成单条消息的有序 parts 列表。不同 part 可能具有不同的 IANA MIME 类型。有关输入限制(例如最大 token 数或图像数量),请参阅 Google 模型页面上的模型规格。 - 文本提示或代码片段。 + 文本提示词或代码片段。 - 创建该消息的实体的身份。支持以下值:user:表示该消息由真人发送,通常是用户生成的消息。model:表示该消息由模型生成。在多轮对话中,使用 model 值可将模型的消息插入到对话中。对于非多轮对话,该字段可以留空或不设置。 + 创建消息的实体的身份。支持以下值:user: 这表示消息由真实的人发送,通常是用户生成的消息。model: 这表示消息由模型生成。在多轮对话期间,model 值用于将来自模型的消息插入对话。对于非多轮对话,此字段可以留空或未设置。 - 可选值:`user`, `model` + 可能的值:`user`, `model` - 一段代码,使系统能够与外部系统交互,以执行超出模型知识范围与能力范围的操作或一组操作。请参阅 Function calling。 + 一段代码,使系统能够与外部系统交互,以执行模型知识范围和能力范围之外的一个操作或一组操作。请参阅函数调用。 @@ -425,11 +428,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 如果设为 true,已生成图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 + 若为 true,已生成的图像将上传到云端存储,并以签名 URL 的形式返回,而不是内联 base64 数据。这些 URL 会在 24 小时后过期。 - 对于视频输入,视频的开始和结束偏移量,采用 Duration 格式。例如,要指定从 1:00 开始的 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 + 对于视频输入,指视频的起始和结束偏移量,采用 Duration 格式。例如,要指定从 1:00 开始的一段 10 秒片段,请设置 "startOffset": \{ "seconds": 60 } 和 "endOffset": \{ "seconds": 70 }。仅当视频数据以 inlineData 或 fileData 形式提供时,才应指定该元数据。 @@ -437,13 +440,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 以纳秒为分辨率的有符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒为分辨率的带符号秒的小数部分。带小数的负秒值其 nanos 值仍必须为非负数。 范围:`0` 到 `999999999` - 时间段的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 范围:`-315576000000` 到 `315576000000` @@ -453,18 +456,18 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 以纳秒为分辨率的有符号秒的小数部分。带小数的负秒值仍必须具有非负的 nanos 值。 + 以纳秒为分辨率的带符号秒的小数部分。带小数的负秒值其 nanos 值仍必须为非负数。 范围:`0` 到 `999999999` - 时间段的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含两端)。 + 时间跨度的带符号秒数。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 范围:`-315576000000` 到 `315576000000` -根据 Router 在 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +本文档由 Router 在 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json` 提供的 schema 生成,该文档也正是它在请求到达提供商之前校验调用所用的同一份文档。 ### 输出 @@ -509,7 +512,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 与模型进行当前对话的内容。对于单轮查询,这是单个实例。对于多轮查询,这是包含对话历史和最新请求的重复字段。 + 与模型的当前对话内容。对于单轮查询,这是一个实例。对于多轮查询,这是一个重复字段,包含对话历史和最新请求。 @@ -525,13 +528,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 - 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 以原始字节表示的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,使用 inlineData 最多可以指定 3000 个图像。 + 以原始字节表示的内联数据。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,最多可通过 inlineData 指定 3000 张图像。 @@ -541,13 +544,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - data 或 fileUri 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 + data 或 fileUri 字段中指定的文件的媒体类型。可接受的取值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。更多信息请参阅 Gemini 音频和视频要求。文本文件必须使用 UTF-8 编码。文本文件的内容计入 token 上限。图像分辨率无限制。 - 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` + 可能的值:`application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - 模型如何读取此部分的视频。将 "AGENTIC" 设置为让模型决定要检查哪些片段,而不是按固定帧率采样。省略则使用默认的固定帧率采样。在 gemini-3.7-flash 及更新的 Flash 模型中受支持。 + 模型如何读取此部分的视频。设为 "AGENTIC" 可让模型自行决定要检查哪些片段,而不是采用固定帧率采样。省略则使用默认的固定帧率采样。仅在 gemini-3.7-flash 及更新版本的 Flash 模型上受支持。 @@ -559,7 +562,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 可能的值:`user`、`model` + 可能的值:`user`, `model` @@ -571,13 +574,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` 内容违反指定安全类别的概率 - 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + 可能的值:`NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -605,13 +608,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 可选值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - + 内容违反指定安全类别的概率 - 可选值:`NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -623,7 +624,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 仅输出。输入中缓存部分(即缓存内容)的 token 数量。 + 仅输出。输入中缓存部分(缓存内容)的 token 数量。 @@ -637,7 +638,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -645,7 +646,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 请求中的 token 数量。设置 cachedContent 时,这仍然是提示的总有效长度,也就是说其中包含缓存内容中的 token 数量。 + 请求中的 token 数量。设置 cachedContent 时,这仍然是有效的提示总大小,即包含缓存内容中的 token 数量。 @@ -655,7 +656,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -663,11 +664,11 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 思考输出中存在的 token 数量。 + 思考输出中出现的 token 数量。 - 工具使用提示中存在的 token 数量。 + 工具使用提示中出现的 token 数量。 @@ -677,7 +678,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -689,7 +690,7 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 请求使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 + 请求所使用的流量类型(例如 PROVISIONED_THROUGHPUT)。 ## 示例 diff --git a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index 400dddca68..d7bd91cba9 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,15 +2,16 @@ title: "将 Kling V2.5 Turbo 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 kling/kling-v2-5-turbo:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 06b3d8e9 +translationSourceHash: 3bbe1969 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 785eeca2 "Quick start": dc63b3ac - "Schema": e36b5646 + "Schema": a24874ef "Examples": 8623c725 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-v2-5-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -165,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 回调通知地址。该字段会被忽略:comfy-api 在转发前会丢弃此字段;由 Comfy Router 代你轮询。 + 回调通知地址。已忽略:comfy-api 会在转发前丢弃该字段;Comfy Router 会代你轮询。 格式:`uri` @@ -179,7 +180,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 控制相机沿水平轴(x 轴)的运动。负值表示向左,正值表示向右。 + 控制相机沿水平轴(x 轴)的移动。负值表示向左,正值表示向右。 范围:`-10` 到 `10` @@ -191,7 +192,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 控制相机的翻滚幅度(z 轴)。负值表示逆时针,正值表示顺时针。 + 控制相机的滚转幅度(z 轴)。负值表示逆时针,正值表示顺时针。 范围:`-10` 到 `10` @@ -203,7 +204,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 控制相机沿竖直轴(y 轴)的运动。负值表示向下,正值表示向上。 + 控制相机沿竖直轴(y 轴)的移动。负值表示向下,正值表示向上。 范围:`-10` 到 `10` @@ -235,17 +236,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 自定义任务 ID。该字段会被忽略:comfy-api 在转发前会丢弃此字段;由 Comfy Router 代你轮询。 - - - - 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长、质量更高的视频。 - - 可选值:`std`、`pro` + 自定义任务 ID。已忽略:comfy-api 会在转发前丢弃该字段;Comfy Router 会代你轮询。 - 模型名。使用 Comfy Router 时请省略该字段或发送 null;模型由请求路径选择。若提供名称,则必须与请求路径一致。 + 模型名。使用 Comfy Router 时可省略该字段或发送 null;模型由请求路径决定。若提供名称,则该名称必须与该路径一致。 @@ -257,7 +252,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 镜头序号 + 分镜序号 @@ -269,11 +264,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 负面文本提示词。推荐直接在正面提示词中用否定语句补充负面提示信息。 + 负面文本提示词。推荐直接在正向提示词中使用否定句来补充负面提示信息。 - 正面文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序相匹配的音色。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。 + 正向文本提示词。使用 \<\<\>> 可按 voice_list 参数顺序指定匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数的值必须为 on。 @@ -283,17 +278,17 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持此参数。 + 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持该参数。 可选值:`on`、`off` - 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用。需要将 `sound` 设为 "on",仅 V2.6 及后续版本的模型支持;在更早的模型上,或 `sound` 保持默认值 "off" 时,音色不会被应用。 + 生成视频时引用的声音列表。最多支持 2 个声音;请在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用它们。需要将 `sound` 设为 "on",仅 V2.6 及后续版本的模型支持该设置;在更早的模型上,或 `sound` 保持默认值 "off" 时,声音不会被应用。 - 通过音色自定义 API 返回的音色 ID,或系统预置的音色 ID。 + 通过声音自定义 API 返回的声音 ID,或系统预设的声音 ID。 @@ -305,19 +300,25 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 参考图像:URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,宽高比在 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 + 参考图像 - URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,宽高比在 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 - 参考图像:结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或 camera_control 同时使用。 + 参考图像 - 结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或相机控制同时使用。 + + + + 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成的视频时长更长,但输出质量更高。 + + 可能的值:`std`、`pro` -由 Router 在 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` 提供的 schema 生成,这份文档与它在请求到达提供商之前用于校验调用的是同一份文档。 +根据 Router 在 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` 提供的 schema 生成,它与 Router 在请求到达提供商之前校验调用所用的文档相同。 ### 输出 - 错误码 + 错误代码 @@ -367,7 +368,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - 带水印的已生成视频的 URL,防盗链格式 + 已生成视频带水印版本的 URL,防盗链格式 格式:`uri` diff --git a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx index 770b91060d..153d3866a0 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,15 +2,16 @@ title: "通过 Comfy Router 使用 Kling V2.6" description: "通过 Comfy Router 调用 kling/kling-v2-6:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V2.6" -translationSourceHash: 94eb0863 +translationSourceHash: c9a8a551 translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": c2065202 "Quick start": 48a3d970 - "Schema": cd52808d + "Schema": e0deb97e "Examples": 8623c725 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-v2-6.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -165,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 回调通知地址。会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代为轮询。 + 回调通知地址。已忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 格式:`uri` @@ -179,13 +180,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 控制相机沿水平轴(x 轴)的移动。负值表示向左,正值表示向右。 + 控制相机沿水平轴(x 轴)移动。负值表示向左,正值表示向右。 范围:`-10` 到 `10` - 控制相机在竖直平面(x 轴)内的旋转。负值表示向下旋转,正值表示向上旋转。 + 控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。 范围:`-10` 到 `10` @@ -197,19 +198,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 控制相机在水平平面(y 轴)内的旋转。负值表示向左旋转,正值表示向右旋转。 + 控制相机在水平面内的旋转(y 轴)。负值表示向左旋转,正值表示向右旋转。 范围:`-10` 到 `10` - 控制相机沿竖直轴(y 轴)的移动。负值表示向下,正值表示向上。 + 控制相机沿竖直轴(y 轴)移动。负值表示向下,正值表示向上。 范围:`-10` 到 `10` - 控制相机焦距的变化。负值表示视野变窄,正值表示视野变宽。 + 控制相机焦距的变化。负值表示视野更窄,正值表示视野更宽。 范围:`-10` 到 `10` @@ -221,7 +222,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 视频生成中的灵活度。值越高,模型的灵活度越低,与用户提示词的相关性越强。 + 视频生成中的灵活性。值越高,模型的灵活度越低,与用户提示词的相关性越强。 范围:`0` 到 `1` @@ -235,21 +236,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 自定义任务 ID。会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代为轮询。 - - - - 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长、输出质量更高的视频。 - - 可选值:`std`、`pro` + 自定义任务 ID。已忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 - 模型名。使用 Comfy Router 时可省略此项或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。 + 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径选择。若提供名称,则必须与该路径匹配。 - 每个分镜的信息,例如提示词和时长。最多支持 6 个分镜,最少 1 个。当 multi_shot 为 true 且 shot_type 为 customize 时必填。 + 关于每个分镜的信息,例如提示词和时长。最多支持 6 个分镜,最少 1 个。当 multi_shot 为 true 且 shot_type 为 customize 时必填。 @@ -269,15 +264,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 负面文本提示词。推荐直接在正向提示词中使用否定句来补充负面提示词信息。 + 负面文本提示词。推荐直接在正面提示词中使用否定句来补充负面提示词信息。 - 正向文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。 + 正面文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。 - 分镜方式。当 multi_shot 参数设置为 true 时必填。 + 分镜方法。当 multi_shot 参数设置为 true 时必填。 可选值:`customize`、`intelligence` @@ -289,11 +284,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 生成视频时引用的声音列表。最多支持 2 个声音;在 `prompt` 中按列表顺序使用 \<\<\>> 和 \<\<\>> 引用它们。要求将 `sound` 设置为 "on",仅 V2.6 及后续版本的模型支持此设置;在较早的模型上,或将 `sound` 保留为默认值 "off" 时,不会应用声音。 + 生成视频时引用的声音列表。最多支持 2 个声音;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用它们。需要将 `sound` 设置为 "on",仅 V2.6 及后续版本的模型支持此设置;在较早的模型上,或者当 `sound` 保留其 "off" 默认值时,声音不会生效。 - 通过声音自定义 API 返回的声音 ID,或系统预设声音 ID。 + 通过声音定制 API 返回的声音 ID,或系统预设声音 ID。 @@ -301,18 +296,24 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 是表示生成水印,否表示不生成。 + true 表示生成水印,false 表示不生成。 - 参考图像 - URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,宽高比在 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 + 参考图像:URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,宽高比在 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 - 参考图像 - 结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或 相机控制 同时使用。 + 参考图像:结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或 camera_control 同时使用。 + + + + 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长、质量更高的视频。 + + 可选值:`std`、`pro` -该内容由 Router 在 `GET /v2/models/kling/kling-v2-6/openapi.json` 提供的 schema 生成,与它在请求到达提供商之前校验调用所用的文档相同。 +本文档由 Router 在 `GET /v2/models/kling/kling-v2-6/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前校验调用所使用的文档相同。 ### 输出 @@ -329,7 +330,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 任务的扣减单位 + 任务的扣减单位数 @@ -357,7 +358,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 已生成视频 ID + 已生成视频的 ID @@ -367,7 +368,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 带水印的已生成视频 URL,防盗链格式 + 已生成视频带水印的 URL,防盗链格式 格式:`uri` diff --git a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx index 729411f1f0..7996849c2f 100644 --- a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用 Kling V3 Omni" description: "通过 Comfy Router 调用 kling/kling-v3-omni:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling V3 Omni" -translationSourceHash: 29d1799c +translationSourceHash: 7fdb91b8 translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": 68bd0500 + "Schema": 6d7cb727 "Examples": 6c2642d6 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-v3-omni.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -160,21 +161,21 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ ### 输入 - 生成视频画面的宽高比(宽度:高度)。当未使用首帧参考或视频编辑功能时,此参数必填。 + 生成视频画面的宽高比(宽度:高度)。未使用首帧参考或视频编辑功能时必填。 - 可选值:`16:9`、`9:16`、`1:1` + 可能的值:`16:9`、`9:16`、`1:1` - 本任务结果的回调通知地址。若配置此项,任务状态发生变化时服务器将主动通知。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 本任务结果的回调通知地址。配置后,任务状态发生变化时服务器会主动通知。忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 格式:`uri` - 视频时长,单位为秒。使用视频编辑功能时(refer_type: base),输出时长与输入视频相同,此参数无效。 + 视频时长(秒)。使用视频编辑功能(refer_type: base)时,输出时长与输入视频相同,此参数无效。 - 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 可能的值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` @@ -188,31 +189,25 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 自定义任务 ID。在单个用户账户内必须唯一。忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 - 参考图像列表。可包含元素、场景、风格等参考图像,也可用作首帧或结束帧来生成视频。 + 参考图像列表。可包含元素、场景、风格等的参考图像,也可作为首帧或尾帧用于生成视频。 - 图像 Base64 编码或图片网址(确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不能超过 10MB。宽度和高度尺寸不得小于 300px,宽高比在 1:2.5 ~ 2.5:1 之间。 + 图像的 Base64 编码或图片网址(请确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不能超过 10MB。宽度和高度不得小于 300px,宽高比在 1:2.5 ~ 2.5:1 之间。 - 该图像是首帧还是结束帧。first_frame 为首帧,end_frame 为结束帧。目前不支持仅使用结束帧。 - - 可选值:`first_frame`、`end_frame` - - - - 视频生成模式。std:标准模式,生成 720P 视频,性价比高。pro:专业模式,生成 1080P 视频,视频输出质量更高。 + 图像是首帧还是尾帧。first_frame 为首帧,end_frame 为尾帧。目前不支持仅使用尾帧。 - 可选值:`pro`、`std` + 可能的值:`first_frame`、`end_frame` - 模型名。使用 Comfy Router 时可省略或发送 null,模型由请求路径选择。若提供名称,则必须与该路径一致。 + 模型名。使用 Comfy Router 时可省略或传 null;模型由请求路径选择。提供的名称必须与该路径匹配。 @@ -220,15 +215,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 此分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 - 镜头序号 + 分镜序号 - 该分镜的提示词。最大长度 512 个字符。 + 此分镜的提示词。最大长度 512 个字符。 @@ -236,39 +231,39 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可通过 \<\<\<>>> 格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。 + 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可以用 \<\<\<>>> 格式指定元素、图像或视频,例如 \<\>、\<\>>、\<\>>。 - 分镜方式。当 multi_shot 参数设置为 true 时必填。 + 分镜方式。当 multi_shot 参数设为 true 时必填。 - 可选值:`customize`、`intelligence` + 可能的值:`customize`、`intelligence` 生成视频时是否同时生成声音。 - 可选值:`on`、`off` + 可能的值:`on`、`off` - 参考视频列表。可用作功能参考视频,也可用作待编辑的视频,默认为待编辑的视频。 + 参考视频列表。可作为功能参考视频,也可作为待编辑的视频,默认为待编辑的视频。 是否保留视频原始声音。yes 表示保留,no 表示不保留。 - 可选值:`yes`、`no` + 可能的值:`yes`、`no` 参考视频类型。feature 为功能参考视频,base 为待编辑的视频。 - 可选值:`feature`、`base` + 可能的值:`feature`、`base` - 上传视频的网址。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 到 2160px 之间。支持 24-60 fps 的帧率。只能上传 1 个视频,且大小不超过 200MB。 + 上传视频的 URL。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 到 2160px 之间。支持 24-60 fps 的帧率。只能上传 1 个视频,大小不超过 200MB。 @@ -279,7 +274,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ true 表示生成水印,false 表示不生成。 -由 Router 在 `GET /v2/models/kling/kling-v3-omni/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 + + 视频生成模式。std:标准模式,生成 720P 视频,性价比高。pro:专业模式,生成 1080P 视频,输出质量更高。4k:超清模式,生成 4K 分辨率视频。仅 kling-v3-omni 支持 4k;kling-video-o1 仅支持 pro/std。 + + 可能的值:`pro`、`std`、`4k` + + +本文档由 Comfy Router 在 `GET /v2/models/kling/kling-v3-omni/openapi.json` 提供的 schema 生成,该 schema 与它在请求到达提供商之前用于校验调用的文档是同一份。 ### 输出 @@ -292,11 +293,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 任务创建时间,Unix 时间戳(毫秒) + 任务创建时间,Unix 时间戳,单位为毫秒 - 任务的扣费单位数 + 任务的扣减单位数 @@ -320,11 +321,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 视频总时长(秒) + 视频总时长,单位为秒 - 已生成的视频 ID + 已生成视频的 ID @@ -334,7 +335,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 已生成的带水印视频 URL,防盗链格式 + 已生成视频的带水印 URL,采用防盗链格式 格式:`uri` @@ -350,7 +351,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - 任务更新时间,Unix 时间戳(毫秒) + 任务更新时间,Unix 时间戳,单位为毫秒 diff --git a/zh/development/comfy-router/models/kling/kling-v3/code.mdx b/zh/development/comfy-router/models/kling/kling-v3/code.mdx index 2499b715cd..bd61006a10 100644 --- a/zh/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用 Kling V3" description: "通过 Comfy Router 调用 kling/kling-v3:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Kling V3" -translationSourceHash: f5127eab +translationSourceHash: d84a12f2 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 6b9cddba "Quick start": 09c0a41a "Serving providers": b4093d36 - "Schema": 2fce4523 + "Schema": 605a654d "Examples": 8623c725 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/kling-v3.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -173,13 +174,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ ### 输入 - 视频比例 + 视频宽高比 - 可能的值:`16:9`、`9:16`、`1:1` + 可选值:`16:9`、`9:16`、`1:1` - 回调通知地址。已忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 + 回调通知地址。此项会被忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代你轮询。 格式:`uri` @@ -199,19 +200,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 控制相机在竖直平面(x 轴)内的旋转。负值表示向下旋转,正值表示向上旋转。 + 控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。 范围:`-10` 到 `10` - 控制相机的滚转数量(z 轴)。负值表示逆时针,正值表示顺时针。 + 控制相机的翻滚量(z 轴)。负值表示逆时针,正值表示顺时针。 范围:`-10` 到 `10` - 控制相机在水平平面(y 轴)内的旋转。负值表示向左旋转,正值表示向右旋转。 + 控制相机在水平平面内的旋转(y 轴)。负值表示向左旋转,正值表示向右旋转。 范围:`-10` 到 `10` @@ -229,13 +230,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 预定义的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上仰拍。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。 + 预定义的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。 - 可能的值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` + 可选值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward` - 视频生成的灵活度。值越高,模型的灵活度越低,与用户提示词的相关性越强。 + 视频生成中的灵活性。该值越高,模型的灵活程度越低,与用户提示词的相关性越强。 范围:`0` 到 `1` @@ -243,71 +244,65 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 视频时长(秒) + 视频时长,单位为秒 - 可能的值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` + 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15` - 自定义任务 ID。已忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 - - - - 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成的视频时长更长,但输出质量更高。 - - 可能的值:`std`、`pro` + 自定义任务 ID。此项会被忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代你轮询。 - 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。 + 模型名。使用 Comfy Router 时请省略该字段或发送 null;模型由请求路径选择。若提供名称,该名称必须与请求路径匹配。 - 每个分镜的信息,例如提示词和时长。最多支持 6 个分镜,最少 1 个。当 multi_shot 为 true 且 shot_type 为 customize 时必填。 + 关于每个分镜的信息,例如提示词和时长。最多支持 6 个分镜,最少 1 个。当 multi_shot 为 true 且 shot_type 为 customize 时必填。 - 该分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 此分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 - 分镜序号 + 镜头序号 - 该分镜的提示词。最大长度为 512 个字符。 + 此分镜的提示词。最大长度为 512 个字符。 - 是否生成多分镜视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。 + 是否生成多镜头视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。 - 负面文本提示词。推荐直接在正面提示词中通过否定句补充负面提示词信息。 + 负面文本提示词。推荐直接在正向提示词中用否定句补充负面提示词信息。 - 正面文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。 + 正向文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。 分镜方法。当 multi_shot 参数设置为 true 时必填。 - 可能的值:`customize`、`intelligence` + 可选值:`customize`、`intelligence` 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持此参数。 - 可能的值:`on`、`off` + 可选值:`on`、`off` - 生成视频时引用的声音列表。最多支持 2 个声音;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用它们。需要将 `sound` 设置为 "on",仅 V2.6 及后续版本的模型支持此参数;在更早的模型上,或将 `sound` 保留为默认值 "off" 时,声音不会生效。 + 生成视频时引用的声音列表。最多支持 2 个声音;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用它们。需要将 `sound` 设置为 "on",仅 V2.6 及后续版本的模型支持该值;在更早的模型上,或将 `sound` 保留为默认值 "off" 时,声音不会应用。 - 通过声音自定义 API 返回的声音 ID,或系统预设声音 ID。 + 通过声音定制 API 返回的声音 ID,或系统预设声音 ID。 @@ -315,23 +310,29 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - true 表示生成水印,false 表示不生成水印。 + true 表示生成水印,false 表示不生成。 - - 参考图像:URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,比例介于 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 + + 参考图像:URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,宽高比在 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。 参考图像:结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或 camera_control 同时使用。 -本文档根据 Router 在 `GET /v2/models/kling/kling-v3/openapi.json` 提供的 schema 生成,该 schema 正是它在请求到达提供商之前用于校验调用的同一份文档。 + + 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成的视频时长更长,但输出质量更高。4k:超高清模式,生成 4K 分辨率的视频。在该系列中,只有 kling-v3 支持 4k;其他所有 Kling 文生视频模型仅支持 pro/std。 + + 可选值:`std`、`pro`、`4k` + + +该内容根据 Router 在 `GET /v2/models/kling/kling-v3/openapi.json` 提供的 schema 生成,该文档与 Router 在请求到达提供商之前校验调用所用的文档相同。 ### 输出 - 错误代码 + 错误码 @@ -339,11 +340,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 任务创建时间,Unix 时间戳,单位为毫秒 + 任务创建时间,Unix 时间戳(毫秒) - 任务的扣减单位 + 任务扣除的单位数 @@ -367,7 +368,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 视频总时长,单位为秒 + 视频总时长(秒) @@ -381,7 +382,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 已生成视频的带水印 URL,防盗链格式 + 带水印的已生成视频 URL,防盗链格式 格式:`uri` @@ -397,7 +398,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - 任务更新时间,Unix 时间戳,单位为毫秒 + 任务更新时间,Unix 时间戳(毫秒) diff --git a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx index da101120b5..79e9e5106e 100644 --- a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,16 +2,17 @@ title: "将 Kling Video O1 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 kling/kling-video-o1:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Kling Video O1" -translationSourceHash: 892ccf77 +translationSourceHash: 8870f379 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": f693e2ef + "Schema": e4a41688 "Examples": 6c2642d6 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-video-o1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -160,13 +161,13 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ ### 输入 - 生成视频画面的宽高比例(宽:高)。未使用首帧参考或视频编辑功能时必填。 + 生成视频画面的宽高比(宽度:高度)。当未使用首帧参考或视频编辑功能时,此参数必填。 可选值:`16:9`、`9:16`、`1:1` - 本任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 此任务结果的回调通知地址。如果已配置,任务状态变化时服务器会主动通知。该字段会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 格式:`uri` @@ -188,31 +189,25 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 自定义任务 ID。在单个用户账号内必须唯一。此项会被忽略:comfy-api 在转发前会丢弃该字段;由 Comfy Router 代你轮询。 + 自定义任务 ID。必须在单个用户账号内唯一。该字段会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。 - 参考图像列表。可包含元素、场景、风格等参考图像,也可用作首帧或结束帧来生成视频。 + 参考图像列表。可以包含元素、场景、风格等的参考图像,也可用作首帧或结束帧来生成视频。 - 图像的 Base64 编码或图片网址(请确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不能超过 10MB。宽度和高度尺寸不得小于 300px,宽高比介于 1:2.5 ~ 2.5:1 之间。 + 图像 Base64 编码或图片网址(确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不能超过 10MB。宽度和高度尺寸不得小于 300px,宽高比在 1:2.5 ~ 2.5:1 之间。 - 图像是首帧还是结束帧。first_frame 为首帧,end_frame 为结束帧。目前不支持仅使用结束帧。 + 图像是首帧还是结束帧。first_frame 是首帧,end_frame 是结束帧。目前不支持仅提供结束帧。 可选值:`first_frame`、`end_frame` - - 视频生成模式。std:标准模式,生成 720P 视频,性价比高。pro:专业模式,生成 1080P 视频,视频输出质量更高。 - - 可选值:`pro`、`std` - - - 模型名。使用 Comfy Router 时可省略或传 null;模型由请求路径选择。若提供名称,则必须与该路径一致。 + 模型名。使用 Comfy Router 时请省略该参数或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。 @@ -220,15 +215,15 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 本分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 + 此分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。 - 镜头序号 + 分镜序号 - 本分镜的提示词。最大长度为 512 个字符。 + 此分镜的提示词。最大长度 512 个字符。 @@ -236,11 +231,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可以按 \<\<\<>>> 的格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。 + 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可使用 \<\<\<>>> 格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。 - 分镜方式。multi_shot 参数设为 true 时必填。 + 分镜方式。当 multi_shot 参数设置为 true 时必填。 可选值:`customize`、`intelligence` @@ -252,23 +247,23 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 参考视频列表。可用作功能参考视频或待编辑视频,默认为待编辑视频。 + 参考视频列表。可用作特征参考视频,也可用作待编辑视频,默认为待编辑视频。 - 是否保留视频的原始声音。yes 表示保留,no 表示不保留。 + 是否保留视频原始声音。yes 表示保留,no 表示不保留。 可选值:`yes`、`no` - 参考视频类型。feature 为特征参考视频,base 为待编辑视频。 + 参考视频类型。feature 是特征参考视频,base 是待编辑视频。 可选值:`feature`、`base` - 上传视频的 URL。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 至 2160px 之间。支持 24-60 fps 的帧率。仅可上传 1 个视频,大小不超过 200MB。 + 上传视频的网址。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 到 2160px 之间。支持 24-60 fps 的帧率。只能上传 1 个视频,大小不能超过 200MB。 @@ -279,7 +274,13 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ true 表示生成水印,false 表示不生成。 -根据 Router 在 `GET /v2/models/kling/kling-video-o1/openapi.json` 提供的 schema 生成,与请求到达提供商之前用于校验调用的文档相同。 + + 视频生成模式。std:标准模式,生成 720P 视频,性价比高。pro:专业模式,生成 1080P 视频,视频输出质量更高。 + + 可选值:`pro`、`std` + + +本文档根据 Router 在 `GET /v2/models/kling/kling-video-o1/openapi.json` 提供的 schema 生成,也是请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -296,7 +297,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 任务扣除的单位数 + 任务的扣减单位数 @@ -328,21 +329,21 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - 已生成视频的 URL + 已生成的视频的 URL - 格式:`uri` + Format: `uri` 带水印的已生成视频的 URL,防盗链格式 - 格式:`uri` + Format: `uri` 任务状态 - 可能的值:`submitted`、`processing`、`succeed`、`failed` + Possible values: `submitted`, `processing`, `succeed`, `failed` diff --git a/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx b/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx new file mode 100644 index 0000000000..4c8b7797aa --- /dev/null +++ b/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx @@ -0,0 +1,222 @@ +--- +title: "通过 Comfy Router 使用 LTX Video Alpha Gen" +description: "通过 Comfy Router 调用 ltx/ltx-video-alpha-gen:端点、请求形状以及 Router 返回的响应。" +sidebarTitle: "LTX Video Alpha Gen" +translationSourceHash: 9ad35117 +translationFrom: development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx +translationBlockHashes: + "_intro": 99d9f21c + "Quick start": 3fae9114 + "Schema": 2e86e846 + "Examples": 68527b2e +--- +{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/ltx/ltx-video-alpha-gen.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-alpha-gen` 的 API 参考,由 Comfy Router 提供,模型来自 LTX。 + +**输入:** 视频 · **输出:** 视频 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建一个密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段则是通过原始 HTTP 发出的同一调用。 + +**模型 ID:** `ltx/ltx-video-alpha-gen` + +**端点:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量中读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-alpha-gen", + { + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("ltx/ltx-video-alpha-gen", { + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests`。只要运行被接纳,Router 就会返回 `201` 和一个 `request_id`;结果就绪后即可收集,可以在这个进程中收集,也可以在另一个进程中收集。[队列投递](/zh/development/comfy-router/queue)会介绍状态、取消和结果收集的完整流程。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量中读取 COMFY_API_KEY。 +# 每次调用 submit() 都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-alpha-gen", + { + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # 加上模型 ID,就是另一个进程需要的全部信息 + + # 轮询直到请求完成,每次按服务器给出的 Retry-After 等待。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自己的响应载荷,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在这里抛出带类型的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// 每次调用 submit() 都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("ltx/ltx-video-alpha-gen", { + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,以及 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. 轮询直到状态为 COMPLETED,每次按响应中给出的 Retry-After 秒数等待。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集结果。返回 200 时带有模型的原始输出;仍在运行时返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 输入视频,可为可公开访问的 HTTPS URL 或 base64 数据 URI。采用 H.264 或 HEVC 编码的 MP4、MOV 或 MKV,通过 URL 提供时最大 200 MB。长边最多 3840 像素,短边最多 2160 像素。 + + +该内容根据 Router 在 `GET /v2/models/ltx/ltx-video-alpha-gen/openapi.json` 提供的 Schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 + +### 输出 + + + 任务完成时间戳(ISO 8601) + + + + 任务创建时间戳(ISO 8601) + + + + 状态为失败时存在 + + + + + + + + + + + + 唯一的任务标识符 + + + + 状态为已完成时存在;输出 URL 在完成后 24 小时过期 + + + + 输入视频的 URL,其中遮罩作为其透明度通道,格式为 ProRes 4444 MOV + + + + 灰度 alpha 遮罩的 URL,为 MP4 格式,其中白色代表前景 + + + + 任务状态(待定、处理中、已完成、失败) + + +## 示例 + +### 输入 + +```json +{ + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 输出 + +```json +{ + "completed_at": "2026-01-01T00:00:50Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "cutout_video_url": "https://example.invalid/ltx/cutout.mov", + "matte_video_url": "https://example.invalid/ltx/matte.mp4" + }, + "status": "completed" +} +``` + + + diff --git a/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx b/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx new file mode 100644 index 0000000000..92df459648 --- /dev/null +++ b/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx @@ -0,0 +1,232 @@ +--- +title: "使用 Comfy Router 调用 LTX Video To Video Hdr" +description: "通过 Comfy Router 调用 ltx/ltx-video-to-video-hdr:端点、请求形状以及 Router 返回的响应。" +sidebarTitle: "LTX Video To Video Hdr" +translationSourceHash: 42a210ab +translationFrom: development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx +translationBlockHashes: + "_intro": 73aee58d + "Quick start": 0cc37810 + "Schema": 511ed3d7 + "Examples": 2bedcca6 +--- +{/* 生成文件。由 `pnpm code-pages:gen` 从 router-schemas/ltx/ltx-video-to-video-hdr.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-to-video-hdr` 的 API 参考,由 Comfy Router 从 LTX 提供。 + +**输入:** 视频 · **输出:** 视频 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 与 `npm install @comfyorg/sdk`);cURL 代码片段则是通过原始 HTTP 发起的同一调用。 + +**模型 ID:** `ltx/ltx-video-to-video-hdr` + +**端点:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量中读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-to-video-hdr", + { + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("ltx/ltx-video-to-video-hdr", { + output_colorspace: "acescg", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"output_colorspace\": \"acescg\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests`。只要运行被接纳,Router 就会以 `201` 返回一个 `request_id`;结果准备就绪后即可收集,无论是本进程还是另一个进程。[队列投递](/zh/development/comfy-router/queue)会依次介绍状态、取消和收集。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量中读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-to-video-hdr", + { + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # 配合模型 ID,就是另一个进程所需的全部信息 + + # 轮询直到请求完成,按服务器给出的 Retry-After 等待。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自己的负载,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在此处抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("ltx/ltx-video-to-video-hdr", { + output_colorspace: "acescg", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并附带 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"output_colorspace\": \"acescg\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. 轮询直到状态为 COMPLETED,每次响应都会给出需要等待的 Retry-After 秒数。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集结果。返回 200 时是模型的原生输出,仍在运行时返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + `result.exr_frames_url` 处 OpenEXR 帧序列的颜色空间。它不影响 `result.video_url`。 + + 可能的值:`acescg`、`acescct`、`srgb_linear`、`aces2065-1` + + + + 输入视频,为可公开访问的 HTTPS URL 或 base64 数据 URI。采用 MP4、MOV 或 MKV 封装的 H.264 或 HEVC,通过 URL 提供时最大 200 MB。无论横向还是纵向,宽度和高度都必须适应 3840x2160 的范围。 + + +本文档根据 Router 在 `GET /v2/models/ltx/ltx-video-to-video-hdr/openapi.json` 提供的 schema 生成,这也是在请求到达提供商之前用于验证调用的同一份文档。 + +### 输出 + + + 任务完成时间戳(ISO 8601) + + + + 任务创建时间戳(ISO 8601) + + + + 当状态为失败时存在 + + + + + + + + + + + + 唯一任务标识符 + + + + 当状态为已完成时存在;输出 URL 在完成后 24 小时后过期 + + + + ZIP 压缩包的 URL,其中包含采用所请求颜色空间的逐帧 OpenEXR 图像 + + + + HDR 视频的 URL,该视频为 10 位 HEVC BT.2020/HLG MP4 + + + + 任务状态(pending、processing、completed、failed) + + +## 示例 + +### 输入 + +```json +{ + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 输出 + +```json +{ + "completed_at": "2026-01-01T00:00:45Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "exr_frames_url": "https://example.invalid/ltx/exr_frames.zip", + "video_url": "https://example.invalid/ltx/hdr.mp4" + }, + "status": "completed" +} +``` + + diff --git a/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx b/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx new file mode 100644 index 0000000000..406b5ef86c --- /dev/null +++ b/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx @@ -0,0 +1,261 @@ +--- +title: "使用 Comfy Router 调用 LTX Video To Video Reframe" +description: "通过 Comfy Router 调用 ltx/ltx-video-to-video-reframe:端点、请求结构以及 Router 返回的响应。" +sidebarTitle: "LTX Video To Video Reframe" +translationSourceHash: a82950a2 +translationFrom: development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx +translationBlockHashes: + "_intro": 06c6f3d9 + "Quick start": a6026b27 + "Schema": 4d231f97 + "Examples": 846aabe4 +--- +{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/ltx/ltx-video-to-video-reframe.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-to-video-reframe` 的 API 参考,该模型由 Comfy Router 从 LTX 提供。 + +**输入:** 视频 · **输出:** 视频 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段则是通过原始 HTTP 发出的同一调用。 + +**模型 ID:** `ltx/ltx-video-to-video-reframe` + +**端点:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-to-video-reframe", + { + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("ltx/ltx-video-to-video-reframe", { + resolution: "720x1280", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"720x1280\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +相同的请求体,发送至 `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests`。只要运行被受理,Router 就会立即以 `201` 和 `request_id` 应答,结果在就绪后再收集,可以来自当前进程,也可以来自另一个进程。[排队交付](/zh/development/comfy-router/queue)会逐一介绍状态查询、取消和结果收集。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-to-video-reframe", + { + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # 配合模型 ID,这就是另一个进程所需的全部信息 + + # 轮询直到请求完成,每次等待服务器给出的 Retry-After 时间。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自身的负载,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在此处抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("ltx/ltx-video-to-video-reframe", { + resolution: "720x1280", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 会返回 201,并附带 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"720x1280\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. 轮询直到状态为 COMPLETED,每次按响应中给出的 Retry-After 秒数等待。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。返回 200 和模型的原生输出;仍在运行时返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 来源视频在输出画面中的位置。可发送 `anchor`,或发送 `x` 和 `y` 并搭配 `width`、`height` 或两者。省略 `placement` 时,视频将以能够容纳的最大尺寸居中放置。 + + + + 视频所贴靠的输出画面边缘或角落。 + + Possible values: `center`, `top`, `bottom`, `left`, `right`, `top_left`, `top_right`, `bottom_left`, `bottom_right` + + + + 放置视频的高度,以输出高度的比例表示。 + + Format: `double` + + + + 放置视频的宽度,以输出宽度的比例表示。 + + Format: `double` + + + + 放置视频的左边缘,以输出宽度的比例表示。 + + Format: `double` + + + + 放置视频的上边缘,以输出高度的比例表示。 + + Format: `double` + + + + 目标输出分辨率。来源视频会被扩展以填满该画面。 + + Possible values: `720x720`, `1080x1080`, `720x900`, `1080x1350`, `900x720`, `1350x1080`, `720x1280`, `1080x1920`, `1280x720`, `1920x1080` + + + + 输入视频,可以是可公开访问的 HTTPS URL 或 base64 数据 URI。支持 MP4、MOV 或 MKV 容器中的 H.264 或 HEVC,通过 URL 提交时最大 200 MB。最长 60 秒、1800 帧,宽度和高度在 64 到 4096 像素之间。 + + +本文档根据 Router 在 `GET /v2/models/ltx/ltx-video-to-video-reframe/openapi.json` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前校验调用时所依据的同一份文档。 + +### 输出 + + + 任务完成时间戳(ISO 8601) + + + + 任务创建时间戳(ISO 8601) + + + + 当状态为失败时存在 + + + + + + + + + + + + 唯一任务标识符 + + + + 当状态为已完成时存在;输出 URL 在完成后 24 小时过期 + + + + 已生成视频的 URL + + + + 任务状态(待定、处理中、已完成、失败) + + +## 示例 + +### 输入 + +```json +{ + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 输出 + +```json +{ + "completed_at": "2026-01-01T00:00:20Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "video_url": "https://example.invalid/ltx/output.mp4" + }, + "status": "completed" +} +``` + + diff --git a/zh/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx b/zh/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx new file mode 100644 index 0000000000..f2f5795337 --- /dev/null +++ b/zh/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx @@ -0,0 +1,228 @@ +--- +title: "配合 Comfy Router 使用 LTX Video Upscale" +description: "通过 Comfy Router 调用 ltx/ltx-video-upscale:端点、请求形状以及 Router 返回的响应。" +sidebarTitle: "LTX Video Upscale" +translationSourceHash: 00a8b2b0 +translationFrom: development/comfy-router/models/ltx/ltx-video-upscale/code.mdx +translationBlockHashes: + "_intro": 8ef040a0 + "Quick start": e19118f2 + "Schema": b6e43e38 + "Examples": a6d53aaa +--- +{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/ltx/ltx-video-upscale.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`ltx/ltx-video-upscale` 的 API 参考,由 Comfy Router 从 LTX 提供。 + +**输入:** 视频 · **输出:** 视频 + 音频 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为环境变量 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段是同一调用,只是通过原始 HTTP 发送。 + +**模型 ID:** `ltx/ltx-video-upscale` + +**端点:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-upscale` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-upscale", + { + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("ltx/ltx-video-upscale", { + resolution: "1080p", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"1080p\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests`。运行一经接纳,Router 就会返回 `201` 和 `request_id`;结果就绪后,可从当前进程或另一个进程收集。[排队交付](/zh/development/comfy-router/queue)介绍了状态、取消和收集的完整流程。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-upscale", + { + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # 配合模型 ID,另一个进程所需的一切就齐了 + + # 轮询直到请求完成,等待服务器指定的 Retry-After。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自己的负载,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在此处抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("ltx/ltx-video-upscale", { + resolution: "1080p", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 会返回 201,以及 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"1080p\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. 轮询直到状态为 COMPLETED,每次响应都会指定需要等待的 Retry-After 秒数。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。返回 200 和模型的原生输出;如果仍在运行,则返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 输出尺寸。宽高比保持不变。 + + 可能的值:`1080p`、`4k`、`8k` + + + + 输入视频,可以是可公开访问的 HTTPS URL 或 base64 data URI。MP4、MOV 或 MKV 格式的 H.264 或 HEVC,通过 URL 传入时最大 200 MB。短边必须至少为 480 像素。 + + +根据 Router 在 `GET /v2/models/ltx/ltx-video-upscale/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前校验调用时所依据的同一份文档。 + +### 输出 + + + 任务完成时间戳(ISO 8601) + + + + 任务创建时间戳(ISO 8601) + + + + 当 status 为失败时存在 + + + + + + + + + + + + 唯一任务标识符 + + + + 当 status 为已完成时存在;输出 URL 在完成 24 小时后过期 + + + + 已生成视频的 URL + + + + 任务状态(待定、处理中、已完成、失败) + + +## 示例 + +### 输入 + +```json +{ + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### 输出 + +```json +{ + "completed_at": "2026-01-01T00:00:20Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "video_url": "https://example.invalid/ltx/output.mp4" + }, + "status": "completed" +} +``` + + + diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 8ea81570d3..2776657318 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -2,14 +2,15 @@ title: "将 GPT Image 2.6 Flare 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 openai/gpt-image-2.6-flare:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "GPT Image 2.6 Flare" -translationSourceHash: 9f6b894f +translationSourceHash: 82634d88 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx translationBlockHashes: "_intro": 1693e80a "Quick start": 8222d9f4 - "Schema": 78f788c9 + "Schema": 85f18947 "Examples": c73859ec --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/openai/gpt-image-2.6-flare.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -159,29 +160,45 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES 可能的值:`transparent`、`opaque`、`auto` + + 动画 GIF 中的帧数(2-16,OpenAI 自身的范围),仅在 `output_format: "gif"` 时有意义,与任何其他 `output_format` 一起使用都会被拒绝。GIF 请求中省略该字段时,默认采用 OpenAI 自身的默认值 9,但 Comfy 还会按环境额外限制此字段(ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES,绝不会超过此字段自身的最大值 16):超过配置上限的值会被拒绝,而当默认值 9 本身超过配置上限时,省略的 `frame_count` 会被拒绝而不是悄悄降低,因此调用方会被告知需显式设置 `frame_count`,而不是收到一个比 OpenAI 默认值更小的动画。帧数也会约束预检报价和 64 MiB 的结果上限,这两者都随帧数缩放。 + + 范围:`2` 到 `16` + + + + 每一帧显示的毫秒数(OpenAI 自身的范围为 20-2000,四舍五入到 10 毫秒),仅在 `output_format: "gif"` 时有意义,与任何其他 `output_format` 一起使用都会被拒绝。GIF 请求中省略该字段时,采用 OpenAI 自身的默认值 200。 + + 范围:`20` 到 `2000` + + - 要编辑的来源图像。只要存在此字段,就会选择编辑操作;如果要进行文生图生成,请完全省略它。 -模型公布的示例是生成调用,其中省略了此字段。添加 `image` 就是两种模式之间的全部差异:相同的端点、相同的模型 id。只不过编辑提示词描述的是你想要的更改,而不是场景,因此下面的编辑请求体读起来会与生成示例不同,尽管从结构上看只有这个字段是新增的。 -它可以完全照原样复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。该载荷是完整的 1x1 PNG,而不是缩写形式;该请求体在 Router 自身的请求验证测试中已被固定为可接受的用例。请替换为你自己图像的字节。 -接受一张图像或由多张图像组成的数组;gpt-image-1 及更高版本最多接受 16 张,Router 会在分发之前根据此 schema 强制执行该限制。 + 要编辑的源图像。此字段是否存在决定是否选择编辑操作:若要文生图生成,请完全省略该字段。 +模型公布的示例是生成调用,其中省略了此字段。添加 `image` 就是两种模式之间的全部差异(相同的端点、相同的模型 ID),只不过编辑提示词描述的是你想要的变化,而不是场景,因此下面的编辑请求体读起来与生成示例不同,即使从结构上看只有此字段是新增的。 +它可以完全按原样复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。其中的有效负载是完整的 1x1 PNG,并非缩写,并且该请求体在 Router 自身的请求验证测试中被固定为可接受用例。请替换为你自己图像的字节。 +接受一张图像或图像数组;gpt-image-1 及更高版本最多接受 16 张,Router 会在分发之前依据此 schema 强制执行。 - 一张图像,可以是 Router 代表调用方获取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,并且该集合会在解析时强制执行,而不是留给提供商处理。svg、gif、avif 或 tiff 会在这里被拒绝,并会指明你发送的图像,而不是在距离原因两跳之外变成一个合作伙伴错误。 -优先使用 URL 形式。base64 载荷大约会膨胀 4/3,而整个请求体上限为 100 MiB,因此内联形式的上限约为 75 MB 的来源图像;而 URL 完全绕过了这一点。本描述末尾所述的每图像和每请求媒体上限比请求体上限更严格,因此对于任何实际尺寸的图像,你首先会遇到的是这些限制。 -URL 必须在不使用你的凭据的情况下完成解析。Router 会在服务器端获取它,并且不会随请求发送调用方凭据,因此受支持的形式是预签名 URL,即签名位于查询字符串中的 URL。诸如 `/api/assets/{id}/content` 之类的需要认证的端点会向 Router 返回 401,而不是返回图像;请自行请求该 URL,并传入它重定向到的签名 URL。 -获取操作仅限于一组具名主机,而不是开放互联网;同一列表既会应用于你发送的 URL,也会重新应用于每一次重定向跳转。因此,位于任何其他主机上的 URL,或者会重定向到列表之外的 URL,都会在联系任何提供商之前被拒绝。目前,该列表仅包含 Comfy 自己的资产交付:位于 Comfy 资产存储桶下的已签名 `storage.googleapis.com` URL,也就是 `/api/assets/{id}/content` 将你重定向到的形式。合作伙伴 CDN 或普通的 https 主机不在列表中。 -两项扩展正在逐步推出,并且目前两者都默认关闭。它们通过一个切换项发布并一起启用,因此请将下面的所有内容视为即将推出的功能,而不是现在就能作为开发依据的内容:在依赖其中任何一项之前,请先询问。 -第一项是 `POST /customers/storage` 为你的上传签发指向的存储桶。在该推广覆盖你的环境之前,来自该端点的上传 URL 会在这里被拒绝,即使该存储桶属于 Comfy 且主机相同也是如此。因此,“上传到 Comfy,然后传入 URL”目前并不可行;可行的形式是由 `/api/assets/{id}/content` 重定向到的签名 URL。 -第二项按账户启用,而不是一次性对所有人启用,因为这些主机背后的存储桶属于你而不是我们:即使上面的切换项已打开,未启用第三方入站媒体的账户仍会被拒绝,并且会以这些字样告知这一点,而不是告知该主机不受支持。请联系你的 Comfy 联系人,为你的账户启用它。它还额外允许以下第三方对象存储主机;在这些主机中,存储桶属于你,Router 不对其提出所有权主张:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,采用路径风格或带 `.` 前缀的形式均可)、Azure Blob Storage(`.blob.core.windows.net`)和 Alibaba Cloud OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域上的常规端点(例如阿里云函数计算触发器)不在列表中,会被拒绝。 -匹配的是主机名形式,而不是提供商。因此,上面提到某个提供商并不意味着该提供商能够签发的每个 URL 都会被接受;有三种近似但不匹配的形式值得直接说明,因为调用方有理由可能遇到其中每一种。R2 自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并将生产流量改为指向自定义域名,但自定义域名的主机名中不包含任何可将其标识为 R2 的内容,因此 Router 无法将其与任何其他主机区分开,并会拒绝它。请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 双栈端点(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)同样不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此你不必回到这里阅读它们。 -上面的 `` 和 `pub-` 占位符展示的是你通常拿到的形式,它们并不是对层级的限制。匹配针对的是对象存储的域名后缀,因此在同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也同样会被接受。这一点并未扩大命名空间本身:后缀仍然必须是所列出的后缀之一。 -下面的示例只展示形式:真实值还会携带签名查询参数,这里有意省略,因为公开的示例会永远留在规范中,而真实签名既是泄露的凭据,也是一个会失效的链接。 -每张图像上限为 25 MiB,单个请求的图像总量上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(发送 `image` 的调用)且在 `context_window` 可用时:此时每张图像最大可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总量上限为 128 MiB。 + 一张图像,可以是 Router 代表调用方获取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。可接受的图像类型为 png、webp 和 jpeg,该集合会在解析时强制执行,而不是留给提供商:svg、gif、avif 或 tiff 会在此处被拒绝,并指出你发送的图像,而不会在距原因两跳之遥的地方变成合作伙伴错误。 +优先使用 URL 形式。base64 有效负载会膨胀约 4/3,而整个请求体上限为 100 MiB,因此内联形式的上限大约对应 75 MB 的源图像;URL 可以完全绕过这一点。本描述末尾所述的单图像和单请求媒体上限比请求体上限更严格,因此对于任何实际尺寸的图像,你会先遇到这些限制。 +该 URL 必须能在不带你的凭据的情况下解析。Router 会在服务器端获取它,并且不会随请求发送调用方凭据,因此,预签名 URL(其签名位于查询字符串中)是受支持的形式。诸如 `/api/assets/{id}/content` 这样的需要认证的端点会向 Router 返回 401,而不是返回图像;请自行请求该 URL,并传递它重定向到的签名 URL。 +获取操作仅限于一组指定的主机,而不是开放的互联网,并且同一列表会重新应用于每一次重定向跳转以及你发送的 URL:因此,任何其他主机上的 URL,或者重定向到列表之外的 URL,都会在联系任何提供商之前被拒绝。目前,该列表仅包含 Comfy 自己的资产分发:位于 Comfy 资产存储桶下的已签名 `storage.googleapis.com` URL,也就是 `/api/assets/{id}/content` 重定向到的形式。合作伙伴 CDN 或普通 https 主机不在该列表中。 +两项扩展正在逐步推出,并且目前都默认关闭。它们通过同一个切换项发布并一起启用,因此请将下面所有内容视为即将推出,而不是现阶段可据以开发的功能:在依赖其中任何一项之前,请先询问。 +第一项是 `POST /customers/storage` 为你的上传签名并指向的存储桶。在该推广覆盖你的环境之前,来自该端点的上传 URL 会在此处被拒绝,即使该存储桶属于 Comfy 且主机相同也是如此:因此,“先上传到 Comfy,再传递 URL”目前不可用,而可用的形式是 `/api/assets/{id}/content` 重定向到的签名 URL。 +第二项是按账户启用,而不是一次性对所有人启用,因为这些主机背后的存储桶属于你而不是我们:即使上面的切换项已开启,未启用第三方入站媒体的账户也会被拒绝,并会收到这样的提示,而不是被告知该主机不受支持。请联系你的 Comfy 联系人,为你的账户启用它。它还会额外允许这些第三方对象存储主机,在这些主机中存储桶属于你,Router 不对其主张所有权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,可以是路径样式或带 `.` 前缀的形式)、Azure Blob Storage(`.blob.core.windows.net`)以及 Alibaba Cloud OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域名上的通用端点(例如 Alibaba Function Compute 触发器)不在列表中,并会被拒绝。 +匹配的是主机名形式,而不是提供商,因此上文指明某个提供商,并不意味着该提供商可签发的每个 URL 都会被接受;有三种近似但不会被接受的形式值得直接说明,因为调用方完全可能带着其中任意一种形式到来。R2 自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 说明为受速率限制的调试主机名,并改为将生产流量指向自定义域名;但自定义域名的主机名中不包含任何可将其标识为 R2 的信息,因此 Router 无法将其与任何其他主机区分开来,并会拒绝它。请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 双栈端点(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)同样不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会明确指出这些相同的形式,因此无需到这里来阅读它们。 + +上文的 `` 与 `pub-` 占位符展示的是你通常会提交的形式;它们并不构成深度限制。匹配依据是对象存储域后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。这并不会放宽命名空间本身:后缀仍然必须是所列出的后缀之一。 + +下面的示例仅展示形状:真实值还会携带签名查询参数,这里有意省略了这些参数,因为已发布的示例会永远留在规范中,而真实签名既是被泄露的凭据,也是一个会失效的链接。 + +每张图像的上限为 25 MiB,单个请求的图像总量上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(发送 `image` 的调用),其中 `context_window` 可用:此时每张图像最大可为 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总量最大为 128 MiB。 + - 要运行的 gpt-image 模型。Router 会把所寻址的模型 id 拼接进去,因此寻址 /v2/models/openai/gpt-image-2 的调用方无需发送此字段。 + 要运行的 gpt-image 模型。Router 会把所寻址的模型 ID 拼接进去,因此调用方在寻址 /v2/models/openai/gpt-image-2.6-flare 时无需发送此字段。 @@ -191,52 +208,52 @@ URL 必须在不使用你的凭据的情况下完成解析。Router 会在服务 - 要生成的图像数量(1-10)。 + 要生成的图像数量(1-10)。GIF 请求(见 `output_format`)会拒绝除 1 以外的任何值:OpenAI 自己的描述将 GIF 请求中的 `n` 称为“动画数量”,Router 在 v1 中并未对此定价。 范围:`1` 到 `10` - JPEG 或 WebP 的压缩级别(0-100) + JPEG 或 WebP 的压缩级别(0-100)。在 GIF 请求中会被拒绝:OpenAI 不接受针对动画输出的压缩级别。 范围:`0` 到 `100` - 输出图像的格式 + 输出图像的格式。`gif` 还会拒绝 `mask`、不为 1 的 `n`、省略的 `size`、`auto` 或格式错误的 `size`、`stream: true`、大于 0 的 `partial_images` 以及 `output_compression`(参见各字段自己的描述),并且除非 Comfy 已为此环境启用它,否则会被直接拒绝。 - 可能的值:`png`、`webp`、`jpeg` + 可能的值:`png`、`webp`、`jpeg`、`gif` - 只有配合实时流才有意义,而本接口无法提供实时流:即使你发送 `stream`,它也会被固定为 `false`。在生成请求中,任何不是 `0` 或 `null` 的值都会被以 400 拒绝,无论请求是否同时发送 `stream: true`;在携带 `image` 的请求中,该字段会被丢弃而不是转发。请省略该字段。 + 仅在配合实时流时才有意义,而此接口无法提供实时流,这与 OpenAIImageRouterRequest 上的情况完全相同(参见该字段的描述)。在 GIF 请求中,大于 0 的值会被拒绝,原因与 `stream: true` 被拒绝相同;0 会被接受。 范围:`0` 到 `3` - 要生成的图像的文本描述,或要对 `image` 进行的编辑的文本描述。 + 要生成的图像、或要对 `image` 进行的编辑的文本描述。 - 生成或编辑后图像的质量。`xhigh` 和 `max` 是新增 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 时所引入的两个档位;`standard` 和 `hd` 是 dall-e 时代的拼写,任何已收录的模型都不会读取。 + 生成或编辑后的图像质量。`xhigh` 和 `max` 是两个层级,gpt-image-2.5-flare 与 gpt-image-2.5-sunburst 正是为此新增的;`standard` 和 `hd` 是 dall-e 时代的拼写,任何已接纳的模型都不会读取。 可能的值:`auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` - 图像的尺寸(例如 1024x1024、1536x1024、auto) + 图像尺寸(例如 1024x1024、1536x1024、auto)。GIF 请求(见 `output_format`)会拒绝 `auto`,也会拒绝省略此字段:显式尺寸可使预检报价与 64 MiB 的结果上限在帧数将它们成倍放大之前保持有限。 - 声明此字段是为了让发送它的调用方不会被拒绝,但它在当前接口上不生效:Router 在分发之前会把它固定为 `false`,因为它捕获的是提供商响应,而不是转发 `text/event-stream`(携带 `image` 的请求则会丢弃该字段,因为编辑结果会在不带该字段的情况下重新编码)。没有任何 Comfy 接口提供 gpt-image 的部分图像流式传输:v1 `POST /proxy/openai/images/generations` 入口会以 400 拒绝 `stream: true`,并且绝不会将请求转发到上游,因此请省略该字段,并将已完成的响应当作单个 JSON 正文读取。由于流从未打开,OpenAI 关于将 `stream: true` 与大于 1 的 `n` 组合使用的限制在此处不适用;`n` 会按发送时的值转发。 + 声明此字段是为了让发送它的调用方不会被拒绝,但它在当前接口上不起作用,与 OpenAIImageRouterRequest 上的情况完全相同(参见该字段的描述)。在 GIF 请求中,`true` 会被拒绝(OpenAI 的指南指出 GIF 输出不支持流式传输);`false` 会被接受。 - 用于最终用户监控的唯一标识符 + 用于终端用户监控的唯一标识符 -根据 Router 在 `GET /v2/models/openai/gpt-image-2.6-flare/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/openai/gpt-image-2.6-flare/openapi.json` 提供的 schema 生成;Router 会在请求到达提供商之前,使用同一份文档校验调用。 ### 输出 @@ -297,25 +314,25 @@ URL 必须在不使用你的凭据的情况下完成解析。Router 会在服务 - 生成的图像背景是 `opaque` 还是 `transparent`,以 OpenAI 为本次生成解析的结果为准。请求参数默认为 `auto`,因此未固定该参数的调用方可以在这里得知实际生成的是哪一种。 + 已生成图像的背景是 `opaque` 还是 `transparent`,以 OpenAI 为本次生成解析出的结果为准。请求参数默认为 `auto`,因此未固定该参数的调用方可以在这里得知实际生成的是哪一种。 - 生成完成时的 Unix 时间戳,单位为秒。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要生产者是 OpenAI 它就会出现;在任一由 alt 后端支持的 id 上,由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与其他四个已解析参数成员一样。声明为 `int64` 是因为当前时代的 epoch 值已足够接近 2^31,未格式化的 `integer` 会在许多 SDK 生成器中生成 32 位字段。 + 生成完成时的 Unix 时间戳,单位为秒。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要生产者是 OpenAI 它就会出现;在任何 alt 后端的 id 上,由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与另外四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 值已经足够接近 2^31,若使用未格式化的 `integer`,许多 SDK 生成器会生成 32 位字段。 格式:`int64` - `data[].b64_json` 中字节的编码格式,为 `png`、`webp` 或 `jpeg`。它是 OpenAI 实际编码的格式:若请求中发送了 `output_format`,则为请求中的该值;若未发送,则为 `png`。因此解码器可以直接依据它,而不必从请求中重新推导格式。 + `data[].b64_json` 中字节的编码,为 `png`、`webp` 或 `jpeg`。它是 OpenAI 实际编码所用的格式:发送了请求中的 `output_format` 时就是该值,未发送时为 `png`,因此解码器可以直接以它为依据,而不必从请求中重新推断格式。 - 生成实际运行时使用的质量档位:OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。它是已解析的档位,而不是对请求的回显,因为请求自身的 `quality` 默认为 `auto`。 + 本次生成实际使用的质量档位:OpenAI 报告的是 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。它是已解析的档位,而不是对请求的回显,请求自身的 `quality` 默认为 `auto`。 - 生成实际运行时使用的像素尺寸,格式为 `x`。它是已解析的尺寸:请求的 `size` 默认为 `auto` 且明确接受 `auto`,因此这里是唯一报告实际使用尺寸的地方。 + 本次生成实际使用的像素尺寸,形式为 `x`。它是已解析的尺寸:请求的 `size` 默认为 `auto` 且明确接受 `auto`,因此这里是唯一报告实际所用尺寸的地方。 ## 示例 diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index e6c3e81a3b..c3fa465399 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -2,14 +2,15 @@ title: "使用 Comfy Router 调用 GPT Image 2.6 Sunburst" description: "通过 Comfy Router 调用 openai/gpt-image-2.6-sunburst:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "GPT Image 2.6 Sunburst" -translationSourceHash: e71f1905 +translationSourceHash: 4e6d4ec0 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx translationBlockHashes: "_intro": 280b9c93 "Quick start": 2d3cb42c - "Schema": 2a71e1a8 + "Schema": 5296621a "Examples": c73859ec --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/openai/gpt-image-2.6-sunburst.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -154,34 +155,47 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ ### 输入 - 背景透明度。`auto` 由模型自行选择。 + 背景透明度。`auto` 让模型自行选择。 + + 可能的值:`transparent`、`opaque`、`auto` + + + + 动画 GIF 的帧数(2-16,OpenAI 自身的范围),仅在 `output_format: "gif"` 时才有意义,与其他任何 `output_format` 一起使用都会被拒绝。在 GIF 请求中省略该字段时,默认为 OpenAI 自身的默认值 9;但 Comfy 还会按环境额外限制该字段(ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES,永远不会超过该字段自身的最大值 16):超过所配置上限的值会被拒绝;当默认值 9 本身超过所配置的上限时,省略的 `frame_count` 会被拒绝,而不是被静默下调,这样调用方会被告知需要显式设置 `frame_count`,而不是收到一个比 OpenAI 默认值悄悄更小的动画。帧数同时也决定预检报价和 64 MiB 结果上限的边界,二者都随帧数缩放。 - 可选值:`transparent`、`opaque`、`auto` + 范围:`2` 到 `16` + + + + 每一帧显示的毫秒数(OpenAI 自身的范围是 20-2000,会四舍五入到 10 ms),仅在 `output_format: "gif"` 时才有意义,与其他任何 `output_format` 一起使用都会被拒绝。在 GIF 请求中省略时采用 OpenAI 自身的默认值 200。 + + 范围:`20` 到 `2000` - 要编辑的来源图像。此字段的出现即选定编辑操作,文生图生成时请完全省略该字段。 -模型公布的示例是生成调用,它省略了该字段。添加 `image` 就是两种模式之间的全部差异:相同的 endpoint、相同的模型 id。区别在于,编辑提示词描述的是你想要的“更改”而不是场景,因此下面的编辑请求体读起来与生成示例不同,尽管在结构上只有这一个字段是新增的。 -它可以按原样复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。该 payload 是一个完整的 1x1 PNG,并非缩写,而且这个请求体已在 Router 自己的请求验证测试中固定为已接受的用例。替换为你自己图像的字节即可。 -接受一张图像或一个图像数组;gpt-image-1 及之后的模型最多接受 16 张,Router 会在派发之前依据此 schema 强制执行。 + 要编辑的来源图像。该字段的出现即选中编辑操作:若要进行文生图生成,请完全省略它。 +模型公布的示例是生成调用,它省略了该字段。添加 `image` 就是两种模式之间的全部差异:相同的端点、相同的模型 id。只不过编辑提示词描述的是你想要的更改,而不是场景,所以下面的编辑请求体读起来与生成示例不同,即使从结构上看只有这个字段是新增的。 +它可以按原样复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`:该载荷是一个完整的 1x1 PNG,而不是缩写,并且该请求体在 Router 自身的请求验证测试中被固定为可通过的用例。请替换为你自己图像的字节。 +接受一张图像,或由它们组成的数组;gpt-image-1 及之后的版本最多接受 16 张,Router 会在派发之前依据此 schema 强制实施。 - 一张图像,形式为 Router 代表调用方抓取的 https URL,或携带内联字节的 `data:image/;base64,` URI。接受的图像类型为 png、webp 和 jpeg,该集合在解析时就会被强制执行,而不是留给提供商:svg、gif、avif 或 tiff 会在这里被拒绝,并指明你发送的图像,而不会在距离原因两跳之外变成一个合作伙伴错误。 -优先使用 URL 形式。base64 payload 大约膨胀 4/3,而整个请求体上限为 100 MiB,因此内联形式的上限约为 75 MB 的来源图像;URL 则完全绕过这一点。本描述末尾说明的单张图像与单次请求媒体上限比请求体上限更严格,因此对于任何实际尺寸的图像,你首先遇到的就是它们。 -URL 必须在不携带你的凭证的情况下可解析。Router 在服务器端抓取它,并且不会随请求发送任何调用方凭证,因此受支持的形式是预签名 URL,即签名位于查询字符串中的 URL。诸如 `/api/assets/{id}/content` 这类需要认证的 endpoint 会向 Router 返回 401 而不是图像;请自行请求该 URL,并传入它重定向到的已签名 URL。 -抓取被限制在一组指定的主机上,而不是整个开放互联网;同一份列表既会应用于你发送的 URL,也会重新应用于每一次重定向跳转,因此位于其他任何主机上的 URL,或者会重定向到列表之外的主机,都会在任何提供商被联系之前被拒绝。如今该列表仅包含 Comfy 自己的资产分发:Comfy 资产桶下的已签名 `storage.googleapis.com` URL,这正是 `/api/assets/{id}/content` 重定向你前往的形式。合作伙伴 CDN 或普通的 https 主机不在列表上。 -两项放宽正在逐步推出,目前都默认关闭。它们通过同一个切换发布并一起启用,因此请把下面的一切视为即将到来,而不是现在就可以依赖的东西:在依赖其中任何一项之前请先询问。 -第一项是 `POST /customers/storage` 为你的上传签发到的那个桶。在推出覆盖到你的环境之前,来自该 endpoint 的上传 URL 会在这里被拒绝,即使该桶属于 Comfy 自己、主机也是同一个,因此“上传到 Comfy,然后传入 URL”这种方式目前不可用,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 -第二项是按账户启用,而不是一次对所有人开放,因为这些主机背后的桶属于你而不是我们:即使上面的切换已打开,未启用第三方入站媒体的账户仍会被拒绝,并会被明确这样告知,而不是被告知该主机不受支持。请联系你的 Comfy 联系人,为你的账户启用它。它还会额外接纳以下第三方对象存储主机,其中桶属于你,Router 不对其主张所属:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,可采用 path-style 或带 `.` 前缀的形式)、Azure Blob Storage(`.blob.core.windows.net`)以及阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` endpoint)。这些明确是对象存储 endpoint:同一提供商域名下的常规用途 endpoint,例如阿里云函数计算的触发器,不在列表上,会被拒绝。 -匹配的是主机名形式,而不是提供商,因此上面列出某个提供商并不意味着该提供商能签发的每一个 URL 都会被接受;有三个近似但不符合的形式值得直接说明,因为调用方有理由带着其中每一个前来。R2 的自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为有速率限制的调试主机名,并把生产流量指向自定义域名,但自定义域名的主机名中没有任何标识说明它是 R2,因此 Router 无法把它与其他任何主机区分开来,会拒绝它,请为该 `.r2.cloudflarestorage.com` endpoint 生成预签名,或者使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack endpoint(`s3.dualstack..amazonaws.com`)也不被接受;请使用普通的区域 endpoint。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)同样不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此你不必特意来这里阅读它们。 -上面的 `` 和 `pub-` 占位符展示的是你通常带来的形式,它们并不是深度限制。匹配依据是对象存储的域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。但这一规则并不会放宽命名空间本身:后缀仍必须是所列出的其中之一。 -下面的示例只展示形状:真实值还带有签名查询参数,这里刻意省略了它们,因为已发布的示例会永远留在规范中,而真实签名既是被泄露的凭据,也是一个会失效的链接。 -每张图像上限为 25 MiB,单个请求的图像总量上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(会发送 `image` 的调用),其中可使用 `context_window`:在那里每张图像最大可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总量最大为 128 MiB。 + 一张图像,形式可以是 Router 代表调用方抓取的 https URL,也可以是内联携带字节的 `data:image/;base64,` URI。可接受的图像类型为 png、webp 和 jpeg,该集合在解析时就会被强制执行,而不是留给提供商:svg、gif、avif 或 tiff 会在这里被拒绝,并指明你发送的图像,而不会变成距离原因两跳之外的合作伙伴错误。 +优先使用 URL 形式。base64 载荷大约会膨胀 4/3,而整个请求体上限为 100 MiB,因此内联形式在来源图像接近 75 MB 时就到顶了;URL 则完全绕开这一点。本描述末尾所述的单图像与单请求媒体上限比请求体上限更严格,因此对于任何实际尺寸的图像,你会先触碰到它们。 +URL 必须在不携带你的凭证的情况下解析成功。Router 在服务器端抓取它,不会随请求发送任何调用方凭证,因此受支持的形式是预签名 URL,即签名位于查询字符串中的 URL。像 `/api/assets/{id}/content` 这样的需要认证的端点会向 Router 返回 401 而不是图像;请自行请求该 URL,并传入它重定向到的已签名 URL。 +抓取被限制在一组具名主机之内,而不是整个开放互联网,并且同一份列表会重新应用于你发送的 URL 以及每一次重定向跳转:因此任何其他主机上的 URL,或重定向到列表之外的 URL,都会在联系任何提供商之前被拒绝。目前该列表仅包含 Comfy 自己的资产分发:Comfy 资产桶下的已签名 `storage.googleapis.com` URL,这正是 `/api/assets/{id}/content` 重定向你到的形式。合作伙伴 CDN 或普通 https 主机不在该列表上。 +两项放宽正在逐步推出,且目前都默认关闭。它们通过一个切换开关发布并一起启用,因此请把下面所有内容视为尚未到来,而不是现在就能依赖的东西:在依赖其中任何一项之前请先询问。 +第一项是 `POST /customers/storage` 为你的上传签名的桶。在推出到达你的环境之前,来自该端点的上传 URL 会在这里被拒绝,即使该桶属于 Comfy 且主机也是同一个:因此“先上传到 Comfy,再传入 URL”目前并不成立,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 +第二项是按账号启用,而不是对所有人一次性启用,因为这些主机背后的桶属于你而不是我们:即使上面的开关已打开,未启用第三方入站媒体的账号仍会被拒绝,并会明确告知这一点,而不是被告知主机不受支持。请联系你的 Comfy 联系人,为你的账号启用它。它还会额外允许以下第三方对象存储主机,这些主机上的桶属于你,Router 不对其主张任何所属权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 以及 `s3..amazonaws.com`,采用路径式或 `.` 前缀式均可)、Azure Blob Storage(`.blob.core.windows.net`)和阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域上的通用端点,例如阿里云函数计算的触发器,不在该列表上,会被拒绝。 +匹配的是主机名形式,而不是提供商,因此在上文指定提供商并不代表该提供商能签发的每个 URL 都会被接受;有三种近似但不被接受的形式值得直接说明,因为调用方完全可能带着其中任何一种形式到来。R2 自定义域名(`cdn.example.com`)不会被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并将生产流量改为指向自定义域名,但自定义域名的主机名中没有任何内容能表明它属于 R2,因此 Router 无法将其与任何其他主机区分开来,并会拒绝它。请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 双栈端点(`s3.dualstack..amazonaws.com`)同样不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)也不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此你不必特意来这里阅读它们。 +上面的 `` 和 `pub-` 占位符展示了你通常会带来的形式;它们不是深度限制。匹配依据是对象存储域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。但这并不会放宽命名空间本身:后缀仍然必须是所列后缀之一。 +下面的示例仅展示形式:真实值还会带有签名查询参数,这里有意省略了它们,因为已发布的示例会永远留在规范中,而真实签名既是被泄露的凭据,也是会失效的链接。 +每张图像上限为 25 MiB,单个请求的图像总量上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(即发送 `image` 且 `context_window` 可用的调用):在该调用中,每张图像最大可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总量最大可达 128 MiB。 + - 要运行的 gpt-image 模型。Router 会把所寻址的模型 id 拼接进去,因此寻址 /v2/models/openai/gpt-image-2 的调用方不需要发送此字段。 + 要运行的 gpt-image 模型。Router 会把所寻址的模型 ID 拼接进去,因此寻址 /v2/models/openai/gpt-image-2.6-flare 的调用方无需发送此字段。 @@ -191,52 +205,52 @@ URL 必须在不携带你的凭证的情况下可解析。Router 在服务器端 - 要生成的图像数量(1-10)。 + 要生成的图像数量(1-10)。GIF 请求(参见 `output_format`)会拒绝除 1 以外的任何值:OpenAI 自己的描述将 GIF 请求中的 `n` 称为“动画数量”,Router 在 v1 中并未为此定价。 范围:`1` 到 `10` - JPEG 或 WebP 的压缩级别(0-100) + JPEG 或 WebP 的压缩级别(0-100)。在 GIF 请求中会被拒绝:OpenAI 不接受动画输出的压缩级别。 范围:`0` 到 `100` - 输出图像的格式 + 输出图像的格式。`gif` 还会拒绝 `mask`、不为 1 的 `n`、省略的、`auto` 或格式错误的 `size`、`stream: true`、大于 0 的 `partial_images` 以及 `output_compression`(参见各字段自身的描述),并且除非 Comfy 已为此环境启用它,否则会被直接拒绝。 - 可能的值:`png`、`webp`、`jpeg` + 可能的值:`png`、`webp`、`jpeg`、`gif` - 仅在配合实时流时才有意义,而此接口无法提供实时流:即使你发送了 `stream`,它也会被固定为 `false`。在生成请求中,除 `0` 或 `null` 以外的任何值都会被以 400 拒绝,无论请求是否同时发送 `stream: true`;在携带 `image` 的请求中,该字段会被丢弃而不会转发。请省略它。 + 仅在与实时流配合时才有意义,而此接口无法提供实时流,情况与 OpenAIImageRouterRequest 上完全相同:参见该字段的描述。在 GIF 请求中,大于 0 会被拒绝,原因与 `stream: true` 被拒绝相同;0 会被接受。 范围:`0` 到 `3` - 要生成的图像的文本描述,或要对 `image` 所做的编辑的文本描述。 + 用于描述要生成的图像,或描述要对 `image` 进行的编辑的文本。 - 已生成或已编辑图像的质量。`xhigh` 和 `max` 是新增 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 所针对的两个档位;`standard` 和 `hd` 是 dall-e 时代的写法,任何已准入的模型都不会读取它们。 + 已生成或已编辑图像的质量。`xhigh` 和 `max` 是 gpt-image-2.5-flare 与 gpt-image-2.5-sunburst 被新增以支持的两个层级;`standard` 和 `hd` 是 dall-e 时代的拼写,任何已接纳的模型都不会读取。 可能的值:`auto`、`low`、`medium`、`high`、`xhigh`、`max`、`standard`、`hd` - 图像的尺寸(例如 1024x1024、1536x1024、auto) + 图像尺寸(例如 1024x1024、1536x1024、auto)。GIF 请求(参见 `output_format`)会拒绝 `auto`,也会拒绝省略此字段:显式尺寸正是让预检报价和 64 MiB 的结果上限在一个会将其倍增的帧数到来之前保持有限的关键。 - 声明它是为了让发送它的调用方不被拒绝,但它在此接口上无效(INERT):Router 会在派发之前将其固定为 `false`,因为它捕获提供商响应而不是转发 `text/event-stream`(携带 `image` 的请求则会丢弃该字段,因为编辑结果是在没有它的情况下重新编码的)。没有任何 Comfy 接口提供 gpt-image 的部分图像流式传输:v1 `POST /proxy/openai/images/generations` 入口会以 400 拒绝 `stream: true`,并且绝不会把请求转发到上游,因此请省略该字段,并将已完成的响应作为单个 JSON 主体读取。由于流从未打开,OpenAI 关于将 `stream: true` 与大于 1 的 `n` 组合的限制在这里并不适用;`n` 会按原样转发。 + 声明此字段是为了让发送它的调用方不会被拒绝,但它在此接口上不起作用,与在 OpenAIImageRouterRequest 上完全相同:参见该字段的描述。在 GIF 请求中 `true` 会被拒绝(OpenAI 的指南指出 GIF 输出不支持流式传输);`false` 会被接受。 - 用于终端用户监控的唯一标识符 + 用于最终用户监控的唯一标识符 -由 Router 在 `GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -297,25 +311,25 @@ URL 必须在不携带你的凭证的情况下可解析。Router 在服务器端 - 已生成图像的背景是 `opaque` 还是 `transparent`,即 OpenAI 为本次生成所解析的结果。请求参数默认值为 `auto`,因此未固定该参数的调用方可以在这里得知实际生成的是哪一种。 + 已生成图像的背景是 `opaque` 还是 `transparent`,由 OpenAI 针对本次生成解析得出。请求参数默认为 `auto`,因此未固定该参数的调用方可在此处得知实际产出的是哪一种。 - 生成完成时的 Unix 时间戳(以秒为单位)。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要由 OpenAI 生成,该字段就一定存在;而在任何 alt-backed id 上由 fal、pika、wavespeed 或 runware 提供的响应则会完全省略它,与其他四个已解析参数成员一样。声明为 `int64`,是因为当前的时间戳值已足够接近 2^31,未格式化的 `integer` 在许多 SDK 生成器中会生成 32 位字段。 + 生成完成时的 Unix 时间戳(单位为秒)。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要生产者是 OpenAI,该字段就会出现;而在任一 alt 后端 id 上由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与其他四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 数值已非常接近 2^31,未格式化的 `integer` 在许多 SDK 生成器中会生成 32 位字段。 格式:`int64` - `data[].b64_json` 中字节的编码格式,为 `png`、`webp` 或 `jpeg`。它是 OpenAI 实际编码所用的格式:如果请求中发送了 `output_format`,则为该值;如果未发送,则为 `png`。因此解码器可以直接依据它,而无需再从请求中重新推导格式。 + `data[].b64_json` 中字节的编码格式:`png`、`webp` 或 `jpeg`。这是 OpenAI 实际编码所用的格式,即请求中发送了 `output_format` 时取该值,未发送时为 `png`,因此解码器可以据此判断,而不必再从请求中重新推导格式。 - 本次生成实际使用的质量档位,OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。它是已解析的档位,而不是对请求的回显,因为请求自身的 `quality` 默认值为 `auto`。 + 本次生成实际使用的质量档位:OpenAI 会报告 `low`、`medium`、`high`、`xhigh` 或 `max` 之一。这是已解析的档位,而不是对请求的回显,因为请求自身的 `quality` 默认为 `auto`。 - 本次生成实际使用的像素尺寸,格式为 `x`。它是已解析的尺寸:请求的 `size` 默认值为 `auto`,并且显式接受 `auto`,因此这里是唯一报告实际所用尺寸的地方。 + 本次生成实际使用的像素尺寸,格式为 `x`。这是已解析的尺寸:请求中的 `size` 默认为 `auto`,并且显式允许 `auto`,因此此处是唯一报告实际所用尺寸的地方。 ## 示例 diff --git a/zh/development/comfy-router/models/pixverse/v3-5/code.mdx b/zh/development/comfy-router/models/pixverse/v3-5/code.mdx new file mode 100644 index 0000000000..c40f618e2b --- /dev/null +++ b/zh/development/comfy-router/models/pixverse/v3-5/code.mdx @@ -0,0 +1,309 @@ +--- +title: "通过 Comfy Router 使用 V3.5" +description: "通过 Comfy Router 调用 pixverse/v3.5:端点、请求结构和 Router 返回的响应。" +sidebarTitle: "V3.5" +translationSourceHash: c6a6b3a8 +translationFrom: development/comfy-router/models/pixverse/v3-5/code.mdx +translationBlockHashes: + "_intro": 2772d5c1 + "Quick start": dc3a1030 + "Schema": 48bf7abc + "Examples": 0600cc10 +--- +{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/pixverse/v3.5.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`pixverse/v3.5` 的 API 参考,由 Comfy Router 从 Pixverse 提供。 + +**输入:** 文本 · **输出:** 视频 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建一个密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段是通过原始 HTTP 进行的同一调用。 + +**模型 ID:** `pixverse/v3.5` + +**端点:** `POST https://api.comfy.org/v2/models/pixverse/v3.5` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "pixverse/v3.5", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("pixverse/v3.5", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v3.5 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +同一个请求体,发送到 `POST https://api.comfy.org/v2/models/pixverse/v3.5/requests`。运行被受理后,Router 会立即返回 `201` 和 `request_id`,结果准备就绪后即可收集,收集方可以是当前进程,也可以是另一个进程。[排队交付](/zh/development/comfy-router/queue)介绍了状态、取消和收集的完整流程。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v3.5", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # 连同模型 ID,这就是另一个进程所需的全部信息。 + + # 轮询直到请求完成,并等待服务器指定的 Retry-After 时间。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自身的 payload,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在这里抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("pixverse/v3.5", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,以及 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/pixverse/v3.5/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. 轮询直到 status 为 COMPLETED,并等待每个响应指定的 Retry-After 秒数。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v3.5/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。返回 200 和模型的原生输出;若仍在运行,则返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/pixverse/v3.5/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`2:3`、`3:2`、`21:9` + + + + 范围:`1` 到 `15` + + + + + + + + PixVerse 文生视频模型标识符。在 Comfy Router 的 `POST /v2/models/pixverse/{model}` 路由上,该字段由路径提供,可以省略。 + + + + 可选值:`normal`、`fast` + + + + + + + + + + + + 可选值:`360p`、`540p`、`720p`、`1080p` + + + + + + + + 可选值:`anime`、`3d_animation`、`clay`、`comic`、`cyberpunk` + + + + + + + + + + +本文档根据 Router 在 `GET /v2/models/pixverse/v3.5/openapi.json` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前用于校验调用的同一份文档。 + +### 输出 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 可选值:`1`、`5`、`6`、`7`、`8` + + + + + + + + + + +## 示例 + +### 输入 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 输出 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + + diff --git a/zh/development/comfy-router/models/pixverse/v6-max/code.mdx b/zh/development/comfy-router/models/pixverse/v6-max/code.mdx new file mode 100644 index 0000000000..518723cf46 --- /dev/null +++ b/zh/development/comfy-router/models/pixverse/v6-max/code.mdx @@ -0,0 +1,309 @@ +--- +title: "通过 Comfy Router 使用 V6 Max" +description: "通过 Comfy Router 调用 pixverse/v6-max:接口端点、请求结构以及 Router 返回的响应。" +sidebarTitle: "V6 Max" +translationSourceHash: fe910720 +translationFrom: development/comfy-router/models/pixverse/v6-max/code.mdx +translationBlockHashes: + "_intro": 79517cb6 + "Quick start": 3197f978 + "Schema": 982f249f + "Examples": 0600cc10 +--- +{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/pixverse/v6-max.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`pixverse/v6-max` 的 API 参考,由 Comfy Router 从 Pixverse 提供。 + +**输入:** 文本 · **输出:** 视频 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段则是通过原生 HTTP 发起的同一调用。 + +**模型 ID:** `pixverse/v6-max` + +**端点:** `POST https://api.comfy.org/v2/models/pixverse/v6-max` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量中读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "pixverse/v6-max", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("pixverse/v6-max", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v6-max \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +同样的请求体,发送到 `POST https://api.comfy.org/v2/models/pixverse/v6-max/requests`。一旦运行被接纳,Router 就会返回 `201` 和一个 `request_id`;结果就绪后即可获取,可以由当前进程获取,也可以由另一个进程获取。[队列投递](/zh/development/comfy-router/queue) 逐步介绍了状态查询、取消和结果获取。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量中读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v6-max", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # 配合模型 ID,就是另一个进程所需的全部信息 + + # 轮询直到请求完成,按服务器给出的 Retry-After 等待。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自己的载荷,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在这里抛出带类型的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("pixverse/v6-max", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并带有 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/pixverse/v6-max/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. 轮询直到状态为 COMPLETED,按每次响应给出的 Retry-After 秒数等待。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v6-max/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 获取。返回 200 和模型的原生输出;若仍在运行,则返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/pixverse/v6-max/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`2:3`、`3:2`、`21:9` + + + + 范围:`1` 到 `15` + + + + + + + + PixVerse 文生视频模型标识符。在 Comfy Router 路由 `POST /v2/models/pixverse/{model}` 上,该字段由路径提供,可以省略。 + + + + 可选值:`normal`、`fast` + + + + + + + + + + + + 可选值:`360p`、`540p`、`720p`、`1080p` + + + + + + + + 可选值:`anime`、`3d_animation`、`clay`、`comic`、`cyberpunk` + + + + + + + + + + +根据 Router 在 `GET /v2/models/pixverse/v6-max/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。 + +### 输出 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 可选值:`1`、`5`、`6`、`7`、`8` + + + + + + + + + + +## 示例 + +### 输入 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 输出 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + + diff --git a/zh/development/comfy-router/models/pixverse/v6/code.mdx b/zh/development/comfy-router/models/pixverse/v6/code.mdx new file mode 100644 index 0000000000..8b36267703 --- /dev/null +++ b/zh/development/comfy-router/models/pixverse/v6/code.mdx @@ -0,0 +1,311 @@ +--- +title: "使用 V6 与 Comfy Router" +description: "通过 Comfy Router 调用 pixverse/v6:端点、请求形状以及 Router 返回的响应。" +sidebarTitle: "V6" +translationSourceHash: a19e855d +translationFrom: development/comfy-router/models/pixverse/v6/code.mdx +translationBlockHashes: + "_intro": f933db97 + "Quick start": cbf8e767 + "Schema": f1b3a5fb + "Examples": 0600cc10 +--- +{/* GENERATED FILE. 由 `pnpm code-pages:gen` 从 router-schemas/pixverse/v6.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`pixverse/v6` 的 API 参考,由 Comfy Router 从 Pixverse 提供。 + +**输入:** 文本 · **输出:** 视频 + + + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并把它导出为 `COMFY_API_KEY`。Python 和 TypeScript 片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 片段则是通过原始 HTTP 发出的同一调用。 + +**模型 ID:** `pixverse/v6` + +**端点:** `POST https://api.comfy.org/v2/models/pixverse/v6` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "pixverse/v6", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("pixverse/v6", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v6 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +同一个请求体,发送到 `POST https://api.comfy.org/v2/models/pixverse/v6/requests`。一旦运行被接纳,Router 立即返回 `201` 和 `request_id`;结果就绪后,即可从当前进程或其他进程收取。[排队投递](/zh/development/comfy-router/queue) 详细介绍了状态查询、取消和收取的流程。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v6", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # 加上模型 ID,就是另一个进程所需的全部信息 + + # 轮询直到请求完成,并按服务器指定的 Retry-After 等待。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自身的响应体,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在此处抛出带类型的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("pixverse/v6", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并附带 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/pixverse/v6/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. 轮询直到状态为 COMPLETED,每次响应中按 Retry-After 指定的秒数等待。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v6/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收取。200 返回模型的原生输出,仍在运行时则返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/pixverse/v6/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`2:3`、`3:2`、`21:9` + + + + 范围:`1` 到 `15` + + + + + + + + PixVerse 文生视频模型标识符。在 Comfy Router 的 `POST /v2/models/pixverse/{model}` 路由上,此字段由路径提供,可以省略。 + + + + 可选值:`normal`、`fast` + + + + + + + + + + + + 可选值:`360p`、`540p`、`720p`、`1080p` + + + + + + + + 可选值:`anime`、`3d_animation`、`clay`、`comic`、`cyberpunk` + + + + + + + + + + +该内容根据 Router 在 `GET /v2/models/pixverse/v6/openapi.json` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前用于校验调用的同一份文档。 + +### 输出 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 可选值:`1`、`5`、`6`、`7`、`8` + + + + + + + + + + +## 示例 + +### 输入 + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### 输出 + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + + diff --git a/zh/development/comfy-router/models/pruna/p-video-2/code.mdx b/zh/development/comfy-router/models/pruna/p-video-2/code.mdx index 1f68f51455..49e68a5360 100644 --- a/zh/development/comfy-router/models/pruna/p-video-2/code.mdx +++ b/zh/development/comfy-router/models/pruna/p-video-2/code.mdx @@ -2,16 +2,17 @@ title: "结合 Comfy Router 使用 P Video 2" description: "通过 Comfy Router 调用 pruna/p-video-2:介绍端点、请求结构以及 Router 返回的响应。" sidebarTitle: "P Video 2" -translationSourceHash: adc4bb77 +translationSourceHash: b7aa4ce2 translationFrom: development/comfy-router/models/pruna/p-video-2/code.mdx translationBlockHashes: "_intro": 7b513d6b "Quick start": 9d47988e - "Schema": 51d0cc63 + "Schema": 4bd9bf87 "Examples": 0d85c9fe --- + {/* GENERATED FILE. Generated from router-schemas/pruna/p-video-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -245,6 +246,34 @@ curl https://api.comfy.org/v2/models/pruna/p-video-2/requests/$REQUEST_ID \ 人类可读的进度信息。 + + Pruna 安全检查器的判定结果。当内容审核阻止了预测时,在 failed 状态下存在。 + + + + 安全检查器是否阻止了该预测。 + + + + 该阻止是否来自请求可以禁用的安全过滤。 + + + + 触发该阻止的内容政策分类,例如 sexual。 + + + + 关于该阻止的人类可读摘要。 + + + + 接受筛查的内容:input(提交的请求)或 output(已生成的视频)。 + + + + 关于该阻止的人类可读原因。 + + 预测状态:starting、processing、succeeded、failed 或 canceled。 diff --git a/zh/development/comfy-router/models/quiver/arrow-2-telos/code.mdx b/zh/development/comfy-router/models/quiver/arrow-2-telos/code.mdx new file mode 100644 index 0000000000..5d2883d12f --- /dev/null +++ b/zh/development/comfy-router/models/quiver/arrow-2-telos/code.mdx @@ -0,0 +1,284 @@ +--- +title: "将 Arrow 2 Telos 与 Comfy Router 搭配使用" +description: "通过 Comfy Router 调用 quiver/arrow-2-telos:端点、请求结构以及 Router 返回的响应。" +sidebarTitle: "Arrow 2 Telos" +translationSourceHash: 38ec271d +translationFrom: development/comfy-router/models/quiver/arrow-2-telos/code.mdx +translationBlockHashes: + "_intro": 7e87a52d + "Quick start": 63ad01e1 + "Schema": 76a21cd4 + "Examples": 36e915ba +--- +{/* GENERATED FILE. Generated from router-schemas/quiver/arrow-2-telos.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`quiver/arrow-2-telos` 的 API 参考,由 Comfy Router 从 Quiver 提供。 + +**输入:** 文本、图像 · **输出:** 图像 + +## 快速开始 + +在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段则是通过原始 HTTP 发起的同一调用。 + +**模型 ID:** `quiver/arrow-2-telos` + +**端点:** `POST https://api.comfy.org/v2/models/quiver/arrow-2-telos` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量中读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "quiver/arrow-2-telos", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("quiver/arrow-2-telos", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests`。任务一旦被接纳,Router 就立即返回 `201` 和 `request_id`,结果就绪后即可取回,可由当前进程取回,也可由另一个进程取回。[队列投递](/zh/development/comfy-router/queue) 介绍了状态查询、取消和结果取回。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量中读取 COMFY_API_KEY。 +# 每次调用 submit() 都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "quiver/arrow-2-telos", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # 加上模型 ID,就是另一个进程所需的全部信息 + + # 轮询直到请求完成,每次等待服务器指明的 Retry-After 时间。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自己的载荷,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在这里抛出带类型的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// 每次调用 submit() 都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("quiver/arrow-2-telos", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并带有 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" + +# 2. 轮询直到状态为 COMPLETED,每次响应都会指明需要等待的 Retry-After 秒数。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 取回。200 返回模型的原生输出,仍在运行时则返回 202 和状态响应体。 +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 额外的样式或格式指导 + + + + 输出 token 的最大数量 + + 范围:`1` 到 `131072` + + + + 用于 SVG 生成的模型标识符 + + + + 要生成的 SVG 数量 + + 范围:`1` 到 `16` + + + + 对先前输出中已存在的 token 施加的惩罚。`arrow-2-telos` 不接受采样参数,因此会忽略该项;在请求被转发之前,该字段会从请求中移除,且不会报错。 + + 范围:`-2` 到 `2` + + + + 所需 SVG 输出的文本描述 + + + + 可选的参考图像,用于引导样式/构图。接受 URL 对象、base64 对象或 URL 字符串简写形式。运行时限制因模型而异。 + + + + 采样温度。`arrow-2-telos` 不接受采样参数,因此会忽略该项;在请求被转发之前,该字段会从请求中移除,且不会报错。 + + 范围:`0` 到 `2` + + + + 核采样概率。`arrow-2-telos` 不接受采样参数,因此会忽略该项;在请求被转发之前,该字段会从请求中移除,且不会报错。 + + 范围:`0` 到 `1` + + +根据 Router 在 `GET /v2/models/quiver/arrow-2-telos/openapi.json` 提供的 schema 生成,该 schema 与请求到达提供商之前 Router 用于校验调用的文档相同。 + +### 输出 + + + 创建时间的 Unix 时间戳 + + + + 固定积分模型(如 arrow-1.1)的积分费用。对于按 token 计价的模型(如 arrow-2),此项会被省略,这些模型会在 usage 中报告实际测量的 token 总数。 + + 范围:`0` 到 `…` + + + + + + + + 输出的 MIME 类型 + + 可能的值:`image/svg+xml` + + + + 原始 SVG 标记 + + + + 本次生成的唯一标识符 + + + + 按 token 计价模型(如 arrow-2)的 token 总数。固定积分模型在此处可能会返回零值。 + + + + 按 token 计价模型的输入 token 数。 + + 范围:`0` 到 `…` + + + + 按 token 计价模型的输出 token 数。 + + 范围:`0` 到 `…` + + + + 按 token 计价模型的 token 总数。 + + 范围:`0` 到 `…` + + +## 示例 + +### 输入 + +```json +{ + "n": 1, + "prompt": "A single red maple leaf on a plain white background." +} +``` + +### 输出 + +```json +{ + "created": 1767225600, + "data": [ + { + "mime_type": "image/svg+xml", + "svg": "" + } + ], + "id": "svg_018f2c7a4b1e7c3d9a056e2f8b41d0c9", + "usage": { + "input_tokens": 180, + "output_tokens": 240, + "total_tokens": 420 + } +} +``` + + + diff --git a/zh/development/comfy-router/models/quiver/arrow-2/code.mdx b/zh/development/comfy-router/models/quiver/arrow-2/code.mdx new file mode 100644 index 0000000000..30a200d616 --- /dev/null +++ b/zh/development/comfy-router/models/quiver/arrow-2/code.mdx @@ -0,0 +1,284 @@ +--- +title: "搭配 Comfy Router 使用 Arrow 2" +description: "通过 Comfy Router 调用 quiver/arrow-2:端点、请求结构以及 Router 返回的响应。" +sidebarTitle: "Arrow 2" +translationSourceHash: e78a6b9f +translationFrom: development/comfy-router/models/quiver/arrow-2/code.mdx +translationBlockHashes: + "_intro": ef6a6611 + "Quick start": c39331bc + "Schema": d3c8d579 + "Examples": 36e915ba +--- +{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/quiver/arrow-2.json 生成。 */} + +import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; + +`quiver/arrow-2` 的 API 参考,该模型由 Comfy Router 从 Quiver 提供。 + +**输入:** 文本、图像 · **输出:** 图像 + +## 快速开始 + +在 [你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router) 中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 代码片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 代码片段是通过原始 HTTP 发起的相同调用。 + +**模型 ID:** `quiver/arrow-2` + +**端点:** `POST https://api.comfy.org/v2/models/quiver/arrow-2` + + + + +```python Python +from comfy_sdk import Comfy + +# 从环境变量中读取 COMFY_API_KEY。 +# SDK 会自动创建幂等键,并在自动重试时复用它。 +with Comfy() as client: + result = client.models.run( + "quiver/arrow-2", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// SDK 会自动创建幂等键,并在自动重试时复用它。 +const { data } = await comfy.models.run("quiver/arrow-2", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/quiver/arrow-2 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" +``` + + + +相同的请求体,发送到 `POST https://api.comfy.org/v2/models/quiver/arrow-2/requests`。运行一旦被接纳,Router 就会返回 `201` 和 `request_id`;结果准备就绪后,可从当前进程或其他进程收集。[队列投递](/zh/development/comfy-router/queue) 会介绍状态、取消和收集流程。 + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# 从环境变量中读取 COMFY_API_KEY。 +# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "quiver/arrow-2", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # 加上模型 ID,就是另一个进程所需的全部信息 + + # 轮询直到请求完成,并按照服务器指定的 Retry-After 等待。 + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # 提供商自身的负载,与 models.run() 返回的值相同。 + # 失败或已取消的请求会在这里抛出类型化的 Router 错误。 + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// 从环境变量中读取 COMFY_API_KEY。 +// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 +const handle = await comfy.models.submit("quiver/arrow-2", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); +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); +``` + +```bash cURL +# 1. 提交。Router 返回 201,并附带 request_id、status_url、response_url 和 cancel_url。 +curl https://api.comfy.org/v2/models/quiver/arrow-2/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" + +# 2. 轮询直到状态为 COMPLETED,并按每个响应指定的 Retry-After 秒数等待。 +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/quiver/arrow-2/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. 收集。200 表示模型的原始输出,202 表示仍在运行时返回的状态响应体。 +curl https://api.comfy.org/v2/models/quiver/arrow-2/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Schema + +### 输入 + + + 额外的风格或格式引导 + + + + 输出 token 的最大数量 + + 范围:`1` 到 `131072` + + + + 用于生成 SVG 的模型标识符 + + + + 要生成的 SVG 数量 + + 范围:`1` 到 `16` + + + + 对已出现在先前输出中的 token 进行惩罚。`arrow-2-telos` 会忽略此参数,因为它不接受采样参数;该字段会在请求被转发之前移除,且不会报错。 + + 范围:`-2` 到 `2` + + + + 所需 SVG 输出的文本描述 + + + + 可选的参考图像,用于引导风格/构图。接受 URL 对象、base64 对象或 URL 字符串简写。运行时限制因模型而异。 + + + + 采样温度。`arrow-2-telos` 会忽略此参数,因为它不接受采样参数;该字段会在请求被转发之前移除,且不会报错。 + + 范围:`0` 到 `2` + + + + 核采样概率。`arrow-2-telos` 会忽略此参数,因为它不接受采样参数;该字段会在请求被转发之前移除,且不会报错。 + + 范围:`0` 到 `1` + + +根据 Router 在 `GET /v2/models/quiver/arrow-2/openapi.json` 提供的 schema 生成,该 schema 也是它在请求到达提供商之前用于校验调用的同一份文档。 + +### 输出 + + + 创建时间的 Unix 时间戳 + + + + 固定积分模型(如 arrow-1.1)的积分费用。对于按 token 计价的模型(如 arrow-2)会省略此字段,这类模型会在 usage 中报告实际测量的 token 总数。 + + 范围:`0` 到 `…` + + + + + + + + 输出的 MIME 类型 + + 可能的值:`image/svg+xml` + + + + 原始 SVG 标记 + + + + 生成的唯一标识符 + + + + 按 token 计价的模型(如 arrow-2)的 token 总数。固定积分模型在此处可能报告为零。 + + + + 按 token 计价的模型的输入 token 数。 + + 范围:`0` 到 `…` + + + + 按 token 计价的模型的输出 token 数。 + + 范围:`0` 到 `…` + + + + 按 token 计价的模型的 token 总数。 + + 范围:`0` 到 `…` + + +## 示例 + +### 输入 + +```json +{ + "n": 1, + "prompt": "A single red maple leaf on a plain white background." +} +``` + +### 输出 + +```json +{ + "created": 1767225600, + "data": [ + { + "mime_type": "image/svg+xml", + "svg": "" + } + ], + "id": "svg_018f2c7a4b1e7c3d9a056e2f8b41d0c9", + "usage": { + "input_tokens": 180, + "output_tokens": 240, + "total_tokens": 420 + } +} +``` + + + diff --git a/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx b/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx index 1cdfe6dff9..200510cc86 100644 --- a/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx +++ b/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx @@ -2,17 +2,18 @@ title: "将 Veo 3.1 Fast Generate 001 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 veo/veo-3.1-fast-generate-001:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Veo 3.1 Fast Generate 001" -translationSourceHash: f5553980 +translationSourceHash: 436f69a6 translationFrom: development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx translationBlockHashes: "_intro": 2dd8ad2f "Quick start": 4f13f7f7 - "Schema": e44aea6d + "Schema": 2b639366 "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-fast-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -336,52 +337,53 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ 已生成视频的目标时长,单位为秒。Veo 2:5-8。Veo 3/3.1:4、6 或 8。默认值:8 - - 自动改进提示词以获得更高质量。默认为 true。 + + 自动优化提示词以获得更高质量。默认为 true。 - 生成视频的帧率,以每秒帧数为单位 + 已生成视频的帧率,单位为每秒帧数 - 是否在生成视频的同时生成音频。默认为 true。Veo 3.0+ 模型支持。 + 是否在生成视频的同时生成音频。默认为 true。由 Veo 3.0+ 模型支持。 - 描述在已生成视频中要避免出现的内容的文本 + 描述在已生成视频中应避免出现的内容的文本 - 控制已生成视频中的人物。默认值:allow_adult + 控制已生成视频中的人物。默认:allow_adult。 +出于相同的兼容性原因,也接受 `ALLOW` 和 `BLOCK`:Veo2GenVidRequest 的 personGeneration 枚举同样包含它们(参见该组件处的说明)。ComfyUI 的 Veo 3 合作伙伴节点(comfy_api_nodes/nodes_veo2.py)始终向 `/proxy/veo/{model}/generate` 发送这两种写法之一,而从不发送 Vertex 自己的写法,涉及 veo-3.1-generate-001、veo-3.1-fast-generate-001 和 veo-3.1-lite-generate-001,也就是本组件作为 Router 输入 schema 所对应的三个模型 ID。对于这些模型 ID 之一,在 Router 调度(`model_provider=veo`)时,无论是同步调用还是排队调用(`/v2/models/veo/{model}/requests`),`ALLOW` 都会在请求到达 Vertex 之前映射为 `allow_adult`,`BLOCK` 映射为 `dont_allow`(routerVeoMapPersonGeneration,server/middleware/router_veo_person_generation.go),因为 Vertex 本身两种写法都不接受。直接调用 v1 `/proxy/veo/:modelId/generate` 的调用方则两种情况下都不受影响:comfy-api 未在 `/proxy/*` 上安装任何请求校验器,因此该枚举在那里本来就是未强制执行的文档说明,而仅适用于 Router 的映射不会对它运行。 - 可选值:`dont_allow`、`allow_adult`、`allowAll` + 可选值:`dont_allow`、`allow_adult`、`allowAll`、`ALLOW`、`BLOCK` - 用于进度更新的 Cloud Pub/Sub 主题(projects/\{project}/topics/\{topic})。在使用 Comfy 凭据(非 BYOK)的请求中不被接受:如果该参数存在,generate 路由会返回 400,因为操作在 Comfy 的项目中运行,而 Vertex 会以 Comfy 服务代理的身份发布。仅在自带密钥(bring-your-own-key)的请求中被接受,此时 Vertex 会在你自己的项目中评估该主题的授权。 + 用于进度更新的 Cloud Pub/Sub 主题(projects/\{project}/topics/\{topic})。在使用 Comfy 凭据(非 BYOK)的请求上不被接受:生成路由若发现该参数存在会返回 400,因为该操作在 Comfy 的项目中运行,Vertex 将以 Comfy 的服务代理身份发布。仅在自带密钥的请求中被接受,此时 Vertex 会在你自己的项目中评估该主题的授权。 - 输入图像的调整大小方式。默认值:pad + 输入图像的调整大小方式。默认:pad 可选值:`pad`、`crop` - 输出视频分辨率。Veo 3.0+ 模型支持。默认值:720p + 输出视频分辨率。由 Veo 3.0+ 模型支持。默认:720p 可选值:`720p`、`1080p`、`4k` - 要生成的视频数量。如果未指定,则生成 1 个视频。 + 要生成的视频数量。若未指定,则生成 1 个视频。 范围:`1` 到 `4` - 用于确定性输出的随机种子。如果 sampleCount > 1,则每个视频使用不同的种子。 + 用于确定性输出的随机种子。若 sampleCount > 1,则每个视频使用不同的种子。 格式:`uint32` diff --git a/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx b/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx index b1982378b1..797b640d98 100644 --- a/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx +++ b/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx @@ -2,17 +2,18 @@ title: "使用 Comfy Router 调用 Veo 3.1 Generate 001" description: "通过 Comfy Router 调用 veo/veo-3.1-generate-001:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Veo 3.1 Generate 001" -translationSourceHash: 0fab4eef +translationSourceHash: 9721a315 translationFrom: development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx translationBlockHashes: "_intro": cba04c2d "Quick start": cd500ec3 - "Schema": 5618a5b3 + "Schema": afe36175 "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -337,29 +338,30 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 自动改进提示词以获得更高质量。默认值为 true。 + 自动优化提示词以获得更高质量。默认为 true。 - 生成视频的帧率,单位为帧每秒 + 已生成视频的帧率,单位为帧/秒 - 是否随视频一起生成音频。默认值为 true。由 Veo 3.0+ 模型支持。 + 是否在生成视频的同时生成音频。默认为 true。受 Veo 3.0+ 模型支持。 - 描述已生成视频中应避免出现内容的文本 + 描述在已生成视频中需要避免的内容的文本 - 控制已生成视频中的人物。默认值:allow_adult + 控制已生成视频中的人物。默认值:allow_adult。 +`ALLOW` 和 `BLOCK` 也被接受,出于同样的兼容性原因,Veo2GenVidRequest 的 personGeneration 枚举也包含它们(参见该组件处的说明):ComfyUI 的 Veo 3 合作伙伴节点(comfy_api_nodes/nodes_veo2.py)始终会将这两种拼写之一(绝不会是 Vertex 自己的拼写)发送到 `/proxy/veo/{model}/generate`,用于 veo-3.1-generate-001、veo-3.1-fast-generate-001 和 veo-3.1-lite-generate-001,也就是此组件作为 Router 输入 schema 所对应的三个 id。对于这些 id 之一,在 Router 分发(`model_provider=veo`)中,无论是同步还是排队(`/v2/models/veo/{model}/requests`),`ALLOW` 都会在请求到达 Vertex 之前映射为 `allow_adult`,`BLOCK` 映射为 `dont_allow`(routerVeoMapPersonGeneration,server/middleware/router_veo_person_generation.go),因为 Vertex 本身不接受这两种拼写中的任何一种。直接调用 v1 `/proxy/veo/:modelId/generate` 的调用方在两种情况下都不受影响:comfy-api 未在 `/proxy/*` 上安装请求校验器,因此这个枚举在那里本来就已经是不强制执行的文档说明,而仅限 Router 的映射也不会为它运行。 - 可选值:`dont_allow`、`allow_adult`、`allowAll` + 可选值:`dont_allow`、`allow_adult`、`allowAll`、`ALLOW`、`BLOCK` - 用于进度更新的 Cloud Pub/Sub 主题(projects/\{project}/topics/\{topic})。使用 Comfy 凭据(非自带密钥)的请求不接受此项:如果请求中存在该字段,generate 路由会返回 400,因为该操作在 Comfy 的项目中运行,Vertex 会以 Comfy 的服务代理身份发布。仅在自带密钥请求中被接受,此时 Vertex 会在你自己的项目中评估该主题的授权。 + 用于进度更新的 Cloud Pub/Sub 主题(projects/\{project}/topics/\{topic})。使用 Comfy 凭据(非 BYOK)的请求不接受该参数:如果存在该参数,generate 路由会返回 400,因为操作在 Comfy 的项目中运行,而 Vertex 会以 Comfy 的服务代理身份发布。仅在自带密钥(bring-your-own-key)请求中接受,此时 Vertex 会在你自己的项目中评估主题授权。 @@ -369,7 +371,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - 输出视频分辨率。由 Veo 3.0+ 模型支持。默认值:720p + 输出视频分辨率。受 Veo 3.0+ 模型支持。默认值:720p 可选值:`720p`、`1080p`、`4k` @@ -388,7 +390,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ 可选的、用于存放已生成视频的 Cloud Storage 目标位置,以 `gs://` URI 表示。 -它必须指向你自己的存储桶。在非自带密钥(bring-your-own-key)的情况下,此路由使用 Comfy 自己的 Google Cloud 凭据而不是你的凭据运行,因此指向 Comfy 拥有存储桶的目标位置会变成由 Comfy 服务账号执行的写入,落到共享布局中,并计入 Comfy 的项目费用。指定此类目标位置的请求会以 400 被拒绝,且不会生成任何内容;唯一例外是启用了平台存储的同步 Comfy Router 调用(`POST /v2/models/{provider}/{model}`):若值指向 Router 自己的 Veo 或 Gemini 资产存储桶,则会替换为 Router 为该次调用在你自己的平台前缀下铸造的目标位置(参见 Router Veo 路由),并且只有该确切由 Router 铸造的目标位置会放行。排队的 Router 提交(`POST /v2/models/{provider}/{model}/requests`)不会做这种替换,因此会像对待任何其他 Comfy 拥有的存储桶一样,以 400 拒绝该值。任何其他目标位置都会原样转发给 Vertex,访问权限由你自行授予。自带密钥的调用在你自己的项目中运行,并按发送内容原样转发。 +它必须指向你自己的存储桶。在非自带密钥(bring-your-own-key)的情况下,此路由使用 Comfy 自己的 Google Cloud 凭据而不是你的凭据运行,因此指向 Comfy 拥有的存储桶的目标位置会变成由 Comfy 服务账号执行的写入,落到共享布局中,并计入 Comfy 的项目费用。指定此类目标位置的请求会以 400 被拒绝,且不会生成任何内容;唯一例外是启用了平台存储的同步 Comfy Router 调用(`POST /v2/models/{provider}/{model}`):如果值指向 Router 自己的 Veo 或 Gemini 资产存储桶,则会替换为 Router 为该次调用在你自己的平台前缀下创建的目标位置(参见 Router Veo 路由),并且只有由 Router 创建的那个确切目标位置会被放行。排队的 Router 提交(`POST /v2/models/{provider}/{model}/requests`)不会做这种替换,因此会像对待任何其他 Comfy 拥有的存储桶一样,以 400 拒绝该值。任何其他目标位置都会原样转发给 Vertex,访问权限由你自行授予。自带密钥的调用在你自己的项目中运行,并按发送内容原样转发。 @@ -397,7 +399,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ 可选值:`textToVideo`、`imageToVideo`、`referenceToVideo`、`edit`、`extend`、`upscale` -该文档由 Router 在 `GET /v2/models/veo/veo-3.1-generate-001/openapi.json` 提供,同样也是请求到达提供商之前用于校验调用的文档。 +根据 Router 在 `GET /v2/models/veo/veo-3.1-generate-001/openapi.json` 提供的 schema 生成,该 schema 也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 diff --git a/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx b/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx index c30bb7e7a2..b5ee7ca215 100644 --- a/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx +++ b/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx @@ -2,17 +2,18 @@ title: "使用 Comfy Router 调用 Veo 3.1 Lite Generate 001" description: "通过 Comfy Router 调用 veo/veo-3.1-lite-generate-001:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Veo 3.1 Lite Generate 001" -translationSourceHash: 6526c1c6 +translationSourceHash: 8ad7346c translationFrom: development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx translationBlockHashes: "_intro": 8110da35 "Quick start": 7f826038 - "Schema": 647d02c5 + "Schema": 25c8331a "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-lite-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -205,7 +206,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 图像的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一次 Veo 生成为你写入的视频。 + 图像的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。 @@ -225,7 +226,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 图像的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一次 Veo 生成为你写入的视频。 + 图像的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。 @@ -245,7 +246,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 遮罩文件的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一次 Veo 生成为你写入的视频。 + 遮罩文件的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。 @@ -277,7 +278,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 图像的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一次 Veo 生成为你写入的视频。 + 图像的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。 @@ -307,7 +308,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 输入视频的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一次 Veo 生成为你写入的视频。 + 输入视频的 Cloud Storage URI。在非 BYOK 请求中,若 `gs://` URI(或其 `https://storage.googleapis.com` 形式)指向 Comfy 拥有的存储桶,则会以 400 拒绝;除非该对象位于你自己的 `POST /customers/storage` 前缀之下,或者它是一段上一个 Veo 生成为你写入的视频。 @@ -337,39 +338,40 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - 自动改进提示词以获得更高质量。默认为 true。 + 自动优化提示词以获得更高质量。默认为 true。 - 已生成视频的帧率,以每秒帧数表示 + 已生成视频的帧率,单位为帧每秒 - 是否在生成视频的同时生成音频。默认为 true。Veo 3.0+ 模型支持。 + 是否在生成视频的同时生成音频。默认为 true。受 Veo 3.0+ 模型支持。 - 描述应在已生成视频中避免出现的内容的文本 + 描述已生成视频中应避免出现内容的文本 - 控制已生成视频中的人物。默认:allow_adult + 控制已生成视频中的人物。默认值:allow_adult。 +`ALLOW` 和 `BLOCK` 也受支持,出于与 Veo2GenVidRequest 的 personGeneration 枚举包含它们相同的兼容性原因(参见该组件处的说明):ComfyUI 的 Veo 3 合作伙伴节点(comfy_api_nodes/nodes_veo2.py)始终将其中的一种拼写(绝不使用 Vertex 自己的拼写)发送到 `/proxy/veo/{model}/generate`,用于 veo-3.1-generate-001、veo-3.1-fast-generate-001 和 veo-3.1-lite-generate-001,也就是此组件作为 Router 输入 schema 所对应的三个 ID。在针对其中某个 ID 的 Router 调度(`model_provider=veo`)中,无论是同步还是排队(`/v2/models/veo/{model}/requests`),在请求到达 Vertex 之前,`ALLOW` 会映射为 `allow_adult`,`BLOCK` 会映射为 `dont_allow`(routerVeoMapPersonGeneration,server/middleware/router_veo_person_generation.go),因为 Vertex 本身不接受这两种拼写。直接调用 v1 `/proxy/veo/:modelId/generate` 的调用方无论如何都不受影响:comfy-api 没有在 `/proxy/*` 上安装请求校验器,因此此枚举在那里本来就已经是不具强制力的说明性文档,而仅限 Router 的映射不会对它运行。 - 可能的值:`dont_allow`、`allow_adult`、`allowAll` + 可能的值:`dont_allow`、`allow_adult`、`allowAll`、`ALLOW`、`BLOCK` - 用于进度更新的 Cloud Pub/Sub 主题(projects/\{project}/topics/\{topic})。在 Comfy 凭据(非 BYOK)请求中不接受:如果存在该字段,generate 路由会返回 400,因为该操作在 Comfy 的项目中运行,而 Vertex 会以 Comfy 的服务代理身份发布。仅在自带密钥请求中接受,此时 Vertex 会在你自己的项目中评估该主题授权。 + 用于进度更新的 Cloud Pub/Sub 主题(projects/\{project}/topics/\{topic})。使用 Comfy 凭据(非 BYOK)的请求不接受此项:如果存在该项,生成路由会返回 400,因为该操作在 Comfy 的项目中运行,Vertex 会以 Comfy 的服务代理身份发布。仅在自带密钥请求中接受,此时 Vertex 会在你自己的项目中评估主题授权。 - 输入图像的调整大小方式。默认:pad + 输入图像的调整大小方式。默认值:pad 可能的值:`pad`、`crop` - 输出视频分辨率。Veo 3.0+ 模型支持。默认:720p + 输出视频分辨率。受 Veo 3.0+ 模型支持。默认值:720p 可能的值:`720p`、`1080p`、`4k` @@ -388,7 +390,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ 可选的 Cloud Storage 目标位置,用于存放已生成的视频,格式为 `gs://` URI。 -它必须指向你自己的存储桶。在非自带密钥(bring-your-own-key)的情况下,此路由使用 Comfy 自己的 Google Cloud 凭据而不是你的凭据运行,因此指向 Comfy 拥有存储桶的目标位置会变成由 Comfy 服务账号执行的写入,落到共享布局中,并计入 Comfy 的项目费用。指定此类目标位置的请求会以 400 被拒绝,且不会生成任何内容;唯一例外是启用了平台存储的同步 Comfy Router 调用(`POST /v2/models/{provider}/{model}`):若值指向 Router 自己的 Veo 或 Gemini 资产存储桶,则会替换为 Router 为该次调用在你自己的平台前缀下铸造的目标位置(参见 Router Veo 路由),并且只有该确切由 Router 铸造的目标位置会放行。排队的 Router 提交(`POST /v2/models/{provider}/{model}/requests`)不会做这种替换,因此会像对待任何其他 Comfy 拥有的存储桶一样,以 400 拒绝该值。任何其他目标位置都会原样转发给 Vertex,访问权限由你自行授予。自带密钥的调用在你自己的项目中运行,并按发送内容原样转发。 +它必须指向你自己的存储桶。在非自带密钥(bring-your-own-key)的情况下,此路由使用 Comfy 自己的 Google Cloud 凭据而不是你的凭据运行,因此指向 Comfy 拥有存储桶的目标位置会变成由 Comfy 服务账号执行的写入,落到共享布局中,并计入 Comfy 的项目费用。指定此类目标位置的请求会以 400 被拒绝,且不会生成任何内容;唯一例外是启用了平台存储的同步 Comfy Router 调用(`POST /v2/models/{provider}/{model}`):若值指向 Router 自己的 Veo 或 Gemini 资产存储桶,则会替换为 Router 为该次调用在你自己的平台前缀下生成的目标位置(参见 Router Veo 路由),并且只有这个由 Router 生成的确切目标位置会被放行。排队的 Router 提交(`POST /v2/models/{provider}/{model}/requests`)不会做这种替换,因此会像对待任何其他 Comfy 拥有的存储桶一样,以 400 拒绝该值。任何其他目标位置都会原样转发给 Vertex,访问权限由你自行授予。自带密钥的调用在你自己的项目中运行,并按发送内容原样转发。 diff --git a/zh/development/comfy-router/pricing.mdx b/zh/development/comfy-router/pricing.mdx index 3781037ffe..4c83634086 100644 --- a/zh/development/comfy-router/pricing.mdx +++ b/zh/development/comfy-router/pricing.mdx @@ -148,10 +148,10 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | 名称 | 模型 ID | 选项 | 积分 | | --- | --- | --- | ---: | -| [Arrow 2](/zh/development/comfy-router/models) | `quiver/arrow-2` | 输入 | 1206.92 / 1M 令牌 | -| [Arrow 2](/zh/development/comfy-router/models) | `quiver/arrow-2` | 输出 | 6034.6 / 1M 令牌 | -| [Arrow 2 Telos](/zh/development/comfy-router/models) | `quiver/arrow-2-telos` | 输入 | 1810.38 / 1M 令牌 | -| [Arrow 2 Telos](/zh/development/comfy-router/models) | `quiver/arrow-2-telos` | 输出 | 9051.9 / 1M 令牌 | +| [Arrow 2](/zh/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 输入 | 1206.92 / 1M 令牌 | +| [Arrow 2](/zh/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 输出 | 6034.6 / 1M 令牌 | +| [Arrow 2 Telos](/zh/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 输入 | 1810.38 / 1M 令牌 | +| [Arrow 2 Telos](/zh/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 输出 | 9051.9 / 1M 令牌 | #### 未发布 @@ -441,17 +441,17 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | --- | --- | --- | ---: | | [Aleph 2](/zh/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | 84.4844 / s | | [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | 15.0865 / s | -| [LTX Video Alpha Gen](/zh/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1080p | 30.173 / s | -| [LTX Video Alpha Gen](/zh/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1440p | 75.4325 / s | -| [LTX Video Alpha Gen](/zh/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 2160p | 301.73 / s | -| [LTX Video To Video Hdr](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1080p | 120.692 / s | -| [LTX Video To Video Hdr](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1440p | 241.384 / s | -| [LTX Video To Video Hdr](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 2160p | 482.768 / s | -| [LTX Video To Video Reframe](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 720p | 30.173 / s | -| [LTX Video To Video Reframe](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 1080p | 60.346 / s | -| [LTX Video Upscale](/zh/development/comfy-router/models) | `ltx/ltx-video-upscale` | 1080p | 24.1384 / s | -| [LTX Video Upscale](/zh/development/comfy-router/models) | `ltx/ltx-video-upscale` | 4K | 90.519 / s | -| [LTX Video Upscale](/zh/development/comfy-router/models) | `ltx/ltx-video-upscale` | 8K | 362.076 / s | +| [LTX Video Alpha Gen](/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1080p | 30.173 / s | +| [LTX Video Alpha Gen](/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1440p | 75.4325 / s | +| [LTX Video Alpha Gen](/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 2160p | 301.73 / s | +| [LTX Video To Video Hdr](/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1080p | 120.692 / s | +| [LTX Video To Video Hdr](/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1440p | 241.384 / s | +| [LTX Video To Video Hdr](/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 2160p | 482.768 / s | +| [LTX Video To Video Reframe](/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 720p | 30.173 / s | +| [LTX Video To Video Reframe](/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 1080p | 60.346 / s | +| [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 1080p | 24.1384 / s | +| [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 4K | 90.519 / s | +| [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 8K | 362.076 / s | | [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | 3.0173 / s | | [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | 6.0346 / s | | [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | 10.56055 / s | @@ -519,9 +519,9 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | 名称 | 模型 ID | 积分 | | --- | --- | ---: | -| [V3.5](/zh/development/comfy-router/models) | `pixverse/v3.5` | 3.0173 / PixVerse 积分 | -| [V6](/zh/development/comfy-router/models) | `pixverse/v6` | 1.025882 / PixVerse 积分 | -| [V6 Max](/zh/development/comfy-router/models) | `pixverse/v6-max` | 1.34102316 / PixVerse 积分 | +| [V3.5](/zh/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | 3.0173 / PixVerse 积分 | +| [V6](/zh/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | 1.025882 / PixVerse 积分 | +| [V6 Max](/zh/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | 1.34102316 / PixVerse 积分 | #### 每请求费率 @@ -676,9 +676,9 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | [Claude Sonnet 5](/zh/development/comfy-router/models/anthropic/claude-sonnet-5/code) | `anthropic/claude-sonnet-5` | 读取: 60.346
写入(1 小时): 1206.92
写入(5 分钟): 754.325 | 文本: 603.46 | 文本: 3017.3 | | [Claude Sonnet 4.6](/zh/development/comfy-router/models/anthropic/claude-sonnet-4-6/code) | `anthropic/claude-sonnet-4-6` | 读取: 63.3
写入(1 小时): 1266
写入(5 分钟): 791.25 | 文本: 633 | 文本: 3165 | | [Claude Sonnet 4.5](/zh/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code) | `anthropic/claude-sonnet-4-5-20250929` | 读取: 63.3
写入(1 小时): 1266
写入(5 分钟): 791.25 | 文本: 633 | 文本: 3165 | -| [Gemini 4 Argon](/zh/development/comfy-router/models) | `vertexai/gemini-4-argon` | - | 音频 / 图像 / 文本 / 视频: 1206.92 | 文本 / 推理: 6034.6 | -| [Gemini 4 Carbon](/zh/development/comfy-router/models) | `vertexai/gemini-4-carbon` | - | 音频 / 图像 / 文本 / 视频: 1206.92 | 文本 / 推理: 6034.6 | -| [Gemini 4 Hydrogen](/zh/development/comfy-router/models) | `vertexai/gemini-4-hydrogen` | - | 音频 / 图像 / 文本 / 视频: 452.595 | 文本 / 推理: 2262.975 | +| [Gemini 4 Argon](/zh/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | - | 音频 / 图像 / 文本 / 视频: 1206.92 | 文本 / 推理: 6034.6 | +| [Gemini 4 Carbon](/zh/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | - | 音频 / 图像 / 文本 / 视频: 1206.92 | 文本 / 推理: 6034.6 | +| [Gemini 4 Hydrogen](/zh/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | - | 音频 / 图像 / 文本 / 视频: 452.595 | 文本 / 推理: 2262.975 | | [Gemini 3.8 Flash](/zh/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | 音频 / 图像 / 文本 / 视频: 452.595 | 文本 / 推理: 2262.975 | | [Gemini 3.7 Flash](/zh/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | 音频 / 图像 / 文本 / 视频: 452.595 | 文本 / 推理: 2262.975 | | [Gemini 3.1 Flash Lite](/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | 图像 / 文本 / 视频: 52.75
音频: 105.5 | 文本 / 推理: 316.5 | @@ -933,10 +933,10 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | 名称 | 模型 ID | 选项 | USD | | --- | --- | --- | ---: | -| [Arrow 2](/zh/development/comfy-router/models) | `quiver/arrow-2` | 输入 | $5.72 / 1M 令牌 | -| [Arrow 2](/zh/development/comfy-router/models) | `quiver/arrow-2` | 输出 | $28.60 / 1M 令牌 | -| [Arrow 2 Telos](/zh/development/comfy-router/models) | `quiver/arrow-2-telos` | 输入 | $8.58 / 1M 令牌 | -| [Arrow 2 Telos](/zh/development/comfy-router/models) | `quiver/arrow-2-telos` | 输出 | $42.90 / 1M 令牌 | +| [Arrow 2](/zh/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 输入 | $5.72 / 1M 令牌 | +| [Arrow 2](/zh/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | 输出 | $28.60 / 1M 令牌 | +| [Arrow 2 Telos](/zh/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 输入 | $8.58 / 1M 令牌 | +| [Arrow 2 Telos](/zh/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | 输出 | $42.90 / 1M 令牌 | #### 未发布 @@ -1226,17 +1226,17 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | --- | --- | --- | ---: | | [Aleph 2](/zh/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | $0.4004 / s | | [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | $0.0715 / s | -| [LTX Video Alpha Gen](/zh/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1080p | $0.143 / s | -| [LTX Video Alpha Gen](/zh/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1440p | $0.3575 / s | -| [LTX Video Alpha Gen](/zh/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 2160p | $1.43 / s | -| [LTX Video To Video Hdr](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1080p | $0.572 / s | -| [LTX Video To Video Hdr](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1440p | $1.144 / s | -| [LTX Video To Video Hdr](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 2160p | $2.288 / s | -| [LTX Video To Video Reframe](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 720p | $0.143 / s | -| [LTX Video To Video Reframe](/zh/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 1080p | $0.286 / s | -| [LTX Video Upscale](/zh/development/comfy-router/models) | `ltx/ltx-video-upscale` | 1080p | $0.1144 / s | -| [LTX Video Upscale](/zh/development/comfy-router/models) | `ltx/ltx-video-upscale` | 4K | $0.429 / s | -| [LTX Video Upscale](/zh/development/comfy-router/models) | `ltx/ltx-video-upscale` | 8K | $1.716 / s | +| [LTX Video Alpha Gen](/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1080p | $0.143 / s | +| [LTX Video Alpha Gen](/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1440p | $0.3575 / s | +| [LTX Video Alpha Gen](/zh/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 2160p | $1.43 / s | +| [LTX Video To Video Hdr](/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1080p | $0.572 / s | +| [LTX Video To Video Hdr](/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1440p | $1.144 / s | +| [LTX Video To Video Hdr](/zh/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 2160p | $2.288 / s | +| [LTX Video To Video Reframe](/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 720p | $0.143 / s | +| [LTX Video To Video Reframe](/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 1080p | $0.286 / s | +| [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 1080p | $0.1144 / s | +| [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 4K | $0.429 / s | +| [LTX Video Upscale](/zh/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 8K | $1.716 / s | | [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | $0.0143 / s | | [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | $0.0286 / s | | [Pika H3 Flex Image To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | $0.05005 / s | @@ -1304,9 +1304,9 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | 名称 | 模型 ID | USD | | --- | --- | ---: | -| [V3.5](/zh/development/comfy-router/models) | `pixverse/v3.5` | $0.0143 / PixVerse 积分 | -| [V6](/zh/development/comfy-router/models) | `pixverse/v6` | $0.004862 / PixVerse 积分 | -| [V6 Max](/zh/development/comfy-router/models) | `pixverse/v6-max` | $0.00635556 / PixVerse 积分 | +| [V3.5](/zh/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | $0.0143 / PixVerse 积分 | +| [V6](/zh/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | $0.004862 / PixVerse 积分 | +| [V6 Max](/zh/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | $0.00635556 / PixVerse 积分 | #### 每请求费率 @@ -1461,9 +1461,9 @@ Ray 3.2 的 EXR 导出暂不可用。HDR 请求请勿启用 `exr_export`。HDR | [Claude Sonnet 5](/zh/development/comfy-router/models/anthropic/claude-sonnet-5/code) | `anthropic/claude-sonnet-5` | 读取: $0.286
写入(1 小时): $5.72
写入(5 分钟): $3.575 | 文本: $2.86 | 文本: $14.30 | | [Claude Sonnet 4.6](/zh/development/comfy-router/models/anthropic/claude-sonnet-4-6/code) | `anthropic/claude-sonnet-4-6` | 读取: $0.30
写入(1 小时): $6.00
写入(5 分钟): $3.75 | 文本: $3.00 | 文本: $15.00 | | [Claude Sonnet 4.5](/zh/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code) | `anthropic/claude-sonnet-4-5-20250929` | 读取: $0.30
写入(1 小时): $6.00
写入(5 分钟): $3.75 | 文本: $3.00 | 文本: $15.00 | -| [Gemini 4 Argon](/zh/development/comfy-router/models) | `vertexai/gemini-4-argon` | - | 音频 / 图像 / 文本 / 视频: $5.72 | 文本 / 推理: $28.60 | -| [Gemini 4 Carbon](/zh/development/comfy-router/models) | `vertexai/gemini-4-carbon` | - | 音频 / 图像 / 文本 / 视频: $5.72 | 文本 / 推理: $28.60 | -| [Gemini 4 Hydrogen](/zh/development/comfy-router/models) | `vertexai/gemini-4-hydrogen` | - | 音频 / 图像 / 文本 / 视频: $2.145 | 文本 / 推理: $10.725 | +| [Gemini 4 Argon](/zh/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | - | 音频 / 图像 / 文本 / 视频: $5.72 | 文本 / 推理: $28.60 | +| [Gemini 4 Carbon](/zh/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | - | 音频 / 图像 / 文本 / 视频: $5.72 | 文本 / 推理: $28.60 | +| [Gemini 4 Hydrogen](/zh/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | - | 音频 / 图像 / 文本 / 视频: $2.145 | 文本 / 推理: $10.725 | | [Gemini 3.8 Flash](/zh/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | 音频 / 图像 / 文本 / 视频: $2.145 | 文本 / 推理: $10.725 | | [Gemini 3.7 Flash](/zh/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | 音频 / 图像 / 文本 / 视频: $2.145 | 文本 / 推理: $10.725 | | [Gemini 3.1 Flash Lite](/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | 图像 / 文本 / 视频: $0.25
音频: $0.50 | 文本 / 推理: $1.50 | diff --git a/zh/development/comfy-router/quickstart.mdx b/zh/development/comfy-router/quickstart.mdx index 5b085658b6..7c9528e96a 100644 --- a/zh/development/comfy-router/quickstart.mdx +++ b/zh/development/comfy-router/quickstart.mdx @@ -2,14 +2,15 @@ title: "Comfy Router 快速入门" sidebarTitle: "快速入门" description: "在几分钟内使用最新前沿媒体模型生成图像和视频。" -translationSourceHash: ea087f5c +translationSourceHash: ea722f9a translationFrom: development/comfy-router/quickstart.mdx translationBlockHashes: "_intro": 201b5b50 - "Image-to-video and reference-to-video": 8ac90191 + "Image-to-video and reference-to-video": e7a93779 "Next steps": ed466781 --- +
Comfy Router 为用户提供统一的 API,用于调用托管的图像和视频模型,地址为 `https://api.comfy.org`。请在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建 API 密钥,然后使用官方 [Python 和 TypeScript SDK](/zh/development/api-development/sdks) 或直接通过 HTTP 调用任意模型。计费方式为按使用量付费:默认情况下,每次请求都会从你的工作区余额中扣除积分,无需订阅。费率和其他计费方式请参阅 [Router 定价](/zh/development/comfy-router/pricing)。 @@ -135,7 +136,7 @@ Comfy Router 为用户提供统一的 API,用于调用托管的图像和视频 ## 图生视频与参考生视频 -同一个 Seedance 请求可以接受图像、视频和音频输入。向 `content` 添加条目,并为每个条目设置 `role`。你发送的 role 决定 Router 执行哪种操作。计费依据 `content` 中的媒体种类,而不是 role:只要包含视频输入,就按视频到视频计费;否则只要包含图像,就按图生视频计费;只有文本的请求按文生视频计费。有些模型对文生视频和图生视频收取相同的费用。 +同一个 Seedance 请求可以接受图像、视频和音频输入。向 `content` 添加条目,并为每个条目设置 `role`。你发送的角色决定 Router 执行哪种操作。计费依据 `content` 中的媒体种类,而不是角色:只要包含视频输入,就按视频转视频计费;否则只要包含图像,就按图生视频计费;只有文本的请求按文生视频计费。有些模型对文生视频和图生视频收取相同的费用。 | 操作 | `content` 条目 | |---|---| @@ -172,13 +173,36 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"}, {"type": "image_url", "image_url": {"url": "https://example.com/outfit.png"}, "role": "reference_image"} ], + "omni_reference_task_type": "reference", "duration": 5, "ratio": "16:9", "resolution": "720p" }' ``` -在 Seedance 2.5 上,首帧请求和首尾帧请求会从首帧获取输出的宽高比。请省略 `ratio` 或传入 `adaptive`,因为传入具体比例会被拒绝并返回 `400`。请求 schema 在 Seedance 系列之间共用,可能会列出模型忽略的 role,因此请查看每个模型的[输入 schema](/zh/development/comfy-router/models) 中的 `x-comfy-router-input-modalities` 字段,了解该模型接受哪些输入种类。例如,`reference_video` 和 `reference_audio` 需要模型在其中列出 `video` 或 `audio`。 +在 Seedance 2.5 上,首帧请求和首尾帧请求会从首帧获取输出的宽高比。请省略 `ratio` 或传入 `adaptive`,因为传入具体比例会被拒绝并返回 `400`。请求 schema 在整个 Seedance 系列中通用,可能会列出模型忽略的角色,因此请查看每个模型[输入 schema](/zh/development/comfy-router/models) 中的 `x-comfy-router-input-modalities` 字段,了解该模型接受哪些输入种类。例如,`reference_video` 和 `reference_audio` 需要模型在其中列出 `video` 或 `audio`。 + +### 编辑或延长参考视频 + +在 Seedance 2.5 上,`omni_reference_task_type` 告诉模型如何处理参考媒体:`reference` 会以其为引导生成新视频,`edit` 会修改 `reference_video` 片段,`extend` 则会延续该片段。不传该字段时,模型会从提示词中推断任务;edit 会保留片段自身的长度和宽高比,并忽略 `duration` 和 `ratio`。在 BytePlus 原生链路上,如果显式传入的值不适合该请求,会在开始生成之前被拒绝,因此不会计费。备用提供商链路(在回退时使用,或通过 `model_provider` 选择)没有任务类型字段:它会丢弃该值,让该提供商像未传该字段一样自行推断任务。丢弃情况会在 `X-Comfy-Router-Dropped-Params` 中披露,同步运行路由的响应和排队提交的 `201` 响应中都会包含。排队路由没有回退,因此只能通过 `model_provider` 到达备用链路。 + +```bash Edit a reference video +curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d '{ + "content": [ + {"type": "text", "text": "Make the fox bright red"}, + {"type": "video_url", "video_url": {"url": "https://example.com/fox.mp4"}, "role": "reference_video"} + ], + "omni_reference_task_type": "edit", + "duration": -1, + "resolution": "720p" + }' +``` + +编辑会保留来源片段的长度,因此请传入 `"duration": -1` 并省略 `ratio`。`extend` 请求只返回新生成的片段,长度为你传入的 `duration`。 ## 下一步 diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 7c4a11bd54..c0b590c16a 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -2,11 +2,11 @@ title: "Comfy Router API 参考" description: "每个 Comfy Router 端点、参数、响应体和错误分类,均由 Comfy API 契约生成。" sidebarTitle: "API 参考" -translationSourceHash: e8d9375f +translationSourceHash: 64fd0a10 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": e6679d4b + "Endpoints": 5e27b6a1 "Error buckets": 02a09cb4 "Response headers": 3ac389bd "Pre-flight cost estimates": 7405db0d @@ -30,6 +30,7 @@ translationBlockHashes: + {/* 生成的文件:请勿手动编辑。 @@ -51,16 +52,16 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 ### `GET /v2/models` -**列出 Comfy Router 可以运行的模型。** +**列出 Comfy Router 可运行的模型。** -列出可用的模型 ID 和计费信息。当 `has_more` 为 true 时,使用 `next_cursor`。 +列出可用的模型 ID 与计费信息。当 `has_more` 为 true 时,使用 `next_cursor`。 **参数** 不透明的分页游标。 - 类型:[`RouterPageCursor`](#routerpagecursor) -- 作为 `next_cursor` 返回的不透明游标,1–512 个字符 + 类型:[`RouterPageCursor`](#routerpagecursor)。作为 `next_cursor` 返回的不透明游标,长度为 1–512 个字符 @@ -76,13 +77,13 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 **响应** - OK - 模型目录中的一页。 + OK:模型目录中的一页。 - 响应体:[`RouterModelListResponse`](#routermodellistresponse) -- 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 响应体:[`RouterModelListResponse`](#routermodellistresponse)。响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该页面没有变化。 + Not Modified:自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该页面未发生变化。 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -90,67 +91,67 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 请求无效。请检查错误类型和请求体。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 凭据缺失或无效。 + 凭证缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或模型不允许发起此请求。 + 该调用方或模型不允许此请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`:当前调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一次请求。 + `rate_limited`:该调用方的请求配额已用尽。请等待 `Retry-After` 之后再发送下一个请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` - Router 暂时不可用。请退避后重试。 + Router 暂时不可用。请使用退避策略重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}` -**按规范模型 ID 读取单个合作伙伴模型的产品目录条目。** +**按规范模型 ID 读取一个合作伙伴模型的目录条目。** -无需列出完整目录即可读取单个模型的详情。 +无需列出完整目录,即可读取单个模型的详情。 **参数** 规范 `{provider}/{model}` 模型 ID 中的提供商部分。 - 类型:[`RouterProviderSegment`](#routerprovidersegment) —— 字母数字标识符,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符 规范 `{provider}/{model}` 模型 ID 中的模型部分。 - 类型:[`RouterModelSegment`](#routermodelsegment) —— 字母数字标识符,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 调用方从之前的 `200` 响应中持有的 `ETag`。 + 调用方从先前的 `200` 响应中持有的 `ETag`。 **响应** - OK —— 该模型的产品目录条目。 + OK:该模型的目录条目。 - 响应体:[`RouterModelDetail`](#routermodeldetail) —— 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 响应体:[`RouterModelDetail`](#routermodeldetail),响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - Not Modified —— 自调用方在 `If-None-Match` 中发送的 `ETag` 对应版本以来,该条目未发生更改。 + 未修改:自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该条目未发生变化。 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` @@ -158,95 +159,95 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 凭据缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或该模型无权执行此请求。 + 该请求对此调用方或模型不被允许。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`:当前调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一次请求。 + `rate_limited`:每个调用方的请求额度已用完。请等待 `Retry-After` 后再发送下一个请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` - Router 暂时不可用。请退避重试。 + Router 暂时不可用。请以退避方式重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}` **按规范模型 ID 同步运行合作伙伴模型。** -运行模型,并在同一个响应中收到其已完成的结果。 +运行一个模型,并在同一个响应中收到其已完成的结果。 **参数** - 规范 `{provider}/{model}` 模型 ID 中表示提供商的部分。 + 规范 `{provider}/{model}` 模型 ID 中的提供商部分。 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字 slug,例如 `anthropic`,最长 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中表示模型的部分。 + 规范 `{provider}/{model}` 模型 ID 中的模型部分。 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字 slug,例如 `claude-opus-4-6`,最长 128 个字符 - 由调用方生成的密钥,使重试一次逻辑调用变得安全。 + 由调用方生成的键,用于让同一次逻辑调用的重试变得安全。 1–255 个字符 - 选择另一个提供商来服务此模型,而不是其当前默认提供商;`fal`、`wavespeed`、`runware` 和 `higgsfield` 是备选提供商,`GET /v2/models/{provider}/{model}` 会报告某个模型支持其中哪些。它的各种拒绝按固定顺序检查,靠前的拒绝无论靠后的拒绝是否成立都会生效:无法识别的值(根本不是已注册的提供商)会被拒绝并返回 `400`;随后,若请求体选择了 multipart 操作(编辑)而指定了备选提供商,则会被拒绝并返回 `409`,其 `detail` 以“this request's `image` selects the edit operation”开头,但仅当该提供商针对此模型的转换器无法服务该操作时才会如此,若某条 leg 的转换器确实携带该媒体,则会正常继续;接下来,若请求解析出了自带密钥(bring-your-own-key)凭据,则任何备选提供商都会被拒绝并返回 `409`,其 `detail` 以 `this request resolved a BYOK credential` 开头(见该响应),无论该提供商是否服务此模型;再接下来是该具名提供商自身的准入检查:当该提供商未为你开启时,会拒绝并返回 `403` 与 `error_type: not_enabled`,当无法评估该检查时,会拒绝并返回 `503` 与 `error_type: service_unavailable`;只有通过以上全部四项之后,真实提供商若对此模型没有 leg,才会被拒绝并返回 `400` 与 `error_type: invalid_input`,与无法识别的值得到相同的应答。在自带密钥请求上、在请求体选择 multipart 操作的请求上以及在 `strict_mode=true` 下,`fallback_provider` 是不生效,而不是被拒绝。 + 选择另一个提供商来为这个模型提供服务,而不是使用其当前默认提供商;`fal`、`wavespeed`、`runware` 和 `higgsfield` 是备选提供商,`GET /v2/models/{provider}/{model}` 会报告某个模型支持其中的哪些。它的各种拒绝按固定顺序检查,靠前的拒绝无论靠后的拒绝是否成立都会给出答复:无法识别的值(根本不是已注册的提供商)会被拒绝 `400`;接着,在请求体选择了 multipart 操作(编辑)的请求上指定备选提供商会以 `409` 拒绝,`detail` 以 "this request's `image` selects the edit operation" 开头,但仅当该提供商针对此模型的转换器无法服务该操作时才会如此,若某条链路的转换器确实承载该媒体,则正常继续;接着,在任何解析到自带密钥凭据的请求上指定备选提供商会以 `409` 拒绝,`detail` 以 `this request resolved a BYOK credential` 开头(见该响应),无论该提供商是否服务此模型;接着是被指名提供商自身的门控:当该提供商未对你开启时,它以 `403` 加 `error_type: not_enabled` 拒绝,当门控无法评估时,它以 `503` 加 `error_type: service_unavailable` 拒绝;只有在通过上述四项之后,一个对此模型没有链路的真实提供商才会以 `400` 加 `error_type: invalid_input` 被拒绝,这与无法识别的值得到的是同一个答复。在自带密钥请求上、在请求体选择了 multipart 操作的请求上以及在 `strict_mode=true` 下,`fallback_provider` 是惰性的,而不是被拒绝。 - 只有与 `model_provider` 一起使用时才有意义。 + 仅在与 `model_provider` 一起使用时才有意义。 - 默认值:否 + 默认值:False - 控制当首次尝试因归因于 Router 或所尝试提供商的原因而失败时,Router 是否针对该模型的另一个已注册提供商重试此调用。省略该参数,或使用除 `false` 之外的任何值,都会保持回退开启;`false` 会将其关闭。成功回退的响应会带有 `X-Comfy-Router-Fallback-Provider`。在解析出了自带密钥凭据的请求上,无论此参数说什么,回退都不可用:根本不会进行该尝试,首次失败会原样返回给你,这属于不生效,而不是被拒绝:这里不会产生任何 `409`。出于同样的原因,在请求体选择 multipart 操作的请求上以及在 `strict_mode=true` 下也是如此:每一种情况都会把调用绑定到一个无法在另一个提供商上忠实重放的提供商,因此回退只是被跳过,而不是被拒绝。只有显式指定 `model_provider` 才会被以该 `409` 拒绝,而且与这种无条件跳过不同,其 multipart 的 `409` 仅适用于转换器无法服务该操作的 leg。 + 控制当首次尝试因可归因于 Router 或所尝试提供商的原因而失败时,Router 是否针对该模型的另一个已注册提供商重试此调用。省略该参数,或传入 `false` 以外的任何值,都会保持回退开启;`false` 会将其关闭。成功的回退响应会带有 `X-Comfy-Router-Fallback-Provider`。在解析到自带密钥凭据的请求上,无论此参数说什么,回退都不可用:该尝试根本不会发起,首次失败会原样返回给你,这属于惰性而非拒绝:不会由此产生 `409`。出于同样的原因,在请求体选择了 multipart 操作的请求上以及在 `strict_mode=true` 下也是如此:这两种情况都把该调用绑定到某一个提供商,无法忠实地在另一个提供商上重放,因此回退只是被跳过,而不是被拒绝。只有显式指定 `model_provider` 才会以那个 `409` 被拒绝,而且与这种无条件的跳过不同,它的 multipart `409` 只适用于转换器无法服务该操作的链路。 - 选择拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受它;嵌套字段不会被检查,对于 schema 允许未声明字段或没有编写 schema 的模型,以及在以 `strict_mode=true` 发送的已执行提交上,都不会拒绝任何内容。 + 选择拒绝此模型的输入 schema 未声明的顶层请求体字段,而不是接受它;嵌套字段不会被检查,对于其 schema 允许未声明字段或没有编写 schema 的模型,或在以 `strict_mode=true` 发送的排队提交上,都不会拒绝任何内容。 - 默认值:否 + 默认值:False **请求体** `application/json` -- [`RouterModelInput`](#routermodelinput)(必填) -合作伙伴模型的原生 JSON 输入。不带 `model_provider` 时,请求会在模型的默认提供商上执行原生分发,此请求体就是模型自身的原生 schema,原样转发(此时 `strict_mode` 没有意义,也不会带来任何改变)。当 `model_provider` 选择备选提供商且 `strict_mode=false`(默认值)时,请求体会在发送之前被转换为该提供商的真实 schema:任何无法精确表达的原生字段都会被丢弃,并通过响应的 `X-Comfy-Router-Dropped-Params` 头予以披露,绝不会静默丢弃。当 `model_provider` 选择备选提供商且 `strict_mode=true` 时不执行任何转换:请求体必须已经是该备选提供商自身的真实 schema,而不是此模型的原生 schema(参见 `strict_mode`),并会原样转发。请求体自身的字段还会选择 Router 在支持多种操作的模型上运行哪种操作:对于可编辑的图像模型,包含一张输入图像会将其从文生图切换为图生图(编辑)操作,该操作可能按自己的费率计费;对于 Seedance 视频模型,`content[].role` 选择操作(首帧图像选择图生视频,参考图像或参考片段选择参考生视频)。在原生分发下,Seedance 的计费依据 `content` 中的媒体类型而非角色:任何包含视频输入的请求按视频转视频计费,否则包含任何图像的请求按图生视频计费,否则按文生视频计费;例外是来自 `draft_task` 项的最终渲染,按其所渲染 Draft 的操作计费;某些模型对文生视频和图生视频收取相同费率。当 `model_provider` 选择备选提供商时,每种带条件的操作可能会按该提供商自己的费率计费。 +合作伙伴模型的原生 JSON 输入。未指定 `model_provider` 时,请求会在模型的默认提供商上执行原生分发,此请求体就是模型自身的原生 schema,会被原样转发(`strict_mode` 在那里没有意义,也不会改变任何东西)。当 `model_provider` 选择了备选提供商且 `strict_mode=false`(默认值)时,请求体会在发送之前被转换为该提供商真实的 schema:任何无法精确表达的原生字段都会被丢弃,并通过响应的 `X-Comfy-Router-Dropped-Params` 头披露,绝不会静默丢弃。当 `model_provider` 选择了备选提供商且 `strict_mode=true` 时不执行任何转换:请求体必须已经是该备选提供商自身的真实 schema,而不是此模型的原生 schema(见 `strict_mode`),并会被原样转发。请求体自身的字段还决定 Router 在支持多种操作的模型上运行哪一种操作:对于可编辑的图像模型,包含输入图像会将其从文生图切换为图生图(编辑)操作,该操作可能按其自身的费率计费;对于 Seedance 视频模型,`content[].role` 选择操作(首帧图像选择图生视频,参考图像或视频片段选择参考生视频)。在原生分发下,Seedance 的计费依据 `content` 中的媒体类型,而不是角色:带有任何视频输入的请求按视频转视频计费,否则带有任何图像的请求按图生视频计费,否则按文生视频计费,例外是来自 `draft_task` 项的最终渲染按其所渲染的 Draft 的操作计费;有些模型对文生视频和图生视频收取相同费率。当 `model_provider` 选择了备选提供商时,每一种带条件的操作都可能按该提供商自身的费率计费。 **响应** - OK - 不带 `model_provider`,或带 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回本模型的原生契约,转换失败时回退到备用提供商自己的原始响应,会记录日志,绝不静默)时,形状是本模型自己的原生输出;当 `strict_mode=true` 时,则原样返回备用提供商的响应。对于由合作伙伴直接以字节形式返回生成结果的模型,响应体就是这些字节,使用合作伙伴自己的 `Content-Type` 而不是 `application/json`;请根据响应的 `Content-Type` 分支处理,不要假定它是一个 JSON 文档。 + OK:不带 `model_provider`,或带有 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回此模型自身的原生契约,转换失败时回退为备用提供商自己的原始响应,会记录日志,绝不静默)时,形状为此模型自身的原生输出;当 `strict_mode=true` 时,返回的是备用提供商未经修改的响应。对于由合作伙伴直接以字节形式返回生成结果的模型,响应体就是这些字节,其 `Content-Type` 为合作伙伴自己的类型而非 `application/json`;请根据响应的 `Content-Type` 分支处理,不要假定这是 JSON 文档。 响应体:[`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`) -- 响应头:`X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Router-Fallback-Provider`、`X-Comfy-Router-Provider`、`X-Comfy-Router-Dropped-Params`、`X-Comfy-Credits-Used`、`Idempotent-Replayed`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining` - 请求无效。请检查错误类型和请求体。 + 无效请求。请检查错误类型和请求体。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status`、`X-Comfy-Upstream-Detail`、`X-Comfy-Refusal-Subject`、`X-Comfy-Credits-Used`、`Idempotent-Replayed` @@ -258,13 +259,13 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 - Router 请求级别的失败:请求从未到达模型,或者因模型自身未反馈的原因而失败。 + Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或模型不允许执行此请求。 + 该调用方或该模型不允许发起此请求。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -276,9 +277,9 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 - 检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则要求使用新的 key。此路由上有两种 `invalid_input` 冲突与 key 完全无关,任何新 key 都无法消除:当请求体选择的是该提供商针对此模型的转换器无法处理的多部分操作(编辑)时,用 `model_provider` 指定备用提供商会遭到拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会检查另一种情况:请求已经为路径中的提供商解析出自带密钥(BYOK)凭据,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭据,并且(针对多部分的情况)不带编辑操作。 + 请检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个键;`invalid_input` 则需要使用新的键。此路由上有两种 `invalid_input` 冲突与键完全无关,换用新键也无法解决:当请求体选择的多部分操作(编辑)是该提供商针对此模型的转换器无法处理的时,指定备用提供商的 `model_provider` 会被拒绝,其 `detail` 以“this request's `image` selects the edit operation”开头;以及,在上述检查之后进行的一项检查中,当请求已为路径中的提供商解析出自带密钥(BYOK)凭据时也会被拒绝,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭据,并且(对于多部分情况)不带编辑操作。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当 `concurrency_limit_exceeded` 时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当为 `concurrency_limit_exceeded` 时) @@ -288,64 +289,64 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 - 请求的内容依据模型 schema 被拒绝。 + 请求的内容未通过模型 schema 的校验。 响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` - 检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示应减少在途调用;`rate_limited` 表示应等待 `Retry-After` 指定的时间。 + 请检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示应减少在途调用;`rate_limited` 表示应等待 `Retry-After`。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining`、`X-Model-Concurrency-Limit`、`X-Model-Concurrency-Current`、`X-Model-Concurrency-Remaining`、`Retry-After`(`rate_limited` 时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining`、`X-Model-Concurrency-Limit`、`X-Model-Concurrency-Current`、`X-Model-Concurrency-Remaining`、`Retry-After`(当为 `rate_limited` 时) - 提供商自己的响应无法转换为结果(`provider_error`)。 + 无法将提供商自身的响应转换为结果(`provider_error`)。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status` - Router 暂时不可用。请退避后重试。 + Router 暂时不可用。请退避重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅限容量拒绝) - 请求超过了截止期限。重试前请检查错误类型。 + 请求超过了截止时间。重试前请检查错误类型。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status`、`Retry-After` ### `POST /v2/models/{provider}/{model}/estimate` -**在运行模型调用之前先为它定价,而无需实际运行。** +**在运行模型调用之前先为其定价,而无需实际运行。** -返回预检估算值,以美元为单位,表示在指定模型上运行此请求体将产生的费用,按 Comfy 的标准标价计算(对于按提供商上报成本计费的模型,则改为根据提供商公布的价目表估算)。它不反映合同费率或客户特定费率:有协商定价的工作区会按标价报价、按合同费率收费,此时 `source: exact` 表示按标价精确,而不是该工作区的实际收费。这是估算值,不是最终费用:你实际支付的是工作区用量与账单记录中的结算费用。请求体会先按模型的输入 schema 校验,校验方式与默认运行(不启用 `strict_mode`,不启用 `reject_unknown_fields`)相同,因此不符合模型 schema 的请求体在这里会得到与运行接口相同的 `422`;不会向提供商派发任何内容,也不会产生任何费用。该结果不是价格锁定:它按 `pricing_as_of` 时生效的费率计价,而运行会按计费时生效的费率收费。如果某个部署关闭了估算,该路由会返回 `403`,并带有 `error_type: not_enabled`;Router 尚不能运行的模型会返回相同的 `403`,但带有运行路由自己的 `detail`,因此要读取 `detail` 来区分两者。请求体按 Router 实际派发它的方式计价:为其指定的 `model_provider` 环节进行转换,并重定向到它实际运行的操作,顺序与已执行提交的 `201` 响应中的 `estimate` 相同。不过,那个 `estimate` 并不是预检价格:它只有在运行被接纳并进入队列之后才会出现,而且该运行除非在派发之前被取消,否则都会被计费。 +返回一个以美元计的预检估算,说明用此模型运行该请求体将花费多少,按 Comfy 的标准标价计价(按供应商上报成本计费的模型,则改为根据供应商公布的价格表估算)。它不反映合同费率或客户专属费率:有议价定价的工作区会按标价报价、按合同费率计费,此时 `source: exact` 表示的是按标价精确,而非该工作区的实际收费。这是估算,不是最终费用:你实际支付的是工作区使用与账单记录中的结算费用。请求体会先按模型的输入 schema 校验,校验方式与默认运行(不设置 `strict_mode`,不设置 `reject_unknown_fields`)相同,因此未通过模型 schema 的请求体在这里和在运行时一样返回 `422`;不会向提供商分发任何内容,也不会产生任何费用。该结果不是价格锁定:它按 `pricing_as_of` 时生效的费率计价,而运行则按计费时生效的费率收费。如果某个部署关闭了估算功能,该路由会返回 `403` 并带有 `error_type: not_enabled`;Router 尚无法运行的模型也会返回同样的 `403`,但带有运行路由自己的 `detail`,因此可通过读取 `detail` 来区分两者。请求体按 Router 分发它的方式定价:针对它所指定的 `model_provider` 段进行转换,并重定向到它在其中运行的操作,顺序与已排队提交的 `201` 响应中的 `estimate` 相同。不过,那个 `estimate` 并不是预检价格:它只有在运行被接纳并排队之后才会出现,且该运行除非在分发前被取消,否则都会被计费。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即被运行模型所属的合作伙伴。 + 规范模型 ID `{provider}/{model}` 中的小写提供商段,即正在运行其模型的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字 slug,例如 `anthropic`,最长 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字短标识,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 + 规范模型 ID `{provider}/{model}` 中的小写模型段,即在该提供商下要运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字 slug,例如 `claude-opus-4-6`,最长 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符 - 选择用于提供此模型的备用提供商,以替代其当前的默认提供商。 + 选择一个替代提供商来提供此模型,而不是使用其当前默认提供商。 **请求体** `application/json` -- [`RouterModelInput`](#routermodelinput)(必填) -合作伙伴模型的原生 JSON 输入,与此模型的同步路由所接受的请求体完全相同。它会按模型自身的输入 schema 进行校验,与默认运行的校验方式一致(此路由不接受 `strict_mode` 或 `reject_unknown_fields`),并由其自身的字段(输出数量、输入图像所选择的操作)决定计价内容。 +合作伙伴模型的原生 JSON 输入,与此模型的同步路由所接受的请求体完全相同。它按模型自身的输入 schema 进行校验,校验方式与默认运行相同(此路由不接受 `strict_mode` 或 `reject_unknown_fields`),其自身的字段(输出数量、输入图像所选定的操作)决定计价内容。 **响应** @@ -362,13 +363,13 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 - 凭据缺失或无效。 + 凭证缺失或无效。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 此调用方或此模型不允许该请求。 + 该调用方或模型不允许发起此请求。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` @@ -386,341 +387,341 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 - 估算请求的请求体未通过模型的 schema 校验,或指定的模型与路径中的模型不一致。 + 估算的请求体未通过模型 schema 校验,或指定的模型与路径中的模型不一致。 响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`:当前调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一次请求。 + `rate_limited`:按调用方计算的请求额度已用尽。请等待 `Retry-After` 后再发送下一个请求。 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` - Router 暂时不可用。请以退避方式重试。 + Router 暂时不可用。请退避重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅限容量拒绝时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) - 请求超过了截止时间。重试前请检查错误类型。 + 请求超出了截止时间。重试前请检查错误类型。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/openapi.json` -**以 OpenAPI 文档形式读取单个合作伙伴模型的输入和输出 Schema。** +**以 OpenAPI 文档形式读取单个合作伙伴模型的输入和输出 schema。** -以独立的 OpenAPI 文档形式读取单个模型的输入和输出 Schema。 +以独立的 OpenAPI 文档形式读取单个模型的输入和输出 schema。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的提供商部分。 + 规范模型 ID `{provider}/{model}` 中的提供商部分。 - 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字短标识,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字 slug,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的模型部分。 + 规范模型 ID `{provider}/{model}` 中的模型部分。 - 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 调用方此前从 `200` 响应中获取的 `ETag`。 + 调用方此前从 `200` 响应中持有的 `ETag`。 **响应** - OK - 该模型的输入和输出 Schema,以独立的 OpenAPI 文档形式呈现。 + OK - 该模型的输入和输出 schema,以独立的 OpenAPI 文档形式返回。 - 响应体:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) - 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + Body:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- Headers:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,文档未发生变化。 + Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该文档未发生变化。 - 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + Headers:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` - 凭据缺失或无效。 + 凭证缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或该模型不允许发起此请求。 + 该调用方或该模型不允许此请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router 无法完成该请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`:当前调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一次请求。 + `rate_limited`:该调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一个请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` + Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` Router 暂时不可用。请使用退避策略重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}/requests` -**将合作伙伴模型运行任务提交到队列并立即返回。** +**将合作伙伴模型运行提交到队列并立即返回。** -Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{provider}/{model}` 所接受的合作伙伴原生 JSON 输入相同:同一请求体形状、同一套按模型定义的 schema、两种投递模式,但此路由不会保持连接来等待结果。它会接纳该运行任务,返回 `201` 和一个句柄,调用方随后通过下文所述的三个读取操作获取结果。 +Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{provider}/{model}` 接受的合作伙伴原生 JSON 输入相同:一种请求体形状、每个模型一套 schema、两种投递模式;但此路由不会为等待结果而保持连接。它会接纳本次运行,返回 `201` 和一个句柄,调用方稍后通过下面的三个读取接口获取结果。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即运行其模型的合作伙伴。 + 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment):字母数字 slug,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment);字母数字 slug,例如 `anthropic`,最多 64 个字符 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment):字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment);字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 选择用于服务此模型的备用提供商,而不是其当前默认提供商。 + 选择一个备用提供商来提供此模型,而不是其当前默认提供商。 - 仅在与 `model_provider` 一起使用时才有意义。 + 仅在配合 `model_provider` 时有意义。 - 默认值:False + 默认:False - 调用方生成的键,可确保重试同一次逻辑调用是安全的。 + 调用方生成的键,使重试同一次逻辑调用变得安全。 1–255 个字符 - 选择拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受该字段;不会检查嵌套字段,并且对于其 schema 允许未声明字段或没有已编写 schema 的模型,或者对于使用 `strict_mode=true` 发送的队列提交,不会拒绝任何字段。 + 启用后,将拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受它;不会检查嵌套字段,并且对于 schema 允许未声明字段或没有编写 schema 的模型,或者在使用 `strict_mode=true` 发送的队列提交中,不会拒绝任何内容。 - 默认值:False + 默认:False **请求体** -`application/json`:[`RouterModelInput`](#routermodelinput)(必填) +`application/json` -- [`RouterModelInput`](#routermodelinput)(必填) -合作伙伴模型的原生 JSON 输入,与同步路由为此模型接受的请求体相同,并且它决定所执行的操作,也按相同方式计费:请求体自身的字段决定 Router 在支持多种操作的模型上运行哪种操作(输入图像会将可编辑图像模型切换为图生图,这可能按单独费率计费;Seedance 的首帧图像会选择图生视频,而参考图像或视频片段会选择参考生视频)。在原生调度时,Seedance 请求按 `content` 中的媒体种类计费,而不是按角色计费:任何视频输入都按视频转视频计费,否则任何图像都按图生视频计费,再否则按文生视频计费;例外是,来自 `draft_task` 项的最终渲染按其渲染的 Draft 对应的操作计费,某些模型对文生视频和图生视频收取相同费率;当 `model_provider` 选择备用提供商时,每种带条件的操作可能会按该提供商自身的费率计费。相同的提供商选择约定在调度时同样适用:未提供 `model_provider`,或提供 `model_provider` 且 `strict_mode=false`(默认值)时,请求体是模型的原生文档,并会在接纳运行任务之前依据模型自身的输入 schema 进行验证,因此模型会拒绝的请求体会在此处返回 `422`,而不是变成一个几分钟后才失败的排队请求;非严格模式下的备用提供商请求体还会在调度时转换为该提供商实际的 schema。使用 `strict_mode=true` 时,请求体必须已经是备用提供商自身的 schema,并会原样转发:跳过原生 schema 验证,与同步路由完全一致(参见 `model_provider` 和 `strict_mode`)。 +合作伙伴模型的原生 JSON 输入,与此模型的同步路由接受的请求体完全相同;它决定操作,并以相同方式计费:请求体自身的字段决定 Router 在支持多种操作的模型上运行哪种操作(输入图像会将可编辑图像模型切换为图生图,后者可能按其自身费率计费;Seedance 的首帧图像会选择图生视频,参考图像或视频片段会选择参考生视频)。在原生调度时,Seedance 请求按 `content` 中的媒体类型计费,而不是按角色:任何视频输入都按视频转视频计费;否则任何图像输入都按图生视频计费;否则按文生视频计费;例外情况是,来自 `draft_task` 项的最终渲染按其所渲染的 Draft 对应的操作计费。某些模型对文生视频和图生视频收取相同费率;当 `model_provider` 选择备用提供商时,每种带条件的操作可能会按该提供商自身的费率计费。相同的提供商选择约定在调度时同样适用:不带 `model_provider`,或带有 `model_provider` 且 `strict_mode=false`(默认值)时,请求体是该模型的原生文档,并会在接纳运行之前依据模型自身的输入 schema 进行验证,因此模型会拒绝的请求体会在此处返回 `422`,而不是变成一个几分钟后才失败的已排队请求。对于非严格模式的备用提供商请求体,还会在调度时转换为该提供商的实际 schema。使用 `strict_mode=true` 时,请求体必须已经是备用提供商自身的 schema,并会原样转发:跳过原生 schema 验证,与同步路由完全一致(参见 `model_provider` 和 `strict_mode`)。 **响应** - 已创建:运行任务已获准进入队列。 + 已创建:运行已接纳进入队列。 - 响应体:[`RouterQueueSubmitResponse`](#routerqueuesubmitresponse):响应头:`X-Comfy-Request-Id`、`Idempotent-Replayed` + 响应体:[`RouterQueueSubmitResponse`](#routerqueuesubmitresponse);响应头:`X-Comfy-Request-Id`、`Idempotent-Replayed`、`X-Comfy-Router-Dropped-Params` - 凭证缺失或无效。 + 凭据缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 请求无效。请检查错误类型和请求体。 - 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 请求体过大。 - 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。 + Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。 - 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 此调用方或模型不允许该请求。对于合作伙伴直接以字节形式返回生成结果的模型,目前尚不能排队,并会以 `not_enabled` 拒绝;请改为在同步路由上运行。 + 此调用方或模型不允许该请求。对于合作伙伴直接以字节形式返回生成结果的模型,目前还不能排队,并会以 `not_enabled` 拒绝;请改用同步路由运行它。 - 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Check `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则需要使用新 key。此路由上的两个 `invalid_input` 冲突与 key 完全无关,且任何新 key 都无法消除其中任何一个:当请求正文选择该提供商针对此模型的转换器无法处理的多部分操作(编辑)时,指定备用提供商的 `model_provider` 会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会检查另一种情况,即当请求已经为路径中的提供商解析出自带密钥(BYOK)凭证时,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭证,并且(对于多部分情形)不带编辑操作。 + Inspect `X-Comfy-Error-Type` 响应头:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此应等待 `Retry-After` 指示的时间并复用同一个 key;`invalid_input` 则需要新的 key。此路由上的两种 `invalid_input` 冲突与 key 完全无关,换用新 key 也无法消除:当请求体选择了该提供商针对此模型无法处理的多部分操作(编辑)时,用 `model_provider` 指定替代提供商就会被拒绝,其 `detail` 以 “this request's `image` selects the edit operation” 开头;此外,在该检查之后还会进行另一项检查,如果请求已经为路径中的提供商解析了自带密钥(BYOK)凭据,也会被拒绝,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭据(多部分场景下还不带编辑)。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当 `concurrency_limit_exceeded` 时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当为 `concurrency_limit_exceeded` 时) - 请求内容未通过模型的 schema 校验。 + 请求内容未通过模型 schema 的校验。 - 正文:[`RouterValidationErrorResponse`](#routervalidationerrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` + 响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed` - 检查 `X-Comfy-Error-Type`:`queue_backlog_full` 表示你持有的未完成排队请求已达到允许的上限,因此请在其中一个完成后再次提交;`rate_limited` 表示需要等待 `Retry-After` 指定的时间。 + 检查 `X-Comfy-Error-Type` 响应头:`queue_backlog_full` 表示你已持有允许数量的未完成排队请求,因此应等其中一个完成后再提交;`rate_limited` 表示需要等待 `Retry-After` 中给出的秒数。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(`rate_limited` 时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当为 `rate_limited` 时) - Router 暂时不可用。请使用退避策略重试。 + Router 暂时不可用。请退避后重试。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) + 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时) - 请求超过了截止时间。重试前请检查错误类型。 + 请求超出了某个截止时间。重试前请先检查错误类型。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}` **收集一个已提交请求的结果。** -收集端点。对于已成功完成的请求,它返回合作伙伴模型自身的原生输出,与同步路由的 `200` 针对同一模型和同一输入返回的内容逐字节相同,因此两种交付模式产生同一种结果形状,调用方无需第二个解析器即可在两者之间切换。 +收集端点。对于已成功完成的请求,它返回合作伙伴模型自己的原生输出,与同步路由针对相同模型和相同输入所返回的 `200` 内容逐字节一致。因此两种投递方式产生同一种结果形状,调用方无需第二个解析器即可在两者之间切换。 **参数** - 规范 `{provider}/{model}` 模型 ID 的小写提供商段,即正在运行其模型的合作伙伴。 + 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符 + 类型: [`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 的小写模型段,即在该提供商内运行的模型。 + 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型: [`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 要处理的已排队请求,即提交时在响应体中返回的 `request_id`。 + 要处理的已执行请求,即提交时在响应正文中返回的 `request_id`。 - 类型:[`RouterQueueRequestId`](#routerqueuerequestid),`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 + 类型: [`RouterQueueRequestId`](#routerqueuerequestid),`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 **响应** - OK:为产生了结果的请求存储的结果。该请求已成功完成,或是同时带有记录扣费和存储结果的终端请求。它按合作伙伴自己的媒体类型原样返回,与同步路由的 `200` 返回它的方式完全一致,并遵循提交时接受的相同提供商选择约定:未提供 `model_provider`,或提供 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回此模型的原生约定,转换失败时回退到备用提供商自己的原始响应,并记录日志,绝不静默),形状为此模型自身的原生输出;使用 `strict_mode=true` 时,则是备用提供商的响应原样返回。对于合作伙伴直接以字节返回生成结果的模型,响应体是这些字节,使用合作伙伴自己的 `Content-Type` 而非 `application/json`;请根据响应的 `Content-Type` 进行分支,不要假定它是 JSON 文档。 + OK,即针对一个产生了结果的请求所存储的结果。该请求可以是成功完成的请求,也可以是同时带有已记录扣费和已存储结果的终端请求。结果在合作伙伴自己的媒体类型下原样返回,与同步路由的 `200` 返回完全一致,并遵循提交时所接受的同一套提供商选择约定:不带 `model_provider`,或带 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回本模型的原生约定,转换失败时回退到替代提供商自己的原始响应,并记录日志,绝不静默)时,形状为本模型自己的原生输出;当 `strict_mode=true` 时,返回的是替代提供商的响应,原样不变。对于合作伙伴直接以字节返回生成结果的模型,正文就是这些字节,使用合作伙伴自己的 `Content-Type` 而非 `application/json`;请根据响应的 `Content-Type` 进行分支处理,不要假定它是 JSON 文档。 - 响应体:[`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`);响应头:`X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Credits-Used` + Body: [`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`)。Headers: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` - 已接受:请求尚未完成。 + Accepted,请求尚未完成。 - 响应体:[`RouterQueueStatusResponse`](#routerqueuestatusresponse);响应头:`X-Comfy-Request-Id`、`Retry-After` + Body: [`RouterQueueStatusResponse`](#routerqueuestatusresponse)。Headers: `X-Comfy-Request-Id`, `Retry-After` - 缺失或无效的凭据。 + 凭据缺失或无效。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 此调用方或模型不允许该请求。 + 该调用方或模型不允许此请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 未找到该模型 ID。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或由于模型本身未报告的原因而失败。 + Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `rate_limited`:当前调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一次请求。 + `rate_limited`:每个调用方的请求配额已用尽。请等待 `Retry-After` 之后再发送下一个请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` Router 暂时不可用。请使用退避策略重试。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 请求处于与操作冲突的状态。请检查错误类型。 + 请求处于与该操作冲突的状态。请检查错误类型。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - 请求超过了截止时间。重试前请检查错误类型。 + 请求超出了截止时间。重试前请检查错误类型。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或由于模型本身未报告的原因而失败。 + Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。 - 响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` **请求取消一个已提交的请求。** -请求 Comfy 停止一个尚未完成的请求。这是一项请求,而不是保证,`202` 正说明了这一点:`CANCELLATION_REQUESTED` 表示该请求已被接受,并不表示运行已经停止。已经发送给合作伙伴的运行仍可能完成;而合作伙伴完成的生成会被计费,无论是否有人获取结果。因此,需要了解实际结果的调用方应随后读取状态端点,在状态端点中,已生效的取消会显示为 `COMPLETED`,并像其他所有终端结果一样带有 `error_type`。 +请求 Comfy 停止一个尚未完成的请求。这只是一个请求,并非保证,`202` 表达的正是这一点:`CANCELLATION_REQUESTED` 表示该请求已被接受,而不表示该次运行已经停止。已经在合作伙伴处开始传输的运行仍可能照常完成,而合作伙伴一旦完成生成就会被计费,无论是否有人取走结果。因此,需要知道实际结果的调用方应随后读取状态端点,在那里,已生效的取消会表现为 `COMPLETED`,并像其他所有终端结果一样携带 `error_type`。 **参数** 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字短标识,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即要在该提供商内运行的模型。 + 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符 - 要处理的排队请求,即提交操作在响应正文中返回的 `request_id`。 + 要处理的已排队请求,即提交时在响应体中返回的 `request_id`。 类型:[`RouterQueueRequestId`](#routerqueuerequestid),`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 @@ -730,81 +731,81 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ 已接受:`CANCELLATION_REQUESTED`。 - 正文:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id` + 响应体:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id` 冲突:`ALREADY_COMPLETED`。 - 正文:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id` + 响应体:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id` - 无效请求。请检查错误类型和请求正文。 + 请求无效。请检查错误类型和请求体。 - 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 凭据缺失或无效。 - 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 该调用方或模型不允许此请求。 - 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`:当前调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一次请求。 + `rate_limited`:该调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一个请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` Router 暂时不可用。请使用退避策略重试。 - 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或由于模型本身未反馈的原因而失败。 + Router 请求级失败:请求从未到达模型,或因模型本身未报告的原因而失败。 - 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` **读取一个已提交请求的队列状态。** -轮询端点。它返回的是请求当前的状态,而非结果,因此客户端可以持续观察一次长时间生成,而无须在每次轮询时都传输其输出。当此端点返回 `COMPLETED` 时,再从下方的读取接口一次性获取结果。 +这是轮询端点。它只返回请求的当前状态,从不返回结果,因此客户端无需在每次轮询时都传输输出,即可跟踪一次长时间运行的生成任务。当该端点返回 `COMPLETED` 时,再通过下面的读取端点一次性获取结果。 **参数** - 规范 `{provider}/{model}` 模型 ID 中的小写提供商标识段,即正在运行其模型的合作伙伴。 + 标准 `{provider}/{model}` 模型 ID 中的小写提供商段,即被运行的模型所属的合作伙伴。 - 类型:[`RouterProviderSegment`](#routerprovidersegment)。字母数字标识,例如 `anthropic`,最多 64 个字符 + 类型:[`RouterProviderSegment`](#routerprovidersegment) ,字母数字 slug,例如 `anthropic`,最多 64 个字符 - 规范 `{provider}/{model}` 模型 ID 中的小写模型标识段,即在该提供商下要运行的模型。 + 标准 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。 - 类型:[`RouterModelSegment`](#routermodelsegment)。字母数字标识,例如 `claude-opus-4-6`,最多 128 个字符 + 类型:[`RouterModelSegment`](#routermodelsegment) ,字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符 - 要查询的排队请求,即提交时在响应体中返回的 `request_id`。 + 要定位的排队请求,即提交时在响应体中返回的 `request_id`。 - 类型:[`RouterQueueRequestId`](#routerqueuerequestid)。`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 + 类型:[`RouterQueueRequestId`](#routerqueuerequestid) ,`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符 **响应** @@ -812,52 +813,52 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ OK,请求当前的队列状态。 - 正文:[`RouterQueueStatusResponse`](#routerqueuestatusresponse)。请求头:`X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` + Body:[`RouterQueueStatusResponse`](#routerqueuestatusresponse) ,Headers:`X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` - 凭据缺失或无效。 + 凭证缺失或无效。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - 该调用方或模型无权执行此请求。 + 该调用方或模型无权发起此请求。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。 + Router 请求级别的失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - `rate_limited`:当前调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一次请求。 + `rate_limited`:该调用方的请求配额已用尽。请等待 `Retry-After` 之后再发送下一个请求。 - 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` + Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` - Router 暂时不可用。请以退避方式重试。 + Router 暂时不可用。请使用退避策略重试。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` - Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。 + Router 请求级别的失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。 - 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` -此处的描述较为简短。有关模型选择、验证、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api);有关请求头行为,请参阅[请求头](/zh/development/comfy-router/headers)。 +此处的描述较为简短。模型选择、验证、重试和计费请参阅[使用 Comfy Router API](/zh/development/comfy-router/api),请求头行为请参阅[请求头](/zh/development/comfy-router/headers)。 ## 错误分类桶 From a0e3a9e1c55905aa7a328c18244310302f4202d7 Mon Sep 17 00:00:00 2001 From: "Daxiong (Lin)" Date: Fri, 13 Nov 2026 18:46:38 +0800 Subject: [PATCH 27/36] fix(i18n): repair the ja Router code page and the es structure-parity gaps - ja gemini-4-carbon: restore the generationConfig.seed ParamField close (mint-checks failed to parse the MDX) and finish the Japanese sentence that still carried the English lead-in - es byteplus code pages: restore the omni_reference_task_type ParamField - es gpt-image-2-6 code pages: restore frame_count and frame_duration_ms - es dreamina-seedance-2-0-fast: restore the Serving providers section - es models index: restore the Pixverse and Quiver tables --- es/development/comfy-router/models.mdx | 15 +++++++++++++++ .../dreamina-seedance-2-0-260128/code.mdx | 10 ++++++++++ .../code.mdx | 19 +++++++++++++++++++ .../dreamina-seedance-2-0-mini/code.mdx | 10 ++++++++++ .../dreamina-seedance-2-5-260628/code.mdx | 10 ++++++++++ .../byteplus/seedance-1-0-pro-250528/code.mdx | 10 ++++++++++ .../seedance-1-0-pro-fast-251015/code.mdx | 10 ++++++++++ .../openai/gpt-image-2-6-flare/code.mdx | 12 ++++++++++++ .../openai/gpt-image-2-6-sunburst/code.mdx | 12 ++++++++++++ .../models/google/gemini-4-carbon/code.mdx | 3 ++- 10 files changed, 110 insertions(+), 1 deletion(-) diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index f0fe9ddcce..125ed7b828 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -669,12 +669,27 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [Pika Sfx](/es/development/comfy-router/models/pika/pika-sfx/code) | `pika/pika-sfx` | Texto | Audio | | [Pika Soundtrack](/es/development/comfy-router/models/pika/pika-soundtrack/code) | `pika/pika-soundtrack` | Video, Texto | Video + Audio | +## Pixverse + +| Modelo | ID | Entrada | Salida | +| --- | --- | --- | --- | +| [V3.5](/es/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | Texto | Video | +| [V6 Max](/es/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | Texto | Video | +| [V6](/es/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | Texto | Video | + ## Pruna | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | | [P Video 2](/es/development/comfy-router/models/pruna/p-video-2/code) | `pruna/p-video-2` | Texto, Imagen, Audio | Video + Audio | +## Quiver + +| Modelo | ID | Entrada | Salida | +| --- | --- | --- | --- | +| [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Texto, Imagen | Imagen | +| [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Texto, Imagen | Imagen | + ## Qwen | Modelo | ID | Entrada | Salida | diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 15f836a08b..5395311f8e 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -312,6 +312,16 @@ false: El modelo genera un video silencioso.En los modelos que lo admiten, el pr El ID del modelo que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo; el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama al Router lo omite. + + Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. +reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. +Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. + + Valores posibles: `reference`, `edit`, `extend` + + Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y un tamaño de archivo menor. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 4861484c41..8ac885d3f7 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -174,6 +174,15 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ +## Proveedores de servicio + +Comfy Router sirve este modelo directamente, a menos que la solicitud indique otro proveedor. Los siguientes proveedores también lo sirven, en el mismo endpoint y con el mismo ID de modelo, y se seleccionan con el parámetro de consulta `model_provider`. + +- **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128` +- **Kelly**, como `kelly/kelly-seedance-2.0-fast`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128?model_provider=kelly` + +`strict_mode` tiene como valor predeterminado false, así que Router traduce el cuerpo de solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para todos los modelos que se enrutan de esta forma. + ## Esquema ### Entrada @@ -298,6 +307,16 @@ false: el modelo genera un video sin audio.En los modelos que lo admiten, el pro El ID del modelo que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa a la v1 de POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde el Router lo omite. + + Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. +reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. +Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. + + Valores posibles: `reference`, `edit`, `extend` + + Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 60b13471ce..38d61e7e2d 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -298,6 +298,16 @@ false: el modelo produce un video sin audio.En los modelos que lo admiten, la pi El ID del modelo a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO aparece en la lista `required` de este esquema porque Comfy Router lo rellena a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través del Router lo omite. + + Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. +reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. +Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. + + Valores posibles: `reference`, `edit`, `extend` + + Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 77036bec1a..266b0d7a72 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -313,6 +313,16 @@ En los modelos que lo admiten, el proveedor revisa el contenido de la pista de a El ID del modelo al que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada v1 directa a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través del Router lo omite. + + Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. +reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. +Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. + + Valores posibles: `reference`, `edit`, `extend` + + Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index fa6df3bf63..816dcea832 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -298,6 +298,16 @@ false: el modelo genera un video sin audio.En los modelos que lo admiten, el pro El ID del modelo que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza con un 400 cualquier otro valor y también la omisión. NO está en la lista `required` de este esquema porque Comfy Router lo completa desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde Router lo omite. + + Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. +reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. +Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. + + Valores posibles: `reference`, `edit`, `extend` + + Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 97dce010fe..e0855f0d06 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -298,6 +298,16 @@ false: el modelo genera un video silencioso.En los modelos que lo admiten, el pr El ID del modelo al que se llama. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa a la v1 mediante POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo; el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo completa a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. + + Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. +reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. +Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. + + Valores posibles: `reference`, `edit`, `extend` + + Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 394a344196..54f124fd6f 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -160,6 +160,18 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES Valores posibles: `transparent`, `opaque`, `auto` + + El número de fotogramas del GIF animado (2-16, el rango propio de OpenAI); solo tiene sentido con `output_format: "gif"` -- se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, se usa el valor predeterminado propio de OpenAI, 9, EXCEPTO que Comfy además limita este campo por entorno (ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES, nunca por encima del máximo propio de este campo, 16): un valor por encima del límite configurado se rechaza, y un `frame_count` omitido se rechaza en lugar de reducirse en silencio cuando el valor predeterminado de 9 supera por sí mismo el límite configurado, de modo que al llamador se le indica que establezca `frame_count` explícitamente en lugar de recibir una animación más corta que la predeterminada de OpenAI. El número de fotogramas también acota la cotización previa y el techo de resultado de 64 MiB, que escalan con él. + + Rango: `2` a `16` + + + + Los milisegundos que se muestra cada fotograma (el rango propio de OpenAI es 20-2000, redondeado a 10 ms); solo tiene sentido con `output_format: "gif"` -- se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, se usa el valor predeterminado propio de OpenAI, 200. + + Rango: `20` a `2000` + + La imagen o imágenes de origen que se van a editar. LA PRESENCIA DE ESTE CAMPO SELECCIONA LA OPERACIÓN DE EDICIÓN: omítelo por completo para la generación de texto a imagen. El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` constituye toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), excepto que un prompt de edición describe el CAMBIO que deseas en lugar de la escena, así que el cuerpo de edición de abajo se lee distinto del ejemplo de generación aunque solo este campo sea estructuralmente nuevo. diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 80819a3310..e1a7119494 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -159,6 +159,18 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ Valores posibles: `transparent`, `opaque`, `auto` + + El número de fotogramas del GIF animado (2-16, el rango propio de OpenAI); solo tiene sentido con `output_format: "gif"` -- se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, se usa el valor predeterminado propio de OpenAI, 9, EXCEPTO que Comfy además limita este campo por entorno (ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES, nunca por encima del máximo propio de este campo, 16): un valor por encima del límite configurado se rechaza, y un `frame_count` omitido se rechaza en lugar de reducirse en silencio cuando el valor predeterminado de 9 supera por sí mismo el límite configurado, de modo que al llamador se le indica que establezca `frame_count` explícitamente en lugar de recibir una animación más corta que la predeterminada de OpenAI. El número de fotogramas también acota la cotización previa y el techo de resultado de 64 MiB, que escalan con él. + + Rango: `2` a `16` + + + + Los milisegundos que se muestra cada fotograma (el rango propio de OpenAI es 20-2000, redondeado a 10 ms); solo tiene sentido con `output_format: "gif"` -- se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, se usa el valor predeterminado propio de OpenAI, 200. + + Rango: `20` a `2000` + + La o las imágenes de origen que se van a editar. LA PRESENCIA DE ESTE CAMPO SELECCIONA LA OPERACIÓN DE EDICIÓN: omítelo por completo para la generación de texto a imagen. El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` es toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), salvo que un prompt de edición describe el CAMBIO que quieres en lugar de la escena, así que el cuerpo de edición de abajo se lee de forma distinta al ejemplo de generación, aunque solo este campo sea estructuralmente nuevo. diff --git a/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx index cc254e3ccd..4d0508ff25 100644 --- a/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -273,7 +273,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ - When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requestsでは、シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じレスポンスを返すよう最善を尽くします。決定的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用していてもレスポンスにばらつきが生じることがあります。デフォルトではランダムなシード値が使用されます。次のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + シードが特定の値に固定されると、モデルは繰り返しのリクエストに対して同じレスポンスを提供するよう最善を尽くします。決定的な出力は保証されません。また、モデルや temperature などのパラメータ設定を変更すると、同じシード値を使用していてもレスポンスにばらつきが生じることがあります。デフォルトではランダムなシード値が使用されます。次のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 From b2a437d8338bc929cbc54a2283f84cffc6b50b95 Mon Sep 17 00:00:00 2001 From: "Daxiong (Lin)" Date: Fri, 13 Nov 2026 19:01:31 +0800 Subject: [PATCH 28/36] fix(i18n): clear the remaining MDX parse errors and broken links - ja nano-banana-2, ko gemini-3-8-flash, ko veo-3-1-fast, ko reference: restore the component close tags that the generator collapsed onto the opening line (mint-checks could not parse them) - ko krea-3: drop a leaked control token that replaced the closing tag - ja/zh limitations: point the Router specification link at the repo-root router-openapi.yaml instead of a locale-prefixed path that does not exist - ko limitations: restore the missing 'Router does not cover every partner operation' paragraph, including the specification link - es models index: link the Pixverse and Quiver rows to the English pages, which are the only ones that exist --- es/development/comfy-router/models.mdx | 10 +++++----- ja/development/comfy-router/limitations.mdx | 2 +- .../comfy-router/models/google/nano-banana-2/code.mdx | 5 ++++- ko/development/comfy-router/limitations.mdx | 2 ++ .../models/google/gemini-3-8-flash/code.mdx | 2 +- .../comfy-router/models/krea/krea-3/code.mdx | 2 +- .../models/veo/veo-3-1-fast-generate-001/code.mdx | 3 ++- ko/development/comfy-router/reference.mdx | 4 +++- zh/development/comfy-router/limitations.mdx | 2 +- 9 files changed, 20 insertions(+), 12 deletions(-) diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 125ed7b828..6fe352672d 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -673,9 +673,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | -| [V3.5](/es/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | Texto | Video | -| [V6 Max](/es/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | Texto | Video | -| [V6](/es/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | Texto | Video | +| [V3.5](/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | Texto | Video | +| [V6 Max](/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | Texto | Video | +| [V6](/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | Texto | Video | ## Pruna @@ -687,8 +687,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | -| [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Texto, Imagen | Imagen | -| [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Texto, Imagen | Imagen | +| [Arrow 2 Telos](/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Texto, Imagen | Imagen | +| [Arrow 2](/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Texto, Imagen | Imagen | ## Qwen diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index 1ab95a4e35..6805d5037f 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -148,7 +148,7 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 ## Router はすべてのパートナー操作をカバーするわけではない -Router はモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があり、これらは Router の外側にあり、そのコントラクトでは説明されていません。Router 自身のサーフェスは [Comfy Router 仕様](/ja/router-openapi.yaml)です。サポートはプロバイダーによって異なります。 +Router はモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があり、これらは Router の外側にあり、そのコントラクトでは説明されていません。Router 自身のサーフェスは [Comfy Router 仕様](/router-openapi.yaml)です。サポートはプロバイダーによって異なります。 ### Krea 3 の参照画像: 先にアップロードするか、公開 https URL を使用する diff --git a/ja/development/comfy-router/models/google/nano-banana-2/code.mdx b/ja/development/comfy-router/models/google/nano-banana-2/code.mdx index 793a0a6c08..40a3dc4ebf 100644 --- a/ja/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/ja/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -606,7 +606,10 @@ Top-P は、モデルが出力のためにトークンを選択する方法を -Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + コンテンツが該当する安全カテゴリ + + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + コンテンツが指定された安全カテゴリに違反する確率 diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index 9d9dea9039..6c19aa0185 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -148,6 +148,8 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 ## Router는 모든 파트너 작업을 다루지 않습니다 +Router는 모델을 실행합니다. 파일 업로드, 계정 읽기, 에셋 관리, 스트리밍, 공급자 작업 제어에는 `/proxy/…` 아래의 파트너 프록시 경로가 필요할 수 있으며, 이 경로들은 Router 외부에 있고 그 계약에 설명되어 있지 않습니다. Router 자체의 표면은 [Comfy Router 사양](/router-openapi.yaml)이며, 지원 범위는 공급자마다 다릅니다. + ### Krea 3 참조 이미지: 먼저 업로드하거나 공개 https URL 사용 `krea/krea-3`의 `image_urls`에서 `POST /proxy/krea/assets`가 반환한 `image_url`(`https://app-uploads.krea.ai/...` URL)은 항상 허용됩니다. 다른 링크가 허용되는지는 환경에 따라 다릅니다. api.comfy.org에서는 현재 허용됩니다. 8개를 초과하는 항목은 요청의 스키마 검사에 의해 가져오기 전에 `422`로 거부됩니다. diff --git a/ko/development/comfy-router/models/google/gemini-3-8-flash/code.mdx b/ko/development/comfy-router/models/google/gemini-3-8-flash/code.mdx index 38ca6a0a68..f61001dd85 100644 --- a/ko/development/comfy-router/models/google/gemini-3-8-flash/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-3-8-flash/code.mdx @@ -277,7 +277,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Available for the following models:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + 시드를 특정 값으로 고정하면 모델은 반복되는 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 시드 값을 사용하더라도 응답에 변동이 생길 수 있습니다. 기본적으로는 임의의 시드 값이 사용됩니다. 사용 가능한 모델:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 diff --git a/ko/development/comfy-router/models/krea/krea-3/code.mdx b/ko/development/comfy-router/models/krea/krea-3/code.mdx index af6296c8f4..f6416f1b79 100644 --- a/ko/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-3/code.mdx @@ -186,7 +186,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ fast(기본값), high 또는 ultra. high와 ultra는 복잡한 편집을 더 자세히 계획하며 시간이 더 오래 걸립니다. ultra는 resolution 2k가 필요합니다. -`GET /v2/models/krea/krea-3/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 이전에 호출을 검증하는 기준이 되는 동일한 문서입니다. +`GET /v2/models/krea/krea-3/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이 문서는 요청이 공급자에 도달하기 이전에 호출을 검증하는 기준이 되는 동일한 문서입니다. ### 출력 diff --git a/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx b/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx index e884cc0a18..be044a0a4a 100644 --- a/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx +++ b/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx @@ -337,7 +337,8 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ 생성된 비디오의 목표 재생 시간(초)입니다. Veo 2: 5-8. Veo 3/3.1: 4, 6 또는 8. 기본값: 8 - 더 높은 품질을 위해 프롬프트를 자동으로 개선합니다. 기본값은 true입니다. + + 더 높은 품질을 위해 프롬프트를 자동으로 개선합니다. 기본값은 true입니다. diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index acba2df505..8c5c990dc6 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -240,7 +240,9 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 파트너 모델의 네이티브 JSON 입력입니다. `model_provider`가 없으면 요청은 모델의 기본 공급자에서 네이티브 디스패치를 실행하며, 이 본문은 모델 자체의 네이티브 스키마이고 그대로 전달됩니다(이 경우 `strict_mode`는 의미가 없고 아무것도 바꾸지 않습니다). `model_provider`가 대체 공급자를 선택하고 `strict_mode=false`(기본값)인 경우, 본문은 전송되기 전에 해당 공급자의 실제 스키마로 변환됩니다. 정확히 표현할 수 없는 네이티브 필드는 버려지고 응답의 `X-Comfy-Router-Dropped-Params` 헤더를 통해 알려지며, 결코 조용히 넘어가지 않습니다. `model_provider`가 대체 공급자를 선택하고 `strict_mode=true`이면 변환이 실행되지 않습니다. 본문은 이 모델의 네이티브 스키마가 아니라 이미 그 대체 공급자 자체의 실제 스키마여야 하며(`strict_mode` 참조), 그대로 전달됩니다. 본문의 필드 자체가 둘 이상의 작업을 지원하는 모델에서 Router가 실행할 작업을 선택하기도 합니다. 편집 가능한 이미지 모델의 경우 입력 이미지가 포함되면 텍스트 기반 이미지 생성에서 이미지 기반 이미지 생성(편집) 작업으로 전환되며, 이 작업은 별도의 요율로 과금될 수 있습니다. Seedance 비디오 모델의 경우 `content[].role`이 작업을 선택합니다(첫 프레임 이미지는 이미지 기반 비디오 생성을, 레퍼런스 이미지 또는 클립은 레퍼런스 기반 비디오 생성을 선택합니다). 네이티브 디스패치에서 Seedance 과금은 역할이 아니라 `content`의 미디어 종류를 따릅니다. 비디오 입력이 하나라도 있는 요청은 비디오 기반 비디오 생성으로, 그렇지 않고 이미지가 하나라도 있으면 이미지 기반 비디오 생성으로, 그 외에는 텍스트 기반 비디오 생성으로 과금됩니다. 다만 `draft_task` 항목에서 나온 최종 렌더는 그것이 렌더링하는 Draft의 작업으로 과금됩니다. 일부 모델은 텍스트 기반 비디오 생성과 이미지 기반 비디오 생성을 같은 요율로 과금합니다. `model_provider`가 대체 공급자를 선택하는 경우, 조건이 적용된 각 작업은 해당 공급자 자체의 요율로 과금될 수 있습니다. -**응답** +**응답** + + OK - `model_provider`가 없거나, `model_provider`와 `strict_mode=false`(기본값)를 함께 사용하는 경우, 가능하면 이 모델의 네이티브 계약으로 다시 변환하며 변환에 실패하면 대체 공급자 자체의 원시 응답으로 폴백합니다(로그에 기록되며, 결코 조용히 넘어가지 않습니다). 이때 형태는 이 모델 자체의 네이티브 출력입니다. `strict_mode=true`이면 대체 공급자의 응답이 변경 없이 그대로 반환됩니다. 파트너가 생성 요청에 바이트로 직접 응답하는 모델의 경우, 본문은 `application/json`이 아니라 파트너 자체의 `Content-Type`으로 반환되는 해당 바이트입니다. 응답의 `Content-Type`을 기준으로 분기하고 JSON 문서라고 가정하지 마세요. 본문: [`RouterModelOutput`](#routermodeloutput) 또는 원시 바이트 (`*/*`) -- 헤더: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index 3f054dd929..90f6c55ae3 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -149,7 +149,7 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, ## Router 并不覆盖所有合作伙伴操作 -Router 运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由,这些路由不在 Router 范围内,其契约也未描述它们。Router 自身的接口面是 [Comfy Router 规范](/zh/router-openapi.yaml);支持情况因提供商而异。 +Router 运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由,这些路由不在 Router 范围内,其契约也未描述它们。Router 自身的接口面是 [Comfy Router 规范](/router-openapi.yaml);支持情况因提供商而异。 ### Krea 3 参考图像:先上传,或使用公开的 https 网址 From 634b62163a165b41a6a6604aafd6f758478229cd Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Sat, 14 Nov 2026 11:10:45 +0800 Subject: [PATCH 29/36] i18n: sync zh/ja/ko translations with upstream/main (2026-11-14) --- docs.json | 6 +- ja/development/comfy-router/limitations.mdx | 7 +- .../models/openai/gpt-image-1-5/code.mdx | 6 +- .../openai/gpt-image-2-5-flare/code.mdx | 8 +- .../openai/gpt-image-2-5-sunburst/code.mdx | 8 +- .../openai/gpt-image-2-6-flare/code.mdx | 16 +- .../openai/gpt-image-2-6-sunburst/code.mdx | 16 +- .../models/openai/gpt-image-2/code.mdx | 6 +- ja/development/comfy-router/providers.mdx | 8 +- ja/development/deploy/cloud-custom-builds.mdx | 262 +++++++++++++++++ ja/development/deploy/overview.mdx | 97 +------ ja/development/serverless/overview.mdx | 67 ++++- .../partner-nodes/pika/pika-h3-flex.mdx | 7 +- ko/development/comfy-router/limitations.mdx | 7 +- .../models/openai/gpt-image-1-5/code.mdx | 6 +- .../openai/gpt-image-2-5-flare/code.mdx | 8 +- .../openai/gpt-image-2-5-sunburst/code.mdx | 8 +- .../openai/gpt-image-2-6-flare/code.mdx | 16 +- .../openai/gpt-image-2-6-sunburst/code.mdx | 16 +- .../models/openai/gpt-image-2/code.mdx | 6 +- ko/development/comfy-router/providers.mdx | 8 +- ko/development/deploy/cloud-custom-builds.mdx | 266 ++++++++++++++++++ ko/development/deploy/overview.mdx | 101 +------ ko/development/serverless/overview.mdx | 55 +++- .../partner-nodes/pika/pika-h3-flex.mdx | 13 +- zh/development/comfy-router/limitations.mdx | 7 +- .../models/openai/gpt-image-1-5/code.mdx | 6 +- .../openai/gpt-image-2-5-flare/code.mdx | 8 +- .../openai/gpt-image-2-5-sunburst/code.mdx | 8 +- .../openai/gpt-image-2-6-flare/code.mdx | 16 +- .../openai/gpt-image-2-6-sunburst/code.mdx | 16 +- .../models/openai/gpt-image-2/code.mdx | 6 +- zh/development/comfy-router/providers.mdx | 10 +- zh/development/deploy/cloud-custom-builds.mdx | 262 +++++++++++++++++ zh/development/deploy/overview.mdx | 101 +------ zh/development/serverless/overview.mdx | 51 +++- .../partner-nodes/pika/pika-h3-flex.mdx | 5 +- 37 files changed, 1136 insertions(+), 384 deletions(-) create mode 100644 ja/development/deploy/cloud-custom-builds.mdx create mode 100644 ko/development/deploy/cloud-custom-builds.mdx create mode 100644 zh/development/deploy/cloud-custom-builds.mdx diff --git a/docs.json b/docs.json index debff87a25..e613c45613 100644 --- a/docs.json +++ b/docs.json @@ -7671,6 +7671,7 @@ }, "zh/development/deploy/overview", "zh/development/deploy/cloud", + "zh/development/deploy/cloud-custom-builds", "zh/development/examples" ] }, @@ -11862,6 +11863,7 @@ }, "ja/development/deploy/overview", "ja/development/deploy/cloud", + "ja/development/deploy/cloud-custom-builds", "ja/development/examples" ] }, @@ -15983,6 +15985,7 @@ }, "ko/development/deploy/overview", "ko/development/deploy/cloud", + "ko/development/deploy/cloud-custom-builds", "ko/development/examples" ] }, @@ -20537,7 +20540,8 @@ "group": "Comfy Cloud", "pages": [ "es/development/deploy/cloud", - "es/development/deploy/cloud-usage" + "es/development/deploy/cloud-usage", + "es/development/deploy/cloud-custom-builds" ] }, { diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index 6805d5037f..cf80898375 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の機能と制限" sidebarTitle: "機能と制限" description: "Comfy Router とパートナープロキシのどちらを選ぶか、長時間実行される呼び出しへの備え、リカバリ・レート制限・アセット保存について説明します。" -translationSourceHash: 04575573 +translationSourceHash: cd27af52 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": 789d46e5 + "Models without a pre-flight estimate": d83b12e1 "Router does not cover every partner operation": 11621b39 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -32,6 +32,7 @@ translationBlockHashes: + Router はパートナーモデルを、1回の同期 HTTP 呼び出し、または送信して後で結果を取得するキュー中のリクエストを通じて実行します。アプリケーションが完了した結果を待つことができ、あるいは後で結果を取得でき、さらにモデル自身の入力フィールドと出力フィールドを処理できる場合に使用します。 ## Router がサポートするもの @@ -130,7 +131,7 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` - **ltx**: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe`, `ltx/ltx-video-upscale` - **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` +- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-gpt-image-2.5-flare`, `minimax/minimax-gpt-image-2.5-sunburst`, `minimax/minimax-gpt-image-2.6-flare`, `minimax/minimax-gpt-image-2.6-sunburst`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index fb4c682084..d6a32bd887 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で GPT Image 1.5 を使用する" description: "Comfy Router 経由で openai/gpt-image-1.5 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 1.5" -translationSourceHash: a1545fc4 +translationSourceHash: 2c734ca2 translationFrom: development/comfy-router/models/openai/gpt-image-1-5/code.mdx translationBlockHashes: "_intro": 7a84676f "Quick start": f364e3f2 - "Schema": 8b660697 + "Schema": aaeae86d "Examples": c73859ec --- @@ -307,7 +307,7 @@ URL は認証情報なしで解決できる必要があります。Router はサ - 生成が完了した時刻の Unix タイムスタンプ(秒)。これは OpenAI が画像生成レスポンスで REQUIRED として宣言している唯一のメンバーであるため、OpenAI が生成元である場合は常に存在します。fal、pika、wavespeed、runware が提供する、alt 対応 ID のいずれかのレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、これは完全に省略されます。現代の epoch 値は 2^31 に十分近く、未フォーマットの `integer` は多くの SDK ジェネレータで 32 ビットフィールドを生成するため、`int64` と宣言されています。 + 生成が完了した時刻の Unix タイムスタンプ(秒)。これは OpenAI が画像生成レスポンスで REQUIRED として宣言している唯一のメンバーであるため、OpenAI が生成元である場合は常に存在します。fal、minimax、pika、wavespeed、runware が提供する、alt 対応 ID のいずれかのレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、これは完全に省略されます。現代の epoch 値は 2^31 に十分近く、未フォーマットの `integer` は多くの SDK ジェネレータで 32 ビットフィールドを生成するため、`int64` と宣言されています。 フォーマット: `int64` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 623495fbfc..8505cb8c0a 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -2,13 +2,13 @@ title: "GPT Image 2.5 Flare を Comfy Router で使う" description: "Comfy Router 経由で openai/gpt-image-2.5-flare を呼び出します: endpoint、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2.5 Flare" -translationSourceHash: e3a1017e +translationSourceHash: 060a72c2 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx translationBlockHashes: "_intro": 1e1ed044 "Quick start": c9749309 - "Serving providers": ef0e9384 - "Schema": a7048d34 + "Serving providers": 943a35c1 + "Schema": aa138d7e "Examples": c73859ec --- @@ -319,7 +319,7 @@ Router が `GET /v2/models/openai/gpt-image-2.5-flare/openapi.json` で提供す - 生成が完了した時刻の Unix タイムスタンプ(秒)。OpenAI が画像生成レスポンスで必須(REQUIRED)として宣言している唯一のメンバーであるため、OpenAI が生成元である場合は常に存在します。alt ベースの ID で fal、pika、wavespeed、runware が処理したレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に完全に省略されます。現在のエポック値は 2^31 に十分近いため `int64` として宣言されています。整形されていない `integer` では、多くの SDK ジェネレータが 32 ビットのフィールドを生成してしまうためです。 + 生成が完了した時刻の Unix タイムスタンプ(秒)。OpenAI が画像生成レスポンスで必須(REQUIRED)として宣言している唯一のメンバーであるため、OpenAI が生成元である場合は常に存在します。alt ベースの ID で fal、minimax、pika、wavespeed、runware が処理したレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に完全に省略されます。現在のエポック値は 2^31 に十分近いため `int64` として宣言されています。整形されていない `integer` では、多くの SDK ジェネレータが 32 ビットのフィールドを生成してしまうためです。 形式: `int64` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index 1db01aae15..d748d1d1b7 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で GPT Image 2.5 Sunburst を使う" description: "Comfy Router 経由で openai/gpt-image-2.5-sunburst を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2.5 Sunburst" -translationSourceHash: 89d64476 +translationSourceHash: c9aa90d3 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx translationBlockHashes: "_intro": 84874630 "Quick start": 8da85011 - "Serving providers": 58af0c87 - "Schema": 61c5bb52 + "Serving providers": 89992590 + "Schema": e341df7c "Examples": c73859ec --- @@ -319,7 +319,7 @@ URL は認証情報なしで解決できなければなりません。Router は - 生成が完了した時刻の Unix タイムスタンプ(秒)。これは OpenAI が画像生成レスポンスで必須(REQUIRED)と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は常に存在します。alt ベースの id のいずれかに対して fal、pika、wavespeed、runware のいずれかが提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に完全に省略されます。現在のエポック値は 2^31 に十分近く、フォーマットされていない `integer` は多くの SDK ジェネレータで 32 ビットフィールドを生成してしまうため、`int64` として宣言されています。 + 生成が完了した時刻の Unix タイムスタンプ(秒)。これは OpenAI が画像生成レスポンスで必須(REQUIRED)と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は常に存在します。alt ベースの id のいずれかに対して fal、minimax、pika、wavespeed、runware のいずれかが提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に完全に省略されます。現在のエポック値は 2^31 に十分近く、フォーマットされていない `integer` は多くの SDK ジェネレータで 32 ビットフィールドを生成してしまうため、`int64` として宣言されています。 フォーマット: `int64` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 75dc51e86a..03d07cd8e1 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -2,12 +2,13 @@ title: "Comfy Router で GPT Image 2.6 Flare を使用する" description: "Comfy Router 経由で openai/gpt-image-2.6-flare を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2.6 Flare" -translationSourceHash: 82634d88 +translationSourceHash: 726e4807 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx translationBlockHashes: "_intro": 1693e80a "Quick start": 8222d9f4 - "Schema": 85f18947 + "Serving providers": ce8a80c6 + "Schema": cdcbdd35 "Examples": c73859ec --- @@ -150,6 +151,15 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES +## 提供プロバイダー + +このモデルは、リクエストで別のプロバイダーを指定しない限り、Comfy Router が直接提供します。以下のプロバイダーも同じエンドポイント、同じモデル ID で提供しており、`model_provider` クエリパラメータで選択します。 + +- **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare` +- **MiniMax**(`minimax/minimax-gpt-image-2-6-flare` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare?model_provider=minimax` + +`strict_mode` のデフォルトは false です。そのため Router は、このページに記載されているネイティブのリクエストボディをそのプロバイダー独自のスキーマに変換し、レスポンスを元の形式に翻訳し直します。API リファレンスの [`model_provider`、`strict_mode`、`fallback_provider`](/ja/development/comfy-router/reference#post-v2modelsprovidermodel) と、この方法でルーティングされるすべてのモデルについては[提供プロバイダー](/ja/development/comfy-router/providers)を参照してください。 + ## スキーマ ### 入力 @@ -319,7 +329,7 @@ URL は認証情報なしで解決できる必要があります。Router はサ - 生成が完了した時刻の Unix タイムスタンプ(秒)。OpenAI が画像生成レスポンスで必須と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は必ず含まれます。alt ベースの ID で fal、pika、wavespeed、runware が提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、このメンバーは完全に省略されます。`int64` として宣言されています。現在のエポック値は 2^31 に十分近いため、未フォーマットの `integer` では多くの SDK ジェネレータが 32 ビットのフィールドを生成してしまうからです。 + 生成が完了した時刻の Unix タイムスタンプ(秒)。OpenAI が画像生成レスポンスで必須と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は必ず含まれます。alt ベースの ID で fal、minimax、pika、wavespeed、runware が提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、このメンバーは完全に省略されます。`int64` として宣言されています。現在のエポック値は 2^31 に十分近いため、未フォーマットの `integer` では多くの SDK ジェネレータが 32 ビットのフィールドを生成してしまうからです。 Format: `int64` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 2ade359414..58be1be63a 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -2,12 +2,13 @@ title: "Comfy Router で GPT Image 2.6 Sunburst を使用する" description: "Comfy Router 経由で openai/gpt-image-2.6-sunburst を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2.6 Sunburst" -translationSourceHash: 4e6d4ec0 +translationSourceHash: b6d31807 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx translationBlockHashes: "_intro": 280b9c93 "Quick start": 2d3cb42c - "Schema": 5296621a + "Serving providers": d22ba32c + "Schema": d9027080 "Examples": c73859ec --- @@ -150,6 +151,15 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ +## 提供プロバイダー + +このモデルは、リクエストで別のプロバイダーを指定しない限り、Comfy Router が直接提供します。以下のプロバイダーも同じエンドポイント、同じモデル ID で提供しており、`model_provider` クエリパラメータで選択します。 + +- **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst` +- **MiniMax**(`minimax/minimax-gpt-image-2-6-sunburst` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst?model_provider=minimax` + +`strict_mode` のデフォルトは false です。そのため Router は、このページに記載されているネイティブのリクエストボディをそのプロバイダー独自のスキーマに変換し、レスポンスを元の形式に翻訳し直します。API リファレンスの [`model_provider`、`strict_mode`、`fallback_provider`](/ja/development/comfy-router/reference#post-v2modelsprovidermodel) と、この方法でルーティングされるすべてのモデルについては[提供プロバイダー](/ja/development/comfy-router/providers)を参照してください。 + ## スキーマ ### 入力 @@ -322,7 +332,7 @@ Router が `GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json` で提供 - 生成が完了したときの Unix タイムスタンプ(秒)。これは OpenAI が画像生成レスポンスで REQUIRED(必須)と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は必ず含まれます。一方、alt ベースの id で fal、pika、wavespeed、runware が提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、これ自体が完全に省略されます。現在のエポック値は 2^31 に十分近いため `int64` と宣言されています。整形されていない `integer` は、多くの SDK ジェネレーターで 32 ビットのフィールドを生成してしまうからです。 + 生成が完了したときの Unix タイムスタンプ(秒)。これは OpenAI が画像生成レスポンスで REQUIRED(必須)と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は必ず含まれます。一方、alt ベースの id で fal、minimax、pika、wavespeed、runware が提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、これ自体が完全に省略されます。現在のエポック値は 2^31 に十分近いため `int64` と宣言されています。整形されていない `integer` は、多くの SDK ジェネレーターで 32 ビットのフィールドを生成してしまうからです。 形式: `int64` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx index 7eaadd24dd..bfadd875cf 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router で GPT Image 2 を使用する" description: "Comfy Router 経由で openai/gpt-image-2 を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "GPT Image 2" -translationSourceHash: 2fe15764 +translationSourceHash: 40bf9f79 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 "Serving providers": f3930e40 - "Schema": 4e6e5e53 + "Schema": d733408e "Examples": c73859ec --- @@ -324,7 +324,7 @@ Router が `GET /v2/models/openai/gpt-image-2/openapi.json` で提供するス - 生成が完了した時刻の Unix タイムスタンプ(秒)。これは OpenAI が画像生成レスポンスにおいて REQUIRED(必須)と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は常に存在します。alt 系の id で fal、pika、wavespeed、runware が提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、これは完全に省略されます。現在のエポック値は 2^31 に十分近いため、書式指定のない `integer` は多くの SDK ジェネレータで 32 ビットフィールドを生成してしまいます。そのため `int64` として宣言されています。 + 生成が完了した時刻の Unix タイムスタンプ(秒)。これは OpenAI が画像生成レスポンスにおいて REQUIRED(必須)と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は常に存在します。alt 系の id で fal、minimax、pika、wavespeed、runware が提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、これは完全に省略されます。現在のエポック値は 2^31 に十分近いため、書式指定のない `integer` は多くの SDK ジェネレータで 32 ビットフィールドを生成してしまいます。そのため `int64` として宣言されています。 フォーマット: `int64` diff --git a/ja/development/comfy-router/providers.mdx b/ja/development/comfy-router/providers.mdx index 9c12fdffbc..19edf90775 100644 --- a/ja/development/comfy-router/providers.mdx +++ b/ja/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の配信プロバイダー" sidebarTitle: "配信プロバイダー" description: "各 Comfy Router モデルを配信できるプロバイダーと、代替プロバイダーを選択する方法を確認できます。" -translationSourceHash: 26a39d7a +translationSourceHash: 770541e9 translationFrom: development/comfy-router/providers.mdx --- @@ -22,8 +22,10 @@ translationFrom: development/comfy-router/providers.mdx | [Gemini 2.5 Flash Image](/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [Gemini Nano Banana 2.1](/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | -| [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | -| [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | - | ✓ | +| [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | - | ✓ | +| [GPT Image 2.6 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [GPT Image 2.6 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [Kling 3.0 Turbo](/ja/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | - | | [Kling V3](/ja/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | - | ✓* | - | | [Nano Banana 2](/ja/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | diff --git a/ja/development/deploy/cloud-custom-builds.mdx b/ja/development/deploy/cloud-custom-builds.mdx new file mode 100644 index 0000000000..a4523249f5 --- /dev/null +++ b/ja/development/deploy/cloud-custom-builds.mdx @@ -0,0 +1,262 @@ +--- +title: "Comfy Cloud にカスタムビルドを追加する" +sidebarTitle: "カスタムビルド" +description: "Comfy Cloud 上で独自のカスタムノードを使ってワークフローを実行します。ビルドを作成し、エディタからデプロイを実行し、LoRA をアップロードし、デプロイを削除します。" +icon: "puzzle-piece" +translationSourceHash: 8794e3d7 +translationFrom: development/deploy/cloud-custom-builds.mdx +translationBlockHashes: + "_intro": 8bac2431 + "Create a Build from your Workflow": 5fc814b8 + "Add your own LoRA or model": dee7604c + "Stop or delete your deployment": c6996c1e + "Next steps": 8223b620 +--- +Build は、カスタムノード、プライベートカスタムノード、LoRA などのモデル、Python の依存関係をまとめてパッケージ化し、Comfy Cloud 上でワークフローを実行できるようにするものです。Build は Comfy Cloud エディタから開始し、Developer Platform で作成・デプロイしたうえで、エディタでその Build 上においてワークフローを実行します。 + +Build をデプロイすると、Comfy Cloud がそれらのノードをすべてすでにサポートしている場合でも、自分のワークフロー専用に提供される GPU ワーカーが得られます。 + + + Comfy Cloud がすでにサポートしているノードで自分の LoRA やその他のモデルを使う場合、Build は必要ありません。代わりにモデルを**モデルライブラリ**にアップロードしてください。詳しくは[自分の LoRA やモデルを追加する](#自分の-lora-やモデルを追加する)を参照してください。 + + +### 前提条件 + +Build を作成する前に、以下を用意してください。 + +- **Comfy Cloud 上に保存済みのワークフロー** +- **有効なサブスクリプション、または残高がゼロより多い Comfy クレジット** + + + Build の作成や保持には費用がかかりません。デプロイは、GPU が起動している間 GPU 時間の費用がかかります。また、デプロイが存在する限り、停止中や GPU が起動していない間もストレージの費用がかかります。デプロイダイアログには、確定する前に推定コストが表示されます。支払いを停止するには、デプロイを削除してください。詳しくは[デプロイを停止または削除する](#デプロイの停止または削除)を参照してください。 + + +## ワークフローからビルドを作成する + +ワークフローでComfy Cloudがサポートしていないカスタムノードを使用している場合、ワークフローを開くとComfy Cloudがダイアログを表示します。ダイアログには、不足しているカスタムノードパック(カスタムノードのグループ)と、LoRAなどのモデルが一覧表示されます。ワークフローを実行するには、それらを含むビルドを作成します。保存済みのワークフローを選択すると、Developer Platformがそのカスタムノードとモデルを検出して自動的に選択します。 + + + + ダイアログで**プラットフォームで作成**をクリックします。Developer Platformが新しいタブで開き、**デプロイ**ページが表示されます。 + + ![Comfy Cloudにないカスタムノードを使用するワークフローに対するComfy Cloudのダイアログ。ドキュメントを読むリンクの上に不足しているノードが一覧表示され、エージェントでビルドボタンとプラットフォームで作成ボタンがある](/images/development/deploy/run-on-custom-deployment.png) + + ![実行ボタンの横で開いた実行メニュー。Comfy Cloudがチェックされており、「このワークスペースにはまだデプロイがありません」というメッセージと、その下にカスタムデプロイを作成が表示されている](/images/development/deploy/run-on.png) + + + ダイアログを使わずにビルドを作成するには、**実行**の左にあるクラウドメニューをクリックします。デフォルトでは**Comfy Cloud**に設定されています。 + + - ワークスペースにまだデプロイがない場合は、**カスタムデプロイを作成**を選択し、**プラットフォームで作成**をクリックします。 + - すでにデプロイがある場合は、**デプロイを管理**を選択します。 + + + + **デプロイ**ページで、**新規ビルド**をクリックします。まだビルドがない場合は、代わりに**ゼロから開始**をクリックします。 + + + 1. **Comfy Cloudから選択**をクリックします。 + 2. ワークフローを選択し、**ワークフローを1件追加**をクリックします。 + + ワークフローの`.json`ファイル、またはそれを使って作成した`.png`画像をドロップエリアにドラッグすることもできます。 + + ![新規ビルドページの最初のステップ。ドロップエリア、Comfy Cloudから選択ボタン、チェックマーク付きで選択されたワークフロー名、推奨デフォルトのリスト、ビルドをカスタマイズとデフォルトでビルドボタンがある](/images/development/deploy/missing-nodes.png) + + ワークフロー名がドロップエリアの下にチェックマーク付きで表示され、**推奨デフォルト**リストにビルドの**カスタムノード**が表示されると、このステップは成功です。 + + + **デフォルトでビルド…**をクリックします。**ビルドターゲットを選択**ダイアログが開きます。 + + **デフォルトでビルド…**が使用できない場合は、ボタンの下の行にその理由が表示されます。「_不足しているモデルとカスタムノードを先にそれぞれのステップで追加してください。_」と表示された場合は、不足しているものを追加します。 + + 1. **ビルドをカスタマイズ**をクリックします。 + 2. 不足しているカスタムノードまたはモデルが一覧表示されるステップまで**次へ**をクリックします。 + 3. それぞれで**提案を使用**または**アップロード**をクリックします。 + + + +ビルドに含める内容を変更するには、代わりに**ビルドをカスタマイズ**をクリックして各ステップを進めます。ビルドの内容を決めるステップは2つあります。 + +- **ビルドに必要なカスタムノードはどれですか?**: カスタムノードを選択します。 +- **ビルドに同梱するモデルはどれですか?**: ビルドに含めるモデルを選択します。ビルドに含まれないモデルは、ジョブで初めて使用されるときにダウンロードされます。 + +### ビルドを公開する + +公開すると、ビルドが`v1`などの番号付きバージョンになり、今すぐにも後でにもデプロイできます。公開は無料です。 + +1. **ビルドターゲットを選択**ダイアログで、**サーバーレスビルド**を選択したままにします。これはComfy Cloudで実行されるターゲットです。 +2. **公開**をクリックします。 + +ビルドのページが新しいバージョンとともに開きます。**サーバーレスビルド**の行にビルドの進行状況が表示されます。ビルドには通常10~15分かかり、ページを離れて後で戻ってくることもできます。ビルドが完了すると、**サーバーレスビルド**の行に**デプロイ**ボタンが表示されます。 + +後でそのバージョンに戻るには: + +1. **Developer Platformのサイドバー**で、**デプロイ**をクリックします。 +2. **ビルド**セクションで、自分のビルドをクリックします。 +3. **バージョン**の下で、最新バージョンをクリックします。 + + + + 一部のカスタムノードはビルドに失敗することがあります。その場合、ビルドのページの**サーバーレスビルド**行に**ビルド失敗**と表示されます。 + + 1. その行の**ログ**を開いて、何が失敗したかを確認します。 + 2. **ビルドを編集**をクリックし、失敗したカスタムノードを削除するなどしてビルドを変更します。 + 3. ビルドを再度公開します。 + + 行の**エージェントでデバッグ**ボタンをクリックすると、失敗の内容を説明するプロンプトが開きます。それをコーディングエージェントにコピーしてビルドを修復できます。 + + + +### ワークフローをデプロイして実行する + +デプロイとは、Comfy Cloud の GPU 上でビルドが動作している状態のことです。ビルドをデプロイし、その後 Comfy Cloud エディタをそのデプロイに切り替えてワークフローを実行します。 + +1. **サーバーレスビルド**の行で**デプロイ**をクリックします。**_ビルド名_ の v1 をデプロイ**ダイアログが開きます。 +2. GPU を選択します。各 GPU には VRAM(GPU メモリ)と 1 時間あたりの料金が表示されます。 +3. ダイアログに**Cloud エディタの準備完了**と表示されている場合は、選択したままにします。これはデフォルトでオンになっています。 +4. その他の設定はデフォルトのままにします。**常時ウォームワーカー**を `0` にすると、ジョブが入ってこないときにデプロイの GPU はオフになります。デフォルトでは、**ジョブ後にワーカーを維持**により最後のジョブの後 3 分間 GPU がオンのままになり、そのアイドル時間は GPU の料金で課金されます。 +5. **推定コスト**パネルを確認します。1 時間あたりの GPU 時間と 1 か月あたりのモデルストレージが表示されます。 +6. **デプロイを作成**をクリックします。デプロイのページが開きます。デプロイ名の下のステータスが**準備完了**になるまで待ちます。 +7. Comfy Cloud エディタで、**実行**の左にあるクラウドメニューをクリックします。**実行先**で、自分のデプロイを選択します。エディタが再読み込みされ、タブは開いたまま残ります。 + + ![実行ボタンの横で開いた実行先メニュー。選択済みのデプロイの横にチェックマークが付いています](/images/development/deploy/selected-deployment.jpg) + +8. ワークフローを開き、**実行**をクリックします。最初のジョブは、デプロイが GPU を起動する間待機することがあります。 + +このブラウザは、別のデプロイを選択するまで、そのデプロイ上でワークフローを実行し続けます。元に戻すには、同じメニューで **Comfy Cloud** を選択します。ワークフローに未保存の変更がある場合は、**切り替える前にワークフローを保存しますか?**ダイアログが開きます。**保存して切り替え**または**保存せずに切り替え**をクリックします。 + +## 自分の LoRA やモデルを追加する + +**モデルライブラリ**には、ワークスペースがアップロードしたモデルが保存されます。アップロードしたモデルは Comfy Cloud とデプロイの両方で実行できます。 + +モデルをアップロードする前に、次の要件を満たしていることを確認してください。 + +- **有効な Pro、Creator、Team、または Enterprise プラン**: モデルをアップロードするには、ワークスペースにいずれかのプランが必要です。 +- **2 GB 以下の `.safetensors` ファイル**: SDXL や Flux のような大きなベースモデルはビルドに入れてください。 + + + ライブラリモデルが利用可能になる前に作成されたデプロイでは、それらを読み込めない場合があります。ライブラリモデルを使用するには、新しいデプロイを作成してください。古いデプロイでは、ジョブが `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` で失敗することがあります。 + + +### モデルをアップロードする + +Comfy Cloud エディタまたは開発者プラットフォームからアップロードできます。作業している場所のタブを選択してください。 + + + + 1. **実行**の左にあるクラウドメニューで、**実行先**に **Comfy Cloud** が選択されていることを確認します。デプロイ上では、**モデルライブラリ**に**インポート**ボタンはありません。 + 2. **左サイドバー**で**モデルライブラリ**をクリックし、**インポート**をクリックします。 + 3. **ファイルを選択**をクリックするか、`.safetensors` ファイルをダイアログにドラッグします。 + 4. **このモデルの種類は何ですか?**で、LoRA の場合は **LoRA** のままにし、ファイルに合う種類を選択します。 + 5. **アップロード**をクリックします。ダイアログに _モデルのインポートに成功しました。_ と表示されたら、**完了**をクリックします。 + + ![my\_style\_lora\_9e2417.safetensors(97.37 MB)を選択し、「このモデルの種類は何ですか?」を LoRA に設定したインポートダイアログ。戻るとアップロードのボタンがある](/images/development/serverless/library-models-editor-import.png) + + Civitai や Hugging Face のリンクからインポートする場合: + + 1. **インポート**ダイアログで、**ここにリンクを貼り付け**にモデルのリンクを貼り付けます。 + 2. **続行**をクリックします。 + 3. **このモデルの種類は何ですか?**で、モデルの種類を選択します。 + 4. **インポート**をクリックします。 + + `.ckpt` など他の形式でのリンクインポートは**モデルライブラリ**に取り込まれますが、デプロイでは実行できません。 + + + 1. ビルドの**どのモデルをビルドに含めますか?**ステップで、**モデルをアップロード**をクリックします。 + 2. **ワークスペースライブラリ**を選択します。 + 3. `.safetensors` ファイルをドロップ領域にドラッグするか、領域をクリックして参照します。 + 4. **モデルの種類**で、LoRA の場合は **LoRA** のままにし、ファイルに合う種類を選択します。 + 5. **アップロード**をクリックします。 + + ![ビルドの「どのモデルをビルドに含めますか?」ステップにあるモデルアップロードダイアログ。公開、非公開、ワークスペースライブラリのタブがあり、ワークスペースライブラリが選択され、ドロップ領域、モデルの種類が LoRA に設定され、ファイルがワークスペースライブラリにある旨の行、キャンセルとアップロードのボタンがある](/images/development/serverless/library-models-platform-upload.png) + + + +### ワークフローでモデルを使用する + +モデルをアップロードしたら、Comfy Cloud またはデプロイで使用できます。 + +1. **実行**の左にあるクラウドメニューで、実行する場所を選択します: **Comfy Cloud**、または自分のデプロイ。 +2. `Load LoRA (Model and CLIP)` ノードを追加するか、そのノードを含むワークフローを開きます。 +3. ノードの `lora_name` リストで、自分のファイルを選択します。 +4. **実行**をクリックします。 + +![Load Checkpoint と Load LoRA (Model and CLIP) ノードを含むワークフロー。lora\_name にアップロードした LoRA が選択され、キューパネルの先頭行に Downloading my\_style\_lora\_9e2417.safetensors 0 B of 97.37 MB と表示されている](/images/development/serverless/library-models-editor-downloading.png) + + + デプロイでは、最初の実行時にモデルをダウンロードし、キューのそのジョブの行に `Downloading ` と表示されます。同じ GPU が稼働している間の後続のジョブはダウンロードをスキップします。デプロイが後から起動する GPU はモデルを再びダウンロードします。ダウンロードを省略するには、モデルをビルドに追加してください。 + + +ジョブがモデルを見つけられるように、次のルールに従ってください。 + +- **一致する種類を選ぶ。** ローダーノードはその種類のモデルだけを一覧に表示します。`Load LoRA (Model and CLIP)` ノードには LoRA としてアップロードしたモデルが表示されます。 +- **新しいファイル名を使う。** ビルドに同じ名前のモデルが既にある場合、デプロイ上のジョブはアップロードしたファイルではなくビルドのファイルを使用します。 +- **ベースモデルを一致させる。** LoRA はワークフローが読み込むベースモデルと一致している必要があります。 +- **Comfy Cloud にあるローダーノードを使う。** ローダーノードが Comfy Cloud にないカスタムノードのものである場合は、モデルをビルドに追加してください。 + +### ライブラリモデルを変更または削除する + +**実行先**でデプロイが選択されている場合、**モデルライブラリ**にはビルドのモデルだけが一覧表示されます。アップロードしたモデルを変更または削除するには、まず [Comfy Cloud に切り替え](#ワークフローをデプロイして実行する) 、**左サイドバー**で**モデルライブラリ**をクリックします。 + +モデルの種類を変更する場合: + +1. モデルのカードにカーソルを合わせ、**モデル情報**をクリックします。 +2. 新しい**モデルの種類**を選択します。 + + + モデルを削除すると、**モデルライブラリ**から完全に削除されます。そのファイルをまだ使用しているジョブは、ローダーノードで `Value not in list` エラーで失敗します。 + + +モデルを削除する場合: + +1. モデルのカードにカーソルを合わせ、**その他**をクリックし、**削除**をクリックします。 +2. **このモデルを削除しますか?**で、**削除**をクリックします。 + +## デプロイの停止または削除 + +デプロイは、停止中であっても削除するまでストレージのコストがかかります。後で使用するためにデプロイを残しておきたい場合は、ジョブを実行せずに停止してください。課金を止めたい場合は削除してください。 + +デプロイのページを開くには: + +1. **Developer Platform サイドバー**で、**Deploy** をクリックします。 +2. **Deployments** セクションで、デプロイ名をクリックします。 + +![Deploy ページの Deployments セクション。各デプロイの名前が左端の列に、ステータスが Status 列に表示されています](/images/development/deploy/deployments.jpg) + +デプロイを停止するには: + +1. **Stop** をクリックします。 +2. **Stop deployment** ダイアログで、**Stop** をクリックします。 + +ステータスは **Stopping**、その後 **Stopped** と表示されます。 + +デプロイを再度実行するには: + +- **Start** をクリックします。 + + + 削除すると、デプロイとその履歴が完全に削除されます。Build とそのバージョンは残るため、後で再度デプロイできます。 + + +デプロイを削除するには: + +1. 停止中のデプロイでは、**Delete** をクリックします。実行中のデプロイでは、**More actions** メニューを開き、**Delete** を選択します。 +2. **Delete deployment** ダイアログで、**Delete** をクリックします。 + +次回このブラウザでエディタを開くと、エディタは Comfy Cloud 上でワークフローを実行します。 + +## 次のステップ + + + + ターミナルからモデルをアップロードし、リクエストごとに `lora_name` で指定します。 + + + オートスケーリングエンドポイントとして、独自のコードからデプロイを呼び出します。 + + + Comfy Cloud のクレジットと同時実行ジョブ数の制限の仕組みを確認します。 + + + APIリクエストで送信される形式でワークフローをエクスポートします。 + + diff --git a/ja/development/deploy/overview.mdx b/ja/development/deploy/overview.mdx index 9a111a6242..8daee25665 100644 --- a/ja/development/deploy/overview.mdx +++ b/ja/development/deploy/overview.mdx @@ -3,21 +3,23 @@ title: "ComfyUI のデプロイ" sidebarTitle: "概要" description: "Comfy Cloud、マネージド Comfy API デプロイ、セルフホストを比較して、ComfyUI の実行方法を選択します。" icon: "map" -translationSourceHash: be91af8f +translationSourceHash: c83524f1 translationFrom: development/deploy/overview.mdx translationBlockHashes: - "_intro": cc75b9f0 + "_intro": 44e94954 "Deploy from the ComfyUI app": 53163f19 - "Run a deployment from the Cloud editor": 9426b4cc - "Stop or delete a deployment": 9b9a173c + "Run a deployment from the Cloud editor": 1c75cbed "Run Workflows from your application": f95d4434 --- ComfyUI ワークフローは、Comfy Cloud、自身の Comfy API デプロイ、または自身で管理するサーバー上で実行できます。Comfy Cloud と Comfy API は Comfy GPU 上で動作するため、お使いのパソコンに GPU は不要です。ワークフローに合う選択肢を選び、そのカードから始めてください。 - + - Comfy Cloud にすでにあるカスタムノードとモデルのワークフローを、ビルドやデプロイなしで実行します。 + カスタムノードとモデルがすでに Comfy Cloud にあるワークフローを、ビルドやデプロイなしで実行します。 + + + 独自のカスタムノードとモデルを必要とするワークフローを、ブラウザで作成したビルドとともに Comfy Cloud エディタで実行します。 カスタムノード、モデル、Python 依存関係をビルドにパッケージ化し、自動スケーリングするエンドポイントとして実行します。 @@ -27,7 +29,7 @@ ComfyUI ワークフローは、Comfy Cloud、自身の Comfy API デプロイ -3 つのいずれかを自身のコードから呼び出すには、[API フォーマット](/ja/development/api-development/workflow-api-format)のワークフローを送信します。 +これらのいずれかを自身のコードから呼び出すには、[API フォーマット](/ja/development/api-development/workflow-api-format)のワークフローを送信します。 ## ComfyUI アプリからのデプロイ @@ -57,86 +59,7 @@ Developer Platform では、ワークフローからビルドを作成し、バ ## Cloud エディターからデプロイを実行する -デプロイは、そのビルドに含まれるカスタムノードとモデルを使い、Comfy Cloud 上の ComfyUI でワークフローを実行できます。 - -### Comfy Cloud からデプロイを作成する - -Comfy Cloud では、**Workflow actions** メニューに **Deploy to Comfy API** エントリはありません。代わりに **Run** の横のメニューから始めます。 - -1. **Run** の横のメニューをクリックします。 -2. **Create a custom deployment** を選択し、**Create on Platform** をクリックします。Developer Platform 上のビルドが新しいタブで開きます。 - -![Run ボタン横で開いた Run on メニュー。Comfy Cloud がチェックされ、This workspace has no deployments yet と Create a custom deployment が表示されている](/images/development/deploy/run-on.png) - -ワークスペースにすでにデプロイがある場合、メニューには代わりに **Manage deployments** が表示されます。同じ Developer Platform のビルドページが開きます。 - -Comfy Cloud にないカスタムノードを使うワークフローを開くと、**Run this workflow on a custom deployment** ダイアログが不足分を一覧表示します。**Create on Platform** をクリックしてビルドを開始します。 - -![Comfy Cloud にないカスタムノードを含むワークフロー用のダイアログ。Read the docs リンク、Build with your agent ボタン、Create on Platform ボタンの上に不足ノードを一覧表示](/images/development/deploy/run-on-custom-deployment.png) - -### Cloud エディターでデプロイを開く - -1. デプロイダイアログで **Ready for the Cloud editor** が表示されている場合は、選択したままにします。このオプションはデフォルトでオンです。**Ready for the Cloud editor** をオフにすると、あとからエディターでデプロイを開くのに約 1 分かかります。 -2. デプロイのページで、名前の下のステータスが **Ready** になるまで待ちます。それまで **Open in ComfyUI** は無効のままです。 -3. **Open in ComfyUI** をクリックします。Comfy Cloud 上の ComfyUI が新しいタブで開き、デプロイに切り替わります。 - -![デプロイ名の下に Ready ステータス、右上に Open in ComfyUI ボタンがあるデプロイページ](/images/development/deploy/deployment-detail.jpg) - -ワークフローの実行先を確認するには: - -1. **Run** の横のメニューをクリックします。 -2. ワークフローが実行されているデプロイの横のチェックマークを確認します。 -3. **Run** をクリックして、そのデプロイでワークフローを実行します。 - -![Run ボタン横で開いた Run on メニュー。選択中のデプロイの横にチェックマーク](/images/development/deploy/selected-deployment.jpg) - -- メニューにはワークスペース内のすべてのデプロイが一覧表示されます。**Ready** のデプロイを選択して切り替えます。 -- 切り替えるとエディターが再読み込みされます。デフォルトではタブは開いたままです。 -- このブラウザーは、別のデプロイを選択するまで、選択したデプロイでワークフローを実行し続けます。 - -### Comfy Cloud に戻す - -1. **Run** の横のメニューをクリックします。 -2. **Comfy Cloud** を選択します。 - -エディターが再読み込みされます。ワークフローに未保存の変更がある場合は、**Save your workflows before switching?** ダイアログが開きます。**Save and switch**、または **Switch without saving** をクリックします。 - -## デプロイの停止または削除 - -デプロイを停止するとジョブが止まり、削除するとデプロイが取り除かれストレージ課金が終了します。どちらの操作も Developer Platform 上のデプロイページにあります。 - - - 停止したデプロイはジョブを実行しませんが、ストレージは引き続き課金されます。ストレージ課金を終了するにはデプロイを削除してください。 - - -デプロイのページを開くには: - -1. Developer Platform のサイドバーで **Deploy** をクリックします。 -2. **Deployments** セクションでデプロイ名をクリックします。 - -![Deploy ページの Deployments セクション。左端の列に各デプロイ名、Status 列にステータス](/images/development/deploy/deployments.jpg) - -デプロイを停止するには: - -1. **Stop** をクリックします。 -2. **Stop deployment** ダイアログで **Stop** をクリックします。 - -ステータスは **Stopping** になり、その後 **Stopped** になります。 - -デプロイを再度実行するには: - -- **Start** をクリックします。 - - - 削除するとデプロイとその履歴が完全に取り除かれます。ビルドは残ります。 - - -デプロイを削除するには: - -1. 停止したデプロイでは **Delete** をクリックします。実行中のデプロイでは **More actions** メニューを開き、**Delete** を選択します。 -2. **Delete deployment** ダイアログで **Delete** をクリックします。 - -そのデプロイ上で Cloud エディターを実行していたブラウザーが次に ComfyUI を読み込むと、削除されたデプロイではなく Comfy Cloud 上で ComfyUI が実行されます。 +Comfy Cloud エディターからデプロイを作成し、その上でワークフローを実行し、停止または削除する方法については、[Comfy Cloud にカスタムビルドを追加する](/ja/development/deploy/cloud-custom-builds) を参照してください。 ## アプリケーションからワークフローを実行する diff --git a/ja/development/serverless/overview.mdx b/ja/development/serverless/overview.mdx index 9eac5551c9..d1eb2e550d 100644 --- a/ja/development/serverless/overview.mdx +++ b/ja/development/serverless/overview.mdx @@ -2,37 +2,39 @@ title: "Comfy API:サーバーレスデプロイ" description: "Comfy API で ComfyUI ワークフローをマネージド GPU エンドポイントとしてデプロイします。Build、リリース、リージョン、ワーカーのスケーリング、ワークスペース制限、デプロイの監視を解説。" icon: "cloud-arrow-up" -translationSourceHash: 4df17332 +translationSourceHash: fbee2a94 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 - "Platform concepts": cd4243ce + "Platform concepts": 7dd0b0f4 "The Build file": 70f351b1 "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f "Workspace limits": e0643567 "Monitor and call a deployment": ff860dab + "Use workspace library models in API requests": ab60f3f3 "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b - "FAQ": 08ef9084 + "FAQ": 4eff1368 "Next steps": 0045baa9 --- + Comfy API を使うと、アプリケーションからマネージドエンドポイント経由で ComfyUI ワークフローを実行できます。ワークフローに必要な ComfyUI のバージョン、モデル、カスタムノード、依存関係をパッケージ化すると、Comfy がマネージド GPU 上で実行します。環境を再現可能に保ち、アプリケーションから呼び出せるエンドポイントが必要な場合に使います。 -## プラットフォームの用語 +## プラットフォームの概念 -| 用語 | 意味 | +| 概念 | 意味 | | --- | --- | | **ワークスペース** | メンバー、Build、デプロイ、使用上限を管理するチームアカウントです。 | -| **Build** | ComfyUI のバージョン、モデル、カスタムノード、依存関係を含む環境定義です。 | +| **Build** | ComfyUI の環境定義です。バージョン、モデル、カスタムノード、依存関係を含みます。 | | **Build バージョン / リリース** | `linux/nvidia` などのデプロイターゲット向けに用意された、番号付きの Build バージョンです。 | | **デプロイ** | リリースを使用する実行中のエンドポイントです。独自の GPU、リージョン、ワーカー設定を持ちます。 | [Comfy Cloud](/ja/development/deploy/cloud) でサポートされるワークフローは、Build やデプロイを作成せずにそこで実行できます。 -新しい Build を作成せずにモデルをデプロイへ追加するには、ワークスペースライブラリにアップロードします。詳しくは [ワークスペースライブラリのモデル](/ja/development/serverless/library-models) を参照してください。 +新しい Build を作成せずにモデルをデプロイへ追加するには、ワークスペースライブラリにアップロードします。詳しくは [独自の LoRA やモデルを追加する](/ja/development/deploy/cloud-custom-builds#自分の-lora-やモデルを追加する) を参照してください。 エージェントから始めるか、環境やワークフローを用意する別の方法を選んでください。 @@ -91,6 +93,43 @@ comfy deploy refs compute --region [Comfy SDK](/ja/development/api-development/sdks) を使用してエンドポイントを呼び出すこともできます。`COMFY_BASE_URL` にデプロイの URL を設定し、APIキーを指定します。詳細は[ベース URL の選択](/ja/development/api-development/sdks#ベースurlの選択)を参照してください。 +## APIリクエストでワークスペースライブラリのモデルを使用する + +デプロイでは、リリースに含まれていない場合でも、ワークスペースライブラリの `.safetensors` モデルが実行されます。Comfy Cloud エディタまたは Developer Platform でモデルをアップロードするには、[独自の LoRA またはモデルの追加](/ja/development/deploy/cloud-custom-builds#自分の-lora-やモデルを追加する)を参照してください。 + +ターミナルからアップロードするには、`--type` でモデルタイプを設定し、ファイルがライブラリにあることを確認します。 + +```bash +comfy assets library upload my_style.safetensors --type loras +comfy assets library ls --tags models,loras +``` + +[API形式のワークフロー](/ja/development/api-development/workflow-api-format)では、ローダーの入力を、`.safetensors` を含むライブラリのファイル名に設定します。 + +```json +"10": { + "class_type": "LoraLoader", + "inputs": { + "lora_name": "my_style.safetensors", + "strength_model": 1.0, + "strength_clip": 1.0, + "model": ["4", 0], + "clip": ["4", 1] + } +} +``` + +ワークフローは `comfy deploy run`、[Comfy SDK](/ja/development/api-development/sdks)、または [Comfy API v2](/ja/api-reference/v2/overview) で送信します。 + +```bash +comfy deploy run --deployment --workflow workflow_api.json +``` + +別の LoRA を使用するには、次のリクエストで `lora_name` を別のライブラリのファイル名に変更します。新しいビルド、リリース、再デプロイは必要ありません。 + +- ワークフローは最大 100 個のライブラリモデルを指定できます。101 個目のライブラリモデルを指定したローダーは、ファイルがライブラリに存在しない場合と同様に失敗します。 +- 1 つのローダーが読み取るフォルダ間でファイル名を一意に保ってください。ライブラリ内の 2 つのフォルダに同じファイル名が存在する場合、API 経由で送信されたジョブはどちらのファイルも読み込みません。 + ## デプロイメントの運用 ```bash @@ -125,7 +164,7 @@ comfy deploy events --deployment dep_123456 - はい。Builder では、1 つ以上のワークフローをアップロードして、そのモデルとカスタムノードをあらかじめ選択できます。実行する予定のすべてのワークフローが必要とする依存関係を含めてから、各 API フォーマットのワークフローをデプロイ済みのエンドポイントに送信します。 + はい。Builder では、1 つ以上のワークフローをアップロードして、そのモデルとカスタムノードをあらかじめ選択できます。実行する予定のすべてのワークフローが必要とする依存関係を含めてから、API フォーマットの各ワークフローをデプロイ済みのエンドポイントに送信します。 各デプロイメントは 1 つの GPU タイプを使用します。異なる GPU タイプでワークフローを実行するには、同じ Build のデプロイメントを別々に作成します。 @@ -135,17 +174,17 @@ comfy deploy events --deployment dep_123456 ストレージの課金はデプロイメントから始まります: - - リリースをデプロイすると、そのモデルはデプロイメントのワーカーが共有するネットワークストレージに配置されます。このストレージはデプロイ後は読み取り専用となり、そのリージョンにその Build のデプロイメントが存在する限り、`comfy deploy stop` でデプロイメントが一時停止している間も含めて、GB 月単位で課金されます。ジョブが[ワークスペースライブラリ](/ja/development/serverless/library-models)から使用するモデルは、そこには配置されません。ワーカーがジョブのためにそれらをダウンロードします。 - - 各ワーカーには固定 50 GB のコンテナディスクも割り当てられます。これはエフェメラルであり、ワーカーのコンピュートコストの一部として、ワーカーの実行中のみ課金されます。 + - リリースをデプロイすると、そのモデルはデプロイメントのワーカーが共有するネットワークストレージに配置されます。このストレージはデプロイ後は読み取り専用となり、そのリージョンにその Build のデプロイメントが存在する限り、`comfy deploy stop` でデプロイメントが一時停止している間も含めて、GB 月単位で課金されます。ジョブが[ワークスペースライブラリ](/ja/development/deploy/cloud-custom-builds#自分の-lora-やモデルを追加する)から利用するモデルは、そこには配置されません。ワーカーがジョブのためにそれらをダウンロードします。 + - 各ワーカーには固定 50 GB のコンテナディスクも割り当てられます。これは一時的なもので、ワーカーのコンピュートコストの一部として、ワーカーの実行中のみ課金されます。 - デプロイメントを削除すると、そのコンピュートが解放されます。配置されたネットワークストレージは、そのリージョンでそれを使用している最後のデプロイメントが削除された後、まもなくクリーンアップされ、その課金も終了します。 現在のストレージ料金については、[Comfy 料金ページ](https://www.comfy.org/pricing)をご覧ください。コンピュートカタログ(`comfy deploy refs compute`)とデプロイダイアログにも、デプロイメントに適用される料金が表示されます。 - `--min` は**アクティブワーカー**の数を設定します。アクティブワーカーとは、常に実行し続けるワーカーであり、リクエストがコールドスタートを待つことはありません。アクティブワーカーは、ジョブを処理しているかどうかに関係なく、実行している間ずっと秒単位で課金されます。 + `--min` は**アクティブワーカー**の数を設定します。アクティブワーカーとは、リクエストがコールドスタートを待つことがないよう常時稼働するワーカーです。アクティブワーカーは、ジョブを処理しているかどうかに関係なく、実行している間ずっと秒単位で課金されます。 - `--min` を超えて `--max` までのワーカーは**フレックスワーカー**です。フレックスワーカーは、起動した瞬間(起動とモデルの読み込みを含む)からジョブの処理を経て、スケールダウンする前の短いアイドルウィンドウ(現在は 30 秒)まで、秒単位で課金されます。フレックスワーカーがスケールダウンされると、コストはかかりません。`--min 0` の場合、デプロイメント全体がゼロにスケールし、アイドル中はコンピュートの課金が発生しませんが、最初のリクエストでコールドスタートが発生します。 + `--min` を超えて `--max` までのワーカーは**フレックスワーカー**です。フレックスワーカーは、起動時(起動処理とモデルの読み込みを含む)から、ジョブの処理を経て、スケールダウンする前の短いアイドルウィンドウ(現在は 30 秒)まで、秒単位で課金されます。フレックスワーカーがスケールダウンすると、コストはかかりません。`--min 0` の場合、デプロイメント全体がゼロにスケールし、アイドル中はコンピュートの課金が発生しませんが、最初のリクエストでコールドスタートが発生します。 課金は、実際のワーカーの秒単位の使用量に、実行中のワーカー数を掛けて計測されます。ワークスペースのクレジットが不足すると、デプロイメントは自動的に停止されます。 @@ -157,7 +196,7 @@ comfy deploy events --deployment dep_123456 - デプロイメントの状態を確認し、次にそのログとイベントを調べて原因を特定します: + デプロイメントの状態を追跡し、次にそのログとイベントを調べて原因を特定してください: ```bash comfy deploy status --deployment --watch @@ -165,7 +204,7 @@ comfy deploy events --deployment dep_123456 comfy deploy events --deployment ``` - 選択した GPU またはリージョンにキャパシティがない場合は、後で再試行するか、`comfy deploy refs compute` を実行して利用可能なリージョンと GPU のペアを選択してください。サポートを依頼する際は、Build、リリース、デプロイメントの ID を添えてください。 + 選択済みの GPU またはリージョンにキャパシティがない場合は、後で再試行するか、`comfy deploy refs compute` を実行して利用可能なリージョンと GPU のペアを選択してください。サポートを依頼する際は、Build、リリース、デプロイメントの ID を添えてください。 diff --git a/ja/tutorials/partner-nodes/pika/pika-h3-flex.mdx b/ja/tutorials/partner-nodes/pika/pika-h3-flex.mdx index 39020489b7..ff446c0c81 100644 --- a/ja/tutorials/partner-nodes/pika/pika-h3-flex.mdx +++ b/ja/tutorials/partner-nodes/pika/pika-h3-flex.mdx @@ -2,7 +2,7 @@ title: "Pika H3 Flex:ComfyUI API でテキスト・画像・リファレンス動画" description: "ComfyUI のパートナーAPI を通じて Pika H3 Flex を実行します。テキスト、画像、先頭・末尾フレーム、リファレンスビデオを、生成済みオーディオ付きで 480p から 4K 出力までサポートします。" sidebarTitle: "Pika H3 Flex" -translationSourceHash: 6b0b02c9 +translationSourceHash: 748513cb translationFrom: tutorials/partner-nodes/pika/pika-h3-flex.mdx translationBlockHashes: "_intro": dc840a35 @@ -10,10 +10,11 @@ translationBlockHashes: "Pika H3 Flex: Text to Video (API) {#api_pika_h3_flex_t2v}": 7745a88d "Image to video and first-last-frame": 76d6d279 "Reference to video": 0ba880d9 - "Pika audio nodes": 642096c1 + "Pika audio nodes": f8d1f386 "Prompt format": 0a07de68 "Cost": 5adc088c --- + import ReqHint from "/snippets/ja/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/ja/tutorials/update-reminder.mdx"; @@ -68,7 +69,7 @@ Pika H3 Flexは、[MiniMax H3](/ja/tutorials/video/minimax/minimax-h3)をPikaが - **Pika SFX**: テキストの説明から、長さ1~20秒のサウンドエフェクトを生成します - **Pika Music**: テキストプロンプトと任意の歌詞から10~360秒の楽曲を生成するか、元の曲をその長さのままカバーします(5~360秒に制限されます) -テキストから生成するこの2つのオーディオノードのコントロール、プロンプトの書き方、制限については [Pika Music と Pika SFX](/ja/tutorials/partner-nodes/pika/pika-audio) を参照してください。 +テキストから音声を生成する2つのオーディオノードのコントロール、プロンプトパターン、制限については [Pika Music と Pika SFX](/ja/tutorials/partner-nodes/pika/pika-audio) を参照してください。 ## プロンプト形式 diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index 6c19aa0185..c3f33c8b1a 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 기능과 한계" sidebarTitle: "기능과 한계" description: "Comfy Router 또는 파트너 프록시 선택, 장시간 실행되는 호출 대비, 복구, 속도 제한 및 자산 저장에 대해 설명합니다." -translationSourceHash: 04575573 +translationSourceHash: cd27af52 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": 789d46e5 + "Models without a pre-flight estimate": d83b12e1 "Router does not cover every partner operation": 11621b39 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -32,6 +32,7 @@ translationBlockHashes: + Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나, 제출한 뒤 나중에 수집하는 대기 중 요청을 통해 실행합니다. 애플리케이션이 완료된 결과를 기다리거나 나중에 결과를 수집할 수 있고, 모델 자체의 입력 및 출력 필드를 처리할 수 있는 경우에 사용하십시오. ## Router가 지원하는 기능 @@ -130,7 +131,7 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` - **ltx**: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe`, `ltx/ltx-video-upscale` - **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` +- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-gpt-image-2.5-flare`, `minimax/minimax-gpt-image-2.5-sunburst`, `minimax/minimax-gpt-image-2.6-flare`, `minimax/minimax-gpt-image-2.6-sunburst`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index 09f1b60095..16f8643392 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 GPT Image 1.5 사용하기" description: "Comfy Router를 통해 openai/gpt-image-1.5를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "GPT Image 1.5" -translationSourceHash: a1545fc4 +translationSourceHash: 2c734ca2 translationFrom: development/comfy-router/models/openai/gpt-image-1-5/code.mdx translationBlockHashes: "_intro": 7a84676f "Quick start": f364e3f2 - "Schema": 8b660697 + "Schema": aaeae86d "Examples": c73859ec --- @@ -305,7 +305,7 @@ Router가 `GET /v2/models/openai/gpt-image-1.5/openapi.json`에서 제공하는 - 생성이 완료된 시각의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 필수로 선언한 유일한 멤버이므로, OpenAI가 생성자일 때는 항상 존재합니다. alt 기반 id에서 fal, pika, wavespeed 또는 runware가 제공하는 응답은 다른 네 개의 확정 파라미터 멤버와 마찬가지로 이 필드를 완전히 생략합니다. 현재 시점의 epoch 값이 2^31에 충분히 가까워, 포맷을 지정하지 않은 `integer`가 많은 SDK 생성기에서 32비트 필드를 만들기 때문에 `int64`로 선언되었습니다. + 생성이 완료된 시각의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 필수로 선언한 유일한 멤버이므로, OpenAI가 생성자일 때는 항상 존재합니다. alt 기반 id에서 fal, minimax, pika, wavespeed 또는 runware가 제공하는 응답은 다른 네 개의 확정 파라미터 멤버와 마찬가지로 이 필드를 완전히 생략합니다. 현재 시점의 epoch 값이 2^31에 충분히 가까워, 포맷을 지정하지 않은 `integer`가 많은 SDK 생성기에서 32비트 필드를 만들기 때문에 `int64`로 선언되었습니다. 형식: `int64` diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 6d18fe0769..0adf58cb58 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router에서 GPT Image 2.5 Flare 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2.5-flare를 호출합니다. 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "GPT Image 2.5 Flare" -translationSourceHash: e3a1017e +translationSourceHash: 060a72c2 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx translationBlockHashes: "_intro": 1e1ed044 "Quick start": c9749309 - "Serving providers": ef0e9384 - "Schema": a7048d34 + "Serving providers": 943a35c1 + "Schema": aa138d7e "Examples": c73859ec --- @@ -320,7 +320,7 @@ Router가 `GET /v2/models/openai/gpt-image-2.5-flare/openapi.json`에서 제공 - 생성이 완료된 시점의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언한 유일한 멤버이므로, OpenAI가 생성자인 경우에는 항상 존재합니다. alt 기반 id에서 fal, pika, wavespeed 또는 runware가 제공하는 응답은 나머지 네 개의 확정 파라미터 멤버와 마찬가지로 이 필드를 완전히 생략합니다. 현재 시점의 epoch 값은 2^31에 충분히 가까워서, 포맷을 지정하지 않은 `integer`는 많은 SDK 생성기에서 32비트 필드를 만들어 내기 때문에 `int64`로 선언되었습니다. + 생성이 완료된 시점의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언한 유일한 멤버이므로, OpenAI가 생성자인 경우에는 항상 존재합니다. alt 기반 id에서 fal, minimax, pika, wavespeed 또는 runware가 제공하는 응답은 나머지 네 개의 확정 파라미터 멤버와 마찬가지로 이 필드를 완전히 생략합니다. 현재 시점의 epoch 값은 2^31에 충분히 가까워서, 포맷을 지정하지 않은 `integer`는 많은 SDK 생성기에서 32비트 필드를 만들어 내기 때문에 `int64`로 선언되었습니다. 형식: `int64` diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index c3e8864b71..fbb0eaf471 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router로 GPT Image 2.5 Sunburst 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2.5-sunburst를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "GPT Image 2.5 Sunburst" -translationSourceHash: 89d64476 +translationSourceHash: c9aa90d3 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx translationBlockHashes: "_intro": 84874630 "Quick start": 8da85011 - "Serving providers": 58af0c87 - "Schema": 61c5bb52 + "Serving providers": 89992590 + "Schema": e341df7c "Examples": c73859ec --- @@ -319,7 +319,7 @@ URL은 자격 증명 없이 접근할 수 있어야 합니다. Router는 이를 - 생성이 완료된 시각의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언한 유일한 멤버이므로, OpenAI가 생성 주체일 때는 항상 존재합니다. alt-backed id 중 하나에서 fal, pika, wavespeed 또는 runware가 제공한 응답에서는 다른 네 개의 확정 파라미터 멤버와 마찬가지로 이 필드가 완전히 생략됩니다. `int64`로 선언된 이유는 현재의 epoch 값이 2^31에 충분히 가까워서, 포맷되지 않은 `integer`가 많은 SDK 생성기에서 32비트 필드를 만들어내기 때문입니다. + 생성이 완료된 시각의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언한 유일한 멤버이므로, OpenAI가 생성 주체일 때는 항상 존재합니다. alt-backed id 중 하나에서 fal, minimax, pika, wavespeed 또는 runware가 제공한 응답에서는 다른 네 개의 확정 파라미터 멤버와 마찬가지로 이 필드가 완전히 생략됩니다. `int64`로 선언된 이유는 현재의 epoch 값이 2^31에 충분히 가까워서, 포맷되지 않은 `integer`가 많은 SDK 생성기에서 32비트 필드를 만들어내기 때문입니다. 형식: `int64` diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index e0cce685b0..3da440c189 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -2,12 +2,13 @@ title: "Comfy Router에서 GPT Image 2.6 Flare 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2.6-flare를 호출합니다: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." sidebarTitle: "GPT Image 2.6 Flare" -translationSourceHash: 82634d88 +translationSourceHash: 726e4807 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx translationBlockHashes: "_intro": 1693e80a "Quick start": 8222d9f4 - "Schema": 85f18947 + "Serving providers": ce8a80c6 + "Schema": cdcbdd35 "Examples": c73859ec --- @@ -151,6 +152,15 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES +## 제공 공급자 + +이 모델은 요청에서 다른 공급자를 지정하지 않는 한 Comfy Router가 직접 제공합니다. 아래 공급자들도 동일한 엔드포인트와 동일한 모델 ID로 이 모델을 제공하며, `model_provider` 쿼리 파라미터로 선택됩니다. + +- **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare` +- **MiniMax**, `minimax/minimax-gpt-image-2-6-flare`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare?model_provider=minimax` + +`strict_mode`의 기본값은 거짓이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이렇게 라우팅되는 모든 모델에 대해서는 [제공 공급자](/ko/development/comfy-router/providers)를 참조하세요. + ## 스키마 ### 입력 @@ -316,7 +326,7 @@ Router가 `GET /v2/models/openai/gpt-image-2.6-flare/openapi.json`에서 제공 - 생성이 완료된 시점의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 필수로 선언하는 유일한 멤버이므로, OpenAI가 생성자일 때는 항상 존재합니다. alt 기반 id 중 하나에서 fal, pika, wavespeed 또는 runware가 제공하는 응답은 다른 네 개의 확정된 매개변수 멤버와 마찬가지로 이를 전혀 생략합니다. 현재의 epoch 값이 2^31에 충분히 가까워 서식 없는 `integer`가 많은 SDK 생성기에서 32비트 필드를 만들기 때문에 `int64`로 선언되었습니다. + 생성이 완료된 시점의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 필수로 선언하는 유일한 멤버이므로, OpenAI가 생성자일 때는 항상 존재합니다. alt 기반 id 중 하나에서 fal, minimax, pika, wavespeed 또는 runware가 제공하는 응답은 다른 네 개의 확정된 매개변수 멤버와 마찬가지로 이를 전혀 생략합니다. 현재의 epoch 값이 2^31에 충분히 가까워 서식 없는 `integer`가 많은 SDK 생성기에서 32비트 필드를 만들기 때문에 `int64`로 선언되었습니다. 형식: `int64` diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index ec1f2b159e..141bc051dc 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -2,12 +2,13 @@ title: "Comfy Router로 GPT Image 2.6 Sunburst 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2.6-sunburst를 호출하는 방법: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "GPT Image 2.6 Sunburst" -translationSourceHash: 4e6d4ec0 +translationSourceHash: b6d31807 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx translationBlockHashes: "_intro": 280b9c93 "Quick start": 2d3cb42c - "Schema": 5296621a + "Serving providers": d22ba32c + "Schema": d9027080 "Examples": c73859ec --- @@ -150,6 +151,15 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ +## 제공 공급자 + +이 모델은 요청에서 다른 공급자를 지정하지 않는 한 Comfy Router가 직접 제공합니다. 아래 공급자들도 동일한 엔드포인트와 동일한 모델 ID로 이 모델을 제공하며, `model_provider` 쿼리 파라미터로 선택됩니다. + +- **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst` +- **MiniMax**, `minimax/minimax-gpt-image-2-6-sunburst`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst?model_provider=minimax` + +`strict_mode`의 기본값은 거짓이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이렇게 라우팅되는 모든 모델에 대해서는 [제공 공급자](/ko/development/comfy-router/providers)를 참조하세요. + ## 스키마 ### 입력 @@ -315,7 +325,7 @@ URL은 자격 증명 없이 접근할 수 있어야 합니다. Router는 이를 - 생성이 완료된 시각을 나타내는 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언한 유일한 멤버이므로, OpenAI가 생성 주체일 때는 항상 존재합니다. alt 기반 id 중 fal-, pika-, wavespeed-, runware-가 처리한 응답에서는 다른 네 개의 확정된 파라미터 멤버와 마찬가지로 이 필드가 완전히 생략됩니다. 현재의 epoch 값이 2^31에 충분히 가까워서, 서식을 지정하지 않은 `integer`로 선언하면 많은 SDK 생성기에서 32비트 필드가 만들어지기 때문에 `int64`로 선언되었습니다. + 생성이 완료된 시각을 나타내는 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언한 유일한 멤버이므로, OpenAI가 생성 주체일 때는 항상 존재합니다. alt 기반 id 중 fal-, minimax-, pika-, wavespeed-, runware-가 처리한 응답에서는 다른 네 개의 확정된 파라미터 멤버와 마찬가지로 이 필드가 완전히 생략됩니다. 현재의 epoch 값이 2^31에 충분히 가까워서, 서식을 지정하지 않은 `integer`로 선언하면 많은 SDK 생성기에서 32비트 필드가 만들어지기 때문에 `int64`로 선언되었습니다. 형식: `int64` diff --git a/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx index bb98974458..c46242edca 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,13 +2,13 @@ title: "Comfy Router에서 GPT Image 2 사용하기" description: "Comfy Router를 통해 openai/gpt-image-2를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "GPT Image 2" -translationSourceHash: 2fe15764 +translationSourceHash: 40bf9f79 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 "Serving providers": f3930e40 - "Schema": 4e6e5e53 + "Schema": d733408e "Examples": c73859ec --- @@ -321,7 +321,7 @@ Router가 `GET /v2/models/openai/gpt-image-2/openapi.json`에서 제공하는 - 생성이 완료된 시점의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언하는 유일한 멤버이므로, OpenAI가 생성자인 경우에는 항상 존재합니다. alt 기반 id 중 하나에 대해 fal, pika, wavespeed 또는 runware가 제공하는 응답에서는 다른 네 개의 확정된 매개변수 멤버와 마찬가지로 이 필드가 완전히 생략됩니다. 현재 시점의 epoch 값이 2^31에 충분히 가까워서, 포맷을 지정하지 않은 `integer`는 많은 SDK 생성기에서 32비트 필드를 만들어 내기 때문에 `int64`로 선언되었습니다. + 생성이 완료된 시점의 Unix 타임스탬프(초)입니다. OpenAI가 이미지 생성 응답에서 REQUIRED로 선언하는 유일한 멤버이므로, OpenAI가 생성자인 경우에는 항상 존재합니다. alt 기반 id 중 하나에 대해 fal, minimax, pika, wavespeed 또는 runware가 제공하는 응답에서는 다른 네 개의 확정된 매개변수 멤버와 마찬가지로 이 필드가 완전히 생략됩니다. 현재 시점의 epoch 값이 2^31에 충분히 가까워서, 포맷을 지정하지 않은 `integer`는 많은 SDK 생성기에서 32비트 필드를 만들어 내기 때문에 `int64`로 선언되었습니다. 형식: `int64` diff --git a/ko/development/comfy-router/providers.mdx b/ko/development/comfy-router/providers.mdx index 18a539b529..98eea236aa 100644 --- a/ko/development/comfy-router/providers.mdx +++ b/ko/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 서빙 공급자" sidebarTitle: "서빙 공급자" description: "각 Comfy Router 모델을 서빙할 수 있는 공급자와 대체 공급자를 선택하는 방법을 확인합니다." -translationSourceHash: 26a39d7a +translationSourceHash: 770541e9 translationFrom: development/comfy-router/providers.mdx --- @@ -22,8 +22,10 @@ translationFrom: development/comfy-router/providers.mdx | [Gemini 2.5 Flash Image](/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [Gemini Nano Banana 2.1](/ko/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | -| [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | -| [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | - | ✓ | +| [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | - | ✓ | +| [GPT Image 2.6 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [GPT Image 2.6 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [Kling 3.0 Turbo](/ko/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | - | | [Kling V3](/ko/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | - | ✓* | - | | [Nano Banana 2](/ko/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | diff --git a/ko/development/deploy/cloud-custom-builds.mdx b/ko/development/deploy/cloud-custom-builds.mdx new file mode 100644 index 0000000000..dc98bd92b6 --- /dev/null +++ b/ko/development/deploy/cloud-custom-builds.mdx @@ -0,0 +1,266 @@ +--- +title: "Comfy Cloud에 커스텀 빌드 추가하기" +sidebarTitle: "커스텀 빌드" +description: "Comfy Cloud에서 자체 커스텀 노드로 워크플로 실행하기: 빌드를 생성하고, 에디터에서 배포를 실행하고, LoRA를 업로드하고, 배포를 삭제합니다." +icon: "puzzle-piece" +translationSourceHash: 8794e3d7 +translationFrom: development/deploy/cloud-custom-builds.mdx +translationBlockHashes: + "_intro": 8bac2431 + "Create a Build from your Workflow": 5fc814b8 + "Add your own LoRA or model": dee7604c + "Stop or delete your deployment": c6996c1e + "Next steps": 8223b620 +--- +A Build packages your Custom Nodes → 빌드는 커스텀 노드, 비공개 커스텀 노드, LoRA 및 기타 모델과 Python 의존성을 패키징하여 워크플로를 Comfy Cloud에서 실행할 수 있게 합니다. 빌드는 Comfy Cloud 편집기에서 시작하고, Developer Platform에서 생성 및 배포한 다음, 편집기에서 해당 빌드 위에서 워크플로를 실행합니다. + +Output: + +빌드는 커스텀 노드, 비공개 커스텀 노드, LoRA 및 기타 모델, Python 의존성을 패키징하여 워크플로를 Comfy Cloud에서 실행할 수 있게 해줍니다. 빌드는 Comfy Cloud 편집기에서 시작하고, Developer Platform에서 생성 및 배포한 다음, 편집기에서 해당 빌드 위에서 워크플로를 실행합니다. + +빌드를 배포하면 해당 워크플로만을 처리하는 GPU 워커도 제공됩니다. Comfy Cloud가 이미 워크플로의 모든 노드를 지원하는 경우에도 마찬가지입니다. + + + Comfy Cloud가 이미 지원하는 노드와 함께 자체 LoRA나 다른 모델을 사용하려면 빌드가 필요하지 않습니다. 대신 모델을 **모델 라이브러리**에 업로드하세요. [자체 LoRA 또는 모델 추가](#나만의-lora-또는-모델-추가)를 참조하세요. + + +### 사전 요구 사항 + +빌드를 생성하기 전에 다음 사항을 준비하세요. + +- **Comfy Cloud에 저장된 워크플로** +- **활성 구독 또는 0보다 큰 Comfy 크레딧 잔액** + + + 빌드는 생성하거나 유지하는 데 비용이 들지 않습니다. 배포는 GPU가 켜져 있는 동안 GPU 시간에 대한 비용이 발생합니다. 또한 배포가 존재하는 한, 중지 상태이거나 GPU가 켜져 있지 않은 동안에도 스토리지 비용이 발생합니다. 배포 대화상자에서는 확인하기 전에 예상 비용을 보여줍니다. 비용 지불을 중지하려면 배포를 삭제하세요. [배포 중지 또는 삭제](#배포-중지-또는-삭제)를 참조하세요. + + +## 워크플로에서 빌드 만들기 + +워크플로에서 Comfy Cloud가 지원하지 않는 커스텀 노드를 사용하는 경우, 해당 워크플로를 열면 Comfy Cloud에 대화상자가 표시됩니다. 대화상자에는 누락된 커스텀 노드 팩(커스텀 노드 그룹)과 LoRA 같은 모델이 나열됩니다. 워크플로를 실행하려면 이러한 항목으로 빌드를 만드세요. 저장한 워크플로를 선택하면 개발자 플랫폼이 해당 워크플로의 커스텀 노드와 모델을 찾아 자동으로 선택합니다. + + + + 대화상자에서 **플랫폼에서 생성**을 클릭합니다. 새 탭에서 개발자 플랫폼의 **배포** 페이지가 열립니다. + + ![Comfy Cloud에 없는 커스텀 노드가 있는 워크플로에 대해 표시되는 Comfy Cloud 대화상자. 누락된 노드가 문서 읽기 링크 위에 나열되어 있고, 에이전트로 빌드 버튼과 플랫폼에서 생성 버튼이 있습니다](/images/development/deploy/run-on-custom-deployment.png) + + ![실행 버튼 옆에 열린 실행 위치 메뉴. Comfy Cloud가 선택되어 있고, '이 워크스페이스에는 아직 배포가 없습니다'라는 메시지와 그 아래에 커스텀 배포 생성이 표시됩니다](/images/development/deploy/run-on.png) + + + 대화상자 없이 빌드를 만들려면 **실행** 왼쪽의 클라우드 메뉴를 클릭합니다. 기본적으로 **Comfy Cloud**로 설정되어 있습니다. + + - 워크스페이스에 아직 배포가 없으면 **커스텀 배포 생성**을 선택한 다음 **플랫폼에서 생성**을 클릭합니다. + - 이미 배포가 있으면 **배포 관리**를 선택합니다. + + + + **배포** 페이지에서 **새 빌드**를 클릭합니다. 아직 빌드가 없으면 대신 **처음부터 시작**을 클릭합니다. + + + 1. **Comfy Cloud에서 선택**을 클릭합니다. + 2. 워크플로를 선택한 다음 **워크플로 1개 추가**를 클릭합니다. + + 워크플로의 `.json` 파일이나 해당 워크플로로 만든 `.png` 이미지를 드롭 영역으로 끌어다 놓을 수도 있습니다. + + ![개발자 플랫폼의 새 빌드 페이지 첫 단계. 드롭 영역, Comfy Cloud에서 선택 버튼, 체크 표시가 있는 선택된 워크플로 이름, 제안된 기본값 목록, 빌드 사용자 지정 및 기본값으로 빌드 버튼이 표시됩니다](/images/development/deploy/missing-nodes.png) + + 워크플로 이름이 체크 표시와 함께 드롭 영역 아래에 나타나고 **제안된 기본값** 목록에 빌드의 **커스텀 노드**가 표시되면 해당 단계가 성공한 것입니다. + + + **기본값으로 빌드…**를 클릭합니다. **빌드 대상 선택** 대화상자가 열립니다. + + **기본값으로 빌드…**를 사용할 수 없으면 버튼 아래에 그 이유가 표시됩니다. _먼저 해당 단계에서 누락된 모델과 커스텀 노드를 추가하세요._라고 표시되면 누락된 항목을 추가합니다: + + 1. **빌드 사용자 지정**을 클릭합니다. + 2. 누락된 커스텀 노드나 모델이 나열된 단계가 나올 때까지 **다음**을 클릭합니다. + 3. 각 항목에서 **제안 사용** 또는 **업로드**를 클릭합니다. + + + +빌드에 포함할 항목을 변경하려면 대신 **빌드 사용자 지정**을 클릭하고 각 단계를 진행하세요. 다음 두 단계에서 빌드에 포함할 항목을 결정합니다: + +- **빌드에 필요한 커스텀 노드는 무엇인가요?**: 커스텀 노드를 선택합니다. +- **빌드에 포함할 모델은 무엇인가요?**: 빌드에 포함할 모델을 선택합니다. 빌드에 포함되지 않은 모델은 작업에서 처음 사용될 때 다운로드됩니다. + +### 빌드 게시 + +게시하면 빌드가 `v1`과 같이 번호가 매겨진 버전으로 바뀌며, 지금 또는 나중에 배포할 수 있습니다. 게시는 무료입니다. + +1. **빌드 대상 선택** 대화상자에서 **서버리스 빌드**가 선택된 상태로 둡니다. 이 대상은 Comfy Cloud에서 실행됩니다. +2. **게시**를 클릭합니다. + +빌드 페이지가 새 버전과 함께 열립니다. **서버리스 빌드** 행에 빌드 진행 상황이 표시됩니다. 빌드는 보통 10~15분 걸리며, 페이지를 나갔다가 다시 돌아와도 됩니다. 빌드가 완료되면 **서버리스 빌드** 행에 **배포** 버튼이 표시됩니다. + +나중에 해당 버전으로 돌아가려면: + +1. **개발자 플랫폼 사이드바**에서 **배포**를 클릭합니다. +2. **빌드** 섹션에서 해당 빌드를 클릭합니다. +3. **버전** 아래에서 최신 버전을 클릭합니다. + + + + 일부 커스텀 노드는 빌드에 실패할 수 있습니다. 이런 경우 빌드 페이지의 **서버리스 빌드** 행에 **빌드 실패**가 표시됩니다. + + 1. 해당 행에서 **로그**를 열어 무엇이 실패했는지 확인합니다. + 2. **빌드 편집**을 클릭하고 실패한 커스텀 노드를 제거하는 등 빌드를 변경합니다. + 3. 빌드를 다시 게시합니다. + + 행의 **에이전트로 디버그** 버튼을 클릭하면 실패 내용을 설명하는 프롬프트가 열립니다. 이 프롬프트를 복사해 코딩 에이전트에 전달하여 빌드를 복구하세요. + + + +### 워크플로 배포 및 실행 + +배포는 Comfy Cloud GPU에서 실행되는 빌드입니다. 빌드를 배포한 다음 Comfy Cloud 편집기를 해당 배포로 전환하여 워크플로를 실행합니다. + +1. **Serverless build** 행에서 **Deploy**를 클릭합니다. **Deploy v1 of** _빌드 이름_ 대화상자가 열립니다. +2. GPU를 선택합니다. 각 GPU에는 VRAM(GPU 메모리)과 시간당 가격이 표시됩니다. +3. 대화상자에 **Ready for the Cloud editor**가 표시되면 선택된 상태로 둡니다. 기본적으로 켜져 있습니다. +4. 나머지 설정은 기본값으로 둡니다. **Always-warm workers**가 `0`이면 작업이 들어오지 않을 때 배포가 GPU를 꺼둡니다. 기본적으로 **Keep worker up after a job**은 마지막 작업 이후 3분 동안 GPU를 켜 두며, 이 유휴 시간은 GPU 요금으로 청구됩니다. +5. **Estimated cost** 패널을 확인합니다. 시간당 GPU 시간과 월별 모델 저장 공간이 표시됩니다. +6. **Create deployment**를 클릭합니다. 배포 페이지가 열립니다. 배포 이름 아래의 상태가 **Ready**로 표시될 때까지 기다립니다. +7. Comfy Cloud 편집기에서 **Run** 왼쪽의 클라우드 메뉴를 클릭합니다. **Run on** 아래에서 사용할 배포를 선택합니다. 편집기가 다시 로드되며, 탭은 그대로 유지됩니다. + + ![Run 버튼 옆에 열린 Run on 메뉴와 선택된 배포 옆의 체크 표시](/images/development/deploy/selected-deployment.jpg) + +8. 워크플로를 열고 **Run**을 클릭합니다. 배포가 GPU를 시작하는 동안 첫 작업은 대기할 수 있습니다. + +이 브라우저는 다른 배포를 선택할 때까지 해당 배포에서 워크플로를 계속 실행합니다. 다시 전환하려면 같은 메뉴에서 **Comfy Cloud**를 선택합니다. 워크플로에 저장되지 않은 변경 사항이 있으면 **Save your workflows before switching?** 대화상자가 열립니다. **Save and switch** 또는 **Switch without saving**을 클릭합니다. + +## 나만의 LoRA 또는 모델 추가 + +**모델 라이브러리**에는 워크스페이스에서 업로드한 모델이 보관됩니다. 업로드한 모델은 Comfy Cloud와 배포에서 실행됩니다. + +모델을 업로드하기 전에 다음 요구 사항을 충족하는지 확인하세요: + +- **활성 Pro, Creator, Team 또는 엔터프라이즈 플랜**: 모델을 업로드하려면 워크스페이스에 해당 플랜이 필요합니다. +- **2 GB 이하의 `.safetensors` 파일**: SDXL 또는 Flux와 같은 더 큰 베이스 모델은 빌드에 넣으세요. + + + 라이브러리 모델이 제공되기 전에 생성된 일부 배포에서는 해당 모델을 로드할 수 없습니다. 라이브러리 모델을 사용하려면 새 배포를 생성하세요. 이전 배포에서는 작업이 다음 오류와 함께 실패할 수 있습니다: `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` + + +### 모델 업로드 + +Comfy Cloud 편집기 또는 개발자 플랫폼에서 업로드할 수 있습니다. 작업 중인 위치에 해당하는 탭을 선택하세요. + + + + 1. **실행** 왼쪽의 클라우드 메뉴에서 **실행 위치** 아래에 **Comfy Cloud**가 선택되어 있는지 확인하세요. 배포에서는 **모델 라이브러리**에 **가져오기** 버튼이 없습니다. + 2. **왼쪽 사이드바**에서 **모델 라이브러리**를 클릭한 다음 **가져오기**를 클릭하세요. + 3. **파일 선택**을 클릭하거나 `.safetensors` 파일을 대화상자로 끌어다 놓으세요. + 4. **이 모델의 유형은 무엇인가요?** 아래에서 LoRA라면 **LoRA**를 유지하고, 그렇지 않으면 파일에 맞는 유형을 선택하세요. + 5. **업로드**를 클릭하세요. 대화상자에 _모델을 성공적으로 가져왔습니다._라고 표시되면 **완료**를 클릭하세요. + + ![my\_style\_lora\_9e2417.safetensors (97.37 MB)가 선택되어 있고 모델 유형이 LoRA로 설정된, 뒤로 및 업로드 버튼이 있는 모델 가져오기 대화상자](/images/development/serverless/library-models-editor-import.png) + + 대신 Civitai 또는 Hugging Face 링크에서 모델을 가져오려면: + + 1. **가져오기** 대화상자에서 **여기에 링크를 붙여넣으세요**에 모델 링크를 붙여넣으세요. + 2. **계속**을 클릭하세요. + 3. **이 모델의 유형은 무엇인가요?** 아래에서 모델 유형을 선택하세요. + 4. **가져오기**를 클릭하세요. + + `.ckpt`와 같은 다른 형식의 링크 가져오기는 **모델 라이브러리**로 가져오지만 배포에서는 실행할 수 없습니다. + + + 1. 빌드의 **빌드에 어떤 모델이 포함되나요?** 단계에서 **모델 업로드**를 클릭하세요. + 2. **워크스페이스 라이브러리**를 선택하세요. + 3. `.safetensors` 파일을 드롭 영역으로 끌어다 놓거나, 영역을 클릭하여 찾아보세요. + 4. **모델 유형** 아래에서 LoRA라면 **LoRA**를 유지하고, 그렇지 않으면 파일에 맞는 유형을 선택하세요. + 5. **업로드**를 클릭하세요. + + ![빌드의 '빌드에 어떤 모델이 포함되나요?' 단계에 있는 모델 업로드 대화상자. 공개, 비공개, 워크스페이스 라이브러리 탭이 있고 워크스페이스 라이브러리가 선택되어 있으며, 드롭 영역, 모델 유형이 LoRA로 설정됨, 파일이 워크스페이스 라이브러리에 있다는 문구, 취소 및 업로드 버튼이 표시됩니다.](/images/development/serverless/library-models-platform-upload.png) + + + +### 워크플로에서 모델 사용 + +모델을 업로드한 후에는 Comfy Cloud 또는 배포에서 사용할 수 있습니다. + +1. **실행** 왼쪽의 클라우드 메뉴에서 실행할 위치를 선택하세요: **Comfy Cloud** 또는 배포. +2. `Load LoRA (Model and CLIP)` 노드를 추가하거나, 해당 노드가 있는 워크플로를 여세요. +3. 노드의 `lora_name` 목록에서 파일을 선택하세요. +4. **실행**을 클릭하세요. + +![Load Checkpoint 및 Load LoRA (Model and CLIP) 노드가 있는 워크플로. lora\_name에 업로드한 LoRA가 선택되어 있고, 큐 패널의 맨 위 행에 다운로드 중 my\_style\_lora\_9e2417.safetensors 0 B of 97.37 MB가 표시됩니다.](/images/development/serverless/library-models-editor-downloading.png) + + + 배포에서는 첫 실행 시 모델을 다운로드하며, 큐에 있는 작업의 행에 `Downloading `이 표시됩니다. 동일한 실행 중인 GPU에서 이후 작업은 다운로드를 건너뜁니다. 배포가 나중에 시작하는 GPU는 모델을 다시 다운로드합니다. 다운로드를 건너뛰려면 모델을 빌드에 추가하세요. + + +작업이 모델을 찾을 수 있도록 다음 규칙을 따르세요: + +- **일치하는 유형을 선택하세요.** 로더 노드는 해당 유형의 모델만 나열합니다. `Load LoRA (Model and CLIP)` 노드는 LoRA로 업로드된 모델을 나열합니다. +- **새 파일 이름을 사용하세요.** 빌드에 같은 이름의 모델이 이미 있으면 배포의 작업은 업로드한 파일이 아니라 빌드의 파일을 사용합니다. +- **베이스 모델을 일치시키세요.** LoRA는 워크플로가 로드하는 베이스 모델과 일치해야 합니다. +- **Comfy Cloud에 있는 로더 노드를 사용하세요.** 로더 노드가 Comfy Cloud에 없는 커스텀 노드에서 제공되는 경우 모델을 빌드에 추가하세요. + +### 라이브러리 모델 변경 또는 삭제 + +**실행 위치**에서 배포가 선택되어 있으면 **모델 라이브러리**에는 빌드의 모델만 나열됩니다. 업로드한 모델을 변경하거나 삭제하려면 먼저 [Comfy Cloud로 다시 전환](#워크플로-배포-및-실행)한 다음, **왼쪽 사이드바**에서 **모델 라이브러리**를 클릭하세요. + +모델 유형을 변경하려면: + +1. 모델 카드 위로 마우스를 올린 다음 **모델 정보**를 클릭하세요. +2. 새 **모델 유형**을 선택하세요. + + + 모델을 삭제하면 **모델 라이브러리**에서 영구적으로 제거됩니다. 해당 파일을 계속 사용하는 작업은 로더 노드에서 `Value not in list` 오류와 함께 실패합니다. + + +모델을 삭제하려면: + +1. 모델 카드 위로 마우스를 올리고 **더 보기**를 클릭한 다음 **삭제**를 클릭하세요. +2. **이 모델을 삭제하시겠습니까?**에서 **삭제**를 클릭하세요. + +## 배포 중지 또는 삭제 + +배포는 중지된 상태에서도 삭제할 때까지 스토리지 비용이 발생합니다. 작업을 실행하지 않고 나중에 사용할 수 있도록 배포를 유지하려면 중지하세요. 비용 지불을 중단하려면 삭제하세요. + +배포 페이지를 열려면: + +1. **Developer Platform 사이드바**에서 **배포**를 클릭합니다. +2. **배포** 섹션에서 배포 이름을 클릭합니다. + +![배포 페이지의 배포 섹션. 각 배포의 이름은 가장 왼쪽 열에, 상태는 상태 열에 표시됩니다](/images/development/deploy/deployments.jpg) + +배포를 중지하려면: + +1. **중지**를 클릭합니다. +2. **배포 중지** 대화상자에서 **중지**를 클릭합니다. + +상태가 **중지 중**으로 표시된 다음 **중지됨**으로 표시됩니다. + +배포를 다시 실행하려면: + +- **시작**을 클릭합니다. + + + 삭제하면 배포와 해당 기록이 영구적으로 제거됩니다. 빌드와 해당 버전은 유지되므로 나중에 다시 배포할 수 있습니다. + + +배포를 삭제하려면: + +1. 중지된 배포에서 **삭제**를 클릭합니다. 실행 중인 배포에서는 **추가 작업** 메뉴를 연 다음 **삭제**를 선택합니다. +2. **배포 삭제** 대화상자에서 **삭제**를 클릭합니다. + +이 브라우저에서 다음에 편집기를 열면, 편집기는 Comfy Cloud에서 워크플로를 실행합니다. + +## 다음 단계 + + + + 터미널에서 모델을 업로드하고 요청마다 `lora_name`으로 선택하세요. + + + 자체 코드에서 배포를 오토스케일링 엔드포인트로 호출하세요. + + + Comfy Cloud 크레딧과 동시 작업 한도가 어떻게 작동하는지 확인하세요. + + + API 요청이 전송하는 형식으로 워크플로를 내보내세요. + + diff --git a/ko/development/deploy/overview.mdx b/ko/development/deploy/overview.mdx index 7d72ce17ea..12631eaad4 100644 --- a/ko/development/deploy/overview.mdx +++ b/ko/development/deploy/overview.mdx @@ -3,31 +3,33 @@ title: "ComfyUI 배포하기" sidebarTitle: "개요" description: "Comfy Cloud, 관리형 Comfy API 배포, 자체 호스팅을 비교하여 ComfyUI 실행 방식을 선택하세요." icon: "map" -translationSourceHash: be91af8f +translationSourceHash: c83524f1 translationFrom: development/deploy/overview.mdx translationBlockHashes: - "_intro": cc75b9f0 + "_intro": 44e94954 "Deploy from the ComfyUI app": 53163f19 - "Run a deployment from the Cloud editor": 9426b4cc - "Stop or delete a deployment": 9b9a173c + "Run a deployment from the Cloud editor": 1c75cbed "Run Workflows from your application": f95d4434 --- -ComfyUI 워크플로는 Comfy Cloud, 자신의 Comfy API 배포, 또는 직접 관리하는 서버에서 실행할 수 있습니다. Comfy Cloud와 Comfy API는 Comfy GPU에서 실행되므로 컴퓨터에 GPU가 필요하지 않습니다. 워크플로에 맞는 옵션을 고르고 해당 카드부터 시작하세요. +ComfyUI 워크플로는 Comfy Cloud, 직접 구축한 Comfy API 배포, 또는 직접 관리하는 서버에서 실행할 수 있습니다. Comfy Cloud와 Comfy API는 Comfy GPU에서 실행되므로 컴퓨터에 GPU가 필요하지 않습니다. 워크플로에 맞는 옵션을 선택하고 해당 카드에서 시작하세요. - + - Comfy Cloud에 이미 있는 커스텀 노드와 모델의 워크플로를 빌드나 배포 없이 실행합니다. + 커스텀 노드와 모델이 이미 Comfy Cloud에 있는 워크플로를 빌드나 배포 없이 실행합니다. + + + 브라우저에서 생성한 빌드와 함께, 자체 커스텀 노드와 모델이 필요한 워크플로를 Comfy Cloud 편집기에서 실행합니다. - 커스텀 노드, 모델, Python 종속성을 빌드로 패키징하고 오토스케일링 엔드포인트로 실행합니다. + 커스텀 노드, 모델, Python 의존성을 빌드로 패키징하고 오토스케일링 엔드포인트로 실행합니다. 직접 관리하는 머신에서 ComfyUI를 실행하고 `--listen`으로 네트워크에 제공합니다. -세 가지 중 하나를 자신의 코드에서 호출하려면 [API 형식](/ko/development/api-development/workflow-api-format) 워크플로를 전송하세요. +이 중 하나를 자신의 코드에서 호출하려면 [API 형식](/ko/development/api-development/workflow-api-format)으로 워크플로를 전송하세요. ## ComfyUI 앱에서 배포하기 @@ -57,86 +59,7 @@ Developer Platform에서는 워크플로에서 빌드를 만들고, 버전을 ## Cloud 편집기에서 배포 실행하기 -배포는 빌드에 포함된 커스텀 노드와 모델을 사용해 Comfy Cloud의 ComfyUI에서 워크플로를 실행할 수 있습니다. - -### Comfy Cloud에서 배포 만들기 - -Comfy Cloud에서는 **Workflow actions** 메뉴에 **Deploy to Comfy API** 항목이 없습니다. 대신 **Run** 옆 메뉴에서 시작하세요. - -1. **Run** 옆 메뉴를 클릭합니다. -2. **Create a custom deployment**를 선택한 다음 **Create on Platform**을 클릭합니다. Developer Platform의 빌드가 새 탭에서 열립니다. - -![Run 버튼 옆에서 연 Run on 메뉴. Comfy Cloud가 선택되어 있고 This workspace has no deployments yet와 Create a custom deployment가 표시됨](/images/development/deploy/run-on.png) - -워크스페이스에 이미 배포가 있으면 메뉴에 **Manage deployments**가 대신 표시됩니다. 같은 Developer Platform 빌드 페이지가 열립니다. - -Comfy Cloud에 없는 커스텀 노드를 쓰는 워크플로를 열면 **Run this workflow on a custom deployment** 대화 상자가 빠진 항목을 나열합니다. **Create on Platform**을 클릭해 빌드를 시작하세요. - -![Comfy Cloud에 없는 커스텀 노드가 있는 워크플로용 Comfy Cloud 대화 상자. Read the docs 링크, Build with your agent 버튼, Create on Platform 버튼 위에 빠진 노드 목록](/images/development/deploy/run-on-custom-deployment.png) - -### Cloud 편집기에서 배포 열기 - -1. 배포 대화 상자에서 **Ready for the Cloud editor**가 보이면 선택된 상태로 둡니다. 이 옵션은 기본적으로 켜져 있습니다. **Ready for the Cloud editor**를 해제하면 나중에 편집기에서 배포를 여는 데 약 1분이 걸립니다. -2. 배포 페이지에서 이름 아래 상태가 **Ready**가 될 때까지 기다립니다. 그전까지 **Open in ComfyUI**는 비활성화된 채로 있습니다. -3. **Open in ComfyUI**를 클릭합니다. Comfy Cloud의 ComfyUI가 새 탭에서 열리고 배포로 다시 로드됩니다. - -![배포 이름 아래에 Ready 상태, 오른쪽 위에 Open in ComfyUI 버튼이 있는 배포 페이지](/images/development/deploy/deployment-detail.jpg) - -워크플로가 어디서 실행되는지 확인하려면: - -1. **Run** 옆 메뉴를 클릭합니다. -2. 워크플로가 실행 중인 배포 옆의 체크 표시를 찾습니다. -3. **Run**을 클릭해 해당 배포에서 워크플로를 실행합니다. - -![Run 버튼 옆에서 연 Run on 메뉴. 선택한 배포 옆에 체크 표시](/images/development/deploy/selected-deployment.jpg) - -- 메뉴에는 워크스페이스의 모든 배포가 나열됩니다. **Ready** 배포를 선택해 전환하세요. -- 전환하면 편집기가 다시 로드됩니다. 기본적으로 탭은 열린 채로 유지됩니다. -- 이 브라우저는 다른 배포를 선택할 때까지 선택한 배포에서 워크플로를 계속 실행합니다. - -### Comfy Cloud로 다시 전환하기 - -1. **Run** 옆 메뉴를 클릭합니다. -2. **Comfy Cloud**를 선택합니다. - -편집기가 다시 로드됩니다. 워크플로에 저장하지 않은 변경 사항이 있으면 **Save your workflows before switching?** 대화 상자가 열립니다. **Save and switch** 또는 **Switch without saving**을 클릭하세요. - -## 배포 중지 또는 삭제 - -배포를 중지하면 작업이 멈추고, 삭제하면 배포가 제거되며 스토리지 요금이 종료됩니다. 두 작업 모두 Developer Platform의 배포 페이지에 있습니다. - - - 중지된 배포는 작업을 실행하지 않지만 스토리지는 계속 청구됩니다. 스토리지 요금을 끝내려면 배포를 삭제하세요. - - -배포 페이지를 열려면: - -1. Developer Platform 사이드바에서 **Deploy**를 클릭합니다. -2. **Deployments** 섹션에서 배포 이름을 클릭합니다. - -![Deploy 페이지의 Deployments 섹션. 가장 왼쪽 열에 각 배포 이름, Status 열에 상태](/images/development/deploy/deployments.jpg) - -배포를 중지하려면: - -1. **Stop**을 클릭합니다. -2. **Stop deployment** 대화 상자에서 **Stop**을 클릭합니다. - -상태가 **Stopping**으로 표시된 다음 **Stopped**가 됩니다. - -배포를 다시 실행하려면: - -- **Start**를 클릭합니다. - - - 삭제하면 배포와 그 기록이 영구적으로 제거됩니다. 빌드는 남습니다. - - -배포를 삭제하려면: - -1. 중지된 배포에서는 **Delete**를 클릭합니다. 실행 중인 배포에서는 **More actions** 메뉴를 연 다음 **Delete**를 선택합니다. -2. **Delete deployment** 대화 상자에서 **Delete**를 클릭합니다. - -해당 배포에서 Cloud 편집기를 실행했던 브라우저가 다음에 ComfyUI를 로드하면, 삭제된 배포가 아니라 Comfy Cloud에서 ComfyUI가 실행됩니다. +Comfy Cloud 편집기에서 배포를 생성하고, 그 위에서 워크플로를 실행하고, 중지하거나 삭제하려면 [Comfy Cloud에 커스텀 빌드 추가하기](/ko/development/deploy/cloud-custom-builds)를 참고하세요. ## 애플리케이션에서 워크플로 실행하기 diff --git a/ko/development/serverless/overview.mdx b/ko/development/serverless/overview.mdx index 8c786d8dfc..ecdbdff0c4 100644 --- a/ko/development/serverless/overview.mdx +++ b/ko/development/serverless/overview.mdx @@ -2,23 +2,25 @@ title: "Comfy API: 서버리스 배포" description: "Comfy API로 ComfyUI 워크플로우를 관리형 GPU 엔드포인트로 배포합니다. Build, 릴리스, 리전, 워커 스케일링, 워크스페이스 한도, 배포 모니터링을 다룹니다." icon: "cloud-arrow-up" -translationSourceHash: 4df17332 +translationSourceHash: fbee2a94 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 - "Platform concepts": cd4243ce + "Platform concepts": 7dd0b0f4 "The Build file": 70f351b1 "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f "Workspace limits": e0643567 "Monitor and call a deployment": ff860dab + "Use workspace library models in API requests": ab60f3f3 "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b - "FAQ": 08ef9084 + "FAQ": 4eff1368 "Next steps": 0045baa9 --- + Comfy API를 사용하면 앱에서 관리형 엔드포인트를 통해 ComfyUI 워크플로를 실행할 수 있습니다. 워크플로에 필요한 ComfyUI 버전, 모델, 커스텀 노드, 종속성을 패키징하면 Comfy가 관리형 GPU에서 실행합니다. 반복 가능한 환경과 앱에서 호출할 엔드포인트가 필요할 때 사용하세요. ## 플랫폼 개념 @@ -27,12 +29,12 @@ Comfy API를 사용하면 앱에서 관리형 엔드포인트를 통해 ComfyUI | --- | --- | | **워크스페이스** | 멤버, Build, 배포, 사용량 한도를 관리하는 팀 계정입니다. | | **Build** | ComfyUI 환경 정의: 버전, 모델, 커스텀 노드, 의존성입니다. | -| **Build 버전 / 릴리스** | `linux/nvidia`와 같은 배포 대상을 위해 준비된, 번호가 매겨진 Build 버전입니다. | -| **배포** | 릴리스를 사용하는 실행 중인 엔드포인트로, 자체 GPU, 리전, 워커 설정이 있습니다. | +| **Build 버전 / 릴리스** | `linux/nvidia`와 같은 배포 대상에 맞춰 준비된, 번호가 매겨진 Build 버전입니다. | +| **배포** | 릴리스를 사용하는 실행 중인 엔드포인트입니다. 자체 GPU, 리전, 워커 설정을 가집니다. | -[Comfy Cloud](/ko/development/deploy/cloud)에서 지원하는 워크플로는 Build나 배포를 만들지 않고도 실행할 수 있습니다. +[Comfy Cloud](/ko/development/deploy/cloud)에서 지원하는 워크플로는 Build나 배포를 만들지 않고도 그곳에서 실행할 수 있습니다. -새로운 Build 없이 배포에 모델을 추가하려면 워크스페이스 라이브러리에 업로드하세요. [워크스페이스 라이브러리 모델](/ko/development/serverless/library-models)을 참조하세요. +새로운 Build 없이 배포에 모델을 추가하려면 워크스페이스 라이브러리에 업로드하세요. [자체 LoRA 또는 모델 추가](/ko/development/deploy/cloud-custom-builds#나만의-lora-또는-모델-추가)를 참조하세요. 에이전트로 시작하거나 환경 또는 워크플로를 제공하는 다른 방법을 선택하세요. @@ -91,6 +93,43 @@ comfy deploy refs compute --region [Comfy SDK](/ko/development/api-development/sdks)로 엔드포인트를 호출할 수도 있습니다. `COMFY_BASE_URL`을 배포 URL로 설정하고 API 키를 제공하세요. [기본 URL 선택](/ko/development/api-development/sdks#기본-url-선택)을 참조하세요. +## API 요청에서 워크스페이스 라이브러리 모델 사용하기 + +배포는 릴리스에 포함되지 않은 경우에도 워크스페이스 라이브러리의 `.safetensors` 모델을 실행합니다. Comfy Cloud 에디터 또는 Developer Platform에서 모델을 업로드하려면 [나만의 LoRA 또는 모델 추가하기](/ko/development/deploy/cloud-custom-builds#나만의-lora-또는-모델-추가)를 참고하세요. + +터미널에서 업로드하려면 `--type`으로 모델 유형을 지정한 다음 파일이 라이브러리에 있는지 확인하세요. + +```bash +comfy assets library upload my_style.safetensors --type loras +comfy assets library ls --tags models,loras +``` + +[API 형식 워크플로](/ko/development/api-development/workflow-api-format)에서 로더 입력을 라이브러리 파일 이름으로 설정하고 `.safetensors`를 포함하세요. + +```json +"10": { + "class_type": "LoraLoader", + "inputs": { + "lora_name": "my_style.safetensors", + "strength_model": 1.0, + "strength_clip": 1.0, + "model": ["4", 0], + "clip": ["4", 1] + } +} +``` + +`comfy deploy run`, [Comfy SDK](/ko/development/api-development/sdks) 또는 [Comfy API v2](/ko/api-reference/v2/overview)로 워크플로를 전송하세요. + +```bash +comfy deploy run --deployment --workflow workflow_api.json +``` + +다른 LoRA를 사용하려면 다음 요청에서 `lora_name`을 다른 라이브러리 파일 이름으로 변경하세요. 새 빌드, 릴리스 또는 재배포가 필요하지 않습니다. + +- 워크플로는 최대 100개의 라이브러리 모델을 지정할 수 있습니다. 101번째 라이브러리 모델을 지정하는 로더는 해당 파일이 라이브러리에 없는 것처럼 실패합니다. +- 하나의 로더가 읽는 폴더들에서 파일 이름을 고유하게 유지하세요. 라이브러리에 같은 파일 이름이 두 폴더에 있으면 API를 통해 전송된 작업은 어느 파일도 로드하지 않습니다. + ## 배포 운영 ```bash @@ -135,7 +174,7 @@ comfy deploy events --deployment dep_123456 저장 비용 청구는 배포와 함께 시작됩니다: - - 릴리스를 배포하면 해당 모델이 배포의 워커가 공유하는 네트워크 스토리지에 스테이징됩니다. 이 스토리지는 배포 후 읽기 전용이며, 해당 리전에 빌드의 배포가 하나라도 존재하는 동안에는 GB-월 단위로 청구됩니다. `comfy deploy stop`으로 배포를 일시 중지한 상태도 포함됩니다. 작업이 [워크스페이스 라이브러리](/ko/development/serverless/library-models)에서 사용하는 모델은 이곳에 스테이징되지 않습니다. 워커가 해당 작업을 위해 모델을 다운로드합니다. + - 릴리스를 배포하면 해당 모델이 배포의 워커가 공유하는 네트워크 스토리지에 스테이징됩니다. 이 스토리지는 배포 후 읽기 전용이며, 해당 리전에 빌드의 배포가 하나라도 존재하는 동안에는 GB-월 단위로 청구됩니다. `comfy deploy stop`으로 배포를 일시 중지한 상태도 포함됩니다. 작업이 [워크스페이스 라이브러리](/ko/development/deploy/cloud-custom-builds#나만의-lora-또는-모델-추가)에서 사용하는 모델은 이곳에 스테이징되지 않습니다. 워커가 해당 작업을 위해 모델을 다운로드합니다. - 각 워커는 고정된 50 GB 컨테이너 디스크도 함께 받습니다. 이 디스크는 임시이며 워커가 실행 중일 때만 워커의 컴퓨팅 비용의 일부로 청구됩니다. - 배포를 삭제하면 해당 컴퓨팅이 해제됩니다. 스테이징된 네트워크 스토리지는 해당 리전에서 이를 사용하는 마지막 배포가 삭제된 직후 정리되고, 그에 대한 청구도 종료됩니다. diff --git a/ko/tutorials/partner-nodes/pika/pika-h3-flex.mdx b/ko/tutorials/partner-nodes/pika/pika-h3-flex.mdx index 79a1330c92..9280c40d94 100644 --- a/ko/tutorials/partner-nodes/pika/pika-h3-flex.mdx +++ b/ko/tutorials/partner-nodes/pika/pika-h3-flex.mdx @@ -2,7 +2,7 @@ title: "Pika H3 Flex API: ComfyUI 텍스트, 이미지 및 참조 비디오" description: "ComfyUI에서 파트너 API를 통해 Pika H3 Flex를 실행하세요. 텍스트, 이미지, 첫-마지막 프레임, 참조 비디오를 지원하며 480p부터 4K 출력까지 생성된 오디오를 제공합니다." sidebarTitle: "Pika H3 Flex" -translationSourceHash: 6b0b02c9 +translationSourceHash: 748513cb translationFrom: tutorials/partner-nodes/pika/pika-h3-flex.mdx translationBlockHashes: "_intro": dc840a35 @@ -10,10 +10,11 @@ translationBlockHashes: "Pika H3 Flex: Text to Video (API) {#api_pika_h3_flex_t2v}": 7745a88d "Image to video and first-last-frame": 76d6d279 "Reference to video": 0ba880d9 - "Pika audio nodes": 642096c1 + "Pika audio nodes": f8d1f386 "Prompt format": 0a07de68 "Cost": 5adc088c --- + import ReqHint from "/snippets/ko/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx"; @@ -62,13 +63,13 @@ Pika H3 Flex는 [MiniMax H3](/ko/tutorials/video/minimax/minimax-h3)를 Pika가 ## Pika 오디오 노드 -세 가지 오디오 노드는 동일한 Pika API에서 실행되며, 생성된 오디오에 대해 초당 과금됩니다: +세 가지 오디오 노드는 동일한 Pika API에서 실행되며, 생성된 오디오의 초 단위로 과금됩니다: -- **Pika Soundtrack**: 최대 10분 길이의 비디오 오디오를 동기화된 사운드트랙으로 대체합니다. 지시문은 사운드 효과, 앰비언스 또는 음악을 설명하며, 오디오를 화면에서 도출하려면 비워 두세요 +- **Pika Soundtrack**: 최대 10분 길이의 비디오 오디오를 동기화된 사운드트랙으로 대체합니다. 지시문은 사운드 효과, 앰비언스 또는 음악을 설명하며, 영상에서 오디오를 도출하려면 비워 두세요 - **Pika SFX**: 텍스트 설명을 바탕으로 1~20초 길이의 사운드 효과를 생성합니다 -- **Pika Music**: 텍스트 프롬프트와 선택적 가사로 10~360초 길이의 노래를 생성하거나, 원곡 길이 그대로 커버하며 5~360초로 제한됩니다 +- **Pika Music**: 텍스트 프롬프트와 선택적 가사로 10~360초 길이의 노래를 생성하거나, 원곡을 원래 길이 그대로 커버하며 5~360초로 제한됩니다 -텍스트로 구동되는 이 두 오디오 노드의 컨트롤과 프롬프트 작성법, 제한은 [Pika Music 및 Pika SFX](/ko/tutorials/partner-nodes/pika/pika-audio)를 참고하세요. +텍스트로 구동되는 이 두 오디오 노드의 컨트롤과 프롬프트 패턴, 제한은 [Pika Music 및 Pika SFX](/ko/tutorials/partner-nodes/pika/pika-audio)를 참고하세요. ## 프롬프트 형식 diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index 90f6c55ae3..877fb60bb9 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 的能力与限制" sidebarTitle: "能力与限制" description: "选择 Comfy Router 还是合作伙伴代理,为长时间运行的调用做好规划,并了解恢复、速率限制与资产存储。" -translationSourceHash: 04575573 +translationSourceHash: cd27af52 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": 789d46e5 + "Models without a pre-flight estimate": d83b12e1 "Router does not cover every partner operation": 11621b39 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -33,6 +33,7 @@ translationBlockHashes: + Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个已排队的请求运行:你提交请求,稍后再收集结果。当你的应用能够等待一个已完成的结果,或稍后收集结果,并且能够处理模型自身的输入和输出字段时,就使用它。 ## Router 支持的功能 @@ -131,7 +132,7 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` - **ltx**: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe`, `ltx/ltx-video-upscale` - **luma**: `luma/photon-1`, `luma/photon-flash-1` -- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` +- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-gpt-image-2.5-flare`, `minimax/minimax-gpt-image-2.5-sunburst`, `minimax/minimax-gpt-image-2.6-flare`, `minimax/minimax-gpt-image-2.6-sunburst`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` diff --git a/zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index 561bd8a5d7..afa90188b0 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -2,12 +2,12 @@ title: "将 GPT Image 1.5 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 openai/gpt-image-1.5:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "GPT Image 1.5" -translationSourceHash: a1545fc4 +translationSourceHash: 2c734ca2 translationFrom: development/comfy-router/models/openai/gpt-image-1-5/code.mdx translationBlockHashes: "_intro": 7a84676f "Quick start": f364e3f2 - "Schema": 8b660697 + "Schema": aaeae86d "Examples": c73859ec --- @@ -309,7 +309,7 @@ URL 必须无需你的凭证即可解析。Router 会在服务器端抓取它, - 生成完成时的 Unix 时间戳,单位为秒。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要由 OpenAI 生成,该字段就会出现;对于任何 alt-backed id,由 fal、pika、wavespeed 或 runware 提供的响应则会完全省略它,就像其他四个已解析参数成员一样。声明为 `int64`,是因为当前纪元的数值已足够接近 2^31,未指定格式的 `integer` 会在许多 SDK 生成器中生成 32 位字段。 + 生成完成时的 Unix 时间戳,单位为秒。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要由 OpenAI 生成,该字段就会出现;对于任何 alt-backed id,由 fal、minimax、pika、wavespeed 或 runware 提供的响应则会完全省略它,就像其他四个已解析参数成员一样。声明为 `int64`,是因为当前纪元的数值已足够接近 2^31,未指定格式的 `integer` 会在许多 SDK 生成器中生成 32 位字段。 格式:`int64` diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 1c94664975..26423da63a 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -2,13 +2,13 @@ title: "将 GPT Image 2.5 Flare 与 Comfy Router 搭配使用" description: "通过 Comfy Router 调用 openai/gpt-image-2.5-flare:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "GPT Image 2.5 Flare" -translationSourceHash: e3a1017e +translationSourceHash: 060a72c2 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx translationBlockHashes: "_intro": 1e1ed044 "Quick start": c9749309 - "Serving providers": ef0e9384 - "Schema": a7048d34 + "Serving providers": 943a35c1 + "Schema": aa138d7e "Examples": c73859ec --- @@ -319,7 +319,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES - 本次生成完成时的 Unix 时间戳(单位为秒)。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要由 OpenAI 生成,该字段就一定会出现;而在任何由备用服务支撑的 ID 上,由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与其他四个已解析参数成员一样。声明为 `int64`,是因为当下的 epoch 数值与 2^31 足够接近,未指定格式的 `integer` 会让许多 SDK 生成器产生 32 位字段。 + 本次生成完成时的 Unix 时间戳(单位为秒)。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要由 OpenAI 生成,该字段就一定会出现;而在任何由备用服务支撑的 ID 上,由 fal、minimax、pika、wavespeed 或 runware 提供的响应会完全省略它,与其他四个已解析参数成员一样。声明为 `int64`,是因为当下的 epoch 数值与 2^31 足够接近,未指定格式的 `integer` 会让许多 SDK 生成器产生 32 位字段。 格式:`int64` diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index e7b608429a..3fdb1cc07f 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -2,13 +2,13 @@ title: "通过 Comfy Router 使用 GPT Image 2.5 Sunburst" description: "通过 Comfy Router 调用 openai/gpt-image-2.5-sunburst:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "GPT Image 2.5 Sunburst" -translationSourceHash: 89d64476 +translationSourceHash: c9aa90d3 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx translationBlockHashes: "_intro": 84874630 "Quick start": 8da85011 - "Serving providers": 58af0c87 - "Schema": 61c5bb52 + "Serving providers": 89992590 + "Schema": e341df7c "Examples": c73859ec --- @@ -322,7 +322,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ - 生成为已完成状态时的 Unix 时间戳(秒)。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要生产者是 OpenAI,它就会出现;而在任何基于备用提供方的 id 上,由 fal、pika、wavespeed 或 runware 提供的响应都会完全省略它,与其他四个已解析参数成员一样。声明为 `int64` 是因为当前纪元的数值已足够接近 2^31,未格式化时 `integer` 会让许多 SDK 生成器生成 32 位字段。 + 生成为已完成状态时的 Unix 时间戳(秒)。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要生产者是 OpenAI,它就会出现;而在任何基于备用提供方的 id 上,由 fal、minimax、pika、wavespeed 或 runware 提供的响应都会完全省略它,与其他四个已解析参数成员一样。声明为 `int64` 是因为当前纪元的数值已足够接近 2^31,未格式化时 `integer` 会让许多 SDK 生成器生成 32 位字段。 格式:`int64` diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 2776657318..1157976d5c 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -2,12 +2,13 @@ title: "将 GPT Image 2.6 Flare 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 openai/gpt-image-2.6-flare:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "GPT Image 2.6 Flare" -translationSourceHash: 82634d88 +translationSourceHash: 726e4807 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx translationBlockHashes: "_intro": 1693e80a "Quick start": 8222d9f4 - "Schema": 85f18947 + "Serving providers": ce8a80c6 + "Schema": cdcbdd35 "Examples": c73859ec --- @@ -150,6 +151,15 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES +## 服务提供商 + +除非请求中指定了其他提供商,否则此模型由 Comfy Router 直接提供服务。以下提供商也在同一端点上、使用相同的模型 ID 提供该模型,并通过 `model_provider` 查询参数进行选择。 + +- **Comfy**(默认): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare` +- **MiniMax**,以 `minimax/minimax-gpt-image-2-6-flare` 的形式: `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare?model_provider=minimax` + +`strict_mode` 默认为 false,因此 Router 会将本页记录的原生请求体转换为提供商自己的 schema,并把响应转换回来。请参阅 API 参考中的 [`model_provider`、`strict_mode` 和 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel),以及[服务提供商](/zh/development/comfy-router/providers),了解所有以这种方式路由的模型。 + ## Schema ### 输入 @@ -318,7 +328,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES - 生成完成时的 Unix 时间戳,单位为秒。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要生产者是 OpenAI 它就会出现;在任何 alt 后端的 id 上,由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与另外四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 值已经足够接近 2^31,若使用未格式化的 `integer`,许多 SDK 生成器会生成 32 位字段。 + 生成完成时的 Unix 时间戳,单位为秒。它是 OpenAI 在图像生成响应中声明为 REQUIRED 的唯一成员,因此只要生产者是 OpenAI 它就会出现;在任何 alt 后端的 id 上,由 fal、minimax、pika、wavespeed 或 runware 提供的响应会完全省略它,与另外四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 值已经足够接近 2^31,若使用未格式化的 `integer`,许多 SDK 生成器会生成 32 位字段。 格式:`int64` diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index c3fa465399..4e336a28fb 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -2,12 +2,13 @@ title: "使用 Comfy Router 调用 GPT Image 2.6 Sunburst" description: "通过 Comfy Router 调用 openai/gpt-image-2.6-sunburst:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "GPT Image 2.6 Sunburst" -translationSourceHash: 4e6d4ec0 +translationSourceHash: b6d31807 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx translationBlockHashes: "_intro": 280b9c93 "Quick start": 2d3cb42c - "Schema": 5296621a + "Serving providers": d22ba32c + "Schema": d9027080 "Examples": c73859ec --- @@ -150,6 +151,15 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ +## 服务提供商 + +除非请求中指定了其他提供商,否则此模型由 Comfy Router 直接提供服务。以下提供商也在同一端点上、使用相同的模型 ID 提供该模型,并通过 `model_provider` 查询参数进行选择。 + +- **Comfy**(默认): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst` +- **MiniMax**,以 `minimax/minimax-gpt-image-2-6-sunburst` 的形式: `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst?model_provider=minimax` + +`strict_mode` 默认为 false,因此 Router 会将本页记录的原生请求体转换为提供商自己的 schema,并把响应转换回来。请参阅 API 参考中的 [`model_provider`、`strict_mode` 和 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel),以及[服务提供商](/zh/development/comfy-router/providers),了解所有以这种方式路由的模型。 + ## Schema ### 输入 @@ -315,7 +325,7 @@ URL 必须在不携带你的凭证的情况下解析成功。Router 在服务器 - 生成完成时的 Unix 时间戳(单位为秒)。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要生产者是 OpenAI,该字段就会出现;而在任一 alt 后端 id 上由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,与其他四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 数值已非常接近 2^31,未格式化的 `integer` 在许多 SDK 生成器中会生成 32 位字段。 + 生成完成时的 Unix 时间戳(单位为秒)。它是 OpenAI 在图像生成响应中声明为必填的唯一成员,因此只要生产者是 OpenAI,该字段就会出现;而在任一 alt 后端 id 上由 fal、minimax、pika、wavespeed 或 runware 提供的响应会完全省略它,与其他四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 数值已非常接近 2^31,未格式化的 `integer` 在许多 SDK 生成器中会生成 32 位字段。 格式:`int64` diff --git a/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx index e8027b0224..55cb30bcf4 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,13 +2,13 @@ title: "将 GPT Image 2 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 openai/gpt-image-2:端点、请求结构,以及 Router 返回的响应。" sidebarTitle: "GPT Image 2" -translationSourceHash: 2fe15764 +translationSourceHash: 40bf9f79 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 "Serving providers": f3930e40 - "Schema": 4e6e5e53 + "Schema": d733408e "Examples": c73859ec --- @@ -323,7 +323,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2/requests/$REQUEST_ID \ - Unix 时间戳,单位为秒,表示生成完成的时间。它是 OpenAI 在图像生成响应中声明的唯一 REQUIRED 成员,因此只要由 OpenAI 作为生产者,它就一定存在;而在任何 alt 后端的 id 上由 fal、pika、wavespeed 或 runware 提供的响应会完全省略它,就像其他四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 值已接近 2^31,在许多 SDK 生成器中,未格式化的 `integer` 会生成 32 位字段。 + Unix 时间戳,单位为秒,表示生成完成的时间。它是 OpenAI 在图像生成响应中声明的唯一 REQUIRED 成员,因此只要由 OpenAI 作为生产者,它就一定存在;而在任何 alt 后端的 id 上由 fal、minimax、pika、wavespeed 或 runware 提供的响应会完全省略它,就像其他四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 值已接近 2^31,在许多 SDK 生成器中,未格式化的 `integer` 会生成 32 位字段。 Format: `int64` diff --git a/zh/development/comfy-router/providers.mdx b/zh/development/comfy-router/providers.mdx index a5705d8ca0..898f4a21e4 100644 --- a/zh/development/comfy-router/providers.mdx +++ b/zh/development/comfy-router/providers.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 服务提供商" sidebarTitle: "服务提供商" description: "查看每个 Comfy Router 模型可由哪些提供商提供服务,以及如何选择备用提供商。" -translationSourceHash: 26a39d7a +translationSourceHash: 770541e9 translationFrom: development/comfy-router/providers.mdx --- @@ -10,7 +10,7 @@ translationFrom: development/comfy-router/providers.mdx
-每个模型都使用 `POST /v2/models/{provider}/{model}`。Comfy 是默认提供商。对于有其他提供商可用的模型,`model_provider` 可以在不更改模型 ID 或请求体的情况下选择另一个提供商。请参阅 API 参考中的 [`model_provider`、`strict_mode` 与 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel)。 +每个模型都使用 `POST /v2/models/{provider}/{model}`。Comfy 是默认提供商。对于有其他提供商可供服务的模型,`model_provider` 可以在不更改模型 ID 或请求体的情况下选择另一个提供商。请参阅 API 参考中的 [`model_provider`、`strict_mode` 与 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel)。 ## 提供商覆盖范围 @@ -22,8 +22,10 @@ translationFrom: development/comfy-router/providers.mdx | [Gemini 2.5 Flash Image](/zh/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [Gemini Nano Banana 2.1](/zh/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | -| [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | -| [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | - | ✓ | - | ✓ | +| [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | - | ✓ | +| [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | - | ✓ | +| [GPT Image 2.6 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [GPT Image 2.6 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | ✓ | - | - | - | ✓ | - | - | - | - | | [Kling 3.0 Turbo](/zh/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | - | | [Kling V3](/zh/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | - | ✓* | - | | [Nano Banana 2](/zh/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | diff --git a/zh/development/deploy/cloud-custom-builds.mdx b/zh/development/deploy/cloud-custom-builds.mdx new file mode 100644 index 0000000000..a58e110841 --- /dev/null +++ b/zh/development/deploy/cloud-custom-builds.mdx @@ -0,0 +1,262 @@ +--- +title: "向 Comfy Cloud 添加自定义构建" +sidebarTitle: "自定义构建" +description: "在 Comfy Cloud 上使用你自己的自定义节点运行工作流:创建构建、从编辑器中运行其部署、上传 LoRA,并删除部署。" +icon: "puzzle-piece" +translationSourceHash: 8794e3d7 +translationFrom: development/deploy/cloud-custom-builds.mdx +translationBlockHashes: + "_intro": 8bac2431 + "Create a Build from your Workflow": 5fc814b8 + "Add your own LoRA or model": dee7604c + "Stop or delete your deployment": c6996c1e + "Next steps": 8223b620 +--- +一个构建(Build)会打包你的自定义节点、私有自定义节点、LoRA 和其他模型以及 Python 依赖关系,使你的工作流能够在 Comfy Cloud 上运行。你在 Comfy Cloud 编辑器中启动构建,在开发者平台上创建并部署它,然后在编辑器中让工作流在其上运行。 + +部署构建还会为你提供仅服务于你的工作流的 GPU 工作节点,即使 Comfy Cloud 已经支持这些工作流中的每一个节点。 + + + 如果要在 Comfy Cloud 已支持的节点上使用你自己的 LoRA 或其他模型,你不需要构建。只需将模型上传到你的**模型库**即可。参见[添加你自己的 LoRA 或模型](#添加自己的-lora-或模型)。 + + +### 前提条件 + +在创建构建之前,请确保你具备以下条件: + +- **在 Comfy Cloud 上保存的工作流** +- **有效的订阅或大于零的 Comfy 积分余额** + + + 创建或保留构建不产生任何费用。部署会在 GPU 为其开启时消耗 GPU 时间。只要部署存在,即使它已停止或没有开启 GPU,也会产生存储费用。部署对话框会在你确认之前显示预估费用。若要停止付费,请删除该部署。参见[停止或删除你的部署](#停止或删除部署)。 + + +## 从工作流创建 Build + +如果你的工作流使用了 Comfy Cloud 不支持的自定义节点,打开该工作流时 Comfy Cloud 会显示一个对话框。对话框会列出缺失的自定义节点包(自定义节点的分组)和模型,例如 LoRA。要运行该工作流,请用它们创建一个 Build。当你选择已保存的工作流时,开发者平台会找到它的自定义节点和模型,并为你选中它们。 + + + + 在对话框中,点击 **在平台上创建**。开发者平台会在新标签页中打开,并停留在 **部署** 页面。 + + ![Comfy Cloud 针对包含其不支持的自定义节点的工作流所显示的对话框,在 Read the docs 链接上方列出缺失节点,并包含使用你的 agent 构建按钮和在平台上创建按钮](/images/development/deploy/run-on-custom-deployment.png) + + ![运行按钮旁打开的运行菜单,其中已勾选 Comfy Cloud,显示消息“此工作区还没有任何部署”,下方是创建自定义部署](/images/development/deploy/run-on.png) + + + 如需不通过对话框创建 Build,请点击 **运行** 左侧的云端菜单。默认情况下,它被设为 **Comfy Cloud**。 + + - 如果你的工作区还没有任何部署,选择 **创建自定义部署**,然后点击 **在平台上创建**。 + - 如果已有部署,选择 **管理部署**。 + + + + 在 **部署** 页面,点击 **新建 Build**。如果你还没有任何 Build,请改为点击 **从零开始**。 + + + 1. 点击 **从 Comfy Cloud 选择**。 + 2. 选择你的工作流,然后点击 **添加 1 个工作流**。 + + 你也可以把工作流的 `.json` 文件,或用它生成的 `.png` 图像拖到拖放区域。 + + ![开发者平台新建 Build 页面的第一步,包含拖放区域、从 Comfy Cloud 选择按钮、带对勾的已选工作流名称、建议的默认配置列表,以及自定义 Build 和使用默认配置构建按钮](/images/development/deploy/missing-nodes.png) + + 当工作流的名称带对勾出现在拖放区域下方,且 **建议的默认配置** 列表显示该 Build 的 **自定义节点** 时,这一步即成功。 + + + 点击 **使用默认配置构建…**。此时会打开 **选择构建目标** 对话框。 + + 如果 **使用默认配置构建…** 不可用,按钮下方会有一行文字说明原因。当它显示 *请先在各步骤中添加缺失的模型和自定义节点。* 时,请添加缺失的内容: + + 1. 点击 **自定义 Build**。 + 2. 点击 **下一步**,直到某个步骤列出缺失的自定义节点或模型。 + 3. 对每一项点击 **使用建议** 或 **上传**。 + + + +要更改 Build 包含的内容,请改为点击 **自定义 Build** 并逐步完成各个步骤。有两个步骤决定 Build 包含什么: + +- **构建需要哪些自定义节点?**:选择自定义节点。 +- **构建中打包哪些模型?**:选择该 Build 包含哪些模型。Build 未包含的模型会在作业首次使用它时下载。 + +### 发布 Build + +发布会把你的 Build 变成一个带编号的版本,例如 `v1`,你可以现在部署,也可以以后再部署。发布是免费的。 + +1. 在 **选择构建目标** 对话框中,保持选中 **Serverless 构建**。它是在 Comfy Cloud 上运行的目标。 +2. 点击 **发布**。 + +你的 Build 页面会打开并显示新版本。**Serverless 构建** 一行会显示构建进度。构建通常需要 10 到 15 分钟,你可以离开页面稍后再回来。构建完成后,**Serverless 构建** 一行会显示 **部署** 按钮。 + +要稍后回到该版本: + +1. 在 **开发者平台侧边栏** 中,点击 **部署**。 +2. 在 **Builds** 区域,点击你的 Build。 +3. 在 **版本** 下,点击最新版本。 + + + + 有些自定义节点会构建失败。出现这种情况时,你的 Build 页面上的 **Serverless 构建** 一行会显示 **构建失败**。 + + 1. 在该行打开 **日志**,查看失败的原因。 + 2. 点击 **编辑 Build**,修改该 Build,例如移除构建失败的那个自定义节点。 + 3. 重新发布该 Build。 + + 该行的 **使用你的 agent 调试** 按钮会打开一段描述该失败的提示词。把它复制给编码 agent,即可修复该 Build。 + + + +### 部署并运行你的工作流 + +部署就是你的构建在 Comfy Cloud GPU 上运行。先部署构建,然后把 Comfy Cloud 编辑器切换到该部署来运行你的工作流。 + +1. 在 **Serverless build** 行上,点击 **Deploy**。此时会打开 **Deploy v1 of** _你的构建名称_ 对话框。 +2. 选择一个 GPU。每个 GPU 都会显示其 VRAM(GPU 内存)和每小时价格。 +3. 如果对话框显示 **Ready for the Cloud editor**,请保持选中状态。该选项默认开启。 +4. 其他设置保持默认值。当 **Always-warm workers** 为 `0` 时,部署会在没有任务进入时关闭其 GPU。默认情况下,**Keep worker up after a job** 会在最后一个任务结束后让 GPU 继续运行 3 分钟,这段空闲时间会按 GPU 费率计费。 +5. 查看 **Estimated cost** 面板。它会显示每小时的 GPU 时间和每月的模型存储费用。 +6. 点击 **Create deployment**。随后会打开该部署的页面。等待部署名称下方的状态显示为 **Ready**。 +7. 在 Comfy Cloud 编辑器中,点击 **Run** 左侧的云端菜单。在 **Run on** 下,选择你的部署。编辑器会重新加载,你的标签页会保持打开。 + + ![Run 按钮旁展开的 Run on 菜单,所选部署旁带有勾选标记](/images/development/deploy/selected-deployment.jpg) + +8. 打开你的工作流,然后点击 **Run**。部署启动 GPU 期间,你的第一个任务可能需要等待。 + +只要你不选择其他部署,这个浏览器就会一直在该部署上运行你的工作流。要切回,请在同一菜单中选择 **Comfy Cloud**。如果某个工作流有未保存的更改,会打开 **Save your workflows before switching?** 对话框。点击 **Save and switch** 或 **Switch without saving**。 + +## 添加自己的 LoRA 或模型 + +**模型库**存储你的工作区上传的模型。你上传的模型可在 Comfy Cloud 和你的部署上运行。 + +在上传模型之前,请确保满足以下要求: + +- **有效的 Pro、Creator、Team 或企业版套餐**:你的工作区需要拥有其中一种套餐才能上传模型。 +- **不超过 2 GB 的 `.safetensors` 文件**:请将更大的基础模型(例如 SDXL 或 Flux)放入构建中。 + + + 某些在模型库中的模型可用之前创建的部署无法加载这些模型。要使用模型库中的模型,请创建新的部署。在较旧的部署上,任务可能会失败并显示 `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` + + +### 上传模型 + +你可以在 Comfy Cloud 编辑器或开发者平台上上传。请根据你当前使用的环境选择对应标签页。 + + + + 1. 在**运行**左侧的云菜单中,确保在**运行于**下选择了 **Comfy Cloud**。在部署上,**模型库**没有**导入**按钮。 + 2. 在**左侧边栏**中,点击**模型库**,然后点击**导入**。 + 3. 点击**选择文件**,或将 `.safetensors` 文件拖入对话框。 + 4. 在**这是什么类型的模型?**下,如果是 LoRA,请保留 **LoRA**,或选择与该文件匹配的类型。 + 5. 点击**上传**。当对话框显示 _模型已成功导入。_ 时,点击**完成**。 + + ![“导入模型”对话框,已选择 my\_style\_lora\_9e2417.safetensors(97.37 MB),“这是什么类型的模型?”设置为 LoRA,还有“返回”和“上传”按钮](/images/development/serverless/library-models-editor-import.png) + + 如需改为从 Civitai 或 Hugging Face 链接导入模型: + + 1. 在**导入**对话框中,在**粘贴链接到此**中粘贴模型的链接。 + 2. 点击**继续**。 + 3. 在**这是什么类型的模型?**下,选择模型类型。 + 4. 点击**导入**。 + + 以其他格式(例如 `.ckpt`)进行的链接导入会导入到**模型库**,但不会在部署上运行。 + + + 1. 在构建流程的**构建中包含哪些模型?**步骤中,点击**上传模型**。 + 2. 选择**工作区库**。 + 3. 将 `.safetensors` 文件拖到拖放区域,或点击该区域进行浏览。 + 4. 在**模型类型**下,如果是 LoRA,请保留 **LoRA**,或选择与该文件匹配的类型。 + 5. 点击**上传**。 + + ![构建流程“构建中包含哪些模型?”步骤中的“上传模型”对话框,包含“公开”、“私有”和“工作区库”标签页,已选择“工作区库”,有拖放区域,“模型类型”设置为 LoRA,一行文字显示该文件位于你的工作区库中,还有“取消”和“上传”按钮](/images/development/serverless/library-models-platform-upload.png) + + + +### 在工作流中使用模型 + +模型上传后,你可以在 Comfy Cloud 或你的部署上使用它。 + +1. 在**运行**左侧的云菜单中,选择运行位置:**Comfy Cloud** 或你的部署。 +2. 添加一个 `Load LoRA (Model and CLIP)` 节点,或打开包含该节点的工作流。 +3. 在该节点的 `lora_name` 列表中,选择你的文件。 +4. 点击**运行**。 + +![包含 Load Checkpoint 和 Load LoRA (Model and CLIP) 节点的工作流,lora\_name 中已选择上传的 LoRA,队列面板顶部一行显示 Downloading my\_style\_lora\_9e2417.safetensors 0 B of 97.37 MB](/images/development/serverless/library-models-editor-downloading.png) + + + 在部署上,首次运行会下载模型,队列中该任务所在行会显示 `Downloading `。同一张正在运行的 GPU 上的后续任务会跳过下载。部署稍后启动的 GPU 会再次下载模型。要跳过下载,请将模型添加到构建中。 + + +请遵循以下规则,以便任务能找到你的模型: + +- **选择匹配的类型。** 加载器节点只列出其类型的模型。`Load LoRA (Model and CLIP)` 节点会列出作为 LoRA 上传的模型。 +- **使用新的文件名。** 如果你的构建中已有同名模型,则部署上的任务会使用构建中的文件,而不是你上传的文件。 +- **匹配基础模型。** LoRA 必须与你的工作流加载的基础模型匹配。 +- **使用 Comfy Cloud 支持的加载器节点。** 如果该加载器节点来自 Comfy Cloud 不支持的自定义节点,请将模型添加到构建中。 + +### 更改或删除模型库中的模型 + +当在**运行于**下选择部署时,**模型库**只列出构建中的模型。要更改或删除你上传的模型,请先[切换回 Comfy Cloud](#部署并运行你的工作流),然后在**左侧边栏**中点击**模型库**。 + +要更改模型类型: + +1. 将鼠标悬停在模型卡片上,然后点击**模型信息**。 +2. 选择新的**模型类型**。 + + + 删除模型会将其从**模型库**中永久移除。仍在使用该文件的任务会在加载器节点上失败,并显示 `Value not in list` 错误。 + + +要删除模型: + +1. 将鼠标悬停在模型卡片上,点击**更多**,然后点击**删除**。 +2. 在**删除此模型?**中,点击**删除**。 + +## 停止或删除部署 + +部署在删除之前会一直产生存储费用,即使已停止也是如此。停止部署可将其保留以备后用,同时不运行任务。删除部署即可停止付费。 + +打开部署页面: + +1. 在**开发者平台侧边栏**中,点击 **部署**。 +2. 在**部署**区域中,点击部署的名称。 + +![部署页面中的部署区域,每个部署的名称位于最左侧列,其状态位于“状态”列](/images/development/deploy/deployments.jpg) + +停止部署: + +1. 点击 **停止**。 +2. 在 **停止部署** 对话框中,点击 **停止**。 + +状态会显示为 **正在停止**,然后变为 **已停止**。 + +再次运行部署: + +- 点击 **启动**。 + + + 删除会永久移除部署及其历史记录。你的 Build 及其版本会保留,因此之后可以再次部署。 + + +删除部署: + +1. 在已停止的部署上,点击 **删除**。对于正在运行的部署,打开 **更多操作** 菜单,然后选择 **删除**。 +2. 在 **删除部署** 对话框中,点击 **删除**。 + +下次在此浏览器中打开编辑器时,编辑器会在 Comfy Cloud 上运行你的工作流。 + +## 后续步骤 + + + + 从终端上传模型,并在每次请求中通过 `lora_name` 选择该模型。 + + + 从你自己的代码中以自动扩缩容端点的方式调用你的部署。 + + + 了解 Comfy Cloud 积分与并发任务限制的工作方式。 + + + 以 API 请求所发送的格式导出工作流。 + + diff --git a/zh/development/deploy/overview.mdx b/zh/development/deploy/overview.mdx index 9acca2c2e1..7652f1be9a 100644 --- a/zh/development/deploy/overview.mdx +++ b/zh/development/deploy/overview.mdx @@ -3,31 +3,33 @@ title: "部署 ComfyUI" sidebarTitle: "概述" description: "对比 Comfy Cloud、托管式 Comfy API 部署与自托管,选择运行 ComfyUI 的方式。" icon: "map" -translationSourceHash: be91af8f +translationSourceHash: c83524f1 translationFrom: development/deploy/overview.mdx translationBlockHashes: - "_intro": cc75b9f0 + "_intro": 44e94954 "Deploy from the ComfyUI app": 53163f19 - "Run a deployment from the Cloud editor": 9426b4cc - "Stop or delete a deployment": 9b9a173c + "Run a deployment from the Cloud editor": 1c75cbed "Run Workflows from your application": f95d4434 --- -你可以在 Comfy Cloud、自己的 Comfy API 部署,或自己管理的服务器上运行 ComfyUI 工作流。Comfy Cloud 和 Comfy API 运行在 Comfy GPU 上,因此你的电脑不需要 GPU。按工作流选择合适方案,从对应卡片开始。 +你可以在 Comfy Cloud、自己的 Comfy API 部署,或自己管理的服务器上运行 ComfyUI 工作流。Comfy Cloud 和 Comfy API 运行在 Comfy GPU 上,因此你的电脑不需要 GPU。选择适合你工作流的方案,并从其对应的卡片开始。 - + - 运行 Comfy Cloud 上已有自定义节点和模型的工作流,无需构建或部署。 + 运行自定义节点和模型已在 Comfy Cloud 上提供的工作流,无需构建或部署。 + + + 在 Comfy Cloud 编辑器中运行需要你自己的自定义节点和模型的工作流,并使用你在浏览器中创建的构建。 - 将自定义节点、模型和 Python 依赖打包为构建,并以可自动扩缩容的端点运行。 + 将自定义节点、模型和 Python 依赖关系打包为构建,并作为可自动扩缩容的端点运行。 在你管理的机器上运行 ComfyUI,并用 `--listen` 在网络中提供服务。 -要从自己的代码调用这三种方案中的任意一种,请发送 [API 格式](/zh/development/api-development/workflow-api-format) 的工作流。 +要从自己的代码调用上述任一方案,请以 [API 格式](/zh/development/api-development/workflow-api-format) 发送工作流。 ## 从 ComfyUI 应用中部署 @@ -57,86 +59,7 @@ translationBlockHashes: ## 从 Cloud 编辑器运行部署 -你的部署可以在 Comfy Cloud 上的 ComfyUI 中运行工作流,并使用其构建中的自定义节点和模型。 - -### 从 Comfy Cloud 创建部署 - -在 Comfy Cloud 上,**Workflow actions** 菜单没有 **Deploy to Comfy API** 入口。请改为从 **Run** 旁边的菜单开始: - -1. 点击 **Run** 旁边的菜单。 -2. 选择 **Create a custom deployment**,然后点击 **Create on Platform**。你在 Developer Platform 上的构建会在新标签页中打开。 - -![Run 按钮旁打开的 Run on 菜单,勾选了 Comfy Cloud,显示 This workspace has no deployments yet,下方是 Create a custom deployment](/images/development/deploy/run-on.png) - -当工作区已有部署时,菜单会改为显示 **Manage deployments**。它会打开 Developer Platform 上的同一构建页面。 - -当你打开使用了 Comfy Cloud 没有的自定义节点的工作流时,**Run this workflow on a custom deployment** 对话框会列出缺失项。点击 **Create on Platform** 为其启动构建。 - -![Comfy Cloud 对话框,针对含 Comfy Cloud 没有的自定义节点的工作流,在 Read the docs 链接、Build with your agent 按钮和 Create on Platform 按钮上方列出缺失节点](/images/development/deploy/run-on-custom-deployment.png) - -### 在 Cloud 编辑器中打开你的部署 - -1. 在部署对话框中,如果显示 **Ready for the Cloud editor**,请保持选中。该选项默认开启。如果取消 **Ready for the Cloud editor**,之后在编辑器中打开该部署会多花大约一分钟。 -2. 在部署页面上,等待名称下方的状态变为 **Ready**。在此之前 **Open in ComfyUI** 保持禁用。 -3. 点击 **Open in ComfyUI**。Comfy Cloud 上的 ComfyUI 会在新标签页中打开,并重新加载到你的部署。 - -![部署页面,部署名称下方显示 Ready 状态,右上角是 Open in ComfyUI 按钮](/images/development/deploy/deployment-detail.jpg) - -要查看工作流在哪里运行: - -1. 点击 **Run** 旁边的菜单。 -2. 找到工作流所运行的部署旁的对勾。 -3. 点击 **Run**,在该部署上运行工作流。 - -![Run 按钮旁打开的 Run on 菜单,所选部署旁有对勾](/images/development/deploy/selected-deployment.jpg) - -- 菜单会列出工作区中的每个部署。选择一个 **Ready** 部署即可切换到它。 -- 切换会重新加载编辑器。默认情况下,你的标签页会保持打开。 -- 此浏览器会继续在所选部署上运行工作流,直到你选择另一个部署。 - -### 切换回 Comfy Cloud - -1. 点击 **Run** 旁边的菜单。 -2. 选择 **Comfy Cloud**。 - -编辑器会重新加载。如果工作流有未保存的更改,会打开 **Save your workflows before switching?** 对话框。点击 **Save and switch**,或 **Switch without saving**。 - -## 停止或删除部署 - -停止部署可停止其任务,删除部署可移除它并结束其存储计费。这两个操作都在 Developer Platform 上的部署页面中。 - - - 已停止的部署不会运行任务,但仍会产生存储费用。删除部署才能结束存储计费。 - - -打开部署页面: - -1. 在 Developer Platform 侧边栏中,点击 **Deploy**。 -2. 在 **Deployments** 部分,点击部署名称。 - -![Deploy 页面的 Deployments 部分,最左列是各部署名称,Status 列是其状态](/images/development/deploy/deployments.jpg) - -停止部署: - -1. 点击 **Stop**。 -2. 在 **Stop deployment** 对话框中,点击 **Stop**。 - -状态会显示为 **Stopping**,然后变为 **Stopped**。 - -再次运行部署: - -- 点击 **Start**。 - - - 删除会永久移除部署及其历史。构建会保留。 - - -删除部署: - -1. 在已停止的部署上,点击 **Delete**。在运行中的部署上,打开 **More actions** 菜单,然后选择 **Delete**。 -2. 在 **Delete deployment** 对话框中,点击 **Delete**。 - -下次在该部署上运行过 Cloud 编辑器的浏览器加载 ComfyUI 时,ComfyUI 会在 Comfy Cloud 上运行,而不是已删除的部署。 +如需从 Comfy Cloud 编辑器创建部署、在其上运行工作流,以及停止或删除部署,请参阅[向 Comfy Cloud 添加自定义构建](/zh/development/deploy/cloud-custom-builds)。 ## 从应用程序运行工作流 diff --git a/zh/development/serverless/overview.mdx b/zh/development/serverless/overview.mdx index 9669da91d2..04bb31d86a 100644 --- a/zh/development/serverless/overview.mdx +++ b/zh/development/serverless/overview.mdx @@ -2,23 +2,25 @@ title: "Comfy API:Serverless 部署" description: "使用 Comfy API 将 ComfyUI 工作流部署为托管 GPU 端点:Build、版本、区域、Worker 扩缩容、工作区限额与部署监控。" icon: "cloud-arrow-up" -translationSourceHash: 4df17332 +translationSourceHash: fbee2a94 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 - "Platform concepts": cd4243ce + "Platform concepts": 7dd0b0f4 "The Build file": 70f351b1 "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f "Workspace limits": e0643567 "Monitor and call a deployment": ff860dab + "Use workspace library models in API requests": ab60f3f3 "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b - "FAQ": 08ef9084 + "FAQ": 4eff1368 "Next steps": 0045baa9 --- + Comfy API 可让你的应用通过托管端点运行 ComfyUI 工作流。你需要打包工作流所需的 ComfyUI 版本、模型、自定义节点和依赖项,然后由 Comfy 在托管 GPU 上运行。适合需要可重复的运行环境,以及供应用调用的端点的场景。 ## 平台概念 @@ -32,7 +34,7 @@ Comfy API 可让你的应用通过托管端点运行 ComfyUI 工作流。你需 受 [Comfy Cloud](/zh/development/deploy/cloud) 支持的工作流可以直接在云端运行,无需创建 Build 或部署。 -如果要为部署添加模型而不创建新的 Build,请将其上传到你的工作区库。请参阅 [工作区库模型](/zh/development/serverless/library-models)。 +如果要为部署添加模型而不创建新的 Build,请将其上传到你的工作区库。请参阅 [添加自己的 LoRA 或模型](/zh/development/deploy/cloud-custom-builds#添加自己的-lora-或模型)。 从 agent 开始,或选择其他方式来提供你的环境或工作流。 @@ -91,6 +93,43 @@ comfy deploy refs compute --region 你也可以使用 [Comfy SDKs](/zh/development/api-development/sdks) 调用该端点。将 `COMFY_BASE_URL` 设置为部署 URL,并提供 API 密钥。请参阅[选择基础 URL](/zh/development/api-development/sdks#选择基础-url)。 +## 在 API 请求中使用工作区库模型 + +部署会运行工作区库中的 `.safetensors` 模型,即使该发布版本并不包含这些模型。要在 Comfy Cloud 编辑器中或开发者平台上上传模型,请参阅[添加自己的 LoRA 或模型](/zh/development/deploy/cloud-custom-builds#添加自己的-lora-或模型)。 + +要从终端上传,请使用 `--type` 设置模型类型,然后确认该文件已存在于库中: + +```bash +comfy assets library upload my_style.safetensors --type loras +comfy assets library ls --tags models,loras +``` + +在 [API 格式的工作流](/zh/development/api-development/workflow-api-format)中,将加载器的输入设置为库中的文件名,并包含 `.safetensors`: + +```json +"10": { + "class_type": "LoraLoader", + "inputs": { + "lora_name": "my_style.safetensors", + "strength_model": 1.0, + "strength_clip": 1.0, + "model": ["4", 0], + "clip": ["4", 1] + } +} +``` + +使用 `comfy deploy run`、[Comfy SDK](/zh/development/api-development/sdks) 或 [Comfy API v2](/zh/api-reference/v2/overview) 发送工作流: + +```bash +comfy deploy run --deployment --workflow workflow_api.json +``` + +要使用其他 LoRA,只需在下一次请求中把 `lora_name` 改为另一个库文件名。无需新的 Build、发布或重新部署。 + +- 一个工作流最多可以引用 100 个库模型。如果某个加载器引用了第 101 个库模型,就会失败,表现得就像该文件不在库中一样。 +- 请确保同一个加载器所读取的各个文件夹中文件名唯一。如果库中有两个文件夹包含相同的文件名,通过 API 发送的任务将不会加载其中任何一个文件。 + ## 部署运维 ```bash @@ -131,7 +170,7 @@ comfy deploy events --deployment dep_123456 - 不会。Build 及其发布版本免费存储在你的账户中。在部署之前,Build 的存储占用不会计费。 + 不会。Build 及其发布版本免费存储在你的账户中。在部署之前,Build 的存储占用不会产生费用。 存储计费从部署开始: @@ -145,7 +184,7 @@ comfy deploy events --deployment dep_123456 `--min` 设置 **活跃 worker** 的数量:这类 worker 始终处于运行状态,因此请求永远不会等待冷启动。活跃 worker 在其运行的整个期间都按秒计费,无论它是否正在处理任务。 - 超过 `--min`、最多到 `--max` 的 worker 是 **弹性 worker**。弹性 worker 从其启动的那一刻起(包括启动和模型加载)按秒计费,一直计到任务处理结束,再加上缩减前的一段短暂空闲窗口(目前为 30 秒)。弹性 worker 缩减后不再产生费用。当设置为 `--min 0` 时,整个部署会缩减到零,空闲时不产生计算费用,代价是第一个请求会有冷启动。 + 超过 `--min`、最多到 `--max` 的 worker 是 **弹性 worker**。弹性 worker 从其启动的那一刻起(包括启动和模型加载)按秒计费,一直计到任务处理结束,再加上缩减前的一段短暂空闲窗口(目前为 30 秒)。弹性 worker 缩减后不再产生费用。当设置为 `--min 0` 时,整个部署会缩减到零,空闲时不产生计算费用,代价是第一个请求需要冷启动。 计费按 worker 的实际每秒用量计算,再乘以正在运行的 worker 数量。如果你的工作区积分已用完,部署会被自动停止。 diff --git a/zh/tutorials/partner-nodes/pika/pika-h3-flex.mdx b/zh/tutorials/partner-nodes/pika/pika-h3-flex.mdx index 226781cc3f..7a3401ed93 100644 --- a/zh/tutorials/partner-nodes/pika/pika-h3-flex.mdx +++ b/zh/tutorials/partner-nodes/pika/pika-h3-flex.mdx @@ -2,7 +2,7 @@ title: "Pika H3 Flex:ComfyUI 中的文本、图像与参考视频" description: "在 ComfyUI 中通过合作伙伴 API 运行 Pika H3 Flex:支持文本、图像、首尾帧以及参考视频,并生成音频,输出范围从 480p 到 4K。" sidebarTitle: "Pika H3 Flex" -translationSourceHash: 6b0b02c9 +translationSourceHash: 748513cb translationFrom: tutorials/partner-nodes/pika/pika-h3-flex.mdx translationBlockHashes: "_intro": dc840a35 @@ -10,10 +10,11 @@ translationBlockHashes: "Pika H3 Flex: Text to Video (API) {#api_pika_h3_flex_t2v}": 7745a88d "Image to video and first-last-frame": 76d6d279 "Reference to video": 0ba880d9 - "Pika audio nodes": 642096c1 + "Pika audio nodes": f8d1f386 "Prompt format": 0a07de68 "Cost": 5adc088c --- + import ReqHint from "/snippets/zh/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/zh/tutorials/update-reminder.mdx"; From 30e9a6f1243e68cb5d843659d3757554a32c95e5 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Sat, 14 Nov 2026 11:11:27 +0800 Subject: [PATCH 30/36] i18n(ja): drop the duplicated mask paragraphs on the GPT Image 2.6 code pages --- .../models/openai/gpt-image-2-6-flare/code.mdx | 4 ---- .../models/openai/gpt-image-2-6-sunburst/code.mdx | 7 ------- 2 files changed, 11 deletions(-) diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 03d07cd8e1..f8d6f37b06 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -203,10 +203,6 @@ URL は認証情報なしで解決できる必要があります。Router はサ 各画像は 25 MiB、1 リクエストの画像は合計 64 MiB までです。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用可能な場合です。その場合、各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1 リクエストの画像は合計 128 MiB までです。 -一致するのはプロバイダーではなく、ホスト名の形式です。そのため、上記でプロバイダーを指定しても、そのプロバイダーが発行できるすべての URL が受け入れられるわけではありません。また、呼び出し元がそれぞれを無理なく使い得るため、紛らわしい 3 つの非対応形式を明示しておく価値があります。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限されたデバッグ用ホスト名として文書化しており、本番トラフィックは代わりにカスタムドメインに向けるよう案内しています。しかし、カスタムドメインのホスト名には R2 であることを示す情報が何も含まれていないため、Router は他のホストと区別できず、拒否します。`.r2.cloudflarestorage.com` エンドポイントの署名付き URL を生成するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 デュアルスタックエンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョンエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が記載されているため、ここに来て読む必要はありません。 -上記の `` と `pub-` プレースホルダーは、通常使用する形式を示しています。これらは階層の深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下にあるより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって名前空間自体が広がるわけではありません。サフィックスは依然として一覧に示されたものの 1 つでなければなりません。 -以下の例は形状のみを示しています。実際の値には署名クエリパラメータも含まれますが、公開された例は仕様に永久に残り、実際の署名は漏洩した認証情報であると同時に機能しなくなるリンクでもあるため、ここでは意図的に省略しています。 -各画像は 25 MiB に、1 回のリクエストの画像は合計 64 MiB に制限されます。唯一の例外は、`context_window` が利用可能な ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)です。そこでは各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセルまで可能で、1 回のリクエストの画像は合計最大 128 MiB です。 実行する gpt-image モデル。Router はアドレス指定されたモデル ID を挿入するため、/v2/models/openai/gpt-image-2.6-flare をアドレス指定する呼び出し元はこれを送信しません。 diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 58be1be63a..ac5776f53c 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -203,13 +203,6 @@ URL は認証情報なしで解決できる必要があります。Router はサ 各画像は 25 MiB、1 回のリクエストの画像は合計 64 MiB に制限されます。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用可能な場合です。その場合、各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1 回のリクエストの画像は合計で最大 128 MiB となります。 -一致するのはホスト名の形式であり、プロバイダーではありません。したがって、上でプロバイダーを指定しても、そのプロバイダーが発行できるすべての URL が受け入れられるわけではありません。また、3 つの紛らわしい非対応形式は明示する価値があります。呼び出し元がそれぞれの形式で到達するのは妥当だからです。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限付きのデバッグ用ホスト名として文書化しており、本番トラフィックは代わりにカスタムドメインに向けます。しかし、カスタムドメインのホスト名には R2 であることを示す情報がないため、Router は他のホストと区別できず、拒否します。`.r2.cloudflarestorage.com` エンドポイントの署名付き URL を生成するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も受け入れられません。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれらの同じ形式が記載されているため、それらを読むためにここへ来る必要はありません。 - -上記の `` と `pub-` は、通常使用する形式を示すプレースホルダーであり、階層の深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下にあるより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって名前空間自体が広がるわけではありません。サフィックスは依然として一覧にあるもののいずれかでなければなりません。 - -以下の例は形状のみを示しています。実際の値には署名クエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例は仕様に永久に残り、実際の署名は漏えいした認証情報であると同時に、機能しなくなるリンクでもあるためです。 - -各画像は 25 MiB、1 つのリクエストの画像は合計 64 MiB に制限されます。唯一の例外は、`context_window` が利用可能な ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)です。この場合、各画像は最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1 つのリクエストの画像は合計最大 128 MiB です。 実行する gpt-image モデル。Router はアドレス指定されたモデル ID を挿入するため、/v2/models/openai/gpt-image-2.6-flare をアドレス指定する呼び出し元はこれを送信しません。 From cee6d335d021bf4ab92eec4c0dd760e921bd8791 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Sat, 14 Nov 2026 11:25:51 +0800 Subject: [PATCH 31/36] i18n(es): sync Spanish translations with upstream/main (2026-11-14) --- es/development/comfy-router/limitations.mdx | 40 +- es/development/comfy-router/models.mdx | 100 +-- .../anthropic/claude-fable-5-1/code.mdx | 11 +- .../models/anthropic/claude-fable-5/code.mdx | 7 +- .../claude-haiku-4-5-20251001/code.mdx | 9 +- .../models/anthropic/claude-opus-4-6/code.mdx | 7 +- .../models/anthropic/claude-opus-4-7/code.mdx | 7 +- .../models/anthropic/claude-opus-4-8/code.mdx | 7 +- .../models/anthropic/claude-opus-5-5/code.mdx | 9 +- .../models/anthropic/claude-opus-5/code.mdx | 7 +- .../claude-sonnet-4-5-20250929/code.mdx | 7 +- .../anthropic/claude-sonnet-4-6/code.mdx | 9 +- .../anthropic/claude-sonnet-5-5/code.mdx | 7 +- .../models/anthropic/claude-sonnet-5/code.mdx | 7 +- .../dreamina-seedance-2-0-260128/code.mdx | 142 ++-- .../code.mdx | 127 ++-- .../dreamina-seedance-2-0-mini/code.mdx | 116 ++- .../dreamina-seedance-2-5-260628/code.mdx | 124 ++-- .../byteplus/seedance-1-0-pro-250528/code.mdx | 109 +-- .../seedance-1-0-pro-fast-251015/code.mdx | 122 ++-- .../google/gemini-2-5-flash-image/code.mdx | 43 +- .../google/gemini-3-1-flash-lite/code.mdx | 28 +- .../models/google/gemini-3-7-flash/code.mdx | 27 +- .../models/google/gemini-3-8-flash/code.mdx | 18 +- .../models/google/gemini-4-argon/code.mdx | 689 ++++++++++++++++++ .../models/google/gemini-4-carbon/code.mdx | 685 +++++++++++++++++ .../models/google/gemini-4-hydrogen/code.mdx | 688 +++++++++++++++++ .../google/gemini-nano-banana-2-1/code.mdx | 244 ++----- .../models/google/gemini/code.mdx | 6 +- .../models/google/nano-banana-2-lite/code.mdx | 33 +- .../models/google/nano-banana-2/code.mdx | 20 +- .../models/google/nano-banana-pro/code.mdx | 25 +- .../models/kling/kling-v2-5-turbo/code.mdx | 36 +- .../models/kling/kling-v2-6/code.mdx | 29 +- .../models/kling/kling-v3-omni/code.mdx | 57 +- .../models/kling/kling-v3/code.mdx | 30 +- .../models/kling/kling-video-o1/code.mdx | 59 +- .../comfy-router/models/krea/krea-3/code.mdx | 29 +- .../models/ltx/ltx-video-alpha-gen/code.mdx | 221 ++++++ .../ltx/ltx-video-to-video-hdr/code.mdx | 232 ++++++ .../ltx/ltx-video-to-video-reframe/code.mdx | 262 +++++++ .../models/ltx/ltx-video-upscale/code.mdx | 228 ++++++ .../models/openai/gpt-image-1-5/code.mdx | 38 +- .../openai/gpt-image-2-5-flare/code.mdx | 13 +- .../openai/gpt-image-2-5-sunburst/code.mdx | 25 +- .../openai/gpt-image-2-6-flare/code.mdx | 82 ++- .../openai/gpt-image-2-6-sunburst/code.mdx | 86 ++- .../models/openai/gpt-image-2/code.mdx | 31 +- .../models/pixverse/v3-5/code.mdx | 309 ++++++++ .../models/pixverse/v6-max/code.mdx | 310 ++++++++ .../comfy-router/models/pixverse/v6/code.mdx | 308 ++++++++ .../models/pruna/p-video-2/code.mdx | 35 +- .../models/quiver/arrow-2-telos/code.mdx | 283 +++++++ .../models/quiver/arrow-2/code.mdx | 283 +++++++ .../veo/veo-3-1-fast-generate-001/code.mdx | 23 +- .../models/veo/veo-3-1-generate-001/code.mdx | 18 +- .../veo/veo-3-1-lite-generate-001/code.mdx | 15 +- es/development/comfy-router/pricing.mdx | 92 +-- es/development/comfy-router/providers.mdx | 35 +- es/development/comfy-router/quickstart.mdx | 30 +- es/development/comfy-router/reference.mdx | 277 +++---- es/development/deploy/cloud-custom-builds.mdx | 262 +++++++ es/development/deploy/overview.mdx | 95 +-- es/development/serverless/overview.mdx | 55 +- .../partner-nodes/pika/pika-h3-flex.mdx | 9 +- 65 files changed, 6033 insertions(+), 1344 deletions(-) create mode 100644 es/development/comfy-router/models/google/gemini-4-argon/code.mdx create mode 100644 es/development/comfy-router/models/google/gemini-4-carbon/code.mdx create mode 100644 es/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx create mode 100644 es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx create mode 100644 es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx create mode 100644 es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx create mode 100644 es/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx create mode 100644 es/development/comfy-router/models/pixverse/v3-5/code.mdx create mode 100644 es/development/comfy-router/models/pixverse/v6-max/code.mdx create mode 100644 es/development/comfy-router/models/pixverse/v6/code.mdx create mode 100644 es/development/comfy-router/models/quiver/arrow-2-telos/code.mdx create mode 100644 es/development/comfy-router/models/quiver/arrow-2/code.mdx create mode 100644 es/development/deploy/cloud-custom-builds.mdx diff --git a/es/development/comfy-router/limitations.mdx b/es/development/comfy-router/limitations.mdx index 3b42a3165d..5629130e31 100644 --- a/es/development/comfy-router/limitations.mdx +++ b/es/development/comfy-router/limitations.mdx @@ -2,20 +2,20 @@ title: "Capacidades y límites de Comfy Router" sidebarTitle: "Capacidades y límites" description: "Elige Router o un proxy socio, planifica llamadas largas y entiende la recuperación, los límites de tasa y el almacenamiento de recursos." -translationSourceHash: a81b3bd9 +translationSourceHash: cd27af52 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 "What Router supports": 2cc63403 - "Queued submission": d0798008 + "Queued submission": bcbb1f7c "Calls are cut off at a server deadline": c8724f59 "Recovery depends on the provider": da9d8904 "Request bodies are capped": 675b77c8 "Requests are rate limited per caller": 83156651 "No progress while a call runs": 75d42d8d "Comfy charges and usage": 06a72e74 - "Models without a pre-flight estimate": e7d7524a - "Router does not cover every partner operation": 786c0fb2 + "Models without a pre-flight estimate": d83b12e1 + "Router does not cover every partner operation": 11621b39 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -23,6 +23,7 @@ translationBlockHashes: + Router ejecuta un modelo socio a través de una llamada HTTP síncrona o mediante una solicitud en cola que envías y recoges más tarde. Úsalo cuando tu aplicación pueda esperar un resultado finalizado o recogerlo más tarde, y pueda manejar los campos de entrada y salida propios del modelo. ## Qué admite Router @@ -47,6 +48,8 @@ Si tu solicitud no puede permanecer abierta el tiempo suficiente, ponla en cola. Cuatro modelos son solo síncronos por ahora y se rechazan con `403` / `not_enabled` si los envías a la cola: `elevenlabs/eleven_sfx_v2`, `elevenlabs/eleven_v3`, `elevenlabs/eleven_v4` y `elevenlabs/eleven_v4_turbo`. Devuelven bytes de audio sin procesar en lugar de un documento de resultado JSON, que la entrega en cola no tiene dónde almacenar. Ejecútalos en la ruta síncrona, que devuelve esos bytes con normalidad. +Cuatro modelos son solo de cola y se rechazan con `403` / `not_enabled` en la ruta síncrona: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe` y `ltx/ltx-video-upscale`. Sus tareas pueden durar más que el tiempo durante el que se mantiene una llamada síncrona. Envía el mismo cuerpo a `POST /v2/models/ltx/{model}/requests` y recoge el resultado de la cola. + Las operaciones de texto a video e imagen a video de LTX v1 devuelven bytes de video sin procesar por la misma razón, y la entrega en cola tampoco puede almacenarlos, pero solo están disponibles mediante el [proxy de socio](#router-no-cubre-todas-las-operaciones-de-los-socios) en `/proxy/ltx/v1/…`, no mediante un id de modelo de Router: todos los modelos del catálogo `ltx/*` resuelven a la operación de envío y consulta v2, que sí se puede poner en cola. ## Las llamadas se cortan por un plazo límite del servidor @@ -104,7 +107,7 @@ Para consultar un precio antes de una ejecución, llama a `POST /v2/models/{prov ## Modelos sin estimación previa -Router todavía no puede calcular de forma fiable el precio de una llamada a los modelos siguientes antes de ejecutarla, así que espera que `/estimate` y el campo `estimate` de un envío en cola respondan `source: unknown` para ellos, aunque algunos pueden devolver una cifra para un cuerpo concreto. `unknown` significa que no se dio ninguna cifra, no que la ejecución sea gratis. Las reglas de [Cargos y uso de Comfy](#cargos-y-uso-de-comfy) siguen aplicándose: una ejecución con tu propia clave de proveedor no se factura a través de Comfy, y `X-Comfy-Credits-Used` es opcional, así que un encabezado faltante significa que no se informó del costo. Un modelo que no aparezca en esta lista puede responder igualmente `unknown` para un cuerpo concreto, así que revisa `source` en cada estimación. +Router todavía no puede calcular de forma fiable el precio de una llamada a los modelos siguientes antes de ejecutarla, así que es posible que `/estimate` y el campo `estimate` de un envío en cola respondan `source: unknown` para ellos, aunque algunos pueden devolver una cifra para un cuerpo concreto. `unknown` significa que no se dio ninguna cifra, no que la ejecución sea gratis. Las reglas de [Cargos y uso de Comfy](#cargos-y-uso-de-comfy) siguen aplicándose: una ejecución con tu propia clave de proveedor no se factura a través de Comfy, y `X-Comfy-Credits-Used` es opcional, así que si falta el encabezado significa que no se informó del costo. Un modelo que no aparezca en esta lista puede responder igualmente `unknown` para un cuerpo concreto, así que revisa `source` en cada estimación. Esta lista se reduce a medida que crece la cobertura de estimaciones. Se genera a partir del propio código de precios de Router, y los modelos que no están disponibles públicamente nunca aparecen en ella. @@ -115,14 +118,20 @@ Esta lista se reduce a medida que crece la cobertura de estimaciones. Se genera - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4` +- **kelly**: `kelly/kelly-seedance-2.0`, `kelly/kelly-seedance-2.0-fast`, `kelly/kelly-seedance-2.5` - **kling**: `kling/kling-4.0`, `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync` -- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` +- **ltx**: `ltx/ltx-video-alpha-gen`, `ltx/ltx-video-to-video-hdr`, `ltx/ltx-video-to-video-reframe`, `ltx/ltx-video-upscale` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` +- **minimax**: `minimax/minimax-gpt-image-2`, `minimax/minimax-gpt-image-2.5-flare`, `minimax/minimax-gpt-image-2.5-sunburst`, `minimax/minimax-gpt-image-2.6-flare`, `minimax/minimax-gpt-image-2.6-sunburst`, `minimax/minimax-h3-image`, `minimax/minimax-h3-image-highspeed` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` +- **pixverse**: `pixverse/v3.5`, `pixverse/v6`, `pixverse/v6-max` +- **quiver**: `quiver/arrow-2`, `quiver/arrow-2-telos` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` - **synclabs**: `synclabs/sync-3` +- **veed**: `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` - **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} @@ -131,18 +140,19 @@ Las ediciones con `openai/gpt-image-2`, `openai/gpt-image-2.5-flare`, `openai/gp ## Router no cubre todas las operaciones de los socios -Router ejecuta modelos. La carga de archivos, la lectura de cuentas, la gestión de recursos, el streaming y el control de tareas del proveedor pueden requerir rutas de proxy de socio bajo `/proxy/…`, que quedan fuera de Router y no están descritas en su contrato. La superficie propia de Router es la [especificación de Comfy Router](/router-openapi.yaml); el soporte varía según el proveedor. +Router ejecuta modelos. Las cargas de archivos, las lecturas de cuentas, la gestión de recursos, el streaming y los controles de tareas del proveedor pueden requerir rutas de proxy de socio bajo `/proxy/…`, que quedan fuera de Router y no están descritas por su contrato. La propia superficie de Router es la [especificación de Comfy Router](/router-openapi.yaml); el soporte varía según el proveedor. -### Imágenes de referencia de Krea 3: subir primero o usar una URL https pública +### Imágenes de referencia de Krea 3: sube primero o usa una URL https pública -En los `image_urls` de `krea/krea-3`, un `image_url` devuelto por `POST /proxy/krea/assets` (una URL `https://app-uploads.krea.ai/...`) siempre se acepta. Que se acepten otros enlaces depende del entorno; en api.comfy.org actualmente se aceptan. +En `image_urls` de `krea/krea-3`, un `image_url` devuelto por `POST /proxy/krea/assets` (una URL `https://app-uploads.krea.ai/...`) siempre se acepta. Que se acepten otros enlaces depende del entorno; en api.comfy.org actualmente se aceptan. Más de 8 entradas se rechazan con `422` antes de cualquier recuperación, por la comprobación del esquema de la solicitud. -- **Donde se aceptan otros enlaces**, funciona cualquier URL de imagen `https` pública. Router lee el tamaño de cada imagen antes de que se ejecute el modelo: un enlace cuyo host no sea accesible públicamente o no exista, que responda con un `4xx` distinto de `408` o `429`, o que no sea una imagen se rechaza con `400` `invalid_input` indicando su host. Un fallo transitorio de DNS, TLS o de conexión, un tiempo de espera agotado o un `408` o `429` del origen provoca un error `502`. Un enlace de `app-uploads.krea.ai` que no sea una carga activa se rechaza con `400` como cualquier otra referencia no accesible. Justo después de que arranque un servidor, antes de que haya aprendido qué regla se aplica, una URL `https` pública que no sea un enlace de `app-uploads.krea.ai` puede fallar con un `503` que se puede reintentar sin riesgo. -- **Donde no se aceptan otros enlaces**, cada entrada debe ser el `image_url` de una carga. Router solo comprueba que el enlace se analice como una URL `https` cuyo host sea exactamente `app-uploads.krea.ai` (ningún otro host y ningún puerto explícito): cualquier otro enlace, incluida una URL `https` pública que alojes tú mismo, se rechaza con `400` `invalid_input` antes de que se ejecute el modelo. Un enlace que pase esa comprobación pero que no sea una carga activa (expirada, eliminada o escrita incorrectamente) también la supera, y entonces Router no consigue leer el tamaño de la imagen y responde con un error `5xx`, no con un `400`. +- **Donde se aceptan otros enlaces**, funciona cualquier URL de imagen `https` pública. Router recupera cada referencia por sí mismo para leer su tamaño antes de que se ejecute el modelo. Una referencia que tienes que corregir se rechaza con `400` `invalid_input` indicando su host: un host que no existe o no es accesible públicamente, un origen que responde con un `4xx` distinto de `408` o `429`, demasiadas redirecciones, una redirección a un enlace que no es `https` o a un host que no es accesible públicamente, contenido que no es una imagen compatible, una respuesta sin longitud que termina antes del encabezado de tamaño de la imagen, o una imagen cuyo encabezado de tamaño no está dentro de los primeros 2 MiB (ver más abajo). Cualquier otro fallo de recuperación es, en cambio, un error `5xx` (`500` `internal_error` en Router). Algunos de esos fallos se resuelven solos (un error del resolutor DNS, un tiempo de espera agotado, una conexión interrumpida, un origen que responde `5xx`, `408` o `429`, o un host cuya respuesta DNS cambia a una dirección no pública entre la comprobación de host de Router y su conexión, lo que al reintentar puede tener éxito o rechazarse con el `400` para un host no público), así que reinténtalos más tarde. Otros fallan siempre de la misma manera, por ejemplo, un certificado TLS en el que la recuperación no confía (autofirmado, vencido o para el nombre de host incorrecto), o un origen que responde con un `2xx` distinto de `200` o un `3xx` que la recuperación no sigue (como `204`, `206`, `300`, `304` o `305`, o un `301`, `302`, `303`, `307` o `308` sin `Location`). Si un reintento falla de la misma manera, sube la imagen primero. Una solicitud en cola con `POST /v2/models/krea/krea-3/requests` no se reintenta ante tal `5xx` cuando alguno de sus enlaces no es un enlace `app-uploads.krea.ai`, así que vuelve a enviarla tú mismo si la causa puede desaparecer. Un enlace `app-uploads.krea.ai` que no es una subida activa se rechaza con `400` como cualquier otra referencia inaccesible. El `400` de una solicitud en cola solo lleva el detalle genérico `invalid_input`, así que no nombra el host, y la cola no la reintenta. Un `400` en cola puede venir de cualquier campo, no solo de `image_urls` (por ejemplo, un `resolution` o `thinking_mode` no admitido), así que revisa primero los otros campos. Si son válidos, sube cada imagen con `POST /proxy/krea/assets` y vuelve a enviarla con esos valores de `image_url` y una nueva `Idempotency-Key` (o ninguna): reutilizar la clave con un cuerpo modificado se rechaza con `409` `invalid_input`, que no dice nada sobre las imágenes, y reutilizarla con el mismo cuerpo se responde con `201` y el `request_id` original y `Idempotent-Replayed: true`, así que no inicia una nueva ejecución, y su URL de resultado (`GET /v2/models/krea/krea-3/requests/{request_id}`) devuelve el mismo `400` (su URL de estado responde `200` con `error_type` `invalid_input`). Si ese reenvío también falla con `400`, el problema es la propia imagen (por ejemplo, no es una imagen compatible o su encabezado de tamaño no está dentro de los primeros 2 MiB). +- **Donde no se aceptan otros enlaces**, cada entrada debe ser el `image_url` de una subida. Router solo comprueba que el enlace se analice como una URL `https` cuyo host sea exactamente `app-uploads.krea.ai` (ningún otro host y ningún puerto explícito): cualquier otro enlace, incluida una URL `https` pública que alojes tú mismo, se rechaza con `400` `invalid_input` que dice "image_urls must be image_url values returned by POST /proxy/krea/assets" antes de que se ejecute el modelo, así que sube la imagen en su lugar. Un enlace que pasa esa comprobación pero no es una subida activa (vencida, eliminada o mal escrita) aun así la supera, y entonces Router no puede leer el tamaño de la imagen y responde con un error `5xx`, no un `400`. Una imagen subida que Router no puede leer (por ejemplo, no es una imagen compatible o su encabezado de tamaño no está dentro de los primeros 2 MiB) también falla con un `5xx` (`500` `internal_error` en Router) aquí en lugar de un `400`, y el problema sigue siendo la imagen, así que volver a subirla no ayuda. +- **Justo después de que se inicie un servidor**, antes de que haya aprendido qué regla se aplica, cualquier URL `https` que no sea un enlace `app-uploads.krea.ai` puede fallar con un `503` (`service_unavailable` en Router) que es seguro reintentar (una solicitud en cola se reintenta automáticamente ante él). -Subir archivos funciona en todos los entornos, así que es la opción portátil; pasa siempre el `image_url` exactamente tal como lo devolvió la carga. +Router solo lee los primeros 2 MiB de cada referencia para encontrar su tamaño, así que una imagen cuya información de tamaño no puede terminar de leer dentro de esa ventana (por ejemplo, un JPEG que lleva más de 2 MiB de metadatos incrustados, o un PNG con paleta en el que los datos de transparencia, o si no tiene, el inicio de su primer fragmento de datos de imagen, quedan más allá de los 2 MiB, como después de más de 2 MiB de fragmentos de texto o de perfil de color) se rechaza con `400` indicando que su encabezado de tamaño no está dentro de los primeros 2 MiB, y volver a subirla no ayuda: primero vuelve a guardarla sin los metadatos grandes o guarda un PNG con paleta como un PNG sin paleta (color verdadero). Envía un nombre de host internacionalizado en su forma ASCII (punycode), por ejemplo `xn--bcher-kva.de` en lugar de `bücher.de`: Router busca el host tal como está escrito, y un nombre no ASCII se rechaza como un host que no existe. -1. Sube cada imagen de referencia como `multipart/form-data`, con la imagen en el campo de formulario `file` (JPEG, PNG o WebP, hasta 75 MB). Autentícate igual que en Router, con `X-API-Key` o `Authorization: Bearer`. +Subir funciona en todos los entornos, así que es la opción portable; pasa siempre el `image_url` exactamente como lo devolvió la subida. Si tu imagen aún no está en una URL `https` pública, súbela primero:1. Sube cada imagen de referencia como `multipart/form-data`, con la imagen en el campo de formulario `file` (JPEG, PNG o WebP, hasta 75 MB). Autentica de la misma forma que en Router, con `X-API-Key` o `Authorization: Bearer`. ```bash curl -X POST https://api.comfy.org/proxy/krea/assets \ @@ -150,7 +160,7 @@ Subir archivos funciona en todos los entornos, así que es la opción portátil; -F "file=@reference.png" ``` -2. Lee `image_url` de la respuesta JSON y pásalo en `image_urls`: +2. Lee `image_url` de la respuesta JSON y pásala en `image_urls`: ```json { @@ -160,7 +170,7 @@ Subir archivos funciona en todos los entornos, así que es la opción portátil; } ``` -Las llamadas de texto a imagen omiten `image_urls` y no requieren subir nada. +Las llamadas de texto a imagen omiten `image_urls` y no necesitan subir nada. ## Salidas del modelo y recursos almacenados diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 6fe352672d..98aed8290d 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -2,27 +2,27 @@ title: "Modelos de Comfy Router" sidebarTitle: "Todos los modelos" description: "Todos los modelos disponibles en Comfy Router, agrupados por proveedor, con su modalidad de entrada y salida." -translationSourceHash: df7e65a1 +translationSourceHash: 4bd95744 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 4d100975 + "Find by output": 23c1048d "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb "Bria": 052054a1 - "BytePlus": 0767a672 + "BytePlus": 97340104 "Elevenlabs": 7d6dbcc6 "fal": 63e65674 "Freepik": 51b8af46 "Gemini Interactions": 38163caf - "Google": 4932820b + "Google": 77d668ec "HeyGen": 76fe1a0d "Higgsfield": 0ce2b918 "Ideogram": c22a0e5e "Kling": aec38bcd "Krea": 16b83e5e - "LTX": 32595bf9 + "LTX": 413dd527 "Luma": 8cd2a7ce "Luma 2": 585eb637 "Meshy": 67e26a17 @@ -31,7 +31,9 @@ translationBlockHashes: "OpenAI": 8652024f "Openrouter": a4f6806b "Pika": 0cc24098 + "Pixverse": 195092d8 "Pruna": 903d76ee + "Quiver": 34eaad49 "Qwen": b3ef78a1 "Recraft": 02b7d9cd "Runway": be098f8c @@ -45,10 +47,6 @@ translationBlockHashes: "xAI": 38a131b8 --- - - - - {/* ARCHIVO GENERADO. Generado a partir del catálogo del Router por `pnpm code-pages:gen`. */} Todos los modelos que aparecen a continuación se sirven por la misma ruta, `POST /v2/models/{provider}/{model}`, con el cuerpo JSON propio del modelo. Cada página muestra una solicitud funcional en Python, TypeScript y cURL. Para descubrimiento, esquemas, errores, reintentos y facturación, consulta [Usar la API de Comfy Router](/es/development/comfy-router/api). @@ -58,7 +56,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta ## Buscar por salida - + - [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [FLUX 3 Video](/es/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` @@ -74,7 +72,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seedance 1.0 Pro 250528](/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code): `byteplus/seedance-1-0-pro-250528` - [Seedance 1.0 Pro Fast 251015](/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code): `byteplus/seedance-1-0-pro-fast-251015` -- [Seedance 1.5 Pro 251215](/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` - [Crystal Video Upscaler](/es/development/comfy-router/models/fal/crystal-video-upscaler/code): `fal/crystal-video-upscaler` - [FLUX 3 Max](/es/development/comfy-router/models/fal/flux-3-max/code): `fal/flux-3-max` - [H3 Max Turbo](/es/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo` @@ -94,6 +91,10 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Videos Lip Sync](/es/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync` - [LTX 2.5 Fast](/es/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/es/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` +- [LTX Video Alpha Gen](/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code): `ltx/ltx-video-alpha-gen` +- [LTX Video To Video Hdr](/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code): `ltx/ltx-video-to-video-hdr` +- [LTX Video To Video Reframe](/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code): `ltx/ltx-video-to-video-reframe` +- [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code): `ltx/ltx-video-upscale` - [Ray 3.2](/es/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` - [MiniMax H3](/es/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [Image To Video](/es/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` @@ -105,6 +106,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` - [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika Soundtrack](/es/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` +- [V3.5](/es/development/comfy-router/models/pixverse/v3-5/code): `pixverse/v3.5` +- [V6 Max](/es/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max`- [V6](/es/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` - [P Video 2](/es/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/es/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` @@ -141,8 +144,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Grok Imagine Video 1.5 Preview](/es/development/comfy-router/models/xai/grok-imagine-video-1-5-preview/code): `xai/grok-imagine-video-1.5-preview` - [Grok Imagine Video 1.5](/es/development/comfy-router/models/xai/grok-imagine-video-1-5/code): `xai/grok-imagine-video-1.5` - [Grok Imagine Video](/es/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` + - + - [SwitchX](/es/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/es/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -160,8 +164,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Image Edit Erase Foreground](/es/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` - [Image Edit Erase](/es/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` - [Image Edit Expand](/es/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` -- [Image Edit Gen Fill](/es/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` -- [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` +- [Image Edit Gen Fill](/es/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill`- [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/es/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` - [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` @@ -210,9 +213,10 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` -- [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare` -- [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` +- [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare`- [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` - [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` +- [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code): `quiver/arrow-2-telos` +- [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code): `quiver/arrow-2` - [Qwen Image 3.0 Pro](/es/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro` - [Qwen Image 3.0](/es/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0` - [Recraft V2](/es/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2` @@ -259,8 +263,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Wan 2.5 T2I Preview](/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` - [Seedvr 2](/es/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` - [Ultimate Image Upscaler](/es/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` -- [Grok Imagine Image 2.0](/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0` -- [Grok Imagine Image Pro](/es/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` +- [Grok Imagine Image 2.0](/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0`- [Grok Imagine Image Pro](/es/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` - [Grok Imagine Image Quality](/es/development/comfy-router/models/xai/grok-imagine-image-quality/code): `xai/grok-imagine-image-quality` - [Grok Imagine Image](/es/development/comfy-router/models/xai/grok-imagine-image/code): `xai/grok-imagine-image` @@ -274,7 +277,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code): `byteplus/dreamina-seedance-2-5-260628` - [Seed Audio 1.0 Multilingual](/es/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual` - [Seed Audio 1.0](/es/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0` -- [Seedance 1.5 Pro 251215](/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215` - [Eleven Multilingual V2](/es/development/comfy-router/models/elevenlabs/eleven-multilingual-v2/code): `elevenlabs/eleven_multilingual_v2` - [Eleven Sfx V2](/es/development/comfy-router/models/elevenlabs/eleven-sfx-v2/code): `elevenlabs/eleven_sfx_v2` - [Eleven V3](/es/development/comfy-router/models/elevenlabs/eleven-v3/code): `elevenlabs/eleven_v3` @@ -290,6 +292,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Higgsfield Kling 3 Pro](/es/development/comfy-router/models/higgsfield/higgsfield-kling-3-pro/code): `higgsfield/higgsfield-kling-3-pro` - [LTX 2.5 Fast](/es/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/es/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` +- [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code): `ltx/ltx-video-upscale` - [MiniMax H3](/es/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code): `pika/pika-h3-flex-image-to-video` - [Pika H3 Flex Reference To Video](/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code): `pika/pika-h3-flex-reference-to-video` @@ -320,8 +323,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Animations](/es/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/es/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` -- [Meshy 7.1](/es/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` -- [Meshy 7](/es/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` +- [Meshy 7.1](/es/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1`- [Meshy 7](/es/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` - [Remesh](/es/development/comfy-router/models/meshy/remesh/code): `meshy/remesh` - [Rigging](/es/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` @@ -332,7 +334,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Hunyuan 3D Uv](/es/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/es/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/es/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -356,6 +358,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Gemini 3.1 Flash Lite](/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code): `vertexai/gemini-3.1-flash-lite` - [Gemini 3.7 Flash](/es/development/comfy-router/models/google/gemini-3-7-flash/code): `vertexai/gemini-3.7-flash` - [Gemini 3.8 Flash](/es/development/comfy-router/models/google/gemini-3-8-flash/code): `vertexai/gemini-3.8-flash` +- [Gemini 4 Argon](/es/development/comfy-router/models/google/gemini-4-argon/code): `vertexai/gemini-4-argon` +- [Gemini 4 Carbon](/es/development/comfy-router/models/google/gemini-4-carbon/code): `vertexai/gemini-4-carbon` +- [Gemini 4 Hydrogen](/es/development/comfy-router/models/google/gemini-4-hydrogen/code): `vertexai/gemini-4-hydrogen` - [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code): `vertexai/gemini-nano-banana-2.1` - [Google Gemini](/es/development/comfy-router/models/google/gemini/code): `vertexai/gemini-3.1-pro-preview` - [Nano Banana 2 Lite](/es/development/comfy-router/models/google/nano-banana-2-lite/code): `vertexai/gemini-3.1-flash-lite-image` @@ -373,8 +378,7 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT 5 Nano](/es/development/comfy-router/models/openai/gpt-5-nano/code): `openai/gpt-5-nano` - [GPT 5](/es/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6.1 Sol](/es/development/comfy-router/models/openai/gpt-6-1-sol/code): `openai/gpt-6.1-sol` -- [GPT 6.1 Terra](/es/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra` -- [GPT 6 Astra](/es/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` +- [GPT 6.1 Terra](/es/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra`- [GPT 6 Astra](/es/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/es/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/es/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` - [o3](/es/development/comfy-router/models/openai/o3/code): `openai/o3` @@ -445,10 +449,10 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [Image Edit Reseason](/es/development/comfy-router/models/bria/image-edit-reseason/code) | `bria/image-edit-reseason` | Imagen, Texto | Imagen | | [Image Edit Restore](/es/development/comfy-router/models/bria/image-edit-restore/code) | `bria/image-edit-restore` | Imagen | Imagen | | [Image](/es/development/comfy-router/models/bria/image/code) | `bria/image` | Texto, Imagen | Imagen | -| [Video Edit Erase](/es/development/comfy-router/models/bria/video-edit-erase/code) | `bria/video-edit-erase` | video | video | -| [Video Edit Green Screen](/es/development/comfy-router/models/bria/video-edit-green-screen/code) | `bria/video-edit-green-screen` | video | video | -| [Video Edit Remove Background](/es/development/comfy-router/models/bria/video-edit-remove-background/code) | `bria/video-edit-remove-background` | video | video | -| [Video Edit Replace Background](/es/development/comfy-router/models/bria/video-edit-replace-background/code) | `bria/video-edit-replace-background` | video, Texto | video | +| [Video Edit Erase](/es/development/comfy-router/models/bria/video-edit-erase/code) | `bria/video-edit-erase` | Video | Video | +| [Video Edit Green Screen](/es/development/comfy-router/models/bria/video-edit-green-screen/code) | `bria/video-edit-green-screen` | Video | Video | +| [Video Edit Remove Background](/es/development/comfy-router/models/bria/video-edit-remove-background/code) | `bria/video-edit-remove-background` | Video | Video | +| [Video Edit Replace Background](/es/development/comfy-router/models/bria/video-edit-replace-background/code) | `bria/video-edit-replace-background` | Video, Texto | Video | ## BytePlus @@ -465,7 +469,6 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [Seed Audio 1.0](/es/development/comfy-router/models/byteplus/seed-audio-1-0/code) | `byteplus/seed-audio-1.0` | Texto | Audio | | [Seedance 1.0 Pro 250528](/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code) | `byteplus/seedance-1-0-pro-250528` | Texto, Imagen | Video | | [Seedance 1.0 Pro Fast 251015](/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code) | `byteplus/seedance-1-0-pro-fast-251015` | Texto, Imagen | Video | -| [Seedance 1.5 Pro 251215](/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code) | `byteplus/seedance-1-5-pro-251215` | Texto, Imagen | Video + Audio | | [Seedream 4.0 250828](/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code) | `byteplus/seedream-4-0-250828` | Texto, Imagen | Imagen | | [Seedream 4.5 251128](/es/development/comfy-router/models/byteplus/seedream-4-5-251128/code) | `byteplus/seedream-4-5-251128` | Texto, Imagen | Imagen | | [Seedream 5.0 260128](/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code) | `byteplus/seedream-5-0-260128` | Texto, Imagen | Imagen | @@ -519,6 +522,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [Gemini 3.1 Flash Lite](/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | Texto, Imagen, Audio, Video | Texto | | [Gemini 3.7 Flash](/es/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | Texto, Imagen, Audio, Video | Texto | | [Gemini 3.8 Flash](/es/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | Texto, Imagen, Audio, Video | Texto | +| [Gemini 4 Argon](/es/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | Texto, Imagen, Audio, Video | Texto | +| [Gemini 4 Carbon](/es/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | Texto, Imagen, Audio, Video | Texto | +| [Gemini 4 Hydrogen](/es/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | Texto, Imagen, Audio, Video | Texto | | [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | `vertexai/gemini-nano-banana-2.1` | Texto, Imagen, Video | Imagen + Texto | | [Google Gemini](/es/development/comfy-router/models/google/gemini/code) | `vertexai/gemini-3.1-pro-preview` | Texto, Imagen, Audio, Video | Texto | | [Nano Banana 2 Lite](/es/development/comfy-router/models/google/nano-banana-2-lite/code) | `vertexai/gemini-3.1-flash-lite-image` | Texto, Imagen, Video | Imagen + Texto | @@ -579,6 +585,10 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | --- | --- | --- | --- | | [LTX 2.5 Fast](/es/development/comfy-router/models/ltx/ltx-2-5-fast/code) | `ltx/ltx-2-5-fast` | Texto | Video + Audio | | [LTX 2.5 Pro](/es/development/comfy-router/models/ltx/ltx-2-5-pro/code) | `ltx/ltx-2-5-pro` | Texto | Video + Audio | +| [LTX Video Alpha Gen](/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | Video | Video | +| [LTX Video To Video Hdr](/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | Video | Video | +| [LTX Video To Video Reframe](/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | Video | Video | +| [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | Video | Video + Audio | ## Luma @@ -618,9 +628,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | -| [Image To Video](/es/development/comfy-router/models/moonvalley/image-to-video/code) | `moonvalley/image-to-video` | Imagen, Texto | Video | -| [Text To Video](/es/development/comfy-router/models/moonvalley/text-to-video/code) | `moonvalley/text-to-video` | Texto | Video | -| [Video To Video](/es/development/comfy-router/models/moonvalley/video-to-video/code) | `moonvalley/video-to-video` | Video, Texto | Video | +| [Imagen a video](/es/development/comfy-router/models/moonvalley/image-to-video/code) | `moonvalley/image-to-video` | Imagen, Texto | Video | +| [Texto a video](/es/development/comfy-router/models/moonvalley/text-to-video/code) | `moonvalley/text-to-video` | Texto | Video | +| [Video a video](/es/development/comfy-router/models/moonvalley/video-to-video/code) | `moonvalley/video-to-video` | Video, Texto | Video | ## OpenAI @@ -673,9 +683,9 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | -| [V3.5](/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | Texto | Video | -| [V6 Max](/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | Texto | Video | -| [V6](/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | Texto | Video | +| [V3.5](/es/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | Texto | Video | +| [V6 Max](/es/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | Texto | Video | +| [V6](/es/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | Texto | Video | ## Pruna @@ -687,8 +697,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | Modelo | ID | Entrada | Salida | | --- | --- | --- | --- | -| [Arrow 2 Telos](/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Texto, Imagen | Imagen | -| [Arrow 2](/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Texto, Imagen | Imagen | +| [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Texto, Imagen | Imagen | +| [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Texto, Imagen | Imagen | ## Qwen @@ -737,19 +747,19 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta | [Edit Erase](/es/development/comfy-router/models/stability/edit-erase/code) | `stability/edit-erase` | Imagen | Imagen | | [Edit Inpaint](/es/development/comfy-router/models/stability/edit-inpaint/code) | `stability/edit-inpaint` | Texto, Imagen | Imagen | | [Edit Outpaint](/es/development/comfy-router/models/stability/edit-outpaint/code) | `stability/edit-outpaint` | Texto, Imagen | Imagen | -| [Edit Eliminar fondo](/es/development/comfy-router/models/stability/edit-remove-background/code) | `stability/edit-remove-background` | Imagen | Imagen | -| [Edit Reemplazar fondo y reiluminar](/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code) | `stability/edit-replace-background-and-relight` | Texto, Imagen | Imagen | -| [Edit Buscar y recolorear](/es/development/comfy-router/models/stability/edit-search-and-recolor/code) | `stability/edit-search-and-recolor` | Texto, Imagen | Imagen | -| [Edit Buscar y reemplazar](/es/development/comfy-router/models/stability/edit-search-and-replace/code) | `stability/edit-search-and-replace` | Texto, Imagen | Imagen | -| [Generar Core](/es/development/comfy-router/models/stability/generate-core/code) | `stability/generate-core` | Texto | Imagen | -| [Generar Ultra](/es/development/comfy-router/models/stability/generate-ultra/code) | `stability/generate-ultra` | Texto, Imagen | Imagen | +| [Edit Remove Background](/es/development/comfy-router/models/stability/edit-remove-background/code) | `stability/edit-remove-background` | Imagen | Imagen | +| [Edit Replace Background And Relight](/es/development/comfy-router/models/stability/edit-replace-background-and-relight/code) | `stability/edit-replace-background-and-relight` | Texto, Imagen | Imagen | +| [Edit Search And Recolor](/es/development/comfy-router/models/stability/edit-search-and-recolor/code) | `stability/edit-search-and-recolor` | Texto, Imagen | Imagen | +| [Edit Search And Replace](/es/development/comfy-router/models/stability/edit-search-and-replace/code) | `stability/edit-search-and-replace` | Texto, Imagen | Imagen | +| [Generate Core](/es/development/comfy-router/models/stability/generate-core/code) | `stability/generate-core` | Texto | Imagen | +| [Generate Ultra](/es/development/comfy-router/models/stability/generate-ultra/code) | `stability/generate-ultra` | Texto, Imagen | Imagen | | [Sd3.5 Flash](/es/development/comfy-router/models/stability/sd3-5-flash/code) | `stability/sd3.5-flash` | Texto, Imagen | Imagen | | [Sd3.5 Large Turbo](/es/development/comfy-router/models/stability/sd3-5-large-turbo/code) | `stability/sd3.5-large-turbo` | Texto, Imagen | Imagen | | [Sd3.5 Large](/es/development/comfy-router/models/stability/sd3-5-large/code) | `stability/sd3.5-large` | Texto, Imagen | Imagen | | [Sd3.5 Medium](/es/development/comfy-router/models/stability/sd3-5-medium/code) | `stability/sd3.5-medium` | Texto, Imagen | Imagen | -| [Sdxl 1.0 Imagen a imagen](/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code) | `stability/sdxl-1.0-image-to-image` | Texto, Imagen | Imagen | +| [Sdxl 1.0 Image To Image](/es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code) | `stability/sdxl-1.0-image-to-image` | Texto, Imagen | Imagen | | [Sdxl 1.0 Masking](/es/development/comfy-router/models/stability/sdxl-1-0-masking/code) | `stability/sdxl-1.0-masking` | Texto, Imagen | Imagen | -| [Sdxl 1.0 Texto a imagen](/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code) | `stability/sdxl-1.0-text-to-image` | Texto | Imagen | +| [Sdxl 1.0 Text To Image](/es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code) | `stability/sdxl-1.0-text-to-image` | Texto | Imagen | | [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code) | `stability/stable-fast-3d` | Imagen | 3D | | [Stable Point Aware 3D](/es/development/comfy-router/models/stability/stable-point-aware-3d/code) | `stability/stable-point-aware-3d` | Imagen | 3D | | [Upscale Conservative](/es/development/comfy-router/models/stability/upscale-conservative/code) | `stability/upscale-conservative` | Texto, Imagen | Imagen | diff --git a/es/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx b/es/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx index 02f21e8c1e..caac4a6b6c 100644 --- a/es/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Fable 5.1 con Comfy Router" description: "Llama a anthropic/claude-fable-5-1 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Fable 5.1" -translationSourceHash: 0c17cbf0 +translationSourceHash: 72432b96 translationFrom: development/comfy-router/models/anthropic/claude-fable-5-1/code.mdx translationBlockHashes: "_intro": d52eb513 "Quick start": 66ea5c23 - "Schema": d2c6492b + "Schema": 9180e71b "Examples": e6e3e477 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-fable-5-1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -170,7 +171,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5-1/requests/$REQUES ### Entrada - Número máximo de tokens que se generan antes de detenerse. + Número máximo de tokens a generar antes de detenerse. @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5-1/requests/$REQUES - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un solo cuerpo JSON. + En la ruta `POST /v2/models/anthropic/{model}` de Comfy Router, `stream` es INERTE: Router lo fija en `false` antes del despacho y siempre devuelve el mensaje completado como un solo documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un solo cuerpo JSON. Envía `stream` en false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. @@ -258,7 +259,7 @@ Proviene del esquema que Router expone en `GET /v2/models/anthropic/claude-fable - Los bloques de contenido de la respuesta, en orden. Presentes en todos los mensajes completados; vacíos cuando el turno no produjo nada. + Los bloques de contenido de la respuesta, en orden. Presentes en todo mensaje completado; vacíos cuando el turno no produjo nada. diff --git a/es/development/comfy-router/models/anthropic/claude-fable-5/code.mdx b/es/development/comfy-router/models/anthropic/claude-fable-5/code.mdx index 80d75bec9a..26e22bbc91 100644 --- a/es/development/comfy-router/models/anthropic/claude-fable-5/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-fable-5/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Fable 5 con Comfy Router" description: "Llama a anthropic/claude-fable-5 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Fable 5" -translationSourceHash: 2b085858 +translationSourceHash: fac73389 translationFrom: development/comfy-router/models/anthropic/claude-fable-5/code.mdx translationBlockHashes: "_intro": 5f3f65cf "Quick start": bffec245 - "Schema": 15962b1f + "Schema": fb6e12b6 "Examples": d4496b58 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-fable-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-fable-5/requests/$REQUEST_ - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta `POST /v2/models/anthropic/{model}` de Comfy Router, `stream` es INERTE: Router lo FIJA en `false` antes de enviar la solicitud y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` convierte la respuesta en un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` en false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx b/es/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx index 4b3802d35f..ea1eb06907 100644 --- a/es/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Haiku 4.5 20251001 con Comfy Router" description: "Llama a anthropic/claude-haiku-4-5-20251001 con Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Claude Haiku 4.5 20251001" -translationSourceHash: dd8d78f3 +translationSourceHash: eb49608c translationFrom: development/comfy-router/models/anthropic/claude-haiku-4-5-20251001/code.mdx translationBlockHashes: "_intro": bf2f46fc "Quick start": 5526f5fd - "Schema": 9679eecf + "Schema": 1e6040f8 "Examples": 18cca7af --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-haiku-4-5-20251001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-haiku-4-5-20251001/request - Una cadena como forma abreviada o un arreglo de bloques de contenido (text, image, document, tool_use, tool_result, ...). + Ya sea una cadena abreviada o un arreglo de bloques de contenido (text, image, document, tool_use, tool_result, ...). @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-haiku-4-5-20251001/request - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta `POST /v2/models/anthropic/{model}` de Comfy Router, `stream` es INERTE: Router lo FIJA en `false` antes del envío y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` con el valor false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx b/es/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx index a102a13fd0..a7a7d9aaf1 100644 --- a/es/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Opus 4.6 con Comfy Router" description: "Llama a anthropic/claude-opus-4-6 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Opus 4.6" -translationSourceHash: 93ccca91 +translationSourceHash: cb5d7e2f translationFrom: development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx translationBlockHashes: "_intro": a1da9d27 "Quick start": 642b5091 - "Schema": d3b6797e + "Schema": c13974e1 "Examples": 2cc5500c --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-opus-4-6.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-6/requests/$REQUEST - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta `POST /v2/models/anthropic/{model}` de Comfy Router, `stream` es INERTE: Router lo FIJA en `false` antes del despacho y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` como false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación de `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx b/es/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx index 891558deaa..8d0a7aeb84 100644 --- a/es/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Opus 4.7 con Comfy Router" description: "Llama a anthropic/claude-opus-4-7 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Opus 4.7" -translationSourceHash: 274ad2a2 +translationSourceHash: 75f77626 translationFrom: development/comfy-router/models/anthropic/claude-opus-4-7/code.mdx translationBlockHashes: "_intro": 9c9cb89b "Quick start": 8bed0f96 - "Schema": 69d553ae + "Schema": 64cc6da3 "Examples": 8eadda7c --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/anthropic/claude-opus-4-7.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-7/requests/$REQUEST - Cuando es `true`, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta de Comfy Router `POST /v2/models/anthropic/{model}`, `stream` es INERTE: Router lo FIJA en `false` antes del despacho y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` como false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx b/es/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx index c34b9576c5..970871d7be 100644 --- a/es/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Opus 4.8 con Comfy Router" description: "Llama a anthropic/claude-opus-4-8 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Opus 4.8" -translationSourceHash: aef515bf +translationSourceHash: 4aae8e49 translationFrom: development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx translationBlockHashes: "_intro": 74fdd245 "Quick start": 874f5aef - "Schema": 0519e19d + "Schema": f74f93ff "Examples": 07251ae9 --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/anthropic/claude-opus-4-8.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-4-8/requests/$REQUEST - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un solo cuerpo JSON. + En la ruta de Comfy Router `POST /v2/models/anthropic/{model}`, `stream` es INERTE: Router lo FIJA en `false` antes del despacho y siempre devuelve el mensaje completado como un solo documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un solo cuerpo JSON. Envía `stream` como false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx b/es/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx index d41f8b89c0..dd4ac6b146 100644 --- a/es/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Opus 5.5 con Comfy Router" description: "Llama a anthropic/claude-opus-5-5 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Opus 5.5" -translationSourceHash: 84c96ea2 +translationSourceHash: 9b019780 translationFrom: development/comfy-router/models/anthropic/claude-opus-5-5/code.mdx translationBlockHashes: "_intro": ae2af968 "Quick start": c6539c4b - "Schema": 3c0dd311 + "Schema": 1dca9f7c "Examples": fd6d9b8d --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/anthropic/claude-opus-5-5.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -178,7 +179,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5-5/requests/$REQUEST - Ya sea una forma abreviada en cadena o un arreglo de bloques de contenido (texto, imagen, documento, tool_use, tool_result, ...). + Ya sea una cadena abreviada o un arreglo de bloques de contenido (texto, imagen, documento, tool_use, tool_result, ...). @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5-5/requests/$REQUEST - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta `POST /v2/models/anthropic/{model}` de Comfy Router, `stream` es INERTE: Router lo FIJA en `false` antes del despacho y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` en `false` u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-opus-5/code.mdx b/es/development/comfy-router/models/anthropic/claude-opus-5/code.mdx index 8f779080f1..f94851ae0e 100644 --- a/es/development/comfy-router/models/anthropic/claude-opus-5/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-opus-5/code.mdx @@ -2,15 +2,16 @@ title: "Usa Claude Opus 5 con Comfy Router" description: "Llama a anthropic/claude-opus-5 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Opus 5" -translationSourceHash: d5eb64ff +translationSourceHash: 3c1df63d translationFrom: development/comfy-router/models/anthropic/claude-opus-5/code.mdx translationBlockHashes: "_intro": 8a45f373 "Quick start": 2f41262e - "Schema": 8006be48 + "Schema": eabb47c6 "Examples": 6926a739 --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/anthropic/claude-opus-5.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -191,7 +192,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-opus-5/requests/$REQUEST_I - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta de Comfy Router `POST /v2/models/anthropic/{model}`, `stream` es INERTE: Router lo FIJA en `false` antes del despacho y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx b/es/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx index af8b49de34..7fb3d18b59 100644 --- a/es/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Sonnet 4.5 20250929 con Comfy Router" description: "Llama a anthropic/claude-sonnet-4-5-20250929 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Sonnet 4.5 20250929" -translationSourceHash: af2be0cb +translationSourceHash: f146cae8 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code.mdx translationBlockHashes: "_intro": e5d80e67 "Quick start": c93ab6db - "Schema": c0b4e9c3 + "Schema": 14769c2e "Examples": 78b06084 --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/anthropic/claude-sonnet-4-5-20250929.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-5-20250929/reques - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta `POST /v2/models/anthropic/{model}` de Comfy Router, `stream` es INERTE: Router lo FIJA en `false` antes del despacho y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` como `false` u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx b/es/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx index dd6a71d642..c463db1ed7 100644 --- a/es/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Sonnet 4.6 con Comfy Router" description: "Llama a anthropic/claude-sonnet-4-6 con Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Claude Sonnet 4.6" -translationSourceHash: 9d3bf586 +translationSourceHash: 51c4d648 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-4-6/code.mdx translationBlockHashes: "_intro": e6f03e00 "Quick start": c2210e0e - "Schema": 7e4df7aa + "Schema": 9c28d0e8 "Examples": 7fb5285d --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-4-6.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -190,11 +191,11 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-4-6/requests/$REQUE - Cuando es `true`, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta `POST /v2/models/anthropic/{model}` de Comfy Router, `stream` es inerte: Router lo fija en `false` antes de despachar la solicitud y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` como false u omítelo en Router; la parte `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. - prompt de sistema de nivel superior. Ya sea una cadena o un arreglo de bloques de contenido; ambos llegan a Anthropic sin cambios. + Prompt de sistema de nivel superior. Ya sea una cadena o un arreglo de bloques de contenido; ambos llegan a Anthropic sin cambios. Generado a partir del esquema que Router sirve en `GET /v2/models/anthropic/claude-sonnet-4-6/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. diff --git a/es/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx b/es/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx index 51f4df322d..3093640349 100644 --- a/es/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx @@ -2,14 +2,15 @@ title: "Usa Claude Sonnet 5.5 con Comfy Router" description: "Llama a anthropic/claude-sonnet-5-5 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Sonnet 5.5" -translationSourceHash: 021cc189 +translationSourceHash: f0a03fa9 translationFrom: development/comfy-router/models/anthropic/claude-sonnet-5-5/code.mdx translationBlockHashes: "_intro": f09ded46 "Quick start": b8433ece - "Schema": 3a226e7f + "Schema": e5d10df7 "Examples": f08878ed --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-5-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -190,7 +191,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-5-5/requests/$REQUE - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta de Comfy Router `POST /v2/models/anthropic/{model}`, `stream` es INERTE: Router lo FIJA en `false` antes del despacho y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` en false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación de `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx b/es/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx index 3c08010a9c..067690649f 100644 --- a/es/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx +++ b/es/development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx @@ -2,15 +2,16 @@ title: "Usa Claude Sonnet 5 con Comfy Router" description: "Llama a anthropic/claude-sonnet-5 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Claude Sonnet 5" -translationSourceHash: a4550d3d +translationSourceHash: 6752140c translationFrom: development/comfy-router/models/anthropic/claude-sonnet-5/code.mdx translationBlockHashes: "_intro": 9027b350 "Quick start": 23b1d5d3 - "Schema": ed894fd9 + "Schema": a6d8a431 "Examples": a3ab5037 --- + {/* GENERATED FILE. Generated from router-schemas/anthropic/claude-sonnet-5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -191,7 +192,7 @@ curl https://api.comfy.org/v2/models/anthropic/claude-sonnet-5/requests/$REQUEST - Cuando es verdadero, la respuesta es un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. + En la ruta `POST /v2/models/anthropic/{model}` de Comfy Router, `stream` es INERTE: Router lo FIJA en `false` antes del despacho y siempre devuelve el mensaje completado como un único documento JSON. En la ruta v1 `POST /proxy/anthropic/v1/messages`, `true` hace que la respuesta sea un `text/event-stream` de eventos de mensaje de Anthropic en lugar de un único cuerpo JSON. Envía `stream` con false u omítelo en Router; la mitad `text/event-stream` del 200 de la operación `/proxy/` no tiene equivalente en Router. diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 5395311f8e..d00977806a 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,16 +2,17 @@ title: "Usa Dreamina Seedance 2.0 260128 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-260128 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: a3a29c99 +translationSourceHash: 63aaaa35 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 - "Serving providers": 74eb2a7c - "Schema": 9c7c68b7 + "Serving providers": 6d20a079 + "Schema": 3b5d80d0 "Examples": 641c458b --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -182,6 +183,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128` - **fal**, como `fal/fal-seedance-2.0`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=fal` - **Higgsfield**, como `higgsfield/higgsfield-seedance-2.0`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=higgsfield` +- **Kelly**, como `kelly/kelly-seedance-2.0`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=kelly` - **Pika**, como `pika/pika-seedance-2.0`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=pika` - **Runware**, como `runware/runware-seedance-2.0`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=runware` - **WaveSpeed**, como `wavespeed/wavespeed-seedance-2.0`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128?model_provider=wavespeed` @@ -193,33 +195,33 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot ### Entrada - Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; consulta la ruta de estado de la tarea para obtener el resultado. + Se ignora. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` - El contenido de entrada para que el modelo genere un video + El contenido de entrada que el modelo usará para generar un video - Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar solo audio: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. + Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar audio por sí solo: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. - URL de audio, codificación Base64 o ID de recurso. + URL de audio, codificación Base64 o Asset ID. URL de audio: URL pública del audio (wav, mp3). -Base64: Formato data:audio/\;base64,\ -ID de recurso: Formato asset://\ +Base64: formato data:audio/\;base64,\ +Asset ID: formato asset://\ - Solo para Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. + Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. +El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type; no los envíes de nuevo. Establece resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. - El ID de tarea devuelto cuando se creó el video Draft con `draft` establecido en true. + El ID de tarea que se devuelve cuando el video Draft se creó con `draft` establecido en true. @@ -228,13 +230,13 @@ El video final reutiliza el prompt, los recursos de entrada, la duración, la re Contenido de imagen para la generación de imagen a video (cuando type es "image_url") -URL de imagen: Asegúrate de que la URL de la imagen sea accesible. -Contenido codificado en Base64: El formato debe ser data:image/\;base64,\ -ID de recurso: Formato asset://\ +URL de la imagen: asegúrate de que la URL de la imagen sea accesible. +Contenido codificado en Base64: el formato debe ser data:image/\;base64,\ +Asset ID: formato asset://\ - El rol o la posición del elemento de contenido. + El rol/posición del elemento de contenido. Para imágenes: first_frame, last_frame o reference_image. Para videos: reference_video (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). @@ -243,11 +245,11 @@ Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). - El texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales. + La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales. -Prompt de texto (requerido): Descripción del video que se generará usando caracteres chinos e ingleses. +Prompt de texto (requerido): descripción del video que se va a generar usando caracteres chinos e ingleses. -Parámetros (opcional): Agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: +Parámetros (opcional): agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: - --resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (predeterminado: 16:9 o adaptive) - --duration (--dur): 3-12 segundos (predeterminado: 5) @@ -258,15 +260,9 @@ Parámetros (opcional): Agrega --[parameters] después del prompt de texto para Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Límite de seguridad del lado de Comfy, no una restricción de BytePlus. BytePlus no publica un -límite de longitud de texto y aceptó 40.000 caracteres en las pruebas (2026-09-17). -Cuenta caracteres, no bytes, por lo que un prompt multibyte puede ser varias -veces mayor en la transmisión. Limita este campo, no la solicitud: -`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita -todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie -que lo aplica; en una llamada directa a v1 /proxy, el validador propio de BytePlus -responde en su lugar. Se estableció muy por encima del tráfico real para que nunca -sea el que determine la validez de un prompt genuino; auméntalo si un cliente necesita más. +Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no publica ningún límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). +Cuenta caracteres, no bytes, así que un prompt multibyte puede ser varias veces este tamaño en la transmisión. Limita este único campo, no la solicitud: +`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de BytePlus. Está establecido muy por encima del tráfico real para que nunca juzgue un prompt genuino; auméntalo si un cliente necesita más. @@ -280,13 +276,13 @@ sea el que determine la validez de un prompt genuino; auméntalo si un cliente n - URL de video o ID de recurso. + URL de video o Asset ID. URL de video: URL pública del video (mp4, mov). -ID de recurso: Formato asset://\ +Asset ID: formato asset://\ - Solo para Seedance 2.5. Genera un video Draft en 480p; la resolución debe ser 480p. + Solo Seedance 2.5. Genera un video Draft en 480p; la resolución debe ser 480p. Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; cuando se omite resolution, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -297,61 +293,61 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende - Umbral de tiempo de espera de la tarea en segundos. Valor predeterminado 172800 (48 h). Alcance: [3600, 259200]. + Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Alcance: [3600, 259200]. Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. -true: El modelo genera un video con audio sincronizado. -false: El modelo genera un video silencioso.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +true: el modelo produce un video con audio sincronizado. +false: el modelo produce un video silencioso.En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada de forma independiente del video: un rechazo ahí se informa como `content_policy_violation` y, dado que el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otras condiciones. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. - El ID del modelo que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo; el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama al Router lo omite. + El ID del modelo al que llamar. Modelos admitidos: 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 y dreamina-seedance-2-5-260628. Una llamada v1 directa a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza con un 400 cualquier otro valor, y también su omisión. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama al Router lo omite. - Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. -reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. -edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). + Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitirlo significa automático: el modelo infiere la tarea a partir del prompt y del medio de referencia, y un ajuste que entre en conflicto con su lectura (como `duration` o `ratio` en lo que interpreta como una edición) se resuelve solo después de que la generación haya comenzado, lo cual se factura. +reference: Genera un nuevo video con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del clip fuente, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. -Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. +El proveedor valida un valor explícito al enviar (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), así que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; automático no tiene esa comprobación. Esa comprobación se ejecuta solo en la rama nativa de BytePlus: una rama de proveedor alternativo (en fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por sí mismo, igual que con automático. El descarte se declara en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una rama alternativa mediante `model_provider`. - Valores posibles: `reference`, `edit`, `extend` + Posibles valores: `reference`, `edit`, `extend` Solo Seedance 2.5. Formato de contenedor del video de salida. -mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y un tamaño de archivo menor. -mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; tamaño de archivo mayor. +mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. +mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para postproducción; mayor tamaño de archivo. - Valores posibles: `mp4`, `mov` + Posibles valores: `mp4`, `mov` - Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro por defecto: adaptive. -Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. + Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro predeterminada: adaptive. +Seedance 2.5 con generación de primer fotograma / primer y último fotograma: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. - Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + Posibles valores: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. + Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite predeterminada: 720p. Seedance 1.0 pro y pro-fast predeterminada: 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. - Valores posibles: `480p`, `720p`, `1080p`, `4k` + Posibles valores: `480p`, `720p`, `1080p`, `4k` - Indica si se devuelve la imagen del último fotograma del video generado. -true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. + Si se devuelve la imagen del último fotograma del video generado. +true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a Consultar la información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. - Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. + Entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. Alcance: `-1` a `4294967295` @@ -359,53 +355,53 @@ false: No devuelve la imagen del último fotograma del video generado. Nivel de servicio para el procesamiento. Seedance 2.5, 2.0 y 2.0 fast no admiten flex (inferencia sin conexión). - Valores posibles: `default`, `flex` + Posibles valores: `default`, `flex` - Indica si el video generado incluye una marca de agua. + Si el video generado incluye una marca de agua. -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se REALOJAN en el almacenamiento de Comfy; cualquier otro campo de aquí es propio de BytePlus. Anulable: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o nulo. + La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus devuelve una, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se vuelven a alojar en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Puede ser nulo: BytePlus borra las URL 24 horas después de la tarea, y un documento exitoso consultado después de eso puede presentar `content` ausente o nulo. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router realoja los bytes que reciba y les asigna un tipo a partir del Content-Type del proveedor o de una detección por contenido, y `image/jpeg` es solo el último recurso cuando ambas fallan. Router realoja el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memo de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga para el último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type upstream o de un análisis del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas. Se firma por 24 horas al emitirse y se reproduce desde un memo de 23 horas; por lo tanto, una consulta posterior puede devolver una con tan solo una hora restante. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. + Hora RFC 3339 en la que las URL upstream dejan de funcionar: la hora de firma más temprana más la vigencia que las propias URL conllevan, nunca más tarde que `updated_at` de la tarea más 24 horas (la vida útil de URL documentada por BytePlus) cuando `updated_at` está presente; de lo contrario, `updated_at` de la tarea más 24 horas. Presente solo cuando `upstream_video_url` o `upstream_last_frame_url` están presentes, y se omite cuando ninguna de las dos fuentes proporciona una hora. No está relacionado con la vigencia de `video_url` / `last_frame_url` realojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a `last_frame_url` realojada en los mismos términos que `upstream_video_url`: solo espacios de trabajo que hayan optado por ello, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio realojamiento de Router. + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado del lado del servidor (no hay ningún parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at` y, en Seedance 2.5, BytePlus la limita a 100 descargas, una de las cuales consume el propio realojamiento de Router. - URL de descarga del video de salida. Router realoja el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memo de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga para el video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas. Se firma por 24 horas al emitirse y se reproduce desde un memo de 23 horas; por lo tanto, una consulta posterior puede devolver una con tan solo una hora restante. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. - La hora en que se creó la tarea. El valor es un timestamp UNIX en segundos. + La hora en que se creó la tarea. El valor es una marca de tiempo UNIX en segundos. - La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. + La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y que las superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Es un campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. @@ -413,31 +409,31 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas HTTP 200 de tareas fallidas, sin sobrescribir los fallos de transporte. + Código de error upstream de ModelArk. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en sobres de error HTTP 400 y en respuestas de tarea fallida con HTTP 200 sin sobrescribir los fallos de transporte. - El mensaje de error + Mensaje de error - + El ID de la tarea de generación de video - El nombre y la versión del modelo usado por la tarea + El nombre y la versión del modelo que usa la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde la consulta de la tarea de video de Seedance lo devuelve. Campo propio de BytePlus, reenviado sin cambios. - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. + La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en tareas de video exitosas y reenviado sin cambios. - La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. + La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus, devuelto en tareas de video exitosas y reenviado sin cambios. Formato: `int64` @@ -449,7 +445,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La hora de la última actualización de la tarea. El valor es un timestamp UNIX en segundos. + La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. @@ -457,11 +453,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - El número de tokens generados por el modelo + La cantidad de tokens generados por el modelo - Para el modelo de generación de video, el número de tokens de entrada no se calcula y es 0 por defecto. Por lo tanto, total_tokens = completion_tokens. + En el caso del modelo de generación de video, la cantidad de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. ## Ejemplos diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 8ac885d3f7..0a399209b6 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,12 +2,13 @@ title: "Usa Dreamina Seedance 2.0 Fast 260128 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-fast-260128 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: 506a7f86 +translationSourceHash: fd645dad translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": 48fe2811 + "Serving providers": dfa238a4 + "Schema": bb84c022 "Examples": 7714eccd --- @@ -109,7 +110,7 @@ async def main(): "resolution": "720p", }, ) - print("request_id:", handle.request_id) # junto con el model ID, es todo lo que otro proceso necesita + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que otro proceso necesita # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. async for update in handle.iter_events(): @@ -140,7 +141,7 @@ const handle = await comfy.models.submit("byteplus/dreamina-seedance-2-0-fast-26 ratio: "16:9", resolution: "720p", }); -console.log("requestId:", handle.requestId); // junto con el model ID, es todo lo que otro proceso necesita +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita // Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. for await (const update of handle.events()) { @@ -176,19 +177,19 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ## Proveedores de servicio -Comfy Router sirve este modelo directamente, a menos que la solicitud indique otro proveedor. Los siguientes proveedores también lo sirven, en el mismo endpoint y con el mismo ID de modelo, y se seleccionan con el parámetro de consulta `model_provider`. +Comfy Router sirve este modelo directamente a menos que la solicitud indique otro proveedor. Los proveedores siguientes también lo sirven, en el mismo endpoint y con el mismo ID de modelo, seleccionados con el parámetro de consulta `model_provider`. - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128` - **Kelly**, como `kelly/kelly-seedance-2.0-fast`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128?model_provider=kelly` -`strict_mode` tiene como valor predeterminado false, así que Router traduce el cuerpo de solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para todos los modelos que se enrutan de esta forma. +`strict_mode` tiene como valor predeterminado false, por lo que Router traduce el cuerpo de solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la Referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para ver todos los modelos enrutados de esta forma. ## Esquema ### Entrada - Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; consulta la ruta de estado de la tarea para obtener el resultado. + Se ignora. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; en su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -202,19 +203,19 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot - URL de audio, codificación Base64 o Asset ID. + URL de audio, codificación Base64 o ID de recurso. URL de audio: URL pública del audio (wav, mp3). -Base64: Formato data:audio/\;base64,\ -Asset ID: Formato asset://\ +Base64: formato data:audio/\;base64,\ +ID de recurso: formato asset://\ - Solo Seedance 2.5. La tarea Draft que se renderizará como el video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. + Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. +El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type; no los envíes de nuevo. Establece la resolución en esta solicitud para el nivel de salida del final, incluido 4k; cuando se omite, el final es 1080p. - El ID de tarea que se devolvió cuando se creó el video Draft con `draft` establecido en true. + El ID de tarea devuelto cuando se creó el video Draft con `draft` establecido en true. @@ -223,13 +224,13 @@ El video final reutiliza el prompt, los recursos de entrada, la duración, la re Contenido de imagen para la generación de imagen a video (cuando type es "image_url") -URL de la imagen: asegúrate de que la URL de la imagen sea accesible. +URL de imagen: asegúrate de que la URL de la imagen sea accesible. Contenido codificado en Base64: el formato debe ser data:image/\;base64,\ -Asset ID: Formato asset://\ +ID de recurso: formato asset://\ - El rol o la posición del elemento de contenido. + El rol y la posición del elemento de contenido. Para imágenes: first_frame, last_frame o reference_image. Para videos: reference_video (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). @@ -253,19 +254,19 @@ Parámetros (opcionales): agrega --[parameters] después del prompt de texto par Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Límite de seguridad del lado de Comfy, no una restricción de BytePlus. BytePlus no -publica un límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). -Cuenta caracteres, no bytes, así que un prompt de varios bytes puede ocupar varias -veces este tamaño en la transmisión. Acota solo este campo, no la solicitud: -`content` es un array y el límite del cuerpo por solicitud es lo que acota el -documento completo. Comfy Router (/v2/models/byteplus/\{model}) es la superficie -que lo aplica; en una llamada directa a v1 /proxy responde el propio validador de -BytePlus. Está fijado muy por encima del tráfico real para que nunca determine un -prompt genuino. Auméntalo si un cliente necesita más. +Salvaguarda del lado de Comfy, no una restricción de BytePlus. BytePlus no publica +ningún límite de longitud de texto y aceptó 40,000 caracteres en las pruebas (2026-09-17). +Cuenta caracteres, no bytes, así que un prompt multibyte puede ser varias veces +este tamaño al transmitirse. Limita este campo, no la solicitud: +`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita +todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie +que lo aplica; en una llamada directa a v1 /proxy responde el validador propio +de BytePlus. Está establecido muy por encima del tráfico real para que nunca +juzgue un prompt genuino: auméntalo si quien llama necesita más. - El tipo de contenido de entrada + El tipo del contenido de entrada Valores posibles: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -275,14 +276,14 @@ prompt genuino. Auméntalo si un cliente necesita más. - URL de video o Asset ID. + URL de video o ID de recurso. URL de video: URL pública del video (mp4, mov). -Asset ID: Formato asset://\ +ID de recurso: formato asset://\ Solo Seedance 2.5. Genera un video Draft de 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; cuando se omite la resolución, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del final, incluido 4k; cuando se omite la resolución, el final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -292,56 +293,56 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende - Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Alcance: [3600, 259200]. + Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Rango: [3600, 259200]. - Alcance: `3600` a `259200` + Rango: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video sin audio.En los modelos que lo admiten, el proveedor revisa la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +false: el modelo genera un video sin audio.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona del Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. - El ID del modelo que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa a la v1 de POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde el Router lo omite. + El ID del modelo al que llamar. Modelos admitidos: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza con un 400 cualquier otro valor, y también uno omitido. NO está en la lista `required` de este esquema porque Comfy Router lo completa desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama al Router lo omite. - Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. -reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. -edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). -extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. -Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. + Solo para Seedance 2.5. La tarea para la que se usan los medios de referencia. Omitido significa automático: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` en lo que interpreta como una edición) solo se resuelve después de que la generación haya comenzado, lo cual se factura. +reference: Genera un video nuevo de la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Cambia el video de referencia conectado. La salida conserva la longitud y la relación de aspecto del clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, de la `duration` solicitada; su relación de aspecto sigue al clip. +El proveedor valida un valor explícito al enviar (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), así que un valor que no se ajusta a la solicitud falla antes de que comience la generación y no se factura; el modo automático no tiene esa comprobación. Esa comprobación se ejecuta solo en la ruta nativa de BytePlus: una ruta de proveedor alternativa (en caso de fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor y ese proveedor infiere la tarea por su cuenta, como con el modo automático. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una ruta alternativa mediante `model_provider`. Valores posibles: `reference`, `edit`, `extend` - Solo Seedance 2.5. Formato de contenedor del video de salida. + Solo para Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. -mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para postproducción; mayor tamaño de archivo. +mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; mayor tamaño de archivo. Valores posibles: `mp4`, `mov` - Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro por defecto: adaptive. -Generación con primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. + Relación de aspecto del video generado. El valor predeterminado para Seedance 2.0, 2.0 fast y 2.0 mini, y 1.5 pro es adaptive. +Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. + Resolución del video. El valor predeterminado para Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro y 1.0 lite es 720p. El valor predeterminado para Seedance 1.0 pro y pro-fast es 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` - Indica si se devuelve la imagen del último fotograma del video generado. -true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. + Indica si devolver la imagen del último fotograma del video generado. +true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la operación de consulta de la información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles iguales a los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. @@ -366,33 +367,33 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr ### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router vuelve a alojar tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Anulable: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. + El contenido posterior a la finalización de la tarea de generación de video, que incluye la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router RE-ALOJA tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Puede ser nulo: BytePlus borra las URL 24 horas después de la tarea, y un documento exitoso consultado después de eso puede traer `content` ausente o nulo. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del origen o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memoria de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo volver a alojar, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace vence, así que descarga el fotograma en lugar de almacenar la URL. + URL de descarga del último fotograma del video generado, devuelta cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG del lado de la solicitud, Router re-aloja los bytes que recibe y los tipifica a partir del Content-Type del upstream o de una inspección del contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router re-aloja el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una caché de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia restante. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente de los dos. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más a menudo como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. - Hora RFC 3339 en la que las URL de origen dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. + Hora RFC 3339 en la que las URL del upstream dejan de funcionar: el primer instante de firma más la validez que las propias URL conllevan, nunca posterior al `updated_at` de la tarea más 24 horas (la vida útil documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, el `updated_at` de la tarea más 24 horas. Presente solo cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes proporciona una hora. No tiene relación con la vigencia de `video_url` / `last_frame_url` re-alojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` re-alojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` re-alojada bajo los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción habilitada, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` re-alojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el re-alojamiento del propio Router. + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a la `video_url` re-alojada. Presente SOLO para tareas Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado del lado del servidor (no existe ningún parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales la consume el propio re-alojamiento de Router. - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una memoria de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo volver a alojar, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace vence, así que descarga el video en lugar de almacenar la URL. + URL de descarga del video de salida. Router re-aloja el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una caché de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia restante. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -400,31 +401,30 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr - La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies de BytePlus informan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. + La duración del video generado en segundos. Se declara como número en lugar de entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y que otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. - La información de error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información de error. + La información del error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información del error. - Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas HTTP 200 de tarea fallida sin sobrescribir los fallos de transporte. + Código de error de ModelArk del upstream. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener una razón separada por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envoltorios de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte. El mensaje de error - - El ID de la tarea de generación de video +El ID de la tarea de generación de video - El nombre y la versión del modelo utilizado por la tarea + El nombre y la versión del modelo que usa la tarea - Formato de contenedor del video generado (mp4 o mov), que se devuelve en el NIVEL SUPERIOR como un hermano de `content`: aquí es donde lo devuelve la consulta de tarea de video de Seedance. Es un campo propio de BytePlus, que se reenvía sin cambios. + Formato de contenedor del video generado (mp4 o mov), que se devuelve en el NIVEL SUPERIOR como un campo hermano de `content`. Ahí es donde lo devuelve la consulta de tareas de video de Seedance. Es un campo propio de BytePlus, que se reenvía sin cambios. @@ -444,19 +444,19 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr - La hora en que se actualizó la tarea por última vez. El valor es una marca de tiempo UNIX en segundos. + La hora de la última actualización de la tarea. El valor es una marca de tiempo UNIX en segundos. - El uso de tokens para la solicitud + El uso de tokens de la solicitud - El número de tokens generados por el modelo + La cantidad de tokens generados por el modelo - Para el modelo de generación de video, el número de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. + Para el modelo de generación de video, la cantidad de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. ## Ejemplos @@ -498,5 +498,4 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr } ``` - diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 38d61e7e2d..d9c8755399 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,15 +2,16 @@ title: "Usa Dreamina Seedance 2.0 Mini con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-0-mini desde Comfy Router: endpoint, forma de la solicitud y respuesta." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69e65942 +translationSourceHash: 55b49c2a translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 51a6f44e + "Schema": def7c834 "Examples": db01067e --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-mini.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -179,29 +180,29 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### Entrada - Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; consulta la ruta de estado de la tarea para obtener el resultado. + Ignorado. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía un callback; en su lugar, consulta el estado de la tarea con la ruta correspondiente. Formato: `uri` - El contenido de entrada que el modelo usará para generar un video + El contenido de entrada para que el modelo genere un video - Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar solo audio: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. + Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar audio por sí solos: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. - URL de audio, codificación Base64 o Asset ID. + URL del audio, codificación Base64 o Asset ID. URL de audio: URL pública del audio (wav, mp3). -Base64: formato data:audio/\;base64,\ -Asset ID: formato asset://\ +Base64: Formato data:audio/\;base64,\ +Asset ID: Formato asset://\ - Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Define resolution en esta solicitud para el nivel de salida del video final, incluido 4k; si se omite, el video final es 1080p. + Solo Seedance 2.5. La tarea Draft que se renderizará como el video final. Debe ser el único elemento de contenido. +El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type; no los envíes de nuevo. Establece la resolución en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. @@ -216,11 +217,11 @@ El video final reutiliza el prompt, los recursos de entrada, la duración, la re Contenido de imagen para la generación de imagen a video (cuando type es "image_url") URL de la imagen: asegúrate de que la URL de la imagen sea accesible. Contenido codificado en Base64: el formato debe ser data:image/\;base64,\ -Asset ID: formato asset://\ +Asset ID: Formato asset://\ - El rol y la posición del elemento de contenido. + El rol/posición del elemento de contenido. Para imágenes: first_frame, last_frame o reference_image. Para videos: reference_video (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). @@ -231,7 +232,7 @@ Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales. -Prompt de texto (requerido): descripción del video que se va a generar usando caracteres chinos e ingleses. +Prompt de texto (requerido): Descripción del video que se generará con caracteres chinos e ingleses. Parámetros (opcionales): agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: - --resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p) @@ -244,15 +245,9 @@ Parámetros (opcionales): agrega --[parameters] después del prompt de texto par Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Límite de seguridad del lado de Comfy, no una restricción de BytePlus. BytePlus no publica -ningún límite de longitud de texto y aceptó 40,000 caracteres en las pruebas (2026-09-17). -Cuenta caracteres, no bytes, así que un prompt multibyte puede ser varias -veces este tamaño en el envío. Limita este único campo, no la solicitud: -`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita el -documento completo. Comfy Router (/v2/models/byteplus/\{model}) es la superficie -que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de BytePlus. -Está configurado muy por encima del tráfico real, de modo que nunca entre a juzgar un -prompt genuino: auméntalo si un cliente necesita más. +Medida de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no publica un límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). +Cuenta caracteres, no bytes, por lo que un prompt multibyte puede ocupar varias veces este tamaño al transmitirse. Limita este campo, no la solicitud: +`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie que lo aplica; en una llamada directa a v1 /proxy, responde el propio validador de BytePlus. Establécelo muy por encima del tráfico real para que nunca juzgue un prompt genuino; auméntalo si un llamador necesita más. @@ -266,14 +261,14 @@ prompt genuino: auméntalo si un cliente necesita más. - URL de video o Asset ID. -URL de video: URL pública del video (mp4, mov). -Asset ID: formato asset://\ + URL del video o Asset ID. +URL del video: URL pública del video (mp4, mov). +Asset ID: Formato asset://\ Solo Seedance 2.5. Genera un video Draft de 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud define la resolución del video final, incluido 4k; si se omite la resolución, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; cuando se omite la resolución, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -285,25 +280,25 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. -true: el modelo produce un video con audio sincronizado. -false: el modelo produce un video sin audio.En los modelos que lo admiten, la pista de audio generada es revisada por contenido por el proveedor de forma independiente al video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +true: El modelo genera un video con audio sincronizado. +false: El modelo genera un video silencioso.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se reporta como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin sonido si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. - El ID del modelo a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO aparece en la lista `required` de este esquema porque Comfy Router lo rellena a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través del Router lo omite. + El ID del modelo al que llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. - Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. + Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitirlo significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entre en conflicto con su interpretación (como `duration` o `ratio` en lo que interpreta como una edición) se resuelve solo después de que la generación haya comenzado, lo cual se factura. reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. -edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). -extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. -Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. +edit: Cambia el video de referencia conectado. La salida conserva la duración y la relación de aspecto del clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue la del clip. +El proveedor valida un valor explícito al enviar (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), así que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativo (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor y ese proveedor infiere la tarea por sí mismo, como con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. Valores posibles: `reference`, `edit`, `extend` @@ -311,14 +306,14 @@ Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTy Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. -mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para postproducción; mayor tamaño de archivo. +mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; mayor tamaño de archivo. Valores posibles: `mp4`, `mov` Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro por defecto: adaptive. -Generación con primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. +Seedance 2.5, generación de primer fotograma / primer y último fotograma: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` @@ -331,15 +326,15 @@ Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 48 - Indica si se devuelve la imagen del último fotograma del video generado. -true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. + Si se devuelve la imagen del último fotograma del video generado. +true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con su ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. - Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. + Entero de semilla para controlar la aleatoriedad. Rango: [-1, 2^32-1]. -1 usa una semilla aleatoria. - Alcance: `-1` a `4294967295` + Rango: `-1` a `4294967295` @@ -349,41 +344,41 @@ false: No devuelve la imagen del último fotograma del video generado. - Indica si el video generado incluye una marca de agua. + Si el video generado incluye una marca de agua. -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida - El resultado una vez completada la tarea de generación de video, que contiene la URL de descarga del video generado y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se vuelven a alojar en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Puede ser null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. + La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router vuelve a alojar tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite nulos: BytePlus borra las URL 24 horas después de la tarea, y un documento exitoso consultado después de eso puede traer `content` ausente o nulo. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type del origen o de una inspección del contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG del lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo a partir del Content-Type upstream o de una detección de contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas al generarse y reproducida desde una memo de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el nuevo alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente de los dos. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo más a menudo como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. - Hora RFC 3339 en la que las URL del origen dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. + Fecha y hora RFC 3339 en que las URL upstream dejan de funcionar: la hora de firma más temprana más la vigencia que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Presente solo cuando lo están `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes proporciona una hora. No tiene relación con la vigencia de `video_url` / `last_frame_url` re-alojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` re-alojada y en los mismos términos que `upstream_video_url`: solo para espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a `last_frame_url` re-alojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo que hayan optado por ello, solo Seedance 2.x, ausente una vez que BytePlus la borra y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` re-alojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el re-alojamiento del propio Router. + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url` re-alojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado del lado del servidor (no existe ningún parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no asociada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at` y, en Seedance 2.5, BytePlus la limita a 100 descargas, una de las cuales consume el propio re-alojamiento de Router. - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas cuando se emite y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas al generarse y reproducida desde una memo de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el nuevo alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -391,39 +386,38 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La duración del video generado en segundos. Se declara como número y no como entero porque BytePlus no es consistente al respecto: se han observado tareas de video que devuelven segundos enteros y superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. + La duración del video generado en segundos. Se declara como número en lugar de entero porque BytePlus no es consistente al respecto: se han observado tareas de video que devuelven segundos enteros y otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Campo propio de BytePlus, devuelto en tareas de video exitosas y reenviado sin cambios. - La información del error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información del error. + La información de error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información de error. - Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas de tarea fallida HTTP 200 sin sobrescribir los fallos de transporte. + Código de error de ModelArk upstream. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envoltorios de error HTTP 400 y en respuestas de tarea fallida HTTP 200 sin sobrescribir los fallos de transporte. El mensaje de error - - El ID de la tarea de generación de video +El ID de la tarea de generación de video - El nombre y la versión del modelo utilizado por la tarea + El nombre y la versión del modelo que usa la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde lo devuelve la consulta de tareas de video de Seedance. Es un campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (`mp4` o `mov`), que se devuelve en el NIVEL SUPERIOR como hermano de `content`. Así es como lo devuelve la consulta de tareas de video de Seedance. Es un campo propio de BytePlus, reenviado sin cambios. - La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. + La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus, se devuelve en las tareas de video exitosas y se reenvía sin cambios. - La semilla de generación que realmente se usó para la tarea. Es un campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. + La semilla de generación que realmente se usó para la tarea. Es un campo propio de BytePlus, se devuelve en las tareas de video exitosas y se reenvía sin cambios. Formato: `int64` @@ -435,7 +429,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La hora en que se actualizó la tarea por última vez. El valor es una marca de tiempo UNIX en segundos. + La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. @@ -443,11 +437,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - El número de tokens generados por el modelo + El número de tokens que generó el modelo - Para el modelo de generación de video, el número de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. + En el modelo de generación de video, el número de tokens de entrada no se calcula y vale 0 por defecto. Por lo tanto, total_tokens = completion_tokens. ## Ejemplos diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 266b0d7a72..1b1b3e59a3 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,16 +2,17 @@ title: "Usa Dreamina Seedance 2.5 260628 con Comfy Router" description: "Llama a byteplus/dreamina-seedance-2-5-260628 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 2acd3f28 +translationSourceHash: eb57edfc translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 - "Serving providers": 197dd61a - "Schema": d29d4b46 + "Serving providers": 79988fbb + "Schema": 254e7e79 "Examples": 5465695b --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/byteplus/dreamina-seedance-2-5-260628.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -182,6 +183,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628` - **fal**, como `fal/fal-seedance-2.5`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=fal` - **Higgsfield**, como `higgsfield/higgsfield-seedance-2.5`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=higgsfield` +- **Kelly**, como `kelly/kelly-seedance-2.5`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=kelly` - **Runware**, como `runware/runware-seedance-2.5`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=runware` - **WaveSpeed**, como `wavespeed/wavespeed-seedance-2.5`: `POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628?model_provider=wavespeed` @@ -192,7 +194,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot ### Entrada - Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; consulta la ruta de estado de la tarea para obtener el resultado. + Se ignora. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía un callback; en su lugar, consulta el estado de la tarea en la ruta de estado para obtener el resultado. Formato: `uri` @@ -202,23 +204,23 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot - Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar audio por sí solos: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. + Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar solo audio: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. - URL de audio, codificación Base64 o ID de recurso. -URL de audio: URL pública del audio (wav, mp3). + URL del audio, codificación Base64 o ID de recurso. +URL del audio: URL pública del audio (wav, mp3). Base64: Formato data:audio/\;base64,\ ID de recurso: Formato asset://\ - Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type; no los envíes de nuevo. Define resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. + Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece la resolución en esta solicitud para el nivel de salida del final, incluido 4k; si se omite, el final es 1080p. - El ID de tarea devuelto cuando el video Draft se creó con `draft` establecido en true. + El ID de tarea devuelto cuando se creó el video Draft con `draft` establecido en true. @@ -227,13 +229,13 @@ El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, l Contenido de imagen para la generación de imagen a video (cuando type es "image_url") -URL de imagen: asegúrate de que la URL de la imagen sea accesible. +URL de la imagen: asegúrate de que la URL de la imagen sea accesible. Contenido codificado en Base64: el formato debe ser data:image/\;base64,\ ID de recurso: Formato asset://\ - El rol/posición del elemento de contenido. + El rol o la posición del elemento de contenido. Para imágenes: first_frame, last_frame o reference_image. Para videos: reference_video (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). @@ -244,9 +246,9 @@ Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales. -Prompt de texto (requerido): descripción del video que se va a generar con caracteres chinos e ingleses. +Prompt de texto (requerido): descripción del video que se generará usando caracteres en chino e inglés. -Parámetros (opcionales): agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: +Parámetros (opcionales): agrega --[parámetros] después del prompt de texto para controlar las especificaciones del video: - --resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (predeterminado: 16:9 o adaptive) - --duration (--dur): 3-12 segundos (predeterminado: 5) @@ -257,19 +259,19 @@ Parámetros (opcionales): agrega --[parameters] después del prompt de texto par Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no -publica un límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). -Cuenta caracteres, no bytes, así que un prompt multibyte puede ocupar varias -veces este tamaño en el envío. Acota este campo, no la solicitud: -`content` es un arreglo y el límite del cuerpo por solicitud es el que acota el +Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no publica +un límite de longitud de texto y aceptó 40,000 caracteres en la prueba (2026-09-17). +Cuenta caracteres, no bytes, así que un prompt multibyte puede ser varias +veces de este tamaño en la transmisión. Limita este único campo, no la solicitud: +`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita el documento completo. Comfy Router (/v2/models/byteplus/\{model}) es la superficie -que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de -BytePlus. Está configurado muy por encima del tráfico real para que nunca juzgue un -prompt genuino: auméntalo si quien llama necesita más. +que lo aplica; en una llamada directa a v1 /proxy, en cambio, responde el validador +propio de BytePlus. Se establece muy por encima del tráfico real para que nunca decida sobre un +prompt genuino; auméntalo si un llamador necesita más. - El tipo del contenido de entrada + El tipo de contenido de entrada Valores posibles: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -279,14 +281,14 @@ prompt genuino: auméntalo si quien llama necesita más. - URL de video o ID de recurso. -URL de video: URL pública del video (mp4, mov). + URL del video o ID de recurso. +URL del video: URL pública del video (mp4, mov). ID de recurso: Formato asset://\ - Solo Seedance 2.5. Genera un video Draft en 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud define la resolución del video final, incluido 4k; cuando se omite la resolución, el video final es 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. + Solo Seedance 2.5. Genera un video Draft de 480p; la resolución debe ser 480p. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del final, incluido 4k; si se omite la resolución, el final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -296,63 +298,61 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende - Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Alcance: [3600, 259200]. + Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48h). Alcance: [3600, 259200]. - Rango: `3600` a `259200` + Alcance: `3600` a `259200` - Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con lo visual. + Admitido por Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video silencioso. - -En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio varía en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. +false: el modelo genera un video sin audio.En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. - El ID del modelo al que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada v1 directa a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través del Router lo omite. + El ID del modelo que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa a v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. - Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. + Solo Seedance 2.5. La tarea para la que se usa el material de referencia. Si se omite, significa automático: el modelo infiere la tarea a partir del prompt y del material de referencia, y un ajuste que entra en conflicto con su lectura (como `duration` o `ratio` en lo que interpreta como una edición) se resuelve solo después de que la generación haya comenzado, lo cual se factura. reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. -edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). -extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. -Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. +edit: Modifica el video de referencia conectado. La salida conserva la longitud y la relación de aspecto del clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue a la del clip. +El proveedor valida un valor explícito al enviar (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), así que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; automático no tiene esa comprobación. Esa comprobación se ejecuta solo en la ruta nativa de BytePlus: una ruta alternativa de proveedor (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor y ese proveedor infiere la tarea por su cuenta, igual que con automático. El descarte se indica en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una ruta alternativa mediante `model_provider`. Valores posibles: `reference`, `edit`, `extend` Solo Seedance 2.5. Formato de contenedor del video de salida. -mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. +mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y un tamaño de archivo menor. mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; mayor tamaño de archivo. Valores posibles: `mp4`, `mov` - Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro por defecto: adaptive. + Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro, valor predeterminado: adaptive. Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite por defecto: 720p. Seedance 1.0 pro y pro-fast por defecto: 1080p. + Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite, valor predeterminado: 720p. Seedance 1.0 pro y pro-fast, valor predeterminado: 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` - Si se devuelve la imagen del último fotograma del video generado. -true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a Querying the information about a video generation task. La imagen del último fotograma está en formato PNG, con su ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado previamente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. + Indica si se devuelve la imagen del último fotograma del video generado. +true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. - Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. + Número entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. Alcance: `-1` a `4294967295` @@ -364,7 +364,7 @@ false: No devuelve la imagen del último fotograma del video generado. - Si el video generado incluye una marca de agua. + Indica si el video generado incluye una marca de agua. Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -372,33 +372,33 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream ### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router REALOJA tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. + La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video generado y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se REHOSTEAN en el almacenamiento de Comfy; cualquier otro campo aquí es de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o nulo. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router realoja los bytes que recibe y les asigna un tipo a partir del Content-Type del proveedor o de una inspección del contenido, e `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router realoja el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router rehostea los bytes que reciba y les asigna un tipo según el Content-Type del proveedor o mediante una detección de contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router rehostea el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas al generarse y reproducida desde una memo de 23 horas, por lo que una consulta posterior puede devolver una a la que le quede tan solo una hora. Cuando el rehosteo no se pudo realizar, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo como un hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente de los dos. - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida útil documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando está presente `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. + Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: la hora de firma más temprana más la validez que las propias URL llevan, nunca posterior al `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, el `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` rehosteadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo para espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y es una credencial de portador hasta `upstream_expires_at`. + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a `last_frame_url` rehosteada con las mismas condiciones que `upstream_video_url`: solo espacios de trabajo que hayan optado por ello, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el realojamiento del propio Router. + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url` rehosteada. Está presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado del lado del servidor (no existe ningún parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio rehosteo de Router. - URL de descarga del video de salida. Router realoja el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router rehostea el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: firmada por 24 horas al generarse y reproducida desde una memo de 23 horas, por lo que una consulta posterior puede devolver una a la que le quede tan solo una hora. Cuando el rehosteo no se pudo realizar, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -406,39 +406,39 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios. + La duración del video generado en segundos. Se declara como number en lugar de integer porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies de BytePlus reportan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Es un campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios. - La información del error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información del error. + La información de error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información de error. - Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en sobres de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin anular los fallos de transporte. + Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas de tarea fallida con HTTP 200 sin sobrescribir los fallos de transporte. El mensaje de error - + El ID de la tarea de generación de video - El nombre y la versión del modelo usado por la tarea + El nombre y la versión del modelo que usa la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (mp4 o mov), que se devuelve en el NIVEL SUPERIOR como hermano de `content`. Aquí es donde la consulta de tareas de video de Seedance lo devuelve. Es un campo propio de BytePlus, reenviado sin cambios. - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios. + La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. - La semilla de generación que se usó realmente para la tarea. Campo propio de BytePlus, que se devuelve en las tareas de video con estado succeeded y se reenvía sin cambios. + La semilla de generación que realmente se usó para la tarea. Es un campo propio de BytePlus, que se devuelve en las tareas de video exitosas y se reenvía sin cambios. Formato: `int64` @@ -458,11 +458,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream - El número de tokens generados por el modelo + La cantidad de tokens generados por el modelo - Para el modelo de generación de video, el número de tokens de entrada no se calcula y es 0 por defecto. Por lo tanto, total_tokens = completion_tokens. + Para el modelo de generación de video, la cantidad de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. ## Ejemplos diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 816dcea832..5bd532d601 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,15 +2,16 @@ title: "Usa Seedance 1.0 Pro 250528 con Comfy Router" description: "Llama a byteplus/seedance-1-0-pro-250528 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 846f38d7 +translationSourceHash: 4453f401 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": 6f05c994 + "Schema": d82c78ff "Examples": 815d621e --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/byteplus/seedance-1-0-pro-250528.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -179,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### Entrada - Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; consulta la ruta de estado de la tarea para obtener el resultado. + Se ignora. Se acepta por compatibilidad con la forma de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía un callback; en su lugar, consulta el estado de la tarea con la ruta de estado. Formato: `uri` @@ -201,11 +202,11 @@ ID de recurso: formato asset://\ Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece la resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. +El video final reutiliza el prompt de la tarea Draft, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type; no los envíes de nuevo. Establece la resolución en esta solicitud para el nivel de salida del video final, incluido 4k; si se omite, el video final es 1080p. - El ID de tarea que se devolvió cuando se creó el video Draft con `draft` establecido en true. + El ID de tarea devuelto cuando el video Draft se creó con `draft` establecido en true. @@ -220,7 +221,7 @@ ID de recurso: formato asset://\ - El rol o la posición del elemento de contenido. + El rol y la posición del elemento de contenido. Para imágenes: first_frame, last_frame o reference_image. Para videos: reference_video (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). @@ -231,9 +232,9 @@ Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales. -Prompt de texto (requerido): descripción del video que se va a generar con caracteres chinos e ingleses. +Prompt de texto (requerido): descripción del video que se va a generar con caracteres en chino e inglés. -Parámetros (opcionales): agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: +Parámetros (opcional): agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: - --resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (predeterminado: 16:9 o adaptive) - --duration (--dur): 3-12 segundos (predeterminado: 5) @@ -244,15 +245,15 @@ Parámetros (opcionales): agrega --[parameters] después del prompt de texto par Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no -publica un límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). -Cuenta caracteres, no bytes, así que un prompt multibyte puede ocupar en la red varias -veces este tamaño. Limita este único campo, no la solicitud: -`content` es un arreglo, y el límite del cuerpo por solicitud es lo que limita el +Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no publica +ningún límite de longitud de texto y aceptó 40.000 caracteres en pruebas (2026-09-17). +Cuenta caracteres, no bytes, así que un prompt multibyte puede pesar varias +veces este tamaño en la red. Limita este único campo, no la solicitud: +`content` es un arreglo, y el límite del cuerpo por solicitud es lo que acota el documento completo. Comfy Router (/v2/models/byteplus/\{model}) es la superficie -que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de -BytePlus. Está establecido muy por encima del tráfico real para que nunca determine el -resultado de un prompt genuino; auméntalo si un cliente necesita más. +que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de BytePlus. +Está establecido muy por encima del tráfico real para que nunca determine la validez de un +prompt genuino; auméntalo si quien llama necesita más. @@ -272,8 +273,8 @@ ID de recurso: formato asset://\ - Solo Seedance 2.5. Genera un video Draft de 480p; la resolution debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolution del video final, incluido 4k; cuando se omite la resolution, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. + Solo Seedance 2.5. Genera un video Draft de 480p; la resolución debe ser 480p. +Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; si se omite la resolución, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -283,61 +284,61 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende - Umbral de tiempo de espera de la tarea en segundos. Valor predeterminado 172800 (48 h). Alcance: [3600, 259200]. + Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48 h). Rango: [3600, 259200]. - Alcance: `3600` a `259200` + Rango: `3600` a `259200` - Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. + Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con la imagen. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video sin audio.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que en ese caso vuelve a crear el Draft con `false`. +false: el modelo genera un video sin audio.En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio varía en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta por lo demás. Envía `false` para obtener un video sin audio si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola aún no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. - El ID del modelo que se va a llamar. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza con un 400 cualquier otro valor y también la omisión. NO está en la lista `required` de este esquema porque Comfy Router lo completa desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama desde Router lo omite. + El ID del modelo que se va a llamar. Modelos admitidos: 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 y dreamina-seedance-2-5-260628. Una llamada directa v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza con un 400 cualquier otro valor y también uno omitido. NO está en la lista `required` de este esquema porque Comfy Router lo completa desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, por lo que quien llama al Router lo omite. - Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. -reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. -edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). -extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. -Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. + Solo Seedance 2.5. La tarea para la que se usan los medios de referencia. Omitido significa automático: el modelo infiere la tarea a partir del prompt y los medios de referencia, y un ajuste que entra en conflicto con su lectura (como `duration` o `ratio` en lo que interpreta como una edición) solo se resuelve después de que ha comenzado la generación, que se factura. +reference: Genera un video nuevo de la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. +edit: Cambia el video de referencia conectado. La salida conserva la longitud y la relación de aspecto propias del clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +extend: Continúa el video de referencia. La salida es solo el segmento recién generado, de la `duration` solicitada; su relación de aspecto sigue al clip. +El proveedor valida un valor explícito al enviar (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no se ajusta a la solicitud falla antes de que comience la generación y no se factura; automático no tiene esa verificación. Esa verificación se ejecuta solo en el segmento nativo de BytePlus: un segmento de proveedor alternativo (al usar un respaldo, o elegido con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por sí mismo, como con automático. El descarte se indica en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene respaldo, así que solo llega a un segmento alternativo mediante `model_provider`. Valores posibles: `reference`, `edit`, `extend` Solo Seedance 2.5. Formato de contenedor del video de salida. -mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. -mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; mayor tamaño de archivo. +mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño del archivo. +mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; mayor tamaño del archivo. Valores posibles: `mp4`, `mov` - Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro, predeterminado: adaptive. -Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. + Relación de aspecto del video generado. Para Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro, el valor predeterminado es adaptive. +En la generación de Seedance 2.5 con primer fotograma / primer y último fotograma: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del envío. Seedance 2.0 acepta una relación concreta en esos modos. Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite, predeterminado: 720p. Seedance 1.0 pro y pro-fast, predeterminado: 1080p. + Resolución del video. Para Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite, el valor predeterminado es 720p. Para Seedance 1.0 pro y pro-fast, el valor predeterminado es 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` - Indica si se debe devolver la imagen del último fotograma del video generado. -true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con un ancho y alto de píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. + Indica si se devuelve la imagen del último fotograma del video generado. +true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a Consultar la información sobre una tarea de generación de video. La imagen del último fotograma está en formato PNG, con su ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar múltiples videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente múltiples videos consecutivos. false: No devuelve la imagen del último fotograma del video generado. - Entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. + Entero de semilla para controlar la aleatoriedad. Rango: [-1, 2^32-1]. -1 usa una semilla aleatoria. Rango: `-1` a `4294967295` @@ -352,38 +353,38 @@ false: No devuelve la imagen del último fotograma del video generado. Indica si el video generado incluye una marca de agua. -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus devuelve una, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se VUELVEN A ALOJAR en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Puede ser nulo: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o nulo. + El resultado después de que se completa la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se RE-ALOJAN en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Admite null: BytePlus borra las URLs 24 horas después de la tarea, y un documento exitoso consultado después de eso puede traer `content` ausente o null. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de la imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG del lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo según el Content-Type del origen o una detección de contenido, y `image/jpeg` es solo el último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de la imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG del lado de la solicitud, Router re-aloja los bytes que recibe y les asigna un tipo a partir del Content-Type del proveedor o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router re-aloja el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta por 24 horas: se firma por 24 horas al emitirse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. De cualquier modo el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo como un hermano de NIVEL SUPERIOR de `content`; consulta el campo `output_format` de nivel superior, y Router lee el que de los dos esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven más comúnmente como un hermano de NIVEL SUPERIOR de `content`: consulta el campo `output_format` de nivel superior, y Router lee el que de los dos esté presente. - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. + Hora RFC 3339 en la que las URLs del proveedor dejan de funcionar: la hora de firma más antigua más la validez que las propias URLs llevan, nunca posterior al `updated_at` de la tarea más 24 horas (la vida útil documentada de las URLs de BytePlus) cuando `updated_at` está presente; de lo contrario, el `updated_at` de la tarea más 24 horas. Presente solo cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a la `last_frame_url` re-alojada bajo los mismos términos que `upstream_video_url`: solo espacios de trabajo que lo hayan habilitado, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el realojamiento del propio Router. + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a la `video_url` re-alojada. Presente SOLO en tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy haya habilitado del lado del servidor (no existe un parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus borra sus URLs 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio re-alojamiento de Router. - URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas, firmada por 24 horas al emitirse y reproducida desde una memo de 23 horas, de modo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el realojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router re-aloja el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta por 24 horas: se firma por 24 horas al emitirse y se reproduce desde una memo de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. De cualquier modo el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -391,22 +392,22 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. + La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies hermanas de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. - La información del error. Si la tarea tiene éxito, devuelve null. Si la tarea falla, devuelve la información del error. + La información del error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información del error. - Código de error de ModelArk del origen. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las respuestas de error HTTP 400 y en las respuestas HTTP 200 de tarea fallida sin sobrescribir los fallos de transporte. + Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation u OutputImageSensitiveContentDetected.DeepFake. Esto es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envoltorios de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte. - El mensaje de error + Mensaje de error - + El ID de la tarea de generación de video @@ -415,15 +416,15 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`; aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`. Aquí es donde la consulta de la tarea de video de Seedance lo devuelve. Campo propio de BytePlus, reenviado sin cambios. - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. + La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. - La semilla de generación que se usó realmente para la tarea. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. + La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus, devuelto en las tareas de video exitosas y reenviado sin cambios. Formato: `int64` @@ -435,7 +436,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - La hora en que se actualizó la tarea por última vez. El valor es una marca de tiempo UNIX en segundos. + La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. @@ -447,7 +448,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda - Para el modelo de generación de video, la cantidad de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. + Para el modelo de generación de video, la cantidad de tokens de entrada no se calcula y toma el valor 0 por defecto. Por lo tanto, total_tokens = completion_tokens. ## Ejemplos diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index e0855f0d06..5a1cec39dd 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,15 +2,16 @@ title: "Usa Seedance 1.0 Pro Fast 251015 con Comfy Router" description: "Llama a byteplus/seedance-1-0-pro-fast-251015 desde Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 5ba64878 +translationSourceHash: cadcf7af translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 2de625f5 + "Schema": db13820d "Examples": 1469ab97 --- + {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-fast-251015.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -179,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### Entrada - Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; consulta la ruta de estado de la tarea para obtener el resultado. + Se ignora. Se acepta por compatibilidad con la estructura de la solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía un callback. En su lugar, consulta la ruta de estado de la tarea para obtener el resultado. Formato: `uri` @@ -193,19 +194,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - URL de audio, codificación Base64 o Asset ID. + URL de audio, codificación Base64 o ID de recurso. URL de audio: URL pública del audio (wav, mp3). Base64: Formato data:audio/\;base64,\ -Asset ID: Formato asset://\ +ID de recurso: Formato asset://\ - Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece la resolución en esta solicitud para el nivel de salida del video final, incluido 4k; si la omites, el video final es 1080p. + Solo Seedance 2.5. La tarea Draft que se va a renderizar como video final. Debe ser el único elemento de contenido. +El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Define la resolución en esta solicitud para el nivel de salida del video final, incluido 4k; si se omite, el video final es 1080p. - El ID de tarea devuelto cuando se creó el video Draft con `draft` establecido en true. + El ID de la tarea que se devuelve al crear el video Draft con `draft` establecido en true. @@ -213,10 +214,10 @@ El video final reutiliza el prompt, los recursos de entrada, la duración, la re - Contenido de imagen para la generación de imagen a video (cuando type es "image_url") -URL de la imagen: asegúrate de que la URL de la imagen sea accesible. -Contenido codificado en Base64: el formato debe ser data:image/\;base64,\ -Asset ID: Formato asset://\ + Contenido de imagen para la generación de imagen a video (cuando type es "image_url"). +URL de la imagen: Asegúrate de que la URL de la imagen sea accesible. +Contenido codificado en Base64: El formato debe ser data:image/\;base64,\ +ID de recurso: Formato asset://\ @@ -231,9 +232,9 @@ Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales. -Prompt de texto (requerido): descripción del video que se va a generar, usando caracteres chinos e ingleses. +Prompt de texto (requerido): Descripción del video que se generará con caracteres en chino e inglés. -Parámetros (opcionales): agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: +Parámetros (opcionales): Agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: - --resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (predeterminado: 16:9 o adaptive) - --duration (--dur): 3-12 segundos (predeterminado: 5) @@ -244,15 +245,7 @@ Parámetros (opcionales): agrega --[parameters] después del prompt de texto par Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Límite de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no publica un -límite de longitud de texto y aceptó 40.000 caracteres en pruebas (2026-09-17). -Cuenta caracteres, no bytes, así que un prompt multibyte puede ser varias -veces de este tamaño en la transmisión. Acota este campo, no la solicitud: -`content` es un arreglo y el límite del cuerpo por solicitud es lo que acota el -documento completo. Comfy Router (/v2/models/byteplus/\{model}) es la superficie -que lo aplica; en una llamada directa a v1 /proxy responde el validador propio de BytePlus. -Establecido muy por encima del tráfico real para que nunca intervenga en un -prompt genuino: auméntalo si un cliente necesita más. +Barrera de protección del lado de Comfy, no una restricción de BytePlus. BytePlus no publica ningún límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). Cuenta caracteres, no bytes, así que un prompt con caracteres multibyte puede ser varias veces este tamaño en la transmisión. Limita este campo, no la solicitud: `content` es un array, y el límite del cuerpo por solicitud es lo que limita todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie que lo aplica; en una llamada directa a v1 /proxy, el propio validador de BytePlus responde en su lugar. Se establece muy por encima del tráfico real para que nunca determine el resultado de un prompt genuino; auméntalo si quien llama necesita más. @@ -266,14 +259,14 @@ prompt genuino: auméntalo si un cliente necesita más. - URL de video o Asset ID. -URL de video: URL pública del video (mp4, mov). -Asset ID: Formato asset://\ + URL del video o ID de recurso. +URL del video: URL pública del video (mp4, mov). +ID de recurso: Formato asset://\ - Solo Seedance 2.5. Genera un video Draft en 480p; la resolución debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; si omites la resolución, el video final es 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. + Solo Seedance 2.5. Genera un video Draft de 480p; la resolución debe ser 480p. +Pasa el ID de la tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud define la resolución del video final, incluido 4k; si se omite la resolución, el video final es 1080p. El ID de la tarea Draft sigue siendo válido durante 7 días. @@ -283,27 +276,27 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende - Umbral de tiempo de espera de la tarea en segundos. Predeterminado 172800 (48h). Alcance: [3600, 259200]. + Umbral de tiempo de espera de la tarea en segundos. Predeterminado: 172800 (48h). Alcance: [3600, 259200]. Alcance: `3600` a `259200` Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. -true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video silencioso.En los modelos que lo admiten, el proveedor revisa la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si esto ocurre; eso ayuda solo cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +true: El modelo genera un video con audio sincronizado. +false: El modelo genera un video sin audio.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo ahí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta por lo demás. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona de Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. - El ID del modelo al que se llama. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa a la v1 mediante POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo; el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo completa a partir del segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. + El ID del modelo que se va a llamar. Modelos admitidos: 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 y dreamina-seedance-2-5-260628. Una llamada v1 directa a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE incluirlo: el proxy rechaza con un 400 cualquier otro valor, y también su omisión. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a Router lo omite. - Solo Seedance 2.5. La tarea para la que se usa el medio de referencia. Omitido significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su interpretación (como `duration` o `ratio` sobre lo que interpreta como una edición) solo se resuelve después de que la generación ya ha comenzado, y eso se factura. + Solo Seedance 2.5. La tarea para la que se usan los medios de referencia. Si se omite, significa auto: el modelo infiere la tarea a partir del prompt y de los medios de referencia, y un ajuste que entra en conflicto con su lectura (como `duration` o `ratio` en lo que interpreta como una edición) se resuelve solo después de que la generación haya comenzado, lo que se factura. reference: Genera un video nuevo con la `duration` solicitada, guiado por las imágenes, videos y audio de referencia. -edit: Modifica el video de referencia conectado. La salida conserva la duración y la relación de aspecto del propio clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). +edit: Cambia el video de referencia conectado. La salida conserva la duración y la relación de aspecto propias del clip de origen, así que envía `duration: -1` y omite `ratio` (o envía `adaptive`). extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. -Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), por lo que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la vía nativa de BytePlus: una vía de proveedor alternativa (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una vía alternativa mediante `model_provider`. +El proveedor valida un valor explícito al enviar (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), así que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; auto no tiene esa comprobación. Esa comprobación se ejecuta solo en la rama nativa de BytePlus: una rama de proveedor alternativo (en el fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por su cuenta, igual que con auto. El descarte se informa en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una rama alternativa mediante `model_provider`. Valores posibles: `reference`, `edit`, `extend` @@ -311,33 +304,33 @@ Un valor explícito lo valida el proveedor al enviarlo (`InvalidParameter.TaskTy Solo Seedance 2.5. Formato de contenedor del video de salida. mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. -mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para posproducción; mayor tamaño de archivo. +mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para postproducción; mayor tamaño de archivo. Valores posibles: `mp4`, `mov` - Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro predeterminado: adaptive. -Generación de primer frame / primer y último frame con Seedance 2.5: la salida sigue la relación de aspecto del primer frame, así que solo se acepta `adaptive` (o omitir el campo); una relación concreta se rechaza con un 400 antes de enviar la solicitud. Seedance 2.0 acepta una relación concreta en esos modos. + Relación de aspecto del video generado. Valor predeterminado de Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro: adaptive. +Generación de primer fotograma / primer y último fotograma de Seedance 2.5: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite predeterminado: 720p. Seedance 1.0 pro y pro-fast predeterminado: 1080p. + Resolución del video. Valor predeterminado de Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite: 720p. Valor predeterminado de Seedance 1.0 pro y pro-fast: 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. Valores posibles: `480p`, `720p`, `1080p`, `4k` - Indica si se devuelve la imagen del último frame del video generado. -true: Devuelve la imagen del último frame del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último frame llamando a la consulta de información de una tarea de generación de video. La imagen del último frame está en formato PNG, con un ancho y alto en píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último frame del video generado anteriormente se usa como primer frame de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. -false: No devuelve la imagen del último frame del video generado. + Si se devuelve la imagen del último fotograma del video generado. +true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a Querying the information about a video generation task. La imagen del último fotograma está en formato PNG, con su ancho y alto en píxeles iguales a los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar varios videos consecutivos rápidamente. +false: No devuelve la imagen del último fotograma del video generado. - Entero de semilla para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. + Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. Alcance: `-1` a `4294967295` @@ -349,41 +342,41 @@ false: No devuelve la imagen del último frame del video generado. - Indica si el video generado incluye una marca de agua. + Si el video generado incluye una marca de agua. -Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida - La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se realojan en el almacenamiento de Comfy; todos los demás campos de aquí son propios de BytePlus. Anulable: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado `succeeded` consultado después de eso puede traer `content` ausente o nulo. + La salida una vez completada la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Router vuelve a alojar tanto `video_url` como `last_frame_url` en el almacenamiento de Comfy; todos los demás campos aquí son propios de BytePlus. Puede ser nulo: BytePlus borra las URL 24 horas después de la tarea, y un documento de tarea exitosa consultado después de eso puede traer `content` ausente o nulo. - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router realoja los bytes que recibe y les asigna un tipo a partir del Content-Type del proveedor o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router realoja el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando el realojamiento no se pudo realizar, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. + URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud establece `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router vuelve a alojar los bytes que recibe y les asigna un tipo según el Content-Type de origen o una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router vuelve a alojar el último fotograma en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas: se firma por 24 horas al emitirse y se recupera desde una memo de 23 horas, así que una consulta posterior puede devolver una a la que le queda tan solo una hora. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso, el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven con mayor frecuencia como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente. + Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance suelen devolverlo como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que esté presente de los dos. - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` realojadas. + Hora en formato RFC 3339 en la que las URL de origen dejan de funcionar: la hora de firma más temprana más la vigencia que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida útil documentada de las URL de BytePlus) cuando `updated_at` está presente; de lo contrario, `updated_at` de la tarea más 24 horas. Se incluye solo cuando están presentes `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes proporciona una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. Formato: `date-time` - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` realojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. + URL de descarga propia de BytePlus para el último fotograma, devuelta byte por byte junto a `last_frame_url` re-alojada, en los mismos términos que `upstream_video_url`: solo espacios de trabajo que hayan optado por ello, solo Seedance 2.x, ausente una vez que BytePlus la borra, y una credencial de portador hasta `upstream_expires_at`. - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` realojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el realojamiento del propio Router. + URL de descarga propia de BytePlus para el video de salida, devuelta byte por byte junto a `video_url` re-alojada. Presente SOLO en tareas Seedance 2.x consultadas por un espacio de trabajo para el que Comfy haya optado por ello del lado del servidor (no hay ningún parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a ninguno), y ausente una vez que BytePlus borra sus URL 24 horas después de la generación. Es una URL prefirmada de almacenamiento de objetos y, por lo tanto, una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el propio re-alojamiento de Router. - URL de descarga del video de salida. Router realoja el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una caché de 23 horas, así que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando el realojamiento no se pudo realizar, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. + URL de descarga del video de salida. Router vuelve a alojar el video en el almacenamiento de Comfy y reescribe este campo, por lo que normalmente es una URL firmada por Comfy válida por hasta 24 horas: se firma por 24 horas al emitirse y se recupera desde una memo de 23 horas, así que una consulta posterior puede devolver una a la que le queda tan solo una hora. Cuando no se pudo realizar el re-alojamiento, el campo conserva la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso, el enlace caduca, así que descarga el video en lugar de guardar la URL. @@ -391,39 +384,38 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed - La duración del video generado en segundos. Se declara como número en lugar de entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies de BytePlus reportan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. + La duración del video generado en segundos. Se declara como un número en lugar de un entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y que otras superficies de BytePlus reportan duraciones fraccionarias, así que un cliente no debe suponer un valor entero. Es un campo propio de BytePlus, que se devuelve en tareas de video exitosas y se reenvía sin cambios. - La información del error. Si la tarea tiene éxito, se devuelve null. Si la tarea falla, se devuelve la información del error. + La información de error. Si la tarea se completa correctamente, se devuelve null. Si la tarea falla, se devuelve la información de error. - Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Esto es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas HTTP 200 de tareas fallidas sin sobrescribir los fallos de transporte. + Código de error de ModelArk upstream. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en envoltorios de error HTTP 400 y en respuestas HTTP 200 de tareas fallidas sin anular los fallos de transporte. - El mensaje de error + Mensaje de error - - El ID de la tarea de generación de video +El ID de la tarea de generación de video - El nombre y la versión del modelo usado por la tarea + El nombre y la versión del modelo que utiliza la tarea - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde lo devuelve la consulta de tareas de video de Seedance. Campo propio de BytePlus, reenviado sin cambios. + Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`. Ahí es donde la consulta de tareas de video de Seedance lo devuelve. Es un campo propio de BytePlus que la API reenvía sin cambios. - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus que aparece en tareas de video exitosas y se reenvía sin cambios. + La resolución del video generado, por ejemplo `1080p`. Es un campo propio de BytePlus que la API devuelve en las tareas de video exitosas y reenvía sin cambios. - La semilla de generación que realmente se usó para la tarea. Campo propio de BytePlus que aparece en tareas de video exitosas y se reenvía sin cambios. + La semilla de generación que realmente se usó para la tarea. Es un campo propio de BytePlus que la API devuelve en las tareas de video exitosas y reenvía sin cambios. Formato: `int64` @@ -435,7 +427,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed - La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. + La hora de la última actualización de la tarea. El valor es una marca de tiempo UNIX en segundos. @@ -443,11 +435,11 @@ Generado a partir del esquema que Router expone en `GET /v2/models/byteplus/seed - La cantidad de tokens generados por el modelo + La cantidad de tokens que generó el modelo - Para el modelo de generación de video, la cantidad de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. + En el modelo de generación de video, la cantidad de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. ## Ejemplos diff --git a/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index 985cb0a95c..6197a384eb 100644 --- a/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -2,16 +2,17 @@ title: "Usa Gemini 2.5 Flash Image con Comfy Router" description: "Llama a vertexai/gemini-2.5-flash-image con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Gemini 2.5 Flash Image" -translationSourceHash: 9bd54fc7 +translationSourceHash: f785dde3 translationFrom: development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx translationBlockHashes: "_intro": ac1aef55 "Quick start": 7ec68bbf "Serving providers": beb2dd36 - "Schema": f124875a + "Schema": f53ea977 "Examples": 19258aaa --- + {/* GENERATED FILE. Generado desde router-schemas/vertexai/gemini-2.5-flash-image.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -271,21 +272,20 @@ El valor predeterminado de `strict_mode` es falso, por lo que Router traduce el - Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K y 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Rango: `16` a `65536` + Alcance: `16` a `65536` - - Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por dar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los valores de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 +Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por dar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los valores de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -315,7 +315,7 @@ El valor predeterminado de `strict_mode` es falso, por lo que Router traduce el Opcional. El nivel de pensamiento para el modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -335,7 +335,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Configuraciones por solicitud para bloquear contenido no seguro. Se aplican en GenerateContentResponse.candidates. + Configuraciones por solicitud para bloquear contenido no seguro. Se aplican a GenerateContentResponse.candidates. @@ -359,13 +359,13 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, típicamente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones de un solo turno, este campo puede dejarse en blanco o sin definir. + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: Indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: Indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones que no son de varios turnos, este campo puede quedar en blanco o sin establecer. Valores posibles: `user`, `model` - Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Llamada a funciones. + Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta la sección Llamada a funciones. @@ -378,9 +378,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - - - + Esquema JSON para los parámetros de la función @@ -564,10 +562,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` @@ -585,11 +580,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Solo salida. Número de tokens en la parte en caché de la entrada (el contenido en caché). + Solo salida. Número de tokens de la parte en caché de la entrada (el contenido en caché). - Número de tokens en la(s) respuesta(s). + Número de tokens de la respuesta o las respuestas. @@ -597,7 +592,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Tipo de modalidad del contenido de entrada o salida. + Tipo de modalidad del contenido de entrada o de salida. Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -607,7 +602,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Número de tokens en la solicitud. Cuando se establece cachedContent, este sigue siendo el tamaño total efectivo del prompt, lo que significa que incluye el número de tokens del contenido en caché. + Número de tokens de la solicitud. Cuando se establece cachedContent, este sigue siendo el tamaño total efectivo del prompt, es decir, incluye el número de tokens del contenido en caché. @@ -615,7 +610,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Tipo de modalidad del contenido de entrada o salida. + Tipo de modalidad del contenido de entrada o de salida. Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -637,7 +632,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Tipo de modalidad del contenido de entrada o salida. + Tipo de modalidad del contenido de entrada o de salida. Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -651,7 +646,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Tipo de tráfico usado para la solicitud (por ejemplo, PROVISIONED_THROUGHPUT). + Tipo de tráfico usado en la solicitud (por ejemplo, PROVISIONED_THROUGHPUT). ## Ejemplos diff --git a/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index 7107bb3046..2799090a34 100644 --- a/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -2,14 +2,15 @@ title: "Usa Gemini 3.1 Flash Lite con Comfy Router" description: "Llama a vertexai/gemini-3.1-flash-lite con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Gemini 3.1 Flash Lite" -translationSourceHash: 52b7530c +translationSourceHash: 1a291975 translationFrom: development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx translationBlockHashes: "_intro": 408e9eae "Quick start": 869398cb - "Schema": 1d473fa3 + "Schema": 2859a2da "Examples": 2ebce337 --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/vertexai/gemini-3.1-flash-lite.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -260,21 +261,20 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE - Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K y 4K. Si lo omites, el modelo usa el valor predeterminado 1K. - Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. + Número máximo de tokens que puede generar la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Rango: `16` a `65536` + Intervalo: `16` a `65536` - - Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por entregar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los ajustes de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 +Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por entregar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los ajustes de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -304,7 +304,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE Opcional. El nivel de pensamiento del modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -354,7 +354,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Llamada a funciones. + Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta la llamada a funciones. @@ -372,7 +372,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URLs firmadas en lugar de datos base64 en línea. Las URLs expiran después de 24 horas. + Si es verdadero, las imágenes generadas se suben al almacenamiento en la nube y se devuelven como URLs firmadas en lugar de datos base64 en línea. Las URLs expiran después de 24 horas. @@ -384,7 +384,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Fracciones de segundo con signo a resolución de nanosegundos. Los valores de segundos negativos con fracciones aún deben tener valores de nanos no negativos. + Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. Rango: `0` a `999999999` @@ -400,7 +400,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Fracciones de segundo con signo a resolución de nanosegundos. Los valores de segundos negativos con fracciones aún deben tener valores de nanos no negativos. + Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. Rango: `0` a `999999999` @@ -522,7 +522,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - La probabilidad de que el contenido viole la categoría de seguridad especificada + La probabilidad de que el contenido infrinja la categoría de seguridad especificada Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -552,6 +552,8 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index 516dab408e..215f42888b 100644 --- a/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -2,14 +2,15 @@ title: "Usa Gemini 3.7 Flash con Comfy Router" description: "Llama a vertexai/gemini-3.7-flash desde Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Gemini 3.7 Flash" -translationSourceHash: a5b78a88 +translationSourceHash: 059b025e translationFrom: development/comfy-router/models/google/gemini-3-7-flash/code.mdx translationBlockHashes: "_intro": 8eab9a58 "Quick start": b4872308 - "Schema": b5f16a3c + "Schema": cc4c8104 "Examples": 1da8dd0c --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-3.7-flash.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -260,13 +261,13 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K y 4K. Si no se especifica, el modelo usa el valor predeterminado 1K. - Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden más o menos a 60-80 palabras. + Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Rango: `16` a `65536` + Alcance: `16` a `65536` @@ -274,7 +275,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por proporcionar la misma respuesta a solicitudes repetidas. La salida determinista no está garantizada. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por proporcionar la misma respuesta a solicitudes repetidas. La salida determinista no está garantizada. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -282,7 +284,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - La temperatura se usa para el muestreo durante la generación de la respuesta, que ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad en la selección de tokens. Las temperaturas más bajas son buenas para prompts que requieren una respuesta menos abierta o creativa, mientras que las temperaturas más altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 significa que siempre se seleccionan los tokens con mayor probabilidad. En este caso, las respuestas para un prompt dado son en su mayoría deterministas, pero todavía es posible una pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, demasiado corta, o el modelo da una respuesta de reserva, prueba a aumentar la temperatura + La temperatura se usa para el muestreo durante la generación de la respuesta, que ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad en la selección de tokens. Las temperaturas más bajas son buenas para prompts que requieren una respuesta menos abierta o creativa, mientras que las temperaturas más altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 significa que siempre se seleccionan los tokens con mayor probabilidad. En este caso, las respuestas para un prompt dado son en su mayoría deterministas, pero todavía es posible una pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, demasiado corta, o el modelo da una respuesta de reserva, intenta aumentar la temperatura Rango: de `0` a `2` @@ -304,7 +306,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST Opcional. El nivel de pensamiento del modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -348,7 +350,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: Esto indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: Esto indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. Para conversaciones de un solo turno, este campo puede dejarse en blanco o sin definir. + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: Indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: Indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones que no son de varios turnos, este campo se puede dejar en blanco o sin definir. Valores posibles: `user`, `model` @@ -411,7 +413,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a Rango: `-315576000000` a `315576000000` -Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que Router publica en `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -551,10 +553,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - - La categoría de seguridad a la que pertenece esta calificación - - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` +Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-3-8-flash/code.mdx b/es/development/comfy-router/models/google/gemini-3-8-flash/code.mdx index 9d59aafdc9..8ec538a1eb 100644 --- a/es/development/comfy-router/models/google/gemini-3-8-flash/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-8-flash/code.mdx @@ -2,14 +2,15 @@ title: "Usa Gemini 3.8 Flash con Comfy Router" description: "Llama a vertexai/gemini-3.8-flash con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Gemini 3.8 Flash" -translationSourceHash: 723f1618 +translationSourceHash: aec8f1da translationFrom: development/comfy-router/models/google/gemini-3-8-flash/code.mdx translationBlockHashes: "_intro": c76d5ed4 "Quick start": e986a155 - "Schema": e5173b06 + "Schema": ab7655e4 "Examples": 48b9d5db --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-3.8-flash.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -273,8 +274,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - -Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los ajustes de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los ajustes de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -304,7 +305,7 @@ Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfue Opcional. El nivel de pensamiento del modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -348,7 +349,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En las conversaciones que no son de varios turnos, este campo puede dejarse en blanco o sin definir. + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones que no son de varios turnos, este campo puede dejarse en blanco o sin definir. Valores posibles: `user`, `model` @@ -551,10 +552,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - - La categoría de seguridad a la que se aplica esta calificación. - - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` +Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-4-argon/code.mdx b/es/development/comfy-router/models/google/gemini-4-argon/code.mdx new file mode 100644 index 0000000000..aa6798098b --- /dev/null +++ b/es/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -0,0 +1,689 @@ +--- +title: "Usa Gemini 4 Argon con Comfy Router" +description: "Llama a vertexai/gemini-4-argon con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Gemini 4 Argon" +translationSourceHash: 913b7628 +translationFrom: development/comfy-router/models/google/gemini-4-argon/code.mdx +translationBlockHashes: + "_intro": 37c83dd8 + "Quick start": 9453b03d + "Schema": 1ff628d6 + "Examples": 046e90e1 +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/vertexai/gemini-4-argon.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `vertexai/gemini-4-argon`, servido por Comfy Router de Google. + +**Entrada:** Texto, Imagen, Audio, Video · **Salida:** Texto + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**ID del modelo:** `vertexai/gemini-4-argon` + +**Endpoint:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-argon` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-argon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("vertexai/gemini-4-argon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-argon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("vertexai/gemini-4-argon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + El contenido de la conversación actual con el modelo. Para consultas de un solo turno, es una sola instancia. Para consultas de varios turnos, es un campo repetido que contiene el historial de la conversación y la solicitud más reciente. + + + + + + + + Datos basados en URI. + + + + URI + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de imagen. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. + + + + La codificación base64 de la imagen, PDF o video que se incluirá en línea en el prompt. Cuando incluyes medios en línea, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB + + Formato: `byte` + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de imagen. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a tasa fija. Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes. + + + + Un prompt de texto o fragmento de código. + + + + Indica que esta parte es un paso de pensamiento/razonamiento del modelo. + + + + Valores posibles: `user`, `model` + + + + Configuraciones de muestreo, longitud y salida para la generación. Todos los campos son opcionales: los campos siguientes que declaran un `default` lo aplican cuando se omiten, y el resto recurre al comportamiento propio del modelo. + + + + Configuración para la generación de imágenes + + + + Relación de aspecto de las imágenes generadas + + + + Opcional. El formato de salida de imagen para las imágenes generadas. + + + + Opcional. La calidad de compresión de la imagen de salida. + + + + Opcional. El formato de imagen con el que se debe guardar la salida, en las rutas de Vertex AI: solicitudes atendidas con las credenciales propias de Comfy y solicitudes BYOK autenticadas con una cuenta de servicio de GCP. Los valores aceptados allí son `image/png` y `image/jpeg`, se comparan sin distinguir mayúsculas y minúsculas y se normalizan a minúsculas antes de reenviar la solicitud; cualquier otro valor se rechaza con un 400 que nombra este campo. Si se omite, el valor predeterminado es `image/png`. Una solicitud BYOK autenticada con una clave API de Google AI Studio es la excepción: ese upstream no tiene esta propiedad y rechaza toda la llamada si está presente, así que el campo se elimina de la solicitud en lugar de respetarse o rechazarse, y el formato de salida es el que elija AI Studio. En todas las rutas, lee el tipo de medio de vuelta desde la parte de la respuesta que recibes (`inlineData.mimeType`, o `fileData.mimeType` cuando `uploadImagesToStorage` está establecido) en lugar de suponer el valor que enviaste. + + + + Opcional. Especifica el tamaño de las imágenes generadas. Los valores compatibles son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + + + + Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. + + Alcance: `16` a `65536` + + + + + + +Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo para proporcionar la misma respuesta en solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de parámetros, como la temperatura, puede causar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + La temperatura se usa para el muestreo durante la generación de respuestas, que ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad en la selección de tokens. Las temperaturas más bajas son buenas para prompts que requieren una respuesta menos abierta o creativa, mientras que las temperaturas más altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 significa que siempre se seleccionan los tokens de mayor probabilidad. En este caso, las respuestas para un prompt dado son en su mayoría deterministas, pero todavía es posible una pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, demasiado corta, o el modelo da una respuesta de reserva, prueba a aumentar la temperatura + + Alcance: `0` a `2` + + Formato: `FLOTANTE` + + + + Opcional. Configuración para las funciones de pensamiento. El pensamiento es un proceso en el que el modelo descompone una tarea compleja en pasos más pequeños para generar una respuesta de mayor calidad. + + + + Opcional. Si es verdadero, el modelo incluirá sus pensamientos en la respuesta. + + + + Opcional. El presupuesto de tokens para el proceso de pensamiento del modelo. El modelo hará su mejor esfuerzo para mantenerse dentro de este presupuesto. + + + + Opcional. El nivel de pensamiento del modelo. + + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` + + + + Top-K cambia cómo el modelo selecciona los tokens para la salida. Un top-K de 1 significa que el siguiente token seleccionado es el más probable entre todos los tokens del vocabulario del modelo. Un top-K de 3 significa que el siguiente token se selecciona entre los 3 tokens más probables usando la temperatura. + + Alcance: `1` a `…` + + + + Si se especifica, se usa el muestreo de núcleo. +Top-P cambia cómo el modelo selecciona los tokens para la salida. Los tokens se seleccionan del más (consulta top-K) al menos probable hasta que la suma de sus probabilidades iguale el valor de top-P. Por ejemplo, si los tokens A, B y C tienen una probabilidad de 0.3, 0.2 y 0.1 y el valor de top-P es 0.5, entonces el modelo seleccionará A o B como el siguiente token usando la temperatura y excluirá C como candidato. +Especifica un valor más bajo para respuestas menos aleatorias y un valor más alto para respuestas más aleatorias. + + Alcance: `0` a `1` + + Formato: `FLOTANTE` + + + + Configuraciones por solicitud para bloquear contenido no seguro. Se aplican a GenerateContentResponse.candidates. + + + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + Valores posibles: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + Instrucciones para el modelo que lo orientan hacia un mejor rendimiento. Por ejemplo, "Responde de la forma más concisa posible" o "No uses términos técnicos en tu respuesta". Las cadenas de texto cuentan para el límite de tokens. El campo role de systemInstruction se ignora y no afecta el rendimiento del modelo. Nota: en las partes solo se debe usar texto, y el contenido de cada parte debe ir en un párrafo separado. + + + + Una lista ordenada de partes que componen un solo mensaje. Las distintas partes pueden tener diferentes tipos MIME de IANA. Para conocer los límites de las entradas, como el número máximo de tokens o el número de imágenes, consulta las especificaciones del modelo en la página de modelos de Google. + + + + Un prompt de texto o un fragmento de código. + + + + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones que no son de varios turnos, este campo puede dejarse en blanco o sin definir. + + Valores posibles: `user`, `model` + + + + Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Function calling. + + + + + + + + + + + + + + Esquema JSON para los parámetros de la función + + + + Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URL firmadas en lugar de datos base64 en línea. Las URL caducan después de 24 horas. + + + + Para la entrada de video, el desplazamiento de inicio y fin del video en formato Duration. Por ejemplo, para especificar un clip de 10 segundos que comienza en 1:00, establece "startOffset": \{ "seconds": 60 } y "endOffset": \{ "seconds": 70 }. Los metadatos solo deben especificarse mientras los datos del video se presenten en inlineData o fileData. + + + + Representa un desplazamiento de duración para posiciones de la línea de tiempo del video. + + + + Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. + + Alcance: `0` a `999999999` + + + + Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. + + Alcance: `-315576000000` a `315576000000` + + + + Representa un desplazamiento de duración para posiciones de la línea de tiempo del video. + + + + Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. + + Alcance: `0` a `999999999` + + + + Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. + + Alcance: `-315576000000` a `315576000000` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemini-4-argon/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + + + + + + + + + + + + + + + + + + + + + + + + + Formato: `date` + + + + + + + + + + + + + + + + El contenido de la conversación actual con el modelo. Para consultas de un solo turno, es una sola instancia. Para consultas de varios turnos, es un campo repetido que contiene el historial de la conversación y la última solicitud. + + + + + + + + Datos basados en URI. + + + + URI + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Datos insertados en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. + + + + La codificación base64 de la imagen, el PDF o el video que se incluirá directamente en el prompt. Cuando incluyes medios directamente, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB + + Formato: `byte` + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a frecuencia fija. Omite este campo para usar el muestreo a frecuencia fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes. + + + + Un prompt de texto o un fragmento de código. + + + + Indica que esta parte es un paso de pensamiento o razonamiento del modelo. + + + + Valores posibles: `user`, `model` + + + + + + + + + + + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + La probabilidad de que el contenido infrinja la categoría de seguridad especificada + + Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + Marca de tiempo de cuándo se creó la respuesta. + + + + La versión del modelo que se usó para generar la respuesta. + + + + + + + + + + + + + + + + + + + + La categoría de seguridad a la que pertenece esta calificación + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + La probabilidad de que el contenido infrinja la categoría de seguridad especificada + + Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + Identificador único de la respuesta. + + + + + + + + Solo salida. Número de tokens en la parte en caché de la entrada (el contenido en caché). + + + + Número de tokens en la respuesta o respuestas. + + + + Desglose de los tokens de candidatos por modalidad. + + + + Tipo de modalidad del contenido de entrada o de salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad dada. + + + + Número de tokens en la solicitud. Cuando se establece cachedContent, este sigue siendo el tamaño total efectivo del prompt, lo que significa que incluye el número de tokens del contenido en caché. + + + + Desglose de los tokens del prompt por modalidad. + + + + Tipo de modalidad del contenido de entrada o de salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad dada. + + + + Número de tokens presentes en la salida de pensamientos. + + + + Número de tokens presentes en el prompt o prompts de uso de herramientas. + + + + Desglose de los tokens del prompt de uso de herramientas por modalidad. + + + + Tipo de modalidad del contenido de entrada o de salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad dada. + + + + Número total de tokens (prompt + candidatos). + + + + Tipo de tráfico usado para la solicitud (p. ej., PROVISIONED_THROUGHPUT). + + +## Ejemplos + +### Entrada + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### Salida + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-argon", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + diff --git a/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx new file mode 100644 index 0000000000..7ef4c21d00 --- /dev/null +++ b/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -0,0 +1,685 @@ +--- +title: "Usar Gemini 4 Carbon con Comfy Router" +description: "Llama a vertexai/gemini-4-carbon con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Gemini 4 Carbon" +translationSourceHash: c107edac +translationFrom: development/comfy-router/models/google/gemini-4-carbon/code.mdx +translationBlockHashes: + "_intro": 8eafb327 + "Quick start": a26083eb + "Schema": 1046bf02 + "Examples": b2720522 +--- +{/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-4-carbon.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `vertexai/gemini-4-carbon`, que Comfy Router sirve desde Google. + +**Entrada:** Texto, Imagen, Audio, Video · **Salida:** Texto + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. + +**ID del modelo:** `vertexai/gemini-4-carbon` + +**Endpoint:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-carbon` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-carbon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("vertexai/gemini-4-carbon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-carbon", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que necesita otro proceso + + # Consulta repetidamente hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("vertexai/gemini-4-carbon", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que necesita otro proceso + +// Consulta repetidamente hasta que la solicitud se complete, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indique cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + El contenido de la conversación actual con el modelo. Para consultas de un solo turno, es una única instancia. Para consultas de varios turnos, es un campo repetido que contiene el historial de la conversación y la solicitud más reciente. + + + + + + + + Datos basados en URI. + + + + URI + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de imágenes. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Datos insertados en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. + + + + La codificación base64 de la imagen, el PDF o el video que se incluirá insertado en el prompt. Cuando incluyes medios insertados, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB + + Formato: `byte` + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de imágenes. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar de un muestreo de fotogramas a tasa fija. Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes. + + + + Un prompt de texto o un fragmento de código. + + + + Indica que esta parte es un paso de pensamiento/razonamiento del modelo. + + + + Valores posibles: `user`, `model` + + + + Configuraciones de muestreo, longitud y salida para la generación. Todos los campos son opcionales: los campos que se indican abajo con un `default` lo aplican cuando se omiten, y el resto recurre al comportamiento propio del modelo. + + + + Configuración para la generación de imágenes + + + + Relación de aspecto para las imágenes generadas + + + + Opcional. El formato de salida de imagen para las imágenes generadas. + + + + Opcional. La calidad de compresión de la imagen de salida. + + + + Opcional. El formato de imagen con el que se debe guardar la salida, en las rutas de Vertex AI: solicitudes atendidas por las credenciales propias de Comfy y solicitudes BYOK autenticadas con una cuenta de servicio de GCP. Allí los valores aceptados son `image/png` e `image/jpeg`, comparados sin distinguir mayúsculas y normalizados a minúsculas antes de reenviar la solicitud; cualquier otro valor se rechaza con un 400 que nombra este campo. Si se omite, el valor predeterminado es `image/png`. Una solicitud BYOK autenticada con una clave API de Google AI Studio es la excepción: ese upstream no tiene tal propiedad y rechaza toda la llamada si está presente, así que el campo se descarta de la solicitud en lugar de respetarse o rechazarse, y el formato de salida es el que elija AI Studio. En todas las rutas, lee el tipo de medio desde la parte de la respuesta que recibes (`inlineData.mimeType`, o `fileData.mimeType` cuando `uploadImagesToStorage` está establecido) en lugar de suponer el valor que enviaste. + + + + Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + + + + Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. + + Rango: `16` a `65536` + + + + + + + + Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los valores de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + La temperatura se usa para el muestreo durante la generación de la respuesta, que ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad en la selección de tokens. Las temperaturas más bajas son buenas para prompts que requieren una respuesta menos abierta o creativa, mientras que las temperaturas más altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 significa que siempre se seleccionan los tokens de mayor probabilidad. En este caso, las respuestas a un prompt dado son en su mayoría deterministas, pero aún es posible una pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, demasiado corta, o el modelo da una respuesta de reserva, intenta aumentar la temperatura + + Alcance: `0` a `2` + + Formato: `float` + + + + Opcional. Configuración para las funciones de razonamiento. El razonamiento es un proceso en el que el modelo descompone una tarea compleja en pasos más pequeños para generar una respuesta de mayor calidad. + + + + Opcional. Si es verdadero, el modelo incluirá sus razonamientos en la respuesta. + + + + Opcional. El presupuesto de tokens para el proceso de razonamiento del modelo. El modelo hará su mejor esfuerzo por mantenerse dentro de este presupuesto. + + + + Opcional. El nivel de razonamiento del modelo. + + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` + + + + Top-K cambia cómo el modelo selecciona los tokens para la salida. Un top-K de 1 significa que el siguiente token seleccionado es el más probable entre todos los tokens del vocabulario del modelo. Un top-K de 3 significa que el siguiente token se selecciona entre los 3 tokens más probables usando la temperatura. + + Alcance: `1` a `…` + + + + Si se especifica, se usa el muestreo de núcleo. +Top-P cambia cómo el modelo selecciona los tokens para la salida. Los tokens se seleccionan del más (ver top-K) al menos probable hasta que la suma de sus probabilidades sea igual al valor de top-P. Por ejemplo, si los tokens A, B y C tienen una probabilidad de 0.3, 0.2 y 0.1 y el valor de top-P es 0.5, entonces el modelo seleccionará A o B como el siguiente token usando la temperatura y excluirá a C como candidato. +Especifica un valor más bajo para respuestas menos aleatorias y un valor más alto para respuestas más aleatorias. + + Alcance: `0` a `1` + + Formato: `float` + + + + Configuraciones por solicitud para bloquear contenido inseguro. Se aplican a GenerateContentResponse.candidates. + + + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + Valores posibles: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + Instrucciones para orientar al modelo hacia un mejor rendimiento. Por ejemplo, "Responde de la forma más concisa posible" o "No uses términos técnicos en tu respuesta". Las cadenas de texto cuentan para el límite de tokens. El campo role de systemInstruction se ignora y no afecta el rendimiento del modelo. Nota: Solo se debe usar texto en las partes y el contenido de cada parte debe ir en un párrafo separado. + + + + Una lista de partes ordenadas que componen un solo mensaje. Distintas partes pueden tener distintos tipos MIME de IANA. Para conocer los límites de las entradas, como la cantidad máxima de tokens o la cantidad de imágenes, consulta las especificaciones del modelo en la página de modelos de Google. + + + + Un prompt de texto o un fragmento de código. + + + + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, por lo general un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones de un solo turno, este campo puede dejarse en blanco o sin definir. + + Valores posibles: `user`, `model` + + + + Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Llamada a funciones. + + + + + + + + + + + + + + Esquema JSON de los parámetros de la función + + + + Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URL firmadas en lugar de datos base64 en línea. Las URL caducan a las 24 horas. + + + + Para entrada de video, el desplazamiento de inicio y fin del video en formato Duration. Por ejemplo, para especificar un clip de 10 segundos que comienza en 1:00, establece "startOffset": \{ "seconds": 60 } y "endOffset": \{ "seconds": 70 }. Los metadatos solo deben especificarse mientras los datos del video se presenten en inlineData o fileData. + + + + Representa un desplazamiento de duración para posiciones en la línea de tiempo del video. + + + + Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. + + Alcance: `0` a `999999999` + + + + Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. + + Alcance: `-315576000000` a `315576000000` + + + + Representa un desplazamiento de duración para posiciones en la línea de tiempo del video. + + + + Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. + + Alcance: `0` a `999999999` + + + + Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. + + Alcance: `-315576000000` a `315576000000` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemini-4-carbon/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + + + + + + + + + + + + + + + + + + + + + + + + + Formato: `date` + + + + + + + + + + + + + + + + El contenido de la conversación actual con el modelo. Para consultas de un solo turno, esta es una única instancia. Para consultas de varios turnos, este es un campo repetido que contiene el historial de la conversación y la última solicitud. + + + + + + + + Datos basados en URI. + + + + URI + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Datos insertados en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. + + + + La codificación base64 de la imagen, PDF o video para incluir en línea en el prompt. Cuando incluyes medios en línea, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB + + Formato: `byte` + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a tasa fija. Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes. + + + + Un prompt de texto o un fragmento de código. + + + + Indica que esta parte es un paso de pensamiento/razonamiento del modelo. + + + + Valores posibles: `user`, `model` + + + + + + + + + + + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + La probabilidad de que el contenido infrinja la categoría de seguridad especificada + + Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + Marca de tiempo de cuándo se creó la respuesta. + + + + La versión del modelo usada para generar la respuesta. + + + + + + + + + + + + + + + + + + + + La probabilidad de que el contenido viole la categoría de seguridad especificada + + Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + Identificador único de la respuesta. + + + + + + + + Solo salida. Número de tokens en la parte almacenada en caché de la entrada (el contenido en caché). + + + + Número de tokens en la respuesta o respuestas. + + + + Desglose de los tokens de candidatos por modalidad. + + + + Tipo de modalidad del contenido de entrada o salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad indicada. + + + + Número de tokens en la solicitud. Cuando se establece cachedContent, este sigue siendo el tamaño total efectivo del prompt, lo que significa que incluye el número de tokens del contenido en caché. + + + + Desglose de los tokens del prompt por modalidad. + + + + Tipo de modalidad del contenido de entrada o salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad indicada. + + + + Número de tokens presentes en la salida de razonamiento. + + + + Número de tokens presentes en el prompt o prompts de uso de herramientas. + + + + Desglose de los tokens del prompt de uso de herramientas por modalidad. + + + + Tipo de modalidad del contenido de entrada o salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad indicada. + + + + Número total de tokens (prompt + candidatos). + + + + Tipo de tráfico usado para la solicitud (p. ej., PROVISIONED_THROUGHPUT). + + +## Ejemplos + +### Entrada + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### Salida + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-carbon", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + + diff --git a/es/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx b/es/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx new file mode 100644 index 0000000000..2cba85a610 --- /dev/null +++ b/es/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx @@ -0,0 +1,688 @@ +--- +title: "Usar Gemini 4 Hydrogen con Comfy Router" +description: "Llama a vertexai/gemini-4-hydrogen con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Gemini 4 Hydrogen" +translationSourceHash: 2fc4f945 +translationFrom: development/comfy-router/models/google/gemini-4-hydrogen/code.mdx +translationBlockHashes: + "_intro": 1792fa1e + "Quick start": 6dd0010d + "Schema": 3edab77e + "Examples": 3698dfec +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/vertexai/gemini-4-hydrogen.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `vertexai/gemini-4-hydrogen`, servido por Comfy Router desde Google. + +**Entrada:** Texto, Imagen, Audio, Video · **Salida:** Texto + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP directo. + +**Model ID:** `vertexai/gemini-4-hydrogen` + +**Endpoint:** `POST https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "vertexai/gemini-4-hydrogen", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("vertexai/gemini-4-hydrogen", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "vertexai/gemini-4-hydrogen", + { + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences.", + }, + ], + "role": "user", + }, + ], + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("vertexai/gemini-4-hydrogen", { + contents: [ + { + parts: [ + { + text: "Describe a robot learning to paint, in two sentences.", + }, + ], + role: "user", + }, + ], +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + El contenido de la conversación actual con el modelo. Para consultas de un solo turno, es una única instancia. Para consultas de varios turnos, es un campo repetido que contiene el historial de la conversación y la solicitud más reciente. + + + + + + + + Datos basados en URI. + + + + URI + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. + + + + La codificación base64 de la imagen, PDF o video que se incluirá en línea en el prompt. Cuando incluyas medios en línea, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB + + Formato: `byte` + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a tasa fija. Omítelo para usar el muestreo de tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes. + + + + Un prompt de texto o fragmento de código. + + + + Indica que esta parte es un paso de pensamiento/razonamiento del modelo. + + + + Valores posibles: `user`, `model` + + + + Configuraciones de muestreo, longitud y salida para la generación. Todos los campos son opcionales: los campos a continuación que declaran un `default` lo aplican cuando se omiten, y el resto recurre al comportamiento propio del modelo. + + + + Configuración para la generación de imágenes + + + + Relación de aspecto para las imágenes generadas + + + + Opcional. El formato de salida de imagen para las imágenes generadas. + + + + Opcional. La calidad de compresión de la imagen de salida. + + + + Opcional. El formato de imagen con el que se debe guardar la salida, en las rutas de Vertex AI: solicitudes atendidas con las credenciales propias de Comfy, y solicitudes BYOK autenticadas con una cuenta de servicio de GCP. Los valores aceptados allí son `image/png` e `image/jpeg`, comparados sin distinguir mayúsculas y normalizados a minúsculas antes de reenviar la solicitud; cualquier otro valor se rechaza con un 400 que nombra este campo. El valor predeterminado es `image/png` cuando se omite. Una solicitud BYOK autenticada con una clave API de Google AI Studio es la excepción: ese upstream no tiene tal propiedad y rechaza toda la llamada si está presente, así que el campo se descarta de la solicitud en lugar de respetarse o rechazarse, y el formato de salida es el que elija AI Studio. En todas las rutas, vuelve a leer el tipo de medio desde la parte de la respuesta que recibes (`inlineData.mimeType`, o `fileData.mimeType` cuando `uploadImagesToStorage` está establecido) en lugar de suponer el valor que enviaste. + + + + Opcional. Especifica el tamaño de las imágenes generadas. Los valores compatibles son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + + + + Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. + + Alcance: `16` a `65536` + + + + + + +Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se utiliza un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + + + + + + + La temperatura se usa para el muestreo durante la generación de la respuesta, que ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad en la selección de tokens. Las temperaturas más bajas son buenas para prompts que requieren una respuesta menos abierta o creativa, mientras que las temperaturas más altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 significa que siempre se seleccionan los tokens de mayor probabilidad. En este caso, las respuestas para un prompt dado son en su mayoría deterministas, pero aún es posible una pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, demasiado corta, o si el modelo da una respuesta de reserva, intenta aumentar la temperatura. + + Alcance: `0` a `2` + + Formato: `float` + + + + Opcional. Configuración para las funciones de razonamiento. El razonamiento es un proceso en el que el modelo descompone una tarea compleja en pasos más pequeños para generar una respuesta de mayor calidad. + + + + Opcional. Si es verdadero, el modelo incluirá sus razonamientos en la respuesta. + + + + Opcional. El presupuesto de tokens para el proceso de razonamiento del modelo. El modelo hará su mejor esfuerzo por mantenerse dentro de este presupuesto. + + + + Opcional. El nivel de razonamiento del modelo. + + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` + + + + Top-K cambia la forma en que el modelo selecciona los tokens de salida. Un top-K de 1 significa que el siguiente token seleccionado es el más probable entre todos los tokens del vocabulario del modelo. Un top-K de 3 significa que el siguiente token se selecciona entre los 3 tokens más probables usando la temperatura. + + Alcance: `1` a `…` + + + + Si se especifica, se utiliza el muestreo de núcleo. +Top-P cambia la forma en que el modelo selecciona los tokens de salida. Los tokens se seleccionan del más (consulta top-K) al menos probable hasta que la suma de sus probabilidades sea igual al valor de top-P. Por ejemplo, si los tokens A, B y C tienen una probabilidad de 0.3, 0.2 y 0.1 y el valor de top-P es 0.5, entonces el modelo seleccionará A o B como el siguiente token usando la temperatura y excluirá a C como candidato. +Especifica un valor más bajo para respuestas menos aleatorias y un valor más alto para respuestas más aleatorias. + + Alcance: `0` a `1` + + Formato: `float` + + + + Configuraciones por solicitud para bloquear contenido no seguro. Se aplican a GenerateContentResponse.candidates. + + + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + Valores posibles: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + + + + Instrucciones para orientar al modelo hacia un mejor rendimiento. Por ejemplo, "Responde de la forma más concisa posible" o "No uses términos técnicos en tu respuesta". Las cadenas de texto cuentan para el límite de tokens. El campo role de systemInstruction se ignora y no afecta el rendimiento del modelo. Nota: Solo se debe usar texto en las partes, y el contenido de cada parte debe ir en un párrafo separado. + + + + Una lista de partes ordenadas que componen un solo mensaje. Las distintas partes pueden tener distintos tipos MIME de IANA. Para conocer los límites de las entradas, como el número máximo de tokens o el número de imágenes, consulta las especificaciones del modelo en la página de modelos de Google. + + + + Un prompt de texto o un fragmento de código. + + + + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones de un solo turno, este campo puede dejarse en blanco o sin definir. + + Valores posibles: `user`, `model` + + + + Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Llamada a funciones. + + + + + + + + + + + + + + Esquema JSON para los parámetros de la función + + + + Si es verdadero, las imágenes generadas se suben al almacenamiento en la nube y se devuelven como URLs firmadas en lugar de datos base64 en línea. Las URLs vencen después de 24 horas. + + + + Para entrada de video, el desplazamiento de inicio y de fin del video en formato Duration. Por ejemplo, para especificar un clip de 10 segundos que comienza en 1:00, define "startOffset": \{ "seconds": 60 } y "endOffset": \{ "seconds": 70 }. Los metadatos solo deben especificarse mientras los datos del video se presentan en inlineData o fileData. + + + + Representa un desplazamiento de duración para posiciones de la línea de tiempo del video. + + + + Fracciones de segundo con signo y resolución de nanosegundos. Los valores de segundos negativos con fracciones deben seguir teniendo valores de nanos no negativos. + + Alcance: `0` a `999999999` + + + + Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. + + Alcance: `-315576000000` a `315576000000` + + + + Representa un desplazamiento de duración para posiciones de la línea de tiempo del video. + + + + Fracciones de segundo con signo y resolución de nanosegundos. Los valores de segundos negativos con fracciones deben seguir teniendo valores de nanos no negativos. + + Alcance: `0` a `999999999` + + + + Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. + + Alcance: `-315576000000` a `315576000000` + + +Generado a partir del esquema que Router publica en `GET /v2/models/vertexai/gemini-4-hydrogen/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + + + + + + + + + + + + + + + + + + + + + + + + + Formato: `date` + + + + + + + + + + + + + + + + El contenido de la conversación actual con el modelo. Para consultas de un solo turno, esta es una única instancia. Para consultas de varios turnos, este es un campo repetido que contiene el historial de la conversación y la última solicitud. + + + + + + + + Datos basados en URI. + + + + URI + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de la imagen. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. + + + + La codificación base64 de la imagen, PDF o video que se incluirá en línea en el prompt. Cuando incluyas contenido multimedia en línea, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB + + Formato: `byte` + + + + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de la imagen. + + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + + + + Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a tasa fija. Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes. + + + + Un prompt de texto o fragmento de código. + + + + Indica que esta parte es un paso de pensamiento/razonamiento del modelo. + + + + Valores posibles: `user`, `model` + + + + + + + + + + + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + La probabilidad de que el contenido infrinja la categoría de seguridad especificada + + Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + Marca de tiempo de cuándo se creó la respuesta. + + + + La versión del modelo usada para generar la respuesta. + + + + + + + + + + + + + + + + + + + +Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + + + La probabilidad de que el contenido infrinja la categoría de seguridad especificada + + Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + + + + Identificador único de la respuesta. + + + + + + + + Solo salida. Número de tokens en la parte en caché de la entrada (el contenido en caché). + + + + Número de tokens en la respuesta o respuestas. + + + + Desglose de los tokens de los candidatos por modalidad. + + + + Tipo de modalidad del contenido de entrada o salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad indicada. + + + + Número de tokens de la solicitud. Cuando se establece cachedContent, este sigue siendo el tamaño total efectivo del prompt, lo que significa que incluye el número de tokens del contenido en caché. + + + + Desglose de los tokens del prompt por modalidad. + + + + Tipo de modalidad del contenido de entrada o salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad indicada. + + + + Número de tokens presentes en la salida de pensamientos. + + + + Número de tokens presentes en el prompt o prompts de uso de herramientas. + + + + Desglose de los tokens del prompt de uso de herramientas por modalidad. + + + + Tipo de modalidad del contenido de entrada o salida. + + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + + + + Número de tokens para la modalidad indicada. + + + + Número total de tokens (prompt + candidatos). + + + + Tipo de tráfico usado para la solicitud (p. ej., PROVISIONED_THROUGHPUT). + + +## Ejemplos + +### Entrada + +```json +{ + "contents": [ + { + "parts": [ + { + "text": "Describe a robot learning to paint, in two sentences." + } + ], + "role": "user" + } + ] +} +``` + +### Salida + +```json +{ + "candidates": [ + { + "content": { + "parts": [ + { + "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up." + } + ], + "role": "model" + }, + "finishReason": "STOP" + } + ], + "modelVersion": "gemini-4-hydrogen", + "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b", + "usageMetadata": { + "candidatesTokenCount": 21, + "promptTokenCount": 12, + "totalTokenCount": 33 + } +} +``` + + + diff --git a/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx b/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx index ee72d5d4a7..c83fed8e80 100644 --- a/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx +++ b/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx @@ -2,16 +2,17 @@ title: "Usa Gemini Nano Banana 2.1 con Comfy Router" description: "Llama a vertexai/gemini-nano-banana-2.1 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Gemini Nano Banana 2.1" -translationSourceHash: 6f9161dd +translationSourceHash: 833b248e translationFrom: development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx translationBlockHashes: "_intro": 5cb6762b "Quick start": df454451 "Serving providers": af126fd5 - "Schema": 02b80e67 + "Schema": 2313ddad "Examples": dff3e9f8 --- + {/* GENERATED FILE. Generated from router-schemas/vertexai/gemini-nano-banana-2.1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -193,9 +194,7 @@ El valor predeterminado de `strict_mode` es `false`, así que Router traduce el ### Entrada - El contenido de la conversación actual con el modelo. Para consultas de un solo turno, -es una única instancia. Para consultas de varios turnos, es un campo repetido que -contiene el historial de la conversación y la solicitud más reciente. + El contenido de la conversación actual con el modelo. Para consultas de un solo turno, es una única instancia. Para consultas de varios turnos, es un campo repetido que contiene el historial de la conversación y la solicitud más reciente. @@ -211,53 +210,29 @@ contiene el historial de la conversación y la solicitud más reciente. - El tipo de medio del archivo especificado en los campos data o fileUri. Los valores -aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la -duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un -archivo de video (sin audio) es de una hora. Para obtener más información, consulta los -requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en -UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite -en la resolución de las imágenes. + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. - Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, -`image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, -`video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, -`image/heic`, `image/heif`, `audio/flac`, `video/webm` + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, -puedes especificar hasta 3000 imágenes usando inlineData. + Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. - La codificación base64 de la imagen, el PDF o el video que se va a incluir en línea en -el prompt. Cuando incluyes medios en línea, también debes especificar el tipo de medio -(mimeType) de los datos. Límite de tamaño: 20MB + La codificación base64 de la imagen, el PDF o el video que se va a incluir en línea en el prompt. Cuando incluyes medios en línea, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB Formato: `byte` - El tipo de medio del archivo especificado en los campos data o fileUri. Los valores -aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la -duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un -archivo de video (sin audio) es de una hora. Para obtener más información, consulta los -requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en -UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite -en la resolución de las imágenes. + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. - Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, -`image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, -`video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, -`image/heic`, `image/heif`, `audio/flac`, `video/webm` + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo -decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a tasa fija. -Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con -gemini-3.7-flash y modelos Flash más recientes. + Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a tasa fija. Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes. @@ -273,9 +248,7 @@ gemini-3.7-flash y modelos Flash más recientes. - Configuraciones de muestreo, longitud y salida para la generación. Todos los campos -son opcionales: los campos siguientes que declaran un `default` lo aplican cuando se -omiten, y el resto recurre al comportamiento propio del modelo. + Configuraciones de muestreo, longitud y salida para la generación. Todos los campos son opcionales: los campos siguientes que declaran un `default` lo aplican cuando se omiten, y el resto recurre al comportamiento propio del modelo. @@ -295,46 +268,24 @@ omiten, y el resto recurre al comportamiento propio del modelo. - Opcional. El formato de imagen con el que se debe guardar la salida, en las rutas de -Vertex AI: las solicitudes atendidas con las credenciales propias de Comfy y las -solicitudes BYOK autenticadas con una cuenta de servicio de GCP. Allí los valores -aceptados son `image/png` y `image/jpeg`, que se comparan sin distinguir mayúsculas y se -normalizan a minúsculas antes de reenviar la solicitud; cualquier otro valor se rechaza -con un error 400 que nombra este campo. Si se omite, el valor predeterminado es -`image/png`. La excepción es una solicitud BYOK autenticada con una clave API de Google -AI Studio: ese upstream no tiene tal propiedad y rechaza toda la llamada si está -presente, así que el campo se elimina de la solicitud en lugar de respetarse o -rechazarse, y el formato de salida es el que elija AI Studio. En todas las rutas, lee el -tipo de medio desde la parte de la respuesta que recibes (`inlineData.mimeType`, o -`fileData.mimeType` cuando `uploadImagesToStorage` está configurado) en lugar de suponer -el valor que enviaste. + Opcional. El formato de imagen con el que se debe guardar la salida, en las rutas de Vertex AI: las solicitudes atendidas con las credenciales propias de Comfy y las solicitudes BYOK autenticadas con una cuenta de servicio de GCP. Allí los valores aceptados son `image/png` y `image/jpeg`, que se comparan sin distinguir mayúsculas y se normalizan a minúsculas antes de reenviar la solicitud; cualquier otro valor se rechaza con un error 400 que nombra este campo. Si se omite, el valor predeterminado es `image/png`. La excepción es una solicitud BYOK autenticada con una clave API de Google AI Studio: ese upstream no tiene tal propiedad y rechaza toda la llamada si está presente, así que el campo se elimina de la solicitud en lugar de respetarse o rechazarse, y el formato de salida es el que elija AI Studio. En todas las rutas, lee el tipo de medio desde la parte de la respuesta que recibes (`inlineData.mimeType`, o `fileData.mimeType` cuando `uploadImagesToStorage` está configurado) en lugar de suponer el valor que enviaste. - Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son -1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. - Número máximo de tokens que se pueden generar en la respuesta. Un token equivale -aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. + Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Rango: `16` a `65536` + Alcance: `16` a `65536` - - Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por -ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida -determinista. Además, cambiar el modelo o las configuraciones de los parámetros, como la -temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo -valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. -Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, -gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, -gemini-2.0-flash-001 + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -342,15 +293,7 @@ gemini-2.0-flash-001 - La temperatura se usa para el muestreo durante la generación de la respuesta, que -ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad -en la selección de tokens. Las temperaturas más bajas son buenas para prompts que -requieren una respuesta menos abierta o creativa, mientras que las temperaturas más -altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 -significa que siempre se seleccionan los tokens de mayor probabilidad. En este caso, las -respuestas a un prompt dado son en su mayoría deterministas, pero todavía es posible una -pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, -demasiado corta, o da una respuesta de reserva, prueba a aumentar la temperatura + La temperatura se usa para el muestreo durante la generación de la respuesta, que ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad en la selección de tokens. Las temperaturas más bajas son buenas para prompts que requieren una respuesta menos abierta o creativa, mientras que las temperaturas más altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 significa que siempre se seleccionan los tokens de mayor probabilidad. En este caso, las respuestas a un prompt dado son en su mayoría deterministas, pero todavía es posible una pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, demasiado corta, o da una respuesta de reserva, prueba a aumentar la temperatura Rango: `0` a `2` @@ -358,9 +301,7 @@ demasiado corta, o da una respuesta de reserva, prueba a aumentar la temperatura - Opcional. Configuración para las funciones de pensamiento. El pensamiento es un -proceso en el que el modelo descompone una tarea compleja en pasos más pequeños para -generar una respuesta de mayor calidad. + Opcional. Configuración para las funciones de pensamiento. El pensamiento es un proceso en el que el modelo descompone una tarea compleja en pasos más pequeños para generar una respuesta de mayor calidad. @@ -368,33 +309,23 @@ generar una respuesta de mayor calidad. - Opcional. El presupuesto de tokens para el proceso de pensamiento del modelo. El -modelo hará su mejor esfuerzo por mantenerse dentro de este presupuesto. + Opcional. El presupuesto de tokens para el proceso de pensamiento del modelo. El modelo hará su mejor esfuerzo por mantenerse dentro de este presupuesto. Opcional. El nivel de pensamiento del modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` - Top-K cambia cómo el modelo selecciona los tokens para la salida. Un top-K de 1 -significa que el siguiente token seleccionado es el más probable entre todos los tokens -del vocabulario del modelo. Un top-K de 3 significa que el siguiente token se selecciona -entre los 3 tokens más probables usando la temperatura. + Top-K cambia cómo el modelo selecciona los tokens para la salida. Un top-K de 1 significa que el siguiente token seleccionado es el más probable entre todos los tokens del vocabulario del modelo. Un top-K de 3 significa que el siguiente token se selecciona entre los 3 tokens más probables usando la temperatura. Rango: `1` a `…` - Si se especifica, se usa el muestreo de núcleo (nucleus sampling). Top-P cambia cómo -el modelo selecciona los tokens para la salida. Los tokens se seleccionan del más (ver -top-K) al menos probable hasta que la suma de sus probabilidades iguale el valor de -top-P. Por ejemplo, si los tokens A, B y C tienen una probabilidad de 0.3, 0.2 y 0.1 y -el valor de top-P es 0.5, entonces el modelo seleccionará A o B como el siguiente token -usando la temperatura y excluirá a C como candidato. Especifica un valor más bajo para -respuestas menos aleatorias y un valor más alto para respuestas más aleatorias. + Si se especifica, se usa el muestreo de núcleo (nucleus sampling). Top-P cambia cómo el modelo selecciona los tokens para la salida. Los tokens se seleccionan del más (ver top-K) al menos probable hasta que la suma de sus probabilidades iguale el valor de top-P. Por ejemplo, si los tokens A, B y C tienen una probabilidad de 0.3, 0.2 y 0.1 y el valor de top-P es 0.5, entonces el modelo seleccionará A o B como el siguiente token usando la temperatura y excluirá a C como candidato. Especifica un valor más bajo para respuestas menos aleatorias y un valor más alto para respuestas más aleatorias. Rango: `0` a `1` @@ -402,33 +333,23 @@ respuestas menos aleatorias y un valor más alto para respuestas más aleatorias - Configuraciones por solicitud para bloquear contenido no seguro. Se aplican en -GenerateContentResponse.candidates. + Configuraciones por solicitud para bloquear contenido no seguro. Se aplican en GenerateContentResponse.candidates. - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, -`HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - Valores posibles: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, -`BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` + Valores posibles: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` - Instrucciones para el modelo para orientarlo hacia un mejor rendimiento. Por ejemplo, -"Responde de la forma más concisa posible" o "No uses términos técnicos en tu -respuesta". Las cadenas de texto cuentan para el límite de tokens. El campo role de -systemInstruction se ignora y no afecta el rendimiento del modelo. Nota: Solo se debe -usar texto en las partes y el contenido de cada parte debe estar en un párrafo separado. + Instrucciones para el modelo para orientarlo hacia un mejor rendimiento. Por ejemplo, "Responde de la forma más concisa posible" o "No uses términos técnicos en tu respuesta". Las cadenas de texto cuentan para el límite de tokens. El campo role de systemInstruction se ignora y no afecta el rendimiento del modelo. Nota: Solo se debe usar texto en las partes y el contenido de cada parte debe estar en un párrafo separado. - Una lista de partes ordenadas que componen un solo mensaje. Las distintas partes -pueden tener distintos tipos MIME de IANA. Para conocer los límites de las entradas, -como el número máximo de tokens o el número de imágenes, consulta las especificaciones -del modelo en la página de modelos de Google. + Una lista de partes ordenadas que componen un solo mensaje. Las distintas partes pueden tener distintos tipos MIME de IANA. Para conocer los límites de las entradas, como el número máximo de tokens o el número de imágenes, consulta las especificaciones del modelo en la página de modelos de Google. @@ -436,20 +357,13 @@ del modelo en la página de modelos de Google. - La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: -user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado -por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa -para insertar mensajes del modelo en la conversación durante conversaciones de varios -turnos. En conversaciones que no son de varios turnos, este campo puede dejarse en -blanco o sin definir. + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones que no son de varios turnos, este campo puede dejarse en blanco o sin definir. Valores posibles: `user`, `model` - Un fragmento de código que permite al sistema interactuar con sistemas externos para -realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del -modelo. Consulta Llamada a funciones. + Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Llamada a funciones. @@ -462,60 +376,46 @@ modelo. Consulta Llamada a funciones. - - - + Esquema JSON para los parámetros de la función - Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se -devolverán como URLs firmadas en lugar de datos base64 en línea. Las URLs caducan -después de 24 horas. + Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URLs firmadas en lugar de datos base64 en línea. Las URLs caducan después de 24 horas. - Para entrada de video, el desplazamiento de inicio y fin del video en formato -Duration. Por ejemplo, para especificar un clip de 10 segundos que comienza en 1:00, -define "startOffset": \{ "seconds": 60 } y "endOffset": \{ "seconds": 70 }. Los -metadatos solo deben especificarse mientras los datos del video se presenten en -inlineData o fileData. + Para entrada de video, el desplazamiento de inicio y fin del video en formato Duration. Por ejemplo, para especificar un clip de 10 segundos que comienza en 1:00, define "startOffset": \{ "seconds": 60 } y "endOffset": \{ "seconds": 70 }. Solo debes especificar los metadatos mientras los datos del video vengan en inlineData o fileData. - Representa un desplazamiento de duración para posiciones de la línea de tiempo del -video. + Representa un desplazamiento de duración para las posiciones de la línea de tiempo del video. - Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de -segundos con fracciones deben seguir teniendo valores de nanos no negativos. + Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. Rango: `0` a `999999999` - Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y -+315,576,000,000 inclusive. + Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. Rango: `-315576000000` a `315576000000` - Representa un desplazamiento de duración para posiciones de la línea de tiempo del -video. + Representa un desplazamiento de duración para las posiciones de la línea de tiempo del video. - Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de -segundos con fracciones deben seguir teniendo valores de nanos no negativos. + Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. Rango: `0` a `999999999` - Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y -+315,576,000,000 inclusive. + Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. Rango: `-315576000000` a `315576000000` @@ -565,9 +465,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - El contenido de la conversación actual con el modelo. Para consultas de un solo turno, -esta es una única instancia. Para consultas de varios turnos, este es un campo repetido -que contiene el historial de la conversación y la última solicitud. + El contenido de la conversación actual con el modelo. Para consultas de un solo turno, esta es una única instancia. Para consultas de varios turnos, este es un campo repetido que contiene el historial de la conversación y la última solicitud. @@ -583,53 +481,29 @@ que contiene el historial de la conversación y la última solicitud. - El tipo de medio del archivo especificado en los campos data o fileUri. Los valores -aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la -duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un -archivo de video (sin audio) es de una hora. Para obtener más información, consulta los -requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en -UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite -en la resolución de las imágenes. + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. - Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, -`image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, -`video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, -`image/heic`, `image/heif`, `audio/flac`, `video/webm` + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, -puedes especificar hasta 3000 imágenes usando inlineData. + Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. - La codificación base64 de la imagen, PDF o video que se incluirá en línea en el -prompt. Cuando incluyas medios en línea, también debes especificar el tipo de medio -(mimeType) de los datos. Límite de tamaño: 20MB + La codificación base64 de la imagen, PDF o video que se incluirá en línea en el prompt. Cuando incluyas medios en línea, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB Formato: `byte` - El tipo de medio del archivo especificado en los campos data o fileUri. Los valores -aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la -duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un -archivo de video (sin audio) es de una hora. Para obtener más información, consulta los -requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en -UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite -en la resolución de las imágenes. + El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes. - Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, -`image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, -`video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, -`image/heic`, `image/heif`, `audio/flac`, `video/webm` + Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` - Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo -decida qué segmentos inspeccionar, en lugar de usar un muestreo de fotogramas a tasa -fija. Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con -gemini-3.7-flash y modelos Flash más recientes. + Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar de usar un muestreo de fotogramas a tasa fija. Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes. @@ -653,8 +527,7 @@ gemini-3.7-flash y modelos Flash más recientes. - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, -`HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` @@ -687,9 +560,8 @@ gemini-3.7-flash y modelos Flash más recientes. - - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, -`HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` @@ -707,8 +579,7 @@ gemini-3.7-flash y modelos Flash más recientes. - Solo salida. Número de tokens en la parte almacenada en caché de la entrada (el -contenido en caché). + Solo salida. Número de tokens en la parte almacenada en caché de la entrada (el contenido en caché). @@ -722,8 +593,7 @@ contenido en caché). Tipo de modalidad del contenido de entrada o salida. - Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, -`DOCUMENT` + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -731,9 +601,7 @@ contenido en caché). - Número de tokens en la solicitud. Cuando se establece cachedContent, este sigue siendo -el tamaño total efectivo del prompt, lo que significa que incluye el número de tokens -del contenido en caché. + Número de tokens en la solicitud. Cuando se establece cachedContent, este sigue siendo el tamaño total efectivo del prompt, lo que significa que incluye el número de tokens del contenido en caché. @@ -743,8 +611,7 @@ del contenido en caché. Tipo de modalidad del contenido de entrada o salida. - Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, -`DOCUMENT` + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -766,8 +633,7 @@ del contenido en caché. Tipo de modalidad del contenido de entrada o salida. - Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, -`DOCUMENT` + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/es/development/comfy-router/models/google/gemini/code.mdx b/es/development/comfy-router/models/google/gemini/code.mdx index d6949cc725..dfeba623ad 100644 --- a/es/development/comfy-router/models/google/gemini/code.mdx +++ b/es/development/comfy-router/models/google/gemini/code.mdx @@ -2,7 +2,7 @@ title: "Usa Google Gemini con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para llamar a modelos de texto de Google Gemini por HTTP con Comfy Router; campos de solicitud y forma del resultado." sidebarTitle: "Google Gemini" -translationSourceHash: ccf669d3 +translationSourceHash: 0958828b translationFrom: development/comfy-router/models/google/gemini/code.mdx --- @@ -326,7 +326,7 @@ La codificación base64 de la imagen, el PDF o el video que se incluye en línea Opcional. El nivel de razonamiento del modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -1017,7 +1017,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST Opcional. El nivel de razonamiento del modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` diff --git a/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index 714733ba8b..f6764d9a70 100644 --- a/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -2,14 +2,15 @@ title: "Usa Nano Banana 2 Lite con Comfy Router" description: "Ejemplos de Python, TypeScript y cURL para generar imágenes con Nano Banana 2 Lite (Gemini 3.1 Flash-Lite Image) en Comfy Router y sus campos de solicitud" sidebarTitle: "Nano Banana 2 Lite" -translationSourceHash: 6381740d +translationSourceHash: 75deda90 translationFrom: development/comfy-router/models/google/nano-banana-2-lite/code.mdx translationBlockHashes: "_intro": 9a5badea "Quick start": 0622ad83 - "Schema": ededaa40 + "Schema": 3b274fc9 "Examples": d294783d --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -290,21 +291,20 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K y 4K. Si no se especifica, el modelo usa el valor predeterminado 1K. - Cantidad máxima de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. + Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Rango: `16` a `65536` + Alcance: `16` a `65536` - - Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -334,7 +334,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques Opcional. El nivel de pensamiento del modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -378,13 +378,13 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En las conversaciones de un solo turno, este campo puede dejarse en blanco o sin establecer. + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones de un solo turno, este campo puede dejarse vacío o sin definir. Valores posibles: `user`, `model` - Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Function calling. + Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Llamada a funciones. @@ -532,7 +532,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Indica que esta parte es un paso de razonamiento del modelo. + Indica que esta parte es un paso de pensamiento y razonamiento del modelo. @@ -581,14 +581,13 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` +Posibles valores: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` La probabilidad de que el contenido infrinja la categoría de seguridad especificada - Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + Posibles valores: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -614,7 +613,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin Tipo de modalidad del contenido de entrada o de salida. - Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Posibles valores: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -632,7 +631,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin Tipo de modalidad del contenido de entrada o de salida. - Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Posibles valores: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -654,7 +653,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin Tipo de modalidad del contenido de entrada o de salida. - Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Posibles valores: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/es/development/comfy-router/models/google/nano-banana-2/code.mdx b/es/development/comfy-router/models/google/nano-banana-2/code.mdx index 4b51c66688..1723d03f72 100644 --- a/es/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -2,17 +2,18 @@ title: "Usa Nano Banana 2 con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para generar imágenes con Nano Banana 2 (Gemini 3.1 Flash Image) a través de Comfy Router, y campos de la solicitud" sidebarTitle: "Nano Banana 2" -translationSourceHash: f8c4ed89 +translationSourceHash: 8183f2d5 translationFrom: development/comfy-router/models/google/nano-banana-2/code.mdx translationBlockHashes: "_intro": e6f85ac2 "Quick start": 7fb17070 "Serving providers": a9deb946 - "Schema": 63c93920 + "Schema": a266962e "Examples": d294783d --- + {/* ARCHIVO GENERADO. Edita code.yaml en este directorio y ejecuta `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -313,15 +314,14 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Rango: `16` a `65536` + Alcance: `16` a `65536` - - Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por proporcionar la misma respuesta para solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de parámetros, como la temperatura, puede causar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 +Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por proporcionar la misma respuesta para solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de parámetros, como la temperatura, puede causar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -351,7 +351,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot Opcional. El nivel de pensamiento para el modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -395,13 +395,13 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: Esto indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: Esto indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. Para conversaciones que no son de varios turnos, este campo se puede dejar en blanco o sin configurar. + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En las conversaciones que no son de varios turnos, este campo puede dejarse vacío o sin definir. Valores posibles: `user`, `model` - Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y alcance del modelo. Consulta Llamada a funciones. + Una pieza de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Llamada a funciones. @@ -421,7 +421,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Si es verdadero, las imágenes generadas se suben al almacenamiento en la nube y se devuelven como URLs firmadas en lugar de datos base64 en línea. Las URLs caducan a las 24 horas. + Si es verdadero, las imágenes generadas se suben al almacenamiento en la nube y se devuelven como URLs firmadas en lugar de datos base64 en línea. Las URLs caducan después de 24 horas. @@ -600,7 +600,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx index 21dd209608..c55fbf8b55 100644 --- a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -2,16 +2,17 @@ title: "Usa Nano Banana Pro con Comfy Router" description: "Fragmentos de Python, TypeScript y cURL para generar imágenes con Nano Banana Pro (Gemini 3 Pro Image) mediante Comfy Router, además de los campos de solicitud" sidebarTitle: "Nano Banana Pro" -translationSourceHash: 48881f72 +translationSourceHash: 63f6b907 translationFrom: development/comfy-router/models/google/nano-banana-pro/code.mdx translationBlockHashes: "_intro": 34f7de08 "Quick start": b78c780a "Serving providers": caff9b45 - "Schema": b9a919e8 + "Schema": 9094176d "Examples": 54f56549 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -306,22 +307,20 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot - Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. + Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K y 4K. Si no se especifica, el modelo usará el valor predeterminado 1K. Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Rango: `16` a `65536` + Alcance: `16` a `65536` - - -Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo para proporcionar la misma respuesta en solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo para proporcionar la misma respuesta en solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -351,7 +350,7 @@ Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuer Opcional. El nivel de pensamiento para el modelo. - Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` + Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH` @@ -395,7 +394,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: Esto indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: Esto indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. Para conversaciones que no son de varios turnos, este campo puede dejarse en blanco o sin establecer. + La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones que no son de varios turnos, este campo puede dejarse en blanco o sin establecer. Valores posibles: `user`, `model` @@ -414,9 +413,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - - - + Esquema JSON para los parámetros de la función @@ -425,7 +422,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Para la entrada de video, el desplazamiento de inicio y fin del video en formato Duration. Por ejemplo, para especificar un clip de 10 segundos que comienza en 1:00, establece "startOffset": \{ "seconds": 60 } y "endOffset": \{ "seconds": 70 }. Los metadatos solo deben especificarse mientras los datos del video se presentan en inlineData o fileData. + Para la entrada de video, el desplazamiento de inicio y fin del video en formato Duration. Por ejemplo, para especificar un clip de 10 segundos que comienza en 1:00, establece "startOffset": \{ "seconds": 60 } y "endOffset": \{ "seconds": 70 }. Especifica los metadatos solo cuando los datos del video vengan en inlineData o fileData. @@ -600,7 +597,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index e3e9181792..c0bf96c7af 100644 --- a/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -2,15 +2,16 @@ title: "Usa Kling V2.5 Turbo con Comfy Router" description: "Llama a kling/kling-v2-5-turbo a través de Comfy Router: punto de acceso, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Kling V2.5 Turbo" -translationSourceHash: 06b3d8e9 +translationSourceHash: 3bbe1969 translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx translationBlockHashes: "_intro": 785eeca2 "Quick start": dc63b3ac - "Schema": e36b5646 + "Schema": a24874ef "Examples": 8623c725 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-v2-5-turbo.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -165,7 +166,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - La dirección de notificación de callback. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. + La dirección de notificación de callback. Se ignora: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. Formato: `uri` @@ -235,13 +236,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - ID de tarea personalizado. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. - - - - Modo de generación de video. std: Modo Estándar, con buena relación costo-beneficio. pro: Modo Profesional, genera videos de mayor duración con una salida de mayor calidad. - - Valores posibles: `std`, `pro` + ID de tarea personalizado. Se ignora: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. @@ -265,11 +260,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - Indica si se genera un video de múltiples planos. Cuando es true, el parámetro prompt no es válido. Cuando es false, los parámetros shot_type y multi_prompt no son válidos. + Indica si se debe generar un video de múltiples planos. Cuando es true, el parámetro prompt no es válido. Cuando es false, los parámetros shot_type y multi_prompt no son válidos. - Prompt de texto negativo. Se recomienda complementar la información del prompt negativo mediante oraciones negativas directamente dentro de los prompts positivos. + Prompt de texto negativo. Se recomienda complementar la información del prompt negativo con oraciones negativas directamente dentro de los prompts positivos. @@ -283,13 +278,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - Indica si se genera sonido de forma simultánea al generar videos. Solo las versiones V2.6 y posteriores del modelo admiten este parámetro. + Indica si se debe generar sonido de forma simultánea al generar videos. Solo las versiones V2.6 y posteriores del modelo admiten este parámetro. Valores posibles: `on`, `off` - Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; referéncialas en `prompt` como \<\<\>> y \<\<\>> en el orden de la lista. Requiere que `sound` esté definido en "on", lo cual solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o si `sound` se deja en su valor predeterminado "off", las voces no se aplican. + Lista de voces que se usan como referencia al generar videos. Admite hasta 2 voces; haz referencia a ellas en `prompt` como \<\<\>> y \<\<\>> en el orden de la lista. Requiere que `sound` esté establecido en "on", lo cual solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o si `sound` se deja en su valor predeterminado "off", las voces no se aplican. @@ -297,21 +292,26 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID - Indica si se generan resultados con marca de agua de forma simultánea. Actualmente no se admiten marcas de agua personalizadas. + Indica si se deben generar resultados con marca de agua de forma simultánea. Actualmente no se admite una marca de agua personalizada. true significa generar marca de agua, false significa no generarla. - - Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, resolución no inferior a 300*300px, relación de aspecto entre 1:2.5 y 2.5:1. Base64 no debe incluir el prefijo data:image. + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, resolución no inferior a 300*300px, relación de aspecto entre 1:2.5 y 2.5:1. Base64 no debe incluir el prefijo data:image. Imagen de referencia: control del fotograma final. URL o cadena codificada en Base64, no puede superar los 10MB, resolución no inferior a 300*300px. Base64 no debe incluir el prefijo data:image. No se puede usar simultáneamente con dynamic_masks/static_mask ni con camera_control. + + Modo de generación de video. std: Modo estándar, que resulta económico. pro: Modo profesional, genera videos de mayor duración pero con resultados de mayor calidad. + + Valores posibles: `std`, `pro` + + Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v2-5-turbo/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -329,7 +329,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v2 - Las unidades deducidas de la tarea + Unidades de deducción de la tarea diff --git a/es/development/comfy-router/models/kling/kling-v2-6/code.mdx b/es/development/comfy-router/models/kling/kling-v2-6/code.mdx index ed0456a01d..313e7c60f9 100644 --- a/es/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -2,15 +2,16 @@ title: "Usa Kling V2.6 con Comfy Router" description: "Llama a kling/kling-v2-6 con Comfy Router: endpoint, forma de la solicitud y la respuesta que devuelve Router." sidebarTitle: "Kling V2.6" -translationSourceHash: 94eb0863 +translationSourceHash: c9a8a551 translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx translationBlockHashes: "_intro": c2065202 "Quick start": 48a3d970 - "Schema": cd52808d + "Schema": e0deb97e "Examples": 8623c725 --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/kling/kling-v2-6.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -215,7 +216,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - Tipo de movimiento de cámara predefinido. simple: movimiento de cámara personalizable. down_back: la cámara desciende y se mueve hacia atrás. forward_up: la cámara avanza e inclina hacia arriba. right_turn_forward: rota a la derecha y avanza. left_turn_forward: rota a la izquierda y avanza. + Tipo de movimiento de cámara predefinido. simple: movimiento de cámara personalizable. down_back: la cámara desciende y se mueve hacia atrás. forward_up: la cámara avanza y se inclina hacia arriba. right_turn_forward: rota a la derecha y avanza. left_turn_forward: rota a la izquierda y avanza. Valores posibles: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward` @@ -238,18 +239,12 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ ID de tarea personalizado. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. - - Modo de generación de video. std: modo estándar, que es rentable. pro: modo profesional, genera videos de mayor duración pero con una salida de mayor calidad. - - Valores posibles: `std`, `pro` - - Nombre del modelo. Omítelo o envía null cuando uses Comfy Router; el modelo se selecciona mediante la ruta de la solicitud. Un nombre proporcionado debe coincidir con esa ruta. - Información de cada storyboard, como los prompts y la duración. Admite hasta 6 storyboards, con un mínimo de 1. Es requerido cuando multi_shot es true y shot_type es customize. + Información de cada storyboard, como los prompts y la duración. Admite hasta 6 storyboards, con un mínimo de 1. Requerido cuando multi_shot es true y shot_type es customize. @@ -289,22 +284,22 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; referéncialas en `prompt` como \<\<\>> y \<\<\>> en el orden de la lista. Requiere que `sound` esté establecido en "on", lo cual solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o si `sound` se deja en su valor predeterminado "off", las voces no se aplican. + Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; haz referencia a ellas en `prompt` como \<\<\>> y \<\<\>> en el orden de la lista. Requiere que `sound` esté establecido en "on", algo que solo admiten las versiones V2.6 y posteriores del modelo; en un modelo anterior, o con `sound` en su valor predeterminado "off", las voces no se aplican. - ID de voz devuelto por la API de personalización de voces o un ID de voz preestablecido del sistema. + ID de voz devuelto por la API de personalización de voces o un ID de voz predefinido del sistema. - Indica si se generan resultados con marca de agua de forma simultánea. Actualmente no se admiten marcas de agua personalizadas. + Indica si se generan resultados con marca de agua simultáneamente. Actualmente no se admite una marca de agua personalizada. true significa generar marca de agua, false significa no generarla. - + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10 MB, la resolución no debe ser inferior a 300*300 px y la relación de aspecto debe estar entre 1:2.5 ~ 2.5:1. Base64 no debe incluir el prefijo data:image. @@ -312,6 +307,12 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ Imagen de referencia: control de fotograma final. URL o cadena codificada en Base64, no puede superar los 10 MB, la resolución no debe ser inferior a 300*300 px. Base64 no debe incluir el prefijo data:image. No se puede usar simultáneamente con dynamic_masks/static_mask o camera_control. + + Modo de generación de video. std: modo estándar, que es rentable. pro: modo profesional, genera videos con mayor duración pero con una salida de mayor calidad. + + Valores posibles: `std`, `pro` + + Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v2-6/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida diff --git a/es/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/es/development/comfy-router/models/kling/kling-v3-omni/code.mdx index e7517c46d7..ab81be85d6 100644 --- a/es/development/comfy-router/models/kling/kling-v3-omni/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v3-omni/code.mdx @@ -2,14 +2,15 @@ title: "Usa Kling V3 Omni con Comfy Router" description: "Llama a kling/kling-v3-omni mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Kling V3 Omni" -translationSourceHash: 29d1799c +translationSourceHash: 7fdb91b8 translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx translationBlockHashes: "_intro": 98827333 "Quick start": 3a226de2 - "Schema": 68bd0500 + "Schema": 6d7cb727 "Examples": 6c2642d6 --- + {/* GENERATED FILE. Generated from router-schemas/kling/kling-v3-omni.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -158,25 +159,25 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ ### Entrada - La relación de aspecto del fotograma del video generado (ancho:alto). Requerido cuando no se usan las funciones de referencia de primer fotograma ni de edición de video. + La relación de aspecto del fotograma del video generado (ancho:alto). Requerido cuando no se utilizan las funciones de referencia de primer fotograma ni de edición de video. Valores posibles: `16:9`, `9:16`, `1:1` - La dirección de notificación de callback para el resultado de esta tarea. Si se configura, el servidor notifica activamente cuando cambia el estado de la tarea. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. + La dirección de notificación de callback para el resultado de esta tarea. Si se configura, el servidor notificará activamente cuando cambie el estado de la tarea. Se ignora: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta en tu nombre. Formato: `uri` - Duración del video en segundos. Al usar la función de edición de video (refer_type: base), la duración de salida es la misma que la del video de entrada y este parámetro no es válido. + Duración del video en segundos. Cuando usas la función de edición de video (refer_type: base), la duración de salida es la misma que la del video de entrada y este parámetro no es válido. Valores posibles: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` - Lista de elementos de referencia configurada según los ID de elemento. + Lista de elementos de referencia configurada según el ID del elemento. @@ -186,7 +187,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - ID de tarea personalizado. Debe ser único dentro de una misma cuenta de usuario. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. + ID de tarea personalizado. Debe ser único dentro de una sola cuenta de usuario. Se ignora: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta en tu nombre. @@ -194,21 +195,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - Codificación Base64 de la imagen o URL de la imagen (asegúrate de que sea accesible). Los formatos admitidos incluyen .jpg/.jpeg/.png. El tamaño del archivo no puede superar los 10 MB. Las dimensiones de ancho y alto no deben ser menores de 300 px y la relación de aspecto debe estar entre 1:2.5 y 2.5:1. + Codificación Base64 de la imagen o URL de la imagen (asegúrate de que sea accesible). Los formatos admitidos incluyen .jpg/.jpeg/.png. El tamaño del archivo no puede superar los 10MB. Las dimensiones de ancho y alto no deben ser inferiores a 300px, con una relación de aspecto entre 1:2.5 y 2.5:1. - Si la imagen es el primer o el último fotograma. first_frame es el primer fotograma, end_frame es el último fotograma. Actualmente no se admite solo el fotograma final. + Si la imagen corresponde al primer o al último fotograma. first_frame es el primer fotograma, end_frame es el último fotograma. Actualmente no se admite solo el fotograma final. Valores posibles: `first_frame`, `end_frame` - - Modo de generación de video. std: modo estándar, genera videos en 720P, rentable. pro: modo profesional, genera videos en 1080P, con una salida de video de mayor calidad. - - Valores posibles: `pro`, `std` - - Nombre del modelo. Omítelo o envía null cuando uses Comfy Router; el modelo se selecciona según la ruta de la solicitud. Un nombre proporcionado debe coincidir con esa ruta. @@ -218,11 +213,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - Duración de este storyboard en segundos. No debe superar la duración total de la tarea ni ser menor de 1. La suma de las duraciones de todos los storyboards es igual a la duración total de la tarea. + Duración de este storyboard en segundos. No debe superar la duración total de la tarea ni ser inferior a 1. La suma de las duraciones de todos los storyboards es igual a la duración total de la tarea. - Número de secuencia de la toma + Número de secuencia del plano @@ -230,11 +225,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - Si se genera un video de varias tomas. Cuando es true, el parámetro prompt no es válido. Cuando es false, los parámetros shot_type y multi_prompt no son válidos. + Si se genera video multi-shot. Cuando es true, el parámetro prompt no es válido. Cuando es false, los parámetros shot_type y multi_prompt no son válidos. - Prompt de texto, que puede incluir descripciones positivas y negativas. No debe superar los 2,500 caracteres. Puede especificar elementos, imágenes o videos con el formato \<\<\<>>> como \<\>, \<\<\>>, \<\<\>>. + Palabras del prompt de texto, que pueden incluir descripciones positivas y negativas. No debe superar los 2,500 caracteres. Puedes especificar elementos, imágenes o videos con el formato \<\<\<>>> como \<\>, \<\<\>>, \<\<\>>. @@ -244,13 +239,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - Si se genera sonido simultáneamente al generar el video. + Si se genera sonido de forma simultánea al generar videos. Valores posibles: `on`, `off` - Lista de videos de referencia. Puede usarse como video de referencia para una función o como video a editar, siendo el video a editar el valor predeterminado. + Lista de videos de referencia. Puede usarse como video de referencia para una función o como video a editar; de forma predeterminada es el video a editar. @@ -266,17 +261,23 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \ - URL del video subido. Solo se admiten los formatos .mp4/.mov. Duración entre 3 y 10 segundos. La resolución debe estar entre 720 px y 2160 px. Se admiten velocidades de fotogramas de 24 a 60 fps. Solo se puede subir 1 video, con un tamaño que no supere los 200 MB. + URL del video cargado. Solo se admiten los formatos .mp4/.mov. Duración entre 3 y 10 segundos. La resolución debe estar entre 720px y 2160px. Se admiten velocidades de fotogramas de 24 a 60 fps. Solo se puede cargar 1 video, con un tamaño que no supere los 200MB. - Si se generan resultados con marca de agua simultáneamente. Actualmente no se admite una marca de agua personalizada. + Si se generan resultados con marca de agua de forma simultánea. Actualmente no se admite una marca de agua personalizada. true significa generar marca de agua, false significa no generarla. + + Modo de generación de video. std: modo Estándar, genera videos en 720P, rentable. pro: modo Profesional, genera videos en 1080P, con una salida de video de mayor calidad. 4k: modo Ultra HD, genera un video con resolución 4K. Solo kling-v3-omni admite 4k; kling-video-o1 solo responde a pro/std. + + Valores posibles: `pro`, `std`, `4k` + + Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v3-omni/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -290,11 +291,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v3 - Hora de creación de la tarea, timestamp Unix en milisegundos + Hora de creación de la tarea, marca de tiempo Unix en milisegundos - Unidades de deducción de la tarea + Unidades deducidas de la tarea @@ -332,7 +333,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v3 - URL del video generado con marca de agua, en formato de protección contra hotlinking + URL del video generado con marca de agua, formato de protección contra hotlinking Formato: `uri` @@ -344,11 +345,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-v3 - Información del estado de la tarea; muestra el motivo del fallo cuando la tarea falla + Información del estado de la tarea, que muestra el motivo del fallo cuando la tarea falla - Hora de actualización de la tarea, timestamp Unix en milisegundos + Hora de actualización de la tarea, marca de tiempo Unix en milisegundos diff --git a/es/development/comfy-router/models/kling/kling-v3/code.mdx b/es/development/comfy-router/models/kling/kling-v3/code.mdx index 6826f0fb7c..c27081b252 100644 --- a/es/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v3/code.mdx @@ -2,16 +2,17 @@ title: "Usa Kling V3 con Comfy Router" description: "Llama a kling/kling-v3 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Kling V3" -translationSourceHash: f5127eab +translationSourceHash: d84a12f2 translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx translationBlockHashes: "_intro": 6b9cddba "Quick start": 09c0a41a "Serving providers": b4093d36 - "Schema": 2fce4523 + "Schema": 605a654d "Examples": 8623c725 --- + {/* ARCHIVO GENERADO. Generado desde router-schemas/kling/kling-v3.json mediante `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -252,12 +253,6 @@ Comfy Router presta este modelo directamente a menos que la solicitud indique ot ID de tarea personalizado. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. - - Modo de generación de video. std: modo estándar, que es rentable. pro: modo profesional, genera videos de mayor duración pero con una salida de mayor calidad. - - Valores posibles: `std`, `pro` - - Nombre del modelo. Omítelo o envía null cuando uses Comfy Router; el modelo se selecciona mediante la ruta de la solicitud. Un nombre proporcionado debe coincidir con esa ruta. @@ -303,29 +298,34 @@ Comfy Router presta este modelo directamente a menos que la solicitud indique ot - Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; referéncialas en `prompt` como \<\<\>> y \<\<\>> según el orden de la lista. Requiere que `sound` esté en "on", algo que solo admiten las versiones V2.6 y posteriores del modelo; en una versión anterior, o si `sound` se deja en su valor predeterminado "off", las voces no se aplican. + Lista de voces a las que se hace referencia al generar videos. Admite hasta 2 voces; referéncialas en `prompt` como \<\<\>> y \<\<\>> según el orden de la lista. Requiere `sound` establecido en "on", que solo admiten la V2.6 y las versiones posteriores del modelo; en un modelo anterior, o si `sound` queda en su valor predeterminado "off", las voces no se aplican. - ID de voz devuelto a través de la API de personalización de voces o un ID de voz preestablecido del sistema. + ID de voz devuelto mediante la API de personalización de voces o un ID de voz predefinido del sistema. - Indica si se generan resultados con marca de agua simultáneamente. Actualmente no se admite la marca de agua personalizada. + Indica si se generan resultados con marca de agua de forma simultánea. Actualmente no se admite una marca de agua personalizada. - true significa generar marca de agua, false significa no generarla. + true significa generar la marca de agua, false significa no generarla. - - Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, la resolución no puede ser inferior a 300*300px, la relación de aspecto debe estar entre 1:2.5 ~ 2.5:1. Base64 no debe incluir el prefijo data:image. + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, la resolución no puede ser inferior a 300*300px, la relación de aspecto debe estar entre 1:2.5 ~ 2.5:1. Base64 no debe incluir el prefijo data:image. Imagen de referencia: control del fotograma final. URL o cadena codificada en Base64, no puede superar los 10MB, la resolución no puede ser inferior a 300*300px. Base64 no debe incluir el prefijo data:image. No se puede usar simultáneamente con dynamic_masks/static_mask ni con camera_control. + + Modo de generación de video. std: Modo Estándar, rentable en cuanto a costo. pro: Modo Profesional, genera videos de mayor duración pero con una salida de mayor calidad. 4k: modo Ultra-HD, genera un video con resolución 4K. Solo kling-v3 admite 4k en esta familia; el resto de los modelos Kling de texto a video solo responden a pro/std. + + Posibles valores: `std`, `pro`, `4k` + + Generado a partir del esquema que Router expone en `GET /v2/models/kling/kling-v3/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -381,7 +381,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/kling/kling-v - URL del video generado con marca de agua, formato de protección contra hotlinking + URL del video generado con marca de agua, con formato de protección contra hotlinking Formato: `uri` diff --git a/es/development/comfy-router/models/kling/kling-video-o1/code.mdx b/es/development/comfy-router/models/kling/kling-video-o1/code.mdx index 0a91da01d6..da15dafae2 100644 --- a/es/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/es/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -2,14 +2,15 @@ title: "Usa Kling Video O1 con Comfy Router" description: "Llama a kling/kling-video-o1 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Kling Video O1" -translationSourceHash: 892ccf77 +translationSourceHash: 8870f379 translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx translationBlockHashes: "_intro": a36df86f "Quick start": 2dd48300 - "Schema": f693e2ef + "Schema": e4a41688 "Examples": 6c2642d6 --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/kling/kling-video-o1.json por `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -158,13 +159,13 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ ### Entrada - La relación de aspecto del fotograma del video generado (ancho:alto). Es requerida cuando no se usan las funciones de referencia de primer fotograma o de edición de video. + La relación de aspecto del fotograma de video generado (ancho:alto). Es requerida cuando no se usan las funciones de referencia de primer fotograma ni de edición de video. Valores posibles: `16:9`, `9:16`, `1:1` - La dirección de notificación de callback para el resultado de esta tarea. Si se configura, el servidor notifica activamente cuando cambia el estado de la tarea. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. + La dirección de notificación callback para el resultado de esta tarea. Si se configura, el servidor notificará activamente cuando cambie el estado de la tarea. Se ignora: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta por ti. Formato: `uri` @@ -186,7 +187,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - ID de tarea personalizado. Debe ser único dentro de una misma cuenta de usuario. Ignorado: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta el estado en tu nombre. + ID de tarea personalizado. Debe ser único dentro de una sola cuenta de usuario. Se ignora: comfy-api descarta este campo antes de reenviarlo; Comfy Router consulta por ti. @@ -194,23 +195,17 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - Codificación Base64 de la imagen o URL de la imagen (asegúrate de que sea accesible). Los formatos admitidos incluyen .jpg/.jpeg/.png. El tamaño del archivo no puede superar los 10 MB. Las dimensiones de ancho y alto no deben ser inferiores a 300 px, con una relación de aspecto entre 1:2.5 y 2.5:1. + Codificación Base64 de la imagen o URL de la imagen (asegúrate de que sea accesible). Los formatos admitidos incluyen .jpg/.jpeg/.png. El tamaño del archivo no puede superar 10MB. Las dimensiones de ancho y alto no deben ser inferiores a 300px, con una relación de aspecto entre 1:2.5 y 2.5:1. - Indica si la imagen es el primer o el último fotograma. first_frame es el primer fotograma, end_frame es el último fotograma. Actualmente no se admite solo el fotograma final. + Indica si la imagen corresponde al primer o al último fotograma. first_frame es el primer fotograma, end_frame es el último fotograma. Actualmente no se admite solo el fotograma final. Valores posibles: `first_frame`, `end_frame` - - Modo de generación de video. std: Modo Estándar, genera videos en 720P, con buena relación costo-beneficio. pro: Modo Profesional, genera videos en 1080P, con una salida de video de mayor calidad. - - Valores posibles: `pro`, `std` - - - Nombre del modelo. Omítelo o envía null cuando uses Comfy Router; el modelo se selecciona según la ruta de la solicitud. Un nombre proporcionado debe coincidir con esa ruta. + Nombre del modelo. Omítelo o envía null cuando uses Comfy Router; el modelo se selecciona según la ruta de la solicitud. El nombre que envíes debe coincidir con esa ruta. @@ -222,7 +217,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - Número de secuencia de la toma + Número de secuencia del plano @@ -230,54 +225,60 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ - Indica si se genera un video de varias tomas. Cuando es true, el parámetro prompt no es válido. Cuando es false, los parámetros shot_type y multi_prompt no son válidos. + Si se genera un video con varios planos. Cuando es true, el parámetro prompt no es válido. Cuando es false, los parámetros shot_type y multi_prompt no son válidos. - Prompts de texto, que pueden incluir descripciones positivas y negativas. No debe superar los 2500 caracteres. Puedes especificar elementos, imágenes o videos con el formato \<\<\<>>> como \<\>, \<\<\>>, \<\<\>>. + Prompt de texto, que puede incluir descripciones positivas y negativas. No debe superar los 2,500 caracteres. Puedes especificar elementos, imágenes o videos con el formato \<\<\<>>> como \<\>, \<\<\>>, \<\<\>>. - Método de storyboard. Es requerido cuando el parámetro multi_shot está en true. + Método de storyboard. Es requerido cuando el parámetro multi_shot está establecido en true. Valores posibles: `customize`, `intelligence` - Indica si se genera sonido de forma simultánea al generar el video. + Si se genera sonido de forma simultánea al generar videos. Valores posibles: `on`, `off` - Lista de videos de referencia. Puede usarse como video de referencia de una función o como video a editar; de forma predeterminada es el video a editar. + Lista de videos de referencia. Puede usarse como video de referencia para una función o como video a editar; de forma predeterminada se usa como video a editar. - Indica si se conserva el sonido original del video. yes indica que se conserva, no indica que no se conserva. + Si se conserva el sonido original del video. yes indica que se conserva, no indica que no se conserva. Valores posibles: `yes`, `no` - Tipo de video de referencia. feature es el video de referencia de una función, base es el video a editar. + Tipo de video de referencia. feature es el video de referencia de función, base es el video a editar. Valores posibles: `feature`, `base` - URL del video cargado. Solo se admiten los formatos .mp4/.mov. Duración entre 3 y 10 segundos. La resolución debe estar entre 720 px y 2160 px. Se admiten velocidades de fotogramas de 24 a 60 fps. Solo se puede cargar 1 video, con un tamaño que no supere los 200 MB. + URL del video cargado. Solo se admiten los formatos .mp4/.mov. Duración entre 3 y 10 segundos. La resolución debe estar entre 720px y 2160px. Se admiten velocidades de fotogramas de 24 a 60 fps. Solo se puede cargar 1 video, con un tamaño no superior a 200MB. - Indica si se generan resultados con marca de agua de forma simultánea. Actualmente no se admiten marcas de agua personalizadas. + Si se generan resultados con marca de agua de forma simultánea. Actualmente no se admite una marca de agua personalizada. - true significa que se genera la marca de agua, false significa que no se genera. + true significa generar marca de agua, false significa no generarla. + + + + Modo de generación de video. std: Modo estándar, genera videos en 720P, rentable. pro: Modo profesional, genera videos en 1080P, con una salida de video de mayor calidad. + + Valores posibles: `pro`, `std` -Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-video-o1/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-video-o1/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -294,7 +295,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-vi - Unidades de deducción de la tarea + Las unidades de deducción de la tarea @@ -332,7 +333,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-vi - URL del video generado con marca de agua, formato de protección contra enlaces directos + URL del video generado con marca de agua, formato de protección contra hotlinking Formato: `uri` @@ -344,7 +345,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/kling/kling-vi - Información del estado de la tarea; muestra el motivo del fallo cuando la tarea falla + Información del estado de la tarea, que muestra el motivo del fallo cuando la tarea falla diff --git a/es/development/comfy-router/models/krea/krea-3/code.mdx b/es/development/comfy-router/models/krea/krea-3/code.mdx index 4c77bda1e2..f808c481b7 100644 --- a/es/development/comfy-router/models/krea/krea-3/code.mdx +++ b/es/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,15 +2,16 @@ title: "Usa Krea 3 con Comfy Router" description: "Llama a krea/krea-3 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Krea 3" -translationSourceHash: eee80c65 +translationSourceHash: cd728587 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": dbedda04 + "Schema": 7aa8390e "Examples": 276619d9 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-3.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -151,11 +152,11 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ ### Entrada - 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9 o 21:9. Úsalo junto con resolution; omítelo para el encuadre automático. + 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9 o 21:9. Úsalo con resolution; omítelo para el encuadre automático. - URL de imágenes de entrada, hasta 8. El image_url que devuelve subir la imagen a POST /proxy/krea/assets (campo de formulario multipart `file`) siempre se acepta. Que se acepten otras URL https públicas depende del entorno: donde no se aceptan, cualquier enlace que no sea una URL https en el host app-uploads.krea.ai se rechaza con 400; donde sí, se acepta cualquier URL de imagen https pública, y una URL mal formada o que no sea https se rechaza con 400 (una URL cuyo puerto sea numérico pero esté fuera de rango no la detecta esta comprobación y puede fallar con un 502 en su lugar). Para una URL https bien formada en ese caso, una referencia que quien llama puede corregir se rechaza con 400 indicando su host: su host no resuelve o no es accesible públicamente cuando se comprueba antes de la descarga, redirige más veces de las permitidas, a una URL que no es https o a un host que no es accesible públicamente, devuelve un 4xx distinto de 408 o 429, no es una imagen, es una imagen en un formato que no se puede leer, su cabecera de tamaño de imagen no está dentro de los primeros 2 MiB, o una respuesta sin longitud declarada o con codificación por trozos termina antes de su cabecera de tamaño de imagen. Cualquier otro fallo al descargarla falla con un error 502 en POST /proxy/krea (Comfy Router lo responde con 500 internal_error): un fallo transitorio de DNS, TLS o de conexión, un tiempo de espera agotado, un 408, 429, 5xx u otro estado distinto de 200 en el origen, o un host que pasó esa comprobación pero no resuelve o no es accesible públicamente cuando la descarga se conecta. Donde no se aceptan otras URL, un enlace de app-uploads.krea.ai que no sea una subida viva falla con un error 5xx; donde sí se aceptan, se rechaza con 400 como cualquier otra referencia inaccesible. Mientras un servidor aún no ha aprendido cuál de los dos casos aplica, cualquier URL https cuyo host no sea un enlace de app-uploads.krea.ai, pública o no, falla con un error 503 que es seguro reintentar. Omítelo para texto a imagen. + URL de imágenes de entrada, hasta 8. Más de 8 entradas se rechazan antes de realizar ninguna obtención (400 en /proxy/krea; la comprobación del esquema de Comfy Router responde primero con 422). El image_url que devuelve subir la imagen a POST /proxy/krea/assets (campo `file` del formulario multipart) siempre se acepta. Que se acepten otras URL https públicas depende del entorno: donde no se aceptan, cualquier enlace que no sea una URL https en el host app-uploads.krea.ai se rechaza con 400 y el mensaje 'image_urls must be image_url values returned by POST /proxy/krea/assets', así que sube la imagen en su lugar; donde sí se aceptan, se acepta cualquier URL de imagen https pública, y una URL malformada o que no sea https se rechaza con 400 (una URL cuyo puerto sea numérico pero esté fuera de rango no la detecta esta comprobación y puede fallar con 502 en su lugar). Para una URL https bien formada en ese caso, una referencia que quien llama puede corregir se rechaza con 400 indicando su host: su host no resuelve o no es accesible públicamente cuando se comprueba antes de la obtención, redirige más veces de las permitidas, a una URL que no es https o a un host que no es accesible públicamente, devuelve un 4xx distinto de 408 o 429, no es una imagen, es una imagen en un formato que no se puede leer, su cabecera de tamaño de imagen no está dentro de los primeros 2 MiB, o una respuesta sin longitud declarada o con codificación chunked termina antes de su cabecera de tamaño de imagen. Cualquier otro fallo al obtenerla produce un error 502 en POST /proxy/krea (Comfy Router responde con 500 internal_error): un fallo transitorio de DNS, TLS o conexión, un timeout, un 408, 429, 5xx u otro estado distinto de 200 del origen, o un host que pasó esa comprobación pero no resuelve o no es accesible públicamente cuando la obtención establece la conexión. Algunos de estos se resuelven al reintentar (un error del resolver, un timeout, una conexión interrumpida, un origen que responde 5xx, 408 o 429, o un host cuya respuesta DNS cambia a una dirección no pública entre la comprobación del host y la conexión, que al reintentar puede tener éxito o recibir el 400 por un host no público); otros fallan de la misma manera siempre, por ejemplo un certificado TLS en el que la obtención no confía (autofirmado, caducado o para el nombre de host incorrecto), o un origen que responde un 2xx distinto de 200 o un 3xx que la obtención no sigue (como 204, 206, 300, 304 o 305, o un 301, 302, 303, 307 o 308 sin Location), así que si un reintento falla de la misma manera, sube la imagen en su lugar. Una solicitud en cola a través de Comfy Router no reintenta ese fallo cuando alguno de sus image_urls no es un enlace de app-uploads.krea.ai, así que reenvíala tú mismo si la causa puede desaparecer. Donde no se aceptan otras URL, un enlace de app-uploads.krea.ai que no sea una carga activa falla con un error 5xx; donde sí se aceptan, se rechaza con 400 como cualquier otra referencia inaccesible. Mientras un servidor aún no haya aprendido cuál se aplica, cualquier URL https cuyo host no sea un enlace de app-uploads.krea.ai, sea público o no, falla con un error 503 que puedes reintentar sin riesgo (una solicitud en cola se reintenta automáticamente ante él). El 400 de una solicitud en cola solo lleva el detalle genérico invalid_input, así que no muestra ni el host ni el texto anterior, y la cola no lo reintenta. Un 400 en cola puede venir de cualquier campo, no solo de image_urls (por ejemplo, una resolution o thinking_mode no compatibles), así que revisa primero los demás campos. Si son válidos, sube cada imagen a POST /proxy/krea/assets y reenvía con esos valores image_url y una nueva Idempotency-Key (o ninguna): reutilizar la clave con un cuerpo modificado se rechaza con 409 invalid_input, que no dice nada sobre las imágenes, y reutilizarla con el mismo cuerpo se responde con 201 junto con el request_id original e Idempotent-Replayed: true, así que no inicia una nueva ejecución, y su URL de resultado devuelve el mismo 400 (su URL de estado responde 200 con error_type invalid_input). Donde se aceptan otras URL https públicas, si ese reenvío también falla con 400, el problema es la propia imagen (por ejemplo, no es una imagen compatible o su cabecera de tamaño de imagen no está dentro de los primeros 2 MiB). Donde no se aceptan, esa misma imagen subida falla con un 5xx (500 internal_error en Comfy Router) en lugar de ese 400, y el problema sigue siendo la imagen, así que volver a subirla no ayuda. Solo se leen los primeros 2 MiB de cada imagen para encontrar su tamaño, así que una imagen cuya información de tamaño no se pueda leer dentro de esa ventana (como un JPEG con más de 2 MiB de metadatos incrustados, o un PNG con paleta en el que los datos de transparencia, o si no los hay, el inicio de su primer chunk de datos de imagen, estén más allá de los 2 MiB, por ejemplo después de más de 2 MiB de chunks de texto o de perfil de color) se rechaza con 400 indicando que su cabecera de tamaño de imagen no está dentro de los primeros 2 MiB, se haya subido o no; vuelve a guardarla sin los metadatos grandes, o guarda un PNG con paleta como un PNG sin paleta. Envía un host internacionalizado en su forma ASCII (punycode); un nombre de host no ASCII se rechaza por no existir. Omítelo para texto a imagen. @@ -171,7 +172,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - Establece true para una edición local que conserva el resto de la imagen. Requiere el modelo berry y al menos una imagen en image_urls. + Establece true para una edición local que mantiene el resto de la imagen. Requiere el modelo berry y al menos una imagen en image_urls. @@ -184,9 +185,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ fast (predeterminado), high o ultra. High y ultra planifican las ediciones complejas con más detalle y tardan más. Ultra requiere resolution 2k. - - -Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-3/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que Router expone en `GET /v2/models/krea/krea-3/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -199,11 +198,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-3/op - Solo se establece cuando el estado es failed. Un trabajo cancelado no lo lleva. + Solo se define cuando el estado es failed. Una tarea cancelada no lo incluye. - Por qué falló el trabajo: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal o node_app_node_failed. Trata un código desconocido como internal. + Por qué falló la tarea: content_policy, invalid_request, validation_failed, model_unavailable, insufficient_balance, timeout, auto_cancelled, provider_error, internal o node_app_node_failed. Trata un código desconocido como internal. @@ -211,7 +210,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-3/op - El parámetro de la solicitud que hay que cambiar; aparece con invalid_request y validation_failed. + El parámetro de la solicitud que debes cambiar, presente con invalid_request y validation_failed. @@ -219,19 +218,19 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/krea/krea-3/op - La generación finalizada. Aquí no admite nulos, a diferencia de `KreaJob`: una tarea terminal cuyo `result` no lleva `urls` se responde como un error de Comfy Router, así que un `200` siempre lo incluye. + La generación finalizada. Aquí no admite nulo, a diferencia de `KreaJob`: una tarea terminal cuyo `result` no lleva `urls` se responde como un error de Comfy Router, así que una respuesta `200` siempre lo incluye. - Lo establecen las tareas de loraTraining, no una generación; un `200` para estos modelos lleva `urls`. + Lo definen las tareas de loraTraining, no una generación; una respuesta `200` de estos modelos lleva `urls`. - Las imágenes generadas, como enlaces descargables. Al menos una, porque una tarea `completed` con `urls` vacío es `success_without_output` y nunca llega a este documento. + Las imágenes generadas, como enlaces descargables. Al menos uno, porque una tarea `completed` con `urls` vacío es `success_without_output` y nunca llega a este documento. - Siempre `completed` en este documento: es el único estado que Router informa como éxito, y el vocabulario de Krea debe coincidir exactamente, sensible a mayúsculas y minúsculas. + Siempre `completed` en este documento: es el único estado que Router reporta como éxito, y el vocabulario de Krea se compara sin distinción de mayúsculas y minúsculas. Valores posibles: `completed` diff --git a/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx b/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx new file mode 100644 index 0000000000..7dd4d0489a --- /dev/null +++ b/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx @@ -0,0 +1,221 @@ +--- +title: "Usa LTX Video Alpha Gen con Comfy Router" +description: "Llama a ltx/ltx-video-alpha-gen mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "LTX Video Alpha Gen" +translationSourceHash: 9ad35117 +translationFrom: development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx +translationBlockHashes: + "_intro": 99d9f21c + "Quick start": 3fae9114 + "Schema": 2e86e846 + "Examples": 68527b2e +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/ltx/ltx-video-alpha-gen.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de la API para `ltx/ltx-video-alpha-gen`, que Comfy Router ofrece desde LTX. + +**Entrada:** Video · **Salida:** Video + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. + +**ID del modelo:** `ltx/ltx-video-alpha-gen` + +**Endpoint:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY desde las variables de entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-alpha-gen", + { + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde las variables de entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("ltx/ltx-video-alpha-gen", { + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests`. Router responde `201` con un `request_id` en cuanto admite la ejecución, y el resultado se recoge, desde este proceso o desde otro, en cuanto está listo. [Queued delivery](/es/development/comfy-router/queue) explica el estado, la cancelación y la obtención del resultado. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY desde las variables de entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-alpha-gen", + { + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud fallida o cancelada lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde las variables de entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("ltx/ltx-video-alpha-gen", { + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud fallida o cancelada se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Enviar. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoger. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Video de entrada como una URL HTTPS de acceso público o un URI de datos base64. H.264 o HEVC en MP4, MOV o MKV, de hasta 200 MB por URL. Como máximo, 3840 píxeles en el lado largo y 2160 en el lado corto. + + +Generado a partir del esquema que Router expone en `GET /v2/models/ltx/ltx-video-alpha-gen/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Marca de tiempo de finalización de la tarea (ISO 8601) + + + + Marca de tiempo de creación de la tarea (ISO 8601) + + + + Presente cuando el estado es failed + + + + + + + + + + + + Identificador único de la tarea + + + + Presente cuando el estado es completed; las URL de salida expiran 24 horas después de completarse + + + + URL del video de entrada con el matte como canal alfa, un MOV ProRes 4444 + + + + URL del matte alfa en escala de grises, un MP4 en el que el blanco es el primer plano + + + + Estado de la tarea (pending, processing, completed, failed) + + +## Ejemplos + +### Entrada + +```json +{ + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### Salida + +```json +{ + "completed_at": "2026-01-01T00:00:50Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "cutout_video_url": "https://example.invalid/ltx/cutout.mov", + "matte_video_url": "https://example.invalid/ltx/matte.mp4" + }, + "status": "completed" +} +``` + + diff --git a/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx b/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx new file mode 100644 index 0000000000..9cacce96e1 --- /dev/null +++ b/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx @@ -0,0 +1,232 @@ +--- +title: "Usa LTX Video To Video Hdr con Comfy Router" +description: "Llama a ltx/ltx-video-to-video-hdr mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "LTX Video To Video Hdr" +translationSourceHash: 42a210ab +translationFrom: development/comfy-router/models/ltx/ltx-video-to-video-hdr/code.mdx +translationBlockHashes: + "_intro": 73aee58d + "Quick start": 0cc37810 + "Schema": 511ed3d7 + "Examples": 2bedcca6 +--- +{/* ARCHIVO GENERADO. Generado desde router-schemas/ltx/ltx-video-to-video-hdr.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `ltx/ltx-video-to-video-hdr`, que Comfy Router sirve desde LTX. + +**Entrada:** Video · **Salida:** Video + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar. + +**ID del modelo:** `ltx/ltx-video-to-video-hdr` + +**Endpoint:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY desde el entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-to-video-hdr", + { + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("ltx/ltx-video-to-video-hdr", { + output_colorspace: "acescg", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"output_colorspace\": \"acescg\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) describe el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY desde el entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-to-video-hdr", + { + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que necesita otro proceso + + # Sondea hasta que se complete la solicitud, esperando el Retry-After que indique el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY desde el entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("ltx/ltx-video-to-video-hdr", { + output_colorspace: "acescg", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que necesita otro proceso + +// Sondea hasta que se complete la solicitud, esperando el Retry-After que indique el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló provoca aquí un rechazo. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. El Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"output_colorspace\": \"acescg\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. Sondea hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-hdr/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Espacio de color de la secuencia de fotogramas OpenEXR en `result.exr_frames_url`. No afecta a `result.video_url`. + + Valores posibles: `acescg`, `acescct`, `srgb_linear`, `aces2065-1` + + + + Video de entrada como una URL HTTPS de acceso público o un URI de datos base64. H.264 o HEVC en MP4, MOV o MKV, de hasta 200 MB por URL. El ancho y el alto deben caber dentro de 3840x2160 en cualquiera de las dos orientaciones. + + +Generado a partir del esquema que Router expone en `GET /v2/models/ltx/ltx-video-to-video-hdr/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Marca temporal de finalización de la tarea (ISO 8601) + + + + Marca temporal de creación de la tarea (ISO 8601) + + + + Presente cuando el estado es failed + + + + + + + + + + + + Identificador único de la tarea + + + + Presente cuando el estado es completed; las URLs de salida expiran 24 horas después de la finalización + + + + URL de un ZIP de imágenes OpenEXR por fotograma en el espacio de color solicitado + + + + URL del video HDR, un MP4 HEVC BT.2020/HLG de 10 bits + + + + Estado de la tarea (pending, processing, completed, failed) + + +## Ejemplos + +### Entrada + +```json +{ + "output_colorspace": "acescg", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### Salida + +```json +{ + "completed_at": "2026-01-01T00:00:45Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "exr_frames_url": "https://example.invalid/ltx/exr_frames.zip", + "video_url": "https://example.invalid/ltx/hdr.mp4" + }, + "status": "completed" +} +``` + + diff --git a/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx b/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx new file mode 100644 index 0000000000..fa5044e51d --- /dev/null +++ b/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx @@ -0,0 +1,262 @@ +--- +title: "Usar LTX Video To Video Reframe con Comfy Router" +description: "Llama a ltx/ltx-video-to-video-reframe mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "LTX Video To Video Reframe" +translationSourceHash: a82950a2 +translationFrom: development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx +translationBlockHashes: + "_intro": 06c6f3d9 + "Quick start": a6026b27 + "Schema": 4d231f97 + "Examples": 846aabe4 +--- +{/* GENERATED FILE. Generated from router-schemas/ltx/ltx-video-to-video-reframe.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `ltx/ltx-video-to-video-reframe`, servida por Comfy Router desde LTX. + +**Entrada:** Video · **Salida:** Video + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar. + +**Model ID:** `ltx/ltx-video-to-video-reframe` + +**Endpoint:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-to-video-reframe", + { + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("ltx/ltx-video-to-video-reframe", { + resolution: "720x1280", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"720x1280\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y recoges el resultado cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) describe el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-to-video-reframe", + { + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("ltx/ltx-video-to-video-reframe", { + resolution: "720x1280", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"720x1280\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Dónde se ubica el video de origen dentro del fotograma de salida. Envía `anchor`, o `x` e `y` junto con `width`, `height` o ambos. Omite `placement` para centrar el video en el tamaño más grande que quepa. + + + + Borde o esquina del fotograma de salida contra el que se coloca el video. + + Valores posibles: `center`, `top`, `bottom`, `left`, `right`, `top_left`, `top_right`, `bottom_left`, `bottom_right` + + + + Alto del video colocado, como fracción del alto de salida. + + Formato: `double` + + + + Ancho del video colocado, como fracción del ancho de salida. + + Formato: `double` + + + + Borde izquierdo del video colocado, como fracción del ancho de salida. + + Formato: `double` + + + + Borde superior del video colocado, como fracción del alto de salida. + + Formato: `double` + + + + Resolución de salida objetivo. El video de origen se extiende para rellenar este fotograma. + + Valores posibles: `720x720`, `1080x1080`, `720x900`, `1080x1350`, `900x720`, `1350x1080`, `720x1280`, `1080x1920`, `1280x720`, `1920x1080` + + + + Video de entrada como una URL HTTPS de acceso público o un URI de datos base64. H.264 o HEVC en MP4, MOV o MKV, hasta 200 MB por URL. Como máximo 60 segundos y 1800 fotogramas, con ancho y alto entre 64 y 4096 píxeles. + + +Generado a partir del esquema que Router sirve en `GET /v2/models/ltx/ltx-video-to-video-reframe/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Marca de tiempo de finalización de la tarea (ISO 8601) + + + + Marca de tiempo de creación de la tarea (ISO 8601) + + + + Presente cuando el estado es failed + + + + + + + + + + + + Identificador único de la tarea + + + + Presente cuando el estado es completed; las URL de salida expiran 24 horas después de completarse + + + + URL del video generado + + + + Estado de la tarea (pending, processing, completed, failed) + + +## Ejemplos + +### Entrada + +```json +{ + "resolution": "720x1280", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### Salida + +```json +{ + "completed_at": "2026-01-01T00:00:20Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "video_url": "https://example.invalid/ltx/output.mp4" + }, + "status": "completed" +} +``` + + + diff --git a/es/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx b/es/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx new file mode 100644 index 0000000000..5d33514b28 --- /dev/null +++ b/es/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx @@ -0,0 +1,228 @@ +--- +title: "Usa LTX Video Upscale con Comfy Router" +description: "Llama a ltx/ltx-video-upscale con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "LTX Video Upscale" +translationSourceHash: 00a8b2b0 +translationFrom: development/comfy-router/models/ltx/ltx-video-upscale/code.mdx +translationBlockHashes: + "_intro": 8ef040a0 + "Quick start": e19118f2 + "Schema": b6e43e38 + "Examples": a6d53aaa +--- + +{/* GENERATED FILE. Generated from router-schemas/ltx/ltx-video-upscale.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `ltx/ltx-video-upscale`, servida por Comfy Router desde LTX. + +**Entrada:** video · **Salida:** video + audio + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar. + +**ID del modelo:** `ltx/ltx-video-upscale` + +**Endpoint:** `POST https://api.comfy.org/v2/models/ltx/ltx-video-upscale` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "ltx/ltx-video-upscale", + { + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("ltx/ltx-video-upscale", { + resolution: "1080p", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"1080p\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "ltx/ltx-video-upscale", + { + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, todo lo que otro proceso necesita + + # Sondea hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("ltx/ltx-video-upscale", { + resolution: "1080p", + video_uri: "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, todo lo que otro proceso necesita + +// Sondea hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"resolution\": \"1080p\", \"video_uri\": \"https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4\"}" + +# 2. Sondea hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Tamaño de salida. Se mantiene la relación de aspecto. + + Valores posibles: `1080p`, `4k`, `8k` + + + + Video de entrada como una URL HTTPS de acceso público o un URI de datos base64. H.264 o HEVC en MP4, MOV o MKV, hasta 200 MB por URL. El lado corto debe medir al menos 480 píxeles. + + +Generado a partir del esquema que Router expone en `GET /v2/models/ltx/ltx-video-upscale/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Marca de tiempo de finalización de la tarea (ISO 8601) + + + + Marca de tiempo de creación de la tarea (ISO 8601) + + + + Presente cuando el estado es fallido + + + + + + + + + + + + Identificador único de la tarea + + + + Presente cuando el estado es completado; las URL de salida caducan 24 horas después de completarse + + + + URL del video generado + + + + Estado de la tarea (pendiente, procesando, completado, fallido) + + +## Ejemplos + +### Entrada + +```json +{ + "resolution": "1080p", + "video_uri": "https://test-videos.co.uk/vids/sintel/mp4/h264/720/Sintel_720_10s_1MB.mp4" +} +``` + +### Salida + +```json +{ + "completed_at": "2026-01-01T00:00:20Z", + "created_at": "2026-01-01T00:00:00Z", + "id": "3f7a1b28-5c0d-4e91-8a6f-1b2c3d4e5f60", + "result": { + "video_url": "https://example.invalid/ltx/output.mp4" + }, + "status": "completed" +} +``` + + diff --git a/es/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/es/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index edb173a32f..a96530f4fb 100644 --- a/es/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -2,14 +2,15 @@ title: "Usa GPT Image 1.5 con Comfy Router" description: "Llama a openai/gpt-image-1.5 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "GPT Image 1.5" -translationSourceHash: a1545fc4 +translationSourceHash: 2c734ca2 translationFrom: development/comfy-router/models/openai/gpt-image-1-5/code.mdx translationBlockHashes: "_intro": 7a84676f "Quick start": f364e3f2 - "Schema": 8b660697 + "Schema": aaeae86d "Examples": c73859ec --- + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-1.5.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -168,20 +169,23 @@ Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta Una imagen, ya sea una URL https que Router descarga en nombre de quien llama, o un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto se APLICA al resolver la solicitud en lugar de dejarlo al proveedor: un svg, gif, avif o tiff se rechaza aquí, indicando la imagen enviada, en vez de convertirse en un error del socio a dos saltos de la causa. - Prefiere la forma de URL. Un payload base64 se infla aproximadamente 4/3 y el cuerpo completo de la solicitud está limitado a 100 MiB, así que la forma en línea se agota cerca de una imagen de origen de 75 MB; una URL evita ese problema por completo. Los límites de multimedia por imagen y por solicitud que se indican al final de esta descripción son más estrictos que el límite del cuerpo, así que para una imagen de tamaño real son los que encuentras primero. + Prefiere la forma de URL. Un payload base64 se infla aproximadamente 4/3 y el cuerpo completo de la solicitud está limitado a 100 MiB, así que la forma en línea tiene un tope cercano a una imagen de origen de 75 MB; una URL evita ese problema por completo. Los límites de multimedia por imagen y por solicitud que se indican al final de esta descripción son más estrictos que el límite del cuerpo, así que para una imagen de tamaño real son los que encuentras primero. LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la descarga en el servidor y no envía ninguna credencial de quien llama con la solicitud, así que la forma admitida es una URL prefirmada, es decir, una cuya firma está en la cadena de consulta. Un endpoint autenticado como `/api/assets/{id}/content` responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. - LA DESCARGA ESTÁ LIMITADA A UN CONJUNTO NOMBRADO DE HOSTS y no a internet abierto, y la misma lista se vuelve a aplicar a cada salto de redirección además de a la URL enviada: por eso una URL en cualquier otro host, o una que redirija fuera de la lista, se rechaza antes de contactar con ningún proveedor. Hoy esa lista es solo el reparto de assets de Comfy: una URL firmada de `storage.googleapis.com` bajo un bucket de assets de Comfy, que es la forma a la que te redirige `/api/assets/{id}/content`. Un CDN de un socio o un host https normal NO está en la lista. + LA DESCARGA ESTÁ LIMITADA A UN CONJUNTO NOMBRADO DE HOSTS y no a internet abierto, y la misma lista se vuelve a aplicar a cada salto de redirección además de a la URL enviada: por eso una URL en cualquier otro host, o una que redirija fuera de la lista, se rechaza antes de contactar con ningún proveedor. Hoy esa lista es solo la entrega de recursos de Comfy: una URL firmada de `storage.googleapis.com` bajo un bucket de recursos de Comfy, que es la forma a la que te redirige `/api/assets/{id}/content`. Un CDN de un socio o un host https simple NO está en la lista. HAY DOS AMPLIACIONES EN DESPLIEGUE Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se publican tras UN solo interruptor y se habilitan juntas, así que considera todo lo siguiente como algo futuro y no como algo sobre lo que construir todavía: pregunta antes de basarte en cualquiera de las dos. La PRIMERA es el bucket en el que `POST /customers/storage` firma tu subida. Hasta que el despliegue llegue a tu entorno, una URL de subida de ese endpoint se rechaza aquí, aunque el bucket sea de Comfy y el host el mismo: así que "subir a Comfy y luego pasar la URL" NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. La SEGUNDA se HABILITA POR CUENTA y no para todos a la vez, porque el bucket que hay detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta que no tenga habilitada la multimedia entrante de terceros recibe un rechazo, y se le indica con esas mismas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que la habilite para tu cuenta. Además admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, tanto en la forma de estilo de ruta como en la prefijada con `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. - LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST Y NO EL PROVEEDOR: por eso nombrar arriba un proveedor NO significa que se acepte cualquier URL que ese proveedor pueda emitir, y conviene enumerar tres casos casi válidos porque quien llama puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. - Los marcadores `` y `pub-` de arriba muestran la forma con la que llegarás normalmente; no son una restricción de profundidad. La comparación es sobre el sufijo de dominio del almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los listados. - El ejemplo siguiente muestra solo la forma: un valor real además lleva los parámetros de consulta de firma, que aquí se omiten deliberadamente porque un ejemplo publicado permanece en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. - Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en total. La única excepción es Precise Edit de ideogram/ideogram-4-5 (una llamada que envía `image`) cuando `context_window` está disponible: ahí cada imagen puede llegar a 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud a 128 MiB en total. + LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR, así que nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y tres casos casi coincidentes merecen mención expresa porque quien llama puede llegar razonablemente con cualquiera de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de velocidad y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com`, o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco lo es la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. + +Los marcadores `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La comparación se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los listados. + + El ejemplo siguiente muestra solo la forma: un valor real también incluye los parámetros de consulta de firma, que aquí se omiten a propósito porque un ejemplo publicado vive en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. + + Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: allí cada imagen puede llegar a 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud hasta 128 MiB en total. - El modelo gpt-image que se ejecutará. Router inserta el id del modelo al que se dirige la llamada, así que un cliente que llama a /v2/models/openai/gpt-image-2 no envía esto. + El modelo gpt-image a ejecutar. Router inserta el id del modelo al que se dirige la llamada, así que quien llama a /v2/models/openai/gpt-image-2 no envía esto. @@ -191,15 +195,15 @@ Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta - El número de imágenes que se generarán (1-10). + El número de imágenes a generar (1-10). - Rango: `1` a `10` + Alcance: `1` a `10` Nivel de compresión para JPEG o WebP (0-100) - Rango: `0` a `100` + Alcance: `0` a `100` @@ -211,15 +215,15 @@ Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta Solo tiene sentido junto con un stream en vivo, que esta superficie no puede servir: `stream` se fija en `false` incluso cuando lo envías. En una generación, cualquier valor distinto de `0` o `null` se rechaza con un 400, independientemente de que la solicitud también envíe `stream: true`; en una solicitud que lleva `image`, el campo se descarta en lugar de reenviarse. Omítelo. - Rango: `0` a `3` + Alcance: `0` a `3` - Una descripción de texto de la imagen que se generará, o de la edición que se hará en `image`. + Una descripción de texto de la imagen a generar, o de la edición que se debe hacer en `image`. - La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se agregaron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la era de DALL-E que ningún modelo admitido reconoce. + La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se añadieron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la era de DALL-E que ningún modelo admitido reconoce. Valores posibles: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` @@ -229,7 +233,7 @@ Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta - Se declara para que no se rechace a un cliente que lo envía, pero es INERTE en esta superficie: Router lo FIJA en `false` antes del despacho, porque captura la respuesta del proveedor en lugar de retransmitir un `text/event-stream` (una solicitud que lleva `image` descarta el campo, ya que la edición se recodifica sin él). No hay ninguna superficie de Comfy que ofrezca streaming de imágenes parciales de gpt-image: la entrada v1 `POST /proxy/openai/images/generations` rechaza `stream: true` con un 400 y nunca reenvía la solicitud al proveedor, así que omite el campo y lee la respuesta completada como un solo cuerpo JSON. Como el stream nunca se abre, la restricción de OpenAI sobre combinar `stream: true` con `n` mayor que 1 no se aplica aquí; `n` se reenvía tal como se envió. + Se declara para no rechazar a quien lo envía, pero es INERTE en esta superficie: Router lo FIJA en `false` antes del despacho, porque captura la respuesta del proveedor en lugar de retransmitir un `text/event-stream` (una solicitud que lleva `image` descarta el campo, ya que la edición se recodifica sin él). Ninguna superficie de Comfy ofrece streaming de imágenes parciales de gpt-image: el punto de entrada v1 `POST /proxy/openai/images/generations` rechaza `stream: true` con un 400 y nunca reenvía la solicitud al proveedor, así que omite el campo y lee la respuesta completada como un único cuerpo JSON. Como el stream nunca se abre, la restricción de OpenAI sobre combinar `stream: true` con `n` mayor que 1 no se aplica aquí; `n` se reenvía tal como se envió. @@ -301,7 +305,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-ima - Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara REQUERIDO en una respuesta de generación de imágenes, así que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativas lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. + Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara REQUERIDO en una respuesta de generación de imágenes, así que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, minimax, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativas lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. Formato: `int64` diff --git a/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 223e91c202..69608e99b7 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -2,16 +2,18 @@ title: "Usa GPT Image 2.5 Flare con Comfy Router" description: "Llama a openai/gpt-image-2.5-flare mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "GPT Image 2.5 Flare" -translationSourceHash: e3a1017e +translationSourceHash: 060a72c2 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx translationBlockHashes: "_intro": 1e1ed044 "Quick start": c9749309 - "Serving providers": ef0e9384 - "Schema": a7048d34 + "Serving providers": 943a35c1 + "Schema": aa138d7e "Examples": c73859ec --- + + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.5-flare.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -157,10 +159,11 @@ Comfy Router sirve este modelo directamente a menos que la solicitud indique otr - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare` - **fal**, como `fal/fal-gpt-image-2.5-flare`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=fal` +- **MiniMax**, como `minimax/minimax-gpt-image-2.5-flare`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=minimax` - **Runware**, como `runware/runware-gpt-image-2.5-flare`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=runware` - **WaveSpeed**, como `wavespeed/wavespeed-gpt-image-2.5-flare`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=wavespeed` -El valor predeterminado de `strict_mode` es false, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la Referencia de la API y [Proveedores de servicio](/es/development/comfy-router/providers) para ver todos los modelos enrutados de esta forma. +El valor predeterminado de `strict_mode` es falso, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la Referencia de la API y [Proveedores de servicio](/es/development/comfy-router/providers) para ver todos los modelos enrutados de esta forma. ## Esquema @@ -314,7 +317,7 @@ Generado a partir del esquema que Router expone en `GET /v2/models/openai/gpt-im - Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara REQUIRED en una respuesta de generación de imágenes, por lo que está presente siempre que OpenAI es el productor; una respuesta servida por fal, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativos lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. + Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara REQUIRED en una respuesta de generación de imágenes, por lo que está presente siempre que OpenAI es el productor; una respuesta servida por fal, minimax, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativos lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. Formato: `int64` diff --git a/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index 0557c15659..e70f5d4950 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -2,15 +2,16 @@ title: "Usa GPT Image 2.5 Sunburst con Comfy Router" description: "Llama a openai/gpt-image-2.5-sunburst a través de Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "GPT Image 2.5 Sunburst" -translationSourceHash: 89d64476 +translationSourceHash: c9aa90d3 translationFrom: development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx translationBlockHashes: "_intro": 84874630 "Quick start": 8da85011 - "Serving providers": 58af0c87 - "Schema": 61c5bb52 + "Serving providers": 89992590 + "Schema": e341df7c "Examples": c73859ec --- + {/* ARCHIVO GENERADO. Generado a partir de router-schemas/openai/gpt-image-2.5-sunburst.json mediante `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -152,14 +153,15 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ ## Proveedores de servicio -Comfy Router sirve este modelo directamente a menos que la solicitud indique otro proveedor. Los proveedores a continuación también lo sirven, en el mismo endpoint y con el mismo ID de modelo, seleccionados con el parámetro de consulta `model_provider`. +Comfy Router sirve este modelo directamente a menos que la solicitud indique otro proveedor. Los siguientes proveedores también lo sirven, en el mismo endpoint y con el mismo ID de modelo, seleccionados con el parámetro de consulta `model_provider`. - **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst` - **fal**, como `fal/fal-gpt-image-2.5-sunburst`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=fal` +- **MiniMax**, como `minimax/minimax-gpt-image-2.5-sunburst`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=minimax` - **Runware**, como `runware/runware-gpt-image-2.5-sunburst`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=runware` - **WaveSpeed**, como `wavespeed/wavespeed-gpt-image-2.5-sunburst`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=wavespeed` -`strict_mode` tiene como valor predeterminado falso, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para cada modelo enrutado de esta manera. +`strict_mode` es falso de forma predeterminada, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para cada modelo enrutado de esta manera. ## Esquema @@ -182,14 +184,13 @@ Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta Una imagen, ya sea una URL https que Router descarga en nombre de quien llama, o un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto se APLICA al resolver la solicitud en lugar de dejarlo al proveedor: un svg, gif, avif o tiff se rechaza aquí, indicando la imagen enviada, en vez de convertirse en un error del socio a dos saltos de la causa. Prefiere la forma de URL. Un payload base64 se infla aproximadamente 4/3 y el cuerpo completo de la solicitud está limitado a 100 MiB, así que la forma en línea se agota cerca de una imagen de origen de 75 MB; una URL evita ese problema por completo. Los límites de multimedia por imagen y por solicitud que se indican al final de esta descripción son más estrictos que el límite del cuerpo, así que para una imagen de tamaño real son los que encuentras primero. LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la descarga en el servidor y no envía ninguna credencial de quien llama con la solicitud, así que la forma admitida es una URL prefirmada, es decir, una cuya firma está en la cadena de consulta. Un endpoint autenticado como `/api/assets/{id}/content` responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. - LA DESCARGA ESTÁ LIMITADA A UN CONJUNTO NOMBRADO DE HOSTS y no a internet abierto, y la misma lista se vuelve a aplicar a cada salto de redirección además de a la URL enviada: por eso una URL en cualquier otro host, o una que redirija fuera de la lista, se rechaza antes de contactar con ningún proveedor. Hoy esa lista es solo el reparto de assets de Comfy: una URL firmada de `storage.googleapis.com` bajo un bucket de assets de Comfy, que es la forma a la que te redirige `/api/assets/{id}/content`. Un CDN de un socio o un host https normal NO está en la lista. + LA DESCARGA ESTÁ LIMITADA A UN CONJUNTO NOMBRADO DE HOSTS y no a internet abierto, y la misma lista se vuelve a aplicar a cada salto de redirección además de a la URL enviada: por eso una URL en cualquier otro host, o una que redirija fuera de la lista, se rechaza antes de contactar con ningún proveedor. Hoy esa lista es solo la entrega de recursos de Comfy: una URL firmada de `storage.googleapis.com` bajo un bucket de recursos de Comfy, que es la forma a la que te redirige `/api/assets/{id}/content`. Un CDN de un socio o un host https normal NO está en la lista. HAY DOS AMPLIACIONES EN DESPLIEGUE Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se publican tras UN solo interruptor y se habilitan juntas, así que considera todo lo siguiente como algo futuro y no como algo sobre lo que construir todavía: pregunta antes de basarte en cualquiera de las dos. La PRIMERA es el bucket en el que `POST /customers/storage` firma tu subida. Hasta que el despliegue llegue a tu entorno, una URL de subida de ese endpoint se rechaza aquí, aunque el bucket sea de Comfy y el host el mismo: así que "subir a Comfy y luego pasar la URL" NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. La SEGUNDA se HABILITA POR CUENTA y no para todos a la vez, porque el bucket que hay detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta que no tenga habilitada la multimedia entrante de terceros recibe un rechazo, y se le indica con esas mismas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que la habilite para tu cuenta. Además admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, tanto en la forma de estilo de ruta como en la prefijada con `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. - LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST Y NO EL PROVEEDOR: por eso nombrar arriba un proveedor NO significa que se acepte cualquier URL que ese proveedor pueda emitir, y conviene enumerar tres casos casi válidos porque quien llama puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. - Los marcadores `` y `pub-` de arriba muestran la forma con la que llegarás normalmente; no son una restricción de profundidad. La comparación es sobre el sufijo de dominio del almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los listados. - El ejemplo siguiente muestra solo la forma: un valor real además lleva los parámetros de consulta de firma, que aquí se omiten deliberadamente porque un ejemplo publicado permanece en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. - Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en total. La única excepción es Precise Edit de ideogram/ideogram-4-5 (una llamada que envía `image`) cuando `context_window` está disponible: ahí cada imagen puede llegar a 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud a 128 MiB en total. + LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR: por eso nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y vale la pena indicar sin rodeos tres casos que casi coinciden, porque quien llama puede llegar razonablemente con cualquiera de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: firma previamente el endpoint `.r2.cloudflarestorage.com`, o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas.Los marcadores `` y `pub-` de arriba muestran la forma con la que llegarás normalmente; no son una restricción de profundidad. La comparación es sobre el sufijo de dominio del almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los listados. +El ejemplo siguiente muestra solo la forma: un valor real además lleva los parámetros de consulta de firma, que aquí se omiten deliberadamente porque un ejemplo publicado permanece en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. +Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en total. La única excepción es Precise Edit de ideogram/ideogram-4-5 (una llamada que envía `image`) cuando `context_window` está disponible: ahí cada imagen puede llegar a 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud a 128 MiB en total. @@ -231,7 +232,7 @@ Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta - La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se agregaron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la época de dall-e que ningún modelo admitido lee. + La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se agregaron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la época de dall-e que ningún modelo admitido reconoce. Valores posibles: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` @@ -313,7 +314,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-ima - Marca de tiempo Unix, en segundos, del momento en que se completó la generación. Es el único miembro que OpenAI declara como REQUIRED en una respuesta de generación de imágenes, por lo que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, pika, wavespeed o runware sobre cualquiera de los ids con respaldo alternativo lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara como `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. + Marca de tiempo Unix, en segundos, del momento en que se completó la generación. Es el único miembro que OpenAI declara como REQUIRED en una respuesta de generación de imágenes, por lo que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, minimax, pika, wavespeed o runware sobre cualquiera de los ids con respaldo alternativo lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara como `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. Formato: `int64` diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 54f124fd6f..8d8d29459e 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -2,15 +2,17 @@ title: "Usa GPT Image 2.6 Flare con Comfy Router" description: "Llama a openai/gpt-image-2.6-flare mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "GPT Image 2.6 Flare" -translationSourceHash: 9f6b894f +translationSourceHash: 726e4807 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx translationBlockHashes: "_intro": 1693e80a "Quick start": 8222d9f4 - "Schema": 78f788c9 + "Serving providers": ce8a80c6 + "Schema": cdcbdd35 "Examples": c73859ec --- + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.6-flare.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -150,6 +152,15 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES +## Proveedores de servicio + +Comfy Router sirve este modelo directamente, a menos que la solicitud indique otro proveedor. Los proveedores a continuación también lo sirven, en el mismo endpoint y con el mismo ID de modelo, seleccionados con el parámetro de consulta `model_provider`. + +- **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare` +- **MiniMax**, como `minimax/minimax-gpt-image-2.6-flare`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare?model_provider=minimax` + +`strict_mode` tiene como valor predeterminado false, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para todos los modelos enrutados de esta manera. + ## Esquema ### Entrada @@ -161,94 +172,95 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES - El número de fotogramas del GIF animado (2-16, el rango propio de OpenAI); solo tiene sentido con `output_format: "gif"` -- se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, se usa el valor predeterminado propio de OpenAI, 9, EXCEPTO que Comfy además limita este campo por entorno (ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES, nunca por encima del máximo propio de este campo, 16): un valor por encima del límite configurado se rechaza, y un `frame_count` omitido se rechaza en lugar de reducirse en silencio cuando el valor predeterminado de 9 supera por sí mismo el límite configurado, de modo que al llamador se le indica que establezca `frame_count` explícitamente en lugar de recibir una animación más corta que la predeterminada de OpenAI. El número de fotogramas también acota la cotización previa y el techo de resultado de 64 MiB, que escalan con él. + El número de fotogramas del GIF animado (2-16, el rango propio de OpenAI), solo tiene sentido con `output_format: "gif"`: se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, toma el valor predeterminado propio de OpenAI de 9, EXCEPTO que Comfy además limita este campo por entorno (`ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES`, nunca por encima del máximo propio de este campo de 16): se rechaza un valor por encima del límite configurado, y se rechaza un `frame_count` omitido en lugar de reducirlo silenciosamente cuando el valor predeterminado de 9 supera el límite configurado, así que se le indica a quien llama que establezca `frame_count` explícitamente en lugar de recibir una animación silenciosamente más pequeña que la predeterminada de OpenAI. El número de fotogramas también limita la cotización previa y el límite de resultados de 64 MiB, y ambos escalan con él. Rango: `2` a `16` - Los milisegundos que se muestra cada fotograma (el rango propio de OpenAI es 20-2000, redondeado a 10 ms); solo tiene sentido con `output_format: "gif"` -- se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, se usa el valor predeterminado propio de OpenAI, 200. + Los milisegundos durante los que se muestra cada fotograma (el rango propio de OpenAI es 20-2000, redondeado a 10 ms), solo tiene sentido con `output_format: "gif"`: se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, toma el valor predeterminado propio de OpenAI de 200. Rango: `20` a `2000` La imagen o imágenes de origen que se van a editar. LA PRESENCIA DE ESTE CAMPO SELECCIONA LA OPERACIÓN DE EDICIÓN: omítelo por completo para la generación de texto a imagen. -El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` constituye toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), excepto que un prompt de edición describe el CAMBIO que deseas en lugar de la escena, así que el cuerpo de edición de abajo se lee distinto del ejemplo de generación aunque solo este campo sea estructuralmente nuevo. -Se puede copiar exactamente tal como está impreso: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`: la carga útil es un PNG de 1x1 completo, no una abreviatura, y este cuerpo está fijado como un caso aceptado en las pruebas de validación de solicitudes de Router. Sustituye los bytes por los de tu propia imagen. -Acepta una imagen o un array de ellas; gpt-image-1 y posteriores admiten hasta 16, y Router lo aplica desde este esquema antes de despachar. +El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` es toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), excepto que un prompt de edición describe el CAMBIO que quieres en lugar de la escena, así que el cuerpo de edición que aparece abajo se lee distinto del ejemplo de generación aunque solo este campo sea estructuralmente nuevo. +Se puede copiar exactamente como está impreso: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`; la carga útil es un PNG de 1x1 completo, no una abreviatura, y este cuerpo está fijado como un caso aceptado en las pruebas de validación de solicitudes del propio Router. Reemplaza los bytes por los de tu propia imagen. +Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta 16, y Router lo aplica desde este esquema antes de despachar. - Una imagen, ya sea como una URL https que Router obtiene en nombre de quien llama o como un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto se APLICA en el momento de la resolución en lugar de dejarse al proveedor: un svg, gif, avif o tiff se rechaza aquí, nombrando la imagen que enviaste, en vez de convertirse en un error del socio a dos saltos de la causa. -Prefiere la forma con URL. Una carga útil base64 se infla aproximadamente 4/3 y el cuerpo completo de la solicitud está limitado a 100 MiB, así que la forma en línea se topa con cerca de una imagen de origen de 75 MB; una URL evita eso por completo. Los límites de medios por imagen y por solicitud indicados al final de esta descripción son más estrictos que el límite del cuerpo, así que para una imagen de cualquier tamaño real son los que encontrarás primero. -LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la obtiene del lado del servidor y no envía ninguna credencial de quien llama con la solicitud, así que una URL prefirmada (aquella cuya firma está en la cadena de consulta) es la forma admitida. Un endpoint autenticado como `/api/assets/{id}/content` responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. -LA OBTENCIÓN ESTÁ CONFINADA A UN CONJUNTO NOMBRADO DE HOSTS en lugar de a la internet abierta, y la misma lista se vuelve a aplicar a cada salto de redirección además de a la URL que envías: por eso una URL en cualquier otro host, o una que redirige fuera de la lista, se rechaza antes de contactar a cualquier proveedor. Hoy esa lista es únicamente el servicio de entrega de recursos de Comfy: una URL firmada de `storage.googleapis.com` dentro de un bucket de recursos de Comfy, que es la forma a la que `/api/assets/{id}/content` te redirige. Un CDN de un socio o un host https simple NO está en la lista. -DOS AMPLIACIONES SE ESTÁN DESPLEGANDO Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se lanzan detrás de UN solo interruptor y se habilitan juntas, así que considera todo lo que sigue como algo próximo y no como algo sobre lo que construir todavía: pregunta antes de depender de cualquiera de las dos. -La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que el despliegue llegue a tu entorno, una URL de carga de ese endpoint se rechaza aquí, aunque el bucket sea de Comfy y el host sea el mismo: por eso "sube a Comfy y luego pasa la URL" NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. -La SEGUNDA SE HABILITA POR CUENTA y no para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta a la que no se le han habilitado los medios entrantes de terceros se rechaza, y se le dice con esas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que la habilite para tu cuenta. Además admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama ninguna propiedad sobre él: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, tanto en la forma de estilo de ruta como en la prefijada con `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. -LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR: por eso nombrar un proveedor arriba NO significa que toda URL que ese proveedor pueda emitir se acepte, y vale la pena enunciar directamente tres casos que casi coinciden porque quien llama puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas.Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los que aparecen en la lista. -El ejemplo de abajo muestra solo la forma: un valor real también lleva los parámetros de consulta de firma, que aquí se omiten a propósito porque un ejemplo publicado vive en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. -Cada imagen está limitada a 25 MiB y el conjunto de imágenes de una petición a 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: ahí cada imagen puede ser de hasta 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y el conjunto de imágenes de una petición de hasta 128 MiB en total. + Una imagen, ya sea como una URL https que Router obtiene en nombre de quien llama o como un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto SE APLICA en el momento de la resolución en lugar de dejarlo al proveedor: aquí se rechaza un svg, gif, avif o tiff, nombrando la imagen que enviaste, en lugar de convertirse en un error de socio a dos saltos de la causa. +Prefiere la forma de URL. Una carga útil base64 se infla aproximadamente 4/3 y todo el cuerpo de la solicitud está limitado a 100 MiB, así que la forma en línea llega a su límite cerca de una imagen de origen de 75 MB; una URL evita eso por completo. Los límites de medios por imagen y por solicitud indicados al final de esta descripción son más estrictos que el límite del cuerpo, así que para una imagen de cualquier tamaño real son lo primero que encuentras. +LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la obtiene del lado del servidor y no envía ninguna credencial de quien llama con la solicitud, así que una URL prefirmada, es decir, una cuya firma está en la cadena de consulta, es la forma admitida. Un endpoint autenticado como `/api/assets/{id}/content` responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. +LA OBTENCIÓN ESTÁ CONFINADA A UN CONJUNTO NOMBRADO DE HOSTS en lugar de la internet abierta, y la misma lista se vuelve a aplicar a cada salto de redirección, así como a la URL que envías, así que se rechaza una URL en cualquier otro host, o una que redirija fuera de la lista, antes de contactar a cualquier proveedor. Hoy esa lista es solo la entrega de recursos propia de Comfy: una URL firmada de `storage.googleapis.com` bajo un bucket de recursos de Comfy, que es la forma a la que `/api/assets/{id}/content` te redirige. Un CDN de socio o un host https simple NO está en la lista. +DOS AMPLIACIONES ESTÁN EN DESPLIEGUE Y AMBAS ESTÁN DESACTIVADAS DE FORMA PREDETERMINADA HOY. Se lanzan detrás de UN interruptor y se habilitan juntas, así que trata todo lo que sigue como algo futuro en lugar de como algo sobre lo que construir todavía: pregunta antes de depender de cualquiera de las dos. +La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que el despliegue llegue a tu entorno, se rechaza aquí una URL de carga de ese endpoint, aunque el bucket sea propio de Comfy y el host sea el mismo: así que "subir a Comfy y luego pasar la URL" todavía NO funciona, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. +La SEGUNDA SE HABILITA POR CUENTA en lugar de para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso una vez que el interruptor anterior está activado, se rechaza una cuenta que no haya tenido habilitados los medios entrantes de terceros, y se le dice así con esas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que lo habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama la propiedad sobre él: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, ya sea en la forma de ruta o en la forma con prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. +Lo que se compara es la forma del nombre de host, no el proveedor: por eso, nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y vale la pena mencionar directamente tres casos que casi coinciden, porque un cliente puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de velocidad y dirige el tráfico de producción a un dominio personalizado en su lugar, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: firma previamente el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí para leerlas. +Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace en el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los enumerados. +El ejemplo de abajo solo muestra la forma: un valor real también lleva los parámetros de consulta de firma, que se omiten deliberadamente aquí porque un ejemplo publicado vive en la especificación para siempre y una firma real es tanto una credencial filtrada como un enlace que deja de funcionar. +Cada imagen tiene un límite de 25 MiB y las imágenes de una solicitud, de 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: allí cada imagen puede ser de hasta 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud, de hasta 128 MiB en total. - El modelo gpt-image que se va a ejecutar. Router inserta el id del modelo direccionado, así que un llamador que apunta a /v2/models/openai/gpt-image-2 no envía esto. + El modelo gpt-image que se ejecutará. Router inserta el id del modelo direccionado, así que un cliente que se dirige a /v2/models/openai/gpt-image-2.6-flare no envía esto. - Ajuste de moderación de contenido + Configuración de moderación de contenido Valores posibles: `low`, `auto` - El número de imágenes a generar (1-10). + El número de imágenes a generar (1-10). Una solicitud GIF (consulta `output_format`) rechaza cualquier valor distinto de 1: la propia descripción de OpenAI llama a `n` en una solicitud GIF «el número de animaciones», que Router no tarifica para v1. Alcance: `1` a `10` - Nivel de compresión para JPEG o WebP (0-100) + Nivel de compresión para JPEG o WebP (0-100). Se rechaza en una solicitud GIF: OpenAI no acepta un nivel de compresión para una salida animada. Alcance: `0` a `100` - Formato de la imagen de salida + Formato de la imagen de salida. `gif` además rechaza `mask`, `n` distinto de 1, un `size` omitido, `auto` o mal formado, `stream: true`, `partial_images` mayor que 0 y `output_compression` (consulta la descripción de cada campo), y se rechaza de plano a menos que Comfy lo haya habilitado para este entorno. - Valores posibles: `png`, `webp`, `jpeg` + Valores posibles: `png`, `webp`, `jpeg`, `gif` - Solo tiene sentido junto con un stream en vivo, que esta superficie no puede servir: `stream` se fija a `false` incluso cuando lo envías. En una generación, cualquier valor distinto de `0` o `null` se rechaza con un 400, independientemente de que la petición también envíe `stream: true`; en una petición que lleva `image`, el campo se descarta en lugar de reenviarse. Omítelo. + Solo tiene sentido junto con una transmisión en vivo, que esta interfaz no puede servir, exactamente como en OpenAIImageRouterRequest (consulta la descripción de ese campo). Un valor mayor que 0 se rechaza en una solicitud GIF, por la misma razón que `stream: true`; se acepta 0. Alcance: `0` a `3` - Una descripción de texto de la imagen a generar, o de la edición que se debe hacer a `image`. + Una descripción de texto de la imagen a generar, o de la edición que se hará en `image`. - La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se añadieron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la era dall-e que ningún modelo admitido lee. + La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se agregaron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la era dall-e que ningún modelo admitido reconoce. Valores posibles: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` - Tamaño de la imagen (p. ej., 1024x1024, 1536x1024, auto) + Tamaño de la imagen (p. ej., 1024x1024, 1536x1024, auto). Una solicitud GIF (consulta `output_format`) rechaza `auto` y rechaza omitir este campo: un tamaño explícito es lo que mantiene finitos la cotización previa y el límite de 64 MiB del resultado antes de un recuento de fotogramas que los multiplica. - Se declara para que un llamador que lo envíe no sea rechazado, pero es INERTE en esta superficie: Router lo FIJA a `false` antes del despacho, porque captura la respuesta del proveedor en lugar de retransmitir un `text/event-stream` (una petición que lleva `image` descarta el campo, ya que la edición se recodifica sin él). Ninguna superficie de Comfy sirve el streaming de imágenes parciales de gpt-image: la entrada v1 `POST /proxy/openai/images/generations` rechaza `stream: true` con un 400 y nunca reenvía la petición al proveedor, así que omite el campo y lee la respuesta completada como un único cuerpo JSON. Como el stream nunca se abre, la restricción de OpenAI sobre combinar `stream: true` con `n` mayor que 1 no aplica aquí; `n` se reenvía tal como se envía. + Se declara para que un cliente que lo envíe no sea rechazado, pero es INERTE en esta interfaz exactamente como en OpenAIImageRouterRequest (consulta la descripción de ese campo). `true` se rechaza en una solicitud GIF (la guía de OpenAI indica que la salida GIF no admite transmisión); `false` se acepta. - Un identificador único para la monitorización de usuarios finales + Un identificador único para el monitoreo de usuarios finales -Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-image-2.6-flare/openapi.json`, el mismo documento con el que valida una llamada antes de que la petición llegue al proveedor. +Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-image-2.6-flare/openapi.json`, el documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -261,7 +273,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-ima - prompt revisado + Prompt revisado @@ -309,17 +321,17 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-ima - Indica si el fondo de la imagen generada es `opaque` o `transparent`, tal como OpenAI lo resolvió para esta generación. El parámetro de la solicitud tiene como valor predeterminado `auto`, así que aquí es donde quien llama sin fijarlo se entera de cuál se produjo. + Si el fondo de la imagen generada es `opaque` o `transparent`, tal como OpenAI lo resolvió para esta generación. El parámetro de la solicitud tiene como valor predeterminado `auto`, así que aquí es donde el llamador que no lo ancló descubre cuál se produjo. - Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara como REQUIRED en una respuesta de generación de imágenes, así que está presente siempre que OpenAI es el productor; una respuesta servida por fal, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativas lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara como `int64` porque un valor de epoch actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. + Marca temporal Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara como requerido en una respuesta de generación de imágenes, por lo que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, minimax, pika, wavespeed o runware en cualquiera de los ids respaldados por proveedores alternativos lo omite por completo, al igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. Formato: `int64` - La codificación de los bytes en `data[].b64_json`: `png`, `webp` o `jpeg`. Es el formato que OpenAI codificó realmente, que es el `output_format` de la solicitud cuando se envió uno y `png` cuando no se envió ninguno, de modo que un decodificador puede basarse en él en lugar de volver a derivar el formato a partir de la solicitud. + La codificación de los bytes en `data[].b64_json`: `png`, `webp` o `jpeg`. Es el formato que OpenAI codificó realmente, que es el `output_format` de la solicitud cuando se envió uno y `png` cuando no se envió ninguno, así que un decodificador puede basarse en él en lugar de volver a derivar el formato de la solicitud. @@ -327,7 +339,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-ima - Las dimensiones en píxeles a las que realmente se ejecutó la generación, como `x`. Es el tamaño RESUELTO: el `size` de la solicitud tiene como valor predeterminado `auto` y admite explícitamente `auto`, así que este es el único lugar donde se informan las dimensiones que realmente se usaron. + Las dimensiones en píxeles a las que realmente se ejecutó la generación, como `x`. Es el tamaño RESUELTO: el `size` de la solicitud tiene como valor predeterminado `auto` y admite explícitamente `auto`, así que este es el único lugar donde se informan las dimensiones realmente usadas. ## Ejemplos diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index e1a7119494..55ef218c36 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -2,14 +2,16 @@ title: "Usa GPT Image 2.6 Sunburst con Comfy Router" description: "Llama a openai/gpt-image-2.6-sunburst con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "GPT Image 2.6 Sunburst" -translationSourceHash: e71f1905 +translationSourceHash: b6d31807 translationFrom: development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx translationBlockHashes: "_intro": 280b9c93 "Quick start": 2d3cb42c - "Schema": 2a71e1a8 + "Serving providers": d22ba32c + "Schema": d9027080 "Examples": c73859ec --- + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.6-sunburst.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -149,51 +151,63 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ +## Proveedores que sirven el modelo + +Comfy Router sirve este modelo directamente, a menos que la solicitud indique otro proveedor. Los proveedores que aparecen a continuación también lo sirven, en el mismo endpoint y con el mismo ID de modelo, y se seleccionan con el parámetro de consulta `model_provider`. + +- **Comfy** (predeterminado): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst` +- **MiniMax**, como `minimax/minimax-gpt-image-2.6-sunburst`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst?model_provider=minimax` + +`strict_mode` es `false` por defecto, así que Router traduce el cuerpo de la solicitud nativo que se documenta en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la Referencia de la API, y [Proveedores que sirven](/es/development/comfy-router/providers) para ver todos los modelos enrutados de esta forma. + ## Esquema ### Entrada - Transparencia del fondo. `auto` permite que el modelo elija. + Transparencia del fondo. `auto` deja que el modelo elija. Valores posibles: `transparent`, `opaque`, `auto` - El número de fotogramas del GIF animado (2-16, el rango propio de OpenAI); solo tiene sentido con `output_format: "gif"` -- se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, se usa el valor predeterminado propio de OpenAI, 9, EXCEPTO que Comfy además limita este campo por entorno (ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES, nunca por encima del máximo propio de este campo, 16): un valor por encima del límite configurado se rechaza, y un `frame_count` omitido se rechaza en lugar de reducirse en silencio cuando el valor predeterminado de 9 supera por sí mismo el límite configurado, de modo que al llamador se le indica que establezca `frame_count` explícitamente en lugar de recibir una animación más corta que la predeterminada de OpenAI. El número de fotogramas también acota la cotización previa y el techo de resultado de 64 MiB, que escalan con él. + El número de fotogramas del GIF animado (2-16, el rango propio de OpenAI), con sentido solo junto a `output_format: "gif"`; se rechaza junto a cualquier otro `output_format`. Si se omite en una solicitud de GIF, toma el valor predeterminado de OpenAI, 9, EXCEPTO que Comfy además limita este campo por entorno (ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES, nunca por encima del máximo propio de este campo, 16): un valor superior al límite configurado se rechaza, y un `frame_count` omitido se rechaza en lugar de reducirse en silencio cuando el valor predeterminado de 9 supera por sí mismo el límite configurado, de modo que al llamador se le indica que establezca `frame_count` explícitamente en vez de recibir una animación más pequeña que la predeterminada de OpenAI. El número de fotogramas también acota la cotización previa y el techo de resultado de 64 MiB, y ambos escalan con él. Rango: `2` a `16` - Los milisegundos que se muestra cada fotograma (el rango propio de OpenAI es 20-2000, redondeado a 10 ms); solo tiene sentido con `output_format: "gif"` -- se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, se usa el valor predeterminado propio de OpenAI, 200. + Los milisegundos que se muestra cada fotograma (el rango propio de OpenAI es 20-2000, redondeado a 10 ms), con sentido solo junto a `output_format: "gif"`; se rechaza junto a cualquier otro `output_format`. Si se omite en una solicitud de GIF, toma el valor predeterminado de OpenAI de 200. Rango: `20` a `2000` La o las imágenes de origen que se van a editar. LA PRESENCIA DE ESTE CAMPO SELECCIONA LA OPERACIÓN DE EDICIÓN: omítelo por completo para la generación de texto a imagen. -El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` es toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), salvo que un prompt de edición describe el CAMBIO que quieres en lugar de la escena, así que el cuerpo de edición de abajo se lee de forma distinta al ejemplo de generación, aunque solo este campo sea estructuralmente nuevo. -Se puede copiar exactamente como se muestra: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`; la carga útil es un PNG completo de 1x1, no una abreviatura, y este cuerpo está fijado como un caso aceptado en las propias pruebas de validación de solicitudes de Router. Sustituye los bytes por los de tu propia imagen. -Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta 16, y Router lo aplica desde este esquema antes de despachar. +El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Añadir `image` es toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), salvo que un prompt de edición describe el CAMBIO que quieres y no la escena, así que el cuerpo de edición de abajo se lee distinto del ejemplo de generación aunque solo este campo sea estructuralmente nuevo. +Se puede copiar tal cual está impreso: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`. El payload es un PNG de 1x1 completo, no una abreviatura, y este cuerpo está fijado como caso aceptado en las propias pruebas de validación de solicitudes de Router. Sustituye los bytes por los de tu propia imagen. +Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores admiten hasta 16, y Router lo aplica desde este esquema antes de despachar. - Una imagen, ya sea como una URL https que Router obtiene en nombre de quien llama, o como un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto se APLICA en el momento de resolución en lugar de dejarlo al proveedor: un svg, gif, avif o tiff se rechaza aquí, indicando la imagen que enviaste, en lugar de convertirse en un error del socio a dos saltos de la causa. -Prefiere la forma de URL. Una carga útil base64 se infla aproximadamente 4/3 y el cuerpo completo de la solicitud tiene un límite de 100 MiB, así que la forma en línea llega a su límite cerca de una imagen de origen de 75 MB; una URL evita eso por completo. Los límites de medios por imagen y por solicitud indicados al final de esta descripción son más estrictos que el límite del cuerpo, así que, para una imagen de cualquier tamaño real, son los que encuentras primero. -LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la obtiene del lado del servidor y no envía ninguna credencial de quien llama con la solicitud, así que una URL prefirmada (una cuya firma está en la cadena de consulta) es la forma admitida. Un endpoint autenticado como `/api/assets/{id}/content` responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. -LA OBTENCIÓN ESTÁ LIMITADA A UN CONJUNTO NOMBRADO DE HOSTS, no a la internet abierta, y la misma lista se vuelve a aplicar a cada salto de redirección y también a la URL que envías; por eso, una URL en cualquier otro host, o una que redirija fuera de la lista, se rechaza antes de contactar a cualquier proveedor. Hoy esa lista es solo la entrega de recursos propia de Comfy: una URL firmada de `storage.googleapis.com` dentro de un bucket de recursos de Comfy, que es la forma a la que te redirige `/api/assets/{id}/content`. Un CDN de un socio o un host https simple NO están en la lista. -DOS AMPLIACIONES SE ESTÁN DESPLEGANDO Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se entregan detrás de UN interruptor y se habilitan juntas, así que trata todo lo siguiente como algo próximo y no como algo sobre lo que construir todavía: pregunta antes de confiar en cualquiera de las dos. -La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que el despliegue llegue a tu entorno, una URL de carga de ese endpoint se rechaza aquí, aunque el bucket sea propio de Comfy y el host sea el mismo; por lo tanto, «subir a Comfy y luego pasar la URL» NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. -La SEGUNDA se HABILITA POR CUENTA, no para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso una vez que el interruptor anterior está activado, una cuenta a la que no se le han habilitado los medios entrantes de terceros se rechaza, y se le dice exactamente eso, en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que la habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, ya sea en la forma de estilo de ruta o con el prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de uso general en el mismo dominio del proveedor, como un disparador de Alibaba Function Compute, no está en la lista y se rechaza. -LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR; por lo tanto, nombrar un proveedor arriba NO significa que se acepte toda URL que ese proveedor pueda emitir, y vale la pena indicar directamente tres casos casi válidos, porque quien llama puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza. Firma previamente el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. + Una imagen, ya sea una URL https que Router obtiene en nombre del llamador o un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto SE APLICA en el momento de resolución en lugar de dejarse al proveedor: un svg, gif, avif o tiff se rechaza aquí, nombrando la imagen que enviaste, en vez de convertirse en un error del socio a dos saltos de la causa. +Prefiere la forma de URL. Un payload base64 se infla aproximadamente 4/3 y todo el cuerpo de la solicitud está limitado a 100 MiB, así que la forma en línea llega a su tope cerca de una imagen de origen de 75 MB; una URL evita eso por completo. Los techos de medios por imagen y por solicitud indicados al final de esta descripción son más estrictos que el límite del cuerpo, así que para una imagen de cualquier tamaño real son lo primero que encuentras. +LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la obtiene del lado del servidor y no envía ninguna credencial del llamador con la solicitud, así que una URL prefirmada (aquella cuya firma está en la cadena de consulta) es la forma admitida. Un endpoint autenticado como `/api/assets/{id}/content` responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. +LA OBTENCIÓN ESTÁ CONFINADA A UN CONJUNTO NOMBRADO DE HOSTS en lugar de a la internet abierta, y la misma lista se vuelve a aplicar a cada salto de redirección y también a la URL que envías, de modo que una URL en cualquier otro host, o una que redirige fuera de la lista, se rechaza antes de contactar a cualquier proveedor. Hoy esa lista es solo la entrega de recursos propia de Comfy: una URL firmada de `storage.googleapis.com` dentro de un bucket de recursos de Comfy, que es la forma a la que `/api/assets/{id}/content` te redirige. Una CDN de un socio o un host https simple NO está en la lista. +SE ESTÁN DESPLEGANDO DOS AMPLIACIONES Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se lanzan detrás de UN solo interruptor y se habilitan juntas, así que trata todo lo siguiente como algo futuro y no como algo sobre lo que construir todavía: pregunta antes de apoyarte en cualquiera de las dos. +La PRIMERA es el bucket en el que `POST /customers/storage` firma tu subida. Hasta que el despliegue llegue a tu entorno, una URL de subida de ese endpoint se rechaza aquí, aunque el bucket sea el propio de Comfy y el host sea el mismo; por lo tanto, “sube a Comfy y luego pasa la URL” NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. +La SEGUNDA SE HABILITA POR CUENTA en lugar de para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta a la que no se le han habilitado los medios entrantes de terceros se rechaza, y se le dice con esas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que lo habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama ninguna propiedad sobre él: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, ya sea en la forma de ruta o con el prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. +Lo que se compara es la forma del nombre de host, no el proveedor, así que nombrar un proveedor arriba **no** significa que se acepte toda URL que ese proveedor pueda emitir, y tres casos que casi coinciden merecen decirse sin rodeos, porque un cliente puede llegar razonablemente con cada uno de ellos. Un **dominio personalizado** de R2 (`cdn.example.com`) **no** se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: genera la URL prefirmada del endpoint `.r2.cloudflarestorage.com`, o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. + +Los marcadores `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La comparación se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que eso **no** amplía es el espacio de nombres en sí: el sufijo sigue teniendo que ser uno de los listados. + +El ejemplo de abajo muestra solo la forma: un valor real también lleva los parámetros de consulta de la firma, que aquí se omiten a propósito porque un ejemplo publicado vive en la especificación para siempre, y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. + +Cada imagen está limitada a 25 MiB y las imágenes de una misma solicitud a 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: ahí cada imagen puede llegar a 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud hasta 128 MiB en total. -Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los que aparecen en la lista. -El ejemplo de abajo muestra solo la forma: un valor real también lleva los parámetros de consulta de firma, que aquí se omiten a propósito porque un ejemplo publicado vive en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. -Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: ahí cada imagen puede llegar hasta 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud hasta 128 MiB en total. - El modelo gpt-image que se ejecutará. Router inserta el id del modelo direccionado, así que un llamador que apunta a /v2/models/openai/gpt-image-2 no envía esto. + El modelo gpt-image a ejecutar. Router inserta el id del modelo direccionado, así que un cliente que apunta a /v2/models/openai/gpt-image-2.6-flare no envía esto. @@ -203,52 +217,52 @@ Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en - El número de imágenes a generar (1-10). + El número de imágenes a generar (1-10). Una solicitud GIF (ver `output_format`) rechaza cualquier valor distinto de 1: la propia descripción de OpenAI llama a `n` en una solicitud GIF «el número de animaciones», que Router no tarifica para v1. Alcance: `1` a `10` - Nivel de compresión para JPEG o WebP (0-100) + Nivel de compresión para JPEG o WebP (0-100). Router lo rechaza en una solicitud GIF: OpenAI no acepta un nivel de compresión para una salida animada. Alcance: `0` a `100` - Formato de la imagen de salida + Formato de la imagen de salida. `gif` además rechaza `mask`, un `n` distinto de 1, un `size` omitido, `auto` o mal formado, `stream: true`, `partial_images` mayor que 0 y `output_compression` (ver la descripción de cada campo), y se rechaza de plano a menos que Comfy lo haya habilitado para este entorno. - Valores posibles: `png`, `webp`, `jpeg` + Valores posibles: `png`, `webp`, `jpeg`, `gif` - Significativo solo junto con un flujo en vivo, que esta superficie no puede servir: `stream` se fija en `false` incluso cuando lo envías. En una generación, cualquier valor distinto de `0` o `null` se rechaza con un 400, tanto si la solicitud también envía `stream: true` como si no; en una solicitud que lleva `image` el campo se descarta en lugar de reenviarse. Omítelo. + Solo tiene sentido junto a un stream en vivo, que esta superficie no puede servir, exactamente igual que en OpenAIImageRouterRequest; ver la descripción de ese campo. Un valor mayor que 0 se rechaza en una solicitud GIF, por la misma razón que `stream: true`; 0 se acepta. Alcance: `0` a `3` - Una descripción de texto de la imagen a generar, o de la edición que se hará a `image`. + Una descripción de texto de la imagen a generar, o de la edición que se hará sobre `image`. - La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se añadieron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la era dall-e que ningún modelo admitido lee. + La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles por los que se añadieron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la era dall-e que ningún modelo admitido lee. Valores posibles: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` - Tamaño de la imagen (p. ej., 1024x1024, 1536x1024, auto) + Tamaño de la imagen (p. ej., 1024x1024, 1536x1024, auto). Una solicitud GIF (ver `output_format`) rechaza `auto` y rechaza omitir este campo: un tamaño explícito es lo que mantiene finitos la cotización previa y el límite de resultado de 64 MiB antes de un recuento de fotogramas que los multiplica. - Declarado para que un llamador que lo envía no sea rechazado, pero INERTE en esta superficie: Router lo FIJA en `false` antes del despacho, porque captura la respuesta del proveedor en lugar de retransmitir un `text/event-stream` (una solicitud que lleva `image` descarta el campo, ya que la edición se recodifica sin él). Ninguna superficie de Comfy sirve el streaming de imágenes parciales de gpt-image: la entrada v1 `POST /proxy/openai/images/generations` rechaza `stream: true` con un 400 y nunca reenvía la solicitud al proveedor, así que omite el campo y lee la respuesta completada como un solo cuerpo JSON. Como el flujo nunca se abre, la restricción de OpenAI de combinar `stream: true` con un `n` mayor que 1 no aplica aquí; `n` se reenvía tal como se envía. + Se declara para que un cliente que lo envíe no sea rechazado, pero es INERTE en esta superficie exactamente igual que en OpenAIImageRouterRequest; ver la descripción de ese campo. `true` se rechaza en una solicitud GIF (la guía de OpenAI indica que la salida GIF no admite streaming); `false` se acepta. Un identificador único para el monitoreo de usuarios finales -Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. +Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-image-2.6-sunburst/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida @@ -261,7 +275,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-ima - Prompt revisado + prompt revisado @@ -309,25 +323,25 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-ima - Indica si el fondo de la imagen generada es `opaque` o `transparent`, tal como OpenAI lo resolvió para esta generación. El parámetro de la solicitud usa `auto` de forma predeterminada, así que aquí es donde quien no lo ancló descubre cuál se produjo. + Si el fondo de la imagen generada es `opaque` o `transparent`, tal como OpenAI lo resolvió para esta generación. El parámetro de la solicitud tiene como valor predeterminado `auto`, así que aquí es donde quien llama y no lo ancló se entera de cuál se produjo. - Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara como REQUERIDO en una respuesta de generación de imágenes, así que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativas lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. + Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara REQUIRED en una respuesta de generación de imágenes, así que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, minimax, pika, wavespeed o runware en cualquiera de los ids respaldados por alternativas lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de epoch de la actualidad está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. Formato: `int64` - La codificación de los bytes en `data[].b64_json`: `png`, `webp` o `jpeg`. Es el formato que OpenAI realmente codificó, que es el `output_format` de la solicitud cuando se envió uno y `png` cuando no se envió ninguno, así que un decodificador puede basarse en él en lugar de volver a derivar el formato desde la solicitud. + La codificación de los bytes en `data[].b64_json`: `png`, `webp` o `jpeg`. Es el formato que OpenAI realmente codificó, que es el `output_format` de la solicitud cuando se envió uno y `png` cuando no se envió ninguno, de modo que un decodificador puede basarse en él en lugar de volver a deducir el formato a partir de la solicitud. - El nivel de calidad con el que realmente se ejecutó la generación: OpenAI informa uno de `low`, `medium`, `high`, `xhigh` o `max`. Es el nivel RESUELTO, no un eco de la solicitud, cuyo propio `quality` usa `auto` por defecto. + El nivel de calidad al que realmente se ejecutó la generación: OpenAI informa uno de `low`, `medium`, `high`, `xhigh` o `max`. Es el nivel RESUELTO, no un eco de la solicitud, cuyo propio `quality` tiene como valor predeterminado `auto`. - Las dimensiones en píxeles con las que realmente se ejecutó la generación, como `x`. Es el tamaño RESUELTO: el `size` de la solicitud usa `auto` por defecto y admite `auto` explícitamente, así que este es el único lugar donde se informan las dimensiones realmente usadas. + Las dimensiones en píxeles a las que realmente se ejecutó la generación, como `x`. Es el tamaño RESUELTO: el `size` de la solicitud tiene como valor predeterminado `auto` y admite explícitamente `auto`, así que este es el único lugar donde se informan las dimensiones realmente usadas. ## Ejemplos diff --git a/es/development/comfy-router/models/openai/gpt-image-2/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2/code.mdx index 26cb0c2f73..54374cf25e 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -2,16 +2,17 @@ title: "Usa GPT Image 2 con Comfy Router" description: "Llama a openai/gpt-image-2 a través de Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "GPT Image 2" -translationSourceHash: 2fe15764 +translationSourceHash: 40bf9f79 translationFrom: development/comfy-router/models/openai/gpt-image-2/code.mdx translationBlockHashes: "_intro": ff220f7e "Quick start": 7ec2e3b6 "Serving providers": f3930e40 - "Schema": 4e6e5e53 + "Schema": d733408e "Examples": c73859ec --- + {/* GENERATED FILE. Generated from router-schemas/openai/gpt-image-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -176,23 +177,23 @@ Comfy Router sirve este modelo directamente a menos que la solicitud indique otr La imagen o imágenes fuente que se van a editar. LA PRESENCIA DE ESTE CAMPO SELECCIONA LA OPERACIÓN DE EDICIÓN: omítelo por completo para la generación de texto a imagen. -El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` es toda la diferencia entre los dos modos: mismo endpoint, mismo id de modelo; salvo que un prompt de edición describe el CAMBIO que quieres, no la escena, así que el cuerpo de edición de abajo se lee distinto del ejemplo de generación aunque solo este campo sea estructuralmente nuevo. -Puedes copiarlo exactamente como se muestra: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`. La carga útil es un PNG 1x1 completo, no una abreviatura, y este cuerpo está fijado como un caso aceptado en las pruebas de validación de solicitudes del propio Router. Sustituye los bytes por los de tu propia imagen. +El ejemplo publicado del modelo es la llamada de GENERACIÓN, que omite este campo. Agregar `image` es toda la diferencia entre los dos modos (mismo endpoint, mismo id de modelo), salvo que un prompt de edición describe el CAMBIO que quieres y no la escena, así que el cuerpo de edición de abajo se lee distinto del ejemplo de generación aunque el único campo estructuralmente nuevo sea este. +Puedes copiarlo exactamente tal como aparece: `{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`. La carga útil es un PNG 1x1 completo, no una abreviatura, y este cuerpo está fijado como caso aceptado en las pruebas de validación de solicitudes del propio Router. Sustituye los bytes por los de tu propia imagen. Acepta una imagen o un arreglo de ellas; gpt-image-1 y versiones posteriores aceptan hasta 16, y Router lo aplica desde este esquema antes de despachar. Una imagen, ya sea una URL https que Router obtiene en nombre de quien llama o un URI `data:image/;base64,` que lleva los bytes en línea. Los tipos de imagen aceptados son png, webp y jpeg, y ese conjunto se APLICA en el momento de resolver, en lugar de dejarlo al proveedor: un svg, gif, avif o tiff se rechaza aquí, nombrando la imagen que enviaste, en vez de convertirse en un error del socio a dos saltos de la causa. Prefiere la forma de URL. Una carga útil en base64 se infla aproximadamente 4/3 y todo el cuerpo de la solicitud tiene un límite de 100 MiB, así que la forma en línea llega como máximo a una imagen fuente de unos 75 MB; una URL evita eso por completo. Los techos de medios por imagen y por solicitud indicados al final de esta descripción son más estrictos que el límite del cuerpo, así que para una imagen de cualquier tamaño real son lo primero que encuentras. -**La URL debe resolverse sin tus credenciales.** Router la obtiene del lado del servidor y no envía ninguna credencial de quien llama con la solicitud, así que una URL prefirmada, cuya firma está en la cadena de consulta, es la forma admitida. Un endpoint autenticado como `/api/assets/{id}/content` le responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. -**La obtención está limitada a un conjunto nombrado de hosts** en lugar de a la internet abierta, y la misma lista se vuelve a aplicar a cada salto de redirección, así como a la URL que envías: por eso, una URL en cualquier otro host, o una que redirija fuera de la lista, se rechaza antes de contactar a cualquier proveedor. Hoy esa lista es solo la entrega de recursos propia de Comfy: una URL firmada de `storage.googleapis.com` dentro de un bucket de recursos de Comfy, que es la forma a la que te redirige `/api/assets/{id}/content`. Un CDN de un socio o un host https simple NO está en la lista. -**Dos ampliaciones se están implementando y ambas están desactivadas por defecto hoy.** Se lanzan detrás de UN interruptor y se habilitan juntas, así que trata todo lo que sigue como algo próximo, no como algo sobre lo que construir todavía: pregunta antes de depender de cualquiera de las dos. -La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que la implementación llegue a tu entorno, una URL de carga de ese endpoint se rechaza aquí, aunque el bucket sea propio de Comfy y el host sea el mismo: así que “subir a Comfy y luego pasar la URL” NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. -La SEGUNDA se HABILITA POR CUENTA, no para todos a la vez, porque el bucket detrás de estos hosts es tuyo, no nuestro: incluso una vez que el interruptor anterior está activado, una cuenta a la que no se le han habilitado los medios entrantes de terceros se rechaza, y se le dice con esas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que lo habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, ya sea en la forma de estilo de ruta o con el prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un disparador de Alibaba Function Compute, no está en la lista y se rechaza. -**Lo que se compara es la forma del nombre de host, no el proveedor**: por eso, nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y vale la pena enunciar directamente tres casos que casi encajan, porque es razonable que quien llama llegue con cualquiera de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de velocidad y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí para leerlas. -Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo de dominio del almacenamiento de objetos, así que un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`) también es válido. Lo que NO se amplía con eso es el propio espacio de nombres: el sufijo debe seguir siendo uno de los listados. +LA URL DEBE RESOLVERSE SIN TUS CREDENCIALES. Router la obtiene del lado del servidor y no envía ninguna credencial de quien llama con la solicitud, así que la forma admitida es una URL prefirmada, es decir, una cuya firma va en la cadena de consulta. Un endpoint autenticado como `/api/assets/{id}/content` le responde a Router con 401 en lugar de la imagen; solicita esa URL tú mismo y pasa la URL firmada a la que redirige. +LA OBTENCIÓN ESTÁ LIMITADA A UN CONJUNTO NOMBRADO DE HOSTS y no a la internet abierta, y la misma lista se vuelve a aplicar a cada salto de redirección y también a la URL que envías, así que una URL en cualquier otro host, o una que redirija fuera de la lista, se rechaza antes de contactar a cualquier proveedor. Hoy esa lista es solo la entrega de recursos propia de Comfy: una URL firmada de `storage.googleapis.com` dentro de un bucket de recursos de Comfy, que es la forma a la que te redirige `/api/assets/{id}/content`. Un CDN de un socio o un host https simple NO está en la lista. +DOS AMPLIACIONES SE ESTÁN IMPLEMENTANDO Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Llegan detrás de UN interruptor y se habilitan juntas, así que trata todo lo que sigue como algo futuro y no como algo sobre lo que construir todavía: pregunta antes de depender de cualquiera de las dos. +La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que la implementación llegue a tu entorno, una URL de carga de ese endpoint se rechaza aquí, aunque el bucket sea propio de Comfy y el host sea el mismo: por eso «subir a Comfy y luego pasar la URL» NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. +La SEGUNDA se HABILITA POR CUENTA y no para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta que no tenga habilitados los medios entrantes de terceros se rechaza, y el mensaje lo dice con esas palabras en lugar de decir que el host no es compatible. Pide a tu contacto de Comfy que lo habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, tanto en la forma de estilo de ruta como con el prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un disparador de Alibaba Function Compute, no está en la lista y se rechaza. +LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR: por eso, nombrar un proveedor arriba NO significa que se acepte cualquier URL que ese proveedor pueda emitir, y vale la pena enunciar directamente tres casos que se le parecen, porque quien llama puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO DE R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un hostname de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su hostname que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes de vuelta nombra estas mismas formas, así que no tienes que venir aquí a leerlas. +Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo de dominio del almacenamiento de objetos, así que un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`) también es válido. Lo que NO se amplía con eso es el propio espacio de nombres: el sufijo debe seguir siendo uno de los enumerados. El ejemplo de abajo muestra solo la forma: un valor real también incluye los parámetros de consulta de firma, que se omiten aquí a propósito porque un ejemplo publicado permanece en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. -Cada imagen tiene un límite de 25 MiB y las imágenes de una misma solicitud, de 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`), donde `context_window` está disponible: ahí cada imagen puede llegar a 50 MB (50.000.000 bytes) y 67.108.864 píxeles, y las imágenes de una sola solicitud hasta 128 MiB en total. +Cada imagen está limitada a 25 MiB y el total de las imágenes de una solicitud, a 64 MiB. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`), donde `context_window` está disponible: ahí cada imagen puede llegar a 50 MB (50.000.000 bytes) y 67.108.864 píxeles, y el total de las imágenes de una solicitud hasta 128 MiB. @@ -234,7 +235,7 @@ Cada imagen tiene un límite de 25 MiB y las imágenes de una misma solicitud, d - La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se añadieron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la época de dall-e que ningún modelo admitido lee. + La calidad de la imagen generada o editada. `xhigh` y `max` son los dos niveles para los que se añadieron gpt-image-2.5-flare y gpt-image-2.5-sunburst; `standard` y `hd` son grafías de la época de dall-e que ningún modelo admitido reconoce. Valores posibles: `auto`, `low`, `medium`, `high`, `xhigh`, `max`, `standard`, `hd` @@ -312,11 +313,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/openai/gpt-ima - Si el fondo de la imagen generada es `opaque` o `transparent`, tal como OpenAI lo resolvió para esta generación. El parámetro de la solicitud toma `auto` por defecto, así que aquí es donde quien no lo fijó se entera de cuál se produjo. + Si el fondo de la imagen generada es `opaque` o `transparent`, tal como OpenAI lo resolvió para esta generación. El parámetro de la solicitud toma `auto` por defecto, así que aquí es donde quien no lo ancló se entera de cuál se produjo. - Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara OBLIGATORIO en una respuesta de generación de imágenes, así que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, pika, wavespeed o runware en cualquiera de los id con respaldo alternativo lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. + Marca de tiempo Unix, en segundos, de cuándo se completó la generación. Es el único miembro que OpenAI declara REQUERIDO en una respuesta de generación de imágenes, así que está presente siempre que OpenAI sea el productor; una respuesta servida por fal, minimax, pika, wavespeed o runware en cualquiera de los id con respaldo alternativo lo omite por completo, igual que los otros cuatro miembros de parámetros resueltos. Se declara `int64` porque un valor de época actual está lo bastante cerca de 2^31 como para que un `integer` sin formato genere un campo de 32 bits en muchos generadores de SDK. Formato: `int64` diff --git a/es/development/comfy-router/models/pixverse/v3-5/code.mdx b/es/development/comfy-router/models/pixverse/v3-5/code.mdx new file mode 100644 index 0000000000..94939f0256 --- /dev/null +++ b/es/development/comfy-router/models/pixverse/v3-5/code.mdx @@ -0,0 +1,309 @@ +--- +title: "Usa V3.5 con Comfy Router" +description: "Llama a pixverse/v3.5 mediante Comfy Router: el endpoint, la forma de la solicitud y la respuesta que devuelve Router." +sidebarTitle: "V3.5" +translationSourceHash: c6a6b3a8 +translationFrom: development/comfy-router/models/pixverse/v3-5/code.mdx +translationBlockHashes: + "_intro": 2772d5c1 + "Quick start": dc3a1030 + "Schema": 48bf7abc + "Examples": 0600cc10 +--- +{/* ARCHIVO GENERADO. Generado a partir de router-schemas/pixverse/v3.5.json mediante `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `pixverse/v3.5`, ofrecida por Comfy Router de Pixverse. + +**Entrada:** Texto · **Salida:** Video + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. + +**ID del modelo:** `pixverse/v3.5` + +**Endpoint:** `POST https://api.comfy.org/v2/models/pixverse/v3.5` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "pixverse/v3.5", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("pixverse/v3.5", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v3.5 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/pixverse/v3.5/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica paso a paso el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v3.5", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado del Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("pixverse/v3.5", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. El Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/pixverse/v3.5/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v3.5/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/pixverse/v3.5/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` + + + + Alcance: `1` a `15` + + + + + + + + Identificador del modelo de texto a video de PixVerse. En la ruta `POST /v2/models/pixverse/{model}` de Comfy Router, este campo se toma de la ruta y puedes omitirlo. + + + + Valores posibles: `normal`, `fast` + + + + + + + + + + + + Valores posibles: `360p`, `540p`, `720p`, `1080p` + + + + + + + + Valores posibles: `anime`, `3d_animation`, `clay`, `comic`, `cyberpunk` + + + + + + + + + + +Generado a partir del esquema que Router sirve en `GET /v2/models/pixverse/v3.5/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Valores posibles: `1`, `5`, `6`, `7`, `8` + + + + + + + + + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### Salida + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + + diff --git a/es/development/comfy-router/models/pixverse/v6-max/code.mdx b/es/development/comfy-router/models/pixverse/v6-max/code.mdx new file mode 100644 index 0000000000..7d76d0d94e --- /dev/null +++ b/es/development/comfy-router/models/pixverse/v6-max/code.mdx @@ -0,0 +1,310 @@ +--- +title: "Usa V6 Max con Comfy Router" +description: "Llama a pixverse/v6-max con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "V6 Max" +translationSourceHash: fe910720 +translationFrom: development/comfy-router/models/pixverse/v6-max/code.mdx +translationBlockHashes: + "_intro": 79517cb6 + "Quick start": 3197f978 + "Schema": 982f249f + "Examples": 0600cc10 +--- +{/* GENERATED FILE. Generated from router-schemas/pixverse/v6-max.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `pixverse/v6-max`, servido por Comfy Router de Pixverse. + +**Entrada:** Texto · **Salida:** Video + + + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP directo. + +**ID del modelo:** `pixverse/v6-max` + +**Endpoint:** `POST https://api.comfy.org/v2/models/pixverse/v6-max` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "pixverse/v6-max", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("pixverse/v6-max", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v6-max \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/pixverse/v6-max/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v6-max", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o fue cancelada lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("pixverse/v6-max", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o fue cancelada se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/pixverse/v6-max/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v6-max/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/pixverse/v6-max/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` + + + + Rango: de `1` a `15` + + + + + + + + Identificador del modelo de texto a video de PixVerse. En la ruta `POST /v2/models/pixverse/{model}` de Comfy Router, este campo proviene de la ruta y puedes omitirlo. + + + + Valores posibles: `normal`, `fast` + + + + + + + + + + + + Valores posibles: `360p`, `540p`, `720p`, `1080p` + + + + + + + + Valores posibles: `anime`, `3d_animation`, `clay`, `comic`, `cyberpunk` + + + + + + + + + + +Generado a partir del esquema que Router publica en `GET /v2/models/pixverse/v6-max/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Valores posibles: `1`, `5`, `6`, `7`, `8` + + + + + + + + + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### Salida + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + diff --git a/es/development/comfy-router/models/pixverse/v6/code.mdx b/es/development/comfy-router/models/pixverse/v6/code.mdx new file mode 100644 index 0000000000..4982adbe20 --- /dev/null +++ b/es/development/comfy-router/models/pixverse/v6/code.mdx @@ -0,0 +1,308 @@ +--- +title: "Usar V6 con Comfy Router" +description: "Llama a pixverse/v6 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "V6" +translationSourceHash: a19e855d +translationFrom: development/comfy-router/models/pixverse/v6/code.mdx +translationBlockHashes: + "_intro": f933db97 + "Quick start": cbf8e767 + "Schema": f1b3a5fb + "Examples": 0600cc10 +--- +{/* GENERATED FILE. Generated from router-schemas/pixverse/v6.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API de `pixverse/v6`, servida por Comfy Router desde Pixverse. + +**Entrada:** Texto · **Salida:** Video + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. + +**Model ID:** `pixverse/v6` + +**Endpoint:** `POST https://api.comfy.org/v2/models/pixverse/v6` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "pixverse/v6", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("pixverse/v6", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/pixverse/v6 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/pixverse/v6/requests`. Router responde `201` con un `request_id` en cuanto admite la ejecución, y recuperas el resultado en cuanto está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) recorre el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "pixverse/v6", + { + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p", + }, + ) + print("request_id:", handle.request_id) # junto con el ID del modelo, es todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("pixverse/v6", { + aspect_ratio: "16:9", + duration: 5, + prompt: "a single red maple leaf falling onto still water", + quality: "360p", +}); +console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/pixverse/v6/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"aspect_ratio\": \"16:9\", \"duration\": 5, \"prompt\": \"a single red maple leaf falling onto still water\", \"quality\": \"360p\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/pixverse/v6/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/pixverse/v6/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` + + + + Rango: de `1` a `15` + + + + + + + + Identificador del modelo PixVerse de texto a video. En la ruta de Comfy Router `POST /v2/models/pixverse/{model}`, este campo se toma de la ruta y puedes omitirlo. + + + + Valores posibles: `normal`, `fast` + + + + + + + + + + + + Valores posibles: `360p`, `540p`, `720p`, `1080p` + + + + + + + + Valores posibles: `anime`, `3d_animation`, `clay`, `comic`, `cyberpunk` + + + + + + + + + + +Generado a partir del esquema que Router publica en `GET /v2/models/pixverse/v6/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Valores posibles: `1`, `5`, `6`, `7`, `8` + + + + + + + + + + +## Ejemplos + +### Entrada + +```json +{ + "aspect_ratio": "16:9", + "duration": 5, + "prompt": "a single red maple leaf falling onto still water", + "quality": "360p" +} +``` + +### Salida + +```json +{ + "ErrCode": 0, + "ErrMsg": "", + "Resp": { + "credits": 1, + "id": 4242, + "status": 1, + "url": "https://example.invalid/pixverse/v6/out.mp4" + } +} +``` + + diff --git a/es/development/comfy-router/models/pruna/p-video-2/code.mdx b/es/development/comfy-router/models/pruna/p-video-2/code.mdx index fde6b6955c..7f657a83fb 100644 --- a/es/development/comfy-router/models/pruna/p-video-2/code.mdx +++ b/es/development/comfy-router/models/pruna/p-video-2/code.mdx @@ -2,14 +2,15 @@ title: "Usa P Video 2 con Comfy Router" description: "Llama a pruna/p-video-2 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "P Video 2" -translationSourceHash: adc4bb77 +translationSourceHash: b7aa4ce2 translationFrom: development/comfy-router/models/pruna/p-video-2/code.mdx translationBlockHashes: "_intro": 7b513d6b "Quick start": 9d47988e - "Schema": 51d0cc63 + "Schema": 4bd9bf87 "Examples": 0d85c9fe --- + {/* GENERATED FILE. Generated from router-schemas/pruna/p-video-2.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -240,7 +241,35 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/pruna/p-video- - Mensaje de progreso legible para las personas. + Mensaje de progreso legible. + + + + Veredicto del verificador de seguridad de Pruna. Presente en un estado failed cuando la moderación de contenido bloqueó la predicción. + + + + Indica si el verificador de seguridad bloqueó la predicción. + + + + Indica si el bloqueo proviene de un filtro de seguridad que la solicitud podría desactivar. + + + + Categorías de políticas de contenido que activaron el bloqueo, por ejemplo sexual. + + + + Resumen legible del bloqueo. + + + + Qué se examinó: input (la solicitud enviada) u output (el video generado). + + + + Motivo legible del bloqueo. diff --git a/es/development/comfy-router/models/quiver/arrow-2-telos/code.mdx b/es/development/comfy-router/models/quiver/arrow-2-telos/code.mdx new file mode 100644 index 0000000000..32b9736a86 --- /dev/null +++ b/es/development/comfy-router/models/quiver/arrow-2-telos/code.mdx @@ -0,0 +1,283 @@ +--- +title: "Usar Arrow 2 Telos con Comfy Router" +description: "Llama a quiver/arrow-2-telos con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Arrow 2 Telos" +translationSourceHash: 38ec271d +translationFrom: development/comfy-router/models/quiver/arrow-2-telos/code.mdx +translationBlockHashes: + "_intro": 7e87a52d + "Quick start": 63ad01e1 + "Schema": 76a21cd4 + "Examples": 36e915ba +--- +{/* GENERATED FILE. Generated from router-schemas/quiver/arrow-2-telos.json by `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `quiver/arrow-2-telos`, servido por Comfy Router desde Quiver. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar. + +**ID del modelo:** `quiver/arrow-2-telos` + +**Endpoint:** `POST https://api.comfy.org/v2/models/quiver/arrow-2-telos` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "quiver/arrow-2-telos", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza en los reintentos automáticos. +const { data } = await comfy.models.run("quiver/arrow-2-telos", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests`. Router responde `201` con un `request_id` en cuanto admite la ejecución, y recoges el resultado cuando esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) detalla el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "quiver/arrow-2-telos", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que otro proceso necesita + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # El payload propio del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló lanza aquí el error tipado del Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza en los reintentos automáticos. +const handle = await comfy.models.submit("quiver/arrow-2-telos", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que otro proceso necesita + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló provoca un rechazo aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo del estado mientras sigue en ejecución. +curl https://api.comfy.org/v2/models/quiver/arrow-2-telos/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Orientación adicional sobre estilo o formato + + + + Número máximo de tokens de salida + + Rango: `1` a `131072` + + + + Identificador del modelo para la generación de SVG + + + + Cantidad de SVG a generar + + Rango: `1` a `16` + + + + Penalización para los tokens ya presentes en la salida previa. `arrow-2-telos` la ignora, ya que no acepta parámetros de muestreo; el campo se elimina de la solicitud antes de reenviarla, sin generar un error. + + Rango: `-2` a `2` + + + + Descripción de texto del SVG de salida deseado + + + + Imágenes de referencia opcionales para orientar el estilo y la composición. Acepta un objeto URL, un objeto base64 o la forma abreviada de cadena URL. Los límites en tiempo de ejecución dependen de cada modelo. + + + + Temperatura de muestreo. `arrow-2-telos` la ignora, ya que no acepta parámetros de muestreo; el campo se elimina de la solicitud antes de reenviarla, sin generar un error. + + Rango: `0` a `2` + + + + Probabilidad de muestreo por núcleo. `arrow-2-telos` la ignora, ya que no acepta parámetros de muestreo; el campo se elimina de la solicitud antes de reenviarla, sin generar un error. + + Rango: `0` a `1` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/quiver/arrow-2-telos/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Marca de tiempo Unix de creación + + + + Costo en créditos para los modelos de créditos fijos como arrow-1.1. Se omite en los modelos con precio por token como arrow-2, que reportan los totales de tokens medidos en usage. + + Rango: `0` a `…` + + + + + + + + Tipo MIME de la salida + + Valores posibles: `image/svg+xml` + + + + Marcado SVG sin procesar + + + + Identificador único de la generación + + + + Totales de tokens para los modelos con precio por token como arrow-2. Los modelos de créditos fijos pueden reportar ceros aquí. + + + + Cantidad de tokens de entrada para los modelos con precio por token. + + Rango: `0` a `…` + + + + Cantidad de tokens de salida para los modelos con precio por token. + + Rango: `0` a `…` + + + + Cantidad total de tokens para los modelos con precio por token. + + Rango: `0` a `…` + + +## Ejemplos + +### Entrada + +```json +{ + "n": 1, + "prompt": "A single red maple leaf on a plain white background." +} +``` + +### Salida + +```json +{ + "created": 1767225600, + "data": [ + { + "mime_type": "image/svg+xml", + "svg": "" + } + ], + "id": "svg_018f2c7a4b1e7c3d9a056e2f8b41d0c9", + "usage": { + "input_tokens": 180, + "output_tokens": 240, + "total_tokens": 420 + } +} +``` + + diff --git a/es/development/comfy-router/models/quiver/arrow-2/code.mdx b/es/development/comfy-router/models/quiver/arrow-2/code.mdx new file mode 100644 index 0000000000..279ea17f9c --- /dev/null +++ b/es/development/comfy-router/models/quiver/arrow-2/code.mdx @@ -0,0 +1,283 @@ +--- +title: "Usa Arrow 2 con Comfy Router" +description: "Llama a quiver/arrow-2 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." +sidebarTitle: "Arrow 2" +translationSourceHash: e78a6b9f +translationFrom: development/comfy-router/models/quiver/arrow-2/code.mdx +translationBlockHashes: + "_intro": ef6a6611 + "Quick start": c39331bc + "Schema": d3c8d579 + "Examples": 36e915ba +--- +{/* ARCHIVO GENERADO. Generado a partir de router-schemas/quiver/arrow-2.json por `pnpm code-pages:gen`. */} + +import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; + +Referencia de API para `quiver/arrow-2`, servida por Comfy Router desde Quiver. + +**Entrada:** Texto, Imagen · **Salida:** Imagen + +## Inicio rápido + +Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP sin procesar. + +**ID del modelo:** `quiver/arrow-2` + +**Endpoint:** `POST https://api.comfy.org/v2/models/quiver/arrow-2` + + + + +```python Python +from comfy_sdk import Comfy + +# Lee COMFY_API_KEY del entorno. +# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +with Comfy() as client: + result = client.models.run( + "quiver/arrow-2", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + +print(result) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. +const { data } = await comfy.models.run("quiver/arrow-2", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); + +console.log(data); +``` + +```bash cURL +curl https://api.comfy.org/v2/models/quiver/arrow-2 \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" +``` + + + +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/quiver/arrow-2/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. + + +```python Python +import asyncio +from comfy_sdk import AsyncComfy + +# Lee COMFY_API_KEY del entorno. +# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +async def main(): + async with AsyncComfy() as client: + handle = await client.models.submit( + "quiver/arrow-2", + { + "n": 1, + "prompt": "A single red maple leaf on a plain white background.", + }, + ) + print("request_id:", handle.request_id) # con el ID del modelo, todo lo que necesita otro proceso + + # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. + async for update in handle.iter_events(): + print(update.status, update.queue_position) + + # La carga propia del proveedor, el mismo valor que devuelve models.run(). + # Una solicitud que falló o se canceló genera aquí el error tipado de Router. + result = await handle.get() + + print(result) + +asyncio.run(main()) +``` + +```typescript TypeScript +import { comfy } from "@comfyorg/sdk"; + +// Lee COMFY_API_KEY del entorno. +// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. +const handle = await comfy.models.submit("quiver/arrow-2", { + n: 1, + prompt: "A single red maple leaf on a plain white background.", +}); +console.log("requestId:", handle.requestId); // con el ID del modelo, todo lo que necesita otro proceso + +// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. +for await (const update of handle.events()) { + console.log(update.status, update.queuePosition); +} + +// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. +const result = await handle.get(); + +console.log(result.data); +``` + +```bash cURL +# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. +curl https://api.comfy.org/v2/models/quiver/arrow-2/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d "{\"n\": 1, \"prompt\": \"A single red maple leaf on a plain white background.\"}" + +# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. +REQUEST_ID="" +curl -i https://api.comfy.org/v2/models/quiver/arrow-2/requests/$REQUEST_ID/status \ + -H "X-API-Key: $COMFY_API_KEY" + +# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras aún se está ejecutando. +curl https://api.comfy.org/v2/models/quiver/arrow-2/requests/$REQUEST_ID \ + -H "X-API-Key: $COMFY_API_KEY" +``` + + + + +## Esquema + +### Entrada + + + Orientación adicional de estilo o formato + + + + Número máximo de tokens de salida + + Alcance: `1` a `131072` + + + + Identificador del modelo para la generación de SVG + + + + Número de SVG que se van a generar + + Alcance: `1` a `16` + + + + Penalización por los tokens que ya aparecen en la salida previa. `arrow-2-telos` la ignora, ya que no acepta parámetros de muestreo; el campo se elimina de la solicitud antes de reenviarla, sin generar un error. + + Alcance: `-2` a `2` + + + + Descripción de texto del resultado SVG deseado + + + + Imágenes de referencia opcionales para guiar el estilo y la composición. Acepta un objeto URL, un objeto base64 o la forma abreviada de cadena URL. Los límites de ejecución dependen de cada modelo. + + + + Temperatura de muestreo. `arrow-2-telos` la ignora, ya que no acepta parámetros de muestreo; el campo se elimina de la solicitud antes de reenviarla, sin generar un error. + + Alcance: `0` a `2` + + + + Probabilidad de muestreo de núcleo. `arrow-2-telos` la ignora, ya que no acepta parámetros de muestreo; el campo se elimina de la solicitud antes de reenviarla, sin generar un error. + + Alcance: `0` a `1` + + +Generado a partir del esquema que Router sirve en `GET /v2/models/quiver/arrow-2/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + +### Salida + + + Marca de tiempo Unix de creación + + + + Costo en créditos para los modelos de créditos fijos como arrow-1.1. Se omite en los modelos con precio por token como arrow-2, que reportan los totales de tokens medidos en usage. + + Alcance: `0` a `…` + + + + + + + + Tipo MIME de la salida + + Valores posibles: `image/svg+xml` + + + + Marcado SVG sin procesar + + + + Identificador único de la generación + + + + Totales de tokens para los modelos con precio por token como arrow-2. Los modelos de créditos fijos pueden reportar ceros aquí. + + + + Recuento de tokens de entrada para los modelos con precio por token. + + Alcance: `0` a `…` + + + + Recuento de tokens de salida para los modelos con precio por token. + + Alcance: `0` a `…` + + + + Recuento total de tokens para los modelos con precio por token. + + Alcance: `0` a `…` + + +## Ejemplos + +### Entrada + +```json +{ + "n": 1, + "prompt": "A single red maple leaf on a plain white background." +} +``` + +### Salida + +```json +{ + "created": 1767225600, + "data": [ + { + "mime_type": "image/svg+xml", + "svg": "" + } + ], + "id": "svg_018f2c7a4b1e7c3d9a056e2f8b41d0c9", + "usage": { + "input_tokens": 180, + "output_tokens": 240, + "total_tokens": 420 + } +} +``` + + diff --git a/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx b/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx index 710c1a3383..92e2769c20 100644 --- a/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx +++ b/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx @@ -2,14 +2,15 @@ title: "Usa Veo 3.1 Fast Generate 001 con Comfy Router" description: "Llama a veo/veo-3.1-fast-generate-001 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Veo 3.1 Fast Generate 001" -translationSourceHash: f5553980 +translationSourceHash: 436f69a6 translationFrom: development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx translationBlockHashes: "_intro": 2dd8ad2f "Quick start": 4f13f7f7 - "Schema": e44aea6d + "Schema": 2b639366 "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-fast-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -333,8 +334,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ Duración objetivo del video generado en segundos. Veo 2: 5-8. Veo 3/3.1: 4, 6 u 8. Predeterminado: 8 - - Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. + Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. @@ -350,9 +350,10 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ - Controla las personas en los videos generados. Valor predeterminado: allow_adult + Controla las personas en los videos generados. Valor predeterminado: allow_adult. +También se aceptan `ALLOW` y `BLOCK`, por la misma razón de compatibilidad por la que el enum personGeneration de Veo2GenVidRequest los incluye (consulta la nota de ese componente): el nodo socio Veo 3 de ComfyUI (comfy_api_nodes/nodes_veo2.py) siempre envía una de estas dos grafías, nunca la propia de Vertex, a `/proxy/veo/{model}/generate` para veo-3.1-generate-001, veo-3.1-fast-generate-001 y veo-3.1-lite-generate-001, que son los tres IDs para los que este componente es el esquema de entrada de Router. En un despacho de Router (`model_provider=veo`) para uno de esos IDs, ya sea síncrono o en cola (`/v2/models/veo/{model}/requests`), `ALLOW` se asigna a `allow_adult` y `BLOCK` a `dont_allow` antes de que la solicitud llegue a Vertex (routerVeoMapPersonGeneration, server/middleware/router_veo_person_generation.go), porque Vertex por sí mismo no acepta ninguna de las dos grafías. Quien llame directamente a v1 `/proxy/veo/:modelId/generate` no se ve afectado en ningún caso: comfy-api no instala ningún validador de solicitudes en `/proxy/*`, así que este enum ya era documentación no aplicada allí, y la asignación exclusiva de Router no se ejecuta para esa llamada. - Valores posibles: `dont_allow`, `allow_adult`, `allowAll` + Valores posibles: `dont_allow`, `allow_adult`, `allowAll`, `ALLOW`, `BLOCK` @@ -360,7 +361,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ - Enfoque de redimensionado para la imagen de entrada. Valor predeterminado: pad + Método de redimensionado para la imagen de entrada. Valor predeterminado: pad Valores posibles: `pad`, `crop` @@ -374,7 +375,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ Número de videos a generar. Si no se especifica, se genera 1 video. - Rango: `1` a `4` + Alcance: `1` a `4` @@ -385,7 +386,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ Destino opcional de Cloud Storage para los videos generados, como un URI `gs://`. -DEBE NOMBRAR UN BUCKET PROPIO. Fuera de bring-your-own-key, esta ruta se ejecuta con las credenciales propias de Google Cloud de Comfy en lugar de las tuyas, así que un destino dentro de un bucket propiedad de Comfy sería una escritura realizada por la cuenta de servicio de Comfy, en un esquema compartido, facturada al proyecto de Comfy. Una solicitud que nombre uno se rechaza con un 400 y no se genera nada, con una excepción en una llamada síncrona de Comfy Router (`POST /v2/models/{provider}/{model}`) donde el almacenamiento de la plataforma está habilitado: un valor que nombre el propio bucket de recursos de Veo o Gemini de Router se reemplaza por un destino que Router crea bajo tu propio prefijo de plataforma para esa llamada (consulta la ruta Veo de Router), y solo se permite pasar ese destino exacto creado por Router. Un envío en cola de Router (`POST /v2/models/{provider}/{model}/requests`) no hace ese reemplazo, así que rechaza ese valor con un 400 como cualquier otro bucket propiedad de Comfy. Cualquier otro destino se reenvía a Vertex sin cambios y es tu responsabilidad conceder acceso. Una llamada bring-your-own-key se ejecuta en tu propio proyecto y se reenvía tal como se envía. +DEBE NOMBRAR UN BUCKET PROPIO. Fuera de bring-your-own-key, esta ruta se ejecuta con las credenciales de Google Cloud de Comfy en lugar de las tuyas, así que un destino dentro de un bucket propiedad de Comfy sería una escritura realizada por la cuenta de servicio de Comfy, en una estructura compartida, facturada al proyecto de Comfy. Una solicitud que nombre uno se rechaza con un 400 y no se genera nada, con una excepción en una llamada síncrona de Comfy Router (`POST /v2/models/{provider}/{model}`) donde el almacenamiento de la plataforma está habilitado: un valor que nombre el bucket de recursos de Veo o Gemini propiedad de Router se reemplaza por un destino que Router genera bajo tu propio prefijo de plataforma para esa llamada (consulta la ruta Veo de Router), y solo ese destino exacto generado por Router puede pasar. Un envío en cola de Router (`POST /v2/models/{provider}/{model}/requests`) no hace ese reemplazo, así que rechaza ese valor con un 400 como cualquier otro bucket propiedad de Comfy. Cualquier otro destino se reenvía a Vertex sin cambios y es tu responsabilidad conceder acceso. Una llamada bring-your-own-key se ejecuta en tu propio proyecto y se reenvía tal como se envía. @@ -419,7 +420,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veo/veo-3.1-fa - La respuesta de la predicción, presente cuando done es verdadero + La respuesta de la predicción, presente cuando `done` es verdadero @@ -431,7 +432,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veo/veo-3.1-fa - Motivos por los que se filtraron los videos según las políticas de IA responsable + Motivos por los que las políticas de IA responsable filtraron los videos diff --git a/es/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx b/es/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx index 531ca799d3..8df03c42a1 100644 --- a/es/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx +++ b/es/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx @@ -2,14 +2,15 @@ title: "Usa Veo 3.1 Generate 001 con Comfy Router" description: "Llama a veo/veo-3.1-generate-001 con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." sidebarTitle: "Veo 3.1 Generate 001" -translationSourceHash: 0fab4eef +translationSourceHash: 9721a315 translationFrom: development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx translationBlockHashes: "_intro": cba04c2d "Quick start": cd500ec3 - "Schema": 5618a5b3 + "Schema": afe36175 "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -260,7 +261,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ - Imágenes de referencia opcionales para guiar la generación de video. Admite hasta 3 imágenes de tipo asset o 1 imagen de tipo style. Compatible con modelos Veo 3.1 (vista previa). + Imágenes de referencia opcionales para guiar la generación de video. Admite hasta 3 imágenes de tipo asset o 1 imagen de tipo style. Compatible con los modelos Veo 3.1 (vista previa). @@ -333,9 +334,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ Duración objetivo del video generado en segundos. Veo 2: 5-8. Veo 3/3.1: 4, 6 u 8. Predeterminado: 8 - - -Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. +Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. @@ -351,9 +350,10 @@ Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterm - Controla las personas en los videos generados. Predeterminado: allow_adult + Controla las personas en los videos generados. Predeterminado: allow_adult. +También se aceptan `ALLOW` y `BLOCK`, por la misma razón de compatibilidad por la que el enum personGeneration de Veo2GenVidRequest las incluye (consulta la nota de ese componente): el nodo partner de Veo 3 de ComfyUI (comfy_api_nodes/nodes_veo2.py) siempre envía una de estas dos grafías, nunca la propia de Vertex, a `/proxy/veo/{model}/generate` para veo-3.1-generate-001, veo-3.1-fast-generate-001 y veo-3.1-lite-generate-001, los tres ids para los que este componente es el esquema de entrada de Router. En un despacho de Router (`model_provider=veo`) para uno de esos ids, ya sea síncrono o en cola (`/v2/models/veo/{model}/requests`), `ALLOW` se asigna a `allow_adult` y `BLOCK` a `dont_allow` antes de que la solicitud llegue a Vertex (routerVeoMapPersonGeneration, server/middleware/router_veo_person_generation.go), porque Vertex no acepta ninguna de las dos grafías. Una llamada directa a v1 `/proxy/veo/:modelId/generate` no se ve afectada en ningún caso: comfy-api no instala ningún validador de solicitudes en `/proxy/*`, así que este enum ya era documentación sin efecto ahí, y la asignación exclusiva de Router no se ejecuta para esa llamada. - Valores posibles: `dont_allow`, `allow_adult`, `allowAll` + Valores posibles: `dont_allow`, `allow_adult`, `allowAll`, `ALLOW`, `BLOCK` @@ -386,7 +386,7 @@ Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterm Destino opcional de Cloud Storage para los videos generados, como URI `gs://`. -DEBE NOMBRAR UN BUCKET PROPIO. Fuera de bring-your-own-key, esta ruta se ejecuta con las credenciales de Google Cloud de Comfy en lugar de las tuyas, así que un destino dentro de un bucket propiedad de Comfy sería una escritura realizada por la cuenta de servicio de Comfy, en un diseño compartido, facturada al proyecto de Comfy. Una solicitud que nombre uno se rechaza con un 400 y no se genera nada, con una excepción en una llamada síncrona de Comfy Router (`POST /v2/models/{provider}/{model}`) donde el almacenamiento de plataforma está habilitado: un valor que nombre el propio bucket de assets de Veo o Gemini de Router se reemplaza por un destino que Router crea bajo tu propio prefijo de plataforma para esa llamada (consulta la ruta Veo de Router), y solo ese destino exacto creado por Router se deja pasar. Un envío en cola de Router (`POST /v2/models/{provider}/{model}/requests`) no hace ese reemplazo, así que rechaza ese valor con un 400 como cualquier otro bucket propiedad de Comfy. Cualquier otro destino se reenvía a Vertex sin cambios y queda de tu parte conceder el acceso. Una llamada bring-your-own-key se ejecuta en tu propio proyecto y se reenvía tal como se envía. +DEBE NOMBRAR UN BUCKET PROPIO. Fuera de bring-your-own-key, esta ruta se ejecuta con las credenciales de Google Cloud de Comfy en lugar de las tuyas, así que un destino dentro de un bucket propiedad de Comfy sería una escritura realizada por la cuenta de servicio de Comfy, en una estructura compartida, facturada al proyecto de Comfy. Una solicitud que nombre uno se rechaza con un 400 y no se genera nada, con una excepción en una llamada síncrona de Comfy Router (`POST /v2/models/{provider}/{model}`) donde el almacenamiento de plataforma está habilitado: un valor que nombre el propio bucket de assets de Veo o Gemini de Router se reemplaza por un destino que Router crea bajo tu propio prefijo de plataforma para esa llamada (consulta la ruta Veo de Router), y solo ese destino exacto creado por Router se deja pasar. Un envío en cola de Router (`POST /v2/models/{provider}/{model}/requests`) no hace ese reemplazo, así que rechaza ese valor con un 400 como cualquier otro bucket propiedad de Comfy. Cualquier otro destino se reenvía a Vertex sin cambios y queda de tu parte conceder el acceso. Una llamada bring-your-own-key se ejecuta en tu propio proyecto y se reenvía tal como se envía. diff --git a/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx b/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx index 9c630a819e..6c4d7044ea 100644 --- a/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx +++ b/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx @@ -2,14 +2,15 @@ title: "Usa Veo 3.1 Lite Generate 001 con Comfy Router" description: "Llama a veo/veo-3.1-lite-generate-001 desde Comfy Router: endpoint, forma de la solicitud y respuesta." sidebarTitle: "Veo 3.1 Lite Generate 001" -translationSourceHash: 6526c1c6 +translationSourceHash: 8ad7346c translationFrom: development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx translationBlockHashes: "_intro": 8110da35 "Quick start": 7f826038 - "Schema": 647d02c5 + "Schema": 25c8331a "Examples": 88e27039 --- + {/* GENERATED FILE. Generated from router-schemas/veo/veo-3.1-lite-generate-001.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; @@ -333,8 +334,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ Duración objetivo del video generado en segundos. Veo 2: 5-8. Veo 3/3.1: 4, 6 u 8. Predeterminado: 8 - -Mejora el prompt automáticamente para obtener mayor calidad. El valor predeterminado es verdadero. +Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. @@ -350,9 +350,10 @@ Mejora el prompt automáticamente para obtener mayor calidad. El valor predeterm - Controla a las personas en los videos generados. Predeterminado: allow_adult + Controla a las personas en los videos generados. Predeterminado: allow_adult. +`ALLOW` y `BLOCK` también se aceptan, por la misma razón de compatibilidad por la que el enum personGeneration de Veo2GenVidRequest los incluye (consulta la nota en ese componente): el nodo socio de Veo 3 de ComfyUI (comfy_api_nodes/nodes_veo2.py) siempre envía una de estas dos formas, nunca la propia de Vertex, a `/proxy/veo/{model}/generate` para veo-3.1-generate-001, veo-3.1-fast-generate-001 y veo-3.1-lite-generate-001, que son los tres ids para los que este componente es el esquema de entrada de Router. En un despacho de Router (`model_provider=veo`) para uno de esos ids, ya sea síncrono o en cola (`/v2/models/veo/{model}/requests`), `ALLOW` se asigna a `allow_adult` y `BLOCK` a `dont_allow` antes de que la solicitud llegue a Vertex (routerVeoMapPersonGeneration, server/middleware/router_veo_person_generation.go), porque Vertex mismo no acepta ninguna de las dos formas. Quien llame directamente a v1 `/proxy/veo/:modelId/generate` no se ve afectado en ningún caso: comfy-api no instala ningún validador de solicitudes en `/proxy/*`, así que este enum ya era documentación sin validación allí, y la asignación que solo hace Router no se ejecuta para esa llamada. - Valores posibles: `dont_allow`, `allow_adult`, `allowAll` + Valores posibles: `dont_allow`, `allow_adult`, `allowAll`, `ALLOW`, `BLOCK` @@ -431,7 +432,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veo/veo-3.1-li - Motivos por los que se filtraron los videos por las políticas de IA responsable + Motivos por los que las políticas de IA responsable filtraron los videos diff --git a/es/development/comfy-router/pricing.mdx b/es/development/comfy-router/pricing.mdx index 13dbf79541..ec59d613ac 100644 --- a/es/development/comfy-router/pricing.mdx +++ b/es/development/comfy-router/pricing.mdx @@ -148,10 +148,10 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | Nombre | ID del modelo | Opción | Créditos | | --- | --- | --- | ---: | -| [Arrow 2](/es/development/comfy-router/models) | `quiver/arrow-2` | Entrada | 1206.92 / 1M de tokens | -| [Arrow 2](/es/development/comfy-router/models) | `quiver/arrow-2` | Salida | 6034.6 / 1M de tokens | -| [Arrow 2 Telos](/es/development/comfy-router/models) | `quiver/arrow-2-telos` | Entrada | 1810.38 / 1M de tokens | -| [Arrow 2 Telos](/es/development/comfy-router/models) | `quiver/arrow-2-telos` | Salida | 9051.9 / 1M de tokens | +| [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Entrada | 1206.92 / 1M de tokens | +| [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Salida | 6034.6 / 1M de tokens | +| [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Entrada | 1810.38 / 1M de tokens | +| [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Salida | 9051.9 / 1M de tokens | #### No publicado @@ -324,8 +324,8 @@ import { PricingCurrencyToggle } from "../../../snippets/router-pricing-currency | --- | --- | ---: | ---: | | [Gemini 2.5 Flash Image](/es/development/comfy-router/models/google/gemini-2-5-flash-image/code) | `vertexai/gemini-2.5-flash-image` | Imagen / Texto: 63.3 | Texto / Razonamiento: 527.5
Imagen: 6330 | | [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | `vertexai/gemini-nano-banana-2.1` | Imagen / Texto: 316.5 | Texto / Razonamiento: 1582.5
Imagen: 6330 | -| [GPT Image 2.6 Flare](/es/development/comfy-router/models) | `openai/gpt-image-2.6-flare` | Texto: 1508.65
Imagen: 2413.84 | Texto: 0
Imagen: 9051.9 | -| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models) | `openai/gpt-image-2.6-sunburst` | Texto: 1508.65
Imagen: 2413.84 | Texto: 0
Imagen: 9051.9 | +| [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | `openai/gpt-image-2.6-flare` | Texto: 1508.65
Imagen: 2413.84 | Texto: 0
Imagen: 9051.9 | +| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | `openai/gpt-image-2.6-sunburst` | Texto: 1508.65
Imagen: 2413.84 | Texto: 0
Imagen: 9051.9 | | [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | Texto: 1508.65
Imagen: 2413.84 | Texto: 0
Imagen: 9051.9 | | [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | Texto: 1508.65
Imagen: 2413.84 | Texto: 0
Imagen: 9051.9 | | [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | Texto: 1266
Imagen: 2025.6 | Imagen: 7596 | @@ -445,17 +445,17 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | --- | --- | --- | ---: | | [Aleph 2](/es/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | 84.4844 / s | | [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | 15.0865 / s | -| [LTX Video Alpha Gen](/es/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1080p | 30.173 / s | -| [LTX Video Alpha Gen](/es/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1440p | 75.4325 / s | -| [LTX Video Alpha Gen](/es/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 2160p | 301.73 / s | -| [LTX Video To Video Hdr](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1080p | 120.692 / s | -| [LTX Video To Video Hdr](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1440p | 241.384 / s | -| [LTX Video To Video Hdr](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 2160p | 482.768 / s | -| [LTX Video To Video Reframe](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 720p | 30.173 / s | -| [LTX Video To Video Reframe](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 1080p | 60.346 / s | -| [LTX Video Upscale](/es/development/comfy-router/models) | `ltx/ltx-video-upscale` | 1080p | 24.1384 / s | -| [LTX Video Upscale](/es/development/comfy-router/models) | `ltx/ltx-video-upscale` | 4K | 90.519 / s | -| [LTX Video Upscale](/es/development/comfy-router/models) | `ltx/ltx-video-upscale` | 8K | 362.076 / s | +| [LTX Video Alpha Gen](/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1080p | 30.173 / s | +| [LTX Video Alpha Gen](/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1440p | 75.4325 / s | +| [LTX Video Alpha Gen](/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 2160p | 301.73 / s | +| [LTX Video To Video Hdr](/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1080p | 120.692 / s | +| [LTX Video To Video Hdr](/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1440p | 241.384 / s | +| [LTX Video To Video Hdr](/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 2160p | 482.768 / s | +| [LTX Video To Video Reframe](/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 720p | 30.173 / s | +| [LTX Video To Video Reframe](/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 1080p | 60.346 / s | +| [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 1080p | 24.1384 / s | +| [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 4K | 90.519 / s | +| [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 8K | 362.076 / s | | [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | 3.0173 / s | | [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | 6.0346 / s | | [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | 10.56055 / s | @@ -523,9 +523,9 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | Nombre | ID del modelo | Créditos | | --- | --- | ---: | -| [V3.5](/es/development/comfy-router/models) | `pixverse/v3.5` | 3.0173 / crédito de PixVerse | -| [V6](/es/development/comfy-router/models) | `pixverse/v6` | 1.025882 / crédito de PixVerse | -| [V6 Max](/es/development/comfy-router/models) | `pixverse/v6-max` | 1.34102316 / crédito de PixVerse | +| [V3.5](/es/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | 3.0173 / crédito de PixVerse | +| [V6](/es/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | 1.025882 / crédito de PixVerse | +| [V6 Max](/es/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | 1.34102316 / crédito de PixVerse | #### Tarifas por solicitud @@ -680,9 +680,9 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [Claude Sonnet 5](/es/development/comfy-router/models/anthropic/claude-sonnet-5/code) | `anthropic/claude-sonnet-5` | Lectura: 60.346
Escritura (1 h): 1206.92
Escritura (5 min): 754.325 | Texto: 603.46 | Texto: 3017.3 | | [Claude Sonnet 4.6](/es/development/comfy-router/models/anthropic/claude-sonnet-4-6/code) | `anthropic/claude-sonnet-4-6` | Lectura: 63.3
Escritura (1 h): 1266
Escritura (5 min): 791.25 | Texto: 633 | Texto: 3165 | | [Claude Sonnet 4.5](/es/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code) | `anthropic/claude-sonnet-4-5-20250929` | Lectura: 63.3
Escritura (1 h): 1266
Escritura (5 min): 791.25 | Texto: 633 | Texto: 3165 | -| [Gemini 4 Argon](/es/development/comfy-router/models) | `vertexai/gemini-4-argon` | - | Audio / Imagen / Texto / Video: 1206.92 | Texto / Razonamiento: 6034.6 | -| [Gemini 4 Carbon](/es/development/comfy-router/models) | `vertexai/gemini-4-carbon` | - | Audio / Imagen / Texto / Video: 1206.92 | Texto / Razonamiento: 6034.6 | -| [Gemini 4 Hydrogen](/es/development/comfy-router/models) | `vertexai/gemini-4-hydrogen` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2262.975 | +| [Gemini 4 Argon](/es/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | - | Audio / Imagen / Texto / Video: 1206.92 | Texto / Razonamiento: 6034.6 | +| [Gemini 4 Carbon](/es/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | - | Audio / Imagen / Texto / Video: 1206.92 | Texto / Razonamiento: 6034.6 | +| [Gemini 4 Hydrogen](/es/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2262.975 | | [Gemini 3.8 Flash](/es/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2262.975 | | [Gemini 3.7 Flash](/es/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | Audio / Imagen / Texto / Video: 452.595 | Texto / Razonamiento: 2262.975 | | [Gemini 3.1 Flash Lite](/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | Imagen / Texto / Video: 52.75
Audio: 105.5 | Texto / Razonamiento: 316.5 | @@ -937,10 +937,10 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | Nombre | ID del modelo | Opción | USD | | --- | --- | --- | ---: | -| [Arrow 2](/es/development/comfy-router/models) | `quiver/arrow-2` | Entrada | $5.72 / 1M de tokens | -| [Arrow 2](/es/development/comfy-router/models) | `quiver/arrow-2` | Salida | $28.60 / 1M de tokens | -| [Arrow 2 Telos](/es/development/comfy-router/models) | `quiver/arrow-2-telos` | Entrada | $8.58 / 1M de tokens | -| [Arrow 2 Telos](/es/development/comfy-router/models) | `quiver/arrow-2-telos` | Salida | $42.90 / 1M de tokens | +| [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Entrada | $5.72 / 1M de tokens | +| [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code) | `quiver/arrow-2` | Salida | $28.60 / 1M de tokens | +| [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Entrada | $8.58 / 1M de tokens | +| [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code) | `quiver/arrow-2-telos` | Salida | $42.90 / 1M de tokens | #### No publicado @@ -1113,8 +1113,8 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | --- | --- | ---: | ---: | | [Gemini 2.5 Flash Image](/es/development/comfy-router/models/google/gemini-2-5-flash-image/code) | `vertexai/gemini-2.5-flash-image` | Imagen / Texto: $0.30 | Texto / Razonamiento: $2.50
Imagen: $30.00 | | [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | `vertexai/gemini-nano-banana-2.1` | Imagen / Texto: $1.50 | Texto / Razonamiento: $7.50
Imagen: $30.00 | -| [GPT Image 2.6 Flare](/es/development/comfy-router/models) | `openai/gpt-image-2.6-flare` | Texto: $7.15
Imagen: $11.44 | Texto: $0.00
Imagen: $42.90 | -| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models) | `openai/gpt-image-2.6-sunburst` | Texto: $7.15
Imagen: $11.44 | Texto: $0.00
Imagen: $42.90 | +| [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | `openai/gpt-image-2.6-flare` | Texto: $7.15
Imagen: $11.44 | Texto: $0.00
Imagen: $42.90 | +| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | `openai/gpt-image-2.6-sunburst` | Texto: $7.15
Imagen: $11.44 | Texto: $0.00
Imagen: $42.90 | | [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | Texto: $7.15
Imagen: $11.44 | Texto: $0.00
Imagen: $42.90 | | [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | Texto: $7.15
Imagen: $11.44 | Texto: $0.00
Imagen: $42.90 | | [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | Texto: $6.00
Imagen: $9.60 | Imagen: $36.00 | @@ -1234,17 +1234,17 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | --- | --- | --- | ---: | | [Aleph 2](/es/development/comfy-router/models/runway/aleph2/code) | `runway/aleph2` | - | $0.4004 / s | | [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code) | `runway/gen4_turbo` | - | $0.0715 / s | -| [LTX Video Alpha Gen](/es/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1080p | $0.143 / s | -| [LTX Video Alpha Gen](/es/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 1440p | $0.3575 / s | -| [LTX Video Alpha Gen](/es/development/comfy-router/models) | `ltx/ltx-video-alpha-gen` | 2160p | $1.43 / s | -| [LTX Video To Video Hdr](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1080p | $0.572 / s | -| [LTX Video To Video Hdr](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 1440p | $1.144 / s | -| [LTX Video To Video Hdr](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-hdr` | 2160p | $2.288 / s | -| [LTX Video To Video Reframe](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 720p | $0.143 / s | -| [LTX Video To Video Reframe](/es/development/comfy-router/models) | `ltx/ltx-video-to-video-reframe` | 1080p | $0.286 / s | -| [LTX Video Upscale](/es/development/comfy-router/models) | `ltx/ltx-video-upscale` | 1080p | $0.1144 / s | -| [LTX Video Upscale](/es/development/comfy-router/models) | `ltx/ltx-video-upscale` | 4K | $0.429 / s | -| [LTX Video Upscale](/es/development/comfy-router/models) | `ltx/ltx-video-upscale` | 8K | $1.716 / s | +| [LTX Video Alpha Gen](/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1080p | $0.143 / s | +| [LTX Video Alpha Gen](/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 1440p | $0.3575 / s | +| [LTX Video Alpha Gen](/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code) | `ltx/ltx-video-alpha-gen` | 2160p | $1.43 / s | +| [LTX Video To Video Hdr](/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1080p | $0.572 / s | +| [LTX Video To Video Hdr](/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 1440p | $1.144 / s | +| [LTX Video To Video Hdr](/es/development/comfy-router/models/ltx/ltx-video-to-video-hdr/code) | `ltx/ltx-video-to-video-hdr` | 2160p | $2.288 / s | +| [LTX Video To Video Reframe](/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 720p | $0.143 / s | +| [LTX Video To Video Reframe](/es/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code) | `ltx/ltx-video-to-video-reframe` | 1080p | $0.286 / s | +| [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 1080p | $0.1144 / s | +| [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 4K | $0.429 / s | +| [LTX Video Upscale](/es/development/comfy-router/models/ltx/ltx-video-upscale/code) | `ltx/ltx-video-upscale` | 8K | $1.716 / s | | [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 480p | $0.0143 / s | | [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 768p | $0.0286 / s | | [Pika H3 Flex Image To Video](/es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code) | `pika/pika-h3-flex-image-to-video` | 1080p | $0.05005 / s | @@ -1312,9 +1312,9 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | Nombre | ID del modelo | USD | | --- | --- | ---: | -| [V3.5](/es/development/comfy-router/models) | `pixverse/v3.5` | $0.0143 / crédito de PixVerse | -| [V6](/es/development/comfy-router/models) | `pixverse/v6` | $0.004862 / crédito de PixVerse | -| [V6 Max](/es/development/comfy-router/models) | `pixverse/v6-max` | $0.00635556 / crédito de PixVerse | +| [V3.5](/es/development/comfy-router/models/pixverse/v3-5/code) | `pixverse/v3.5` | $0.0143 / crédito de PixVerse | +| [V6](/es/development/comfy-router/models/pixverse/v6/code) | `pixverse/v6` | $0.004862 / crédito de PixVerse | +| [V6 Max](/es/development/comfy-router/models/pixverse/v6-max/code) | `pixverse/v6-max` | $0.00635556 / crédito de PixVerse | #### Tarifas por solicitud @@ -1469,9 +1469,9 @@ Las imágenes se facturan por imagen de salida. Los videos se facturan por cada | [Claude Sonnet 5](/es/development/comfy-router/models/anthropic/claude-sonnet-5/code) | `anthropic/claude-sonnet-5` | Lectura: $0.286
Escritura (1 h): $5.72
Escritura (5 min): $3.575 | Texto: $2.86 | Texto: $14.30 | | [Claude Sonnet 4.6](/es/development/comfy-router/models/anthropic/claude-sonnet-4-6/code) | `anthropic/claude-sonnet-4-6` | Lectura: $0.30
Escritura (1 h): $6.00
Escritura (5 min): $3.75 | Texto: $3.00 | Texto: $15.00 | | [Claude Sonnet 4.5](/es/development/comfy-router/models/anthropic/claude-sonnet-4-5-20250929/code) | `anthropic/claude-sonnet-4-5-20250929` | Lectura: $0.30
Escritura (1 h): $6.00
Escritura (5 min): $3.75 | Texto: $3.00 | Texto: $15.00 | -| [Gemini 4 Argon](/es/development/comfy-router/models) | `vertexai/gemini-4-argon` | - | Audio / Imagen / Texto / Video: $5.72 | Texto / Razonamiento: $28.60 | -| [Gemini 4 Carbon](/es/development/comfy-router/models) | `vertexai/gemini-4-carbon` | - | Audio / Imagen / Texto / Video: $5.72 | Texto / Razonamiento: $28.60 | -| [Gemini 4 Hydrogen](/es/development/comfy-router/models) | `vertexai/gemini-4-hydrogen` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $10.725 | +| [Gemini 4 Argon](/es/development/comfy-router/models/google/gemini-4-argon/code) | `vertexai/gemini-4-argon` | - | Audio / Imagen / Texto / Video: $5.72 | Texto / Razonamiento: $28.60 | +| [Gemini 4 Carbon](/es/development/comfy-router/models/google/gemini-4-carbon/code) | `vertexai/gemini-4-carbon` | - | Audio / Imagen / Texto / Video: $5.72 | Texto / Razonamiento: $28.60 | +| [Gemini 4 Hydrogen](/es/development/comfy-router/models/google/gemini-4-hydrogen/code) | `vertexai/gemini-4-hydrogen` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $10.725 | | [Gemini 3.8 Flash](/es/development/comfy-router/models/google/gemini-3-8-flash/code) | `vertexai/gemini-3.8-flash` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $10.725 | | [Gemini 3.7 Flash](/es/development/comfy-router/models/google/gemini-3-7-flash/code) | `vertexai/gemini-3.7-flash` | - | Audio / Imagen / Texto / Video: $2.145 | Texto / Razonamiento: $10.725 | | [Gemini 3.1 Flash Lite](/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code) | `vertexai/gemini-3.1-flash-lite` | - | Imagen / Texto / Video: $0.25
Audio: $0.50 | Texto / Razonamiento: $1.50 | diff --git a/es/development/comfy-router/providers.mdx b/es/development/comfy-router/providers.mdx index cf708e4347..9857267094 100644 --- a/es/development/comfy-router/providers.mdx +++ b/es/development/comfy-router/providers.mdx @@ -1,8 +1,8 @@ --- title: "Proveedores de servicio de Comfy Router" sidebarTitle: "Proveedores de servicio" -description: "Consulta qué proveedores pueden servir cada modelo de Comfy Router y cómo seleccionar otro proveedor." -translationSourceHash: 2e5f5f1e +description: "Consulta qué proveedores pueden servir cada modelo de Comfy Router y cómo elegir un proveedor alternativo." +translationSourceHash: 770541e9 translationFrom: development/comfy-router/providers.mdx --- @@ -14,20 +14,23 @@ Todos los modelos usan `POST /v2/models/{provider}/{model}`. Comfy es el proveed ## Cobertura de proveedores -| Modelo / proveedor | **Comfy (predeterminado)** | **fal** | **Higgsfield** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | -| --- | --- | --- | --- | --- | --- | --- | --- | --- | -| [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | -| [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | -| [Gemini 2.5 Flash Image](/es/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | ✓ | - | - | - | - | -| [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | ✓ | - | - | - | - | -| [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | -| [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | - | ✓ | - | ✓ | -| [Kling 3.0 Turbo](/es/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | -| [Kling V3](/es/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | ✓* | - | -| [Nano Banana 2](/es/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [Nano Banana Pro](/es/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | ✓ | ✓ | ✓ | - | ✓ | -| [Wan 3.0 Video](/es/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | +| Modelo / proveedor | **Comfy (predeterminado)** | **fal** | **Higgsfield** | **Kelly** | **MiniMax** | **Pika** | **Runware** | **Tencent** | **WaveSpeed** | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | +| [Dreamina Seedance 2.0 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code) | ✓ | ✓ | ✓ | ✓ | - | ✓ | ✓ | - | ✓ | +| [Dreamina Seedance 2.0 Fast 260128](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code) | ✓ | - | - | ✓ | - | - | - | - | - | +| [Dreamina Seedance 2.5 260628](/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code) | ✓ | ✓ | ✓ | ✓ | - | - | ✓ | - | ✓ | +| [Gemini 2.5 Flash Image](/es/development/comfy-router/models/google/gemini-2-5-flash-image/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [Gemini Nano Banana 2.1](/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | - | ✓ | +| [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | ✓ | ✓ | - | - | ✓ | - | ✓ | - | ✓ | +| [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code) | ✓ | - | - | - | ✓ | - | - | - | - | +| [Kling 3.0 Turbo](/es/development/comfy-router/models/kling/kling-3-0-turbo/code) | ✓ | - | ✓ | - | - | - | - | - | - | +| [Kling V3](/es/development/comfy-router/models/kling/kling-v3/code) | ✓ | - | ✓ | - | - | - | - | ✓* | - | +| [Nano Banana 2](/es/development/comfy-router/models/google/nano-banana-2/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [Nano Banana Pro](/es/development/comfy-router/models/google/nano-banana-pro/code) | ✓ | ✓ | - | - | ✓ | ✓ | ✓ | - | ✓ | +| [Wan 3.0 Video](/es/development/comfy-router/models/wan/wan3-0-video/code) | ✓ | - | ✓ | - | - | - | - | - | - | \* Este proveedor sirve el modelo con límites más restringidos que el predeterminado; consulta la página del modelo. diff --git a/es/development/comfy-router/quickstart.mdx b/es/development/comfy-router/quickstart.mdx index 5ed155a80a..b578b8564a 100644 --- a/es/development/comfy-router/quickstart.mdx +++ b/es/development/comfy-router/quickstart.mdx @@ -2,14 +2,15 @@ title: "Inicio rápido de Comfy Router" sidebarTitle: "Inicio rápido" description: "Genera imágenes y videos con los últimos modelos de IA en minutos." -translationSourceHash: ea087f5c +translationSourceHash: ea722f9a translationFrom: development/comfy-router/quickstart.mdx translationBlockHashes: "_intro": 201b5b50 - "Image-to-video and reference-to-video": 8ac90191 + "Image-to-video and reference-to-video": e7a93779 "Next steps": ed466781 --- +
Comfy Router te ofrece una sola API para modelos alojados de imagen y video en `https://api.comfy.org`. Crea una clave API en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y luego llama a cualquier modelo con los [SDK oficiales de Python y TypeScript](/es/development/api-development/sdks) o por HTTP simple. La facturación es de pago por uso: de forma predeterminada, cada solicitud toma créditos del saldo de tu espacio de trabajo, sin suscripción. Consulta los [precios de Router](/es/development/comfy-router/pricing) para ver las tarifas y otras opciones de facturación. @@ -146,7 +147,7 @@ La misma solicitud de Seedance acepta entradas de imagen, video y audio. Agrega | Primer y último fotograma | lo anterior más un segundo elemento `image_url` con `role: last_frame` | | Referencia a video | un elemento `text` más elementos `image_url` con `role: reference_image` y, en Seedance 2.0 y 2.5, elementos `video_url` con `role: reference_video` y elementos `audio_url` con `role: reference_audio` | -La `url` de una imagen puede ser una URL pública o una cadena `data:image/;base64,`. Envía, consulta el estado y recoge el resultado exactamente como en la guía de inicio anterior. Solo cambia el cuerpo. +La `url` de una imagen puede ser una URL pública o una cadena `data:image/;base64,`. Envía, consulta el estado y recoge el resultado exactamente como en la guía de inicio rápido anterior. Solo cambia el cuerpo. ```bash Image-to-video curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests \ @@ -174,6 +175,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"}, {"type": "image_url", "image_url": {"url": "https://example.com/outfit.png"}, "role": "reference_image"} ], + "omni_reference_task_type": "reference", "duration": 5, "ratio": "16:9", "resolution": "720p" @@ -182,6 +184,28 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque En Seedance 2.5, las solicitudes de primer fotograma y de primer y último fotograma toman la relación de aspecto de salida del primer fotograma. Omite `ratio` o envía `adaptive`, porque una relación concreta se rechaza con un `400`. El esquema de la solicitud es compartido por toda la familia Seedance y puede listar roles que un modelo ignora, así que revisa el campo `x-comfy-router-input-modalities` en el [esquema de entrada](/es/development/comfy-router/models) de cada modelo para conocer los tipos de entrada que ese modelo acepta. Por ejemplo, `reference_video` y `reference_audio` necesitan un modelo que liste `video` o `audio` ahí. +### Editar o extender un video de referencia + +En Seedance 2.5, `omni_reference_task_type` le indica al modelo qué hacer con el material de referencia: `reference` crea un video nuevo guiado por él, `edit` cambia un clip de `reference_video` y `extend` continúa un clip. Sin el campo, el modelo elige la tarea a partir del prompt, y una edición conserva la longitud y la relación de aspecto del propio clip e ignora `duration` y `ratio`. En la ruta nativa de BytePlus, un valor explícito que no se ajusta a la solicitud se rechaza antes de que empiece la generación, por lo que no se cobra. Una ruta de proveedor alternativa, usada como respaldo o elegida con `model_provider`, no tiene campo de tipo de tarea: descarta el valor y deja que ese proveedor infiera la tarea como si el campo se hubiera omitido. El descarte se indica en `X-Comfy-Router-Dropped-Params`, en la respuesta de una ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene respaldo, así que solo llega a una ruta alternativa mediante `model_provider`. + +```bash Edit a reference video +curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/requests \ + -H "X-API-Key: $COMFY_API_KEY" \ + -H "Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d '{ + "content": [ + {"type": "text", "text": "Make the fox bright red"}, + {"type": "video_url", "video_url": {"url": "https://example.com/fox.mp4"}, "role": "reference_video"} + ], + "omni_reference_task_type": "edit", + "duration": -1, + "resolution": "720p" + }' +``` + +Una edición conserva la longitud del clip de origen, así que envía `"duration": -1` y omite `ratio`. Una solicitud de `extend` devuelve solo el segmento recién generado, con la `duration` que envíes. + ## Siguientes pasos diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index fceae0ef56..f1ea6107f5 100644 --- a/es/development/comfy-router/reference.mdx +++ b/es/development/comfy-router/reference.mdx @@ -2,11 +2,11 @@ title: "Referencia de la API de Comfy Router" sidebarTitle: "Referencia de la API" description: "Todos los endpoints, parámetros, respuestas y errores de Comfy Router, según el contrato de la API de Comfy." -translationSourceHash: e8d9375f +translationSourceHash: 64fd0a10 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": e6679d4b + "Endpoints": 5e27b6a1 "Error buckets": 02a09cb4 "Response headers": 3ac389bd "Pre-flight cost estimates": 7405db0d @@ -16,6 +16,7 @@ translationBlockHashes: --- + {/* ARCHIVO GENERADO -- NO EDITAR A MANO. @@ -38,9 +39,9 @@ Las claves de API de Comfy también se pueden enviar como tokens Bearer. `X-API- ### `GET /v2/models` -**Listar los modelos que Comfy Router puede ejecutar.** +**Enumera los modelos que Comfy Router puede ejecutar.** -Enumera los IDs de modelo disponibles y los datos de facturación. Usa `next_cursor` mientras `has_more` sea verdadero. +Consulta los IDs de modelo disponibles y los datos de facturación. Usa `next_cursor` mientras `has_more` sea `true`. **Parámetros** @@ -51,7 +52,7 @@ Enumera los IDs de modelo disponibles y los datos de facturación. Usa `next_cur - Cantidad de modelos que se devuelven en una página. + Cantidad de modelos a devolver en una página. Hasta 100, Predeterminado: 20 @@ -87,19 +88,19 @@ Enumera los IDs de modelo disponibles y los datos de facturación. Usa `next_cur - La solicitud no está permitida para este cliente ni para este modelo. + La solicitud no está permitida para este cliente o modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `rate_limited`: se agotó la cuota de solicitudes por cliente. Espera el tiempo indicado en `Retry-After` antes de enviar la siguiente solicitud. + `rate_limited`: se agotó la cuota de solicitudes por cliente. Espera `Retry-After` antes de enviar la siguiente solicitud. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - El router no está disponible temporalmente. Reintenta aplicando backoff. + Router no está disponible temporalmente. Reintenta con retroceso exponencial. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -115,17 +116,17 @@ Consulta los detalles de un modelo sin listar el catálogo completo. Parte del proveedor en el ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres Parte del modelo en el ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - El `ETag` que el solicitante obtuvo de un `200` anterior. + El `ETag` que el cliente conserva de una respuesta `200` anterior. **Respuestas** @@ -137,7 +138,7 @@ Consulta los detalles de un modelo sin listar el catálogo completo. - Not Modified: la entrada no ha cambiado desde el `ETag` que el solicitante envió en `If-None-Match`. + No modificado: la entrada no ha cambiado desde el `ETag` que el cliente envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -149,7 +150,7 @@ Consulta los detalles de un modelo sin listar el catálogo completo. - La solicitud no está permitida para este solicitante o modelo. + La solicitud no está permitida para este cliente o modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -161,45 +162,45 @@ Consulta los detalles de un modelo sin listar el catálogo completo. - `rate_limited`: se agotó la cuota de solicitudes por solicitante. Espera el valor de `Retry-After` antes de enviar la siguiente solicitud. + `rate_limited`: se agotó la cuota de solicitudes por cliente. Espera el `Retry-After` antes de enviar la siguiente solicitud. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - El Router no está disponible temporalmente. Reintenta con retroceso exponencial. + El router no está disponible temporalmente. Reintenta con retroceso exponencial. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}` -**Ejecuta un modelo socio de forma síncrona por su ID de modelo canónico.** +**Ejecuta un modelo socio de forma síncrona mediante su ID de modelo canónico.** Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. **Parámetros** - Porción del proveedor en el ID de modelo canónico `{provider}/{model}`. + Porción de proveedor del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, por ejemplo `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres - Porción del modelo en el ID de modelo canónico `{provider}/{model}`. + Porción de modelo del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, por ejemplo `claude-opus-4-6`, hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres Clave generada por quien llama que hace seguro reintentar una misma llamada lógica. - De 1 a 255 caracteres + 1–255 caracteres - Selecciona un proveedor alternativo para servir este modelo en lugar de su valor predeterminado actual; `fal`, `wavespeed`, `runware` y `higgsfield` son los alternativos, y `GET /v2/models/{provider}/{model}` informa cuáles de ellos admite un modelo determinado. Sus rechazos se comprueban en un orden fijo, y los anteriores responden tanto si los posteriores lo harían como si no: un valor no reconocido (que no es un proveedor registrado en absoluto) se rechaza con `400`; después, un proveedor alternativo en una solicitud cuyo cuerpo selecciona una operación multipart (una edición) se rechaza con `409` y un `detail` que comienza con "this request's `image` selects the edit operation", pero solo cuando el traductor de ese proveedor para este modelo no puede servir la operación; una rama cuyo traductor sí incluye los medios continúa con normalidad; luego, cualquier proveedor alternativo en una solicitud que resolvió una credencial BYOK (trae tu propia clave) se rechaza con `409` y un `detail` que comienza con `this request resolved a BYOK credential` (consulta esa respuesta), independientemente de si ese proveedor sirve este modelo; luego, la compuerta propia del proveedor nombrado, que rechaza con `403` y `error_type: not_enabled` cuando ese proveedor no está habilitado para ti, y con `503` y `error_type: service_unavailable` cuando la compuerta no se puede evaluar; y solo después de las cuatro se rechaza con `400` y `error_type: invalid_input` un proveedor real sin rama para este modelo, la misma respuesta que un valor no reconocido. `fallback_provider` queda inerte en lugar de rechazarse en una solicitud BYOK, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`. + Selecciona un proveedor alternativo para servir este modelo, en lugar de su valor predeterminado actual; `fal`, `wavespeed`, `runware` y `higgsfield` son los alternativos, y `GET /v2/models/{provider}/{model}` informa cuáles de ellos admite un modelo dado. Sus rechazos se comprueban en un orden fijo, y los anteriores responden tanto si los posteriores lo harían como si no: un valor no reconocido, que no es un proveedor registrado en absoluto, se rechaza con `400`; luego, un proveedor alternativo en una solicitud cuyo cuerpo selecciona una operación multipart (una edición) se rechaza con `409` con un `detail` que comienza con "this request's `image` selects the edit operation", pero solo cuando el traductor de ese proveedor para este modelo no puede servir la operación; una rama cuyo traductor sí admite los medios continúa con normalidad; luego, cualquier proveedor alternativo en una solicitud que resolvió una credencial de bring-your-own-key se rechaza con `409` con un `detail` que comienza con `this request resolved a BYOK credential` (ver esa respuesta), independientemente de si ese proveedor sirve este modelo; luego, la compuerta propia del proveedor nombrado, que rechaza con `403` con `error_type: not_enabled` cuando ese proveedor no está activado para ti y con `503` con `error_type: service_unavailable` cuando la compuerta no se puede evaluar; y solo tras las cuatro se rechaza con `400` con `error_type: invalid_input` un proveedor real sin rama para este modelo, la misma respuesta que la de un valor no reconocido. `fallback_provider` queda inerte en lugar de rechazarse en una solicitud de bring-your-own-key, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`. @@ -209,11 +210,11 @@ Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. - Controla si Router reintenta esta llamada con el otro proveedor registrado del modelo cuando el primer intento falla por una razón atribuible a Router o al proveedor probado. Si se omite, o con cualquier valor distinto de `false`, el fallback queda activado; `false` lo desactiva. Una respuesta de fallback correcta incluye `X-Comfy-Router-Fallback-Provider`. En una solicitud que resolvió una credencial BYOK el fallback no está disponible diga lo que diga este parámetro: simplemente no se hace el intento y el primer fallo te llega sin cambios, lo cual es inerte, no un rechazo: aquí no se origina ningún `409`. Lo mismo ocurre, por la misma razón, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`: cada una vincula la llamada a un único proveedor que no se puede reproducir fielmente contra otro, así que el fallback simplemente se omite en lugar de rechazarse. Solo un `model_provider` explícito se rechaza con ese `409`, y a diferencia de esta omisión incondicional, su `409` de multipart se aplica únicamente a una rama cuyo traductor no puede servir la operación. + Controla si Router reintenta esta llamada contra el otro proveedor registrado del modelo cuando el primer intento falla por una razón atribuible a Router o al proveedor intentado. Omitido, o con cualquier valor distinto de `false`, el fallback queda activado; `false` lo desactiva. Una respuesta de fallback exitosa lleva `X-Comfy-Router-Fallback-Provider`. En una solicitud que resolvió una credencial de bring-your-own-key, el fallback no está disponible diga lo que diga este parámetro: el intento simplemente no se realiza y el primer fallo te llega sin cambios, lo cual es inerte, no un rechazo: ningún `409` se origina aquí. Lo mismo ocurre, por la misma razón, en una solicitud cuyo cuerpo selecciona una operación multipart y con `strict_mode=true`: cada uno vincula la llamada a un proveedor que no se puede reproducir fielmente contra otro, así que el fallback simplemente se omite en lugar de rechazarse. Solo un `model_provider` explícito se rechaza con ese `409`, y a diferencia de esta omisión incondicional, su `409` de multipart se aplica solo a una rama cuyo traductor no puede servir la operación. - Opta por rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declara, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada para un modelo cuyo esquema permite campos no declarados o que no tiene esquema redactado, ni en un envío en cola enviado con `strict_mode=true`. + Opta por rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declara, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada para un modelo cuyo esquema permite campos no declarados o que no tiene un esquema escrito, ni en un envío en cola enviado con `strict_mode=true`. Predeterminado: False @@ -222,14 +223,14 @@ Ejecuta un modelo y recibe su resultado finalizado en la misma respuesta. `application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) -La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejecuta el despacho nativo en el proveedor predeterminado del modelo y este cuerpo es el esquema nativo propio del modelo, reenviado sin cambios (`strict_mode` no tiene sentido ahí y no cambia nada). Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=false` (el valor predeterminado), el cuerpo se traduce al esquema real de ese proveedor antes de enviarse: cualquier campo nativo que no se pueda expresar exactamente se descarta y se divulga mediante el encabezado `X-Comfy-Router-Dropped-Params` de la respuesta, nunca de forma silenciosa. Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=true` no se ejecuta ninguna traducción: el cuerpo ya debe ser el esquema real propio de ese proveedor alternativo, no el nativo de este modelo (consulta `strict_mode`), y se reenvía sin cambios. Los campos del propio cuerpo también seleccionan qué operación ejecuta Router en un modelo que admite más de una: en un modelo de imagen editable, incluir una imagen de entrada lo cambia de texto a imagen a la operación imagen a imagen (edición), que puede facturarse con su propia tarifa; en un modelo de video Seedance, `content[].role` selecciona la operación (una imagen de primer fotograma selecciona imagen a video, una imagen o un clip de referencia selecciona referencia a video). En el despacho nativo, la facturación de Seedance sigue los tipos de medios en `content`, no los roles: una solicitud con cualquier entrada de video se factura como video a video; si no, una con cualquier imagen se factura como imagen a video; si no, como texto a video, salvo que un render final a partir de un elemento `draft_task` se factura como la operación del Draft que renderiza; algunos modelos cobran la misma tarifa por texto a video y por imagen a video. Con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. +La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejecuta el despacho nativo en el proveedor predeterminado del modelo y este cuerpo es el esquema nativo propio del modelo, reenviado sin cambios (`strict_mode` no tiene sentido ahí y no cambia nada). Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=false` (el valor predeterminado), el cuerpo se traduce al esquema real de ese proveedor antes de enviarse: cualquier campo nativo que no se pueda expresar exactamente se descarta y se divulga mediante el encabezado `X-Comfy-Router-Dropped-Params` de la respuesta, nunca en silencio. Con `model_provider` seleccionando un proveedor alternativo y `strict_mode=true` no se ejecuta ninguna traducción: el cuerpo ya debe ser el esquema real propio de ese proveedor alternativo, no el nativo de este modelo (ver `strict_mode`), y se reenvía sin cambios. Los campos del propio cuerpo también seleccionan qué operación ejecuta Router en un modelo que admite más de una: en un modelo de imagen editable, incluir una imagen de entrada lo cambia de la operación texto a imagen a la operación imagen a imagen (edición), que puede facturarse a su propia tarifa; en un modelo de video Seedance, `content[].role` selecciona la operación (una imagen de primer fotograma selecciona imagen a video, una imagen o un clip de referencia selecciona referencia a video). En el despacho nativo, la facturación de Seedance sigue los tipos de medios en `content`, no los roles: una solicitud con cualquier entrada de video se factura como video a video; de lo contrario, una con cualquier imagen se factura como imagen a video; de lo contrario, texto a video; salvo que un render final a partir de un elemento `draft_task` se factura como la operación del Draft que renderiza; algunos modelos cobran la misma tarifa por texto a video e imagen a video. Con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse a la tarifa propia de ese proveedor. **Respuestas** - OK: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, que se convierte de vuelta al contrato nativo de este modelo cuando es posible, y recurre a la respuesta en bruto del proveedor alternativo si la conversión falla, algo que se registra en el log y nunca ocurre en silencio), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. En un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes con el `Content-Type` propio del socio en lugar de `application/json`; decide según el `Content-Type` de la respuesta y no asumas que se trata de un documento JSON. + OK: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, traducido de vuelta al contrato nativo de este modelo cuando es posible, y recurriendo a la respuesta sin procesar del proveedor alternativo si la traducción falla, lo cual se registra en el log y nunca ocurre de forma silenciosa), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde a una generación directamente como bytes, el cuerpo son esos bytes con el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no asumas que es un documento JSON. - Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes en bruto (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` + Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining` @@ -251,7 +252,7 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - La solicitud no está permitida para este solicitante ni para este modelo. + La solicitud no está permitida para este solicitante o este modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -263,9 +264,9 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en curso, así que espera el `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: un `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, y cuyo `detail` empieza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial de tipo bring-your-own-key para el proveedor de la ruta, cuyo `detail` empieza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. + Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya ha resuelto una credencial bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `concurrency_limit_exceeded`) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando `concurrency_limit_exceeded`) @@ -275,53 +276,53 @@ La entrada JSON nativa del modelo socio. Sin `model_provider`, la solicitud ejec - El contenido de la solicitud se rechazó contra el esquema del modelo. + El contenido de la solicitud fue rechazado según el esquema del modelo. Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - Revisa `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que debes reducir las llamadas en curso; `rate_limited` significa que debes esperar el `Retry-After`. + Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa reducir las llamadas en curso; `rate_limited` significa esperar `Retry-After`. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining`, `Retry-After` (cuando es `rate_limited`) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining`, `Retry-After` (cuando `rate_limited`) - La propia respuesta del proveedor no se pudo convertir en un resultado (`provider_error`). + La respuesta propia del proveedor no se pudo convertir en un resultado (`provider_error`). Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status` - El Router no está disponible temporalmente. Reintenta aplicando backoff. + Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo en rechazos por capacidad) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) - La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. + La solicitud superó una fecha límite. Revisa el tipo de error antes de reintentar. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After` ### `POST /v2/models/{provider}/{model}/estimate` -**Calcula el precio de una llamada a un modelo antes de ejecutarla, sin ejecutarla.** +**Cotiza una llamada a un modelo antes de ejecutarla, sin ejecutarla.** -Devuelve una estimación previa, en dólares estadounidenses, de lo que costará ejecutar este cuerpo en este modelo, con el precio de lista estándar de Comfy (un modelo que se factura según el costo que reporta su proveedor se estima a partir de la lista de precios publicada por ese proveedor). No refleja tarifas por contrato ni específicas del cliente: a un espacio de trabajo con precios negociados se le cotiza el precio de lista y se le cobra su tarifa contractual, y `source: exact` entonces significa exacto según el precio de lista, no el cargo de ese espacio de trabajo. Es una estimación, no el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es lo que pagas. El cuerpo se valida primero contra el esquema de entrada del modelo, tal como lo valida una ejecución predeterminada (sin `strict_mode`, sin `reject_unknown_fields`), así que un cuerpo que no cumple el esquema del modelo devuelve aquí el mismo `422` que en la ejecución; no se envía nada a un proveedor y no se cobra nada. La respuesta no es una fijación de precio: se calcula con las tarifas vigentes en `pricing_as_of`, y una ejecución se cobra con las tarifas vigentes cuando se tarifica. Si las estimaciones están desactivadas para una implementación, la ruta responde `403` con `error_type: not_enabled`; un modelo que Router aún no puede ejecutar responde el mismo `403` con el `detail` de la propia ruta de ejecución, así que lee `detail` para distinguir ambos casos. El cuerpo se tarifica tal como Router lo enviaría: traducido para el tramo `model_provider` que nombra y reorientado a la operación con la que se ejecuta, en el mismo orden que el `estimate` del `201` del envío en cola. Sin embargo, ese `estimate` no es un precio previo: llega solo después de que la ejecución se admite y se pone en cola, y esa ejecución se cobra a menos que se cancele antes del envío. +Devuelve una estimación previa, en dólares estadounidenses, de lo que costará ejecutar este cuerpo en este modelo, con el precio de lista estándar de Comfy (un modelo que se factura al costo que reporta su proveedor se estima a partir de la lista de precios publicada por el proveedor). No refleja tarifas contractuales ni específicas del cliente: a un espacio de trabajo con precios negociados se le cotiza el precio de lista y se le cobra su tarifa contractual, así que `source: exact` significa exacto al precio de lista, no el cargo de ese espacio de trabajo. Es una estimación, no el cargo final: el cargo liquidado en los registros de uso y facturación de tu espacio de trabajo es lo que pagas. El cuerpo se valida primero contra el esquema de entrada del modelo, tal como lo valida una ejecución predeterminada (sin `strict_mode`, sin `reject_unknown_fields`), así que un cuerpo que no cumple el esquema del modelo produce el mismo `422` aquí que en la ejecución; no se despacha nada a un proveedor y no se cobra nada. La respuesta no es un bloqueo de precio: se calcula con las tarifas vigentes en `pricing_as_of`, y una ejecución se cobra con las tarifas vigentes cuando se tarifica. Si las estimaciones están desactivadas para un despliegue, la ruta responde `403` con `error_type: not_enabled`; un modelo que Router aún no puede ejecutar responde el mismo `403` con el `detail` propio de la ruta de ejecución, así que lee `detail` para distinguir ambos casos. El cuerpo se tarifica tal como Router lo despacharía: traducido para el tramo `model_provider` que indica y redirigido a la operación en la que se ejecuta, en el mismo orden que el `estimate` del `201` del envío en cola. Sin embargo, ese `estimate` no es un precio previo: llega solo después de que la ejecución se admite y se pone en cola, y esa ejecución se cobra a menos que se cancele antes del despacho. **Parámetros** - Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se ejecuta. + Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment): slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment): slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres @@ -330,106 +331,106 @@ Devuelve una estimación previa, en dólares estadounidenses, de lo que costará **Cuerpo de la solicitud** -`application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) +`application/json`: [`RouterModelInput`](#routermodelinput) (requerido) -La entrada JSON nativa del modelo del socio, idéntica al cuerpo que acepta la ruta síncrona para este modelo. Se valida contra el esquema de entrada propio del modelo tal como lo valida una ejecución predeterminada (esta ruta no acepta `strict_mode` ni `reject_unknown_fields`), y sus propios campos (la cantidad de salidas, la operación que selecciona una imagen de entrada) deciden qué se tarifica. +La entrada JSON nativa del modelo del socio, idéntica al cuerpo que la ruta sincrónica acepta para este modelo. Se valida contra el esquema de entrada del propio modelo tal como lo hace una ejecución predeterminada (esta ruta no acepta `strict_mode` ni `reject_unknown_fields`), y sus propios campos (la cantidad de salidas, la operación que selecciona una imagen de entrada) determinan qué se tarifica. **Respuestas** La cotización. - Body: [`RouterCostEstimate`](#routercostestimate) -- Headers: `X-Comfy-Request-Id` + Cuerpo: [`RouterCostEstimate`](#routercostestimate). Encabezados: `X-Comfy-Request-Id` Solicitud no válida. Revisa el tipo de error y el cuerpo de la solicitud. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Credenciales faltantes o no válidas. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud no está permitida para este solicitante o modelo. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` No se encontró el ID de modelo. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` El cuerpo de la solicitud es demasiado grande. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - El cuerpo de la estimación fue rechazado por el esquema del modelo, o nombraba un modelo distinto del indicado en la ruta. + El cuerpo de la estimación se rechazó contra el esquema del modelo, o nombraba un modelo distinto del de la ruta. - Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `rate_limited`: se agotó la cuota de solicitudes por solicitante. Espera `Retry-After` antes de enviar la siguiente solicitud. + `rate_limited`: se agotó la cuota de solicitudes por solicitante. Espera a `Retry-After` antes de enviar la siguiente solicitud. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo en rechazos por capacidad) La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse). Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/openapi.json` -**Lee los esquemas de entrada y salida de un modelo socio como documento OpenAPI.** +**Lee los esquemas de entrada y salida de un modelo socio como un documento OpenAPI.** -Lee los esquemas de entrada y salida de un modelo como documento OpenAPI independiente. +Lee los esquemas de entrada y salida de un modelo como un documento OpenAPI independiente. **Parámetros** Porción de proveedor del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, Hasta 64 caracteres Porción de modelo del ID de modelo canónico `{provider}/{model}`. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, Hasta 128 caracteres - El `ETag` que el cliente conserva de un `200` anterior. + El `ETag` que quien llama conserva de un `200` anterior. **Respuestas** - OK: los esquemas de entrada y salida del modelo, como documento OpenAPI independiente. + OK: los esquemas de entrada y salida del modelo, como un documento OpenAPI independiente. Cuerpo: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` - Not Modified: el documento no ha cambiado desde el `ETag` que el cliente envió en `If-None-Match`. + Not Modified: el documento no ha cambiado desde el `ETag` que quien llama envió en `If-None-Match`. Encabezados: `X-Comfy-Request-Id`, `ETag`, `Cache-Control` @@ -441,13 +442,13 @@ Lee los esquemas de entrada y salida de un modelo como documento OpenAPI indepen - La solicitud no está permitida para este cliente o modelo. + La solicitud no está permitida para quien llama ni para este modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID de modelo. + No se encontró el ID del modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -459,13 +460,13 @@ Lee los esquemas de entrada y salida de un modelo como documento OpenAPI indepen - `rate_limited`: se agotó la cuota de solicitudes por cliente. Espera el tiempo indicado en `Retry-After` antes de enviar la siguiente solicitud. + `rate_limited`: se agotó la cuota de solicitudes por quien llama. Espera el tiempo indicado en `Retry-After` antes de enviar la siguiente solicitud. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - Router no está disponible temporalmente. Reintenta con retroceso exponencial. + Router no está disponible temporalmente. Reintenta aplicando una espera progresiva. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -474,7 +475,7 @@ Lee los esquemas de entrada y salida de un modelo como documento OpenAPI indepen **Envía una ejecución de modelo de socio a la cola y responde de inmediato.** -El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es el mismo JSON de entrada nativo del socio que `POST /v2/models/{provider}/{model}` acepta para este modelo: una sola forma de cuerpo, un esquema por modelo, dos modos de entrega; pero esta ruta no mantiene la conexión abierta para el resultado. Admite la ejecución, responde `201` con un identificador y quien llama recoge el resultado más tarde mediante las tres lecturas siguientes. +El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es la misma entrada JSON nativa del socio que `POST /v2/models/{provider}/{model}` acepta para este modelo: una sola forma de cuerpo, un esquema por modelo, dos modos de entrega. Sin embargo, esta ruta no mantiene la conexión abierta para el resultado. Admite la ejecución, responde `201` con un identificador y quien llama recoge el resultado más tarde mediante las tres lecturas de abajo. **Parámetros** @@ -485,29 +486,29 @@ El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es el mism - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecutará dentro de ese proveedor. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - Selecciona un proveedor alternativo para servir este modelo en lugar de su valor predeterminado actual. + Selecciona un proveedor alternativo para servir este modelo, en lugar de su valor predeterminado actual. - Solo tiene efecto junto con `model_provider`. + Solo tiene sentido junto con `model_provider`. Predeterminado: False - Clave generada por quien llama que hace seguro reintentar una misma llamada lógica. + Clave generada por quien llama que hace seguro reintentar una llamada lógica. - De 1 a 255 caracteres + 1–255 caracteres - Actívalo para rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declare, en lugar de aceptarlo; los campos anidados no se comprueban, y no se rechaza nada para un modelo cuyo esquema permita campos no declarados o que no tenga un esquema definido, ni en un envío en cola enviado con `strict_mode=true`. + Actívalo para rechazar un campo de nivel superior del cuerpo de la solicitud que el esquema de entrada de este modelo no declara, en lugar de aceptarlo; los campos anidados no se verifican, y no se rechaza nada para un modelo cuyo esquema permite campos no declarados o que no tiene esquema definido, ni en un envío en cola enviado con `strict_mode=true`. Predeterminado: False @@ -516,14 +517,14 @@ El modo de entrega en cola de Comfy Router. El cuerpo de la solicitud es el mism `application/json` -- [`RouterModelInput`](#routermodelinput) (requerido) -El JSON de entrada nativo del modelo del socio, idéntico al cuerpo que la ruta síncrona acepta para este modelo, y que selecciona la operación y se factura de la misma manera: los propios campos del cuerpo eligen qué operación ejecuta Router en un modelo que admite más de una (una imagen de entrada cambia un modelo de imagen editable a imagen a imagen, lo que puede facturarse con su propia tarifa; una imagen de primer fotograma de Seedance selecciona imagen a video, y una imagen o un clip de referencia seleccionan referencia a video). En el despacho nativo, una solicitud de Seedance se factura según los tipos de medio en `content`, no según los roles: cualquier entrada de video se factura como video a video; de lo contrario, cualquier imagen se factura como imagen a video; de lo contrario, texto a video; salvo que un render final de un elemento `draft_task` se factura como la operación del Draft que renderiza, y algunos modelos cobran la misma tarifa para texto a video e imagen a video; con `model_provider` seleccionando un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. El mismo contrato de selección de proveedor se aplica en el despacho: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado), el cuerpo es el documento nativo del modelo y se valida contra el esquema de entrada propio del modelo antes de admitir la ejecución, así que un cuerpo que el modelo rechazaría es un `422` aquí en lugar de una solicitud en cola que falla minutos más tarde; además, un cuerpo no estricto de proveedor alternativo se traduce al esquema real de ese proveedor en el despacho. Con `strict_mode=true`, el cuerpo ya debe ser el esquema propio del proveedor alternativo y se reenvía sin cambios: la validación contra el esquema nativo se omite, exactamente igual que en la ruta síncrona (consulta `model_provider` y `strict_mode`). +La entrada JSON nativa del modelo del socio, idéntica al cuerpo que la ruta sincrónica acepta para este modelo, y que además selecciona la operación y se factura de la misma manera: los propios campos del cuerpo eligen qué operación ejecuta Router en un modelo que admite más de una (una imagen de entrada cambia un modelo de imagen editable a imagen a imagen, que puede facturarse con su propia tarifa; una imagen de primer fotograma de Seedance selecciona imagen a video y una imagen o clip de referencia selecciona referencia a video). En el despacho nativo, una solicitud de Seedance se factura según los tipos de medios en `content`, no según los roles: cualquier entrada de video se factura como video a video; si no, cualquier imagen se factura como imagen a video; si no, texto a video; salvo que un render final de un elemento `draft_task` se factura como la operación del Draft que renderiza, y algunos modelos cobran la misma tarifa para texto a video y para imagen a video; cuando `model_provider` selecciona un proveedor alternativo, cada operación condicionada puede facturarse con la tarifa propia de ese proveedor. El mismo contrato de selección de proveedor se aplica en el despacho: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado), el cuerpo es el documento nativo del modelo y se valida contra el esquema de entrada propio del modelo antes de admitir la ejecución, de modo que un cuerpo que el modelo rechazaría es un `422` aquí en lugar de una solicitud en cola que falla minutos más tarde; además, un cuerpo de proveedor alternativo no estricto se traduce al esquema real de ese proveedor en el despacho. Con `strict_mode=true`, el cuerpo ya debe ser el esquema propio del proveedor alternativo y se reenvía sin cambios: la validación contra el esquema nativo se omite, exactamente igual que en la ruta sincrónica (consulta `model_provider` y `strict_mode`). **Respuestas** - Creada: la ejecución se admitió en la cola. + Creado: la ejecución se admitió en la cola. - Cuerpo: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- Encabezados: `X-Comfy-Request-Id`, `Idempotent-Replayed` + Cuerpo: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- Encabezados: `X-Comfy-Request-Id`, `Idempotent-Replayed`, `X-Comfy-Router-Dropped-Params` @@ -545,13 +546,13 @@ El JSON de entrada nativo del modelo del socio, idéntico al cuerpo que la ruta - Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud de Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este llamador o este modelo. Un modelo cuyo socio responde una generación directamente como bytes todavía no se puede poner en cola y se rechaza con `not_enabled`; ejecútalo en la ruta síncrona. + La solicitud no está permitida para quien llama ni para este modelo. Un modelo cuyo socio responde una generación directamente como bytes todavía no se puede poner en cola y se rechaza con `not_enabled`; ejecútalo en la ruta sincrónica en su lugar. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -562,28 +563,28 @@ El JSON de entrada nativo del modelo del socio, idéntico al cuerpo que la ruta Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - - Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos de `invalid_input` en esta ruta no tienen nada que ver con la clave, y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Omite `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. + + Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos `invalid_input` en esta ruta no tienen nada que ver con la clave y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando `concurrency_limit_exceeded`) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `concurrency_limit_exceeded`) - El contenido de la solicitud fue rechazado según el esquema del modelo. + El contenido de la solicitud se rechazó contra el esquema del modelo. Cuerpo: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` - Inspecciona `X-Comfy-Error-Type`: `queue_backlog_full` significa que ya tienes tantas solicitudes en cola sin terminar como se te permite, así que vuelve a enviar cuando una de ellas termine; `rate_limited` significa que debes esperar el número de segundos indicado en `Retry-After`. + Inspecciona `X-Comfy-Error-Type`: `queue_backlog_full` significa que ya tienes tantas solicitudes en cola sin terminar como se te permite, así que envía de nuevo cuando una de ellas termine; `rate_limited` significa esperar el número de segundos indicado en `Retry-After`. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando `rate_limited`) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `rate_limited`) - El router no está disponible temporalmente. Reintenta con retroceso. + El router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo en rechazos por capacidad) + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (solo rechazos por capacidad) @@ -594,9 +595,9 @@ El JSON de entrada nativo del modelo del socio, idéntico al cuerpo que la ruta ### `GET /v2/models/{provider}/{model}/requests/{request_id}` -**Recupera el resultado de una solicitud enviada.** +**Recoge el resultado de una solicitud enviada.** -El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, devuelve la salida nativa del propio modelo del socio, byte por byte lo que la ruta síncrona entrega en su `200` para el mismo modelo y la misma entrada, de modo que los dos modos de entrega producen una sola forma de resultado y quien llama puede pasar de uno a otro sin un segundo analizador. +El endpoint de recogida. Sobre una solicitud que terminó correctamente, devuelve la salida nativa del modelo del socio: byte por byte lo mismo que lleva el `200` de la ruta síncrona para ese mismo modelo y esa misma entrada, de modo que los dos modos de entrega producen una sola forma de resultado y quien llama puede moverse entre ellos sin un segundo analizador. **Parámetros** @@ -607,13 +608,13 @@ El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, de - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecutará dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, Hasta 128 caracteres - La solicitud en cola que se va a atender: el `request_id` que el envío devolvió en su cuerpo. + La solicitud en cola que se va a consultar: el `request_id` que el envío devolvió en su cuerpo. Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres @@ -621,95 +622,95 @@ El endpoint de recogida. Sobre una solicitud que ha finalizado correctamente, de **Respuestas** - OK: el resultado almacenado de una solicitud que lo produjo (una solicitud que se completó correctamente, o una terminal que lleva tanto un cargo registrado como un resultado almacenado), devuelto sin cambios bajo el tipo de medio propio del socio, exactamente como lo devuelve el `200` de la ruta síncrona, y bajo el mismo contrato de selección de proveedor que aceptó el envío: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, traducido de vuelta al contrato nativo de este modelo cuando es posible, recurriendo a la respuesta sin procesar del proveedor alternativo si falla la traducción, registrado en el log y nunca en silencio), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde una generación directamente como bytes, el cuerpo son esos bytes bajo el `Content-Type` propio del socio en lugar de `application/json`; ramifica según el `Content-Type` de la respuesta y no des por hecho que hay un documento JSON. + OK: el resultado almacenado para una solicitud que produjo uno, es decir, una solicitud que se completó correctamente o una solicitud terminal que lleva a la vez un cargo registrado y un resultado almacenado. Se devuelve sin cambios bajo el tipo de medio propio del socio, exactamente como lo devuelve el `200` de la ruta síncrona, y bajo el mismo contrato de selección de proveedor que aceptó el envío: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, traducido de vuelta al contrato nativo de este modelo cuando es posible, y recurriendo a la respuesta sin procesar del proveedor alternativo si la traducción falla, siempre registrado en el log y nunca en silencio), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde una generación directamente como bytes, el cuerpo son esos bytes bajo el `Content-Type` propio del socio en lugar de `application/json`; decide según el `Content-Type` de la respuesta y no asumas un documento JSON. - Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` + Body: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Headers: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` - Aceptada: la solicitud no ha finalizado. + Aceptada: la solicitud todavía no ha finalizado. - Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After` + Body: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Headers: `X-Comfy-Request-Id`, `Retry-After` Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este llamador o modelo. + La solicitud no está permitida para este llamador ni para este modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - No se encontró el ID de modelo. + No se encontró el ID del modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por una razón que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `rate_limited`: se agotó la cuota de solicitudes por llamador. Espera el `Retry-After` antes de enviar la siguiente solicitud. + `rate_limited`: el cupo de solicitudes por llamador está agotado. Espera `Retry-After` antes de enviar la siguiente solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` El Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud está en un estado que entra en conflicto con la operación. Revisa el tipo de error. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por una razón que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` -**Solicita la cancelación de una solicitud enviada.** +**Solicita la cancelación de una solicitud ya enviada.** -Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una petición, no una garantía, y el `202` dice exactamente eso: `CANCELLATION_REQUESTED` significa que se aceptó la petición, no que la ejecución se haya detenido. Una ejecución que ya está en curso en un socio puede completarse de todos modos, y una generación del socio que se completa se cobra, sin importar si alguien la recogió, así que quien llama y necesita saber qué ocurrió realmente consulta el endpoint de estado después, donde una cancelación que surtió efecto es `COMPLETED` y lleva un `error_type` como cualquier otro resultado terminal. +Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una petición, no una garantía, y el `202` lo dice exactamente: `CANCELLATION_REQUESTED` significa que la petición fue aceptada, no que la ejecución se haya detenido. Una ejecución que ya está en curso en un socio puede completarse de todos modos, y una generación del socio que se completa se cobra, la haya recogido alguien o no, así que quien necesita saber qué ocurrió realmente consulta el endpoint de estado después, donde una cancelación que surtió efecto aparece como `COMPLETED` con un `error_type`, igual que cualquier otro resultado terminal. **Parámetros** Segmento de proveedor en minúsculas del ID de modelo canónico `{provider}/{model}`: el socio cuyo modelo se está ejecutando. - Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, hasta 64 caracteres + Tipo: [`RouterProviderSegment`](#routerprovidersegment) -- Slug alfanumérico, p. ej. `anthropic`, Hasta 64 caracteres - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecutará dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. - Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres + Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, Hasta 128 caracteres La solicitud en cola que se va a atender: el `request_id` que devolvió el envío en su cuerpo. - Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres + Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Hasta 36 caracteres **Respuestas** @@ -727,13 +728,13 @@ Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una petición - Solicitud no válida. Revisa el tipo de error y el cuerpo de la solicitud. + Solicitud inválida. Revisa el tipo de error y el cuerpo de la solicitud. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Credenciales faltantes o no válidas. + Credenciales faltantes o inválidas. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` @@ -745,34 +746,34 @@ Le pide a Comfy que detenga una solicitud que no ha finalizado. Es una petición - No se encontró el ID de modelo. + No se encontró el ID del modelo. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `rate_limited`: se agotó la cuota de solicitudes por solicitante. Espera `Retry-After` antes de enviar la siguiente solicitud. + `rate_limited`: se agotó la cuota de solicitudes por solicitante. Espera el `Retry-After` antes de enviar la siguiente solicitud. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - El Router no está disponible temporalmente. Reintenta con retroceso exponencial. + El Router no está disponible temporalmente. Reintenta con espera progresiva. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo o falló por un motivo que el propio modelo no reportó. + Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por una razón que el propio modelo no reportó. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}/status` -**Consulta el estado en cola de una solicitud enviada.** +**Lee el estado en cola de una solicitud enviada.** -El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con el resultado, así que un cliente puede seguir una generación larga sin transferir su salida en cada sondeo: el resultado se recoge una sola vez, con la lectura de más abajo, cuando este indica `COMPLETED`. +El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con el resultado, así un cliente puede seguir una generación larga sin transferir su salida en cada sondeo: el resultado se recoge una sola vez, desde la lectura de abajo, cuando este indica `COMPLETED`. **Parámetros** @@ -783,13 +784,13 @@ El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con - Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo que se ejecuta dentro de ese proveedor. + Segmento de modelo en minúsculas del ID de modelo canónico `{provider}/{model}`: el modelo a ejecutar dentro de ese proveedor. Tipo: [`RouterModelSegment`](#routermodelsegment) -- Slug alfanumérico, p. ej. `claude-opus-4-6`, hasta 128 caracteres - La solicitud en cola que quieres consultar: el `request_id` que el envío devolvió en su cuerpo. + La solicitud en cola que se va a consultar: el `request_id` que el envío devolvió en su cuerpo. Tipo: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, hasta 36 caracteres @@ -797,54 +798,54 @@ El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con **Respuestas** - OK: el estado actual de la cola de la solicitud. + OK: el estado en cola actual de la solicitud. - Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Credits-Used`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` + Body: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Credits-Used`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` Credenciales faltantes o no válidas. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - La solicitud no está permitida para este cliente o este modelo. + La solicitud no está permitida para este llamador o modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` No se encontró el ID de modelo. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - `rate_limited`: se agotó la cuota de solicitudes por cliente. Espera `Retry-After` antes de enviar la siguiente solicitud. + `rate_limited`: se agotó la cuota de solicitudes por llamador. Espera `Retry-After` antes de enviar la siguiente solicitud. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` - Router no está disponible temporalmente. Reintenta con retroceso exponencial. + El Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` -Las descripciones aquí son breves. Consulta [Uso de la API de Comfy Router](/es/development/comfy-router/api) para la selección de modelos, la validación, los reintentos y la facturación, y [Encabezados](/es/development/comfy-router/headers) para el comportamiento de los encabezados. +Las descripciones aquí son breves. Consulta [Usar la API de Comfy Router](/es/development/comfy-router/api) para la selección de modelos, la validación, los reintentos y la facturación, y [Encabezados](/es/development/comfy-router/headers) para el comportamiento de los encabezados. ## Categorías de error diff --git a/es/development/deploy/cloud-custom-builds.mdx b/es/development/deploy/cloud-custom-builds.mdx new file mode 100644 index 0000000000..37b2006768 --- /dev/null +++ b/es/development/deploy/cloud-custom-builds.mdx @@ -0,0 +1,262 @@ +--- +title: "Agregar Builds personalizados a Comfy Cloud" +sidebarTitle: "Builds personalizados" +description: "Ejecuta un flujo de trabajo con Nodos Personalizados en Comfy Cloud: crea un Build, ejecuta su despliegue desde el editor, sube un LoRA y elimina el despliegue." +icon: "puzzle-piece" +translationSourceHash: 8794e3d7 +translationFrom: development/deploy/cloud-custom-builds.mdx +translationBlockHashes: + "_intro": 8bac2431 + "Create a Build from your Workflow": 5fc814b8 + "Add your own LoRA or model": dee7604c + "Stop or delete your deployment": c6996c1e + "Next steps": 8223b620 +--- +Un Build empaqueta tus Nodos Personalizados, tus Nodos Personalizados privados, tus LoRAs y otros modelos, y las Dependencias de Python para que tus Flujos de trabajo puedan ejecutarse en Comfy Cloud. Inicias el Build desde el editor de Comfy Cloud, lo creas y lo despliegas en la Developer Platform, y después ejecutas tu flujo de trabajo en él desde el editor. + +Un despliegue de tu Build también te da workers de GPU que atienden únicamente tus flujos de trabajo, incluso cuando Comfy Cloud ya admite todos los nodos que contienen. + + + Para usar tu propio LoRA u otro modelo con nodos que Comfy Cloud ya admite, no necesitas un Build. En su lugar, sube el modelo a tu **Biblioteca de modelos**. Consulta [Agrega tu propio LoRA o modelo](#add-your-own-lora-or-model). + + +### Requisitos previos + +Antes de crear un Build, asegúrate de tener lo siguiente: + +- **Un flujo de trabajo guardado en Comfy Cloud** +- **Una suscripción activa o un saldo de créditos de Comfy superior a cero** + + + Crear o mantener un Build no tiene costo. Un despliegue consume tiempo de GPU mientras haya una GPU activa para él. También consume almacenamiento mientras el despliegue exista, incluso mientras esté detenido o no haya ninguna GPU activa. El cuadro de diálogo de despliegue muestra el costo estimado antes de que confirmes. Para dejar de pagar, elimina el despliegue. Consulta [Detén o elimina tu despliegue](#stop-or-delete-your-deployment). + + +## Crear una Build desde tu flujo de trabajo + +Si tu flujo de trabajo usa Nodos Personalizados que Comfy Cloud no admite, Comfy Cloud muestra un diálogo al abrirlo. El diálogo enumera los paquetes de Nodos Personalizados faltantes (grupos de Nodos Personalizados) y los modelos, como las LoRA. Para ejecutar el flujo de trabajo, crea una Build con ellos. Cuando eliges tu flujo de trabajo guardado, la Developer Platform encuentra sus Nodos Personalizados y sus modelos, y los selecciona por ti. + + + + En el diálogo, haz clic en **Create on Platform**. La Developer Platform se abre en una pestaña nueva, en su página **Deploy**. + + ![Diálogo de Comfy Cloud para un flujo de trabajo con Nodos Personalizados que Comfy Cloud no tiene, donde se enumeran los Nodos faltantes encima del enlace Leer la documentación, el botón Crea con tu agente y el botón Create on Platform](/images/development/deploy/run-on-custom-deployment.png) + + ![Menú Run on abierto junto al botón Run, con Comfy Cloud marcado, el mensaje This workspace has no deployments yet y Create a custom deployment debajo](/images/development/deploy/run-on.png) + + + Para crear una Build sin el diálogo, haz clic en el menú de la nube a la izquierda de **Run**. De forma predeterminada, está configurado en **Comfy Cloud**. + + - Si tu espacio de trabajo aún no tiene implementaciones, selecciona **Create a custom deployment** y luego haz clic en **Create on Platform**. + - Si ya tiene implementaciones, selecciona **Manage deployments**. + + + + En la página **Deploy**, haz clic en **New build**. Si aún no tienes ninguna Build, haz clic en **Start from scratch** en su lugar. + + + 1. Haz clic en **Pick from Comfy Cloud**. + 2. Selecciona tu flujo de trabajo y luego haz clic en **Add 1 workflow**. + + También puedes arrastrar el archivo `.json` del flujo de trabajo, o una imagen `.png` hecha con él, al área para soltar archivos. + + ![Página de nueva Build de la Developer Platform en su primer paso, con el área para soltar archivos, el botón Pick from Comfy Cloud, el nombre del flujo de trabajo elegido con una marca de verificación, la lista Suggested defaults y los botones Customise build y Build with defaults](/images/development/deploy/missing-nodes.png) + + El paso se completa cuando el nombre de tu flujo de trabajo aparece debajo del área para soltar archivos con una marca de verificación y la lista **Suggested defaults** muestra los **Custom nodes** de la Build. + + + Haz clic en **Build with defaults…**. Se abre el diálogo **Choose build targets**. + + Si **Build with defaults…** no está disponible, una línea debajo del botón explica por qué. Cuando esa línea dice _Add the missing models and custom nodes on their steps first._, agrega lo que falta: + + 1. Haz clic en **Customise build**. + 2. Haz clic en **Next** hasta que un paso enumere los Nodos Personalizados o los modelos faltantes. + 3. En cada uno, haz clic en **Use suggestion** o en **Upload**. + + + +Para cambiar lo que incluye la Build, haz clic en **Customise build** y recorre los pasos. Dos pasos determinan el contenido de la Build: + +- **Which custom nodes does the build need?**: elige los Nodos Personalizados. +- **Which models ship inside the build?**: elige qué modelos incluye la Build. Un modelo que la Build no incluye se descarga la primera vez que un trabajo lo usa. + +### Publicar la Build + +Publicar convierte tu Build en una versión numerada, como `v1`, que puedes implementar ahora y más tarde. Publicar es gratis. + +1. En el diálogo **Choose build targets**, deja seleccionado **Serverless build**. Es el objetivo que se ejecuta en Comfy Cloud. +2. Haz clic en **Publish**. + +La página de tu Build se abre con la nueva versión. La fila **Serverless build** muestra el progreso de la Build. Por lo general, la Build tarda de 10 a 15 minutos en completarse, y puedes abandonar la página y volver. Cuando la Build termina, la fila **Serverless build** muestra un botón **Deploy**. + +Para volver a la versión más tarde: + +1. En la barra lateral de la Developer Platform, haz clic en **Deploy**. +2. En la sección **Builds**, haz clic en tu Build. +3. En **Versions**, haz clic en la última versión. + + + + Algunos Nodos Personalizados fallan durante la compilación. Cuando eso ocurre, la fila **Serverless build** de la página de tu Build muestra **Build failed**. + + 1. Abre **Logs** en la fila para leer qué falló. + 2. Haz clic en **Edit build** y cambia la Build, por ejemplo quitando el Nodo Personalizado que falló. + 3. Publica la Build de nuevo. + + El botón **Debug with your agent** de la fila abre un prompt que describe el fallo. Cópialo en un agente de programación para reparar la Build. + + + +### Desplegar y ejecutar tu flujo de trabajo + +Un despliegue es tu Build ejecutándose en las GPU en la nube de Comfy Cloud. Despliega el Build y luego cambia el editor de Comfy Cloud al despliegue para ejecutar tu flujo de trabajo. + +1. En la fila **Serverless build**, haz clic en **Deploy**. Se abre el diálogo **Deploy v1 of** _el nombre de tu Build_. +2. Selecciona una GPU. Cada GPU muestra su VRAM (memoria de GPU) y su precio por hora. +3. Si el diálogo muestra **Ready for the Cloud editor**, deja esa opción seleccionada. Está activada de forma predeterminada. +4. Deja las demás configuraciones con sus valores predeterminados. Con **Always-warm workers** en `0`, el despliegue apaga sus GPU cuando no llegan tareas. De forma predeterminada, **Keep worker up after a job** mantiene una GPU encendida durante 3 minutos después de la última tarea, y ese tiempo de inactividad se factura a la tarifa de la GPU. +5. Revisa el panel **Estimated cost**. Muestra el tiempo de GPU por hora y el almacenamiento del modelo por mes. +6. Haz clic en **Create deployment**. Se abre la página del despliegue. Espera hasta que el estado debajo del nombre del despliegue indique **Ready**. +7. En el editor de Comfy Cloud, haz clic en el menú de la nube a la izquierda de **Run**. En **Run on**, selecciona tu despliegue. El editor se recarga y tus pestañas permanecen abiertas. + + ![Menú Run on abierto junto al botón Run, con una marca de verificación junto al despliegue seleccionado](/images/development/deploy/selected-deployment.jpg) + +8. Abre tu flujo de trabajo y haz clic en **Run**. Tu primera tarea puede esperar mientras el despliegue inicia una GPU. + +Este navegador sigue ejecutando tus flujos de trabajo en el despliegue hasta que selecciones otro. Para volver, selecciona **Comfy Cloud** en el mismo menú. Si un flujo de trabajo tiene cambios sin guardar, se abre el diálogo **Save your workflows before switching?**. Haz clic en **Save and switch** o en **Switch without saving**. + +## Agregar tu propio LoRA o modelo + +La **Biblioteca de modelos** contiene los modelos que sube tu espacio de trabajo. Un modelo que subes funciona en Comfy Cloud y en tus despliegues. + +Antes de subir un modelo, asegúrate de cumplir estos requisitos: + +- **Un plan Pro, Creator, Team o Empresa activo**: tu espacio de trabajo necesita uno para subir un modelo. +- **Un archivo `.safetensors` de 2 GB o menos**: coloca los modelos base más grandes, como SDXL o Flux, en el Build. + + + Algunos despliegues creados antes de que existieran los modelos de la biblioteca no pueden cargarlos. Para usar modelos de la biblioteca, crea un nuevo despliegue. En un despliegue antiguo, un trabajo puede fallar con `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` + + +### Subir el modelo + +Puedes subir el modelo en el editor de Comfy Cloud o en la Developer Platform. Elige la pestaña del lugar donde estés trabajando. + + + + 1. En el menú de la nube a la izquierda de **Run**, asegúrate de que **Comfy Cloud** esté seleccionado en **Run on**. En un despliegue, la **Biblioteca de modelos** no tiene botón **Import**. + 2. En la **barra lateral izquierda**, haz clic en **Biblioteca de modelos** y luego en **Importar**. + 3. Haz clic en **Choose a file** o arrastra un archivo `.safetensors` al cuadro de diálogo. + 4. En **What type of model is this?**, deja **LoRA** si es un LoRA o selecciona el tipo que corresponda al archivo. + 5. Haz clic en **Upload**. Cuando el diálogo muestre _Model successfully imported._, haz clic en **Finalizar**. + + ![Cuadro de diálogo Importar un modelo con my\_style\_lora\_9e2417.safetensors (97.37 MB) seleccionado, What type of model is this? establecido en LoRA, y los botones Back y Upload](/images/development/serverless/library-models-editor-import.png) + + Para importar un modelo desde un enlace de Civitai o Hugging Face en su lugar: + + 1. En el cuadro de diálogo **Importar**, pega el enlace del modelo en **Pega el enlace aquí**. + 2. Haz clic en **Continuar**. + 3. En **What type of model is this?**, selecciona el tipo de modelo. + 4. Haz clic en **Importar**. + + Una importación desde enlace en otro formato, como `.ckpt`, entra en la **Biblioteca de modelos**, pero no funciona en un despliegue. + + + 1. En el paso **Which models ship inside the build?** de un Build, haz clic en **Upload Models**. + 2. Selecciona **Workspace library**. + 3. Arrastra un archivo `.safetensors` al área de carga o haz clic en el área para explorar. + 4. En **Tipo de modelo**, deja **LoRA** si es un LoRA o selecciona el tipo que corresponda al archivo. + 5. Haz clic en **Upload**. + + ![Cuadro de diálogo Upload Models en el paso Which models ship inside the build? de un Build, con las pestañas Public, Private y Workspace library, Workspace library seleccionada, la zona de carga, Tipo de modelo establecido en LoRA, una línea que indica que el archivo está en la biblioteca de tu espacio de trabajo, y los botones Cancelar y Upload](/images/development/serverless/library-models-platform-upload.png) + + + +### Usar el modelo en tu flujo de trabajo + +Una vez subido el modelo, puedes usarlo en Comfy Cloud o en tu despliegue. + +1. En el menú de la nube a la izquierda de **Run**, selecciona dónde ejecutar: **Comfy Cloud** o tu despliegue. +2. Agrega un nodo `Load LoRA (Model and CLIP)` o abre un flujo de trabajo que ya tenga uno. +3. En la lista `lora_name` del nodo, selecciona tu archivo. +4. Haz clic en **Run**. + +![Flujo de trabajo con nodos Load Checkpoint y Load LoRA (Model and CLIP), el LoRA subido seleccionado en lora\_name, y la fila superior del Panel de Cola mostrando Descargando my\_style\_lora\_9e2417.safetensors 0 B de 97.37 MB](/images/development/serverless/library-models-editor-downloading.png) + + + En un despliegue, la primera ejecución descarga el modelo y la fila del trabajo en la cola muestra `Downloading `. Los trabajos posteriores en la misma GPU en ejecución omiten la descarga. Una GPU que el despliegue inicie más adelante descarga el modelo otra vez. Para omitir la descarga, agrega el modelo al Build. + + +Sigue estas reglas para que un trabajo encuentre tu modelo: + +- **Elige el tipo correcto.** Un nodo de carga solo lista modelos de su tipo. Un nodo `Load LoRA (Model and CLIP)` lista los modelos subidos como LoRA. +- **Usa un nombre de archivo nuevo.** Si tu Build ya tiene un modelo con el mismo nombre, un trabajo en tu despliegue usa el archivo del Build, no el que subiste. +- **Usa el modelo base correcto.** Un LoRA debe coincidir con el modelo base que carga tu flujo de trabajo. +- **Usa un nodo de carga que exista en Comfy Cloud.** Si el nodo de carga proviene de un nodo personalizado que Comfy Cloud no tiene, agrega el modelo al Build. + +### Cambiar o eliminar un modelo de la biblioteca + +Cuando hay un despliegue seleccionado en **Run on**, la **Biblioteca de modelos** solo lista los modelos del Build. Para cambiar o eliminar un modelo que subiste, primero [vuelve a Comfy Cloud](#deploy-and-run-your-workflow) y luego, en la **barra lateral izquierda**, haz clic en **Biblioteca de modelos**. + +Para cambiar el tipo de modelo: + +1. Pasa el cursor sobre la tarjeta del modelo y haz clic en **Información del modelo**. +2. Selecciona un nuevo **Tipo de modelo**. + + + Eliminar un modelo lo quita de la **Biblioteca de modelos** de forma permanente. Un trabajo que todavía use el archivo falla con un error `Value not in list` en el nodo de carga. + + +Para eliminar el modelo: + +1. Pasa el cursor sobre la tarjeta del modelo, haz clic en **More** y luego en **Eliminar**. +2. En **Delete this model?**, haz clic en **Eliminar**. + +## Detener o eliminar tu despliegue + +Un despliegue consume almacenamiento hasta que lo elimines, incluso mientras está detenido. Detén un despliegue para conservarlo más adelante sin ejecutar tareas. Elimínalo para dejar de pagar por él. + +Para abrir la página del despliegue: + +1. En la **barra lateral de Developer Platform**, haz clic en **Deploy**. +2. En la sección **Deployments**, haz clic en el nombre del despliegue. + +![Sección Deployments de la página Deploy, con el nombre de cada despliegue en la columna de la izquierda y su estado en la columna Status](/images/development/deploy/deployments.jpg) + +Para detener el despliegue: + +1. Haz clic en **Stop**. +2. En el cuadro de diálogo **Stop deployment**, haz clic en **Stop**. + +El estado muestra **Stopping** y luego **Stopped**. + +Para volver a ejecutar el despliegue: + +- Haz clic en **Start**. + + + Eliminar quita el despliegue y su historial de forma permanente. Tu Build y sus versiones se conservan, así que puedes volver a desplegar más adelante. + + +Para eliminar el despliegue: + +1. En un despliegue detenido, haz clic en **Delete**. En un despliegue en ejecución, abre el menú **More actions** y luego selecciona **Delete**. +2. En el cuadro de diálogo **Delete deployment**, haz clic en **Delete**. + +La próxima vez que abras el editor en este navegador, el editor ejecutará tus flujos de trabajo en Comfy Cloud. + +## Próximos pasos + + + + Sube un modelo desde una terminal y selecciónalo en cada solicitud con `lora_name`. + + + Llama a tu implementación desde tu propio código como un endpoint de autoescalado. + + + Consulta cómo funcionan los créditos de Comfy Cloud y los límites de tareas simultáneas. + + + Exporta un flujo de trabajo en el formato que envían las solicitudes de API. + + diff --git a/es/development/deploy/overview.mdx b/es/development/deploy/overview.mdx index 0f487e6dc2..c4e016641f 100644 --- a/es/development/deploy/overview.mdx +++ b/es/development/deploy/overview.mdx @@ -3,22 +3,24 @@ title: "Implementar ComfyUI" sidebarTitle: "Descripción general" description: "Compara Comfy Cloud, las implementaciones gestionadas de la API de Comfy y el autoalojamiento para elegir cómo ejecutar ComfyUI." icon: "map" -translationSourceHash: be91af8f +translationSourceHash: c83524f1 translationFrom: development/deploy/overview.mdx translationBlockHashes: - "_intro": cc75b9f0 + "_intro": 44e94954 "Deploy from the ComfyUI app": 53163f19 - "Run a deployment from the Cloud editor": 9426b4cc - "Stop or delete a deployment": 9b9a173c + "Run a deployment from the Cloud editor": 1c75cbed "Run Workflows from your application": f95d4434 --- Puedes ejecutar tus flujos de trabajo de ComfyUI en Comfy Cloud, en tu propia implementación de Comfy API o en un servidor que administres. Comfy Cloud y Comfy API se ejecutan en GPU de Comfy, así que no necesitas una GPU en tu equipo. Elige la opción que encaje con tu flujo de trabajo y empieza desde su tarjeta. - + Ejecuta flujos de trabajo cuyos nodos personalizados y modelos ya están en Comfy Cloud, sin crear un build ni un despliegue. + + Ejecuta flujos de trabajo que necesitan tus propios nodos personalizados y modelos dentro del editor de Comfy Cloud, con un build que creas en tu navegador. + Empaqueta nodos personalizados, modelos y dependencias de Python en un build y ejecútalo como un endpoint con escalado automático. @@ -27,7 +29,7 @@ Puedes ejecutar tus flujos de trabajo de ComfyUI en Comfy Cloud, en tu propia im -Para llamar a cualquiera de las tres desde tu propio código, envía el flujo de trabajo en [formato API](/es/development/api-development/workflow-api-format). +Para llamar a cualquiera de estas opciones desde tu propio código, envía el flujo de trabajo en [formato API](/es/development/api-development/workflow-api-format). ## Implementar desde la aplicación ComfyUI @@ -57,86 +59,7 @@ En Developer Platform, creas un build a partir del flujo de trabajo, publicas un ## Ejecutar una implementación desde el editor de Cloud -Tu implementación puede ejecutar flujos de trabajo en ComfyUI en Comfy Cloud, con los nodos personalizados y los modelos de su build. - -### Crear una implementación desde Comfy Cloud - -En Comfy Cloud, el menú **Workflow actions** no tiene la entrada **Deploy to Comfy API**. Empieza desde el menú junto a **Run**: - -1. Haz clic en el menú junto a **Run**. -2. Selecciona **Create a custom deployment** y luego haz clic en **Create on Platform**. Tus builds en Developer Platform se abren en una pestaña nueva. - -![Menú Run on abierto junto al botón Run, con Comfy Cloud marcado, el mensaje This workspace has no deployments yet y Create a custom deployment debajo](/images/development/deploy/run-on.png) - -Cuando tu espacio de trabajo ya tiene implementaciones, el menú muestra **Manage deployments** en su lugar. Abre la misma página de builds en Developer Platform. - -Cuando abres un flujo de trabajo que usa nodos personalizados que Comfy Cloud no tiene, el diálogo **Run this workflow on a custom deployment** enumera lo que falta. Haz clic en **Create on Platform** para iniciar un build. - -![Diálogo de Comfy Cloud para un flujo de trabajo con nodos personalizados que Comfy Cloud no tiene, con la lista de nodos faltantes encima del enlace Read the docs, el botón Build with your agent y el botón Create on Platform](/images/development/deploy/run-on-custom-deployment.png) - -### Abrir tu implementación en el editor de Cloud - -1. En el diálogo de despliegue, deja seleccionado **Ready for the Cloud editor** si el diálogo lo muestra. La opción está activada por defecto. Si desmarcas **Ready for the Cloud editor**, abrir la implementación en el editor más tarde tarda un minuto. -2. En la página de la implementación, espera a que el estado bajo su nombre diga **Ready**. **Open in ComfyUI** permanece deshabilitado hasta entonces. -3. Haz clic en **Open in ComfyUI**. ComfyUI en Comfy Cloud se abre en una pestaña nueva y se recarga en tu implementación. - -![Página de la implementación con el estado Ready bajo el nombre y el botón Open in ComfyUI arriba a la derecha](/images/development/deploy/deployment-detail.jpg) - -Para comprobar dónde se ejecutan tus flujos de trabajo: - -1. Haz clic en el menú junto a **Run**. -2. Busca la marca de verificación junto a la implementación en la que se ejecutan tus flujos de trabajo. -3. Haz clic en **Run** para ejecutar el flujo de trabajo en ella. - -![Menú Run on abierto junto al botón Run, con una marca de verificación junto a la implementación seleccionada](/images/development/deploy/selected-deployment.jpg) - -- El menú enumera cada implementación de tu espacio de trabajo. Selecciona una implementación **Ready** para cambiar a ella. -- Al cambiar se recarga el editor. Por defecto, tus pestañas permanecen abiertas. -- Este navegador sigue ejecutando tus flujos de trabajo en la implementación seleccionada hasta que elijas otra. - -### Volver a Comfy Cloud - -1. Haz clic en el menú junto a **Run**. -2. Selecciona **Comfy Cloud**. - -El editor se recarga. Si un flujo de trabajo tiene cambios sin guardar, se abre el diálogo **Save your workflows before switching?**. Haz clic en **Save and switch** o en **Switch without saving**. - -## Detener o eliminar una implementación - -Detén una implementación para parar sus trabajos, o elimínala para quitarla y terminar su facturación de almacenamiento. Ambas acciones están en la página de la implementación en Developer Platform. - - - Una implementación detenida no ejecuta trabajos, pero su almacenamiento sigue facturándose. Elimina la implementación para terminar la facturación de almacenamiento. - - -Para abrir la página de la implementación: - -1. En la barra lateral de Developer Platform, haz clic en **Deploy**. -2. En la sección **Deployments**, haz clic en el nombre de la implementación. - -![Sección Deployments de la página Deploy, con el nombre de cada implementación en la columna de la izquierda y su estado en la columna Status](/images/development/deploy/deployments.jpg) - -Para detener la implementación: - -1. Haz clic en **Stop**. -2. En el diálogo **Stop deployment**, haz clic en **Stop**. - -El estado pasa a **Stopping** y luego a **Stopped**. - -Para volver a ejecutar la implementación: - -- Haz clic en **Start**. - - - Eliminar quita la implementación y su historial de forma permanente. El build permanece. - - -Para eliminar la implementación: - -1. En una implementación detenida, haz clic en **Delete**. En una implementación en ejecución, abre el menú **More actions** y luego selecciona **Delete**. -2. En el diálogo **Delete deployment**, haz clic en **Delete**. - -La próxima vez que un navegador que ejecutó el editor de Cloud en la implementación cargue ComfyUI, ComfyUI se ejecutará en Comfy Cloud en lugar de en la implementación eliminada. +Para crear una implementación desde el editor de Comfy Cloud, ejecutar tus flujos de trabajo en ella y detenerla o eliminarla, consulta [Agregar builds personalizados a Comfy Cloud](/es/development/deploy/cloud-custom-builds). ## Ejecutar flujos de trabajo desde tu aplicación diff --git a/es/development/serverless/overview.mdx b/es/development/serverless/overview.mdx index 41577f9ba0..eb72cecde1 100644 --- a/es/development/serverless/overview.mdx +++ b/es/development/serverless/overview.mdx @@ -3,23 +3,25 @@ title: "Guía de despliegue de Comfy API" sidebarTitle: "Guía de despliegue" description: "Despliega flujos de ComfyUI en endpoints GPU: Builds, versiones, regiones, escalado de workers, límites del espacio de trabajo y monitorización del despliegue." icon: "cloud-arrow-up" -translationSourceHash: 4df17332 +translationSourceHash: fbee2a94 translationFrom: development/serverless/overview.mdx translationBlockHashes: "_intro": f163eb63 - "Platform concepts": cd4243ce + "Platform concepts": 7dd0b0f4 "The Build file": 70f351b1 "Update and release": 66e5f4ab "Regions and GPU availability": fe40705f "Workspace limits": e0643567 "Monitor and call a deployment": ff860dab + "Use workspace library models in API requests": ab60f3f3 "Operate a deployment": de5e72b5 "Inspect and clean up": 0033fd9b - "FAQ": 08ef9084 + "FAQ": 4eff1368 "Next steps": 0045baa9 --- + Comfy API permite que tu aplicación ejecute flujos de trabajo de ComfyUI a través de un endpoint gestionado. Empaquetas la versión de ComfyUI, los modelos, los nodos personalizados y las dependencias que necesita el flujo de trabajo, y luego Comfy lo ejecuta en GPUs gestionadas. Úsalo cuando necesites un entorno repetible y un endpoint al que tu aplicación pueda llamar. ## Conceptos de la plataforma @@ -33,7 +35,7 @@ Comfy API permite que tu aplicación ejecute flujos de trabajo de ComfyUI a trav Los flujos de trabajo compatibles con [Comfy Cloud](/es/development/deploy/cloud) pueden ejecutarse allí sin crear un Build ni un despliegue. -Para agregar un modelo a un despliegue sin crear un Build nuevo, súbelo a la biblioteca de tu espacio de trabajo. Consulta [Modelos de la biblioteca del espacio de trabajo](/es/development/serverless/library-models). +Para agregar un modelo a un despliegue sin crear un Build nuevo, súbelo a la biblioteca de tu espacio de trabajo. Consulta [Agregar tu propia LoRA o modelo](/es/development/deploy/cloud-custom-builds#agregar-tu-propio-lora-o-modelo). Comienza con un agente o elige otra forma de proporcionar tu entorno o flujo de trabajo. @@ -92,6 +94,43 @@ Las opciones `--min` y `--max` establecen los límites de workers. Ejecuta `comf También puedes llamar al endpoint con los [Comfy SDKs](/es/development/api-development/sdks). Establece `COMFY_BASE_URL` con la URL del despliegue y proporciona una clave API. Consulta [Elegir una URL base](/es/development/api-development/sdks#elegir-una-url-base). +## Usar modelos de la biblioteca del espacio de trabajo en solicitudes a la API + +Un despliegue ejecuta modelos `.safetensors` de la biblioteca de tu espacio de trabajo, incluso cuando su release no los incluye. Para subir un modelo en el editor de Comfy Cloud o en la Developer Platform, consulta [Agrega tu propia LoRA o modelo](/es/development/deploy/cloud-custom-builds#agregar-tu-propio-lora-o-modelo). + +Para subir desde una terminal, define el tipo de modelo con `--type` y luego verifica que el archivo esté en la biblioteca: + +```bash +comfy assets library upload my_style.safetensors --type loras +comfy assets library ls --tags models,loras +``` + +En el [flujo de trabajo en formato API](/es/development/api-development/workflow-api-format), define la entrada del cargador con el nombre del archivo de la biblioteca, incluida la extensión `.safetensors`: + +```json +"10": { + "class_type": "LoraLoader", + "inputs": { + "lora_name": "my_style.safetensors", + "strength_model": 1.0, + "strength_clip": 1.0, + "model": ["4", 0], + "clip": ["4", 1] + } +} +``` + +Envía el flujo de trabajo con `comfy deploy run`, los [SDK de Comfy](/es/development/api-development/sdks) o la [API v2 de Comfy](/es/api-reference/v2/overview): + +```bash +comfy deploy run --deployment --workflow workflow_api.json +``` + +Para usar una LoRA diferente, cambia `lora_name` por el nombre de otro archivo de la biblioteca en la siguiente solicitud. No necesitas un Build nuevo, un release nuevo ni volver a desplegar. + +- Un flujo de trabajo puede indicar hasta 100 modelos de la biblioteca. Un cargador que indica un modelo número 101 de la biblioteca falla como si el archivo no estuviera en la biblioteca. +- Mantén los nombres de archivo únicos en todas las carpetas que lee un mismo cargador. Si la biblioteca tiene el mismo nombre de archivo en dos de ellas, una tarea enviada a través de la API no carga ninguno de los dos archivos. + ## Operar un despliegue ```bash @@ -136,9 +175,9 @@ comfy deploy events --deployment dep_123456 La facturación de almacenamiento comienza con un despliegue: - - Cuando despliegas un release, sus modelos se preparan en el almacenamiento en red que comparten los workers del despliegue. Ese almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con `comfy deploy stop`. Los modelos que una tarea usa de tu [biblioteca del espacio de trabajo](/es/development/serverless/library-models) no se preparan allí. El worker los descarga para la tarea. + - Cuando despliegas un release, sus modelos se copian de forma provisional al almacenamiento en red que comparten los workers del despliegue. Ese almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con `comfy deploy stop`. Los modelos que una tarea usa de tu [biblioteca del espacio de trabajo](/es/development/serverless/library-models) no se copian allí. El worker los descarga para la tarea. - Cada worker también recibe un disco de contenedor fijo de 50 GB. Es efímero y solo se factura mientras el worker está en ejecución, como parte del costo de cómputo del worker. - - Eliminar un despliegue libera su cómputo. El almacenamiento en red preparado se limpia poco después de eliminar el último despliegue que lo usa en esa región, y la facturación correspondiente termina. + - Eliminar un despliegue libera su cómputo. El almacenamiento en red provisional se limpia poco después de eliminar el último despliegue que lo usa en esa región, y la facturación correspondiente termina. Para conocer las tarifas de almacenamiento actuales, consulta la [página de precios de Comfy](https://www.comfy.org/pricing). El catálogo de cómputo (`comfy deploy refs compute`) y el diálogo de despliegue también muestran las tarifas que se aplican a un despliegue. @@ -166,11 +205,11 @@ comfy deploy events --deployment dep_123456 comfy deploy events --deployment ``` - Si la GPU o la región seleccionada no tiene capacidad, reintenta más tarde o ejecuta `comfy deploy refs compute` y elige un par de región y GPU disponible. Incluye los IDs del Build, del release y del despliegue cuando pidas ayuda. + Si la GPU o la región seleccionada no tiene capacidad, reintenta más tarde o ejecuta `comfy deploy refs compute` y elige una combinación de región y GPU disponible. Incluye los IDs del Build, del release y del despliegue cuando pidas ayuda. - Eliminar un despliegue quita su endpoint y libera su cómputo. No elimina el Build ni sus releases. Después de eliminar el último despliegue que usa ese Build en una región, su almacenamiento en red preparado se limpia y la facturación de almacenamiento termina poco después. + Eliminar un despliegue quita su endpoint y libera su cómputo. No elimina el Build ni sus releases. Después de eliminar el último despliegue que usa ese Build en una región, su almacenamiento en red provisional se limpia y la facturación de almacenamiento termina poco después. Eliminar el Build es una operación aparte: `comfy build delete --id --yes`. diff --git a/es/tutorials/partner-nodes/pika/pika-h3-flex.mdx b/es/tutorials/partner-nodes/pika/pika-h3-flex.mdx index ec66413472..2f66157953 100644 --- a/es/tutorials/partner-nodes/pika/pika-h3-flex.mdx +++ b/es/tutorials/partner-nodes/pika/pika-h3-flex.mdx @@ -2,7 +2,7 @@ title: "Pika H3 Flex en ComfyUI: texto, imagen y video de referencia" description: "Ejecuta Pika H3 Flex con el API de socios en ComfyUI: video de texto, imagen, primer y último fotograma y referencia con audio generado, de 480p a 4K." sidebarTitle: "Pika H3 Flex" -translationSourceHash: 6b0b02c9 +translationSourceHash: 748513cb translationFrom: tutorials/partner-nodes/pika/pika-h3-flex.mdx translationBlockHashes: "_intro": dc840a35 @@ -10,10 +10,11 @@ translationBlockHashes: "Pika H3 Flex: Text to Video (API) {#api_pika_h3_flex_t2v}": 7745a88d "Image to video and first-last-frame": 76d6d279 "Reference to video": 0ba880d9 - "Pika audio nodes": 642096c1 + "Pika audio nodes": f8d1f386 "Prompt format": 0a07de68 "Cost": 5adc088c --- + import ReqHint from "/snippets/es/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"; @@ -66,9 +67,9 @@ Tres nodos de audio se ejecutan en la misma API de Pika y se facturan por segund - **Pika Soundtrack**: reemplaza el audio de un video de hasta 10 minutos con una banda sonora sincronizada. La instrucción describe los efectos de sonido, el ambiente o la música; déjala vacía para derivar el audio a partir de la imagen. - **Pika SFX**: genera un efecto de sonido a partir de una descripción de texto, de 1 a 20 segundos de duración. -- **Pika Music**: genera una canción a partir de un prompt de texto y letras opcionales, de 10 a 360 segundos, o versiona una canción original con su propia duración, limitada a 5 a 360 segundos. +- **Pika Music**: genera una canción a partir de un prompt de texto y letras opcionales, de 10 a 360 segundos, o hace una versión de una canción fuente con su propia duración, limitada a 5 a 360 segundos. -Para ver los controles, los patrones de prompt y los límites de estos dos nodos de audio, consulta [Pika Music y Pika SFX](/es/tutorials/partner-nodes/pika/pika-audio). +Para ver los controles, los patrones de prompt y los límites de los dos nodos de audio basados en texto, consulta [Pika Music y Pika SFX](/es/tutorials/partner-nodes/pika/pika-audio). ## Formato del prompt From 2283504f230af710bf94bd48fb28fb4f4921d0af Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Sun, 15 Nov 2026 11:01:44 +0800 Subject: [PATCH 32/36] i18n(es): fix unclosed and duplicated schema field tags on Router code pages Un-glue body text from ParamField/ResponseField opening tags, drop the duplicated response field in gemini-3-1-flash-lite, and point the cloud-custom-builds cards at the localized anchor slugs. --- .../byteplus/dreamina-seedance-2-0-260128/code.mdx | 2 +- .../byteplus/dreamina-seedance-2-5-260628/code.mdx | 2 +- .../models/byteplus/seedance-1-0-pro-250528/code.mdx | 2 +- .../models/google/gemini-2-5-flash-image/code.mdx | 7 +++++-- .../models/google/gemini-3-1-flash-lite/code.mdx | 9 +++++---- .../models/google/gemini-3-7-flash/code.mdx | 5 +++-- .../models/google/gemini-3-8-flash/code.mdx | 9 ++++++--- .../models/google/gemini-4-argon/code.mdx | 9 ++++++--- .../models/google/gemini-4-carbon/code.mdx | 12 +++++++++--- .../models/google/gemini-4-hydrogen/code.mdx | 7 +++++-- .../models/google/gemini-nano-banana-2-1/code.mdx | 6 ++++-- .../models/google/nano-banana-2-lite/code.mdx | 10 +++++++--- .../models/google/nano-banana-2/code.mdx | 8 +++++--- .../models/google/nano-banana-pro/code.mdx | 9 ++++++--- .../comfy-router/models/kling/kling-v2-6/code.mdx | 2 +- .../comfy-router/models/krea/krea-3/code.mdx | 4 +++- .../models/openai/gpt-image-1-5/code.mdx | 2 +- .../models/openai/gpt-image-2-6-flare/code.mdx | 2 +- .../models/openai/gpt-image-2-6-sunburst/code.mdx | 2 +- .../comfy-router/models/openai/gpt-image-2/code.mdx | 2 +- .../pika/pika-h3-flex-reference-to-video/code.mdx | 3 ++- .../models/stability/sdxl-1-0-masking/code.mdx | 3 ++- .../models/wan/happyhorse-1-0-i2v/code.mdx | 3 ++- .../models/wan/happyhorse-1-0-r2v/code.mdx | 3 ++- .../models/wan/happyhorse-1-1-i2v/code.mdx | 3 ++- .../models/wan/wan2-5-i2v-preview/code.mdx | 3 ++- .../comfy-router/models/wan/wan2-6-i2v/code.mdx | 3 ++- .../comfy-router/models/wan/wan2-6-r2v/code.mdx | 3 ++- .../comfy-router/models/wan/wan2-7-i2v/code.mdx | 3 ++- .../models/wan/wan2-7-videoedit/code.mdx | 3 ++- .../comfy-router/models/wan/wan3-0-video/code.mdx | 3 ++- es/development/comfy-router/reference.mdx | 2 +- es/development/deploy/cloud-custom-builds.mdx | 8 ++++---- ja/development/deploy/cloud-custom-builds.mdx | 2 +- ko/development/deploy/cloud-custom-builds.mdx | 2 +- zh/development/deploy/cloud-custom-builds.mdx | 2 +- 36 files changed, 102 insertions(+), 58 deletions(-) diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index d00977806a..8a9cf63d21 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -416,7 +416,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr Mensaje de error - + El ID de la tarea de generación de video diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 1b1b3e59a3..ba65888bce 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -421,7 +421,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream El mensaje de error - + El ID de la tarea de generación de video diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 5bd532d601..8ced8f1a78 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -407,7 +407,7 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/se Mensaje de error - + El ID de la tarea de generación de video diff --git a/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index 6197a384eb..b59cd0aafc 100644 --- a/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -285,7 +285,8 @@ El valor predeterminado de `strict_mode` es falso, por lo que Router traduce el -Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por dar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los valores de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por dar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los valores de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -378,7 +379,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON para los parámetros de la función diff --git a/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index 2799090a34..9817fcf853 100644 --- a/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -274,7 +274,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE -Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por entregar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los ajustes de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por entregar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los ajustes de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -367,7 +368,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON para los parámetros de la función @@ -552,8 +555,6 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index 215f42888b..6bc63b8bcb 100644 --- a/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -369,7 +369,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + Esquema JSON para los parámetros de la función @@ -553,7 +553,8 @@ Generado a partir del esquema que Router publica en `GET /v2/models/vertexai/gem -Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-3-8-flash/code.mdx b/es/development/comfy-router/models/google/gemini-3-8-flash/code.mdx index 8ec538a1eb..2d1d38fcc2 100644 --- a/es/development/comfy-router/models/google/gemini-3-8-flash/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-8-flash/code.mdx @@ -274,7 +274,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.8-flash/requests/$REQUEST - + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los ajustes de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -368,7 +368,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON de los parámetros de la función @@ -552,7 +554,8 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin -Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-4-argon/code.mdx b/es/development/comfy-router/models/google/gemini-4-argon/code.mdx index aa6798098b..b18ed26bd1 100644 --- a/es/development/comfy-router/models/google/gemini-4-argon/code.mdx +++ b/es/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -273,7 +273,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_I -Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo para proporcionar la misma respuesta en solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de parámetros, como la temperatura, puede causar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo para proporcionar la misma respuesta en solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de parámetros, como la temperatura, puede causar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -366,7 +367,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON para los parámetros de la función @@ -550,7 +553,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - + La categoría de seguridad a la que pertenece esta calificación Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx index 7ef4c21d00..955feae345 100644 --- a/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx +++ b/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -273,7 +273,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ - + Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los valores de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -367,7 +367,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON de los parámetros de la función @@ -551,7 +553,11 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT` + + + La probabilidad de que el contenido viole la categoría de seguridad especificada Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` diff --git a/es/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx b/es/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx index 2cba85a610..b78d344ccb 100644 --- a/es/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx +++ b/es/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx @@ -273,7 +273,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUES -Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se utiliza un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se utiliza un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -366,7 +367,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON para los parámetros de la función diff --git a/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx b/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx index c83fed8e80..1d752186be 100644 --- a/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx +++ b/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx @@ -376,7 +376,9 @@ El valor predeterminado de `strict_mode` es `false`, así que Router traduce el - + + + Esquema JSON para los parámetros de la función @@ -560,7 +562,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index f6764d9a70..12f856dcca 100644 --- a/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -101,7 +101,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image \ -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"a single red maple leaf on a plain white background, studio lighting\"}]}], \"generationConfig\": {\"responseModalities\":[\"IMAGE\"],\"imageConfig\":{\"aspectRatio\":\"1:1\"}}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge una vez que está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. @@ -397,7 +398,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON para los parámetros de la función @@ -581,7 +584,8 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin -Posibles valores: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + Posibles valores: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/nano-banana-2/code.mdx b/es/development/comfy-router/models/google/nano-banana-2/code.mdx index 1723d03f72..07cc3df59c 100644 --- a/es/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -105,7 +105,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image \ -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"a single red maple leaf on a plain white background, studio lighting\"}]}], \"generationConfig\": {\"responseModalities\":[\"IMAGE\"],\"imageConfig\":{\"aspectRatio\":\"1:1\"}}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-image/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) repasa el estado, la cancelación y la recogida. @@ -321,7 +322,8 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot -Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por proporcionar la misma respuesta para solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de parámetros, como la temperatura, puede causar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por proporcionar la misma respuesta para solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de parámetros, como la temperatura, puede causar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -600,7 +602,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx index c55fbf8b55..63ef735851 100644 --- a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -104,7 +104,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image \ -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"a single red maple leaf on a plain white background, studio lighting\"}]}], \"generationConfig\": {\"responseModalities\":[\"IMAGE\"],\"imageConfig\":{\"aspectRatio\":\"1:1\"}}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado en cuanto esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. @@ -413,7 +414,9 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - + + + Esquema JSON para los parámetros de la función @@ -597,7 +600,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/kling/kling-v2-6/code.mdx b/es/development/comfy-router/models/kling/kling-v2-6/code.mdx index 313e7c60f9..8506fccb79 100644 --- a/es/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -299,7 +299,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ true significa generar marca de agua, false significa no generarla. - + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10 MB, la resolución no debe ser inferior a 300*300 px y la relación de aspecto debe estar entre 1:2.5 ~ 2.5:1. Base64 no debe incluir el prefijo data:image. diff --git a/es/development/comfy-router/models/krea/krea-3/code.mdx b/es/development/comfy-router/models/krea/krea-3/code.mdx index f808c481b7..5d8850c1bb 100644 --- a/es/development/comfy-router/models/krea/krea-3/code.mdx +++ b/es/development/comfy-router/models/krea/krea-3/code.mdx @@ -185,7 +185,9 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ fast (predeterminado), high o ultra. High y ultra planifican las ediciones complejas con más detalle y tardan más. Ultra requiere resolution 2k. -Generado a partir del esquema que Router expone en `GET /v2/models/krea/krea-3/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. + + +Generado a partir del esquema que Router expone en `GET /v2/models/krea/krea-3/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida diff --git a/es/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/es/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index a96530f4fb..d095de423c 100644 --- a/es/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -177,7 +177,7 @@ Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta La SEGUNDA se HABILITA POR CUENTA y no para todos a la vez, porque el bucket que hay detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta que no tenga habilitada la multimedia entrante de terceros recibe un rechazo, y se le indica con esas mismas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que la habilite para tu cuenta. Además admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, tanto en la forma de estilo de ruta como en la prefijada con `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR, así que nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y tres casos casi coincidentes merecen mención expresa porque quien llama puede llegar razonablemente con cualquiera de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de velocidad y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com`, o usa la forma `pub-.r2.dev`. El endpoint dualstack IPv6 de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco lo es la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. -Los marcadores `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La comparación se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los listados. +Los marcadores `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La comparación se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los listados. El ejemplo siguiente muestra solo la forma: un valor real también incluye los parámetros de consulta de firma, que aquí se omiten a propósito porque un ejemplo publicado vive en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 8d8d29459e..e487af20e3 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -198,7 +198,7 @@ LA OBTENCIÓN ESTÁ CONFINADA A UN CONJUNTO NOMBRADO DE HOSTS en lugar de la int DOS AMPLIACIONES ESTÁN EN DESPLIEGUE Y AMBAS ESTÁN DESACTIVADAS DE FORMA PREDETERMINADA HOY. Se lanzan detrás de UN interruptor y se habilitan juntas, así que trata todo lo que sigue como algo futuro en lugar de como algo sobre lo que construir todavía: pregunta antes de depender de cualquiera de las dos. La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que el despliegue llegue a tu entorno, se rechaza aquí una URL de carga de ese endpoint, aunque el bucket sea propio de Comfy y el host sea el mismo: así que "subir a Comfy y luego pasar la URL" todavía NO funciona, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. La SEGUNDA SE HABILITA POR CUENTA en lugar de para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso una vez que el interruptor anterior está activado, se rechaza una cuenta que no haya tenido habilitados los medios entrantes de terceros, y se le dice así con esas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que lo habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama la propiedad sobre él: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, ya sea en la forma de ruta o en la forma con prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. -Lo que se compara es la forma del nombre de host, no el proveedor: por eso, nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y vale la pena mencionar directamente tres casos que casi coinciden, porque un cliente puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de velocidad y dirige el tráfico de producción a un dominio personalizado en su lugar, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: firma previamente el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí para leerlas. +Lo que se compara es la forma del nombre de host, no el proveedor: por eso, nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y vale la pena mencionar directamente tres casos que casi coinciden, porque un cliente puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de velocidad y dirige el tráfico de producción a un dominio personalizado en su lugar, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: firma previamente el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí para leerlas. Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace en el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los enumerados. El ejemplo de abajo solo muestra la forma: un valor real también lleva los parámetros de consulta de firma, que se omiten deliberadamente aquí porque un ejemplo publicado vive en la especificación para siempre y una firma real es tanto una credencial filtrada como un enlace que deja de funcionar. Cada imagen tiene un límite de 25 MiB y las imágenes de una solicitud, de 64 MiB en total. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`) donde `context_window` está disponible: allí cada imagen puede ser de hasta 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud, de hasta 128 MiB en total. diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 55ef218c36..423fe8b319 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -197,7 +197,7 @@ LA OBTENCIÓN ESTÁ CONFINADA A UN CONJUNTO NOMBRADO DE HOSTS en lugar de a la i SE ESTÁN DESPLEGANDO DOS AMPLIACIONES Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se lanzan detrás de UN solo interruptor y se habilitan juntas, así que trata todo lo siguiente como algo futuro y no como algo sobre lo que construir todavía: pregunta antes de apoyarte en cualquiera de las dos. La PRIMERA es el bucket en el que `POST /customers/storage` firma tu subida. Hasta que el despliegue llegue a tu entorno, una URL de subida de ese endpoint se rechaza aquí, aunque el bucket sea el propio de Comfy y el host sea el mismo; por lo tanto, “sube a Comfy y luego pasa la URL” NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. La SEGUNDA SE HABILITA POR CUENTA en lugar de para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta a la que no se le han habilitado los medios entrantes de terceros se rechaza, y se le dice con esas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que lo habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama ninguna propiedad sobre él: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, ya sea en la forma de ruta o con el prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. -Lo que se compara es la forma del nombre de host, no el proveedor, así que nombrar un proveedor arriba **no** significa que se acepte toda URL que ese proveedor pueda emitir, y tres casos que casi coinciden merecen decirse sin rodeos, porque un cliente puede llegar razonablemente con cada uno de ellos. Un **dominio personalizado** de R2 (`cdn.example.com`) **no** se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: genera la URL prefirmada del endpoint `.r2.cloudflarestorage.com`, o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. +Lo que se compara es la forma del nombre de host, no el proveedor, así que nombrar un proveedor arriba **no** significa que se acepte toda URL que ese proveedor pueda emitir, y tres casos que casi coinciden merecen decirse sin rodeos, porque un cliente puede llegar razonablemente con cada uno de ellos. Un **dominio personalizado** de R2 (`cdn.example.com`) **no** se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: genera la URL prefirmada del endpoint `.r2.cloudflarestorage.com`, o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco se acepta la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. Los marcadores `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La comparación se hace sobre el sufijo del dominio de almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que eso **no** amplía es el espacio de nombres en sí: el sufijo sigue teniendo que ser uno de los listados. diff --git a/es/development/comfy-router/models/openai/gpt-image-2/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2/code.mdx index 54374cf25e..5e8a9afe48 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -191,7 +191,7 @@ DOS AMPLIACIONES SE ESTÁN IMPLEMENTANDO Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO La PRIMERA es el bucket en el que `POST /customers/storage` firma tu carga. Hasta que la implementación llegue a tu entorno, una URL de carga de ese endpoint se rechaza aquí, aunque el bucket sea propio de Comfy y el host sea el mismo: por eso «subir a Comfy y luego pasar la URL» NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. La SEGUNDA se HABILITA POR CUENTA y no para todos a la vez, porque el bucket detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta que no tenga habilitados los medios entrantes de terceros se rechaza, y el mensaje lo dice con esas palabras en lugar de decir que el host no es compatible. Pide a tu contacto de Comfy que lo habilite para tu cuenta. Además, admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, tanto en la forma de estilo de ruta como con el prefijo `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Esos son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un disparador de Alibaba Function Compute, no está en la lista y se rechaza. LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR: por eso, nombrar un proveedor arriba NO significa que se acepte cualquier URL que ese proveedor pueda emitir, y vale la pena enunciar directamente tres casos que se le parecen, porque quien llama puede llegar razonablemente con cada uno de ellos. Un DOMINIO PERSONALIZADO DE R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un hostname de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su hostname que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: prefirma el endpoint `.r2.cloudflarestorage.com` o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes de vuelta nombra estas mismas formas, así que no tienes que venir aquí a leerlas. -Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo de dominio del almacenamiento de objetos, así que un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`) también es válido. Lo que NO se amplía con eso es el propio espacio de nombres: el sufijo debe seguir siendo uno de los enumerados. +Los marcadores de posición `` y `pub-` de arriba muestran la forma con la que normalmente llegarás; no son una restricción de profundidad. La coincidencia se hace sobre el sufijo de dominio del almacenamiento de objetos, así que un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`) también es válido. Lo que NO se amplía con eso es el propio espacio de nombres: el sufijo debe seguir siendo uno de los enumerados. El ejemplo de abajo muestra solo la forma: un valor real también incluye los parámetros de consulta de firma, que se omiten aquí a propósito porque un ejemplo publicado permanece en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. Cada imagen está limitada a 25 MiB y el total de las imágenes de una solicitud, a 64 MiB. La única excepción es ideogram/ideogram-4-5 Precise Edit (una llamada que envía `image`), donde `context_window` está disponible: ahí cada imagen puede llegar a 50 MB (50.000.000 bytes) y 67.108.864 píxeles, y el total de las imágenes de una solicitud hasta 128 MiB. diff --git a/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx b/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx index e586e1d3cb..b9c07bc3c0 100644 --- a/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx +++ b/es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx @@ -81,7 +81,8 @@ curl https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video \ -d "{\"duration\": 5, \"prompt\": \"The woman from the first image walks through the market from the video, humming the tune from the audio\", \"references\": [{\"type\":\"image\",\"url\":\"https://example.invalid/pika/character.png\"}], \"resolution\": \"480p\"}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/pika/pika-h3-flex-reference-to-video/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado una vez que esté listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida del resultado. diff --git a/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx b/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx index 74536f000a..9630145c25 100644 --- a/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx +++ b/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx @@ -81,7 +81,8 @@ curl https://api.comfy.org/v2/models/stability/sdxl-1.0-masking \ -d "{\"init_image\": \"https://storage.googleapis.com/example-bucket/source.png\", \"mask_image\": \"https://storage.googleapis.com/example-bucket/mask.png\", \"mask_source\": \"MASK_IMAGE_WHITE\", \"seed\": 12345, \"text_prompts\": [{\"text\":\"a lighthouse on a cliff at sunset, oil painting\"}]}" ``` - + + El mismo body, enviado a `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-masking/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index 14ac8e12c2..e8bf7d653c 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -96,7 +96,8 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-i2v \ -d "{\"input\": {\"prompt\":\"the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady\",\"media\":[{\"type\":\"first_frame\",\"url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}]}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/happyhorse-1.0-i2v/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index 09adfbf230..72703e5ead 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -96,7 +96,8 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v \ -d "{\"input\": {\"prompt\":\"character1 walks in from the left, turns to the camera and waves, plain orange backdrop\",\"media\":[{\"type\":\"reference_image\",\"url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}]}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index 613cee1b47..2a1af8130b 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -97,7 +97,8 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v \ -d "{\"input\": {\"prompt\":\"the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady\",\"media\":[{\"type\":\"first_frame\",\"url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}]}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. diff --git a/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index ec351dde14..f41771c618 100644 --- a/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -86,7 +86,8 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2v-preview \ -d "{\"input\": {\"prompt\":\"the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady\",\"img_url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/wan2.5-i2v-preview/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recopila cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) repasa el estado, la cancelación y la recopilación. diff --git a/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index b9b1a69a18..98d15e0e01 100644 --- a/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -86,7 +86,8 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v \ -d "{\"input\": {\"prompt\":\"the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady\",\"img_url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) repasa el estado, la cancelación y la recogida. diff --git a/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index 4d81e143e7..88d0d0fffe 100644 --- a/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -86,7 +86,8 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-r2v \ -d "{\"input\": {\"prompt\":\"character1 walks in from the left, turns to the camera and waves, plain orange backdrop\",\"reference_video_urls\":[\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/street_dancer.mp4\"]}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/wan2.6-r2v/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) repasa el estado, la cancelación y la recogida del resultado. diff --git a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 27eb9bf836..4ad515a647 100644 --- a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -97,7 +97,8 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v \ -d "{\"input\": {\"prompt\":\"the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady\",\"media\":[{\"type\":\"first_frame\",\"url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}]}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests`. El router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. diff --git a/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx b/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx index 2a187b0fad..fae34f1f06 100644 --- a/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx @@ -96,7 +96,8 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-videoedit \ -d "{\"input\": {\"prompt\":\"restyle the clip as a hand-drawn ink sketch, keep the dancer's movement unchanged\",\"media\":[{\"type\":\"video\",\"url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/street_dancer.mp4\"}]}, \"parameters\": {\"resolution\":\"720P\",\"audio_setting\":\"origin\"}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/wan2.7-videoedit/requests`. El router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. diff --git a/es/development/comfy-router/models/wan/wan3-0-video/code.mdx b/es/development/comfy-router/models/wan/wan3-0-video/code.mdx index b4005167f5..e612e81f0d 100644 --- a/es/development/comfy-router/models/wan/wan3-0-video/code.mdx +++ b/es/development/comfy-router/models/wan/wan3-0-video/code.mdx @@ -97,7 +97,8 @@ curl https://api.comfy.org/v2/models/wan/wan3.0-video \ -d "{\"input\": {\"prompt\":\"the robot lowers its raised arm and steps toward the camera, the flat orange backdrop holds steady\",\"media\":[{\"type\":\"first_frame\",\"url\":\"https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png\"}]}, \"parameters\": {\"resolution\":\"720P\",\"duration\":5}}" ``` - + + El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/wan/wan3.0-video/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index f1ea6107f5..e0e4849b5d 100644 --- a/es/development/comfy-router/reference.mdx +++ b/es/development/comfy-router/reference.mdx @@ -563,7 +563,7 @@ La entrada JSON nativa del modelo del socio, idéntica al cuerpo que la ruta sin Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` - + Inspecciona `X-Comfy-Error-Type`: `concurrency_limit_exceeded` significa que la llamada original sigue en ejecución, así que espera `Retry-After` y reutiliza la misma clave; `invalid_input` requiere una clave nueva. Dos conflictos `invalid_input` en esta ruta no tienen nada que ver con la clave y ninguna clave nueva resuelve ninguno de los dos: `model_provider` que nombra un proveedor alternativo se rechaza cuando el cuerpo de la solicitud selecciona una operación multipart (una edición) que el traductor de ese proveedor para este modelo no puede atender, cuyo `detail` comienza con "this request's `image` selects the edit operation"; y, comprobado después de eso, cuando la solicitud ya resolvió una credencial bring-your-own-key para el proveedor de la ruta, cuyo `detail` comienza con `this request resolved a BYOK credential`. Quita `model_provider`, o envía la solicitud sin la credencial BYOK y (para el caso multipart) sin la edición. Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (cuando es `concurrency_limit_exceeded`) diff --git a/es/development/deploy/cloud-custom-builds.mdx b/es/development/deploy/cloud-custom-builds.mdx index 37b2006768..f0b003dd44 100644 --- a/es/development/deploy/cloud-custom-builds.mdx +++ b/es/development/deploy/cloud-custom-builds.mdx @@ -17,7 +17,7 @@ Un Build empaqueta tus Nodos Personalizados, tus Nodos Personalizados privados, Un despliegue de tu Build también te da workers de GPU que atienden únicamente tus flujos de trabajo, incluso cuando Comfy Cloud ya admite todos los nodos que contienen. - Para usar tu propio LoRA u otro modelo con nodos que Comfy Cloud ya admite, no necesitas un Build. En su lugar, sube el modelo a tu **Biblioteca de modelos**. Consulta [Agrega tu propio LoRA o modelo](#add-your-own-lora-or-model). + Para usar tu propio LoRA u otro modelo con nodos que Comfy Cloud ya admite, no necesitas un Build. En su lugar, sube el modelo a tu **Biblioteca de modelos**. Consulta [Agrega tu propio LoRA o modelo](#agregar-tu-propio-lora-o-modelo). ### Requisitos previos @@ -28,7 +28,7 @@ Antes de crear un Build, asegúrate de tener lo siguiente: - **Una suscripción activa o un saldo de créditos de Comfy superior a cero** - Crear o mantener un Build no tiene costo. Un despliegue consume tiempo de GPU mientras haya una GPU activa para él. También consume almacenamiento mientras el despliegue exista, incluso mientras esté detenido o no haya ninguna GPU activa. El cuadro de diálogo de despliegue muestra el costo estimado antes de que confirmes. Para dejar de pagar, elimina el despliegue. Consulta [Detén o elimina tu despliegue](#stop-or-delete-your-deployment). + Crear o mantener un Build no tiene costo. Un despliegue consume tiempo de GPU mientras haya una GPU activa para él. También consume almacenamiento mientras el despliegue exista, incluso mientras esté detenido o no haya ninguna GPU activa. El cuadro de diálogo de despliegue muestra el costo estimado antes de que confirmes. Para dejar de pagar, elimina el despliegue. Consulta [Detén o elimina tu despliegue](#detener-o-eliminar-tu-despliegue). ## Crear una Build desde tu flujo de trabajo @@ -195,7 +195,7 @@ Sigue estas reglas para que un trabajo encuentre tu modelo: ### Cambiar o eliminar un modelo de la biblioteca -Cuando hay un despliegue seleccionado en **Run on**, la **Biblioteca de modelos** solo lista los modelos del Build. Para cambiar o eliminar un modelo que subiste, primero [vuelve a Comfy Cloud](#deploy-and-run-your-workflow) y luego, en la **barra lateral izquierda**, haz clic en **Biblioteca de modelos**. +Cuando hay un despliegue seleccionado en **Run on**, la **Biblioteca de modelos** solo lista los modelos del Build. Para cambiar o eliminar un modelo que subiste, primero [vuelve a Comfy Cloud](#desplegar-y-ejecutar-tu-flujo-de-trabajo) y luego, en la **barra lateral izquierda**, haz clic en **Biblioteca de modelos**. Para cambiar el tipo de modelo: @@ -247,7 +247,7 @@ La próxima vez que abras el editor en este navegador, el editor ejecutará tus ## Próximos pasos - + Sube un modelo desde una terminal y selecciónalo en cada solicitud con `lora_name`. diff --git a/ja/development/deploy/cloud-custom-builds.mdx b/ja/development/deploy/cloud-custom-builds.mdx index a4523249f5..dd0f516c5c 100644 --- a/ja/development/deploy/cloud-custom-builds.mdx +++ b/ja/development/deploy/cloud-custom-builds.mdx @@ -247,7 +247,7 @@ Comfy Cloud エディタまたは開発者プラットフォームからアッ ## 次のステップ - + ターミナルからモデルをアップロードし、リクエストごとに `lora_name` で指定します。 diff --git a/ko/development/deploy/cloud-custom-builds.mdx b/ko/development/deploy/cloud-custom-builds.mdx index dc98bd92b6..bbb39bd23b 100644 --- a/ko/development/deploy/cloud-custom-builds.mdx +++ b/ko/development/deploy/cloud-custom-builds.mdx @@ -251,7 +251,7 @@ Comfy Cloud 편집기 또는 개발자 플랫폼에서 업로드할 수 있습 ## 다음 단계 - + 터미널에서 모델을 업로드하고 요청마다 `lora_name`으로 선택하세요. diff --git a/zh/development/deploy/cloud-custom-builds.mdx b/zh/development/deploy/cloud-custom-builds.mdx index a58e110841..2de266943e 100644 --- a/zh/development/deploy/cloud-custom-builds.mdx +++ b/zh/development/deploy/cloud-custom-builds.mdx @@ -247,7 +247,7 @@ translationBlockHashes: ## 后续步骤 - + 从终端上传模型,并在每次请求中通过 `lora_name` 选择该模型。 From 02224be0f84707a666e004a8778197df4db8e1cb Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Sun, 15 Nov 2026 11:02:27 +0800 Subject: [PATCH 33/36] i18n: refresh the FLUX 3 Klein translation hashes after #2355 The translations for the layout prompt node note already landed with the English change; only the frontmatter hashes were stale. --- es/tutorials/flux/flux-3-klein.mdx | 6 +++--- ja/tutorials/flux/flux-3-klein.mdx | 6 +++--- ko/tutorials/flux/flux-3-klein.mdx | 6 +++--- zh/tutorials/flux/flux-3-klein.mdx | 6 +++--- 4 files changed, 12 insertions(+), 12 deletions(-) diff --git a/es/tutorials/flux/flux-3-klein.mdx b/es/tutorials/flux/flux-3-klein.mdx index b9e5cdcf86..58fdb084da 100644 --- a/es/tutorials/flux/flux-3-klein.mdx +++ b/es/tutorials/flux/flux-3-klein.mdx @@ -2,14 +2,14 @@ title: "FLUX 3 Image Klein en ComfyUI: texto a imagen y edición" description: "Ejecuta FLUX.3 [klein] en local en ComfyUI: texto a imagen con pesos abiertos y edición por instrucciones, con un checkpoint destilado para 4–16 pasos." sidebarTitle: "FLUX 3 Klein" -translationSourceHash: 7cedfbb4 +translationSourceHash: c5a53c73 translationFrom: tutorials/flux/flux-3-klein.mdx translationBlockHashes: "_intro": 3e9c5a21 "About FLUX.3 [klein]": 1d7659ce - "FLUX 3 Image Klein Workflows": d0941358 + "FLUX 3 Image Klein Workflows": 1c646d35 "FLUX 3 Image Klein Model Downloads": 0170574c - "Prompting and reference tips": 43ad4a36 + "Prompting and reference tips": 55438f73 --- import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx' diff --git a/ja/tutorials/flux/flux-3-klein.mdx b/ja/tutorials/flux/flux-3-klein.mdx index 9e992b586a..acadfb15e6 100644 --- a/ja/tutorials/flux/flux-3-klein.mdx +++ b/ja/tutorials/flux/flux-3-klein.mdx @@ -2,14 +2,14 @@ title: "FLUX 3 Image Klein ComfyUI ガイド" description: "ComfyUI で FLUX.3 [klein] をローカル実行: オープンウェイトのテキストから画像生成と指示による画像編集。4〜16 ステップの蒸留版にも対応。" sidebarTitle: "FLUX 3 Klein" -translationSourceHash: 7cedfbb4 +translationSourceHash: c5a53c73 translationFrom: tutorials/flux/flux-3-klein.mdx translationBlockHashes: "_intro": 3e9c5a21 "About FLUX.3 [klein]": 1d7659ce - "FLUX 3 Image Klein Workflows": d0941358 + "FLUX 3 Image Klein Workflows": 1c646d35 "FLUX 3 Image Klein Model Downloads": 0170574c - "Prompting and reference tips": 43ad4a36 + "Prompting and reference tips": 55438f73 --- import UpdateReminder from "/snippets/ja/tutorials/update-reminder.mdx" diff --git a/ko/tutorials/flux/flux-3-klein.mdx b/ko/tutorials/flux/flux-3-klein.mdx index b79ffac11c..b7a6fec0a0 100644 --- a/ko/tutorials/flux/flux-3-klein.mdx +++ b/ko/tutorials/flux/flux-3-klein.mdx @@ -2,14 +2,14 @@ title: "FLUX 3 Image Klein ComfyUI 가이드" description: "ComfyUI에서 FLUX.3 [klein]을 로컬로 실행: 오픈 웨이트 텍스트 기반 이미지 생성과 지시 기반 이미지 편집, 4~16스텝 증류판 포함." sidebarTitle: "FLUX 3 Klein" -translationSourceHash: 7cedfbb4 +translationSourceHash: c5a53c73 translationFrom: tutorials/flux/flux-3-klein.mdx translationBlockHashes: "_intro": 3e9c5a21 "About FLUX.3 [klein]": 1d7659ce - "FLUX 3 Image Klein Workflows": d0941358 + "FLUX 3 Image Klein Workflows": 1c646d35 "FLUX 3 Image Klein Model Downloads": 0170574c - "Prompting and reference tips": 43ad4a36 + "Prompting and reference tips": 55438f73 --- import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" diff --git a/zh/tutorials/flux/flux-3-klein.mdx b/zh/tutorials/flux/flux-3-klein.mdx index 71241a6a40..2574baa123 100644 --- a/zh/tutorials/flux/flux-3-klein.mdx +++ b/zh/tutorials/flux/flux-3-klein.mdx @@ -2,14 +2,14 @@ title: "FLUX 3 Image Klein ComfyUI 指南" description: "在 ComfyUI 本地运行 FLUX.3 [klein]:开源权重文生图与指令驱动图像编辑,并提供 4–16 步的蒸馏版快速采样。" sidebarTitle: "FLUX 3 Klein" -translationSourceHash: 7cedfbb4 +translationSourceHash: c5a53c73 translationFrom: tutorials/flux/flux-3-klein.mdx translationBlockHashes: "_intro": 3e9c5a21 "About FLUX.3 [klein]": 1d7659ce - "FLUX 3 Image Klein Workflows": d0941358 + "FLUX 3 Image Klein Workflows": 1c646d35 "FLUX 3 Image Klein Model Downloads": 0170574c - "Prompting and reference tips": 43ad4a36 + "Prompting and reference tips": 55438f73 --- import UpdateReminder from "/snippets/zh/tutorials/update-reminder.mdx" From 5c769c87bc8acb5072affb2b54cef5da6f53f6a0 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Sun, 15 Nov 2026 11:08:08 +0800 Subject: [PATCH 34/36] i18n(es): move inline field bodies off the ParamField tag line mint-checks rejects a field whose body starts on the opening tag line and continues on the next, so twelve Router code pages now follow the English one-line-per-tag shape. Formatting only, no wording change. --- .../models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx | 3 ++- .../models/byteplus/dreamina-seedance-2-0-mini/code.mdx | 3 ++- .../models/byteplus/seedance-1-0-pro-fast-251015/code.mdx | 3 ++- .../comfy-router/models/google/gemini-2-5-flash-image/code.mdx | 3 ++- .../comfy-router/models/google/gemini-nano-banana-2-1/code.mdx | 3 ++- .../comfy-router/models/google/nano-banana-2-lite/code.mdx | 3 ++- .../comfy-router/models/google/nano-banana-pro/code.mdx | 3 ++- .../comfy-router/models/kling/kling-v2-5-turbo/code.mdx | 3 ++- es/development/comfy-router/models/kling/kling-v3/code.mdx | 3 ++- .../comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx | 3 ++- .../comfy-router/models/veo/veo-3-1-generate-001/code.mdx | 3 ++- .../comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx | 3 ++- 12 files changed, 24 insertions(+), 12 deletions(-) diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 0a399209b6..f79b4cd84e 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -416,7 +416,8 @@ Generado a partir del esquema que el Router sirve en `GET /v2/models/byteplus/dr El mensaje de error -El ID de la tarea de generación de video + + El ID de la tarea de generación de video diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index d9c8755399..0054e84d9a 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -401,7 +401,8 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/dream El mensaje de error -El ID de la tarea de generación de video + + El ID de la tarea de generación de video diff --git a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 5a1cec39dd..5bd8ced8bc 100644 --- a/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -399,7 +399,8 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seeda Mensaje de error -El ID de la tarea de generación de video + + El ID de la tarea de generación de video diff --git a/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index b59cd0aafc..d9d8e37abf 100644 --- a/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/es/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -565,7 +565,8 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx b/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx index 1d752186be..ed343b992e 100644 --- a/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx +++ b/es/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx @@ -285,7 +285,8 @@ El valor predeterminado de `strict_mode` es `false`, así que Router traduce el - Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 diff --git a/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index 12f856dcca..23f0840697 100644 --- a/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -305,7 +305,8 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por ofrecer la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o las configuraciones de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 diff --git a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx index 63ef735851..885ea6eef3 100644 --- a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -321,7 +321,8 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot - Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo para proporcionar la misma respuesta en solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + + Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo para proporcionar la misma respuesta en solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 diff --git a/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index c0bf96c7af..791e965a07 100644 --- a/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -299,7 +299,8 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID true significa generar marca de agua, false significa no generarla. - Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, resolución no inferior a 300*300px, relación de aspecto entre 1:2.5 y 2.5:1. Base64 no debe incluir el prefijo data:image. + + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, resolución no inferior a 300*300px, relación de aspecto entre 1:2.5 y 2.5:1. Base64 no debe incluir el prefijo data:image. diff --git a/es/development/comfy-router/models/kling/kling-v3/code.mdx b/es/development/comfy-router/models/kling/kling-v3/code.mdx index c27081b252..4423786be3 100644 --- a/es/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v3/code.mdx @@ -313,7 +313,8 @@ Comfy Router presta este modelo directamente a menos que la solicitud indique ot true significa generar la marca de agua, false significa no generarla. - Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, la resolución no puede ser inferior a 300*300px, la relación de aspecto debe estar entre 1:2.5 ~ 2.5:1. Base64 no debe incluir el prefijo data:image. + + Imagen de referencia: URL o cadena codificada en Base64, no puede superar los 10MB, la resolución no puede ser inferior a 300*300px, la relación de aspecto debe estar entre 1:2.5 ~ 2.5:1. Base64 no debe incluir el prefijo data:image. diff --git a/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx b/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx index 92e2769c20..d1ba16acb8 100644 --- a/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx +++ b/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx @@ -334,7 +334,8 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ Duración objetivo del video generado en segundos. Veo 2: 5-8. Veo 3/3.1: 4, 6 u 8. Predeterminado: 8 - Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. + + Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. diff --git a/es/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx b/es/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx index 8df03c42a1..c6e60fc6a1 100644 --- a/es/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx +++ b/es/development/comfy-router/models/veo/veo-3-1-generate-001/code.mdx @@ -334,7 +334,8 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-generate-001/requests/$REQUEST_ Duración objetivo del video generado en segundos. Veo 2: 5-8. Veo 3/3.1: 4, 6 u 8. Predeterminado: 8 -Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. + + Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. diff --git a/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx b/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx index 6c4d7044ea..e7ca41eda8 100644 --- a/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx +++ b/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx @@ -334,7 +334,8 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ Duración objetivo del video generado en segundos. Veo 2: 5-8. Veo 3/3.1: 4, 6 u 8. Predeterminado: 8 -Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. + + Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. From bbc34e137de8fd8fb0c9d7259acff97a6204c823 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Sun, 15 Nov 2026 11:15:27 +0800 Subject: [PATCH 35/36] i18n(es): close the seed and functionDeclarations.name fields The seed field's body had drifted below its closing tag and the name field was missing its closer, so mint-checks could not parse the page. --- .../comfy-router/models/google/gemini-3-7-flash/code.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index 6bc63b8bcb..d69b09cb64 100644 --- a/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -275,8 +275,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - - Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por proporcionar la misma respuesta a solicitudes repetidas. La salida determinista no está garantizada. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + Cuando la semilla se fija a un valor específico, el modelo hace su mejor esfuerzo por proporcionar la misma respuesta a solicitudes repetidas. La salida determinista no está garantizada. Además, cambiar el modelo o la configuración de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada, se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -369,6 +368,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a + Esquema JSON para los parámetros de la función From f4e87db5b1e599324427d76fb264b0c818efc503 Mon Sep 17 00:00:00 2001 From: daxiong Date: Sun, 15 Nov 2026 14:20:20 +0800 Subject: [PATCH 36/36] i18n: repair the zh/ja/ko/es pages that drifted from the English source Verified every localized page in the sync against its English source and fixed the drift: live values that had been translated (enums, booleans, schema types, dotted model ids rewritten with hyphens), field bodies collapsed to a sentence or left in English, English tails pasted onto translated text, caveats closed outside their ParamField, bullets merged onto one line, invented or duplicated paragraphs, and a MiniMax bullet missing from the GPT Image serving-provider lists. Also drops the four library-models and four seedance-1-5-pro-251215 pages, whose English sources no longer exist (folded into deploy/cloud-custom-builds and pruned upstream), with matching docs.json nav removal and locale redirects. Gates: check-anchors --only-changed, validate-links, structure-parity --base origin/main and sync-hash --dry-run all pass. --- docs.json | 36 +- es/development/comfy-router/limitations.mdx | 4 +- es/development/comfy-router/models.mdx | 18 +- .../dreamina-seedance-2-0-260128/code.mdx | 13 +- .../code.mdx | 3 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 483 ----------------- .../byteplus/seedream-4-0-250828/code.mdx | 12 +- .../byteplus/seedream-5-0-260128/code.mdx | 7 +- .../seedream-5-0-flash-260915/code.mdx | 5 +- .../byteplus/seedream-5-0-pro-260628/code.mdx | 2 +- .../byteplus/seedream-5-5-261028/code.mdx | 3 +- .../google/gemini-3-1-flash-lite/code.mdx | 2 +- .../models/google/gemini-3-7-flash/code.mdx | 2 +- .../models/google/gemini-4-argon/code.mdx | 4 +- .../models/google/gemini-4-carbon/code.mdx | 20 +- .../models/google/gemini/code.mdx | 8 +- .../models/google/nano-banana-2-lite/code.mdx | 14 +- .../models/google/nano-banana-2/code.mdx | 2 +- .../models/google/nano-banana-pro/code.mdx | 2 +- .../models/kling/kling-v3/code.mdx | 4 +- .../models/ltx/ltx-video-alpha-gen/code.mdx | 2 +- .../models/meshy/rigging/code.mdx | 2 +- .../minimax-h3-image-highspeed/code.mdx | 6 +- .../openai/gpt-image-2-5-sunburst/code.mdx | 5 +- .../openai/gpt-image-2-6-flare/code.mdx | 4 +- .../openai/gpt-image-2-6-sunburst/code.mdx | 6 +- .../models/pixverse/v6-max/code.mdx | 2 - .../models/stability/control-sketch/code.mdx | 2 +- .../stability/edit-remove-background/code.mdx | 2 +- .../stability/sdxl-1-0-masking/code.mdx | 6 +- .../models/stability/stable-fast-3d/code.mdx | 2 - .../veo/veo-3-1-fast-generate-001/code.mdx | 8 +- .../veo/veo-3-1-lite-generate-001/code.mdx | 6 +- .../models/wan/happyhorse-1-0-i2v/code.mdx | 8 +- .../models/wan/happyhorse-1-0-r2v/code.mdx | 6 +- .../models/wan/happyhorse-1-0-t2v/code.mdx | 10 +- .../wan/happyhorse-1-0-video-edit/code.mdx | 7 +- .../models/wan/happyhorse-1-1-i2v/code.mdx | 4 +- .../models/wan/happyhorse-1-1-r2v/code.mdx | 4 +- .../models/wan/happyhorse-1-1-t2v/code.mdx | 4 +- .../models/wan/wan2-5-i2v-preview/code.mdx | 17 +- .../models/wan/wan2-5-t2i-preview/code.mdx | 2 +- .../models/wan/wan2-5-t2v-preview/code.mdx | 6 +- .../models/wan/wan2-6-i2v/code.mdx | 6 +- .../models/wan/wan2-6-r2v/code.mdx | 4 +- .../models/wan/wan2-6-t2v/code.mdx | 8 +- .../models/wan/wan2-7-i2v/code.mdx | 8 +- .../models/wan/wan2-7-r2v/code.mdx | 15 +- .../models/wan/wan2-7-t2v/code.mdx | 4 +- .../models/wan/wan2-7-videoedit/code.mdx | 4 +- .../models/wan/wan3-0-video-prime/code.mdx | 14 +- .../models/wan/wan3-0-video/code.mdx | 19 +- es/development/comfy-router/reference.mdx | 47 +- es/development/serverless/library-models.mdx | 171 ------ es/development/serverless/overview.mdx | 2 +- es/tutorials/video/ltx/ltx-2-3.mdx | 10 +- ja/development/comfy-router/limitations.mdx | 4 +- ja/development/comfy-router/models.mdx | 18 +- .../models/anthropic/claude-opus-4-8/code.mdx | 2 +- .../dreamina-seedance-2-0-260128/code.mdx | 26 +- .../dreamina-seedance-2-0-mini/code.mdx | 9 +- .../dreamina-seedance-2-5-260628/code.mdx | 2 + .../byteplus/seedance-1-0-pro-250528/code.mdx | 14 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 489 ------------------ .../byteplus/seedream-4-0-250828/code.mdx | 2 +- .../byteplus/seedream-4-5-251128/code.mdx | 2 +- .../byteplus/seedream-5-0-260128/code.mdx | 4 +- .../byteplus/seedream-5-0-pro-260628/code.mdx | 5 +- .../byteplus/seedream-5-5-261028/code.mdx | 3 +- .../google/gemini-2-5-flash-image/code.mdx | 16 +- .../google/gemini-3-1-flash-lite/code.mdx | 10 +- .../models/google/gemini-4-argon/code.mdx | 2 +- .../models/google/gemini-4-carbon/code.mdx | 10 +- .../models/google/gemini-4-hydrogen/code.mdx | 2 +- .../google/gemini-nano-banana-2-1/code.mdx | 10 +- .../models/google/nano-banana-2-lite/code.mdx | 6 +- .../models/google/nano-banana-2/code.mdx | 2 - .../models/google/nano-banana-pro/code.mdx | 2 +- .../models/kling/kling-v2-6/code.mdx | 9 +- .../models/kling/kling-v3/code.mdx | 5 +- .../comfy-router/models/krea/krea-2/code.mdx | 2 +- .../comfy-router/models/krea/krea-3/code.mdx | 2 +- .../models/ltx/ltx-video-alpha-gen/code.mdx | 6 +- .../models/openai/gpt-image-1-5/code.mdx | 2 +- .../openai/gpt-image-2-5-flare/code.mdx | 1 + .../openai/gpt-image-2-5-sunburst/code.mdx | 1 + .../openai/gpt-image-2-6-flare/code.mdx | 6 +- .../openai/gpt-image-2-6-sunburst/code.mdx | 4 +- .../models/wan/happyhorse-1-0-i2v/code.mdx | 2 +- .../models/wan/happyhorse-1-0-r2v/code.mdx | 2 +- .../models/wan/happyhorse-1-0-t2v/code.mdx | 4 +- .../wan/happyhorse-1-0-video-edit/code.mdx | 3 +- .../models/wan/happyhorse-1-1-i2v/code.mdx | 2 +- .../models/wan/happyhorse-1-1-r2v/code.mdx | 5 +- .../models/wan/happyhorse-1-1-t2v/code.mdx | 7 +- .../models/wan/wan2-5-i2v-preview/code.mdx | 2 +- .../models/wan/wan2-5-t2v-preview/code.mdx | 5 +- .../models/wan/wan2-6-i2v/code.mdx | 4 +- .../models/wan/wan2-6-r2v/code.mdx | 2 +- .../models/wan/wan2-6-t2v/code.mdx | 2 +- .../models/wan/wan2-7-i2v/code.mdx | 6 +- .../models/wan/wan2-7-r2v/code.mdx | 6 +- .../models/wan/wan2-7-t2v/code.mdx | 6 +- .../models/wan/wan2-7-videoedit/code.mdx | 5 +- .../models/wan/wan3-0-video-prime/code.mdx | 5 +- .../models/wan/wan3-0-video/code.mdx | 6 +- ja/development/comfy-router/reference.mdx | 32 +- ja/development/serverless/library-models.mdx | 171 ------ ja/tutorials/flux/flux-3-klein.mdx | 14 +- ja/tutorials/video/ltx/ltx-2-3.mdx | 6 +- ko/development/comfy-router/models.mdx | 15 +- .../models/anthropic/claude-opus-4-6/code.mdx | 2 +- .../dreamina-seedance-2-0-260128/code.mdx | 5 +- .../dreamina-seedance-2-0-mini/code.mdx | 3 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 2 +- .../seedance-1-0-pro-fast-251015/code.mdx | 2 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 487 ----------------- .../byteplus/seedream-4-0-250828/code.mdx | 4 +- .../byteplus/seedream-5-0-260128/code.mdx | 4 +- .../byteplus/seedream-5-0-pro-260628/code.mdx | 3 +- .../byteplus/seedream-5-5-261028/code.mdx | 5 +- .../google/gemini-2-5-flash-image/code.mdx | 10 +- .../google/gemini-3-1-flash-lite/code.mdx | 2 +- .../models/google/gemini-3-7-flash/code.mdx | 4 +- .../models/google/gemini-4-argon/code.mdx | 4 +- .../models/google/gemini-4-hydrogen/code.mdx | 4 +- .../models/google/nano-banana-2-lite/code.mdx | 4 +- .../models/google/nano-banana-2/code.mdx | 10 +- .../models/google/nano-banana-pro/code.mdx | 4 +- .../models/kling/kling-v2-6/code.mdx | 2 +- .../models/meshy/rigging/code.mdx | 4 +- .../minimax-h3-image-highspeed/code.mdx | 2 +- .../models/openai/gpt-image-1-5/code.mdx | 2 +- .../openai/gpt-image-2-5-flare/code.mdx | 1 + .../openai/gpt-image-2-5-sunburst/code.mdx | 3 +- .../openai/gpt-image-2-6-flare/code.mdx | 6 +- .../openai/gpt-image-2-6-sunburst/code.mdx | 9 +- .../models/openai/gpt-image-2/code.mdx | 4 +- .../models/wan/happyhorse-1-0-i2v/code.mdx | 5 +- .../models/wan/happyhorse-1-0-r2v/code.mdx | 4 +- .../models/wan/happyhorse-1-0-t2v/code.mdx | 4 +- .../wan/happyhorse-1-0-video-edit/code.mdx | 4 +- .../models/wan/happyhorse-1-1-i2v/code.mdx | 6 +- .../models/wan/happyhorse-1-1-r2v/code.mdx | 8 +- .../models/wan/happyhorse-1-1-t2v/code.mdx | 8 +- .../models/wan/wan2-5-i2v-preview/code.mdx | 6 +- .../models/wan/wan2-5-t2v-preview/code.mdx | 6 +- .../models/wan/wan2-6-i2v/code.mdx | 4 +- .../models/wan/wan2-6-r2v/code.mdx | 4 +- .../models/wan/wan2-6-t2v/code.mdx | 8 +- .../models/wan/wan2-7-i2v/code.mdx | 6 +- .../models/wan/wan2-7-r2v/code.mdx | 4 +- .../models/wan/wan2-7-t2v/code.mdx | 10 +- .../models/wan/wan3-0-video-prime/code.mdx | 8 +- ko/development/comfy-router/reference.mdx | 32 +- ko/development/deploy/cloud-custom-builds.mdx | 6 +- ko/development/serverless/library-models.mdx | 171 ------ ko/tutorials/flux/flux-3-klein.mdx | 6 +- .../partner-nodes/pika/pika-h3-flex.mdx | 2 +- ko/tutorials/video/ltx/ltx-2-3.mdx | 86 +-- zh/development/comfy-router/limitations.mdx | 4 +- zh/development/comfy-router/models.mdx | 15 +- .../dreamina-seedance-2-0-260128/code.mdx | 12 +- .../code.mdx | 23 +- .../byteplus/seedance-1-0-pro-250528/code.mdx | 6 +- .../seedance-1-0-pro-fast-251015/code.mdx | 3 +- .../byteplus/seedance-1-5-pro-251215/code.mdx | 485 ----------------- .../byteplus/seedream-4-0-250828/code.mdx | 2 + .../byteplus/seedream-4-5-251128/code.mdx | 8 +- .../byteplus/seedream-5-0-260128/code.mdx | 4 +- .../seedream-5-0-flash-260915/code.mdx | 2 +- .../byteplus/seedream-5-0-pro-260628/code.mdx | 5 +- .../byteplus/seedream-5-5-261028/code.mdx | 3 +- .../google/gemini-3-1-flash-lite/code.mdx | 13 +- .../models/google/gemini-3-7-flash/code.mdx | 4 +- .../models/google/gemini-4-argon/code.mdx | 14 +- .../models/google/gemini-4-carbon/code.mdx | 6 +- .../models/google/gemini-4-hydrogen/code.mdx | 13 +- .../models/google/nano-banana-2-lite/code.mdx | 6 +- .../models/google/nano-banana-2/code.mdx | 12 +- .../models/google/nano-banana-pro/code.mdx | 8 +- .../models/kling/kling-v2-5-turbo/code.mdx | 2 +- .../models/kling/kling-video-o1/code.mdx | 6 +- .../ltx/ltx-video-to-video-reframe/code.mdx | 14 +- .../models/ltx/ltx-video-upscale/code.mdx | 6 +- .../models/minimax/minimax-h3-image/code.mdx | 4 +- .../openai/gpt-image-2-5-flare/code.mdx | 1 + .../openai/gpt-image-2-5-sunburst/code.mdx | 5 +- .../openai/gpt-image-2-6-flare/code.mdx | 4 +- .../openai/gpt-image-2-6-sunburst/code.mdx | 7 +- .../models/openai/gpt-image-2/code.mdx | 4 +- .../comfy-router/models/pixverse/v6/code.mdx | 2 - .../veo/veo-3-1-fast-generate-001/code.mdx | 10 +- .../models/wan/happyhorse-1-0-i2v/code.mdx | 2 +- .../models/wan/happyhorse-1-0-r2v/code.mdx | 4 +- .../models/wan/happyhorse-1-0-t2v/code.mdx | 2 +- .../wan/happyhorse-1-0-video-edit/code.mdx | 2 +- .../models/wan/happyhorse-1-1-i2v/code.mdx | 5 +- .../models/wan/happyhorse-1-1-r2v/code.mdx | 5 +- .../models/wan/happyhorse-1-1-t2v/code.mdx | 4 +- .../models/wan/wan2-5-i2i-preview/code.mdx | 2 +- .../models/wan/wan2-5-i2v-preview/code.mdx | 6 +- .../models/wan/wan2-5-t2v-preview/code.mdx | 4 +- .../models/wan/wan2-6-i2v/code.mdx | 5 +- .../models/wan/wan2-6-r2v/code.mdx | 2 +- .../models/wan/wan2-6-t2v/code.mdx | 2 +- .../models/wan/wan2-7-i2v/code.mdx | 2 +- .../models/wan/wan2-7-r2v/code.mdx | 6 +- .../models/wan/wan2-7-t2v/code.mdx | 2 +- .../models/wan/wan3-0-video-prime/code.mdx | 4 +- zh/development/comfy-router/reference.mdx | 66 +-- zh/development/serverless/library-models.mdx | 171 ------ zh/development/serverless/overview.mdx | 2 +- zh/tutorials/flux/flux-3-klein.mdx | 8 +- zh/tutorials/video/ltx/ltx-2-3.mdx | 4 +- 215 files changed, 736 insertions(+), 3344 deletions(-) delete mode 100644 es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx delete mode 100644 es/development/serverless/library-models.mdx delete mode 100644 ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx delete mode 100644 ja/development/serverless/library-models.mdx delete mode 100644 ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx delete mode 100644 ko/development/serverless/library-models.mdx delete mode 100644 zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx delete mode 100644 zh/development/serverless/library-models.mdx diff --git a/docs.json b/docs.json index eab2a011ab..057269edf9 100644 --- a/docs.json +++ b/docs.json @@ -7848,7 +7848,6 @@ "zh/development/comfy-router/models/byteplus/seed-audio-1-0/code", "zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code", "zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code", - "zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", "zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code", "zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code", "zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code", @@ -12057,7 +12056,6 @@ "ja/development/comfy-router/models/byteplus/seed-audio-1-0/code", "ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code", "ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code", - "ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", "ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code", "ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code", "ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code", @@ -16196,7 +16194,6 @@ "ko/development/comfy-router/models/byteplus/seed-audio-1-0/code", "ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code", "ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code", - "ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", "ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code", "ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code", "ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code", @@ -18034,7 +18031,6 @@ "es/development/comfy-router/models/byteplus/seed-audio-1-0/code", "es/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code", "es/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code", - "es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", "es/development/comfy-router/models/byteplus/seedream-4-0-250828/code", "es/development/comfy-router/models/byteplus/seedream-4-5-251128/code", "es/development/comfy-router/models/byteplus/seedream-5-0-260128/code", @@ -20999,6 +20995,22 @@ "source": "/development/serverless/library-models", "destination": "/development/deploy/cloud-custom-builds#add-your-own-lora-or-model" }, + { + "source": "/zh/development/serverless/library-models", + "destination": "/zh/development/deploy/cloud-custom-builds" + }, + { + "source": "/ja/development/serverless/library-models", + "destination": "/ja/development/deploy/cloud-custom-builds" + }, + { + "source": "/ko/development/serverless/library-models", + "destination": "/ko/development/deploy/cloud-custom-builds" + }, + { + "source": "/es/development/serverless/library-models", + "destination": "/es/development/deploy/cloud-custom-builds" + }, { "source": "/custom-nodes/tips", "destination": "/custom-nodes/overview" @@ -22606,6 +22618,22 @@ { "source": "/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", "destination": "/development/comfy-router/models" + }, + { + "source": "/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", + "destination": "/zh/development/comfy-router/models" + }, + { + "source": "/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", + "destination": "/ja/development/comfy-router/models" + }, + { + "source": "/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", + "destination": "/ko/development/comfy-router/models" + }, + { + "source": "/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code", + "destination": "/es/development/comfy-router/models" } ], "search": { diff --git a/es/development/comfy-router/limitations.mdx b/es/development/comfy-router/limitations.mdx index 5629130e31..eaf719c9cb 100644 --- a/es/development/comfy-router/limitations.mdx +++ b/es/development/comfy-router/limitations.mdx @@ -152,7 +152,9 @@ En `image_urls` de `krea/krea-3`, un `image_url` devuelto por `POST /proxy/krea/ Router solo lee los primeros 2 MiB de cada referencia para encontrar su tamaño, así que una imagen cuya información de tamaño no puede terminar de leer dentro de esa ventana (por ejemplo, un JPEG que lleva más de 2 MiB de metadatos incrustados, o un PNG con paleta en el que los datos de transparencia, o si no tiene, el inicio de su primer fragmento de datos de imagen, quedan más allá de los 2 MiB, como después de más de 2 MiB de fragmentos de texto o de perfil de color) se rechaza con `400` indicando que su encabezado de tamaño no está dentro de los primeros 2 MiB, y volver a subirla no ayuda: primero vuelve a guardarla sin los metadatos grandes o guarda un PNG con paleta como un PNG sin paleta (color verdadero). Envía un nombre de host internacionalizado en su forma ASCII (punycode), por ejemplo `xn--bcher-kva.de` en lugar de `bücher.de`: Router busca el host tal como está escrito, y un nombre no ASCII se rechaza como un host que no existe. -Subir funciona en todos los entornos, así que es la opción portable; pasa siempre el `image_url` exactamente como lo devolvió la subida. Si tu imagen aún no está en una URL `https` pública, súbela primero:1. Sube cada imagen de referencia como `multipart/form-data`, con la imagen en el campo de formulario `file` (JPEG, PNG o WebP, hasta 75 MB). Autentica de la misma forma que en Router, con `X-API-Key` o `Authorization: Bearer`. +Subir funciona en todos los entornos, así que es la opción portable; pasa siempre el `image_url` exactamente como lo devolvió la subida. Si tu imagen aún no está en una URL `https` pública, súbela primero: + +1. Sube cada imagen de referencia como `multipart/form-data`, con la imagen en el campo de formulario `file` (JPEG, PNG o WebP, hasta 75 MB). Autentica de la misma forma que en Router, con `X-API-Key` o `Authorization: Bearer`. ```bash curl -X POST https://api.comfy.org/proxy/krea/assets \ diff --git a/es/development/comfy-router/models.mdx b/es/development/comfy-router/models.mdx index 98aed8290d..791aeaf409 100644 --- a/es/development/comfy-router/models.mdx +++ b/es/development/comfy-router/models.mdx @@ -107,7 +107,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Pika H3 Flex Text To Video](/es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika Soundtrack](/es/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` - [V3.5](/es/development/comfy-router/models/pixverse/v3-5/code): `pixverse/v3.5` -- [V6 Max](/es/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max`- [V6](/es/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` +- [V6 Max](/es/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max` +- [V6](/es/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` - [P Video 2](/es/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/es/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/es/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` @@ -164,7 +165,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Image Edit Erase Foreground](/es/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` - [Image Edit Erase](/es/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` - [Image Edit Expand](/es/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` -- [Image Edit Gen Fill](/es/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill`- [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` +- [Image Edit Gen Fill](/es/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` +- [Image Edit Increase Resolution](/es/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/es/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` - [Image Edit Relight](/es/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` @@ -213,7 +215,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT Image 1.5](/es/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/es/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` -- [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare`- [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` +- [GPT Image 2.6 Flare](/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare` +- [GPT Image 2.6 Sunburst](/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` - [GPT Image 2](/es/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Arrow 2 Telos](/es/development/comfy-router/models/quiver/arrow-2-telos/code): `quiver/arrow-2-telos` - [Arrow 2](/es/development/comfy-router/models/quiver/arrow-2/code): `quiver/arrow-2` @@ -263,7 +266,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Wan 2.5 T2I Preview](/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` - [Seedvr 2](/es/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` - [Ultimate Image Upscaler](/es/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` -- [Grok Imagine Image 2.0](/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0`- [Grok Imagine Image Pro](/es/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` +- [Grok Imagine Image 2.0](/es/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0` +- [Grok Imagine Image Pro](/es/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` - [Grok Imagine Image Quality](/es/development/comfy-router/models/xai/grok-imagine-image-quality/code): `xai/grok-imagine-image-quality` - [Grok Imagine Image](/es/development/comfy-router/models/xai/grok-imagine-image/code): `xai/grok-imagine-image` @@ -323,7 +327,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [Animations](/es/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/es/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` -- [Meshy 7.1](/es/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1`- [Meshy 7](/es/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` +- [Meshy 7.1](/es/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` +- [Meshy 7](/es/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` - [Remesh](/es/development/comfy-router/models/meshy/remesh/code): `meshy/remesh` - [Rigging](/es/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/es/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` @@ -378,7 +383,8 @@ Algunos de estos modelos también los puede servir un agregador en la misma ruta - [GPT 5 Nano](/es/development/comfy-router/models/openai/gpt-5-nano/code): `openai/gpt-5-nano` - [GPT 5](/es/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6.1 Sol](/es/development/comfy-router/models/openai/gpt-6-1-sol/code): `openai/gpt-6.1-sol` -- [GPT 6.1 Terra](/es/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra`- [GPT 6 Astra](/es/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` +- [GPT 6.1 Terra](/es/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra` +- [GPT 6 Astra](/es/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/es/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/es/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` - [o3](/es/development/comfy-router/models/openai/o3/code): `openai/o3` diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 8a9cf63d21..da1eb33edd 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -301,7 +301,8 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo produce un video con audio sincronizado. -false: el modelo produce un video silencioso.En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada de forma independiente del video: un rechazo ahí se informa como `content_policy_violation` y, dado que el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otras condiciones. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. +false: el modelo produce un video silencioso. +En los modelos que lo admiten, el proveedor verifica el contenido de la pista de audio generada de forma independiente del video: un rechazo ahí se informa como `content_policy_violation` y, dado que el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otras condiciones. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio era la modalidad rechazada, que una respuesta síncrona del Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false` en su lugar. @@ -315,7 +316,7 @@ edit: Modifica el video de referencia conectado. La salida conserva la duración extend: Continúa el video de referencia. La salida es solo el segmento recién generado, con la `duration` solicitada; su relación de aspecto sigue al clip. El proveedor valida un valor explícito al enviar (`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`), así que un valor que no encaja con la solicitud falla antes de que empiece la generación y no se factura; automático no tiene esa comprobación. Esa comprobación se ejecuta solo en la rama nativa de BytePlus: una rama de proveedor alternativo (en fallback, o elegida con `model_provider`) no tiene campo de tipo de tarea, descarta el valor, y ese proveedor infiere la tarea por sí mismo, igual que con automático. El descarte se declara en `X-Comfy-Router-Dropped-Params`, en la respuesta de la ruta de ejecución síncrona y en el `201` del envío en cola. La ruta en cola no tiene fallback, así que solo llega a una rama alternativa mediante `model_provider`. - Posibles valores: `reference`, `edit`, `extend` + Valores posibles: `reference`, `edit`, `extend` @@ -323,21 +324,21 @@ El proveedor valida un valor explícito al enviar (`InvalidParameter.TaskTypeCon mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño de archivo. mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para postproducción; mayor tamaño de archivo. - Posibles valores: `mp4`, `mov` + Valores posibles: `mp4`, `mov` Relación de aspecto del video generado. Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro predeterminada: adaptive. Seedance 2.5 con generación de primer fotograma / primer y último fotograma: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del despacho. Seedance 2.0 acepta una relación concreta en esos modos. - Posibles valores: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` Resolución del video. Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite predeterminada: 720p. Seedance 1.0 pro y pro-fast predeterminada: 1080p. Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. - Posibles valores: `480p`, `720p`, `1080p`, `4k` + Valores posibles: `480p`, `720p`, `1080p`, `4k` @@ -355,7 +356,7 @@ false: No devuelve la imagen del último fotograma del video generado. Nivel de servicio para el procesamiento. Seedance 2.5, 2.0 y 2.0 fast no admiten flex (inferencia sin conexión). - Posibles valores: `default`, `flex` + Valores posibles: `default`, `flex` diff --git a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index f79b4cd84e..925e8bffdc 100644 --- a/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -301,7 +301,8 @@ Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para rende Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video sin audio.En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona del Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. +false: el modelo genera un video sin audio. +En los modelos que lo admiten, el proveedor revisa el contenido de la pista de audio generada por separado del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta en otros casos. Envía `false` para obtener un video silencioso si eso ocurre; esto solo ayuda cuando el audio fue la modalidad rechazada, que una respuesta síncrona del Router identifica como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. diff --git a/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx deleted file mode 100644 index b79fce23c8..0000000000 --- a/es/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ /dev/null @@ -1,483 +0,0 @@ ---- -title: "Usa Seedance 1.5 Pro 251215 con Comfy Router" -description: "Llama a byteplus/seedance-1-5-pro-251215 mediante Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router." -sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 8c658f01 -translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx -translationBlockHashes: - "_intro": 5f93a1f1 - "Quick start": 71aafccf - "Schema": b9957cb9 - "Examples": 7e73ac5c ---- - -{/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-5-pro-251215.json by `pnpm code-pages:gen`. */} - -import RouterCodeFooter from "/snippets/es/comfy-router/model-code-footer.mdx"; - -Referencia de API para `byteplus/seedance-1-5-pro-251215`, que Comfy Router sirve desde BytePlus. - -**Entrada:** Texto, Imagen · **Salida:** Video + Audio - -## Inicio rápido - -Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada sobre HTTP directo. - -**ID del modelo:** `byteplus/seedance-1-5-pro-251215` - -**Endpoint:** `POST https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215` - - - - -```python Python -from comfy_sdk import Comfy - -# Lee COMFY_API_KEY del entorno. -# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. -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) -``` - -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; - -// Lee COMFY_API_KEY del entorno. -// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos. -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); -``` - -```bash cURL -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\"}" -``` - - - -El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests`. Router responde `201` con un `request_id` en cuanto acepta la ejecución, y recoges el resultado en cuanto está listo, desde este proceso o desde otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida del resultado. - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy - -# Lee COMFY_API_KEY del entorno. -# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. -async def main(): - async with AsyncComfy() as client: - handle = await 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) # junto con el ID del modelo, es todo lo que otro proceso necesita - - # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. - async for update in handle.iter_events(): - print(update.status, update.queue_position) - - # La carga útil propia del proveedor, el mismo valor que devuelve models.run(). - # Una solicitud que falló o se canceló lanza aquí el error tipado de Router. - result = await handle.get() - - print(result) - -asyncio.run(main()) -``` - -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; - -// Lee COMFY_API_KEY del entorno. -// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos. -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); // junto con el ID del modelo, es todo lo que otro proceso necesita - -// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor. -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); -} - -// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí. -const result = await handle.get(); - -console.log(result.data); -``` - -```bash cURL -# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url. -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. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta. -REQUEST_ID="" -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. Recoge el resultado. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución. -curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" -``` - - - - -## Esquema - -### Entrada - - - Ignorado. Se acepta por compatibilidad con la forma de solicitud de BytePlus, pero se elimina antes de enviar la tarea, así que nunca se envía ningún callback; consulta la ruta de estado de la tarea para obtener el resultado. - - Formato: `uri` - - - - El contenido de entrada que el modelo usará para generar un video - - - - Objeto de audio de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de audio. Seedance 2.0, 2.0 fast y 2.0 mini no pueden usar audio por sí solo: deben incluir al menos 1 imagen o video; Seedance 2.5 admite entrada solo de audio. - - - - URL de audio, codificación Base64 o ID de recurso. -URL de audio: URL pública del audio (wav, mp3). -Base64: formato data:audio/\;base64,\ -ID de recurso: formato asset://\ - - - - Solo Seedance 2.5. La tarea Draft que se renderizará como video final. Debe ser el único elemento de contenido. -El video final reutiliza el prompt, los recursos de entrada, la duración, la relación, la semilla, generate_audio y omni_reference_task_type de la tarea Draft; no los envíes de nuevo. Establece resolution en esta solicitud para el nivel de salida del video final, incluido 4k; cuando se omite, el video final es 1080p. - - - - El ID de tarea devuelto cuando se creó el video Draft con `draft` establecido en true. - - - - - - - - Contenido de imagen para la generación de imagen a video (cuando type es "image_url") -URL de imagen: asegúrate de que la URL de la imagen sea accesible. -Contenido codificado en Base64: el formato debe ser data:image/\;base64,\ -ID de recurso: formato asset://\ - - - - El rol y la posición del elemento de contenido. -Para imágenes: first_frame, last_frame o reference_image. -Para videos: reference_video (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). -Para audio: reference_audio (solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini). - - Valores posibles: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - - - - La información de texto de entrada para el modelo. Incluye el prompt de texto y parámetros opcionales. - -Prompt de texto (requerido): descripción del video que se va a generar usando caracteres chinos e ingleses. - -Parámetros (opcionales): agrega --[parameters] después del prompt de texto para controlar las especificaciones del video: -- --resolution (--rs): 480p, 720p, 1080p (predeterminado: 720p) -- --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (predeterminado: 16:9 o adaptive) -- --duration (--dur): 3-12 segundos (predeterminado: 5) -- --framepersecond (--fps): 24 (predeterminado: 24) -- --watermark (--wm): true/false (predeterminado: false) -- --seed (--seed): -1 a 2^32-1 (predeterminado: -1) -- --camerafixed (--cf): true/false (predeterminado: false) - -Ejemplo: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -Límite de seguridad del lado de Comfy, no una restricción de BytePlus. BytePlus no publica -ningún límite de longitud de texto y aceptó 40,000 caracteres en pruebas (2026-09-17). -Cuenta caracteres, no bytes, así que un prompt multibyte puede ocupar varias veces -este tamaño en el cable. Limita este campo, no la solicitud: -`content` es un array y el límite del cuerpo por solicitud es lo que limita -todo el documento. Comfy Router (/v2/models/byteplus/\{model}) es la superficie -que lo aplica; en una llamada directa a v1 /proxy responde el propio validador -de BytePlus. Está configurado muy por encima del tráfico real para que nunca juzgue un -prompt genuino. Auméntalo si un cliente necesita más. - - - - El tipo del contenido de entrada - - Valores posibles: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - - - - Objeto de video de entrada. Solo Seedance 2.5, 2.0, 2.0 fast y 2.0 mini admiten entrada de video. - - - - URL de video o ID de recurso. -URL de video: URL pública del video (mp4, mov). -ID de recurso: formato asset://\ - - - - Solo Seedance 2.5. Genera un video Draft de 480p; resolution debe ser 480p. -Pasa el ID de tarea devuelto en un elemento de contenido `draft_task` para renderizar el video final. Esa solicitud establece la resolución del video final, incluido 4k; cuando se omite resolution, el video final es 1080p. El ID de tarea Draft sigue siendo válido durante 7 días. - - - - Duración del video en segundos. Seedance 1.5 pro: [4,12] o -1 (automático). - - Valores posibles: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` - - - - Umbral de tiempo de espera de la tarea en segundos. Predeterminado: 172800 (48 h). Alcance: [3600, 259200]. - - Alcance: `3600` a `259200` - - - - Compatible con Seedance 2.5, 2.0, 2.0 fast, 2.0 mini y 1.5 pro. Indica si el video generado incluye audio sincronizado con las imágenes. -true: el modelo genera un video con audio sincronizado. -false: el modelo genera un video silencioso.En los modelos que lo admiten, el proveedor somete la pista de audio generada a una verificación de contenido independiente de la del video; un rechazo allí se informa como `content_policy_violation` y, como el audio cambia en cada ejecución, puede ser intermitente para una entrada que el proveedor acepta por lo demás. Envía `false` para obtener un video silencioso si eso ocurre; esto ayuda solo cuando el audio fue la modalidad rechazada, que una respuesta síncrona de Router nombra como `refusal_subject: output_audio` (una solicitud en cola todavía no lo identifica). Un render final de Seedance 2.5 hereda `generate_audio` de su tarea Draft, así que vuelve a crear el Draft con `false`. - - - - El ID del modelo al que se llama. Modelos compatibles: 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 y dreamina-seedance-2-5-260628. Una llamada directa de v1 a POST /proxy/byteplus/api/v3/contents/generations/tasks DEBE proporcionarlo: el proxy rechaza cualquier otro valor, y también su omisión, con un 400. NO está en la lista `required` de este esquema porque Comfy Router lo rellena desde el segmento de ruta `{model}` de /v2/models/byteplus/\{model}, así que quien llama a través de Router lo omite. - - - - Solo Seedance 2.5. Formato de contenedor del video de salida. -mp4: Contenedor de uso general (H.264/AAC, yuv420p) con amplia compatibilidad y menor tamaño del archivo. -mov: Contenedor profesional (H.264 High 4:4:4 Predictive/PCM, yuv444p) con alta precisión de color, adecuado para postproducción; mayor tamaño del archivo. - - Valores posibles: `mp4`, `mov` - - - - Relación de aspecto del video generado. Valor predeterminado en Seedance 2.0, 2.0 fast y 2.0 mini, 1.5 pro: adaptive. -Generación de Seedance 2.5 con primer fotograma / primer y último fotograma: la salida sigue la relación de aspecto del primer fotograma, así que solo se acepta `adaptive` (u omitir el campo); una relación concreta se rechaza con un 400 antes del envío. Seedance 2.0 acepta una relación concreta en esos modos. - - Valores posibles: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - - - - Resolución del video. Valor predeterminado en Seedance 2.5, 2.0, 2.0 fast y 2.0 mini, 1.5 pro, 1.0 lite: 720p. Valor predeterminado en Seedance 1.0 pro y pro-fast: 1080p. -Nota: Seedance 2.0, 2.0 fast y 2.0 mini no admiten 1080p. Seedance 2.5 admite 480p, 720p, 1080p y 4k. - - Valores posibles: `480p`, `720p`, `1080p`, `4k` - - - - Indica si se devuelve la imagen del último fotograma del video generado. -true: Devuelve la imagen del último fotograma del video generado. Después de establecer este parámetro en true, puedes obtener la imagen del último fotograma llamando a la consulta de información de una tarea de generación de video. La imagen del último fotograma está en formato PNG, con su ancho y alto de píxeles coherentes con los del video generado, y no contiene marcas de agua. Usar este parámetro permite generar varios videos consecutivos: el último fotograma del video generado anteriormente se usa como primer fotograma de la siguiente tarea de video, lo que permite generar rápidamente varios videos consecutivos. -false: No devuelve la imagen del último fotograma del video generado. - - - - Semilla entera para controlar la aleatoriedad. Alcance: [-1, 2^32-1]. -1 usa una semilla aleatoria. - - Alcance: `-1` a `4294967295` - - - - Nivel de servicio para el procesamiento. Seedance 2.5, 2.0 y 2.0 fast no admiten flex (inferencia offline). - - Valores posibles: `default`, `flex` - - - - Indica si el video generado incluye una marca de agua. - - -Generado a partir del esquema que Router sirve en `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. - -### Salida - - - El resultado después de que se completa la tarea de generación de video, que contiene la URL de descarga del video de salida y, cuando BytePlus la devuelve, la URL de descarga de su último fotograma. Tanto `video_url` como `last_frame_url` se RE-ALOJAN en el almacenamiento de Comfy; cualquier otro campo aquí es propio de BytePlus. Admite null: BytePlus borra las URL 24 horas después de la tarea, y un documento con estado succeeded consultado después de eso puede traer `content` ausente o null. - - - - URL de descarga del último fotograma del video generado, que se devuelve cuando la solicitud estableció `return_last_frame`. No infieras el formato de imagen a partir de esta URL: BytePlus documenta el último fotograma como PNG en el lado de la solicitud, Router re-aloja los bytes que recibe y les asigna un tipo a partir del Content-Type upstream o de una inspección del contenido, y `image/jpeg` es solo el respaldo de último recurso cuando ambos fallan. Router re-aloja el último fotograma en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memoria de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea. En cualquier caso el enlace caduca, así que descarga el fotograma en lugar de guardar la URL. - - - - Formato de contenedor del video generado (mp4 o mov), cuando BytePlus lo anida dentro de `content`. Los modelos Seedance lo devuelven con más frecuencia como un campo hermano de NIVEL SUPERIOR de `content` (consulta el campo `output_format` de nivel superior), y Router lee el que de los dos esté presente. - - - - Hora RFC 3339 en la que las URL del proveedor dejan de funcionar: el momento de firma más temprano más la validez que las propias URL llevan, nunca posterior a `updated_at` de la tarea más 24 horas (la vida documentada de las URL de BytePlus) cuando `updated_at` está presente; en caso contrario, `updated_at` de la tarea más 24 horas. Solo está presente cuando lo está `upstream_video_url` o `upstream_last_frame_url`, y se omite cuando ninguna de las dos fuentes da una hora. No tiene relación con la vida útil de `video_url` / `last_frame_url` re-alojadas. - - Formato: `date-time` - - - - La URL de descarga del último fotograma del propio BytePlus, devuelta byte a byte junto a `last_frame_url` re-alojada y en los mismos términos que `upstream_video_url`: solo espacios de trabajo con la opción activada, solo Seedance 2.x, ausente una vez que BytePlus la elimina, y una credencial de portador hasta `upstream_expires_at`. - - - - La URL de descarga del video de salida del propio BytePlus, devuelta byte a byte junto a `video_url` re-alojada. Presente SOLO para tareas de Seedance 2.x consultadas por un espacio de trabajo que Comfy ha habilitado en el servidor (no hay parámetro de solicitud); ausente para todos los demás, incluida una credencial que no resuelve a ningún espacio de trabajo (como una clave API clásica no vinculada a uno), y ausente una vez que BytePlus elimina sus URL 24 horas después de la generación. Es una URL de almacenamiento de objetos prefirmada y por tanto una credencial de portador: cualquiera que la tenga puede descargar el video hasta que caduque, así que trátala como un secreto. Caduca en `upstream_expires_at`, y en Seedance 2.5 BytePlus la limita a 100 descargas, una de las cuales consume el re-alojamiento del propio Router. - - - - URL de descarga del video de salida. Router re-aloja el video en el almacenamiento de Comfy y reescribe este campo, así que normalmente es una URL firmada por Comfy válida hasta 24 horas: se firma por 24 horas al generarse y se reproduce desde una memoria de 23 horas, por lo que una consulta posterior puede devolver una con tan solo una hora de vigencia. Cuando no se pudo realizar el re-alojamiento, el campo conserva en su lugar la URL propia de BytePlus, que BytePlus borra 24 horas después de la tarea y limita a 100 descargas en algunos modelos. En cualquier caso el enlace caduca, así que descarga el video en lugar de guardar la URL. - - - - La hora en que se creó la tarea. El valor es una marca de tiempo UNIX en segundos. - - - - La duración del video generado en segundos. Se declara como número y no como entero porque BytePlus no es consistente al respecto: se ha observado que las tareas de video devuelven segundos enteros y otras superficies de BytePlus reportan duraciones fraccionarias, así que un cliente no debe asumir un valor entero. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. - - - - La información del error. Si la tarea se completa con éxito, se devuelve null. Si la tarea falla, se devuelve la información del error. - - - - Código de error de ModelArk del proveedor. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected y OutputAudioSensitiveContentDetected identifican rechazos por políticas de contenido. Una familia puede tener un motivo separado por puntos, como InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation o OutputImageSensitiveContentDetected.DeepFake. Esta es una cadena abierta, no un enum: otros códigos describen fallos de validación y del proveedor. Router reconoce las familias de políticas en las envolturas de error HTTP 400 y en las respuestas de tarea fallida HTTP 200 sin sobrescribir los fallos de transporte. - - - - El mensaje de error - - - - El ID de la tarea de generación de video - - - - El nombre y la versión del modelo que usa la tarea - - - - Formato de contenedor del video generado (mp4 o mov), devuelto en el NIVEL SUPERIOR como hermano de `content`: aquí es donde la consulta de la tarea de video de Seedance lo devuelve. Campo propio de BytePlus, reenviado sin cambios. - - - - La resolución del video generado, por ejemplo `1080p`. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. - - - - La semilla de generación que se usó realmente para la tarea. Campo propio de BytePlus, devuelto en las tareas de video con estado succeeded y reenviado sin cambios. - - Formato: `int64` - - - - El estado de la tarea - - Valores posibles: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - - - - La hora en que la tarea se actualizó por última vez. El valor es una marca de tiempo UNIX en segundos. - - - - El uso de tokens de la solicitud - - - - El número de tokens generados por el modelo - - - - Para el modelo de generación de video, el número de tokens de entrada no se calcula y su valor predeterminado es 0. Por lo tanto, total_tokens = completion_tokens. - - -## Ejemplos - -### Entrada - -```json -{ - "content": [ - { - "text": "A red fox trotting through a snowy pine forest", - "type": "text" - } - ], - "duration": 5, - "ratio": "16:9", - "resolution": "720p" -} -``` - -### Salida - -```json -{ - "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 -} -``` - - - diff --git a/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index eb9c3f24e5..fec7fe370b 100644 --- a/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -239,7 +239,7 @@ Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o Especifica el formato de la imagen generada que se devuelve en la respuesta - Posibles valores: `url`, `b64_json` + Valores posibles: `url`, `b64_json` @@ -253,7 +253,7 @@ Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o auto: En modo automático, el modelo determina automáticamente si devolver varias imágenes y cuántas imágenes incluirá según el prompt del usuario. disabled: Deshabilita la función de generación por lotes. El modelo solo generará una imagen. - Posibles valores: `auto`, `disabled` + Valores posibles: `auto`, `disabled` @@ -321,7 +321,7 @@ En el escenario de separación por capas, el primer elemento del arreglo es la i - La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve solo cuando layer_decomposition es verdadero. + La información de la caja delimitadora de la región que ocupa la capa actual dentro de la imagen base. Solo las capas devuelven este campo; la imagen base cubre todo el lienzo y no devuelve bounding_box. Se devuelve solo cuando layer_decomposition es true. @@ -333,11 +333,11 @@ En el escenario de separación por capas, el primer elemento del arreglo es la i - Una descripción detallada del elemento separado actual, que ofrece características de capa más ricas (como color, estado o material) que name. Solo las capas devuelven este campo; la imagen base no lo hace. Se devuelve solo cuando layer_decomposition es verdadero. + Una descripción detallada del elemento separado actual, que ofrece características de capa más ricas (como color, estado o material) que name. Solo las capas devuelven este campo; la imagen base no lo hace. Se devuelve solo cuando layer_decomposition es true. - El nombre o etiqueta del elemento separado actual, generado automáticamente por el modelo a partir de las características del sujeto separado. Solo las capas devuelven este campo; la imagen base no lo hace. Se devuelve solo cuando layer_decomposition es verdadero. + El nombre o etiqueta del elemento separado actual, generado automáticamente por el modelo a partir de las características del sujeto separado. Solo las capas devuelven este campo; la imagen base no lo hace. Se devuelve solo cuando layer_decomposition es true. @@ -355,7 +355,7 @@ En el escenario de separación por capas, el primer elemento del arreglo es la i - El orden de apilamiento de la capa, que aumenta de abajo hacia arriba: 0 es la capa más baja (la imagen base); los valores mayores quedan más arriba. Úsalo para recomponer las capas en la imagen completa con el orden de apilamiento correcto. Se devuelve solo cuando layer_decomposition es verdadero. + El orden de apilamiento de la capa, que aumenta de abajo hacia arriba: 0 es la capa más baja (la imagen base); los valores mayores quedan más arriba. Úsalo para recomponer las capas en la imagen completa con el orden de apilamiento correcto. Se devuelve solo cuando layer_decomposition es true. diff --git a/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx b/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx index eec487f18e..b69a47676e 100644 --- a/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx @@ -227,6 +227,7 @@ Notas sobre el modo de separación de capas: solo se admite una única imagen de Especifica el formato de la imagen de salida. Solo seedream-5.0-pro, 5.0-flash, 5.0-lite y 5.5 admiten este parámetro. seedream-5.5 usa png de forma predeterminada. En el escenario de separación de capas, output_format solo controla el formato de la imagen base; cada capa siempre se genera como png. + Valores posibles: `png`, `jpeg` @@ -242,9 +243,9 @@ Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o - Semilla aleatoria para controlar la estocasticidad de la generación de imágenes. Alcance: [-1, 2147483647]. Si no se especifica, se generará una semilla automáticamente. Para reproducir la misma salida, usa el mismo valor de semilla. + Semilla aleatoria para controlar la estocasticidad de la generación de imágenes. Rango: [-1, 2147483647]. Si no se especifica, se generará una semilla automáticamente. Para reproducir la misma salida, usa el mismo valor de semilla. - Alcance: `-1` a `2147483647` + Rango: `-1` a `2147483647` @@ -263,7 +264,7 @@ Configuración de la función de generación de imágenes por lotes. Este parám Especifica el número máximo de imágenes a generar en esta solicitud. Número de imágenes de referencia de entrada + Número de imágenes generadas ≤ 15. - Alcance: `1` a `15` + Rango: `1` a `15` diff --git a/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx b/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx index af78389e36..3576e86403 100644 --- a/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx @@ -232,7 +232,8 @@ Opcional en el escenario de separación por capas (seedream-5.0-pro, 5.0-flash o - Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos:auto: En modo automático, el modelo determina automáticamente, según el prompt del usuario, si debe devolver varias imágenes y cuántas imágenes incluirá. + Controla si se deshabilita la función de generación por lotes. Este parámetro solo es compatible con seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos: +auto: En modo automático, el modelo determina automáticamente, según el prompt del usuario, si debe devolver varias imágenes y cuántas imágenes incluirá. disabled: Desactiva la función de generación por lote. El modelo solo generará una imagen. Valores posibles: `auto`, `disabled` @@ -246,7 +247,7 @@ Configuración de la función de generación de imágenes por lote. Este paráme Especifica el número máximo de imágenes a generar en esta solicitud. Número de imágenes de referencia de entrada + Número de imágenes generadas ≤ 15. - Alcance: `1` a `15` + Rango: `1` a `15` diff --git a/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx b/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx index 9a1cdcbc5c..4e3bb89659 100644 --- a/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx @@ -247,7 +247,7 @@ Configuración de la función de generación de imágenes por lotes. Este parám Especifica el número máximo de imágenes a generar en esta solicitud. Número de imágenes de referencia de entrada + Número de imágenes generadas ≤ 15. - Alcance: `1` a `15` + Rango: `1` a `15` diff --git a/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx b/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx index b683dd31d0..e09ab7b9a0 100644 --- a/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx +++ b/es/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx @@ -231,7 +231,8 @@ Opcional en el escenario de separación de capas (seedream-5.0-pro, 5.0-flash o - Controla si se deshabilita la función de generación por lote. Este parámetro solo se admite en seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos:auto: En modo automático, el modelo determina automáticamente si devuelve varias imágenes y cuántas imágenes contendrá cada una, según el prompt del usuario. + Controla si se deshabilita la función de generación por lote. Este parámetro solo se admite en seedream-5.0-lite, 4.5 y 4.0 (no es compatible con seedream-5.0-pro, 5.0-flash ni 5.5). Valores válidos: +auto: En modo automático, el modelo determina automáticamente si devuelve varias imágenes y cuántas imágenes contendrá cada una, según el prompt del usuario. disabled: Desactiva la función de generación por lote. El modelo solo generará una imagen. Valores posibles: `auto`, `disabled` diff --git a/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index 9817fcf853..ea71588d67 100644 --- a/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -267,7 +267,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE Número máximo de tokens que puede generar la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Intervalo: `16` a `65536` + Rango: `16` a `65536` diff --git a/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index d69b09cb64..4e5c6ad263 100644 --- a/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/es/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -267,7 +267,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Alcance: `16` a `65536` + Rango: de `16` a `65536` diff --git a/es/development/comfy-router/models/google/gemini-4-argon/code.mdx b/es/development/comfy-router/models/google/gemini-4-argon/code.mdx index b18ed26bd1..94117416de 100644 --- a/es/development/comfy-router/models/google/gemini-4-argon/code.mdx +++ b/es/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -286,7 +286,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_I Alcance: `0` a `2` - Formato: `FLOTANTE` + Formato: `float` @@ -320,7 +320,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a Alcance: `0` a `1` - Formato: `FLOTANTE` + Formato: `float` diff --git a/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx index 955feae345..690015d75b 100644 --- a/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx +++ b/es/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -284,7 +284,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ La temperatura se usa para el muestreo durante la generación de la respuesta, que ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad en la selección de tokens. Las temperaturas más bajas son buenas para prompts que requieren una respuesta menos abierta o creativa, mientras que las temperaturas más altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 significa que siempre se seleccionan los tokens de mayor probabilidad. En este caso, las respuestas a un prompt dado son en su mayoría deterministas, pero aún es posible una pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, demasiado corta, o el modelo da una respuesta de reserva, intenta aumentar la temperatura - Alcance: `0` a `2` + Rango: `0` a `2` Formato: `float` @@ -294,7 +294,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ - Opcional. Si es verdadero, el modelo incluirá sus razonamientos en la respuesta. + Opcional. Si es true, el modelo incluirá sus razonamientos en la respuesta. @@ -310,7 +310,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ Top-K cambia cómo el modelo selecciona los tokens para la salida. Un top-K de 1 significa que el siguiente token seleccionado es el más probable entre todos los tokens del vocabulario del modelo. Un top-K de 3 significa que el siguiente token se selecciona entre los 3 tokens más probables usando la temperatura. - Alcance: `1` a `…` + Rango: `1` a `…` @@ -318,7 +318,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ Top-P cambia cómo el modelo selecciona los tokens para la salida. Los tokens se seleccionan del más (ver top-K) al menos probable hasta que la suma de sus probabilidades sea igual al valor de top-P. Por ejemplo, si los tokens A, B y C tienen una probabilidad de 0.3, 0.2 y 0.1 y el valor de top-P es 0.5, entonces el modelo seleccionará A o B como el siguiente token usando la temperatura y excluirá a C como candidato. Especifica un valor más bajo para respuestas menos aleatorias y un valor más alto para respuestas más aleatorias. - Alcance: `0` a `1` + Rango: `0` a `1` Formato: `float` @@ -374,7 +374,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URL firmadas en lugar de datos base64 en línea. Las URL caducan a las 24 horas. + Si es true, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URL firmadas en lugar de datos base64 en línea. Las URL caducan a las 24 horas. @@ -388,13 +388,13 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. - Alcance: `0` a `999999999` + Rango: `0` a `999999999` Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. - Alcance: `-315576000000` a `315576000000` + Rango: `-315576000000` a `315576000000` @@ -404,13 +404,13 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a Fracciones de segundo con signo a resolución de nanosegundos. Los valores negativos de segundos con fracciones deben seguir teniendo valores de nanos no negativos. - Alcance: `0` a `999999999` + Rango: `0` a `999999999` Segundos con signo del intervalo de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive. - Alcance: `-315576000000` a `315576000000` + Rango: `-315576000000` a `315576000000` Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemini-4-carbon/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. @@ -554,7 +554,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT` + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/es/development/comfy-router/models/google/gemini/code.mdx b/es/development/comfy-router/models/google/gemini/code.mdx index dfeba623ad..0cb406ff4e 100644 --- a/es/development/comfy-router/models/google/gemini/code.mdx +++ b/es/development/comfy-router/models/google/gemini/code.mdx @@ -316,7 +316,7 @@ La codificación base64 de la imagen, el PDF o el video que se incluye en línea - Opcional. Si es verdadero, el modelo incluirá sus razonamientos en la respuesta. + Opcional. Si es true, el modelo incluirá sus razonamientos en la respuesta. @@ -396,7 +396,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URL firmadas en lugar de datos base64 insertados. Las URL vencen después de 24 horas. + Si es true, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URL firmadas en lugar de datos base64 insertados. Las URL vencen después de 24 horas. @@ -1007,7 +1007,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST - Opcional. Si es verdadero, el modelo incluirá sus razonamientos en la respuesta. + Opcional. Si es true, el modelo incluirá sus razonamientos en la respuesta. @@ -1087,7 +1087,7 @@ Especifica un valor más bajo para respuestas menos aleatorias y un valor más a - Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URLs firmadas en lugar de datos base64 en línea. Las URLs vencen después de 24 horas. + Si es true, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URLs firmadas en lugar de datos base64 en línea. Las URLs vencen después de 24 horas. diff --git a/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index 23f0840697..d4f62994be 100644 --- a/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -298,7 +298,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Alcance: `16` a `65536` + Rango: `16` a `65536` @@ -516,7 +516,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - La codificación base64 de la imagen, PDF o video que se incluirá insertada en el prompt. Cuando incluyes medios insertados, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20 MB + La codificación base64 de la imagen, PDF o video que se incluirá insertada en el prompt. Cuando incluyes medios insertados, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB Formato: `byte` @@ -586,13 +586,13 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Posibles valores: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` La probabilidad de que el contenido infrinja la categoría de seguridad especificada - Posibles valores: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -618,7 +618,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin Tipo de modalidad del contenido de entrada o de salida. - Posibles valores: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -636,7 +636,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin Tipo de modalidad del contenido de entrada o de salida. - Posibles valores: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -658,7 +658,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin Tipo de modalidad del contenido de entrada o de salida. - Posibles valores: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/es/development/comfy-router/models/google/nano-banana-2/code.mdx b/es/development/comfy-router/models/google/nano-banana-2/code.mdx index 07cc3df59c..4fbfdd3f2d 100644 --- a/es/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -529,7 +529,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemin - Datos insertados en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. + Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData. diff --git a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx index 885ea6eef3..f8fc162954 100644 --- a/es/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/es/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -314,7 +314,7 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras. - Alcance: `16` a `65536` + Rango: `16` a `65536` diff --git a/es/development/comfy-router/models/kling/kling-v3/code.mdx b/es/development/comfy-router/models/kling/kling-v3/code.mdx index 4423786be3..7ff258e662 100644 --- a/es/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/es/development/comfy-router/models/kling/kling-v3/code.mdx @@ -322,9 +322,9 @@ Comfy Router presta este modelo directamente a menos que la solicitud indique ot - Modo de generación de video. std: Modo Estándar, rentable en cuanto a costo. pro: Modo Profesional, genera videos de mayor duración pero con una salida de mayor calidad. 4k: modo Ultra-HD, genera un video con resolución 4K. Solo kling-v3 admite 4k en esta familia; el resto de los modelos Kling de texto a video solo responden a pro/std. + Modo de generación de video. std: Modo Estándar, rentable en cuanto a costo. pro: Modo Profesional, genera videos de mayor duración pero con una salida de mayor calidad. 4k: modo Ultra-HD, genera un video con resolución 4K. Solo kling-v3 admite 4k en esta familia; el resto de los modelos Kling de texto a video solo responden a pro/std. - Posibles valores: `std`, `pro`, `4k` + Valores posibles: `std`, `pro`, `4k` Generado a partir del esquema que Router expone en `GET /v2/models/kling/kling-v3/openapi.json`, el mismo documento contra el que valida una llamada antes de que la solicitud llegue al proveedor. diff --git a/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx b/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx index 7dd4d0489a..4227e3617d 100644 --- a/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx +++ b/es/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx @@ -67,7 +67,7 @@ curl https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen \ -El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests`. Router responde `201` con un `request_id` en cuanto admite la ejecución, y el resultado se recoge, desde este proceso o desde otro, en cuanto está listo. [Queued delivery](/es/development/comfy-router/queue) explica el estado, la cancelación y la obtención del resultado. +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/ltx/ltx-video-alpha-gen/requests`. Router responde `201` con un `request_id` en cuanto admite la ejecución, y el resultado se recoge, desde este proceso o desde otro, en cuanto está listo. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la obtención del resultado. ```python Python diff --git a/es/development/comfy-router/models/meshy/rigging/code.mdx b/es/development/comfy-router/models/meshy/rigging/code.mdx index 0b9be595f9..777952e81c 100644 --- a/es/development/comfy-router/models/meshy/rigging/code.mdx +++ b/es/development/comfy-router/models/meshy/rigging/code.mdx @@ -157,7 +157,7 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ - Si se añaden huesos de dedos a las manos del personaje. Solo para rig bípedo; con texture_image_url, un rig cuadrúpedo o un input_task_id de topología quad, Meshy rechaza la solicitud con 400, y con un modelo que solo puede riggear sin dedos, con 422 (sin cargo). Los huesos de dedos no cambian el costo en créditos. El valor predeterminado es falso. + Si se añaden huesos de dedos a las manos del personaje. Solo para rig bípedo; con texture_image_url, un rig cuadrúpedo o un input_task_id de topología quad, Meshy rechaza la solicitud con 400, y con un modelo que solo puede riggear sin dedos, con 422 (sin cargo). Los huesos de dedos no cambian el costo en créditos. El valor predeterminado es `false`. diff --git a/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx b/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx index cf51c435c7..a83bacee64 100644 --- a/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx +++ b/es/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx @@ -158,7 +158,7 @@ curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests - Desactiva el mejoramiento de prompt de MiniMax. Requiere un `size` fijo o un `aspect_ratio` con formato `X:Y`. + Desactiva la mejora de prompt de MiniMax. Requiere un `size` fijo o un `aspect_ratio` con formato `X:Y`. @@ -176,13 +176,13 @@ curl https://api.comfy.org/v2/models/minimax/minimax-h3-image-highspeed/requests Cantidad de imágenes. Los tokens de entrada se cobran una vez por imagen. - Alcance: `1` a `10` + Rango: `1` a `10` Calidad de compresión para `jpeg` y `webp`, predeterminado 95. - Alcance: `0` a `100` + Rango: `0` a `100` diff --git a/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index e70f5d4950..aff00fa87b 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -161,7 +161,7 @@ Comfy Router sirve este modelo directamente a menos que la solicitud indique otr - **Runware**, como `runware/runware-gpt-image-2.5-sunburst`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=runware` - **WaveSpeed**, como `wavespeed/wavespeed-gpt-image-2.5-sunburst`: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=wavespeed` -`strict_mode` es falso de forma predeterminada, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para cada modelo enrutado de esta manera. +`strict_mode` es `false` de forma predeterminada, por lo que Router traduce el cuerpo de la solicitud nativo documentado en esta página al esquema propio del proveedor y traduce la respuesta de vuelta. Consulta [`model_provider`, `strict_mode` y `fallback_provider`](/es/development/comfy-router/reference#post-v2modelsprovidermodel) en la referencia de la API, y [Proveedores de servicio](/es/development/comfy-router/providers) para cada modelo enrutado de esta manera. ## Esquema @@ -188,7 +188,8 @@ Acepta una imagen o un arreglo de ellas; gpt-image-1 y posteriores aceptan hasta HAY DOS AMPLIACIONES EN DESPLIEGUE Y AMBAS ESTÁN DESACTIVADAS POR DEFECTO HOY. Se publican tras UN solo interruptor y se habilitan juntas, así que considera todo lo siguiente como algo futuro y no como algo sobre lo que construir todavía: pregunta antes de basarte en cualquiera de las dos. La PRIMERA es el bucket en el que `POST /customers/storage` firma tu subida. Hasta que el despliegue llegue a tu entorno, una URL de subida de ese endpoint se rechaza aquí, aunque el bucket sea de Comfy y el host el mismo: así que "subir a Comfy y luego pasar la URL" NO funciona todavía, y la forma que sí funciona es la URL firmada a la que redirige `/api/assets/{id}/content`. La SEGUNDA se HABILITA POR CUENTA y no para todos a la vez, porque el bucket que hay detrás de estos hosts es tuyo y no nuestro: incluso con el interruptor anterior activado, una cuenta que no tenga habilitada la multimedia entrante de terceros recibe un rechazo, y se le indica con esas mismas palabras en lugar de decirle que el host no es compatible. Pide a tu contacto de Comfy que la habilite para tu cuenta. Además admite estos hosts de almacenamiento de objetos de terceros, donde el bucket es tuyo y Router no reclama su propiedad: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` y `s3..amazonaws.com`, tanto en la forma de estilo de ruta como en la prefijada con `.`), Azure Blob Storage (`.blob.core.windows.net`) y Alibaba Cloud OSS (`.oss-.aliyuncs.com`, incluido el endpoint `oss-accelerate`). Son endpoints de almacenamiento de objetos específicamente: un endpoint de propósito general en el mismo dominio del proveedor, como un trigger de Alibaba Function Compute, no está en la lista y se rechaza. - LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR: por eso nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y vale la pena indicar sin rodeos tres casos que casi coinciden, porque quien llama puede llegar razonablemente con cualquiera de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: firma previamente el endpoint `.r2.cloudflarestorage.com`, o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas.Los marcadores `` y `pub-` de arriba muestran la forma con la que llegarás normalmente; no son una restricción de profundidad. La comparación es sobre el sufijo de dominio del almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los listados. + LO QUE SE COMPARA ES LA FORMA DEL NOMBRE DE HOST, NO EL PROVEEDOR: por eso nombrar un proveedor arriba NO significa que se acepte cada URL que ese proveedor pueda emitir, y vale la pena indicar sin rodeos tres casos que casi coinciden, porque quien llama puede llegar razonablemente con cualquiera de ellos. Un DOMINIO PERSONALIZADO de R2 (`cdn.example.com`) NO se acepta: Cloudflare documenta `pub-.r2.dev` como un nombre de host de depuración con límite de tasa y dirige el tráfico de producción a un dominio personalizado, pero un dominio personalizado no lleva nada en su nombre de host que lo identifique como R2, así que Router no puede distinguirlo de cualquier otro host y lo rechaza: firma previamente el endpoint `.r2.cloudflarestorage.com`, o usa la forma `pub-.r2.dev`. El endpoint IPv6 dualstack de S3 (`s3.dualstack..amazonaws.com`) tampoco se acepta; usa el endpoint regional simple. Tampoco la zona DNS alternativa de Azure Blob (`.z.blob.storage.azure.net`); usa `.blob.core.windows.net`. El rechazo que recibes nombra estas mismas formas, así que no tienes que venir aquí a leerlas. + Los marcadores `` y `pub-` de arriba muestran la forma con la que llegarás normalmente; no son una restricción de profundidad. La comparación es sobre el sufijo de dominio del almacenamiento de objetos, así que también se acepta un nombre más profundo bajo el mismo espacio de nombres (`a.b.pub-.r2.dev`). Lo que NO se amplía con eso es el espacio de nombres en sí: el sufijo todavía tiene que ser uno de los listados. El ejemplo siguiente muestra solo la forma: un valor real además lleva los parámetros de consulta de firma, que aquí se omiten deliberadamente porque un ejemplo publicado permanece en la especificación para siempre y una firma real es a la vez una credencial filtrada y un enlace que deja de funcionar. Cada imagen está limitada a 25 MiB y las imágenes de una solicitud a 64 MiB en total. La única excepción es Precise Edit de ideogram/ideogram-4-5 (una llamada que envía `image`) cuando `context_window` está disponible: ahí cada imagen puede llegar a 50 MB (50,000,000 bytes) y 67,108,864 píxeles, y las imágenes de una solicitud a 128 MiB en total. diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index e487af20e3..82bed7b2a1 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -174,13 +174,13 @@ Comfy Router sirve este modelo directamente, a menos que la solicitud indique ot El número de fotogramas del GIF animado (2-16, el rango propio de OpenAI), solo tiene sentido con `output_format: "gif"`: se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, toma el valor predeterminado propio de OpenAI de 9, EXCEPTO que Comfy además limita este campo por entorno (`ROUTER_OPENAI_IMAGE_GIF_MAX_FRAMES`, nunca por encima del máximo propio de este campo de 16): se rechaza un valor por encima del límite configurado, y se rechaza un `frame_count` omitido en lugar de reducirlo silenciosamente cuando el valor predeterminado de 9 supera el límite configurado, así que se le indica a quien llama que establezca `frame_count` explícitamente en lugar de recibir una animación silenciosamente más pequeña que la predeterminada de OpenAI. El número de fotogramas también limita la cotización previa y el límite de resultados de 64 MiB, y ambos escalan con él. - Rango: `2` a `16` + Alcance: `2` a `16` Los milisegundos durante los que se muestra cada fotograma (el rango propio de OpenAI es 20-2000, redondeado a 10 ms), solo tiene sentido con `output_format: "gif"`: se rechaza junto con cualquier otro `output_format`. Si se omite en una solicitud GIF, toma el valor predeterminado propio de OpenAI de 200. - Rango: `20` a `2000` + Alcance: `20` a `2000` diff --git a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 423fe8b319..079289bfa0 100644 --- a/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -219,13 +219,13 @@ Cada imagen está limitada a 25 MiB y las imágenes de una misma solicitud a 64 El número de imágenes a generar (1-10). Una solicitud GIF (ver `output_format`) rechaza cualquier valor distinto de 1: la propia descripción de OpenAI llama a `n` en una solicitud GIF «el número de animaciones», que Router no tarifica para v1. - Alcance: `1` a `10` + Rango: `1` a `10` Nivel de compresión para JPEG o WebP (0-100). Router lo rechaza en una solicitud GIF: OpenAI no acepta un nivel de compresión para una salida animada. - Alcance: `0` a `100` + Rango: `0` a `100` @@ -237,7 +237,7 @@ Cada imagen está limitada a 25 MiB y las imágenes de una misma solicitud a 64 Solo tiene sentido junto a un stream en vivo, que esta superficie no puede servir, exactamente igual que en OpenAIImageRouterRequest; ver la descripción de ese campo. Un valor mayor que 0 se rechaza en una solicitud GIF, por la misma razón que `stream: true`; 0 se acepta. - Alcance: `0` a `3` + Rango: `0` a `3` diff --git a/es/development/comfy-router/models/pixverse/v6-max/code.mdx b/es/development/comfy-router/models/pixverse/v6-max/code.mdx index 7d76d0d94e..490ff18fd2 100644 --- a/es/development/comfy-router/models/pixverse/v6-max/code.mdx +++ b/es/development/comfy-router/models/pixverse/v6-max/code.mdx @@ -18,8 +18,6 @@ Referencia de API para `pixverse/v6-max`, servido por Comfy Router de Pixverse. **Entrada:** Texto · **Salida:** Video - - ## Inicio rápido Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP directo. diff --git a/es/development/comfy-router/models/stability/control-sketch/code.mdx b/es/development/comfy-router/models/stability/control-sketch/code.mdx index c924d50e78..a17b1aa613 100644 --- a/es/development/comfy-router/models/stability/control-sketch/code.mdx +++ b/es/development/comfy-router/models/stability/control-sketch/code.mdx @@ -193,7 +193,7 @@ curl https://api.comfy.org/v2/models/stability/control-sketch/requests/$REQUEST_ Se acepta y no se aplica. -Generated from the schema Router serves at `GET /v2/models/stability/control-sketch/openapi.json`, the same document it validates a call against before the request reaches the provider. +Generado a partir del esquema que Router sirve en `GET /v2/models/stability/control-sketch/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor. ### Salida diff --git a/es/development/comfy-router/models/stability/edit-remove-background/code.mdx b/es/development/comfy-router/models/stability/edit-remove-background/code.mdx index b401e0651f..0a42bff11f 100644 --- a/es/development/comfy-router/models/stability/edit-remove-background/code.mdx +++ b/es/development/comfy-router/models/stability/edit-remove-background/code.mdx @@ -146,7 +146,7 @@ curl https://api.comfy.org/v2/models/stability/edit-remove-background/requests/$ ### Entrada - Una URL de asset firmada por Comfy de la imagen de origen. + Una URL de recurso firmada por Comfy de la imagen de origen. Formato: `uri` diff --git a/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx b/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx index 9630145c25..5f54e76e40 100644 --- a/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx +++ b/es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx @@ -83,7 +83,7 @@ curl https://api.comfy.org/v2/models/stability/sdxl-1.0-masking \ -El mismo body, enviado a `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-masking/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. +El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/stability/sdxl-1.0-masking/requests`. El Router responde `201` con un `request_id` en cuanto se admite la ejecución, y el resultado se recoge cuando está listo, desde este proceso u otro. [Entrega en cola](/es/development/comfy-router/queue) explica el estado, la cancelación y la recogida. ```python Python @@ -192,13 +192,13 @@ curl https://api.comfy.org/v2/models/stability/sdxl-1.0-masking/requests/$REQUES - Una URL de asset firmada por Comfy de la imagen de origen. + Una URL de recurso firmada por Comfy de la imagen de origen. Formato: `uri` - Una URL de asset firmada por Comfy de la máscara. Requerida con MASK_IMAGE_WHITE y MASK_IMAGE_BLACK, rechazada con INIT_IMAGE_ALPHA. + Una URL de recurso firmada por Comfy de la máscara. Requerida con MASK_IMAGE_WHITE y MASK_IMAGE_BLACK, rechazada con INIT_IMAGE_ALPHA. Formato: `uri` diff --git a/es/development/comfy-router/models/stability/stable-fast-3d/code.mdx b/es/development/comfy-router/models/stability/stable-fast-3d/code.mdx index 0c7937eb69..c141de3670 100644 --- a/es/development/comfy-router/models/stability/stable-fast-3d/code.mdx +++ b/es/development/comfy-router/models/stability/stable-fast-3d/code.mdx @@ -19,8 +19,6 @@ Referencia de API para `stability/stable-fast-3d`, servido por Comfy Router de S **Entrada:** Imagen · **Salida:** 3D - - ## Inicio rápido Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada por HTTP sin procesar. diff --git a/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx b/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx index d1ba16acb8..1f95bf99e8 100644 --- a/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx +++ b/es/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx @@ -335,7 +335,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ - Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. + Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es true. @@ -343,7 +343,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ - Indica si se genera audio junto con el video. El valor predeterminado es verdadero. Compatible con los modelos Veo 3.0+. + Indica si se genera audio junto con el video. El valor predeterminado es true. Compatible con los modelos Veo 3.0+. @@ -376,7 +376,7 @@ También se aceptan `ALLOW` y `BLOCK`, por la misma razón de compatibilidad por Número de videos a generar. Si no se especifica, se genera 1 video. - Alcance: `1` a `4` + Rango: `1` a `4` @@ -421,7 +421,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veo/veo-3.1-fa - La respuesta de la predicción, presente cuando `done` es verdadero + La respuesta de la predicción, presente cuando `done` es true diff --git a/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx b/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx index e7ca41eda8..6d4bdbe069 100644 --- a/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx +++ b/es/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code.mdx @@ -335,7 +335,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es verdadero. + Mejora automáticamente el prompt para obtener mayor calidad. El valor predeterminado es true. @@ -343,7 +343,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-lite-generate-001/requests/$REQ - Indica si se genera audio junto con el video. El valor predeterminado es verdadero. Compatible con los modelos Veo 3.0+. + Indica si se genera audio junto con el video. El valor predeterminado es true. Compatible con los modelos Veo 3.0+. @@ -421,7 +421,7 @@ Generado a partir del esquema que Router sirve en `GET /v2/models/veo/veo-3.1-li - La respuesta de la predicción, presente cuando done es verdadero + La respuesta de la predicción, presente cuando done es true diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index e8bf7d653c..c65ead4a17 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -289,7 +289,7 @@ enfrenta a un límite de transporte: el cuerpo de una solicitud POST de Comfy Ro un límite total de 100 MiB y se responde con 413 si se supera, y base64 infla la carga útil en aproximadamente 4/3, así que un solo recurso en línea de más de aproximadamente 75 MB se rechaza antes de que se aplique cualquiera de las reglas del socio que aparecen -aquí. Con ese tamaño, un solo recurso con el propioEl techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. +aquí. Con ese tamaño, un solo recurso cabe holgadamente en línea dentro del techo de 20MB del propio socio, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -358,17 +358,17 @@ Facturación: según la duración de referencia real utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 activa el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Alcance: `-1` a `30` + Rango: `-1` a `30` - Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero. + Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es true. Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. Para modelos wan2.7, toma un valor predeterminado según el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una adecuadarelación de aspecto según las proporciones y la intención de los recursos multimedia de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index 72703e5ead..71706c8df9 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -291,7 +291,7 @@ techo de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 M total y se responde 413 por encima de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio descritas aquí. Con ese tamaño, un -solo recurso con el propioCon ese tamaño, un solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. +solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -372,9 +372,7 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unaRelación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. -En los modelos wan2.7, se toma un valor predeterminado según el nivel de resolución si no se proporciona. -En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index 4b5c6791fc..e8a4090025 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -195,20 +195,16 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID - wan2.7-i2v: first_frame, last_frame, driving_audio, first_clip. first_frame y last_frame: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; driving_audio (WAV/MP3, de 2 a 30 segundos, como máximo 15MB) y first_clip (MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB): una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-r2v: first_frame (opcional, máx. 1), reference_image, reference_video. Se requiere al menos un reference_image o un reference_video, y el total de imágenes de referencia y videos de referencia es como máximo 5. first_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP (sin canal alfa), 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; reference_video: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - wan2.7-videoedit: video (exactamente 1, el clip que se edita: MP4/MOV, de 2 a 10 segundos, 240-4096 píxeles por lado, como máximo 100MB, una URL pública HTTP/HTTPS; no se acepta una URL data: en línea) más un reference_image opcional, de 0 a 4 (JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto entre 1:8 y 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). -- wan3.0-video, wan3.0-video-prime: first_frame (máx. 1), last_frame (máx. 1), reference_image (máx. 10), reference_video (máx. 5 clips, duración total \<= 15s), reference_audio (máx. 5 clips, duración total \<= 15s), file (máx. 1, no se puede usar con link), link (máx. 1, no se puede usar con file). Los tipos reference_*/file/link y los tipos first_frame/last_frame son mutuamente excluyentes dentro de una misma solicitud. El orden del array define el orden de referencia de los recursos en el prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. +- wan3.0-video, wan3.0-video-prime: first_frame (máx. 1), last_frame (máx. 1), reference_image (máx. 10), reference_video (máx. 5 clips, duración total \<= 15s), reference_audio (máx. 5 clips, duración total \<= 15s), file (máx. 1, no se puede usar con link), link (máx. 1, no se puede usar con file). Los tipos reference_*/file/link y los tipos first_frame/last_frame son mutuamente excluyentes dentro de una misma solicitud. El orden del array define el orden de referencia de los recursos en el prompt (Image 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se acepta una URL data: en línea. - happyhorse-1.0-i2v, happyhorse-1.1-i2v: solo first_frame, exactamente 1. Estas variantes toman su primer fotograma AQUÍ y no en img_url. Al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... - happyhorse-1.0-r2v, happyhorse-1.1-r2v: solo reference_image, de 1 a 9. Esta es la única entrada de referencia del modelo. El lado más corto debe medir al menos 400 píxeles, JPEG/JPG/PNG/WEBP, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...; reference_video no es un tipo de entrada para esta operación. - happyhorse-1.0-video-edit: video (exactamente 1, el clip que se edita: MP4/MOV, de 3 a 60 segundos, lado más largo como máximo 4096 píxeles, lado más corto al menos 360 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 100MB, una URL pública HTTP/HTTPS; no se acepta una URL data: en línea) más un reference_image opcional, de 0 a 5 (JPEG/JPG/PNG/BMP/WEBP, al menos 300x300 píxeles, relación de aspecto entre 1:2.5 y 2.5:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,...). - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: operaciones de texto a video. Sus referencias del socio no documentan ninguna entrada de medios, así que deja este campo sin definir. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: este componente no enumera ningún vocabulario de medios para estas variantes. wan2.5-i2v-preview y wan2.6-i2v toman su primer fotograma en img_url; wan2.6-r2v toma sus clips de referencia en reference_video_urls. -Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no se declara minItems/maxItems en media, porque los tipos admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el límite máximo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el límite máximo del socio para el recurso que finalmente recibe, y se aplican tal como están escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se enfrenta a un límite de transporte: el cuerpo de un POST de Comfy Router tiene un tope de 100 MiB en total y se responde con 413 si se supera, y base64 infla la carga útil en aproximadamente 4/3, así que un solo recurso en línea de más de aproximadamente 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio del socio +Los recuentos por modelo anteriores son restricciones del socio, no de este esquema: no se declara minItems/maxItems en media, porque los tipos admisibles y sus límites difieren según el modelo. Que el esquema acepte un valor no implica que el proveedor lo acepte; y, en la otra dirección, las cifras de "como máximo 20MB" por recurso anteriores (el límite máximo de las entradas de imagen, las únicas entradas que pueden enviarse en línea) son el límite máximo del socio para el recurso que finalmente recibe, y se aplican tal como están escritas cuando el recurso es una URL pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se enfrenta a un límite de transporte: el cuerpo de un POST de Comfy Router tiene un tope de 100 MiB en total y se responde con 413 si se supera, y base64 infla la carga útil en aproximadamente 4/3, así que un solo recurso en línea de más de aproximadamente 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso con el propio límite de 20 MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. -20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; -el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota -TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos -techos. Tipo de recurso multimedia @@ -293,7 +289,7 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. En los modelos wan2.7, si no se proporciona, se toma un valor predeterminado según el nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto según las proporciones y la intención de los recursos de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index edb018eb6a..75caa11b24 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -286,7 +286,7 @@ data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con transporte: un cuerpo POST de Comfy Router está limitado a 100 MiB en total y se responde con 413 si se supera, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de que se alcance cualquiera -de las reglas del socio aquí. A ese tamaño, un solo recurso en el propio con ese tamaño, un recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. +de las reglas del socio aquí. A ese tamaño, un solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -363,7 +363,7 @@ Facturación: según la duración de referencia real utilizada. el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Alcance: `-1` a `30` + Rango: `-1` a `30` @@ -373,7 +373,8 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación adecuadarelación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una +relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index 2a1af8130b..7d0baf3d36 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -253,7 +253,7 @@ modelo: con link), link (máx. 1, no se puede usar con file). Los tipos reference_*/file/link y los tipos first_frame/last_frame son mutuamente excluyentes dentro de una misma solicitud. El orden del array define el orden de referencia de los recursos en el - prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: + prompt (Image 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se @@ -382,7 +382,7 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. En los modelos wan2.7, si no se proporciona, se toma un valor predeterminado según el nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unrelación de aspecto según las proporciones y la intención de los recursos de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx index 344f8c827d..dcccf7045d 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx @@ -291,7 +291,7 @@ medios, así que deja este campo sin establecer. POST de Comfy Router tiene un límite total de 100 MiB y se responde con 413 si se supera, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de que se aplique cualquiera de las - reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propioEl techo de 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. + reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso con el techo de 20MB del propio socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -372,7 +372,7 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, se usa un valor predeterminado según el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una adecuadarelación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index 94c52a8345..b514146880 100644 --- a/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -227,7 +227,7 @@ modelo: con link), link (máx. 1, no se puede usar con file). Los tipos reference_*/file/link y los tipos first_frame/last_frame son mutuamente excluyentes dentro de una misma solicitud. El orden del array define el orden de referencia de los recursos en el - prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: + prompt (Image 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se @@ -266,7 +266,7 @@ enfrenta a un techo de transporte: el cuerpo de un POST de Comfy Router está li 100 MiB en total y se responde 413 si lo supera, y base64 infla la carga útil alrededor de 4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio que aparecen aquí. A ese tamaño, un solo recurso en -el propio20MB del socio cabe en línea sin problema, así que con un solo recurso lo que obliga es la +el propio límite de 20 MB del socio cabe en línea sin problema, así que con un solo recurso lo que obliga es la regla del socio: el techo de transporte obliga cuando hay varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. diff --git a/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index f41771c618..eef5e33103 100644 --- a/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -270,17 +270,10 @@ de transporte: el cuerpo de una solicitud POST de Comfy Router tiene un tope de en total y se responde 413 por encima de eso, y base64 infla la carga útil alrededor de 4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio que se describen aquí. Con ese tamaño, un solo -recurso en el propio acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. +recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un +solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando +son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada +elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -367,7 +360,7 @@ Este proxy devuelve 400 si la duración está fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto adecuada según las proporciones y la intención del contenido multimedia de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención del contenido multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx index 42505f0ff0..8a65ae59a2 100644 --- a/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-t2i-preview/code.mdx @@ -197,7 +197,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview/requests/$REQUEST_ID - Habilita la reescritura inteligente del prompt. El valor predeterminado es verdadero + Habilita la reescritura inteligente del prompt. El valor predeterminado es true diff --git a/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx b/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx index a49444c50e..bbaa2258ea 100644 --- a/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx @@ -265,8 +265,8 @@ data:\{MIME_type};base64,... en línea sí pasa por Comfy y además se topa con transporte: el cuerpo de un POST a Comfy Router está limitado a 100 MiB en total y se responde con 413 si se supera, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar a -cualquiera de las reglas del socio que figuran aquí. Con ese tamaño, un solo recurso con -el propioun solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. +cualquiera de las reglas del socio que figuran aquí. Con ese tamaño, un solo recurso +en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -353,7 +353,7 @@ Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, si no se proporciona, se usa un valor predeterminado según el nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index 98d15e0e01..4a2e79fce9 100644 --- a/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -271,7 +271,7 @@ medios, así que deja este campo sin definir. Comfy Router está limitado a 100 MiB en total y se responde 413 si lo supera, y base64 infla la carga en aproximadamente 4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio aquí descritas. - Con ese tamaño, un solo recurso con los propiosEl techo de 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. + Con ese tamaño, un solo recurso en el techo de 20MB del propio socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -338,7 +338,7 @@ Facturación: según la duración de referencia realmente utilizada. - wan3.0-video: entero en [2, 30] sin entrada de video; con entrada de video, la duración total del video de entrada + la duración del video de salida no debe superar los 30 segundos; -1 habilita el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 para una duración fuera de [-1, 30]. - Alcance: `-1` a `30` + Rango: `-1` a `30` @@ -348,7 +348,7 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. En los modelos wan2.7, si no se proporciona, toma un valor predeterminado según el nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto adecuada según las proporciones y la intención de los recursos de +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index 88d0d0fffe..ed0b1194bc 100644 --- a/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -269,7 +269,7 @@ data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se topa con de transporte: el cuerpo de una solicitud POST de Comfy Router está limitado a 100 MiB en total y se responde 413 si se supera, y base64 infla una carga útil alrededor de 4/3, así que un solo recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera -de las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propiopública, porque esos bytes nunca pasan por Comfy. Con ese tamaño, un solo recurso en el propio techo de +de las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como @@ -360,7 +360,7 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una adecuadarelación de aspecto adecuada según las proporciones de los medios de entrada y la intención. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones de los medios de entrada y la intención. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-6-t2v/code.mdx b/es/development/comfy-router/models/wan/wan2-6-t2v/code.mdx index fc0cf9a10d..6989f6844e 100644 --- a/es/development/comfy-router/models/wan/wan2-6-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-6-t2v/code.mdx @@ -227,7 +227,7 @@ modelo: con link), link (máx. 1, no se puede usar con file). Los tipos reference_*/file/link y los tipos first_frame/last_frame son mutuamente excluyentes dentro de una misma solicitud. El orden del array define el orden de referencia de los recursos en el - prompt (Imagen 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: + prompt (Image 1, Video 1, Audio 1, ...). first_frame, last_frame y reference_image: JPEG/JPG/PNG/BMP/WEBP, 240-8000 píxeles por lado, relación de aspecto como máximo 8:1, como máximo 20MB, una URL pública o una URL data:\{MIME_type};base64,... reference_video, reference_audio, file y link: una URL pública HTTP/HTTPS; no se @@ -265,7 +265,7 @@ en línea sí pasa por Comfy y también se enfrenta a un techo de transporte: el POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio descritas -aquí. Con ese tamaño, un único recurso con el propioEl techo de 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es +aquí. Con ese tamaño, un único recurso con el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -345,7 +345,7 @@ Facturación: según la duración de referencia real utilizada. el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. - Alcance: `-1` a `30` + Rango: `-1` a `30` @@ -355,7 +355,7 @@ Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. En los modelos wan2.7, el valor predeterminado depende del nivel de resolución si no se proporciona. -En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unarelación de aspecto adecuada según las proporciones y la intención del recurso multimedia de entrada. +En wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención del recurso multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 4ad515a647..289a6b9978 100644 --- a/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -291,10 +291,10 @@ techo de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 M total y se responde 413 cuando se supera, y base64 infla la carga útil en aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza antes de que se aplique cualquiera de las reglas del socio que aparecen aquí. Con ese -tamaño, un único recurso en el propio límite del socio20MB ceiling fits inline comfortably, so the partner rule is what binds for one asset -- -the transport ceiling binds across several of them, since the 100 MiB Router cap bounds -the WHOLE request rather than each element. Send anything near these ceilings as a -public URL. +tamaño, un único recurso en el propio límite de 20 MB del socio cabe en línea sin problema, +así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte +obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y +no cada elemento. Envía como URL pública cualquier recurso cercano a estos techos. diff --git a/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index ff6f6350e1..48b95fa297 100644 --- a/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -291,20 +291,9 @@ techo de transporte: el cuerpo de una solicitud POST de Comfy Router está limit 100 MiB en total y se responde 413 al superarlo, y base64 infla una carga útil en aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza antes de alcanzar cualquiera de las reglas del socio que aquí se indican. A ese tamaño, -un único recurso en el propio +un único recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB de Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. -acaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. Tipo de recurso multimedia @@ -389,7 +378,7 @@ Este proxy devuelve 400 si la duración está fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. Para los modelos wan2.7, si no se proporciona, se toma un valor predeterminado según el nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente un valor adecuadorelación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-7-t2v/code.mdx b/es/development/comfy-router/models/wan/wan2-7-t2v/code.mdx index bfc50ff578..11f6256988 100644 --- a/es/development/comfy-router/models/wan/wan2-7-t2v/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-t2v/code.mdx @@ -265,7 +265,7 @@ data:\{MIME_type};base64,... en línea sí pasa por Comfy y también se enfrenta de transporte: el cuerpo de un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima de eso, y base64 infla la carga útil alrededor de 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de -las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso con el propioEl techo de 20MB cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. +las reglas del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -352,7 +352,7 @@ Este proxy devuelve 400 si la duración queda fuera de [-1, 30]. Relación de aspecto del video generado. Solo para los modelos wan2.7 y wan3.0. En los modelos wan2.7, si no se proporciona, se toma un valor predeterminado según el nivel de resolución. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente unla relación de aspecto adecuada según las proporciones y la intención de los medios de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los medios de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx b/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx index fae34f1f06..a72cabb3d4 100644 --- a/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx +++ b/es/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx @@ -284,7 +284,7 @@ de transporte: el cuerpo de un POST de Comfy Router tiene un límite total de 10 se responde 413 si lo supera, y base64 infla una carga útil en aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio que aparecen aquí. Con ese tamaño, un único recurso -con el propio techo del socio Un recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. +en el propio techo de 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -363,7 +363,7 @@ Este proxy devuelve 400 para una duración fuera de [-1, 30]. Relación de aspecto del video generado. Solo para modelos wan2.7 y wan3.0. Para los modelos wan2.7, se establece de forma predeterminada según el nivel de resolución si no se proporciona. -Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuadarelación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. +Para wan3.0-video, adaptive (el valor predeterminado) recomienda automáticamente una relación de aspecto adecuada según las proporciones y la intención de los recursos multimedia de entrada. Valores posibles: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index 74a0027202..2f3314755c 100644 --- a/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/es/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -267,13 +267,13 @@ un límite de transporte: el cuerpo de una solicitud POST de Comfy Router tiene total de 100 MiB y se responde con 413 si se supera, y base64 infla una carga útil en aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio que aparecen aquí. Con ese tamaño, -un único recurso en el propio del socio +un único recurso en el propio techo de 20MB del socio cabe en línea sin problema, así que +para un solo recurso lo que obliga es la regla del socio; con varios recursos, lo que +obliga es el techo de transporte, ya que el límite de 100 MiB del Router acota TODA la +solicitud y no cada elemento. Envía como URL pública cualquier cosa que se acerque a +estos techos. -20MB ceiling fits inline comfortably, so the partner rule is what binds for one asset; -the transport ceiling binds across several of them, since the 100 MiB Router cap bounds -the WHOLE request rather than each element. Envía como URL pública cualquier cosa que se -acerque a estos techos. Tipo de recurso multimedia @@ -342,7 +342,7 @@ Facturación: según la duración de referencia real utilizada. el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 si la duración está fuera de [-1, 30]. - Alcance: `-1` a `30` + Rango: `-1` a `30` @@ -368,7 +368,7 @@ adecuada según las proporciones y la intención de los recursos multimedia de e - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P Este proxy rechaza las solicitudes de generación de video que no indican ni resolution ni size, porque el nivel de resolución determina la tarifa de facturación. Convierte -resolution a mayúsculas antes de validarla y reenvía el valor en mayúsculas; devuelve 400 fuera de esta enumeración, y devuelve 400 para 480P (ya sea enviado como +resolution a mayúsculas antes de validarla y reenvía el valor en mayúsculas; devuelve 400 para un valor fuera de esta enumeración, y devuelve 400 para 480P (ya sea enviado como resolution o como un size de 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 indicados arriba como modelos sin 480P. diff --git a/es/development/comfy-router/models/wan/wan3-0-video/code.mdx b/es/development/comfy-router/models/wan/wan3-0-video/code.mdx index e612e81f0d..de0a3f24b3 100644 --- a/es/development/comfy-router/models/wan/wan3-0-video/code.mdx +++ b/es/development/comfy-router/models/wan/wan3-0-video/code.mdx @@ -294,17 +294,10 @@ con un límite de transporte: el cuerpo de una solicitud POST de Comfy Router es limitado a 100 MiB en total y se responde con 413 si se supera, y base64 infla una carga útil en aproximadamente 4/3, así que un único recurso en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas del socio descritas aquí. Con ese -tamaño, un único recurso en el propioacaba recibiendo, y se aplican tal como están escritas cuando el recurso es una URL - pública, porque esos bytes nunca pasan por Comfy. Una URL data:\{MIME_type};base64,... - en línea sí pasa por Comfy y también se topa con un techo de transporte: el cuerpo de - un POST de Comfy Router está limitado a 100 MiB en total y se responde 413 por encima - de eso, y base64 infla una carga útil en aproximadamente 4/3, así que un solo recurso - en línea de más de unos 75 MB se rechaza antes de llegar a cualquiera de las reglas - del socio que aparecen aquí. Con ese tamaño, un solo recurso en el propio techo de - 20MB del socio cabe en línea sin problema, así que para un solo recurso lo que obliga - es la regla del socio; el techo de transporte obliga cuando son varios, ya que el - límite de 100 MiB del Router acota TODA la solicitud y no cada elemento. Envía como - URL pública cualquier cosa que se acerque a estos techos. +tamaño, un solo recurso en el propio techo de 20MB del socio cabe en línea sin problema, +así que para un solo recurso lo que obliga es la regla del socio; el techo de transporte +obliga cuando son varios, ya que el límite de 100 MiB del Router acota TODA la solicitud y +no cada elemento. Envía como URL pública cualquier cosa que se acerque a estos techos. @@ -375,7 +368,7 @@ Facturación: según la duración de referencia real utilizada. el modo de duración inteligente, en el que el modelo elige una duración adecuada Este proxy devuelve 400 si la duración está fuera de [-1, 30]. - Alcance: `-1` a `30` + Rango: `-1` a `30` @@ -401,7 +394,7 @@ adecuada según las proporciones y la intención de los recursos multimedia de e - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P Este proxy rechaza las solicitudes de generación de video que no indican ni resolución ni tamaño, porque el nivel de resolución determina la tarifa de facturación. Convierte -la resolución a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas; devuelve 400para un valor fuera de esta enumeración y devuelve 400 para 480P (ya sea enviado como +la resolución a mayúsculas antes de comprobarla y reenvía el valor en mayúsculas; devuelve 400 para un valor fuera de esta enumeración y devuelve 400 para 480P (ya sea enviado como resolución o como un tamaño 480P) en los modelos wan2.6, wan2.7 y happyhorse-1.0 que se enumeran arriba como modelos sin 480P. diff --git a/es/development/comfy-router/reference.mdx b/es/development/comfy-router/reference.mdx index e0e4849b5d..d26ce512e0 100644 --- a/es/development/comfy-router/reference.mdx +++ b/es/development/comfy-router/reference.mdx @@ -624,67 +624,67 @@ El endpoint de recogida. Sobre una solicitud que terminó correctamente, devuelv OK: el resultado almacenado para una solicitud que produjo uno, es decir, una solicitud que se completó correctamente o una solicitud terminal que lleva a la vez un cargo registrado y un resultado almacenado. Se devuelve sin cambios bajo el tipo de medio propio del socio, exactamente como lo devuelve el `200` de la ruta síncrona, y bajo el mismo contrato de selección de proveedor que aceptó el envío: sin `model_provider`, o con `model_provider` y `strict_mode=false` (el valor predeterminado, traducido de vuelta al contrato nativo de este modelo cuando es posible, y recurriendo a la respuesta sin procesar del proveedor alternativo si la traducción falla, siempre registrado en el log y nunca en silencio), la forma es la salida nativa de este modelo; con `strict_mode=true` es la respuesta del proveedor alternativo devuelta sin cambios. Para un modelo cuyo socio responde una generación directamente como bytes, el cuerpo son esos bytes bajo el `Content-Type` propio del socio en lugar de `application/json`; decide según el `Content-Type` de la respuesta y no asumas un documento JSON. - Body: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Headers: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` + Cuerpo: [`RouterModelOutput`](#routermodeloutput) o bytes sin procesar (`*/*`) -- Encabezados: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` Aceptada: la solicitud todavía no ha finalizado. - Body: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Headers: `X-Comfy-Request-Id`, `Retry-After` + Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After` Credenciales faltantes o no válidas. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud no está permitida para este llamador ni para este modelo. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` No se encontró el ID del modelo. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` `rate_limited`: el cupo de solicitudes por llamador está agotado. Espera `Retry-After` antes de enviar la siguiente solicitud. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` El Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud está en un estado que entra en conflicto con la operación. Revisa el tipo de error. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud superó un plazo límite. Revisa el tipo de error antes de reintentar. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` @@ -800,49 +800,49 @@ El endpoint de sondeo. Responde con el estado actual de la solicitud y nunca con OK: el estado en cola actual de la solicitud. - Body: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Credits-Used`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` + Cuerpo: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- Encabezados: `X-Comfy-Request-Id`, `Retry-After`, `X-Comfy-Credits-Used`, `X-Comfy-Estimated-Duration-Seconds`, `X-Comfy-Estimated-Duration-P90-Seconds`, `X-Comfy-Estimate-Source` Credenciales faltantes o no válidas. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` La solicitud no está permitida para este llamador o modelo. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` No se encontró el ID de modelo. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` `rate_limited`: se agotó la cuota de solicitudes por llamador. Espera `Retry-After` antes de enviar la siguiente solicitud. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` El Router no está disponible temporalmente. Reintenta con retroceso exponencial. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Un fallo a nivel de solicitud del Router: la solicitud nunca llegó al modelo, o falló por un motivo que el propio modelo no reportó. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + Cuerpo: [`RouterErrorResponse`](#routererrorresponse) -- Encabezados: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` Las descripciones aquí son breves. Consulta [Usar la API de Comfy Router](/es/development/comfy-router/api) para la selección de modelos, la validación, los reintentos y la facturación, y [Encabezados](/es/development/comfy-router/headers) para el comportamiento de los encabezados. @@ -1049,7 +1049,8 @@ Límites de la estimación. Una cifra de `200` no garantiza que la ejecución se - `/estimate` no acepta `strict_mode` ni `reject_unknown_fields`, así que solo comprueba el contrato nativo del modelo: un cuerpo que una ejecución con `strict_mode=true` acepta en el esquema propio del proveedor alternativo puede recibir aquí un `422`, y aquí se calcula el precio de un campo de nivel superior no declarado que una ejecución con `reject_unknown_fields=true` rechazaría. Un modelo de Anthropic Messages es la excepción: su esquema permite campos no declarados, así que una ejecución con `reject_unknown_fields=true` no rechaza ninguno, y la estimación solo tarifica los campos de nivel superior no declarados `tools`, `tool_choice`, `temperature`, `top_p`, `top_k`, `stop_sequences`, `metadata`, `thinking` y un `mcp_servers` vacío. Cualquier otro campo de nivel superior no declarado hace que responda `unknown` con `reason: not_quotable`. - `pricing_as_of` indica cuándo se obtuvo la tarjeta de tarifas. Una cotización `estimated` tomada de la lista de precios publicada por el proveedor lleva la fecha en que se leyó esa lista. Una cotización `exact` o `estimated` cuya cantidad facturable se predice a partir de un calendario de precios publicado por el proveedor lleva la fecha de lectura de ese calendario cuando es anterior a la de la tarjeta. Cuando no se leyó ni tarjeta ni calendario, indica cuándo se respondió la estimación. No es un bloqueo de precio: la ejecución se cobra con las tarifas vigentes cuando se tarifica. -- `/estimate` cotiza el tramo que nombra `model_provider`, o el proveedor nativo. No acepta los parámetros `fallback_provider` ni `strict_mode`. Una ejecución síncrona cuyo reintento de fallback recae en otro proveedor se cobra a la tarifa de ese proveedor, que la estimación no cotizó; `X-Comfy-Router-Fallback-Provider` en la respuesta de la ejecución indica que ocurrió. Un envío en cola no tiene fallback, así que su `estimate` cotiza el tramo que se ejecuta.- `/estimate` siempre cotiza el cargo de la plataforma. Comfy no factura una ejecución con tu propia clave de proveedor, pero `/estimate` no lo detecta y aun así devuelve una cifra; solo un envío en cola responde `reason: byok`. +- `/estimate` cotiza el tramo que nombra `model_provider`, o el proveedor nativo. No acepta los parámetros `fallback_provider` ni `strict_mode`. Una ejecución síncrona cuyo reintento de fallback recae en otro proveedor se cobra a la tarifa de ese proveedor, que la estimación no cotizó; `X-Comfy-Router-Fallback-Provider` en la respuesta de la ejecución indica que ocurrió. Un envío en cola no tiene fallback, así que su `estimate` cotiza el tramo que se ejecuta. +- `/estimate` siempre cotiza el cargo de la plataforma. Comfy no factura una ejecución con tu propia clave de proveedor, pero `/estimate` no lo detecta y aun así devuelve una cifra; solo un envío en cola responde `reason: byok`. - Los dólares se calculan a partir de centavos sin redondear, con hasta 8 decimales, y una `amount` cobrable inferior a un centavo nunca se muestra como `0`. `credits` es `round(amount × 211, 2)`, la misma conversión que `X-Comfy-Credits-Used` aplica a un cargo, así que `credits` puede redondearse a `0` para un precio muy pequeño distinto de cero; presupuesta con `amount` o `amount_cents`, no con `credits`, cuando eso importe. Ese encabezado sigue siendo la cifra a posteriori de una ejecución; los saldos están en la plataforma de Comfy. ## Recursos del resultado @@ -1315,13 +1316,13 @@ Una página del catálogo de modelos de Router. **Campos** - + Los modelos de esta página, como máximo `limit` de ellos. Tipo: arreglo de [`RouterModelListEntry`](#routermodellistentry) - + Indica si existe otra página después de esta. Sigue avanzando mientras esto sea verdadero; no deduzcas el final del catálogo a partir de un `data` corto o vacío. @@ -1331,7 +1332,7 @@ Una página del catálogo de modelos de Router. Tipo: [`RouterPageCursor`](#routerpagecursor): cursor opaco devuelto como `next_cursor`, de 1–512 caracteres - + El tamaño de página que realmente se entregó. Un `limit` solicitado que supere el máximo se ajusta al máximo en lugar de rechazarse, así que este valor puede ser menor que el solicitado: pagina con este número, no con el que enviaste, o asumirás filas que nunca recibiste. 1–100 diff --git a/es/development/serverless/library-models.mdx b/es/development/serverless/library-models.mdx deleted file mode 100644 index 93cb5f1719..0000000000 --- a/es/development/serverless/library-models.mdx +++ /dev/null @@ -1,171 +0,0 @@ ---- -title: "Modelos de la biblioteca del espacio de trabajo en un despliegue de Comfy API" -sidebarTitle: "Modelos de la biblioteca" -description: "Sube un LoRA u otro modelo .safetensors a la biblioteca de tu espacio de trabajo y ejecútalo en un despliegue de Comfy API sin nuevo Build, Release ni redeploy." -icon: "folder-open" -translationSourceHash: ece5d691 -translationFrom: development/serverless/library-models.mdx -translationBlockHashes: - "_intro": 6a0b3555 - "Before you start": c7b9ddf9 - "Upload a model to the workspace library": 693a12a3 - "Run the model on your deployment": 8b7df85e - "Follow the limits and naming rules": 5b0d3461 - "Change or delete a library model": dda1b7bd ---- -Comfy API ejecuta modelos desde la biblioteca de tu espacio de trabajo, incluso cuando el Release del despliegue no los incluye. Sube un LoRA u otro modelo `.safetensors` a la biblioteca y ejecútalo en tu despliegue sin crear un nuevo Build o Release ni volver a desplegar. - -Usa la biblioteca del espacio de trabajo para probar un LoRA que entrenaste en tu despliegue, o para elegir un LoRA distinto para cada solicitud a la API cambiando un nombre de archivo en el flujo de trabajo. - -## Antes de empezar - -Antes de subir un modelo a la biblioteca del espacio de trabajo, asegúrate de cumplir estos requisitos: - -- **Plan**: tu espacio de trabajo necesita un plan Pro, Creator, Team o Enterprise activo. -- **Archivo del modelo**: el archivo debe ser un `.safetensors` de 2 GB o menos. Los modelos base más grandes, como SDXL o Flux, aún van en el Build. -- **Una implementación activa**: la implementación debe estar en el mismo espacio de trabajo que la biblioteca. - - - Algunas implementaciones creadas antes de que los modelos de la biblioteca del espacio de trabajo estuvieran disponibles no pueden cargarlos. Para usar los modelos de la biblioteca del espacio de trabajo, crea una nueva implementación. En una implementación más antigua, una tarea puede fallar con `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` - - -## Subir un modelo a la biblioteca del espacio de trabajo - -Puedes subir un modelo con cualquiera de estas tres herramientas: - -- **Editor de Cloud**: sube un archivo o importa desde un enlace de Civitai o Hugging Face. -- **comfy-cli**: sube desde una terminal o un script. -- **Developer Platform**: sube desde el paso de modelos de un Build. - -Elige la pestaña de la herramienta que uses. - - - - 1. En el menú de despliegue a la izquierda de **Run**, asegúrate de que **Comfy Cloud** esté seleccionado en **Run on**. - 2. En la **barra lateral izquierda**, haz clic en **Model Library** y luego en **Import**. - 3. Haz clic en **Choose a file** o arrastra un archivo `.safetensors` al cuadro de diálogo. - 4. En **What type of model is this?**, deja **LoRA** si es una LoRA o selecciona el tipo que coincida con el archivo. - 5. Haz clic en **Upload**. Cuando termine la subida, haz clic en **Finish**. - - ![Diálogo Import a model con my_style_lora_9e2417.safetensors (97.37 MB) seleccionado, What type of model is this? establecido en LoRA, y los botones Back y Upload](/images/development/serverless/library-models-editor-import.png) - - Para importar un modelo desde un enlace de Civitai o Hugging Face: - - 1. En el diálogo **Import**, pega el enlace del modelo en **Paste link here**. - 2. Haz clic en **Continue**. - 3. En **What type of model is this?**, selecciona el tipo de modelo. - 4. Haz clic en **Import**. - - Solo los archivos `.safetensors` se ejecutan en un despliegue. Si importas un enlace en otro formato, como `.ckpt`, el modelo entra en la biblioteca pero no se ejecuta en un despliegue. - - - Sube el archivo y define su tipo de modelo con `--type`: - - ```bash - comfy assets library upload my_style.safetensors --type loras - ``` - - Verifica que el archivo esté en la biblioteca: - - ```bash - comfy assets library ls --tags models,loras - ``` - - - 1. En la Developer Platform, abre el paso de modelos de un Build y haz clic en **Upload Models**. - 2. Selecciona **Workspace library**. - 3. Arrastra un archivo `.safetensors` al área de carga o haz clic en el área para explorar. - 4. En **Model type**, deja **LoRA** si es una LoRA o selecciona el tipo que coincida con el archivo. - 5. Haz clic en **Upload**. - - ![Diálogo Upload Models en el paso Which models ship inside the build? de un Build, con las pestañas Public, Private y Workspace library, Workspace library seleccionado, la zona para soltar archivos, Model type establecido en LoRA, una línea que indica que el archivo está en tu biblioteca del espacio de trabajo, y los botones Cancel y Upload](/images/development/serverless/library-models-platform-upload.png) - - - -Todos los miembros del espacio de trabajo pueden usar el modelo una vez que está en la biblioteca. La biblioteca acepta cualquier tipo de modelo, no solo LoRAs. Elige el tipo que coincida con la carpeta que lee tu nodo de carga, como `loras` para una LoRA o `vae` para un VAE. - -## Ejecutar el modelo en tu implementación - -Una vez que el modelo está en la biblioteca, puedes ejecutarlo en tu implementación desde el editor de Cloud o a través de la API. Elige la pestaña según cómo envíes las tareas. - - - - 1. Haz clic en el menú de implementación a la izquierda de **Run**. En **Run on**, selecciona tu implementación. El editor se recarga y tus pestañas permanecen abiertas. - 2. Agrega un nodo `Load LoRA (Model and CLIP)` o abre un flujo de trabajo que contenga uno. - 3. En la lista `lora_name` del nodo, selecciona tu archivo. La lista muestra los modelos de tu biblioteca junto a los modelos de la Release. - 4. Haz clic en **Run**. - - En la primera ejecución, la fila de la tarea en la cola muestra `Downloading my_style.safetensors` mientras el worker descarga el archivo. Cuando la tarea descarga varios modelos, la fila muestra `Downloading ( of )`. - - ![Flujo de trabajo con los nodos Load Checkpoint y Load LoRA (Model and CLIP), el LoRA subido seleccionado en lora_name, y la fila superior del panel de cola mostrando Downloading my_style_lora_9e2417.safetensors 0 B of 97.37 MB](/images/development/serverless/library-models-editor-downloading.png) - - - En el [flujo de trabajo en formato API](/es/development/api-development/workflow-api-format), establece la entrada `lora_name` del nodo `LoraLoader` con el nombre del archivo de la biblioteca, incluida la extensión `.safetensors`: - - ```json - "10": { - "class_type": "LoraLoader", - "inputs": { - "lora_name": "my_style.safetensors", - "strength_model": 1.0, - "strength_clip": 1.0, - "model": ["4", 0], - "clip": ["4", 1] - } - } - ``` - - Envía el flujo de trabajo con `comfy deploy run`, los [SDK de Comfy](/es/development/api-development/sdks) o la [Comfy API v2](/es/api-reference/v2/overview): - - ```bash - comfy deploy run --deployment --workflow workflow_api.json - ``` - - Para usar un LoRA diferente, cambia `lora_name` por otro nombre de archivo de tu biblioteca en la siguiente solicitud. No necesitas un nuevo Build, Release ni volver a implementar. - - - - - La primera tarea en un worker que usa un modelo de la biblioteca tarda más, porque el worker descarga el modelo primero. Las tareas posteriores en el mismo worker usan la copia en caché. Un worker nuevo descarga el modelo otra vez, y también lo hace un worker que eliminó el modelo de su caché para hacer espacio a otros modelos. Para saltar la descarga, agrega el modelo al Build. - - -## Cumplir los límites y las reglas de nomenclatura - -Además de los límites de tamaño de archivo y formato en [Antes de empezar](#antes-de-empezar), se aplican estos límites: - -| Límite | Valor | -| --- | --- | -| Almacenamiento del espacio de trabajo | 1 TB de modelos por espacio de trabajo, incluidas las importaciones por enlace | -| Nombres de modelos de la biblioteca por flujo de trabajo | 100 | - -Un cargador que nombra un modelo de biblioteca número 101 falla como si el archivo no estuviera en la biblioteca. - -Sigue estas reglas para que una tarea encuentre el archivo correcto: - -- **Usa la carpeta que lee el cargador.** Un cargador solo encuentra archivos de biblioteca de su propio tipo de modelo. Un nodo `Load LoRA` encuentra archivos subidos como `loras`, no como `checkpoints`. -- **Usa el nombre del archivo sin ruta.** Establece la entrada del cargador solo en el nombre del archivo, como `my_style.safetensors`, sin ninguna carpeta delante. -- **No reutilices el nombre de un modelo de una Release.** Si la Release ya tiene un archivo con ese nombre, el worker usa el archivo de la Release, no tu archivo de biblioteca. -- **Mantén los nombres únicos entre carpetas.** Si la biblioteca tiene el mismo nombre de archivo en dos carpetas que lee un solo cargador, una tarea enviada a través de la API no carga ninguno de los dos archivos. -- **Espera que gane el archivo más reciente.** Si la biblioteca tiene dos archivos con el mismo nombre en una carpeta, las tareas usan el que se agregó al final. -- **Haz coincidir el modelo base.** Un LoRA debe coincidir con el modelo base que carga el flujo de trabajo. -- **Usa un cargador disponible en el despliegue.** El nodo de carga debe estar disponible en el despliegue. Los modelos de biblioteca solo se cargan mediante nodos de carga que Comfy Cloud tenga. Si tu cargador viene de un nodo personalizado que Comfy Cloud no tiene, agrega sus modelos al Build. - -## Cambiar o eliminar un modelo de la biblioteca - -Cuando hay una implementación seleccionada en **Run on**, la **Biblioteca de modelos** muestra solo los modelos de la Release. Para cambiar o eliminar un modelo de la biblioteca, primero vuelve a Comfy Cloud: - -1. Haz clic en el menú de implementación a la izquierda de **Run**. En **Run on**, selecciona **Comfy Cloud**. -2. En la **barra lateral izquierda**, haz clic en **Biblioteca de modelos**. - -Para cambiar el tipo de modelo: - -- Pasa el cursor sobre la tarjeta del modelo, haz clic en **Información del modelo** y selecciona un nuevo **Tipo de modelo**. - - - Eliminar un modelo lo quita de la biblioteca del espacio de trabajo para todos los miembros. Una tarea o solicitud de API que todavía nombre el archivo falla con un error `Value not in list` en la entrada del loader. - - -Para eliminar el modelo: - -1. Pasa el cursor sobre la tarjeta del modelo, haz clic en **Más** y luego en **Eliminar**. -2. En **¿Eliminar este modelo?**, haz clic en **Eliminar**. diff --git a/es/development/serverless/overview.mdx b/es/development/serverless/overview.mdx index eb72cecde1..2d6f1407cb 100644 --- a/es/development/serverless/overview.mdx +++ b/es/development/serverless/overview.mdx @@ -175,7 +175,7 @@ comfy deploy events --deployment dep_123456 La facturación de almacenamiento comienza con un despliegue: - - Cuando despliegas un release, sus modelos se copian de forma provisional al almacenamiento en red que comparten los workers del despliegue. Ese almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con `comfy deploy stop`. Los modelos que una tarea usa de tu [biblioteca del espacio de trabajo](/es/development/serverless/library-models) no se copian allí. El worker los descarga para la tarea. + - Cuando despliegas un release, sus modelos se copian de forma provisional al almacenamiento en red que comparten los workers del despliegue. Ese almacenamiento es de solo lectura después del despliegue y se factura por GB-mes mientras exista cualquier despliegue del Build en esa región, incluso mientras un despliegue está en pausa con `comfy deploy stop`. Los modelos que una tarea usa de tu [biblioteca del espacio de trabajo](/es/development/deploy/cloud-custom-builds#agregar-tu-propio-lora-o-modelo) no se copian allí. El worker los descarga para la tarea. - Cada worker también recibe un disco de contenedor fijo de 50 GB. Es efímero y solo se factura mientras el worker está en ejecución, como parte del costo de cómputo del worker. - Eliminar un despliegue libera su cómputo. El almacenamiento en red provisional se limpia poco después de eliminar el último despliegue que lo usa en esa región, y la facturación correspondiente termina. diff --git a/es/tutorials/video/ltx/ltx-2-3.mdx b/es/tutorials/video/ltx/ltx-2-3.mdx index 214053b28b..311070bfe2 100644 --- a/es/tutorials/video/ltx/ltx-2-3.mdx +++ b/es/tutorials/video/ltx/ltx-2-3.mdx @@ -200,7 +200,7 @@ ComfyUI/ ### LTX-2.3: convertir de primer y último fotograma a video {#video_ltx2_3_flf2v} -Interpola entre una imagen inicial y una final. +Interpola entre una imagen inicial y una imagen final para generar una transición de video suave. @@ -248,6 +248,8 @@ ComfyUI/ │ └── gemma_3_12B_it_fp4_mixed.safetensors ``` +--- + ### LTX-2.3 Imagen y audio a video {#video_ltx2_3_ia2v} Genera videos con sincronización de labios a partir de una imagen y un audio. @@ -531,11 +533,11 @@ Remove subtitles, captions, and related text occlusions from the video, restorin ### LTX-2.3 ID LoRA {#video_ltx2_3_id_lora} -Genera videos personalizados con audio sincronizado a partir de una imagen de referencia y un clip de audio. +Genera videos personalizados con audio sincronizado a partir de un prompt de texto, una imagen de referencia y un clip de audio corto. Usa ID-LoRA para adaptar la apariencia y la voz de una persona en un solo modelo generativo. -LTX-2.3 ID LoRA (vista previa del flujo de trabajo +LTX-2.3 ID LoRA (vista previa del flujo de trabajo) @@ -591,7 +593,7 @@ ComfyUI/ │ └── ltx-2.3-spatial-upscaler-x2-1.1.safetensors ``` -## Sugerencias de prompts +## Consejos para escribir prompts Al escribir prompts para LTX-2.3, describe las acciones y las escenas con detalle y en orden cronológico: diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index cf80898375..5afd75c625 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -161,7 +161,9 @@ Router はモデルを実行します。ファイルのアップロード、ア Router は各参照のサイズを見つけるために最初の 2 MiB のみを読み取るため、そのウィンドウ内でサイズ情報を読み取り完了できない画像(たとえば、2 MiB を超える埋め込みメタデータを含む JPEG、または透過データ、それがなければ最初の画像データチャンクの先頭が 2 MiB を超えた位置にあるパレット PNG。たとえば 2 MiB を超えるテキストやカラープロファイルチャンクの後など)は、サイズヘッダーが最初の 2 MiB 以内にないと述べる `400` で拒否され、アップロードしても役に立ちません。まず大きなメタデータを含めずに再保存するか、パレット PNG を非パレット(トゥルーカラー)PNG として保存してください。国際化されたホスト名は ASCII(punycode)形式で送信してください。たとえば `bücher.de` ではなく `xn--bcher-kva.de` です。Router は記述されたとおりにホストを検索し、非 ASCII の名前は存在しないホストとして拒否されます。 -アップロードはすべての環境で機能するため、移植性のある選択肢です。常にアップロードが返したとおりに `image_url` を渡してください。画像がまだ公開 `https` URL にない場合は、まずアップロードしてください:1. 各参照画像を `multipart/form-data` としてアップロードします。画像はフォームフィールド `file` に含めます(JPEG、PNG、または WebP、最大 75 MB)。Router と同じ方法で、`X-API-Key` または `Authorization: Bearer` を使用して認証します。 +アップロードはすべての環境で機能するため、移植性のある選択肢です。常にアップロードが返したとおりに `image_url` を渡してください。画像がまだ公開 `https` URL にない場合は、まずアップロードしてください: + +1. 各参照画像を `multipart/form-data` としてアップロードします。画像はフォームフィールド `file` に含めます(JPEG、PNG、または WebP、最大 75 MB)。Router と同じ方法で、`X-API-Key` または `Authorization: Bearer` を使用して認証します。 ```bash curl -X POST https://api.comfy.org/proxy/krea/assets \ diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index 99253ba0fd..f2d67373bc 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -113,7 +113,8 @@ translationBlockHashes: - [Pika H3 Flex テキストから動画へ](/ja/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika サウンドトラック](/ja/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` - [V3.5](/ja/development/comfy-router/models/pixverse/v3-5/code): `pixverse/v3.5` -- [V6 Max](/ja/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max`- [V6](/ja/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` +- [V6 Max](/ja/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max` +- [V6](/ja/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` - [P Video 2](/ja/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/ja/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/ja/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` @@ -170,7 +171,8 @@ translationBlockHashes: - [Image Edit Erase Foreground](/ja/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` - [Image Edit Erase](/ja/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` - [Image Edit Expand](/ja/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` -- [Image Edit Gen Fill](/ja/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill`- [Image Edit Increase Resolution](/ja/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` +- [Image Edit Gen Fill](/ja/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` +- [Image Edit Increase Resolution](/ja/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [Image Edit Product Holding](/ja/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [Image Edit Product Virtual Tryon](/ja/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` - [Image Edit Relight](/ja/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` @@ -219,7 +221,8 @@ translationBlockHashes: - [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` -- [GPT Image 2.6 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare`- [GPT Image 2.6 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` +- [GPT Image 2.6 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare` +- [GPT Image 2.6 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` - [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Arrow 2 Telos](/ja/development/comfy-router/models/quiver/arrow-2-telos/code): `quiver/arrow-2-telos` - [Arrow 2](/ja/development/comfy-router/models/quiver/arrow-2/code): `quiver/arrow-2` @@ -269,7 +272,8 @@ translationBlockHashes: - [Wan 2.5 T2I Preview](/ja/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` - [Seedvr 2](/ja/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` - [Ultimate Image Upscaler](/ja/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` -- [Grok Imagine Image 2.0](/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0`- [Grok Imagine Image Pro](/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` +- [Grok Imagine Image 2.0](/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0` +- [Grok Imagine Image Pro](/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` - [Grok Imagine Image Quality](/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code): `xai/grok-imagine-image-quality` - [Grok Imagine Image](/ja/development/comfy-router/models/xai/grok-imagine-image/code): `xai/grok-imagine-image` @@ -329,7 +333,8 @@ translationBlockHashes: - [Animations](/ja/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/ja/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` -- [Meshy 7.1](/ja/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1`- [Meshy 7](/ja/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` +- [Meshy 7.1](/ja/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` +- [Meshy 7](/ja/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` - [Remesh](/ja/development/comfy-router/models/meshy/remesh/code): `meshy/remesh` - [Rigging](/ja/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/ja/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` @@ -384,7 +389,8 @@ translationBlockHashes: - [GPT 5 Nano](/ja/development/comfy-router/models/openai/gpt-5-nano/code): `openai/gpt-5-nano` - [GPT 5](/ja/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6.1 Sol](/ja/development/comfy-router/models/openai/gpt-6-1-sol/code): `openai/gpt-6.1-sol` -- [GPT 6.1 Terra](/ja/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra`- [GPT 6 Astra](/ja/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` +- [GPT 6.1 Terra](/ja/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra` +- [GPT 6 Astra](/ja/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ja/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` - [o3](/ja/development/comfy-router/models/openai/o3/code): `openai/o3` diff --git a/ja/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx b/ja/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx index a6a0a1d562..18c160f233 100644 --- a/ja/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx +++ b/ja/development/comfy-router/models/anthropic/claude-opus-4-8/code.mdx @@ -17,7 +17,7 @@ translationBlockHashes: import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; -`anthropic/claude-opus-4-8` の APIリファレンス です。Anthropic から Comfy Router を介して提供されます。 +`anthropic/claude-opus-4-8` の API リファレンスです。Anthropic から Comfy Router を介して提供されます。 **入力:** テキスト, 画像 · **出力:** テキスト diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index e0f5ac5598..bbd81d3def 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -385,7 +385,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。 上流URLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻と有効期間の和で、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusが文書化したURLの寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 - Format: `date-time` + 形式: `date-time` @@ -421,47 +421,47 @@ false: 生成されたビデオの最終フレーム画像を返しません。 - The ID of the video generation task + 動画生成タスクのID - The name and version of the model used by the task + タスクで使用されたモデルの名前とバージョン - Container format of the generated video (mp4 or mov), returned at the TOP LEVEL as a sibling of `content` - this is where the Seedance video task query returns it. BytePlus's own field, forwarded unchanged. + 生成された動画のコンテナ形式(mp4またはmov)で、`content` の兄弟としてトップレベルで返されます。これはSeedanceの動画タスククエリがこの値を返す位置です。BytePlus自身のフィールドで、変更されずにそのまま転送されます。 - The resolution of the generated video, for example `1080p`. BytePlus's own field, returned on succeeded video tasks and forwarded unchanged. + 生成された動画の解像度です(例: `1080p`)。BytePlus自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - The generation seed actually used for the task. BytePlus's own field, returned on succeeded video tasks and forwarded unchanged. + タスクで実際に使用された生成シードです。BytePlus自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - Format: `int64` + 形式: `int64` - The state of the task + タスクの状態 - Possible values: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` + 指定可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - The time when the task was last updated. The value is a UNIX timestamp in seconds. + タスクが最後に更新された時刻です。値は秒単位のUNIXタイムスタンプです。 - The token usage for the request + リクエストのトークン使用量 - The number of tokens generated by the model + モデルによって生成されたトークン数 - For the video generation model, the number of input tokens is not calculated and defaults to 0. Therefore, total_tokens = completion_tokens. + 動画生成モデルでは入力トークン数は計算されず、0がデフォルトです。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index ce0007aedf..82d77787c0 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -230,7 +230,7 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 使用可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 指定可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -255,7 +255,7 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ 入力コンテンツのタイプ - 使用可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -276,7 +276,7 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(auto)。 - 使用可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` + 指定可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15` @@ -289,9 +289,8 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 false: モデルは無音のビデオを出力します。 - - 対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによるコンテンツチェックを受けます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力であっても断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 + 呼び出すモデルの 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 の呼び出し元は省略します。 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 87e2cc990d..2bc2eae248 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -429,7 +429,9 @@ false: 生成されたビデオの最終フレーム画像を返しません。 + ビデオ生成タスクの ID + タスクで使用されたモデルの名前とバージョン diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 901ee04563..c09d00cc1b 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -304,7 +304,7 @@ edit: 接続された参照ビデオを変更します。出力はソースク extend: 参照ビデオを継続します。出力は指定された `duration` の新しく生成されたセグメントのみで、アスペクト比はクリップに従います。 明示的な値は送信時にプロバイダーによって検証されるため(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`)、リクエストに適合しない値は生成が開始される前に失敗し、課金されません。auto にはそのようなチェックはありません。このチェックはネイティブの BytePlus 側でのみ実行されます。代替プロバイダー側(フォールバック時、または `model_provider` で選択した場合)にはタスク種別のフィールドがなく、値は破棄され、そのプロバイダーが auto と同様にタスク自体を推論します。この破棄は、同期実行ルートのレスポンスと、キュー中の送信の `201` において `X-Comfy-Router-Dropped-Params` で開示されます。キュー中のルートにはフォールバックがないため、`model_provider` を通じてのみ代替側に到達します。 - Possible values: `reference`, `edit`, `extend` + 指定可能な値: `reference`、`edit`、`extend` @@ -312,21 +312,21 @@ extend: 参照ビデオを継続します。出力は指定された `duration` mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性があり、ファイルサイズも小さくなります。 mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適していますが、ファイルサイズは大きくなります。 - Possible values: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 Seedance 2.5 の最初のフレーム / 最初と最後のフレームの生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け入れます。 - Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - Possible values: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` @@ -338,13 +338,13 @@ false: 生成されたビデオの最後のフレーム画像を返しません ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 - Range: `-1` to `4294967295` + 範囲: `-1` から `4294967295` 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - Possible values: `default`, `flex` + 指定可能な値: `default`、`flex` @@ -406,7 +406,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - The ID of the video generation task + ビデオ生成タスクの ID diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx deleted file mode 100644 index b041fd3bee..0000000000 --- a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ /dev/null @@ -1,489 +0,0 @@ ---- -title: "Comfy Router で Seedance 1.5 Pro 251215 を使用する" -description: "Comfy Router 経由で byteplus/seedance-1-5-pro-251215 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" -sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 8c658f01 -translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx -translationBlockHashes: - "_intro": 5f93a1f1 - "Quick start": 71aafccf - "Schema": b9957cb9 - "Examples": 7e73ac5c ---- - - - - - -{/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-5-pro-251215.json by `pnpm code-pages:gen`. */} - -import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; - -`byteplus/seedance-1-5-pro-251215` の API リファレンス。BytePlus から Comfy Router によって提供されます。 - -**入力:** テキスト, 画像 · **出力:** ビデオ + オーディオ - -## クイックスタート - -[お使いの Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` と `npm 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` - - - - -```python Python -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) -``` - -```typescript TypeScript -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); -``` - -```bash cURL -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` を返し、結果は準備が整った時点で、このプロセスからでも別のプロセスからでも取得できます。ステータス、キャンセル、結果の取得については[キュー配信](/ja/development/comfy-router/queue)で順を追って説明しています。 - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy - -# 環境変数から COMFY_API_KEY を読み取ります。 -# 各 submit() 呼び出しは独自の Idempotency-Key を発行し、自動リトライのために再利用します。 -async def main(): - async with AsyncComfy() as client: - handle = await 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 だけ待機します。 - async for update in handle.iter_events(): - print(update.status, update.queue_position) - - # プロバイダー自身のペイロードで、models.run() が返す値と同じです。 - # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。 - result = await handle.get() - - print(result) - -asyncio.run(main()) -``` - -```typescript TypeScript -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); -``` - -```bash cURL -# 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="" -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" -``` - - - - -## スキーマ - -### 入力 - - - 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることは一切ありません。結果の取得には代わりにタスクステータスのルートをポーリングしてください。 - - 形式: `uri` - - - - モデルがビデオを生成するための入力コンテンツ - - - - 入力オーディオオブジェクト。オーディオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - - - - オーディオ URL、Base64 エンコード、またはアセット ID。 -Audio URL: オーディオ(wav、mp3)の公開 URL。 -Base64: 形式 data:audio/\;base64,\ -Asset ID: 形式 asset://\ - - - - Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツアイテムである必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を引き継ぐため、これらを再度送信しないでください。最終ビデオの出力ティア(4k を含む)はこのリクエストで解像度を設定してください。省略した場合、最終ビデオは 1080p になります。 - - - - Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。 - - - - - - - - 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -Image URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -Asset ID: 形式 asset://\ - - - - コンテンツアイテムの役割/位置。 -画像の場合: first_frame、last_frame、または reference_image。 -ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 -オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - - 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - - - - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 - -テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 - -パラメータ(任意): テキストプロンプトの後に --[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 独自のバリデータが -応答します。実際のトラフィックよりはるかに高く設定されているため、本物の -プロンプトが判定の対象になることはありません。呼び出し元がより多くを必要と -する場合は引き上げてください。 - - - - 入力コンテンツの種類 - - 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - - - - 入力ビデオオブジェクト。ビデオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 - - - - ビデオ URL またはアセット ID。 -Video URL: ビデオ(mp4、mov)の公開 URL。 -Asset ID: 形式 asset://\ - - - - Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツアイテムに渡して最終ビデオをレンダリングします。そのリクエストで最終ビデオの解像度(4k を含む)を設定します。解像度を省略した場合、最終ビデオは 1080p になります。Draft タスク ID は 7 日間有効です。 - - - - ビデオの再生時間(秒)。Seedance 1.5 pro: [4,12] または -1(自動)。 - - 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - - - - タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48h)。範囲: [3600, 259200]。 - - 範囲: `3600` 〜 `259200` - - - - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 -true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力であっても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 - - - - 呼び出すモデルの 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 の呼び出し元は省略します。 - - - - Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズはより小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズはより大きくなります。 - - 指定可能な値: `mp4`、`mov` - - - - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の first-frame / first-last-frame 生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみ受け付けられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 - - 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - - - - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p、4k をサポートします。 - - 指定可能な値: `480p`、`720p`、`1080p`、`4k` - - - - 生成されたビデオの最後のフレーム画像を返すかどうか。 -true: 生成されたビデオの最後のフレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報のクエリを呼び出して最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用でき、複数の連続したビデオをすばやく生成できます。 -false: 生成されたビデオの最後のフレーム画像を返しません。 - - - - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 - - 範囲: `-1` から `4294967295` - - - - 処理のサービス階層。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。 - - 指定可能な値: `default`、`flex` - - - - 生成されたビデオにウォーターマークを含めるかどうか。 - - -Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 - -### 出力 - - - ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロードURLと、BytePlusが返す場合にはその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされ、ここにある他のすべてのフィールドはBytePlus独自のものです。null許容: BytePlusはタスクの24時間後にURLをクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないかnullであることがあります。 - - - - 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。 - - - - BytePlusが `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式(mp4またはmov)です。Seedanceモデルでは `content` のトップレベルの兄弟として返すことのほうが一般的です。トップレベルの `output_format` フィールドを参照してください。Routerは存在するほうを読み取ります。 - - - - アップストリームのURLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusがドキュメント化しているURLの寿命)を加えた時刻より後になることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 - - 形式: `date-time` - - - - 再ホストされた `last_frame_url` の隣にバイト単位でそのまま返される、BytePlus独自の最終フレームのダウンロードURLです。条件は `upstream_video_url` と同じで、オプトインしたワークスペースのみ、Seedance 2.xのみ、BytePlusがクリアした後は存在せず、`upstream_expires_at` まではベアラ資格情報です。 - - - - 再ホストされた `video_url` の隣にバイト単位でそのまま返される、BytePlus独自の出力ビデオのダウンロードURLです。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされたSeedance 2.xタスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべての場合には存在しません。ワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)も含まれ、BytePlusが生成の24時間後にURLをクリアすると存在しなくなります。これは署名付きオブジェクトストレージのURL、つまりベアラ資格情報であるため、それを保持する誰もが有効期限までビデオをダウンロードできます。秘密情報と同様に扱ってください。`upstream_expires_at` で期限切れになり、Seedance 2.5ではBytePlusが100ダウンロードに制限しており、そのうち1回はRouter自身の再ホストで消費されます。 - - - - 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でのポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus独自のURLを保持し、BytePlusはタスクの24時間後にそれをクリアし、一部のモデルでは100ダウンロードに制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - - - - タスクが作成された時刻です。値は秒単位のUNIXタイムスタンプです。 - - - - 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlusの扱いが一貫していないためです。ビデオタスクでは整数秒が返されることが観測されており、同じBytePlusの他のサーフェスでは小数の再生時間が報告されるため、クライアントは整数値を前提にしてはいけません。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - - - - エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合は、エラー情報が返されます。 - - - - アップストリームのModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの障害を表します。RouterはHTTP 400のエラーエンベロープおよびHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの障害を上書きすることはありません。 - - - - エラーメッセージ - - - - 動画生成タスクの ID - - - - タスクで使用されたモデルの名前とバージョン - - - - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟要素として TOP LEVEL で返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。 - - - - 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - - - - タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - - 形式: `int64` - - - - タスクの状態 - - 指定可能な値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - - - - タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 - - - - リクエストのトークン使用量 - - - - モデルによって生成されたトークン数 - - - - ビデオ生成モデルでは入力トークン数は計算されず、0 がデフォルトとなります。したがって、total_tokens = completion_tokens となります。 - - -## 例 - -### 入力 - -```json -{ - "content": [ - { - "text": "A red fox trotting through a snowy pine forest", - "type": "text" - } - ], - "duration": 5, - "ratio": "16:9", - "resolution": "720p" -} -``` - -### 出力 - -```json -{ - "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 -} -``` - - diff --git a/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index 93bca7f92f..90ab601520 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -233,7 +233,7 @@ false: 標準の画像生成モード。レイヤー分離は実行されませ - Possible values: `png`、`jpeg` + 指定可能な値: `png`、`jpeg` diff --git a/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx index 9d8c7690db..7b29ff19b7 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx @@ -232,7 +232,7 @@ false: スタンダードな画像生成モード。レイヤー分離は行わ 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御します。各レイヤーは常に png として出力されます。 - Possible values: `png`, `jpeg` + 指定可能な値: `png`、`jpeg` diff --git a/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx index ffd2e636b7..5455e0be6c 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx @@ -229,7 +229,9 @@ false: スタンダードな画像生成モード。レイヤー分離は行わ - 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御し、各レイヤーは常に png で出力されます。Possible values: `png`、`jpeg` + 出力画像の形式を指定します。このパラメータをサポートするのは seedream-5.0-pro、5.0-flash、5.0-lite、5.5 のみです。seedream-5.5 のデフォルトは png です。レイヤー分離シナリオでは、output_format はベース画像の形式のみを制御し、各レイヤーは常に png で出力されます。 + + 可能な値: `png`、`jpeg` diff --git a/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx index 661b00115d..36752141ff 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx @@ -237,10 +237,11 @@ false: 標準の画像生成モード。レイヤー分離は行われません - バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされていません)。有効な値:auto: 自動モードでは、モデルがユーザーのプロンプトに基づいて複数の画像を返すかどうか、および含まれる画像数を自動的に決定します。 + バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされていません)。有効な値: +auto: 自動モードでは、モデルがユーザーのプロンプトに基づいて複数の画像を返すかどうか、および含まれる画像数を自動的に決定します。 disabled: バッチ生成機能を無効にします。モデルは1枚の画像のみを生成します。 - 可能な値: `auto`, `disabled` + 指定可能な値: `auto`、`disabled` diff --git a/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx b/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx index 53e26831bb..3cb7525f23 100644 --- a/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx @@ -231,7 +231,8 @@ false: 標準の画像生成モードです。レイヤー分離は行われま - バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。指定可能な値:auto: 自動モードでは、モデルはユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および画像を何枚含めるかを自動的に決定します。 + バッチ生成機能を無効にするかどうかを制御します。このパラメータは seedream-5.0-lite、4.5、4.0 でのみサポートされています(seedream-5.0-pro、5.0-flash、5.5 ではサポートされません)。指定可能な値: +auto: 自動モードでは、モデルはユーザーのプロンプトに基づいて、複数の画像を返すかどうか、および画像を何枚含めるかを自動的に決定します。 disabled: バッチ生成機能を無効にします。モデルは1枚の画像のみを生成します。 指定可能な値: `auto`, `disabled` diff --git a/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index a7489d2bbd..18aaa177f4 100644 --- a/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -302,7 +302,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash-image/requests/$R 範囲: `0` から `2` - 形式: `浮動小数点` + 形式: `float` @@ -336,7 +336,7 @@ Top-P は、モデルが出力するトークンを選択する方法を変更 範囲: `0` から `1` - 形式: `浮動小数点` + 形式: `float` @@ -570,15 +570,13 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 - コンテンツが違反する可能性のある安全カテゴリ - - 可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全カテゴリに違反する確率 - 可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -604,7 +602,7 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 入力または出力コンテンツのモダリティのタイプ。 - 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -622,7 +620,7 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 入力または出力コンテンツのモダリティのタイプ。 - 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -644,7 +642,7 @@ Router が `GET /v2/models/vertexai/gemini-2.5-flash-image/openapi.json` で提 入力または出力コンテンツのモダリティのタイプ。 - 可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index cda87c2e0b..dc4d60b15e 100644 --- a/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -558,13 +558,13 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全性カテゴリに違反する確率 - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -590,7 +590,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -608,7 +608,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -630,7 +630,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` diff --git a/ja/development/comfy-router/models/google/gemini-4-argon/code.mdx b/ja/development/comfy-router/models/google/gemini-4-argon/code.mdx index 4ae0571753..d30ae4592b 100644 --- a/ja/development/comfy-router/models/google/gemini-4-argon/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -15,7 +15,7 @@ translationBlockHashes: import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; -`vertexai/gemini-4-argon` の API リファレンスです。Comfy Router が Google から提供しています。 +`vertexai/gemini-4-argon` の API リファレンスです。Comfy Router が Google のモデルを提供しています。 **入力:** テキスト、画像、オーディオ、ビデオ · **出力:** テキスト diff --git a/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx index 4d0508ff25..5d3cb59bb9 100644 --- a/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -554,13 +554,13 @@ Router が `GET /v2/models/vertexai/gemini-4-carbon/openapi.json` で提供す - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全性カテゴリに違反する確率 - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -586,7 +586,7 @@ Router が `GET /v2/models/vertexai/gemini-4-carbon/openapi.json` で提供す 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -604,7 +604,7 @@ Router が `GET /v2/models/vertexai/gemini-4-carbon/openapi.json` で提供す 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -626,7 +626,7 @@ Router が `GET /v2/models/vertexai/gemini-4-carbon/openapi.json` で提供す 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/ja/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx b/ja/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx index 97cabef00c..2a4b41cc0e 100644 --- a/ja/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx @@ -554,7 +554,7 @@ Top-P は、モデルが出力するトークンを選択する方法を変更 - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx b/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx index 60ca78c614..212744dfc9 100644 --- a/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx +++ b/ja/development/comfy-router/models/google/gemini-nano-banana-2-1/code.mdx @@ -566,13 +566,13 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` コンテンツが指定された安全性カテゴリに違反する確率 - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 指定可能な値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -598,7 +598,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -616,7 +616,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -638,7 +638,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 入力または出力コンテンツのモダリティの種類。 - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 指定可能な値: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/ja/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/ja/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index 4c9ff0d7ab..f492d60202 100644 --- a/ja/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/ja/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -310,7 +310,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Available for the following models:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + seed を特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じ seed 値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムな seed 値が使用されます。次のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 @@ -390,7 +390,7 @@ Top-P は、モデルが出力用のトークンを選択する方法を変更 - システムがモデルの知識や适用范围外で 1 つまたは複数のアクションを実行するために、外部システムとやり取りできるようにするコード。関数呼び出しを参照してください。 + システムがモデルの知識や適用範囲外で 1 つまたは複数のアクションを実行するために、外部システムとやり取りできるようにするコード。関数呼び出しを参照してください。 @@ -590,7 +590,7 @@ Router が `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json` - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/ja/development/comfy-router/models/google/nano-banana-2/code.mdx b/ja/development/comfy-router/models/google/nano-banana-2/code.mdx index 40a3dc4ebf..eb975fcaf7 100644 --- a/ja/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/ja/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -606,8 +606,6 @@ Top-P は、モデルが出力のためにトークンを選択する方法を - コンテンツが該当する安全カテゴリ - 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/ja/development/comfy-router/models/google/nano-banana-pro/code.mdx b/ja/development/comfy-router/models/google/nano-banana-pro/code.mdx index b8ebca987a..86c295c3c8 100644 --- a/ja/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/ja/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -327,7 +327,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Available for the following models:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + シードを特定の値に固定すると、モデルは繰り返しのリクエストに対して同じ応答を返せるよう最善を尽くします。決定的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。次のモデルで利用できます: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 diff --git a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx index a5e7e6fbe3..c7595b0210 100644 --- a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -268,7 +268,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - ポジティブテキストプロンプト。\>> を使用して、voice_list パラメータの順序に対応する音声を指定します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 + ポジティブテキストプロンプト。\<\<\>> を使用して、voice_list パラメータの順序に対応する音声を指定します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。 @@ -284,7 +284,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順序に従って `prompt` 内で \>> および \>> として参照します。`sound` を "on" に設定する必要があり、これをサポートするのはモデルの V2.6 以降のバージョンのみです。それ以前のモデル、または `sound` をデフォルトの "off" のままにした場合、音声は適用されません。 + ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順序に従って `prompt` 内で \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これをサポートするのはモデルの V2.6 以降のバージョンのみです。それ以前のモデル、または `sound` をデフォルトの "off" のままにした場合、音声は適用されません。 @@ -300,12 +300,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - -参照画像:URL または Base64 エンコード文字列。10MB を超えることはできません。解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 + 参照画像:URL または Base64 エンコード文字列。10MB を超えることはできません。解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 - 参照画像:終了フレームの制御。URL または Base64 エンコード文字列。10MB を超えることはできません。解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask またはカメラコントロールと同時に使用することはできません。 + 参照画像:終了フレームの制御。URL または Base64 エンコード文字列。10MB を超えることはできません。解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control と同時に使用することはできません。 diff --git a/ja/development/comfy-router/models/kling/kling-v3/code.mdx b/ja/development/comfy-router/models/kling/kling-v3/code.mdx index d179602d02..1fc6df11a0 100644 --- a/ja/development/comfy-router/models/kling/kling-v3/code.mdx +++ b/ja/development/comfy-router/models/kling/kling-v3/code.mdx @@ -315,12 +315,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \ - -Reference Image - URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image プレフィックスを含めないでください。 + 参照画像 - URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上、アスペクト比は 1:2.5 ~ 2.5:1 の範囲である必要があります。Base64 には data:image というプレフィックスを含めないでください。 - Reference Image - 終了フレーム制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control とは同時に使用できません。 + 参照画像 - 終了フレーム制御。URL または Base64 エンコード文字列。10MB を超えることはできず、解像度は 300*300px 以上である必要があります。Base64 には data:image プレフィックスを含めないでください。dynamic_masks/static_mask または camera_control とは同時に使用できません。 diff --git a/ja/development/comfy-router/models/krea/krea-2/code.mdx b/ja/development/comfy-router/models/krea/krea-2/code.mdx index 06c32d533e..d09aefc3e2 100644 --- a/ja/development/comfy-router/models/krea/krea-2/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-2/code.mdx @@ -238,7 +238,7 @@ Routerが `GET /v2/models/krea/krea-2/openapi.json` で提供するスキーマ - statusが失敗した場合にのみ設定されます。キャンセル済みのジョブには含まれません。 + `status` が `failed` の場合にのみ設定されます。キャンセル済みのジョブには含まれません。 diff --git a/ja/development/comfy-router/models/krea/krea-3/code.mdx b/ja/development/comfy-router/models/krea/krea-3/code.mdx index a4d30258d7..3cd84dd5da 100644 --- a/ja/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-3/code.mdx @@ -232,7 +232,7 @@ Router が `GET /v2/models/krea/krea-3/openapi.json` で提供するスキーマ - このドキュメントでは常に `completed` です。Router が成功として報告する唯一のステータスであり、Krea の語彙は大文字と小文字を区別せずに照合されます。 + このドキュメントでは常に `completed` です。Router が成功として報告する唯一のステータスであり、Krea の語彙は大文字と小文字を変換せずにそのまま照合されます。 取り得る値: `completed` diff --git a/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx b/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx index eb21388415..b9fb0a6d34 100644 --- a/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx +++ b/ja/development/comfy-router/models/ltx/ltx-video-alpha-gen/code.mdx @@ -162,7 +162,7 @@ Router が `GET /v2/models/ltx/ltx-video-alpha-gen/openapi.json` で配信する - status が失敗の場合に存在します + status が failed の場合に存在します @@ -178,7 +178,7 @@ Router が `GET /v2/models/ltx/ltx-video-alpha-gen/openapi.json` で配信する - status が完了の場合に存在します。出力 URL は完了から 24 時間後に失効します + status が completed の場合に存在します。出力 URL は完了から 24 時間後に失効します @@ -190,7 +190,7 @@ Router が `GET /v2/models/ltx/ltx-video-alpha-gen/openapi.json` で配信する - ジョブのステータス(保留中、処理中、完了、失敗) + ジョブのステータス(pending、processing、completed、failed) ## 例 diff --git a/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index d6a32bd887..bcc868746b 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -180,7 +180,7 @@ URL は認証情報なしで解決できる必要があります。Router はサ 2 つの拡張が展開中で、どちらも現在はデフォルトで無効です。これらは 1 つの切り替えの背後で提供され、一緒に有効化されます。したがって以下はすべて今後に予定されているものとして扱い、まだそれに依存した実装はしないでください。どちらかに依存する前に確認してください。 1 つ目は `POST /customers/storage` がアップロード先として署名するバケットです。展開がお使いの環境に到達するまで、このエンドポイントから得たアップロード URL はここで拒否されます。バケットは Comfy 自身のものでホストも同じであるにもかかわらずです。そのため「Comfy にアップロードしてから URL を渡す」方法はまだ機能せず、機能するのは `/api/assets/{id}/content` がリダイレクトする署名付き URL です。 2 つ目は全員に一度にではなくアカウント単位で有効化されます。これらのホストの背後にあるバケットは当社のものではなくお客様のものであるためです。上の切り替えがオンになっていても、サードパーティの受信メディアが有効になっていないアカウントは拒否され、ホストがサポート対象外であると告げられるのではなく、その旨がそのままの文言で通知されます。お使いのアカウントで有効化するよう Comfy の担当者に依頼してください。これにより、バケットがお客様のもので Router が所有権を主張しない以下のサードパーティ オブジェクトストレージ ホストも追加で許可されます: Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` および `s3..amazonaws.com`、パス形式または `.` を先頭に付ける形式のいずれか)、Azure Blob Storage(`.blob.core.windows.net`)、Alibaba Cloud OSS(`.oss-.aliyuncs.com`、`oss-accelerate` エンドポイントを含む)。これらは具体的にはオブジェクトストレージのエンドポイントです。同じプロバイダーのドメイン上の汎用エンドポイント、たとえば Alibaba Function Compute のトリガーはリストに含まれず拒否されます。 -照合されるのはプロバイダーではなくホスト名の形式です。したがって上でプロバイダーを挙げたからといって、そのプロバイダーが発行しうるすべての URL が受け入れられるわけではありません。呼び出し元がそれぞれに到達するのは自然なことなので、紛らわしい 3 つのケースを明示しておきます。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限のあるデバッグ用ホスト名として文書化し、本番トラフィックはカスタムドメインに向けるよう案内していますが、カスタムドメインのホスト名には R2 であることを示す情報がないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントに署名するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれと同じ形式が記載されているため、それらを読むためにここに来る必要はありません。上記の `` と `pub-` というプレースホルダーは、通常アクセスする際の形式を示すものであり、階層の制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間の下にあるより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって広がるわけではないのは名前空間そのものです。サフィックスは依然として列挙されたもののいずれかでなければなりません。 +照合されるのはプロバイダーではなくホスト名の形式です。したがって上でプロバイダーを挙げたからといって、そのプロバイダーが発行しうるすべての URL が受け入れられるわけではありません。呼び出し元がそれぞれに到達するのは自然なことなので、紛らわしい 3 つのケースを明示しておきます。R2 のカスタムドメイン(`cdn.example.com`)は受け入れられません。Cloudflare は `pub-.r2.dev` をレート制限のあるデバッグ用ホスト名として文書化し、本番トラフィックはカスタムドメインに向けるよう案内していますが、カスタムドメインのホスト名には R2 であることを示す情報がないため、Router は他のホストと区別できず拒否します。`.r2.cloudflarestorage.com` エンドポイントに署名するか、`pub-.r2.dev` 形式を使用してください。S3 の IPv6 dualstack エンドポイント(`s3.dualstack..amazonaws.com`)も受け入れられません。通常のリージョナルエンドポイントを使用してください。Azure Blob の代替 DNS ゾーン(`.z.blob.storage.azure.net`)も同様です。`.blob.core.windows.net` を使用してください。返される拒否メッセージにはこれと同じ形式が記載されているため、それらを読むためにここに来る必要はありません。 上記の `` と `pub-` プレースホルダーは、通常たどり着く形式を示したものであり、深さの制限ではありません。マッチングはオブジェクトストレージのドメインサフィックスに対して行われるため、同じ名前空間配下のより深い名前(`a.b.pub-.r2.dev`)も受け入れられます。ただし、それによって広がるわけではないのは名前空間そのものです。サフィックスは依然として列挙されたもののいずれかでなければなりません。 以下の例は形状のみを示しています。実際の値には署名用のクエリパラメータも含まれますが、ここでは意図的に省略しています。公開された例は仕様の中に永久に残り、実際の署名は漏えいした認証情報であると同時に、やがて機能しなくなるリンクでもあるためです。 各画像は 25 MiB、1 回のリクエストの画像は合計 64 MiB に制限されます。唯一の例外は ideogram/ideogram-4-5 Precise Edit(`image` を送信する呼び出し)で `context_window` が利用可能な場合です。その場合は各画像が最大 50 MB(50,000,000 バイト)かつ 67,108,864 ピクセル、1 回のリクエストの画像は合計最大 128 MiB となります。 diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 8505cb8c0a..7f47c18453 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -162,6 +162,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES - **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare` - **fal**、`fal/fal-gpt-image-2.5-flare` として: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=fal` +- **MiniMax**、`minimax/minimax-gpt-image-2.5-flare` として: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=minimax` - **Runware**、`runware/runware-gpt-image-2.5-flare` として: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=runware` - **WaveSpeed**、`wavespeed/wavespeed-gpt-image-2.5-flare` として: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=wavespeed` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index d748d1d1b7..4c5217deb4 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -162,6 +162,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ - **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst` - **fal**、`fal/fal-gpt-image-2.5-sunburst` として: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=fal` +- **MiniMax**、`minimax/minimax-gpt-image-2.5-sunburst` として: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=minimax` - **Runware**、`runware/runware-gpt-image-2.5-sunburst` として: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=runware` - **WaveSpeed**、`wavespeed/wavespeed-gpt-image-2.5-sunburst` として: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=wavespeed` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index f8d6f37b06..b08e0e8dac 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -155,8 +155,8 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES このモデルは、リクエストで別のプロバイダーを指定しない限り、Comfy Router が直接提供します。以下のプロバイダーも同じエンドポイント、同じモデル ID で提供しており、`model_provider` クエリパラメータで選択します。 -- **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare` -- **MiniMax**(`minimax/minimax-gpt-image-2-6-flare` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare?model_provider=minimax` +- **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare` +- **MiniMax**(`minimax/minimax-gpt-image-2.6-flare` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare?model_provider=minimax` `strict_mode` のデフォルトは false です。そのため Router は、このページに記載されているネイティブのリクエストボディをそのプロバイダー独自のスキーマに変換し、レスポンスを元の形式に翻訳し直します。API リファレンスの [`model_provider`、`strict_mode`、`fallback_provider`](/ja/development/comfy-router/reference#post-v2modelsprovidermodel) と、この方法でルーティングされるすべてのモデルについては[提供プロバイダー](/ja/development/comfy-router/providers)を参照してください。 @@ -327,7 +327,7 @@ URL は認証情報なしで解決できる必要があります。Router はサ 生成が完了した時刻の Unix タイムスタンプ(秒)。OpenAI が画像生成レスポンスで必須と宣言している唯一のメンバーであるため、OpenAI が生成元である場合は必ず含まれます。alt ベースの ID で fal、minimax、pika、wavespeed、runware が提供するレスポンスでは、他の 4 つの解決済みパラメータのメンバーと同様に、このメンバーは完全に省略されます。`int64` として宣言されています。現在のエポック値は 2^31 に十分近いため、未フォーマットの `integer` では多くの SDK ジェネレータが 32 ビットのフィールドを生成してしまうからです。 - Format: `int64` + 形式: `int64` diff --git a/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index ac5776f53c..f02f61bc13 100644 --- a/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -155,8 +155,8 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ このモデルは、リクエストで別のプロバイダーを指定しない限り、Comfy Router が直接提供します。以下のプロバイダーも同じエンドポイント、同じモデル ID で提供しており、`model_provider` クエリパラメータで選択します。 -- **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst` -- **MiniMax**(`minimax/minimax-gpt-image-2-6-sunburst` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst?model_provider=minimax` +- **Comfy**(デフォルト): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst` +- **MiniMax**(`minimax/minimax-gpt-image-2.6-sunburst` として): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst?model_provider=minimax` `strict_mode` のデフォルトは false です。そのため Router は、このページに記載されているネイティブのリクエストボディをそのプロバイダー独自のスキーマに変換し、レスポンスを元の形式に翻訳し直します。API リファレンスの [`model_provider`、`strict_mode`、`fallback_provider`](/ja/development/comfy-router/reference#post-v2modelsprovidermodel) と、この方法でルーティングされるすべてのモデルについては[提供プロバイダー](/ja/development/comfy-router/providers)を参照してください。 diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index c67089d71c..bd6f27015f 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -365,7 +365,7 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用。 wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index 83bc8937c3..41895c8473 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -364,7 +364,7 @@ base64 はペイロードを約4/3に膨らませるため、およそ75 MB を 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合は解像度のティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切なものを自動的に推奨しますアスペクト比は入力メディアの比率と意図に基づいて決まります。 +wan3.0-video では、adaptive(デフォルト)が適切なアスペクト比を自動的に推奨します。アスペクト比は入力メディアの比率と意図に基づいて決まります。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index ed4f7e2f14..62d8e8d560 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -339,7 +339,7 @@ reference_video_urls ではなくここで渡すかどうかは、モデルに 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルの場合、指定しないと解像度ティアに基づいてデフォルト設定されます。 -wan3.0-video の場合、adaptive(デフォルト)は適切な入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video の場合、adaptive(デフォルト)は入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` @@ -478,7 +478,7 @@ resolution はそのモデルに対してこのプロキシが受け付ける値 タスクステータス - 取り得る値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index 2b6dae3c91..e544f81916 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -362,7 +362,8 @@ wan3.0-video の reference モードでは、media 配列内の対応する順 生成されるビデオのアスペクト比。wan2.7 と wan3.0 のモデル専用です。 wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切な値を自動的に推奨します入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video では、adaptive(デフォルト)が、入力メディアの比率と意図に基づいて適切な +アスペクト比を自動的に推奨します。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index e3f0f20da6..ef64260fe3 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -372,7 +372,7 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序に 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive (デフォルト) が適切なアスペクト比は、入力メディアの比率と意図に基づいて決まります。 +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx index 1a4c535a6b..ad5b596571 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx @@ -284,10 +284,9 @@ minItems/maxItems が宣言されていません。許容される type とそ URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 で応答され、base64 は ペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、 -ここに示したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の +ここに示したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の 20MB 上限にインラインで余裕をもって収まるため、1 つのアセットについてはパートナーのルールが制約となります。複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは公開 URL として送信してください。 -20MB の上限はインラインで余裕をもって収まるため、1 つのアセットについてはパートナーのルールが制約となります。複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは公開 URL として送信してください。 メディアアセットの種類 @@ -364,7 +363,7 @@ wan3.0-video の参照モードでは、'Image 1'、'Video 1'、'Audio 1' など 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive (デフォルト) が適切な値を自動的に推奨しますマージン比は入力メディアの比率と意図に基づいて決まります。 +wan3.0-video では、adaptive (デフォルト) が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/ja/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/ja/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index f44eb5b3e0..819e3d0999 100644 --- a/ja/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/ja/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -341,12 +341,11 @@ Comfy Router の POST ボディは合計 100 MiB に制限され、それを超 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive (デフォルト) が適切なものを自動的に推奨します - - -入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video では、adaptive (デフォルト) が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` + + 解像度レベル。サポートされる値はモデルによって異なります: - wan2.5-i2v-preview: 480P、720P、1080P diff --git a/ja/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/ja/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index bdee107166..57914a34f3 100644 --- a/ja/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -349,7 +349,7 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合は解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video では、adaptive(デフォルト)が、入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx b/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx index 444e6a614d..1e1e73bfa2 100644 --- a/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx @@ -264,10 +264,9 @@ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の Comfy Router の POST ボディは合計100 MiBに制限され、それを超えると 413 が返されます。 また base64 はペイロードを約4/3に膨らませるため、およそ75 MBを超える単一の インラインアセットは、ここに示すパートナーのルールに到達する前に拒否されます。 -そのサイズでは、パートナー自身の +そのサイズでは、パートナー自身の 20MB の上限はインラインでも余裕を持って収まるため、アセットが 1 つの場合はパートナーのルールが制約となります。複数のアセットにまたがる場合は転送上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 -20MB の上限はインラインでも余裕を持って収まるため、アセットが 1 つの場合はパートナーのルールが制約となります。複数のアセットにまたがる場合は転送上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはパブリック URL として送信してください。 メディアアセットのタイプ @@ -341,7 +340,7 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で - 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデルのみ。wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 + 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデルのみ。wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index 0953c1cfef..6785200437 100644 --- a/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -230,7 +230,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ テキストプロンプト。中国語と英語をサポートします。ドキュメントに記載された長さを超えると、wan2.x モデルはプロンプトを拒否せずに切り捨てます。wan2.5 と wan2.6 では 1,500 文字、wan2.7 では 5,000 文字です。wan3.0-video と wan3.0-video-prime は最大 20,000 文字を受け付けます。prompt と negative_prompt を合わせて約 60,850 バイトの UTF-8 テキスト(約 20,000 中国語文字)を超えるリクエストはプロバイダーが拒否し、InvalidParameter `Range of input length should be [1, 61440]` を返します。 -参照ビデオが複数ある wan2.6-r2v では、参照ビデオの順序に従って被写体を 'character1'、'character2' などで指定します。例: "Character1 sings on the roadside, Character2 dances beside it" +参照ビデオが複数ある wan2.6-r2v では、参照ビデオの順序に従って被写体を 'character1'、'character2' などで指定します。例: "Character1 が道端で歌い、Character2 がそのそばで踊る" wan3.0-video の参照モードでは、media 配列内の対応する順序でメディアアセットを 'Image 1'、'Video 1'、'Audio 1' などで指定します。 @@ -292,7 +292,7 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合は解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video の場合、adaptive(デフォルト)は適切なものを自動的に推奨しますaspect ratio は入力メディアの比率と意図に基づいて決まります。 +wan3.0-video の場合、adaptive(デフォルト)は入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index f41180f52b..12194972e2 100644 --- a/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -346,7 +346,7 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序で 生成されるビデオのアスペクト比。wan2.7 と wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合、解像度の階層に基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ja/development/comfy-router/models/wan/wan2-6-t2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-6-t2v/code.mdx index 73515bde5b..9016a8cdcc 100644 --- a/ja/development/comfy-router/models/wan/wan2-6-t2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-6-t2v/code.mdx @@ -339,7 +339,7 @@ minItems/maxItems が宣言されていません。許容される type とそ 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video では、adaptive(デフォルト)が、入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 取り得る値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/ja/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index f60b9560f0..7511704054 100644 --- a/ja/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -234,7 +234,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests/$REQUEST_ID \ メディアアセットのタイプ - 可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` + 指定可能な値: `first_frame`、`last_frame`、`driving_audio`、`first_clip`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file`、`link` @@ -282,7 +282,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests/$REQUEST_ID \ - auto(デフォルト): モデルがプロンプトの内容に基づいてインテリジェントに判断します - origin: 入力ビデオのオリジナルオーディオを強制的に保持します - 可能な値: `auto`、`origin` + 指定可能な値: `auto`、`origin` @@ -307,7 +307,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests/$REQUEST_ID \ 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合は解像度のティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切な入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/ja/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index 4eb806edcf..1bba93fc6c 100644 --- a/ja/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -230,9 +230,9 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-r2v/requests/$REQUEST_ID \ - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview: テキストから動画への操作。対応するパートナーのリファレンスにはメディア入力が記載されていないため、このフィールドは未設定のままにしてください。 - wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v: このコンポーネントはこれらのスペルに対するメディアの語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は先頭フレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 上記のモデルごとの個数はこのスキーマの制約ではなく、パートナーの制約です。media には minItems/maxItems が宣言されていません。許容されるタイプとその上限はモデルごとに異なるためです。スキーマが受け付けることはプロバイダーが受け付けることを意味しません。そして逆方向についても、上記のアセットごとの「最大 20MB」という数値(インラインで送信できる唯一の入力である画像入力に対する上限)は、パートナーが最終的に受け取るアセットに対する上限であり、アセットが公開URLの場合はそのまま適用されます。そのバイト列が Comfy を経由することはないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の POST ボディは合計 100 MiB に制限され、それを超えると 413 が返されます。さらに base64 はペイロードを約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに示すパートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の +20MB の上限にはインラインでも余裕で収まるため、アセット 1 件の場合はパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いサイズのものは、パブリック URL として送信してください。 -20MB の上限にはインラインでも余裕で収まるため、アセット 1 件の場合はパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は個々の要素ではなくリクエスト全体を制限するためです。これらの上限に近いサイズのものは、パブリック URL として送信してください。 メディアアセットの種類 @@ -244,7 +244,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-r2v/requests/$REQUEST_ID \ - Reverse prompt words は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これは prompt と同じ入力バジェットにカウントされます。 + ネガティブプロンプト(reverse prompt words)は、ビデオ画面に表示したくないコンテンツを記述するために使用します。500 文字を超えると、wan モデルは拒否せずに切り捨てます。これは prompt と同じ入力バジェットにカウントされます。 @@ -309,7 +309,7 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序の 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデルのみ。 wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切な値を自動的に推奨しますaspect ratio based on the input media proportions and intent. +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ja/development/comfy-router/models/wan/wan2-7-t2v/code.mdx b/ja/development/comfy-router/models/wan/wan2-7-t2v/code.mdx index cd324231b0..0582f1e55f 100644 --- a/ja/development/comfy-router/models/wan/wan2-7-t2v/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-7-t2v/code.mdx @@ -265,7 +265,7 @@ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。 また、base64 はペイロードを約 4/3 に膨らませるため、約 75 MB を超える単一の インラインアセットは、ここに記載されたパートナーのルールに到達する前に拒否されます。 -そのサイズでは、単一のアセットはパートナー自身の20MB の上限はインラインで余裕を持って収まるため、1 つのアセットについてはパートナーのルールが制約となります。転送の上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 +そのサイズでは、パートナー自身の20MB の上限にある単一のアセットはインラインで余裕を持って収まるため、1 つのアセットについてはパートナーのルールが制約となります。転送の上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべてパブリック URL として送信してください。 @@ -346,7 +346,7 @@ wan3.0-video の参照モードでは、media 配列内の対応する順序に 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが決まります。 -wan3.0-video では、adaptive(デフォルト)が適切なものを自動的に推奨しますaspect ratio based on the input media proportions and intent. +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -479,7 +479,7 @@ size と resolution の両方を送信した場合、課金ティアは size で タスクステータス - 取り得る値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 指定可能な値: `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` diff --git a/ja/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx b/ja/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx index 37a12e2c7f..c2f1ac78e9 100644 --- a/ja/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx +++ b/ja/development/comfy-router/models/wan/wan2-7-videoedit/code.mdx @@ -230,10 +230,9 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-videoedit/requests/$REQUEST_ID \ - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: テキストから動画への操作。これらのパートナーリファレンスには media 入力の記載がないため、このフィールドは未設定のままにします。 - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: このコンポーネントはこれらの表記向けの media の語彙を列挙していません。wan2.5-i2v-preview と wan2.6-i2v は最初のフレームを img_url で受け取り、wan2.6-r2v は参照クリップを reference_video_urls で受け取ります。 -上記のモデルごとの件数はこのスキーマの制約ではなくパートナーの制約です。media には minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに異なるためです。スキーマが受け入れることはプロバイダーが受け入れることを意味しません。逆に、上記のアセットごとの「最大20MB」という数値は、画像入力(インラインで送信できる唯一の入力)に対する上限であり、パートナーが最終的に受け取るアセットに対する上限です。アセットが公開URLの場合は記載どおりに適用されます。そのバイト列はComfyを経由しないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の POST ボディは合計100 MiBに制限され、超えると413が返されます。また base64 はペイロードを約4/3に膨らませるため、約75 MBを超える単一のインラインアセットは、ここに記載したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の +上記のモデルごとの件数はこのスキーマの制約ではなくパートナーの制約です。media には minItems/maxItems が宣言されていません。許容される type とその上限がモデルごとに異なるためです。スキーマが受け入れることはプロバイダーが受け入れることを意味しません。逆に、上記のアセットごとの「最大20MB」という数値は、画像入力(インラインで送信できる唯一の入力)に対する上限であり、パートナーが最終的に受け取るアセットに対する上限です。アセットが公開URLの場合は記載どおりに適用されます。そのバイト列はComfyを経由しないためです。インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも直面します。Comfy Router の POST ボディは合計100 MiBに制限され、超えると413が返されます。また base64 はペイロードを約4/3に膨らませるため、約75 MBを超える単一のインラインアセットは、ここに記載したパートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の 20MB の上限の範囲内でインラインで余裕を持って収まるため、1 つのアセットについてはパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべて公開 URL として送信してください。 -20MB の上限はインラインで余裕を持って収まるため、1 つのアセットについてはパートナーのルールが制約となります。トランスポートの上限は複数のアセットにまたがる場合に制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべて公開 URL として送信してください。 メディアアセットのタイプ @@ -308,7 +307,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-videoedit/requests/$REQUEST_ID \ 生成されるビデオのアスペクト比。wan2.7 および wan3.0 モデル専用です。 wan2.7 モデルでは、指定しない場合、解像度ティアに基づいてデフォルトが設定されます。 -wan3.0-video では、adaptive(デフォルト)が適切なものを自動的に推奨します入力メディアの比率と意図に基づくアスペクト比。 +wan3.0-video では、adaptive(デフォルト)が入力メディアの比率と意図に基づいて適切なアスペクト比を自動的に推奨します。 指定可能な値: `adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/ja/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/ja/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index 662fc1727e..b822f1300c 100644 --- a/ja/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/ja/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -261,10 +261,9 @@ minItems/maxItems が宣言されていません。許容される type とそ インラインの data:\{MIME_type};base64,... URL は Comfy を経由するため、転送上の上限にも 達します。Comfy Router の POST ボディは合計で100 MiB に制限され、それを超えると 413 が返り、 base64 はペイロードを約4/3に膨らませるため、およそ75 MB を超える単一のインラインアセットは、 -ここに挙げたパートナーのルールのいずれかに到達する前に拒否されます。そのサイズでは、パートナー自身の +ここに挙げたパートナーのルールのいずれかに到達する前に拒否されます。そのサイズでは、パートナー自身の20MB の上限の範囲内でインラインでも余裕を持って収まるため、1つのアセットではパートナーのルールが制約となります。一方、複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべて公開 URL として送信してください。 -20MB の上限はインラインでも余裕を持って収まるため、1つのアセットではパートナーのルールが制約となります。一方、複数のアセットにまたがる場合はトランスポートの上限が制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものはすべて公開 URL として送信してください。 メディアアセットの種類 @@ -356,7 +355,7 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 - happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P このプロキシは resolution も size も指定されていないビデオ生成リクエストを拒否します。 解像度ティアが課金レートを決定するためです。チェックの前に resolution を大文字化し、 -大文字化した値を転送します。400 を返しますこのenum外の値に対して返され、また 480P に対しては 400 を返します(`resolution` として送信された場合も、480P の `size` として送信された場合も同様です)。対象は、上記で 480P を持たないと記載されている wan2.6、wan2.7、happyhorse-1.0 モデルです。 +大文字化した値を転送し、この enum にない値には 400 を返します。また 480P に対しては 400 を返します(`resolution` として送信された場合も、480P の `size` として送信された場合も同様です)。対象は、上記で 480P を持たないと記載されている wan2.6、wan2.7、happyhorse-1.0 モデルです。 指定可能な値: `480P`、`720P`、`1080P` diff --git a/ja/development/comfy-router/models/wan/wan3-0-video/code.mdx b/ja/development/comfy-router/models/wan/wan3-0-video/code.mdx index addc0e3e41..b7a2c36422 100644 --- a/ja/development/comfy-router/models/wan/wan3-0-video/code.mdx +++ b/ja/development/comfy-router/models/wan/wan3-0-video/code.mdx @@ -296,7 +296,7 @@ minItems/maxItems が宣言されていません。許容される type とそ data:\{MIME_type};base64,... URL は Comfy を経由するため、転送時の上限にも達します。Comfy Router の POST ボディは合計 100 MiB に制限され、超えると 413 が返されます。また base64 はペイロードを 約 4/3 に膨らませるため、およそ 75 MB を超える単一のインラインアセットは、ここに示す -パートナーのルールに到達する前に拒否されます。そのサイズでは、単一のアセットはパートナー自身の20MB の上限はインラインに余裕で収まるため、1 つのアセットについてはパートナーのルールが制約となります。転送の上限は複数のアセットにまたがって制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、すべてパブリック URL として送信してください。 +パートナーのルールに到達する前に拒否されます。そのサイズでは、パートナー自身の 20MB の上限にある単一のアセットはインラインに余裕で収まるため、1 つのアセットについてはパートナーのルールが制約となります。転送の上限は複数のアセットにまたがって制約となります。100 MiB の Router の上限は各要素ではなくリクエスト全体を制限するためです。これらの上限に近いものは、すべてパブリック URL として送信してください。 @@ -392,7 +392,7 @@ wan3.0-video では、adaptive(デフォルト)が入力メディアの比 - happyhorse-1.1-*(t2v、i2v、r2v): 480P、720P、1080P このプロキシは、resolution も size も指定されていないビデオ生成リクエストを拒否します。 解像度ティアが課金レートを選択するためです。チェックする前に解像度を大文字に変換し、 -大文字に変換した値を転送します。400 を返しますこの enum 外の値に対しては、上記で 480P 非対応として記載されている wan2.6、wan2.7、happyhorse-1.0 モデルにおいて、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 +大文字に変換した値を転送します。この enum 外の値に対しては 400 を返し、上記で 480P 非対応として記載されている wan2.6、wan2.7、happyhorse-1.0 モデルにおいて、480P(resolution として送信された場合も、480P の size として送信された場合も)に対して 400 を返します。 指定可能な値: `480P`、`720P`、`1080P` @@ -514,7 +514,7 @@ resolution の説明で 480P 非対応と記載されているすべてのモデ タスクのステータス - 取りうる値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` + 指定可能な値: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, `UNKNOWN` diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index 3acae39963..3da1abd4ac 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -581,31 +581,31 @@ Comfy Router のキュー配信モードです。リクエストボディは、` `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` の時間だけ待って同じキーを再利用してください。`invalid_input` の場合は新しいキーが必要です。このルートで発生する 2 つの `invalid_input` 競合はキーに関するものではなく、新しいキーでもどちらも解消されません。1 つは、リクエストボディがそのプロバイダーのこのモデル向けトランスレーターでは処理できないマルチパート操作(編集)を選択しているときに、別のプロバイダーを指定する `model_provider` が拒否されるケースで、`detail` は "this request's `image` selects the edit operation" で始まります。もう 1 つはその後でチェックされるもので、リクエストがすでにパス内のプロバイダーに対する BYOK 認証情報を解決している場合で、`detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで、かつ(マルチパートの場合は)編集なしでリクエストを送信してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded` の場合) + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded` の場合) リクエストの内容がモデルのスキーマに照らして拒否されました。 - Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` + ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed` `X-Comfy-Error-Type` を確認してください。`queue_backlog_full` は、すでに許可された数まで未完了のキュー中のリクエストを保持していることを意味するため、そのうち 1 つが完了したら再度送信してください。`rate_limited` は `Retry-After` に示された秒数だけ待つことを意味します。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`rate_limited` の場合) + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`rate_limited` の場合) Router は一時的に利用できません。バックオフしながら再試行してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (容量拒否の場合のみ) + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (容量拒否の場合のみ) リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。 - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/requests/{request_id}` @@ -1065,8 +1065,8 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積 - `/estimate` は `strict_mode` や `reject_unknown_fields` を受け取らないため、モデルのネイティブな契約のみを検証します。`strict_mode=true` の実行が代替プロバイダー自身のスキーマで受け付けるボディが、ここでは `422` になることがあります。また、`reject_unknown_fields=true` の実行なら拒否する未宣言のトップレベルフィールドが、ここでは価格付けされます。Anthropic Messages モデルは例外です。そのスキーマは未宣言のフィールドを許容するため、`reject_unknown_fields=true` の実行でも何も拒否せず、見積もりは未宣言のトップレベルフィールド `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` および空の `mcp_servers` のみを価格付けします。その他の未宣言のトップレベルフィールドがあると、`reason: not_quotable` とともに `unknown` を返します。 - `pricing_as_of` は料率表を取得した時刻です。ベンダーの公開価格表から取得した `estimated` の見積もりは、その価格表を読んだ日付を持ちます。請求数量をベンダーの公開スケジュールから予測し、その後レートカードで価格設定する `exact` または `estimated` の見積もりは、そのスケジュールの読み取り日がカードより古い場合、スケジュールの読み取り日を持ちます。カードもスケジュールも読まれていない場合は、見積もりを返した時刻です。これは価格の固定ではありません。実行は、レーティング時点で有効な料率で請求されます。 - `/estimate` は `model_provider` が示すレグ、またはネイティブのプロバイダーを価格付けします。`fallback_provider` や `strict_mode` パラメータは受け取りません。フォールバックのリトライが別のプロバイダーで行われる同期実行は、そのプロバイダーの料率で請求され、見積もりはそのレグを価格付けしていません。実行のレスポンスの `X-Comfy-Router-Fallback-Provider` が、それが発生したことを示します。キュー中の送信にはフォールバックがないため、その `estimate` は実行されるレグを価格付けします。 -- `/estimate` とキュー中の送信の `estimate` は、`model_provider` レグの同じボディ、または兄弟オペレーションで実行されるボディについて、わずかに異なるドキュメントを価格付けすることがあります。送信の `estimate` は、実行が送信するドキュメントに基づいて価格付けされます。 -- `/estimate` は常にプラットフォームの請求額を算出します。自分のプロバイダーキーでの実行は Comfy から請求されませんが、`/estimate` はそれを検出せずに数値を返します。`reason: byok` を返すのはキュー中の送信だけです。- ドルは丸めていないセントから最大8桁の小数で表示され、課金対象の1セント未満の `amount` が `0` と表示されることはありません。`credits` は `round(amount × 211, 2)` であり、これは `X-Comfy-Credits-Used` が課金に適用するのと同じ変換です。そのため、ごく小さい非ゼロの価格では `credits` が `0` にラウンドされることがあります。これが重要となる場合は、`credits` ではなく `amount` または `amount_cents` で予算を立ててください。このヘッダーは引き続き、1回の実行に対する事後的な数値です。残高は Comfy プラットフォーム上にあります。 +- `/estimate` は常にプラットフォームの請求額を算出します。自分のプロバイダーキーでの実行は Comfy から請求されませんが、`/estimate` はそれを検出せずに数値を返します。`reason: byok` を返すのはキュー中の送信だけです。 +- ドルは丸めていないセントから最大8桁の小数で表示され、課金対象の1セント未満の `amount` が `0` と表示されることはありません。`credits` は `round(amount × 211, 2)` であり、これは `X-Comfy-Credits-Used` が課金に適用するのと同じ変換です。そのため、ごく小さい非ゼロの価格では `credits` が `0` にラウンドされることがあります。これが重要となる場合は、`credits` ではなく `amount` または `amount_cents` で予算を立ててください。このヘッダーは引き続き、1回の実行に対する事後的な数値です。残高は Comfy プラットフォーム上にあります。 ## 結果アセット @@ -1428,25 +1428,25 @@ Type: `string` キュー中の Router リクエスト 1 件の識別子。呼び出し側がポーリング、キャンセル、結果取得に使うハンドルです。 - Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 キュー中の Router リクエストの状態です。値はちょうど 3 つしかなく、`RouterErrorType` とは異なりこれは閉じた `enum` です。2 つのスキーマは意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えることが想定されているため、未知の分類を厳格に拒否する生成済みクライアントは、すでに何かが失敗したまさにそのときに最も激しく失敗することになります。一方こちらはライフサイクルであり、後から 4 つ目の状態を追加するライフサイクルは、enum として宣言されているかどうかに関わらず、それに対応して書かれたすべてのポーリングループにとって破壊的変更になります。だからこそ enum として宣言し、その制約はクライアントから見える場所で明示しています。 - Type: [`RouterQueueStatus`](#routerqueuestatus) + 型: [`RouterQueueStatus`](#routerqueuestatus) レスポンスが構成された瞬間に、このリクエストより前にキュー内にあるリクエストの数です。0 はこのリクエストが先頭であることを意味します。 - Type: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 + 型: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 成功しなかった `COMPLETED` リクエストにのみ存在し、その失敗を返すときに結果読み取りが `X-Comfy-Error-Type` に設定するのと同じ大まかな分類を保持します。これにより、成功したターミナルリクエストと、失敗またはキャンセル済みのリクエストを区別できます。どちらにも別個のターミナルステータスは存在しません。また、成功時には null ではなく存在しないため、その有無で分岐してください。 - Type: [`RouterErrorType`](#routererrortype) + 型: [`RouterErrorType`](#routererrortype) ### RouterQueueStatusResponse @@ -1466,25 +1466,25 @@ Type: `object` キュー中の Router リクエスト 1 件の識別子。呼び出し側がポーリング、キャンセル、結果取得に使うハンドルです。 - Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 + 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字 キュー中の Router リクエストの状態です。値はちょうど 3 つで、`RouterErrorType` と異なりこちらは閉じた `enum` です。これは 2 つのスキーマが意図的に逆方向へ閉じられているためです。`RouterErrorType` は失敗を分類するもので、その集合は増えることが想定されています。そのため、未知のバケットを厳格に拒否する生成済みクライアントは、まさに何かがすでに失敗したときに最も困ることになります。こちらはライフサイクルであり、後で 4 つ目の状態が追加されるようなライフサイクルは、enum として宣言されているかどうかに関わらず、それに合わせて書かれたすべてのポーリングループにとって破壊的変更になります。そのため enum として宣言し、制約はクライアントから見える場所に明示しています。 - Type: [`RouterQueueStatus`](#routerqueuestatus) + 型: [`RouterQueueStatus`](#routerqueuestatus) レスポンスが構成された時点で、このリクエストよりキューの先頭側に何件のリクエストがあるかを示します。0 はこのリクエストが先頭であることを意味します。 - Type: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 + 型: [`RouterQueuePosition`](#routerqueueposition) -- 0 以上 - このリクエストの事前コスト見積もりです。呼び出し元に対してコスト見積もりが有効な場合、新規受け付け時に含まれます。これはこのリクエストがピン留めされたプロバイダー区間を示します(キューにはフォールバックループがないため、`fallback_provider` が実際に実行される区間を変えることはありません)。数値を示せない場合でも `source: unknown` として存在します。見積もりが原因で送信が失敗することはありません。冪等なリプレイ(`Idempotent-Replayed: true`)では省略されます。オリジナルの見積もりは保存されないためです。これは見積もりであり、最終的な請求額でも価格の固定でもありません。実行はレーティング時点で有効な料金で課金され、ワークスペースの使用量および請求記録における確定した請求額が最終となります。 + このリクエストの事前コスト見積もりです。呼び出し元に対してコスト見積もりが有効な場合、新規受け付け時に含まれます。これは、このリクエストがピン留めされたプロバイダーのレッグを見積もります(キューにはフォールバックループがないため、`fallback_provider` が実際に実行されるレッグを変えることはありません)。数値を示せない場合でも `source: unknown` として存在します。見積もりが原因で送信が失敗することはありません。冪等なリプレイ(`Idempotent-Replayed: true`)では省略されます。オリジナルの見積もりは保存されないためです。これは見積もりであり、最終的な請求額でも価格の固定でもありません。実行はレーティング時点で有効な料金で課金され、ワークスペースの使用量および請求記録における確定した請求額が最終となります。 - Type: [`RouterCostEstimate`](#routercostestimate) + 型: [`RouterCostEstimate`](#routercostestimate) ### RouterQueueSubmitResponse diff --git a/ja/development/serverless/library-models.mdx b/ja/development/serverless/library-models.mdx deleted file mode 100644 index 901ddb86a0..0000000000 --- a/ja/development/serverless/library-models.mdx +++ /dev/null @@ -1,171 +0,0 @@ ---- -title: "Comfy API デプロイメントでワークスペースライブラリのモデルを使用する" -sidebarTitle: "ライブラリのモデル" -description: "LoRA などの .safetensors モデルをワークスペースライブラリにアップロードし、新しいビルド、リリース、再デプロイなしで Comfy API デプロイメント上で実行できます。" -icon: "folder-open" -translationSourceHash: ece5d691 -translationFrom: development/serverless/library-models.mdx -translationBlockHashes: - "_intro": 6a0b3555 - "Before you start": c7b9ddf9 - "Upload a model to the workspace library": 693a12a3 - "Run the model on your deployment": 8b7df85e - "Follow the limits and naming rules": 5b0d3461 - "Change or delete a library model": dda1b7bd ---- -Comfy API は、デプロイメントのリリースに含まれていない場合でも、ワークスペースライブラリのモデルを実行します。LoRA または別の `.safetensors` モデルをライブラリにアップロードし、新しいビルド、リリース、再デプロイなしでデプロイメント上で実行します。 - -ワークスペースライブラリを使用して、デプロイメントでトレーニングした LoRA を試したり、ワークフロー内のファイル名を1つ変更して API リクエストごとに異なる LoRA を選択したりできます。 - -## 始める前に - -モデルをワークスペースライブラリにアップロードする前に、次の要件を満たしていることを確認してください: - -- **プラン**: ワークスペースには、有効なプロ、クリエイター、チーム、またはエンタープライズプランが必要です。 -- **モデルファイル**: ファイルは 2 GB 以下の `.safetensors` ファイルである必要があります。SDXL や Flux などのより大きなベースモデルは、引き続き Build に配置します。 -- **有効なデプロイメント**: デプロイメントはライブラリと同じワークスペースにある必要があります。 - - - ワークスペースライブラリモデルが利用可能になる前に作成された一部のデプロイメントでは、これらのモデルを読み込めません。ワークスペースライブラリモデルを使用するには、新しいデプロイメントを作成してください。古いデプロイメントでは、ジョブが `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` で失敗する可能性があります。 - - -## ワークスペースライブラリへのモデルのアップロード - -モデルは次の3つのツールのいずれかでアップロードできます。 - -- **クラウドエディタ**: ファイルをアップロードするか、Civitai または Hugging Face のリンクからインポートします。 -- **comfy-cli**: ターミナルまたはスクリプトからアップロードします。 -- **Developer Platform**: Build のモデルステップからアップロードします。 - -使用するツールのタブを選択してください。 - - - - 1. **Run** の左側にあるデプロイメントメニューで、**Run on** の下で **Comfy Cloud** が選択されていることを確認します。 - 2. **左サイドバー**で **モデルライブラリ** をクリックし、**インポート** をクリックします。 - 3. **ファイルを選択** をクリックするか、`.safetensors` ファイルをダイアログにドラッグします。 - 4. **What type of model is this?** で、LoRA の場合は **LoRA** のままにし、それ以外はファイルに一致するタイプを選択します。 - 5. **アップロード** をクリックします。アップロードが完了したら **完了** をクリックします。 - - ![my_style_lora_9e2417.safetensors (97.37 MB) が選択され、What type of model is this? が LoRA に設定されたインポートダイアログ。Back と Upload ボタンがある](/images/development/serverless/library-models-editor-import.png) - - 代わりに Civitai または Hugging Face のリンクからモデルをインポートするには: - - 1. **インポート** ダイアログの **ここにリンクを貼り付けてください** にモデルのリンクを貼り付けます。 - 2. **続ける** をクリックします。 - 3. **What type of model is this?** でモデルタイプを選択します。 - 4. **インポート** をクリックします。 - - デプロイメントで実行できるのは `.safetensors` ファイルのみです。`.ckpt` など他の形式のリンクインポートはライブラリにはインポートされますが、デプロイメントでは実行されません。 - - - ファイルをアップロードし、`--type` でモデルタイプを設定します。 - - ```bash - comfy assets library upload my_style.safetensors --type loras - ``` - - ファイルがライブラリにあることを確認します。 - - ```bash - comfy assets library ls --tags models,loras - ``` - - - 1. Developer Platform で、Build のモデルステップを開き、**モデルをアップロード** をクリックします。 - 2. **ワークスペースライブラリ** を選択します。 - 3. `.safetensors` ファイルをドロップ領域にドラッグするか、領域をクリックしてブラウズします。 - 4. **モデルタイプ** で、LoRA の場合は **LoRA** のままにし、それ以外はファイルに一致するタイプを選択します。 - 5. **アップロード** をクリックします。 - - ![Build の「Which models ship inside the build?」ステップにあるモデルをアップロードダイアログ。Public、Private、ワークスペースライブラリのタブがあり、ワークスペースライブラリが選択され、ドロップ領域、LoRA に設定されたモデルタイプ、ファイルがワークスペースライブラリにあることを示す行、Cancel と Upload ボタンがある](/images/development/serverless/library-models-platform-upload.png) - - - -モデルがライブラリに入れば、ワークスペースのすべてのメンバーがそのモデルを使用できます。ライブラリは LoRA だけでなく、あらゆるモデルタイプを受け入れます。ローダーノードが読み取るフォルダーに一致するタイプを選択してください。たとえば LoRA なら `loras`、VAE なら `vae` です。 - -## デプロイでモデルを実行する - -モデルがライブラリに入ると、CloudエディタまたはAPIからデプロイ上で実行できます。ジョブの送信方法に応じてタブを選択してください。 - - - - 1. **Run** の左にあるデプロイメントメニューをクリックします。**Run on** でデプロイメントを選択します。エディタが再読み込みされますが、タブは開いたままです。 - 2. `Load LoRA (Model and CLIP)` ノードを追加するか、それが含まれるワークフローを開きます。 - 3. ノードの `lora_name` リストでファイルを選択します。リストには、Releaseのモデルの隣にライブラリのモデルが表示されます。 - 4. **Run** をクリックします。 - - 初回実行時は、ワーカーがファイルをダウンロードしている間、キューのジョブの行に `Downloading my_style.safetensors` と表示されます。ジョブが複数のモデルをダウンロードする場合、行には `Downloading ( of )` と表示されます。 - - ![Load Checkpoint ノードと Load LoRA (Model and CLIP) ノードを含むワークフロー、lora_name で選択済みのアップロード済み LoRA、キューパネルの最上行に Downloading my_style_lora_9e2417.safetensors 0 B of 97.37 MB と表示されている様子](/images/development/serverless/library-models-editor-downloading.png) - - - [API形式のワークフロー](/ja/development/api-development/workflow-api-format)で、`LoraLoader` ノードの `lora_name` 入力に、`.safetensors` を含むライブラリのファイル名を設定します: - - ```json - "10": { - "class_type": "LoraLoader", - "inputs": { - "lora_name": "my_style.safetensors", - "strength_model": 1.0, - "strength_clip": 1.0, - "model": ["4", 0], - "clip": ["4", 1] - } - } - ``` - - ワークフローは `comfy deploy run`、[Comfy SDK](/ja/development/api-development/sdks)、または [Comfy API v2](/ja/api-reference/v2/overview) で送信します: - - ```bash - comfy deploy run --deployment --workflow workflow_api.json - ``` - - 別のLoRAを使用するには、次のリクエストで `lora_name` をライブラリ内の別のファイル名に変更します。新しいBuild、Release、再デプロイは必要ありません。 - - - - - ライブラリのモデルを使用するワーカーでは、最初のジョブに時間がかかります。ワーカーが最初にモデルをダウンロードするためです。同じワーカーでの後続のジョブは、キャッシュされたコピーを使用します。新しいワーカーはモデルを再度ダウンロードし、他のモデルのための容量を確保するためにキャッシュからモデルを削除したワーカーも同様です。ダウンロードを省略するには、モデルをBuildに追加してください。 - - -## 制限と命名ルールに従う - -[開始する前に](#始める前に) に記載されているファイルサイズと形式の制限に加えて、次の制限が適用されます。 - -| 制限 | 値 | -| --- | --- | -| ワークスペースのストレージ | ワークスペースあたり1 TBのモデル(リンクインポートを含む) | -| ワークフローあたりのライブラリモデル名 | 100 | - -101個目のライブラリモデルを指定するローダーは、そのファイルがライブラリに存在しない場合と同じように失敗します。 - -ジョブが正しいファイルを見つけられるように、次のルールに従ってください。 - -- **ローダーが読み取るフォルダーを使用する。** ローダーは、自身のモデルタイプのライブラリファイルのみを見つけます。`Load LoRA` ノードは `loras` としてアップロードされたファイルを見つけますが、`checkpoints` としてアップロードされたファイルは見つけません。 -- **ベアファイル名を使用する。** ローダーの入力には `my_style.safetensors` のようにファイル名だけを設定し、前にフォルダーを付けないでください。 -- **リリースモデルの名前を再利用しない。** リリースに同じ名前のファイルが既にある場合、ワーカーはライブラリのファイルではなくリリースのファイルを使用します。 -- **フォルダー間で名前を一意に保つ。** 1つのローダーが読み取る2つのフォルダーにライブラリが同じファイル名を持つ場合、API経由で送信されたジョブはどちらのファイルも読み込みません。 -- **最新のファイルが優先されることを想定する。** 1つのフォルダー内に同じ名前のファイルが2つある場合、ジョブは最後に追加されたものを使用します。 -- **ベースモデルを一致させる。** LoRAは、ワークフローが読み込むベースモデルと一致している必要があります。 -- **デプロイに存在するローダーを使用する。** ローダーノードはデプロイ上で利用可能である必要があります。ライブラリモデルは、Comfy Cloud が持つローダーノードを通じてのみ読み込まれます。使用するローダーが Comfy Cloud にないカスタムノード由来の場合は、そのモデルをビルドに追加してください。 - -## ライブラリモデルの変更または削除 - -**実行先**でデプロイメントが選択されている場合、**モデルライブラリ**にはそのリリースのモデルのみが表示されます。ライブラリのモデルを変更または削除するには、まず Comfy Cloud に切り替え直してください。 - -1. **実行**の左にあるデプロイメントメニューをクリックします。**実行先**で **Comfy Cloud** を選択します。 -2. **左サイドバー**で **モデルライブラリ**をクリックします。 - -モデルタイプを変更するには: - -- モデルのカードにカーソルを合わせ、**モデル情報**をクリックして、新しい**モデルタイプ**を選択します。 - - - モデルを削除すると、メンバー全員のワークスペースライブラリからそのモデルが削除されます。ファイル名を指定したままのジョブまたは API リクエストは、ローダー入力で `Value not in list` エラーが発生して失敗します。 - - -モデルを削除するには: - -1. モデルのカードにカーソルを合わせ、**その他**をクリックしてから、**削除**をクリックします。 -2. **このモデルを削除しますか?** で、**削除**をクリックします。 diff --git a/ja/tutorials/flux/flux-3-klein.mdx b/ja/tutorials/flux/flux-3-klein.mdx index acadfb15e6..4ff3563849 100644 --- a/ja/tutorials/flux/flux-3-klein.mdx +++ b/ja/tutorials/flux/flux-3-klein.mdx @@ -84,13 +84,13 @@ FLUX.3 [klein] は、Black Forest Labs によるローカル ComfyUI 向けの 指示プロンプトから写真を編集します。オリジナル画像は参照として接続します。指示は参照コンテンツを置き換えます。ここではプロンプトがドレスの色を赤に変更し、それ以外はすべてそのまま維持されます。 -FLUX 3 Image Klein image edit workflow preview +FLUX 3 Image Klein 画像編集ワークフローのプレビュー - + Comfy Cloud で開く - + JSON をダウンロードするか、テンプレートライブラリで「FLUX 3 Image Klein: Image Edit」を検索してください @@ -118,13 +118,13 @@ FLUX.3 [klein] は、Black Forest Labs によるローカル ComfyUI 向けの **出力例**
- Input image - FLUX 3 Image Klein image edit example output + 入力画像 + FLUX 3 Image Klein 画像編集の出力例
### FLUX 3 Image Klein Distilled: 画像編集 {#image_flux3_klein_distilled_image_edit} -ステップ蒸留された checkpoint で画像を編集します。参照画像1枚、指示プロンプト1つ、16 steps、ガイダンスなしです。 +ステップ蒸留された checkpoint で画像を編集します。参照画像1枚、指示プロンプト1つ、16 ステップ、ガイダンスなしです。 FLUX 3 Image Klein Distilled 画像編集ワークフローのプレビュー @@ -154,7 +154,7 @@ FLUX.3 [klein] は、Black Forest Labs によるローカル ComfyUI 向けの 1. 編集したい画像を読み込み、`Set Reference Multi Latent` に接続します 2. 編集プロンプトは `FLUX 3 Image Layout Prompt` ノードに記述します。同梱のサンプルではイヤリングを置き換え、新しいイヤリングについて、表示してはいけないものも含めて詳細に記述しています 3. `steps` は 4~16 の範囲に保ち、`cfg` は 1 のままにします -4. **キュー** をクリックし、入力と `ImageCompare` の結果を比較します +4. **Queue** をクリックし、入力と `ImageCompare` の結果を比較します ## FLUX 3 Image Klein モデルのダウンロード diff --git a/ja/tutorials/video/ltx/ltx-2-3.mdx b/ja/tutorials/video/ltx/ltx-2-3.mdx index cff6f2d91e..4b631f90fc 100644 --- a/ja/tutorials/video/ltx/ltx-2-3.mdx +++ b/ja/tutorials/video/ltx/ltx-2-3.mdx @@ -198,7 +198,7 @@ ComfyUI/ --- ### LTX-2.3 最初・最後フレームから動画(`video_ltx2_3_flf2v`) {#video_ltx2_3_flf2v} -開始画像と終了画像の間を補間します。 +開始画像と終了画像の間を補間し、スムーズな動画トランジションを生成します。 @@ -316,7 +316,7 @@ ComfyUI/ ### LTX-2.3 IC-LoRAユニオン制御 {#video_ltx2_3_ic_lora} 深度、ポーズ、エッジなどの整列された制御入力を使用して、IC-LoRAでLTX-2.3動画を生成します。IC-LoRAは、LTX-2.3上でトレーニングされたインコンテキストLoRAであり、参照動画からの構造的ガイダンスを適用します。深度マップ、Cannyエッジ、ポーズスケルトンなど、様々なプリプロセッサからの制御信号を受け入れます。このワークフローはモジュラー処理のためにサブグラフを使用します。 -![LTX-2.3 IC-LoRA preview](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_ltx2_3_ic_lora-1.webp) +![LTX-2.3 IC-LoRA プレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_ltx2_3_ic_lora-1.webp) @@ -528,7 +528,7 @@ Remove subtitles, captions, and related text occlusions from the video, restorin --- ### LTX-2.3 ID LoRA(`video_ltx2_3_id_lora`) {#video_ltx2_3_id_lora} -参照画像と音声クリップから、同期オーディオ付きのパーソナライズ動画を生成します。 +テキストプロンプト、参照画像、短い音声クリップから、同期オーディオ付きのパーソナライズ動画を生成します。ID-LoRA を使用して、人物の外見と声を単一の生成モデルで適応させます。 diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index 8875bea725..4e0598f189 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -171,7 +171,8 @@ translationBlockHashes: - [Image Edit Erase Foreground](/ko/development/comfy-router/models/bria/image-edit-erase-foreground/code): `bria/image-edit-erase-foreground` - [Image Edit Erase](/ko/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase` - [Image Edit Expand](/ko/development/comfy-router/models/bria/image-edit-expand/code): `bria/image-edit-expand` -- [Image Edit Gen Fill](/ko/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill`- [이미지 편집 해상도 높이기](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` +- [Image Edit Gen Fill](/ko/development/comfy-router/models/bria/image-edit-gen-fill/code): `bria/image-edit-gen-fill` +- [이미지 편집 해상도 높이기](/ko/development/comfy-router/models/bria/image-edit-increase-resolution/code): `bria/image-edit-increase-resolution` - [이미지 편집 제품 들기](/ko/development/comfy-router/models/bria/image-edit-product-holding/code): `bria/image-edit-product-holding` - [이미지 편집 제품 가상 착용](/ko/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code): `bria/image-edit-product-virtual-tryon` - [이미지 편집 조명 변경](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` @@ -220,7 +221,8 @@ translationBlockHashes: - [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` -- [GPT Image 2.6 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare`- [GPT 이미지 2.6 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` +- [GPT Image 2.6 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code): `openai/gpt-image-2.6-flare` +- [GPT 이미지 2.6 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` - [GPT 이미지 2](/ko/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [화살표 2 Telos](/ko/development/comfy-router/models/quiver/arrow-2-telos/code): `quiver/arrow-2-telos` - [화살표 2](/ko/development/comfy-router/models/quiver/arrow-2/code): `quiver/arrow-2` @@ -270,7 +272,8 @@ translationBlockHashes: - [Wan 2.5 T2I 미리보기](/ko/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` - [Seedvr 2](/ko/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` - [Ultimate 이미지 Upscaler](/ko/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` -- [Grok Imagine 이미지 2.0](/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0`- [Grok Imagine Image Pro](/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` +- [Grok Imagine 이미지 2.0](/ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0` +- [Grok Imagine Image Pro](/ko/development/comfy-router/models/xai/grok-imagine-image-pro/code): `xai/grok-imagine-image-pro` - [Grok Imagine Image Quality](/ko/development/comfy-router/models/xai/grok-imagine-image-quality/code): `xai/grok-imagine-image-quality` - [Grok Imagine Image](/ko/development/comfy-router/models/xai/grok-imagine-image/code): `xai/grok-imagine-image` @@ -330,7 +333,8 @@ translationBlockHashes: - [Animations](/ko/development/comfy-router/models/meshy/animations/code): `meshy/animations` - [Meshy 6](/ko/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` -- [Meshy 7.1](/ko/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1`- [Meshy 7](/ko/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` +- [Meshy 7.1](/ko/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` +- [Meshy 7](/ko/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` - [Remesh](/ko/development/comfy-router/models/meshy/remesh/code): `meshy/remesh` - [Rigging](/ko/development/comfy-router/models/meshy/rigging/code): `meshy/rigging` - [Stable Fast 3D](/ko/development/comfy-router/models/stability/stable-fast-3d/code): `stability/stable-fast-3d` @@ -385,7 +389,8 @@ translationBlockHashes: - [GPT 5 Nano](/ko/development/comfy-router/models/openai/gpt-5-nano/code): `openai/gpt-5-nano` - [GPT 5](/ko/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6.1 Sol](/ko/development/comfy-router/models/openai/gpt-6-1-sol/code): `openai/gpt-6.1-sol` -- [GPT 6.1 Terra](/ko/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra`- [GPT 6 Astra](/ko/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` +- [GPT 6.1 Terra](/ko/development/comfy-router/models/openai/gpt-6-1-terra/code): `openai/gpt-6.1-terra` +- [GPT 6 Astra](/ko/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ko/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` - [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` - [o3](/ko/development/comfy-router/models/openai/o3/code): `openai/o3` diff --git a/ko/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx b/ko/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx index 1ff82b347c..f59c01c097 100644 --- a/ko/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx +++ b/ko/development/comfy-router/models/anthropic/claude-opus-4-6/code.mdx @@ -17,7 +17,7 @@ translationBlockHashes: import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; -Anthropic의 Comfy Router에서 제공하는 `anthropic/claude-opus-4-6`에 대한 API 레퍼런스입니다. +`anthropic/claude-opus-4-6`에 대한 API 레퍼런스입니다. 이 모델은 Anthropic에서 제공하며 Comfy Router가 서비스합니다. **입력:** 텍스트, 이미지 · **출력:** 텍스트 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 1c22d633f3..a5eaa9aeea 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -308,7 +308,8 @@ v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합 Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다. +이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원하면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. @@ -424,7 +425,9 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에
+ 비디오 생성 작업의 ID + 작업에서 사용된 모델의 이름과 버전 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 3e69b6782c..dd2124c0bb 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -294,9 +294,8 @@ BytePlus 제약 사항이 아닌 Comfy 측 가드레일입니다. BytePlus는 Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. false: 모델이 무음 비디오를 출력합니다. - - 이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 해당 검사에서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + 호출할 모델의 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 호출자는 생략합니다. diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 3d162a25e9..2ebca0742e 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -378,7 +378,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. URL 자체가 지니는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 있으면 해당 값에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않고, 없으면 해당 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시간을 제공하지 않으면 생략됩니다. Re-host된 `video_url` / `last_frame_url`의 수명과는 무관합니다. - Format: `date-time` + 형식: `date-time` diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index e2349d0860..0c636304dc 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -370,7 +370,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. URL 자체가 지니는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 해당 작업의 `updated_at`에 24시간을 더한 값(BytePlus가 문서화한 URL 수명)보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 다시 호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. - Format: `date-time` + 형식: `date-time` diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx deleted file mode 100644 index d096f88a92..0000000000 --- a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ /dev/null @@ -1,487 +0,0 @@ ---- -title: "Comfy Router로 Seedance 1.5 Pro 251215 사용하기" -description: "Comfy Router를 통해 byteplus/seedance-1-5-pro-251215를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." -sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 8c658f01 -translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx -translationBlockHashes: - "_intro": 5f93a1f1 - "Quick start": 71aafccf - "Schema": b9957cb9 - "Examples": 7e73ac5c ---- - - - - - -{/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/byteplus/seedance-1-5-pro-251215.json에서 생성되었습니다. */} - -import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; - -BytePlus에서 Comfy Router를 통해 제공되는 `byteplus/seedance-1-5-pro-251215`의 API 레퍼런스입니다. - -**입력:** 텍스트, 이미지 · **출력:** 비디오 + 오디오 - -## 빠른 시작 - -[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk`, `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 raw HTTP로 수행합니다. - -**모델 ID:** `byteplus/seedance-1-5-pro-251215` - -**엔드포인트:** `POST https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215` - - - - -```python Python -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) -``` - -```typescript TypeScript -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); -``` - -```bash cURL -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` 를 응답하며, 결과는 준비가 되는 대로 이 프로세스나 다른 프로세스에서 수집할 수 있습니다. 상태, 취소, 수집 방법은 [큐 전송](/ko/development/comfy-router/queue) 을 참고하세요. - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy - -# 환경 변수에서 COMFY_API_KEY를 읽습니다. -# 각 submit() 호출은 자체 Idempotency-Key를 생성하고 자동 재시도에 재사용합니다. -async def main(): - async with AsyncComfy() as client: - handle = await 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만큼 기다립니다. - async for update in handle.iter_events(): - print(update.status, update.queue_position) - - # 공급자의 자체 페이로드이며, models.run()이 반환하는 것과 동일한 값입니다. - # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. - result = await handle.get() - - print(result) - -asyncio.run(main()) -``` - -```typescript TypeScript -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()이 반환하는 것과 동일한 결과입니다. 실패했거나 취소된 요청은 여기에서 거부됩니다. -const result = await handle.get(); - -console.log(result.data); -``` - -```bash cURL -# 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="" -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" -``` - - - - -## 스키마 - -### 입력 - - - 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하세요. - - 형식: `uri` - - - - 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다 - - - - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. - - - - 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL입니다(wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ - - - - Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 콘텐츠 항목 중 유일해야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 4k를 포함한 최종 출력 등급에 맞게 이 요청에서 해상도를 설정하세요. 해상도를 생략하면 최종 결과는 1080p입니다. - - - - `draft`가 true로 설정된 상태에서 Draft 비디오를 생성했을 때 반환되는 작업 ID입니다. - - - - - - - - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ - - - - 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). - - 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - - - - 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. - -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. - -파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[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자를 허용했습니다. -바이트가 아닌 문자를 계산하므로 멀티바이트 프롬프트는 전송 시 이 크기의 -여러 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 -제한합니다. `content`는 배열이며, 요청당 본문 제한이 전체 문서를 -제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})입니다. -직접 v1 /proxy를 호출하면 대신 BytePlus 자체 검증기가 -응답합니다. 실제 트래픽보다 훨씬 높게 설정하여 실제 프롬프트를 -판정하지 않도록 하세요. 호출자가 더 필요하면 늘리세요. - - - - 입력 콘텐츠의 유형입니다 - - 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - - - - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - - - - 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL입니다(mp4, mov). -에셋 ID: 형식 asset://\ - - - - Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -최종 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. 해당 요청은 4k를 포함한 최종 결과의 해상도를 설정합니다. 해상도를 생략하면 최종 결과는 1080p입니다. Draft 작업 ID는 7일 동안 유효합니다. - - - - 비디오 재생 시간(초)입니다. Seedance 1.5 pro: [4,12] 또는 -1(자동). - - 가능한 값: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12` - - - - 작업 시간 초과 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. - - 범위: `3600`부터 `259200`까지 - - - - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -모델이 이를 지원하는 경우, 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 이런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 표시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - - - - 호출할 모델의 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 호출자는 이를 생략합니다. - - - - Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 폭넓은 호환성과 더 작은 파일 크기를 갖춘 범용 컨테이너(H.264/AAC, yuv420p)입니다. -mov: 높은 색상 정밀도를 갖춘 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로, 후반 작업에 적합하지만 파일 크기가 더 큽니다. - - 가능한 값: `mp4`, `mov` - - - - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. - - 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - - - - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p, 4k를 지원합니다. - - 가능한 값: `480p`, `720p`, `1080p`, `4k` - - - - 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 연속된 여러 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 연속된 여러 비디오를 빠르게 생성할 수 있습니다. -false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - - - - 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. - - 범위: `-1`에서 `4294967295`까지 - - - - 처리용 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. - - 가능한 값: `default`, `flex` - - - - 생성된 비디오에 워터마크가 포함되는지 여부입니다. - - -`GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 동일한 문서입니다. - -### 출력 - - - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - - - - 생성된 비디오의 마지막 프레임에 대한 다운로드 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을 저장하지 말고 프레임을 다운로드하세요. - - - - BytePlus가 `content` 안에 중첩해 반환할 때의 생성된 비디오의 컨테이너 형식(mp4 또는 mov)입니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 것을 읽습니다. - - - - 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. URL 자체가 지니는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 있을 때는 해당 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦을 수 없고, `updated_at`이 없을 때는 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시간을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. - - 형식: `date-time` - - - - 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되는 BytePlus 자체의 마지막 프레임 다운로드 URL로, `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인한 워크스페이스 전용, Seedance 2.x 전용, BytePlus가 지운 뒤에는 없음, 그리고 `upstream_expires_at`까지는 베어러 자격 증명입니다. - - - - 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환되는 BytePlus 자체의 출력 비디오 다운로드 URL입니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 모든 경우(워크스페이스로 해석되지 않는 자격 증명, 예를 들어 특정 워크스페이스에 범위가 지정되지 않은 레거시 API 키 포함)에는 없고, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 없습니다. 미리 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 누구나 만료 전까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드를 100회로 제한하고 그중 하나는 Router의 재호스팅이 소비합니다. - - - - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체의 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - - - - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - - - - 생성된 비디오의 재생 시간(초)입니다. 정수가 아닌 숫자로 선언된 것은 BytePlus가 이에 대해 일관적이지 않기 때문입니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고 같은 BytePlus의 다른 표면은 소수 재생 시간을 보고하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체의 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. - - - - 오류 정보입니다. 작업이 성공하면 null이 반환됩니다. 작업이 실패하면 오류 정보가 반환됩니다. - - - - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열린 문자열이며 열거형이 아닙니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. - - - - 오류 메시지 - - - - 비디오 생성 작업의 ID - - - - 작업에서 사용된 모델의 이름과 버전 - - - - 생성된 비디오의 컨테이너 형식(mp4 또는 mov). `content`의 형제 항목으로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 조회가 이 위치에 값을 반환합니다. BytePlus 자체 필드이며 값은 그대로 전달됩니다. - - - - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 값은 그대로 전달됩니다. - - - - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 값은 그대로 전달됩니다. - - 형식: `int64` - - - - 작업의 상태 - - 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - - - - 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - - - - 요청의 토큰 사용량 - - - - 모델이 생성한 토큰 수 - - - - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. - - -## 예시 - -### 입력 - -```json -{ - "content": [ - { - "text": "A red fox trotting through a snowy pine forest", - "type": "text" - } - ], - "duration": 5, - "ratio": "16:9", - "resolution": "720p" -} -``` - -### 출력 - -```json -{ - "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 -} -``` - - diff --git a/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index e5061e60f6..f1a8f203bb 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -215,7 +215,7 @@ false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않 - 모델 식별자입니다. 지원되는 모델: seedream-4-0-250828, seedream-4-0-250828, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 및 seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. + 모델 식별자입니다. 지원되는 모델: seedream-4-0-250828, seedream-4-5-251128, seedream-5-0-260128, seedream-5-0-pro-260628, seedream-5-0-flash-260915 및 seedream-5-5-261028. POST /proxy/byteplus/api/v3/images/generations에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. @@ -275,7 +275,7 @@ disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지를 "seedream-4-0-250828": 생성된 이미지의 사양을 설정합니다. 두 가지 방법을 사용할 수 있지만 함께 사용할 수는 없습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 1K, 2K, 4K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [1024x1024, 4096x4096], 가로세로 비율: [1/16, 16] -"seedream-4-0-250828": 두 가지 방법을 사용할 수 있습니다. +"seedream-4-5-251128": 두 가지 방법을 사용할 수 있습니다. 방법 1 | 해상도를 지정합니다. 선택 가능한 값: 2K, 4K 방법 2 | 너비와 높이를 픽셀 단위로 지정합니다. 기본값: 2048x2048, 총 픽셀: [2560x1440, 4096x4096], 가로세로 비율: [1/16, 16] "seedream-5-0-260128": 두 가지 방법을 사용할 수 있습니다. diff --git a/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx index 9c77ec8530..000a3a79a3 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx @@ -230,7 +230,9 @@ false: 표준 이미지 생성 모드이며 레이어 분리를 수행하지 않 - 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 매개변수를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. 가능한 값: `png`, `jpeg` + 출력 이미지의 형식을 지정합니다. seedream-5.0-pro, 5.0-flash, 5.0-lite 및 5.5만 이 매개변수를 지원합니다. seedream-5.5의 기본값은 png입니다. 레이어 분리 시나리오에서 output_format은 기본 이미지의 형식만 제어하며, 모든 레이어는 항상 png로 출력됩니다. + + 가능한 값: `png`, `jpeg` diff --git a/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx index 1ffb5664f7..86d6b9ed38 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx @@ -236,7 +236,8 @@ false: 표준 이미지 생성 모드이며, 레이어 분리를 수행하지 - 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않음). 유효한 값:auto: 자동 모드에서는 모델이 사용자의 프롬프트를 기반으로 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. + 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 매개변수는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않음). 유효한 값: +auto: 자동 모드에서는 모델이 사용자의 프롬프트를 기반으로 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. disabled: 배치 생성 기능을 비활성화합니다. 모델은 이미지를 하나만 생성합니다. 가능한 값: `auto`, `disabled` diff --git a/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx b/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx index a8fa079b54..f15dbb8d21 100644 --- a/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx @@ -16,7 +16,7 @@ import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; `byteplus/seedream-5-5-261028`에 대한 API 레퍼런스이며, Comfy Router가 BytePlus에서 제공합니다. -**입력:** Text, Image · **출력:** 이미지 +**입력:** 텍스트, 이미지 · **출력:** 이미지 ## 빠른 시작 @@ -231,7 +231,8 @@ false: 표준 이미지 생성 모드이며, 레이어 분리를 수행하지 - 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). 유효한 값:auto: 자동 모드에서 모델은 사용자의 프롬프트에 따라 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. + 배치 생성 기능을 비활성화할지 여부를 제어합니다. 이 파라미터는 seedream-5.0-lite, 4.5 및 4.0에서만 지원됩니다(seedream-5.0-pro, 5.0-flash 또는 5.5에서는 지원되지 않습니다). 유효한 값: +auto: 자동 모드에서 모델은 사용자의 프롬프트에 따라 여러 이미지를 반환할지 여부와 포함할 이미지 수를 자동으로 결정합니다. disabled: 배치 생성 기능을 비활성화합니다. 모델은 하나의 이미지만 생성합니다. 가능한 값: `auto`, `disabled` diff --git a/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx b/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx index 3c55eeff3b..1916342bca 100644 --- a/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-2-5-flash-image/code.mdx @@ -570,13 +570,13 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다.
- Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -602,7 +602,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -620,7 +620,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -642,7 +642,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index f12eab8ea3..7ca01f3bdb 100644 --- a/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -278,7 +278,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE -When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. Deterministic output isn't guaranteed. Also, changing the model or parameter settings, such as the temperature, can cause variations in the response even when you use the same seed value. By default, a random seed value is used. Available for the following models:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 + seed를 특정 값으로 고정하면 모델은 반복 요청에 대해 동일한 응답을 제공하기 위해 최선을 다합니다. 결정론적 출력은 보장되지 않습니다. 또한 temperature와 같은 모델이나 파라미터 설정을 변경하면 동일한 seed 값을 사용하더라도 응답이 달라질 수 있습니다. 기본적으로 무작위 seed 값이 사용됩니다. 지원 모델: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 diff --git a/ko/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/ko/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index 484ec41b8e..2c87800cce 100644 --- a/ko/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -378,7 +378,7 @@ Top-P는 모델이 출력용 토큰을 선택하는 방식을 변경합니다. - 참이면 생성된 이미지가 인라인 base64 데이터 대신 클라우드 스토리지에 업로드되어 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. + true이면 생성된 이미지가 인라인 base64 데이터 대신 클라우드 스토리지에 업로드되어 서명된 URL로 반환됩니다. URL은 24시간 후에 만료됩니다. @@ -558,8 +558,6 @@ Router가 `GET /v2/models/vertexai/gemini-3.7-flash/openapi.json`에서 제공 - 콘텐츠가 위반할 수 있는 안전 카테고리 - 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/ko/development/comfy-router/models/google/gemini-4-argon/code.mdx b/ko/development/comfy-router/models/google/gemini-4-argon/code.mdx index 5a46e26114..fd9a8a9e3f 100644 --- a/ko/development/comfy-router/models/google/gemini-4-argon/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -554,8 +554,10 @@ Router가 `GET /v2/models/vertexai/gemini-4-argon/openapi.json`에서 제공하 + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` diff --git a/ko/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx b/ko/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx index e5accb439e..f4b114ca33 100644 --- a/ko/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx +++ b/ko/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx @@ -336,7 +336,7 @@ Top-P는 모델이 출력할 토큰을 선택하는 방식을 변경합니다. - 모델이 더 나은 성능을 내도록 유도하는 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 역할 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 문단에 있어야 합니다. + 모델이 더 나은 성능을 내도록 유도하는 지침입니다. 예를 들어 "가능한 한 간결하게 답변하세요" 또는 "응답에 기술 용어를 사용하지 마세요"와 같습니다. 텍스트 문자열은 토큰 한도에 포함됩니다. systemInstruction의 role 필드는 무시되며 모델의 성능에 영향을 주지 않습니다. 참고: parts에는 텍스트만 사용해야 하며, 각 part의 콘텐츠는 별도의 문단에 있어야 합니다. @@ -554,7 +554,7 @@ Router가 `GET /v2/models/vertexai/gemini-4-hydrogen/openapi.json`에서 제공 -Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/ko/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/ko/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index 4c938ab294..3470c3fca2 100644 --- a/ko/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/ko/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -590,8 +590,10 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-lite-image/openapi.json`에 + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` diff --git a/ko/development/comfy-router/models/google/nano-banana-2/code.mdx b/ko/development/comfy-router/models/google/nano-banana-2/code.mdx index 5d80843774..0680bf0234 100644 --- a/ko/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/ko/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -606,13 +606,13 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. - Possible values: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` + 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` @@ -638,7 +638,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -656,7 +656,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` @@ -678,7 +678,7 @@ Router가 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json`에서 입력 또는 출력 콘텐츠 모달리티의 유형입니다. - Possible values: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` + 가능한 값: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT` diff --git a/ko/development/comfy-router/models/google/nano-banana-pro/code.mdx b/ko/development/comfy-router/models/google/nano-banana-pro/code.mdx index fdf739b696..e4e9d20500 100644 --- a/ko/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/ko/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -606,8 +606,10 @@ Router가 `GET /v2/models/vertexai/gemini-3-pro-image/openapi.json`에서 제공 + 가능한 값: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` - + + 콘텐츠가 지정된 안전 카테고리를 위반할 확률입니다. 가능한 값: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN` diff --git a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx index 8d3cfe6957..d1b4c10ec8 100644 --- a/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx +++ b/ko/development/comfy-router/models/kling/kling-v2-6/code.mdx @@ -304,7 +304,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \ - 참조 이미지: 종료 프레임 제어. URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. dynamic_masks/static_mask 또는 카메라 제어와 동시에 사용할 수 없습니다. + 참조 이미지: 종료 프레임 제어. URL 또는 Base64로 인코딩된 문자열이며, 10MB를 초과할 수 없고 해상도는 300*300px 이상이어야 합니다. Base64에는 data:image 접두사를 포함하지 않아야 합니다. dynamic_masks/static_mask 또는 camera_control과 동시에 사용할 수 없습니다. diff --git a/ko/development/comfy-router/models/meshy/rigging/code.mdx b/ko/development/comfy-router/models/meshy/rigging/code.mdx index a1280ca5f0..c1818f8db6 100644 --- a/ko/development/comfy-router/models/meshy/rigging/code.mdx +++ b/ko/development/comfy-router/models/meshy/rigging/code.mdx @@ -159,7 +159,7 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ - 캐릭터 손에 손가락 본을 추가할지 여부입니다. Biped 리그에만 적용됩니다. texture_image_url, 사족보행 리그 또는 quad 토폴로지 input_task_id와 함께 사용하면 Meshy가 400으로 요청을 거부하며, 손가락 없이만 리깅할 수 있는 모델의 경우 422로 거부합니다(과금되지 않음). 손가락 본은 크레딧 비용을 변경하지 않습니다. 기본값은 거짓입니다. + 캐릭터 손에 손가락 본을 추가할지 여부입니다. Biped 리그에만 적용됩니다. texture_image_url, 사족보행 리그 또는 quad 토폴로지 input_task_id와 함께 사용하면 Meshy가 400으로 요청을 거부하며, 손가락 없이만 리깅할 수 있는 모델의 경우 422로 거부합니다(과금되지 않음). 손가락 본은 크레딧 비용을 변경하지 않습니다. 기본값은 `false`입니다. @@ -171,7 +171,7 @@ curl https://api.comfy.org/v2/models/meshy/rigging/requests/$REQUEST_ID \ - 리깅된 캐릭터의 스켈레톤으로, 본 이름과 계층 구조를 설정합니다. Biped 리그에만 적용됩니다. meshyrig 이외의 값(또는 include_fingers 참)을 사용하면 출력 파일은 미터 단위가 되고, 기본값인 센티미터 단위의 24개 본 meshyrig 파일 대신 해당 스켈레톤의 본을 사용합니다. 이 리그로 만든 애니메이션 작업도 같은 스켈레톤을 사용합니다. 그 밖의 값은 거부됩니다. 기본값은 meshyrig입니다. + 리깅된 캐릭터의 스켈레톤으로, 본 이름과 계층 구조를 설정합니다. Biped 리그에만 적용됩니다. meshyrig 이외의 값(또는 include_fingers true)을 사용하면 출력 파일은 미터 단위가 되고, 기본값인 센티미터 단위의 24개 본 meshyrig 파일 대신 해당 스켈레톤의 본을 사용합니다. 이 리그로 만든 애니메이션 작업도 같은 스켈레톤을 사용합니다. 그 밖의 값은 거부됩니다. 기본값은 meshyrig입니다. 가능한 값: `meshyrig`, `mixamo`, `ue5_mannequin`, `max_biped`, `unity_humanoid`, `maya_human_ik`, `blender_rigify_basic_human`, `cc5_hd_neutral_base`, `daz_genesis9` diff --git a/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx b/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx index de8ecd75da..375823f75d 100644 --- a/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx +++ b/ko/development/comfy-router/models/minimax/minimax-h3-image-highspeed/code.mdx @@ -16,7 +16,7 @@ import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; `minimax/minimax-h3-image-highspeed`의 API 레퍼런스로, MiniMax가 제공하고 Comfy Router가 서비스합니다. -**입력:** Text, Image · **출력:** Image +**입력:** 텍스트, 이미지 · **출력:** 이미지 ## 빠른 시작 diff --git a/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx index 16f8643392..170a0b1290 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx @@ -179,7 +179,7 @@ URL은 귀하의 자격 증명 없이 접근할 수 있어야 합니다. Router 두 가지 확장이 순차 배포 중이며 오늘 기준으로 둘 다 기본적으로 꺼져 있습니다. 하나의 전환 뒤에 함께 제공되어 동시에 활성화되므로, 아래의 모든 내용은 아직 대비해 개발할 대상이 아니라 예정된 사항으로 취급하세요. 어느 쪽이든 의존하기 전에 문의하세요. 첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 배포가 귀하의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기서 거부됩니다. 버킷이 Comfy 소유이고 호스트도 동일함에도 그렇습니다. 따라서 "Comfy에 업로드한 뒤 URL을 전달"하는 방식은 아직 작동하지 않으며, 작동하는 형식은 `/api/assets/{id}/content`가 리디렉션하는 서명된 URL입니다. 두 번째는 모든 계정에 한꺼번에 적용되는 것이 아니라 계정별로 활성화됩니다. 이 호스트들 뒤의 버킷이 우리 것이 아니라 귀하의 것이기 때문입니다. 위 전환이 켜져 있더라도 서드파티 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 메시지가 아니라 바로 그 취지의 문구로 안내받습니다. 담당 Comfy 연락처에 계정에 대해 이를 활성화해 달라고 요청하세요. 이 전환은 다음과 같은 서드파티 오브젝트 스토리지 호스트를 추가로 허용합니다. 여기서 버킷은 귀하의 것이며 Router는 이에 대한 소유권을 주장하지 않습니다: Cloudflare R2(`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3(`s3.amazonaws.com` 및 `s3..amazonaws.com`, path-style 또는 `.` 접두사 형식 모두), Azure Blob Storage(`.blob.core.windows.net`), Alibaba Cloud OSS(`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함). 이들은 구체적으로 오브젝트 스토리지 엔드포인트입니다. 같은 공급자 도메인의 범용 엔드포인트, 예를 들어 Alibaba Function Compute 트리거는 목록에 없으며 거부됩니다. -일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아닙니다. 호출자가 각각을 합리적으로 사용할 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보내지만, 사용자 지정 도메인은 호스트 이름에 R2임을 나타내는 정보가 없으므로 Router는 이를 다른 호스트와 구별할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 거부 응답에도 동일한 형식이 명시되므로 이를 확인하기 위해 이 문서를 찾아올 필요는 없습니다.위의 `` 및 `pub-` 플레이스홀더는 일반적으로 접하게 될 형식을 보여 주며, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 하므로 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그로 인해 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. +일치되는 것은 공급자가 아니라 호스트 이름 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아닙니다. 호출자가 각각을 합리적으로 사용할 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보내지만, 사용자 지정 도메인은 호스트 이름에 R2임을 나타내는 정보가 없으므로 Router는 이를 다른 호스트와 구별할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 거부 응답에도 동일한 형식이 명시되므로 이를 확인하기 위해 이 문서를 찾아올 필요는 없습니다. 위의 `` 및 `pub-` 플레이스홀더는 일반적으로 접하게 될 형식을 보여 주며, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 하므로 동일한 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그로 인해 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. 아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 포함되지만, 게시된 예시는 스펙에 영구히 남고 실제 서명은 유출된 자격 증명이자 더 이상 작동하지 않는 링크이기 때문에 여기서는 의도적으로 생략했습니다. 각 이미지는 최대 25 MiB로 제한되며, 한 요청의 이미지는 총 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 보내는 호출)입니다. 이 경우 각 이미지는 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀일 수 있고, 한 요청의 이미지는 총 128 MiB까지 가능합니다. diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 0adf58cb58..aeaad772e1 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -163,6 +163,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES - **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare` - **fal**, `fal/fal-gpt-image-2.5-flare`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=fal` +- **MiniMax**, `minimax/minimax-gpt-image-2.5-flare`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=minimax` - **Runware**, `runware/runware-gpt-image-2.5-flare`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=runware` - **WaveSpeed**, `wavespeed/wavespeed-gpt-image-2.5-flare`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=wavespeed` diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index fbb0eaf471..12be7635c7 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -162,10 +162,11 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ - **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst` - **fal**, `fal/fal-gpt-image-2.5-sunburst`(으)로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=fal` +- **MiniMax**, `minimax/minimax-gpt-image-2.5-sunburst`(으)로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=minimax` - **Runware**, `runware/runware-gpt-image-2.5-sunburst`(으)로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=runware` - **WaveSpeed**, `wavespeed/wavespeed-gpt-image-2.5-sunburst`(으)로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=wavespeed` -`strict_mode`의 기본값은 false(false)이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)를 참고하고, 이렇게 라우팅되는 모든 모델은 [서빙 공급자](/ko/development/comfy-router/providers)에서 확인하세요. +`strict_mode`의 기본값은 false이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)를 참고하고, 이렇게 라우팅되는 모든 모델은 [서빙 공급자](/ko/development/comfy-router/providers)에서 확인하세요. ## 스키마 diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 3da440c189..a4e808c77d 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -156,10 +156,10 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES 이 모델은 요청에서 다른 공급자를 지정하지 않는 한 Comfy Router가 직접 제공합니다. 아래 공급자들도 동일한 엔드포인트와 동일한 모델 ID로 이 모델을 제공하며, `model_provider` 쿼리 파라미터로 선택됩니다. -- **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare` -- **MiniMax**, `minimax/minimax-gpt-image-2-6-flare`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare?model_provider=minimax` +- **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare` +- **MiniMax**, `minimax/minimax-gpt-image-2.6-flare`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare?model_provider=minimax` -`strict_mode`의 기본값은 거짓이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이렇게 라우팅되는 모든 모델에 대해서는 [제공 공급자](/ko/development/comfy-router/providers)를 참조하세요. +`strict_mode`의 기본값은 false이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이렇게 라우팅되는 모든 모델에 대해서는 [제공 공급자](/ko/development/comfy-router/providers)를 참조하세요. ## 스키마 diff --git a/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 141bc051dc..0a51d593a3 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -155,10 +155,10 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ 이 모델은 요청에서 다른 공급자를 지정하지 않는 한 Comfy Router가 직접 제공합니다. 아래 공급자들도 동일한 엔드포인트와 동일한 모델 ID로 이 모델을 제공하며, `model_provider` 쿼리 파라미터로 선택됩니다. -- **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst` -- **MiniMax**, `minimax/minimax-gpt-image-2-6-sunburst`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst?model_provider=minimax` +- **Comfy** (기본값): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst` +- **MiniMax**, `minimax/minimax-gpt-image-2.6-sunburst`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst?model_provider=minimax` -`strict_mode`의 기본값은 거짓이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이렇게 라우팅되는 모든 모델에 대해서는 [제공 공급자](/ko/development/comfy-router/providers)를 참조하세요. +`strict_mode`의 기본값은 false이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이렇게 라우팅되는 모든 모델에 대해서는 [제공 공급자](/ko/development/comfy-router/providers)를 참조하세요. ## 스키마 @@ -197,12 +197,11 @@ URL은 자격 증명 없이 접근할 수 있어야 합니다. Router는 이를 두 가지 확장이 롤아웃 중이며 현재 둘 다 기본적으로 꺼져 있습니다. 이들은 하나의 전환 뒤에서 제공되며 함께 활성화되므로, 아래의 모든 내용은 아직 구축 대상으로 삼을 것이 아니라 향후 제공될 예정인 것으로 취급하십시오. 둘 중 하나에 의존하기 전에 문의하십시오. 첫 번째는 `POST /customers/storage`가 업로드를 서명해 넣는 버킷입니다. 롤아웃이 사용자 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기에서 거부됩니다. 버킷은 Comfy 자체의 것이고 호스트도 동일한데도 그렇습니다. 따라서 "Comfy에 업로드한 다음 URL을 전달"하는 방식은 아직 작동하지 않으며, 작동하는 형식은 `/api/assets/{id}/content`가 리다이렉트하는 서명된 URL입니다. 두 번째는 모든 사용자에게 한꺼번에 적용되는 것이 아니라 계정별로 활성화됩니다. 이 호스트 뒤의 버킷이 우리 것이 아니라 사용자의 것이기 때문입니다. 위의 전환이 켜져 있더라도 제3자 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 안내 대신 그 표현 그대로 안내받습니다. 사용자의 계정에 대해 활성화하려면 Comfy 담당자에게 문의하십시오. 또한 버킷이 사용자 소유이고 Router가 이에 대해 소유권을 주장하지 않는 다음 제3자 오브젝트 스토리지 호스트를 추가로 허용합니다: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` 및 `s3..amazonaws.com`, 경로 스타일 또는 `.` 접두사 형식 모두), Azure Blob Storage (`.blob.core.windows.net`) 및 Alibaba Cloud OSS (`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함). 이들은 특히 오브젝트 스토리지 엔드포인트입니다: 같은 공급자 도메인의 범용 엔드포인트, 예를 들어 Alibaba Function Compute 트리거는 목록에 없으며 거부됩니다. - - 일치되는 대상은 공급자가 아니라 호스트 이름 형태입니다. 따라서 위에서 공급자를 지정했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용되는 것은 아니며, 호출자가 각각을 합리적으로 사용할 수 있는 세 가지 유사 사례를 분명히 밝혀 둘 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트 이름으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보냅니다. 그러나 사용자 지정 도메인은 호스트 이름에 R2임을 식별할 수 있는 어떤 것도 담고 있지 않으므로 Router는 다른 호스트와 구별할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 미리 서명하거나 `pub-.r2.dev` 형태를 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 돌려받는 거부 메시지에 바로 이 형태들이 명시되므로, 이를 읽기 위해 이 문서를 찾아올 필요는 없습니다. 위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형태를 보여 줄 뿐, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 하므로 같은 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 그것으로 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. 아래 예시는 형태만 보여 줍니다. 실제 값에는 서명 쿼리 파라미터도 포함되는데, 게시된 예시는 스펙에 영구히 남고 실제 서명은 유출된 자격 증명이자 작동이 중단되는 링크이기 때문에 여기서는 의도적으로 생략했습니다. 각 이미지는 25 MiB로 제한되며, 한 요청의 이미지 총합은 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 보내는 호출)로, 여기서는 각 이미지가 최대 50 MB(50,000,000바이트) 및 67,108,864픽셀, 한 요청의 이미지 총합이 최대 128 MiB까지 가능합니다. + 실행할 gpt-image 모델입니다. Router가 주소 지정된 모델 id를 삽입하므로, /v2/models/openai/gpt-image-2.6-flare로 주소를 지정하는 호출자는 이 값을 보내지 않습니다. diff --git a/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx b/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx index c46242edca..d0c35720b4 100644 --- a/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/ko/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -167,7 +167,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2/requests/$REQUEST_ID \ - **Runware**, `runware/runware-gpt-image-2`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=runware` - **WaveSpeed**, `wavespeed/wavespeed-gpt-image-2`로: `POST https://api.comfy.org/v2/models/openai/gpt-image-2?model_provider=wavespeed` -`strict_mode`의 기본값은 거짓이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이렇게 라우팅되는 모든 모델에 대해서는 [제공 공급자](/ko/development/comfy-router/providers)를 참조하세요. +`strict_mode`의 기본값은 false이므로, Router는 이 페이지에 문서화된 네이티브 요청 본문을 공급자 자체의 스키마로 변환하고 응답을 다시 변환합니다. API 레퍼런스의 [`model_provider`, `strict_mode` 및 `fallback_provider`](/ko/development/comfy-router/reference#post-v2modelsprovidermodel)와, 이렇게 라우팅되는 모든 모델에 대해서는 [제공 공급자](/ko/development/comfy-router/providers)를 참조하세요. ## 스키마 @@ -195,7 +195,7 @@ URL은 자격 증명 없이 해석되어야 합니다. Router는 서버 측에 첫 번째는 `POST /customers/storage`가 업로드에 서명해 넣는 버킷입니다. 배포가 귀하의 환경에 도달할 때까지 해당 엔드포인트의 업로드 URL은 여기에서 거부됩니다. 버킷이 Comfy 소유이고 호스트도 동일한데도 그렇습니다. 따라서 "Comfy에 업로드한 뒤 URL을 전달"하는 방식은 아직 동작하지 않으며, 동작하는 형식은 `/api/assets/{id}/content`가 리다이렉트하는 서명 URL입니다. 두 번째는 모든 계정에 한 번에 적용되는 것이 아니라 계정별로 활성화됩니다. 이 호스트 뒤의 버킷이 우리 것이 아니라 귀하의 것이기 때문입니다. 위 전환을 켠 뒤에도 서드파티 인바운드 미디어가 활성화되지 않은 계정은 거부되며, 호스트가 지원되지 않는다는 안내 대신 그 취지의 문구를 받습니다. Comfy 담당자에게 계정에 대해 활성화해 달라고 요청하세요. 또한 버킷이 귀하의 것이고 Router가 이에 대한 소유권을 주장하지 않는 다음 서드파티 오브젝트 스토리지 호스트를 허용합니다: Cloudflare R2 (`.r2.cloudflarestorage.com`, `pub-.r2.dev`), Amazon S3 (`s3.amazonaws.com` 및 `s3..amazonaws.com`, 경로 스타일 또는 `.` 접두 형식 모두), Azure Blob Storage (`.blob.core.windows.net`), Alibaba Cloud OSS (`.oss-.aliyuncs.com`, `oss-accelerate` 엔드포인트 포함). 이는 특히 오브젝트 스토리지 엔드포인트입니다. 같은 공급자 도메인의 일반 목적 엔드포인트, 예컨대 Alibaba Function Compute 트리거는 목록에 없으며 거부됩니다. 일치되는 것은 공급자가 아니라 호스트명 형식입니다. 따라서 위에서 공급자를 언급했다고 해서 그 공급자가 발급할 수 있는 모든 URL이 허용된다는 뜻은 아니며, 호출자가 합리적으로 각각을 가지고 올 수 있으므로 세 가지 유사 사례를 분명히 밝힐 필요가 있습니다. R2 사용자 지정 도메인(`cdn.example.com`)은 허용되지 않습니다. Cloudflare는 `pub-.r2.dev`를 속도 제한이 있는 디버그 호스트명으로 문서화하고 프로덕션 트래픽은 대신 사용자 지정 도메인으로 보냅니다. 그러나 사용자 지정 도메인은 호스트명에 R2임을 식별할 정보가 없으므로 Router는 다른 호스트와 구분할 수 없어 거부합니다. `.r2.cloudflarestorage.com` 엔드포인트를 presign하거나 `pub-.r2.dev` 형식을 사용하세요. S3의 IPv6 dualstack 엔드포인트(`s3.dualstack..amazonaws.com`)도 허용되지 않습니다. 일반 리전 엔드포인트를 사용하세요. Azure Blob의 대체 DNS 영역(`.z.blob.storage.azure.net`)도 마찬가지입니다. `.blob.core.windows.net`을 사용하세요. 반환되는 거부 메시지에 이와 동일한 형식이 명시되므로, 이를 읽기 위해 여기까지 올 필요는 없습니다. -위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형태를 보여줄 뿐이며, 깊이 제한이 아닙니다. 일치는 객체 스토리지 도메인 접미사를 기준으로 이루어지므로, 같은 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 다만 이것으로 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. +위의 `` 및 `pub-` 자리 표시자는 일반적으로 사용하게 될 형태를 보여줄 뿐이며, 깊이 제한이 아닙니다. 일치는 오브젝트 스토리지 도메인 접미사를 기준으로 이루어지므로, 같은 네임스페이스 아래의 더 깊은 이름(`a.b.pub-.r2.dev`)도 허용됩니다. 다만 이것으로 넓어지지 않는 것은 네임스페이스 자체입니다. 접미사는 여전히 나열된 것 중 하나여야 합니다. 아래 예시는 형태만 보여줍니다. 실제 값에는 서명 쿼리 파라미터도 함께 포함되는데, 게시된 예시는 스펙에 영원히 남고 실제 서명은 유출된 자격 증명이자 더 이상 작동하지 않는 링크이므로 여기서는 의도적으로 생략했습니다. 각 이미지는 25 MiB로 제한되며, 한 요청의 이미지들은 총 64 MiB로 제한됩니다. 유일한 예외는 `context_window`를 사용할 수 있는 ideogram/ideogram-4-5 Precise Edit(`image`를 보내는 호출)입니다. 여기서는 각 이미지가 최대 50 MB(50,000,000바이트) 그리고 67,108,864픽셀까지 가능하며, 한 요청의 이미지들은 총 128 MiB까지 가능합니다. diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index 20b60709ce..738b55e440 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -286,7 +286,7 @@ minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 -자체의 단일 에셋은20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. +자체의 20MB 한도에 해당하는 단일 에셋은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 전송 한도는 여러 에셋에 걸쳐 구속력을 가지는데, 100 MiB Router 상한이 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 한도에 근접하는 것은 무엇이든 공개 URL로 보내십시오. @@ -369,8 +369,7 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 생성된 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적합한aspect ratio based on the input media proportions and intent. -입력 미디어의 비율과 의도에 따라 결정되는 종횡비입니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적합한 화면 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index 37cc1fcfea..f4b393df6b 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -286,7 +286,7 @@ minItems/maxItems가 선언되어 있지 않습니다. 허용되는 유형과 전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 -크기에서는 파트너 자체의20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. 여러 에셋에 걸치면 전송 한도가 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 한도에 가까운 것은 공개 URL로 보내세요. +크기에서는 파트너 자체의 20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. 여러 에셋에 걸치면 전송 한도가 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 한도에 가까운 것은 공개 URL로 보내세요. @@ -365,7 +365,7 @@ minItems/maxItems가 선언되어 있지 않습니다. 허용되는 유형과 생성되는 비디오의 가로세로 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 자동으로 적합한 값을 추천합니다입력 미디어의 비율과 의도에 따라 결정되는 종횡비입니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도를 기반으로 적합한 종횡비를 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index 8d9d1dfd6b..980d0a36c0 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -205,7 +205,7 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID - happyhorse-1.0-video-edit: video(정확히 1개, 편집할 클립: MP4/MOV, 3-60초, 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 100MB, 공개 HTTP/HTTPS URL. 인라인 data: URL은 허용되지 않음)와 선택 사항인 0~5개의 reference_image(JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 가로세로 비율 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL)입니다. - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: 텍스트 기반 비디오 생성 연산입니다. 해당 파트너 참조 문서에는 media 입력이 없으므로 이 필드는 설정하지 않은 상태로 두십시오. - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 이 컴포넌트는 이 표기들에 대해 어떤 media 어휘도 열거하지 않습니다. wan2.5-i2v-preview와 wan2.6-i2v는 첫 프레임을 img_url에서 받고, wan2.6-r2v는 참조 클립을 reference_video_urls에서 받습니다. -위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한이 모델마다 다르기 때문입니다. 스키마가 허용한다고 해서 공급자가 허용한다는 뜻은 아닙니다. 반대 방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 입력인 이미지 입력의 상한으로서, 파트너가 최종적으로 받는 에셋에 대한 파트너의 상한이며, 에셋이 공개 URL일 때는 그대로 적용됩니다. 해당 바이트는 Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3으로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. +위의 모델별 개수는 이 스키마가 아니라 파트너의 제약입니다. media에는 minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한이 모델마다 다르기 때문입니다. 스키마가 허용한다고 해서 공급자가 허용한다는 뜻은 아닙니다. 반대 방향으로, 위의 에셋별 "최대 20MB" 수치는 인라인으로 전송될 수 있는 유일한 입력인 이미지 입력의 상한으로서, 파트너가 최종적으로 받는 에셋에 대한 파트너의 상한이며, 에셋이 공개 URL일 때는 그대로 적용됩니다. 해당 바이트는 Comfy를 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3으로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의 20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 근접하는 값은 공개 URL로 보내세요. @@ -294,7 +294,7 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 생성되는 비디오의 화면 비율. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적절한입력 미디어의 비율과 의도에 따른 가로세로 비율입니다. +wan3.0-video의 경우 adaptive(기본값)는 입력 미디어의 비율과 의도에 따라 적절한 가로세로 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index b7031322c4..9600f169f7 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -282,7 +282,7 @@ minItems/maxItems가 선언되어 있지 않은데, 허용되는 타입과 그 상한도 적용됩니다. Comfy Router POST 본문은 전체 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 -자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. +자체의 20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. 여러 에셋에 걸치면 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 공개 URL로 보내세요. @@ -364,7 +364,7 @@ wan3.0-video 참조 모드의 경우, media 배열 내의 해당 순서대로 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)는 적절한입력 미디어의 비율과 의도에 기반한 가로세로 비율입니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적합한 화면 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index 3946c61ca1..a6e8ebce20 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -286,7 +286,7 @@ minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 상한도 함께 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의 -단일 에셋이20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나일 때는 파트너 규칙이 제약이 됩니다. +20MB 상한을 가진 단일 에셋이 인라인으로 충분히 들어가므로, 에셋 하나일 때는 파트너 규칙이 제약이 됩니다. 여러 개일 때는 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 무엇이든 공개 URL로 보내세요. @@ -369,13 +369,13 @@ wan3.0-video 참조 모드의 경우 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 프롬프트 지능적 재작성 활성화 여부입니다. 기본값은 참입니다. + 프롬프트 지능적 재작성 활성화 여부입니다. 기본값은 true입니다. 생성된 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적절한 값을 자동으로 추천합니다.aspect ratio는 입력 미디어의 비율과 의도에 따라 결정됩니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 화면 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx index 5194c435e2..e96c392514 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx @@ -242,7 +242,7 @@ JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10M HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않습니다. - wan2.7-videoedit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 2-10초, 변당 240-4096 픽셀, 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 - 허용되지 않음) plus 선택적 0에서 4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, + 허용되지 않음) 및 선택적 0에서 4개의 reference_image (JPEG/JPG/PNG/BMP/WEBP, 변당 240-8000 픽셀, 종횡비 1:8에서 8:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). - wan3.0-video, wan3.0-video-prime: first_frame (최대 1), last_frame (최대 1), @@ -265,7 +265,7 @@ JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10M 이 연산에서 입력 유형이 아닙니다. - happyhorse-1.0-video-edit: video (정확히 1개, 편집 대상 클립: MP4/MOV, 3-60초, 긴 변 최대 4096 픽셀, 짧은 변 최소 360 픽셀, 종횡비 1:2.5에서 2.5:1 사이, - 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않음) plus + 최대 100MB, 공개 HTTP/HTTPS URL이며, 인라인 data: URL은 허용되지 않음) 및 선택적 0에서 5개의 reference_image (JPEG/JPG/PNG/WEBP, 최소 300x300 픽셀, 종횡비 1:2.5에서 2.5:1 사이, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL). @@ -285,7 +285,7 @@ JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10M 전송 상한도 만납니다. Comfy Router POST 본문은 총 100 MiB로 제한되어 이를 넘으면 413으로 응답하며, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB가 넘는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서는 -파트너 자체의 단일 에셋이20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 보내십시오. +파트너 자체의 20MB 상한을 가진 단일 에셋이 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 보내십시오. @@ -364,7 +364,7 @@ JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10M 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적절한 값을 자동으로 추천합니다입력 미디어의 비율과 의도에 따른 화면 비율입니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 화면 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index ffb0767cdf..346f2cb521 100644 --- a/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/ko/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -228,8 +228,8 @@ media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. reference_audio(최대 5개 클립, 총 재생 시간 \<= 15초), file(최대 1개, link와 함께 사용할 수 없음), link(최대 1개, file과 함께 사용할 수 없음). reference_*/file/link 유형과 first_frame/last_frame 유형은 같은 요청 내에서 상호 배타적입니다. - 배열 순서가 프롬프트 내 에셋의 참조 순서를 정의합니다(이미지 1, 비디오 1, - 오디오 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, + 배열 순서가 프롬프트 내 에셋의 참조 순서를 정의합니다(Image 1, Video 1, + Audio 1, ...). first_frame, last_frame 및 reference_image: JPEG/JPG/PNG/BMP/WEBP, 측면당 240-8000 픽셀, 가로세로 비율 최대 8:1, 최대 20MB, 공개 URL 또는 data:\{MIME_type};base64,... URL. reference_video, reference_audio, file 및 link: 공개 HTTP/HTTPS URL이며 인라인 data: URL은 허용되지 않습니다. @@ -262,7 +262,7 @@ media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 상한도 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 약 75MB를 넘는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 단일 -에셋은 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. +에셋은 파트너 자체의 20MB 상한 안에 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 제약이 됩니다. 여러 에셋에 걸치면 전송 상한이 제약이 되는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 공개 URL로 보내세요. @@ -352,7 +352,7 @@ wan3.0-video 참조 모드에서는 media 배열 내 해당 순서의 미디어 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적합한입력 미디어의 비율과 의도에 따른 가로세로 비율입니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 화면 비율을 자동으로 권장합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index b77fe93ac5..b4469720fc 100644 --- a/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -265,11 +265,9 @@ minItems/maxItems가 선언되어 있지 않은데, 허용되는 유형과 그 거치지 않기 때문입니다. 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 함께 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3으로 부풀리므로 약 75 MB를 초과하는 -단일 인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서 -파트너 자체의 단일 에셋은 +단일 인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서 파트너 자체의 20MB 상한에 있는 단일 에셋은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 공개 URL로 보내세요. -20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 가까운 것은 공개 URL로 보내세요. 미디어 에셋 유형 @@ -354,7 +352,7 @@ wan3.0-video 참조 모드에서는 media 배열 내 해당 순서의 미디어 생성되는 비디오의 화면 비율. wan2.7 및 wan3.0 모델 전용. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적절한 값을 자동으로 추천합니다.aspect ratio(화면 비율)는 입력 미디어의 비율과 의도에 따라 결정됩니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도를 기반으로 적절한 화면 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx b/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx index 9dd86e6192..7d7c049e8c 100644 --- a/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx @@ -262,7 +262,7 @@ img_url이나 reference_video_urls가 아니라 여기에서 받는지 여부는 URL은 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기서 설명한 -파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의 단일20MB 한도는 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 한도가 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 한도에 가까운 값은 공개 URL로 보내십시오. +파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의 20MB 한도에 있는 단일 에셋은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 한도가 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 한도에 가까운 값은 공개 URL로 보내십시오. @@ -335,13 +335,13 @@ POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답 - 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 참입니다. + 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 true입니다. 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 값을 제공하지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적절한 값을 자동으로 추천합니다.입력 미디어의 비율과 의도에 따른 화면 비율입니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 화면 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index 8dd60bf7cf..d1b51bdadf 100644 --- a/ko/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -267,7 +267,7 @@ Comfy를 거치지 않으므로 명시된 그대로 적용됩니다. 인라인 d URL은 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로, 대략 75 MB를 초과하는 단일 인라인 -에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서는 단일 에셋이 파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 전송 상한은 여러 에셋에 걸쳐 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 값은 공개 URL로 전송하세요. +에셋은 여기의 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서는 파트너 자체의 20MB 상한에 있는 단일 에셋이 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 전송 상한은 여러 에셋에 걸쳐 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이 상한에 근접하는 값은 공개 URL로 전송하세요. @@ -348,7 +348,7 @@ wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우, 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우, adaptive(기본값)는 적절한입력 미디어의 비율과 의도에 기반한 가로세로 비율입니다. +wan3.0-video의 경우, adaptive(기본값)는 입력 미디어의 비율과 의도에 기반하여 적절한 가로세로 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index 73fdec0694..5931ac2b73 100644 --- a/ko/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -268,7 +268,7 @@ JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10M 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 초과하면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 초과하는 단일 인라인 에셋은 여기의 파트너 규칙에 도달하기도 전에 거부됩니다. 그 크기에서는 파트너 자체의 -단일 에셋20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 실제로 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 가까운 값은 공개 URL로 보내세요. +단일 에셋의 20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 실제로 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 가까운 값은 공개 URL로 보내세요. @@ -347,7 +347,7 @@ JPEG, JPG, PNG, BMP, WEBP. 해상도: 360-2000 픽셀. 파일 크기: 최대 10M 생성되는 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델에서는 제공되지 않으면 해상도 티어에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적절한입력 미디어의 비율과 의도에 따른 종횡비입니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 종횡비를 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/wan2-6-t2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-6-t2v/code.mdx index f2d9af91a4..81ab9551ae 100644 --- a/ko/development/comfy-router/models/wan/wan2-6-t2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-6-t2v/code.mdx @@ -342,9 +342,9 @@ URL일 때는 그대로 적용됩니다. 해당 바이트는 Comfy를 거치지 생성되는 비디오의 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 자동으로 적절한aspect ratio based on the input media proportions and intent. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도를 기반으로 적절한 가로세로 비율을 자동으로 추천합니다. - Possible values: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -357,7 +357,7 @@ wan3.0-video의 경우 adaptive(기본값)가 자동으로 적절한aspect ratio - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P 이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 과금 요율을 결정하기 때문입니다. 이 프록시는 검사 전에 resolution을 대문자로 변환하고 대문자로 변환된 값을 전달하며, 이 열거형에 없는 값에 대해서는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서는 480P(resolution으로 보내든 480P size로 보내든)에 대해 400을 반환합니다. - Possible values: `480P`, `720P`, `1080P` + 가능한 값: `480P`, `720P`, `1080P` @@ -372,7 +372,7 @@ wan2.6 및 wan2.7-r2v 모델용입니다. - single: 단일 샷 비디오(기본값) - multi: 멀티 샷 비디오 - Possible values: `multi`, `single` + 가능한 값: `multi`, `single` diff --git a/ko/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 2ed3096fea..df28be9a6b 100644 --- a/ko/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -101,7 +101,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v \ -동일한 body를 `POST https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests`로 전송합니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`을 응답하며, 결과는 준비가 되면 이 프로세스 또는 다른 프로세스에서 수집합니다. [대기열 전송](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 자세히 다룹니다. +동일한 본문을 `POST https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests`로 전송합니다. Router는 실행이 접수되는 즉시 `request_id`와 함께 `201`을 응답하며, 결과는 준비가 되면 이 프로세스 또는 다른 프로세스에서 수집합니다. [대기열 전송](/ko/development/comfy-router/queue)에서 상태, 취소, 수집 과정을 자세히 다룹니다. ```python Python @@ -286,7 +286,7 @@ minItems/maxItems가 선언되어 있지 않은데, 허용되는 타입과 그 전송 상한도 함께 적용됩니다. Comfy Router POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75 MB를 넘는 단일 인라인 에셋은 여기의 어떤 파트너 규칙에도 도달하기 전에 거부됩니다. 그 크기에서는 -파트너 자체의20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 가까운 값은 공개 URL로 보내세요. +파트너 자체의 20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 여러 에셋에 걸치면 전송 상한이 구속력을 가지는데, 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문입니다. 이러한 상한에 가까운 값은 공개 URL로 보내세요. @@ -367,7 +367,7 @@ wan3.0-video 참조 모드에서는 media 배열 내 해당 순서의 미디어 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)는 적절한미디어 입력 비율과 의도에 따른 화면 비율입니다. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도를 기반으로 적합한 화면 비율을 자동으로 추천합니다. 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/ko/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index d078330c5e..00381dc6f7 100644 --- a/ko/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -287,7 +287,7 @@ wan2.6-i2v에서 성공하는 img_url 본문은 happyhorse-1.0-i2v 및 happyhors 인라인 data:\{MIME_type};base64,... URL은 Comfy를 거치므로 전송 상한도 적용됩니다. Comfy Router의 POST 본문은 총 100 MiB로 제한되며 이를 넘으면 413으로 응답하고, base64는 페이로드를 약 4/3로 부풀리므로 대략 75MB를 넘는 단일 인라인 에셋은 여기서 -설명한 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의 단일 에셋20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문에, 여러 에셋에 걸치면 전송 상한이 구속력을 가집니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 보내세요. +설명한 파트너 규칙에 도달하기 전에 거부됩니다. 그 크기에서 파트너 자체의 단일 에셋의 20MB 상한은 인라인으로 충분히 들어가므로, 에셋 하나에 대해서는 파트너 규칙이 구속력을 가집니다. 100 MiB Router 상한은 각 요소가 아니라 요청 전체를 제한하기 때문에, 여러 에셋에 걸치면 전송 상한이 구속력을 가집니다. 이 상한에 근접하는 것은 무엇이든 공개 URL로 보내세요. @@ -362,7 +362,7 @@ wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사 - 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 참입니다 + 프롬프트 지능형 재작성을 활성화할지 여부입니다. 기본값은 true입니다 diff --git a/ko/development/comfy-router/models/wan/wan2-7-t2v/code.mdx b/ko/development/comfy-router/models/wan/wan2-7-t2v/code.mdx index c241a7b632..4ec27ef8c6 100644 --- a/ko/development/comfy-router/models/wan/wan2-7-t2v/code.mdx +++ b/ko/development/comfy-router/models/wan/wan2-7-t2v/code.mdx @@ -351,9 +351,9 @@ wan3.0-video 참조 모드에서는 'Image 1', 'Video 1', 'Audio 1' 등을 사 생성되는 비디오의 화면 비율입니다. wan2.7 및 wan3.0 모델 전용입니다. wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본값이 정해집니다. -wan3.0-video의 경우 adaptive(기본값)가 적절한 비율을 자동으로 추천합니다aspect ratio based on the input media proportions and intent. +wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도에 따라 적절한 화면 비율을 자동으로 추천합니다. - Possible values: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -366,13 +366,13 @@ wan3.0-video의 경우 adaptive(기본값)가 적절한 비율을 자동으로 - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P 이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부합니다. 해상도 등급이 청구 요율을 결정하기 때문입니다. 검사 전에 resolution을 대문자로 변환하고 그 대문자 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7, happyhorse-1.0 모델에서는 (resolution으로 보내든 480P size로 보내든) 480P에 대해 400을 반환합니다. - Possible values: `480P`, `720P`, `1080P` + 가능한 값: `480P`, `720P`, `1080P` 난수 시드로, 모델이 생성하는 콘텐츠의 무작위성을 제어하는 데 사용됩니다 - Range: `0` ~ `2147483647` + 범위: `0` ~ `2147483647` @@ -381,7 +381,7 @@ wan2.6 및 wan2.7-r2v 모델 대상입니다. - single: 단일 샷 비디오 (기본값) - multi: 멀티 샷 비디오 - Possible values: `multi`, `single` + 가능한 값: `multi`, `single` diff --git a/ko/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/ko/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index cba37c0fb0..38cf2cbf0b 100644 --- a/ko/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/ko/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -269,7 +269,7 @@ media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. 미디어 에셋 유형 - Possible values: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` + 가능한 값: `first_frame`, `last_frame`, `driving_audio`, `first_clip`, `reference_image`, `reference_video`, `reference_audio`, `video`, `file`, `link` @@ -318,7 +318,7 @@ media에서 받습니다. 이미지 형식: JPEG, JPG, PNG, BMP, WEBP. - auto (기본값): 모델이 프롬프트 콘텐츠를 기반으로 지능적으로 판단 - origin: 입력 비디오의 원본 오디오를 강제로 유지 - Possible values: `auto`, `origin` + 가능한 값: `auto`, `origin` @@ -346,7 +346,7 @@ wan2.7 모델의 경우 제공되지 않으면 해상도 등급에 따라 기본 wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의도를 기반으로 적절한 화면 비율을 자동으로 추천합니다. - Possible values: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` + 가능한 값: `adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -359,7 +359,7 @@ wan3.0-video의 경우 adaptive(기본값)가 입력 미디어의 비율과 의 - happyhorse-1.1-* (t2v, i2v, r2v): 480P, 720P, 1080P 이 프록시는 resolution과 size를 모두 제공하지 않는 비디오 생성 요청을 거부하는데, 해상도 등급이 과금 요율을 결정하기 때문입니다. 확인 전에 resolution을 대문자로 -변환하고 대문자로 변환된 값을 전달하며, 400을 반환합니다이 enum 외부의 값에 대해서는, 그리고 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 전송되든 480P 크기로 전송되든)에 대해 400을 반환합니다. +변환하고 대문자로 변환된 값을 전달하며, 이 enum에 없는 값에는 400을 반환하고, 위에서 480P가 없다고 나열된 wan2.6, wan2.7 및 happyhorse-1.0 모델에서 480P(해상도로 전송되든 480P 크기로 전송되든)에 대해 400을 반환합니다. 가능한 값: `480P`, `720P`, `1080P` diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index 8c5c990dc6..7a8c6fc33f 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -331,13 +331,13 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 정규 `{provider}/{model}` 모델 ID의 소문자 공급자 세그먼트로, 실행 대상 모델을 보유한 파트너입니다. - Type: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 + 유형: [`RouterProviderSegment`](#routerprovidersegment) -- 영숫자 슬러그, 예: `anthropic`, 최대 64자 정규 `{provider}/{model}` 모델 ID의 소문자 모델 세그먼트로, 해당 공급자 내에서 실행할 모델입니다. - Type: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 + 유형: [`RouterModelSegment`](#routermodelsegment) -- 영숫자 슬러그, 예: `claude-opus-4-6`, 최대 128자 @@ -355,61 +355,61 @@ Comfy API 키는 Bearer 토큰으로도 전송할 수 있습니다. 두 자격 견적입니다. - Body: [`RouterCostEstimate`](#routercostestimate) -- Headers: `X-Comfy-Request-Id` + 본문: [`RouterCostEstimate`](#routercostestimate) -- 헤더: `X-Comfy-Request-Id` 유효하지 않은 요청입니다. 오류 유형과 요청 본문을 확인하세요. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 자격 증명이 누락되었거나 유효하지 않습니다. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 이 호출자 또는 모델에 대해 허용되지 않는 요청입니다. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 모델 ID를 찾을 수 없습니다. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 요청 본문이 너무 큽니다. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` 견적 요청의 본문이 모델 스키마에 대해 거부되었거나, 경로와 다른 모델을 지정했습니다. - Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` `rate_limited`: 호출자의 요청 허용량이 소진되었습니다. 다음 요청을 보내기 전에 `Retry-After`를 기다리세요. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` Router를 일시적으로 사용할 수 없습니다. 백오프를 두고 재시도하세요. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부 시에만) + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (용량 거부 시에만) 요청이 기한을 초과했습니다. 재시도하기 전에 오류 유형을 확인하세요. - Body: [`RouterErrorResponse`](#routererrorresponse) -- Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 본문: [`RouterErrorResponse`](#routererrorresponse) -- 헤더: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` ### `GET /v2/models/{provider}/{model}/openapi.json` @@ -1239,7 +1239,7 @@ Router가 아직 실행 전에 가격을 산정할 수 없는 모델은 [실행 기계가 읽을 수 있는 Router 오류 카테고리이며, `X-Comfy-Error-Type` 헤더로도 전송됩니다. -Type: `string` +타입: `string` ### RouterModelBilling @@ -1386,13 +1386,13 @@ Router 모델 카탈로그의 한 페이지입니다. 대기 중인 Router 요청 하나의 식별자입니다. 호출자가 결과를 폴링하고, 취소하고, 수집할 때 사용하는 핸들입니다. - Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, Up to 36 characters + 타입: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 최대 36자 이 라우트가 실제로 처리한 요청을 설명하는 두 결과에 대해 취소 요청이 발견한 내용입니다. 두 결과 모두 HTTP 상태로 반영되므로 클라이언트는 어느 쪽으로든 분기할 수 있습니다. - Type: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) + 타입: [`RouterQueueCancelStatus`](#routerqueuecancelstatus) ### RouterQueueCancelStatus @@ -1493,7 +1493,7 @@ Router 모델 카탈로그의 한 페이지입니다. [`RouterQueueUrls`](#routerqueueurls), [`RouterQueueSubmitFields`](#routerqueuesubmitfields)를 구성합니다. -Type: `object` +타입: `object` ### RouterQueueUrls diff --git a/ko/development/deploy/cloud-custom-builds.mdx b/ko/development/deploy/cloud-custom-builds.mdx index bbb39bd23b..994abc6ca0 100644 --- a/ko/development/deploy/cloud-custom-builds.mdx +++ b/ko/development/deploy/cloud-custom-builds.mdx @@ -12,11 +12,7 @@ translationBlockHashes: "Stop or delete your deployment": c6996c1e "Next steps": 8223b620 --- -A Build packages your Custom Nodes → 빌드는 커스텀 노드, 비공개 커스텀 노드, LoRA 및 기타 모델과 Python 의존성을 패키징하여 워크플로를 Comfy Cloud에서 실행할 수 있게 합니다. 빌드는 Comfy Cloud 편집기에서 시작하고, Developer Platform에서 생성 및 배포한 다음, 편집기에서 해당 빌드 위에서 워크플로를 실행합니다. - -Output: - -빌드는 커스텀 노드, 비공개 커스텀 노드, LoRA 및 기타 모델, Python 의존성을 패키징하여 워크플로를 Comfy Cloud에서 실행할 수 있게 해줍니다. 빌드는 Comfy Cloud 편집기에서 시작하고, Developer Platform에서 생성 및 배포한 다음, 편집기에서 해당 빌드 위에서 워크플로를 실행합니다. +빌드는 커스텀 노드, 비공개 커스텀 노드, LoRA 및 기타 모델과 Python 의존성을 패키징하여 워크플로를 Comfy Cloud에서 실행할 수 있게 합니다. 빌드는 Comfy Cloud 편집기에서 시작하고, Developer Platform에서 생성 및 배포한 다음, 편집기에서 해당 빌드 위에서 워크플로를 실행합니다. 빌드를 배포하면 해당 워크플로만을 처리하는 GPU 워커도 제공됩니다. Comfy Cloud가 이미 워크플로의 모든 노드를 지원하는 경우에도 마찬가지입니다. diff --git a/ko/development/serverless/library-models.mdx b/ko/development/serverless/library-models.mdx deleted file mode 100644 index 6dcecf3fd3..0000000000 --- a/ko/development/serverless/library-models.mdx +++ /dev/null @@ -1,171 +0,0 @@ ---- -title: "Comfy API 배포에서 워크스페이스 라이브러리 모델 사용" -sidebarTitle: "라이브러리 모델" -description: "LoRA 또는 기타 .safetensors 모델을 워크스페이스 라이브러리에 업로드하고 새로운 Build, Release 또는 재배포 없이 Comfy API 배포에서 실행하세요." -icon: "folder-open" -translationSourceHash: ece5d691 -translationFrom: development/serverless/library-models.mdx -translationBlockHashes: - "_intro": 6a0b3555 - "Before you start": c7b9ddf9 - "Upload a model to the workspace library": 693a12a3 - "Run the model on your deployment": 8b7df85e - "Follow the limits and naming rules": 5b0d3461 - "Change or delete a library model": dda1b7bd ---- -Comfy API는 배포의 Release에 포함되어 있지 않더라도 워크스페이스 라이브러리의 모델을 실행합니다. LoRA 또는 다른 `.safetensors` 모델을 라이브러리에 업로드하고, 새 Build, Release, 재배포 없이 배포에서 실행하세요. - -워크스페이스 라이브러리를 사용하면 배포에서 직접 학습한 LoRA를 사용해 보거나, 워크플로에서 파일 이름 하나만 변경하여 API 요청마다 다른 LoRA를 선택할 수 있습니다. - -## 시작하기 전에 - -모델을 워크스페이스 라이브러리에 업로드하기 전에 다음 요구 사항을 충족해야 합니다: - -- **플랜**: 워크스페이스에 활성 Pro, Creator, Team, Enterprise 플랜이 필요합니다. -- **모델 파일**: 파일은 2 GB 이하의 `.safetensors` 파일이어야 합니다. SDXL 또는 FLUX와 같은 더 큰 베이스 모델은 여전히 Build에 포함됩니다. -- **활성 배포**: 배포는 라이브러리와 동일한 워크스페이스에 있어야 합니다. - - - 워크스페이스 라이브러리 모델을 사용할 수 있게 되기 전에 생성된 일부 배포에서는 해당 모델을 로드할 수 없습니다. 워크스페이스 라이브러리 모델을 사용하려면 새 배포를 생성하세요. 이전 배포에서는 작업이 다음 메시지와 함께 실패할 수 있습니다: `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` - - -## 워크스페이스 라이브러리에 모델 업로드 - -세 가지 도구 중 하나로 모델을 업로드할 수 있습니다: - -- **클라우드 편집기**: 파일을 업로드하거나 Civitai 또는 Hugging Face 링크에서 가져옵니다. -- **comfy-cli**: 터미널이나 스크립트에서 업로드합니다. -- **Developer Platform**: Build의 모델 단계에서 업로드합니다. - -사용하는 도구의 탭을 선택하세요. - - - - 1. **Run** 왼쪽의 배포 메뉴에서 **Run on** 아래에 **Comfy Cloud**가 선택되어 있는지 확인합니다. - 2. **왼쪽 사이드바**에서 **모델 라이브러리**를 클릭한 다음 **가져오기**를 클릭합니다. - 3. **파일 선택**을 클릭하거나 `.safetensors` 파일을 대화상자로 끌어다 놓습니다. - 4. **이 모델의 유형은 무엇인가요?** 에서 LoRA의 경우 **LoRA**를 그대로 두고, 파일에 맞는 유형을 선택합니다. - 5. **업로드**를 클릭합니다. 업로드가 끝나면 **완료**를 클릭합니다. - - ![my_style_lora_9e2417.safetensors(97.37 MB)가 선택되어 있고, 이 모델의 유형은 무엇인가요?가 LoRA로 설정되어 있으며, 뒤로 및 업로드 버튼이 있는 모델 가져오기 대화상자](/images/development/serverless/library-models-editor-import.png) - - 대신 Civitai 또는 Hugging Face 링크에서 모델을 가져오려면: - - 1. **가져오기** 대화상자에서 **여기에 링크를 붙여넣으세요**에 모델 링크를 붙여넣습니다. - 2. **계속**을 클릭합니다. - 3. **이 모델의 유형은 무엇인가요?** 에서 모델 유형을 선택합니다. - 4. **가져오기**를 클릭합니다. - - 배포에서 실행되는 것은 `.safetensors` 파일뿐입니다. `.ckpt` 같은 다른 형식의 링크 가져오기는 라이브러리에는 가져와지지만 배포에서는 실행되지 않습니다. - - - 파일을 업로드하고 `--type`으로 모델 유형을 설정합니다: - - ```bash - comfy assets library upload my_style.safetensors --type loras - ``` - - 파일이 라이브러리에 있는지 확인합니다: - - ```bash - comfy assets library ls --tags models,loras - ``` - - - 1. Developer Platform에서 Build의 모델 단계를 열고 **모델 업로드**를 클릭합니다. - 2. **워크스페이스 라이브러리**를 선택합니다. - 3. `.safetensors` 파일을 드롭 영역으로 끌어다 놓거나, 영역을 클릭해 찾아봅니다. - 4. **모델 유형**에서 LoRA의 경우 **LoRA**를 그대로 두고, 파일에 맞는 유형을 선택합니다. - 5. **업로드**를 클릭합니다. - - ![Build의 어떤 모델이 빌드에 포함되나요? 단계에 있는 모델 업로드 대화상자로, 공개, 비공개, 워크스페이스 라이브러리 탭, 선택된 워크스페이스 라이브러리, 드롭 영역, LoRA로 설정된 모델 유형, 파일이 워크스페이스 라이브러리에 있다는 문구, 취소 및 업로드 버튼이 표시됩니다](/images/development/serverless/library-models-platform-upload.png) - - - -모델이 라이브러리에 있으면 워크스페이스의 모든 멤버가 사용할 수 있습니다. 라이브러리는 LoRA뿐 아니라 모든 모델 유형을 받습니다. 로더 노드가 읽는 폴더에 맞는 유형을 선택하세요. 예를 들어 LoRA는 `loras`, VAE는 `vae`입니다. - -## 배포에서 모델 실행 - -모델이 라이브러리에 있으면 클라우드 에디터에서 또는 API를 통해 배포에서 실행할 수 있습니다. 작업을 보내는 방식에 해당하는 탭을 선택하세요. - - - - 1. **Run** 왼쪽의 배포 메뉴를 클릭합니다. **Run on**에서 배포를 선택합니다. 에디터가 다시 로드되며, 열려 있던 탭은 그대로 유지됩니다. - 2. `Load LoRA (Model and CLIP)` 노드를 추가하거나, 해당 노드가 포함된 워크플로를 엽니다. - 3. 노드의 `lora_name` 목록에서 파일을 선택합니다. 목록에는 릴리스의 모델과 함께 라이브러리 모델이 표시됩니다. - 4. **Run**을 클릭합니다. - - 첫 실행에서는 워커가 파일을 다운로드하는 동안 실행 대기열에서 해당 작업의 행에 `Downloading my_style.safetensors`가 표시됩니다. 작업이 여러 모델을 다운로드하면 행에 `Downloading ( of )`이 표시됩니다. - - ![체크포인트 로드 노드와 LoRA 로드 (모델 및 CLIP) 노드가 있는 워크플로, lora_name에 업로드한 LoRA가 선택됨, 큐 패널의 맨 위 행에 Downloading my_style_lora_9e2417.safetensors 0 B of 97.37 MB 표시](/images/development/serverless/library-models-editor-downloading.png) - - - [API 형식 워크플로](/ko/development/api-development/workflow-api-format)에서 `LoraLoader` 노드의 `lora_name` 입력을 `.safetensors`를 포함한 라이브러리 파일 이름으로 설정합니다: - - ```json - "10": { - "class_type": "LoraLoader", - "inputs": { - "lora_name": "my_style.safetensors", - "strength_model": 1.0, - "strength_clip": 1.0, - "model": ["4", 0], - "clip": ["4", 1] - } - } - ``` - - `comfy deploy run`, [Comfy SDK](/ko/development/api-development/sdks) 또는 [Comfy API v2](/ko/api-reference/v2/overview)로 워크플로를 전송합니다: - - ```bash - comfy deploy run --deployment --workflow workflow_api.json - ``` - - 다른 LoRA를 사용하려면 다음 요청에서 `lora_name`을 라이브러리의 다른 파일 이름으로 변경하면 됩니다. 새 빌드, 릴리스 또는 재배포는 필요하지 않습니다. - - - - - 라이브러리 모델을 사용하는 워커의 첫 작업은 시간이 더 오래 걸립니다. 워커가 먼저 모델을 다운로드하기 때문입니다. 같은 워커의 이후 작업은 캐시된 사본을 사용합니다. 새 워커는 모델을 다시 다운로드하며, 다른 모델을 위한 공간을 확보하기 위해 캐시에서 모델을 제거한 워커도 마찬가지입니다. 다운로드를 건너뛰려면 모델을 빌드에 추가하세요. - - -## 제한 및 이름 규칙 준수 - -[시작하기 전](#시작하기-전에)에 설명된 파일 크기 및 형식 제한 외에도 다음 제한이 적용됩니다. - -| 제한 | 값 | -| --- | --- | -| 워크스페이스 저장소 | 워크스페이스당 모델 1 TB (링크 가져오기 포함) | -| 워크플로당 라이브러리 모델 이름 | 100 | - -101번째 라이브러리 모델을 지정하는 로더는 해당 파일이 라이브러리에 없는 것처럼 실패합니다. - -작업이 올바른 파일을 찾도록 다음 규칙을 따르세요. - -- **로더가 읽는 폴더를 사용하세요.** 로더는 자신의 모델 유형에 해당하는 라이브러리 파일만 찾습니다. `Load LoRA` 노드는 `checkpoints`가 아닌 `loras`로 업로드된 파일을 찾습니다. -- **순수 파일 이름을 사용하세요.** 로더 입력에는 `my_style.safetensors`처럼 앞에 폴더가 붙지 않은 파일 이름만 설정하세요. -- **Release 모델의 이름을 재사용하지 마세요.** Release에 해당 이름의 파일이 이미 있으면 워커는 라이브러리 파일이 아닌 Release의 파일을 사용합니다. -- **폴더 간에 이름을 고유하게 유지하세요.** 하나의 로더가 읽는 두 폴더에 라이브러리에 같은 파일 이름이 있으면 API를 통해 전송된 작업은 두 파일 모두 로드하지 않습니다. -- **최신 파일이 우선한다는 점을 염두에 두세요.** 한 폴더에 라이브러리에 같은 이름의 파일이 두 개 있으면 작업은 마지막에 추가된 파일을 사용합니다. -- **베이스 모델을 일치시키세요.** LoRA는 워크플로가 로드하는 베이스 모델과 일치해야 합니다. -- **배포에 있는 로더를 사용하세요.** 로더 노드는 배포에서 사용할 수 있어야 합니다. 라이브러리 모델은 Comfy Cloud에 있는 로더 노드를 통해서만 로드됩니다. 사용하는 로더가 Comfy Cloud에 없는 커스텀 노드에서 제공되는 경우 해당 모델을 Build에 추가하세요. - -## 라이브러리 모델 변경 또는 삭제 - -**Run on**에서 배포가 선택된 경우, **Model Library**에는 해당 Release의 모델만 표시됩니다. 라이브러리 모델을 변경하거나 삭제하려면 먼저 Comfy Cloud로 다시 전환하세요: - -1. **Run** 왼쪽의 배포 메뉴를 클릭합니다. **Run on**에서 **Comfy Cloud**를 선택합니다. -2. **Left sidebar**에서 **Model Library**를 클릭합니다. - -모델 유형을 변경하려면: - -- 모델 카드 위에 마우스를 올리고 **Model Info**를 클릭한 다음 새 **Model Type**을 선택합니다. - - - 모델을 삭제하면 모든 멤버의 워크스페이스 라이브러리에서 해당 모델이 제거됩니다. 여전히 해당 파일을 지정하는 작업이나 API 요청은 로더 입력에서 `Value not in list` 오류와 함께 실패합니다. - - -모델을 삭제하려면: - -1. 모델 카드 위에 마우스를 올리고 **More**를 클릭한 다음 **Delete**를 클릭합니다. -2. **Delete this model?**에서 **Delete**를 클릭합니다. diff --git a/ko/tutorials/flux/flux-3-klein.mdx b/ko/tutorials/flux/flux-3-klein.mdx index b7a6fec0a0..06322f22a8 100644 --- a/ko/tutorials/flux/flux-3-klein.mdx +++ b/ko/tutorials/flux/flux-3-klein.mdx @@ -54,7 +54,7 @@ FLUX.3 [klein]은 Black Forest Labs의 로컬 ComfyUI용 오픈 웨이트 FLUX.3 2. `width`와 `height`를 설정하거나 `ResolutionSelector`에서 프레임을 선택합니다 (기본값은 1:1 정사각형) 3. `steps`(기본값 50)와 `cfg`(기본값 3.5)를 조정합니다 4. 프롬프트 업샘플링이 기본적으로 켜져 있어 짧은 프롬프트는 먼저 Qwen3.5 9B 업샘플러로 확장됩니다. 직접 작성한 문장 그대로 생성하려면 `enable_prompt_upsampler`를 끕니다 -5. **실행 대기열**을 클릭합니다. 이미지는 `SaveImage` 노드에 의해 `ComfyUI/output/`에 저장됩니다 +5. **Queue**를 클릭합니다. 이미지는 `SaveImage` 노드에 의해 `ComfyUI/output/`에 저장됩니다 ### FLUX 3 Image Klein Distilled: 텍스트 기반 이미지 생성 {#image_flux3_klein_distilled_t2i} @@ -113,7 +113,7 @@ FLUX.3 [klein]은 Black Forest Labs의 로컬 ComfyUI용 오픈 웨이트 FLUX.3 2. `Set Reference Multi Latent`에 연결합니다. 첫 번째 참조는 프롬프트에서 ``이고, 다음은 ``이며, 이런 식으로 계속 이어집니다 3. 편집 내용은 `FLUX 3 Image Layout Prompt` 노드에 결과에 대한 완전한 설명으로 작성합니다. 제공된 예시의 프롬프트는 `In , change the dress color to red`입니다 4. 다른 출력 크기를 원한다면 `Empty Flux 2 Latent`(템플릿에서는 1024 x 1024)로 캔버스를 조정합니다 -5. **실행 대기열**을 클릭합니다. `ImageCompare`가 입력과 결과를 나란히 보여줍니다 +5. **Queue**를 클릭합니다. `ImageCompare`가 입력과 결과를 나란히 보여줍니다 **예시 출력** @@ -154,7 +154,7 @@ FLUX.3 [klein]은 Black Forest Labs의 로컬 ComfyUI용 오픈 웨이트 FLUX.3 1. 편집할 이미지를 로드하고 `Set Reference Multi Latent`에 연결합니다 2. 편집 프롬프트는 `FLUX 3 Image Layout Prompt` 노드에 작성합니다. 함께 제공되는 예시는 귀걸이를 교체하고, 나타나서는 안 되는 것까지 포함해 새 귀걸이를 자세히 설명합니다 3. `steps`를 4에서 16 범위로 유지하고 `cfg`는 1로 둡니다 -4. **실행 대기열**을 클릭하고 `ImageCompare`에서 입력과 결과를 비교합니다 +4. **Queue**를 클릭하고 `ImageCompare`에서 입력과 결과를 비교합니다 ## FLUX 3 Image Klein 모델 다운로드 diff --git a/ko/tutorials/partner-nodes/pika/pika-h3-flex.mdx b/ko/tutorials/partner-nodes/pika/pika-h3-flex.mdx index 9280c40d94..566a1c284a 100644 --- a/ko/tutorials/partner-nodes/pika/pika-h3-flex.mdx +++ b/ko/tutorials/partner-nodes/pika/pika-h3-flex.mdx @@ -57,7 +57,7 @@ Pika H3 Flex는 [MiniMax H3](/ko/tutorials/video/minimax/minimax-h3)를 Pika가 ## 레퍼런스 기반 비디오 생성 -**Pika H3 Flex Reference to Video** 노드는 레퍼런스 자료를 바탕으로 클립을 생성하거나 편집합니다. 최대 이미지 9개, 비디오 3개, 오디오 클립 3개, 총 12개의 레퍼런스를 사용할 수 있습니다. 비디오와 오디오 클립은 각각 2~15초이며, 비디오와 오디오는 각각 최대 15초까지 합산됩니다. +**Pika H3 Flex Reference to Video** 노드는 레퍼런스 자료를 바탕으로 클립을 생성하거나 편집합니다. 최대 이미지 9개, 비디오 3개, 오디오 클립 3개, 총 12개의 레퍼런스를 사용할 수 있습니다. 비디오와 오디오 클립은 각각 2~15초이며, 비디오와 오디오에는 각각 별도의 15초 제한이 적용됩니다. 프롬프트에서 레퍼런스는 연결 순서에 따라 `@Image1`, `@Video1`, `@Audio1`로 참조하세요. 연결된 비디오의 사운드 대신 새로운 앰비언스나 새 음악을 원할 때는 `reference_video_audio`를 끄세요. diff --git a/ko/tutorials/video/ltx/ltx-2-3.mdx b/ko/tutorials/video/ltx/ltx-2-3.mdx index 8170e6bb68..358a221bbd 100644 --- a/ko/tutorials/video/ltx/ltx-2-3.mdx +++ b/ko/tutorials/video/ltx/ltx-2-3.mdx @@ -52,7 +52,7 @@ LTX-2.3은 ComfyUI에서 기본적으로 지원됩니다. 시작하려면: ## 템플릿 워크플로 선택 -**템플릿 라이브러리** > **Video**에 네이티브 LTX-2.3 템플릿 6개가 포함됩니다(예시이며 전체 목록은 아님). +**템플릿 라이브러리** > **비디오**에 네이티브 LTX-2.3 템플릿 6개가 포함됩니다(예시이며 전체 목록은 아님). @@ -98,19 +98,19 @@ LTX-2.3은 ComfyUI에서 기본적으로 지원됩니다. 시작하려면: - Place in ComfyUI/models/checkpoints/ + ComfyUI/models/checkpoints/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/text_encoders/ + ComfyUI/models/text_encoders/에 배치 - Place in ComfyUI/models/latent_upscale_models/ + ComfyUI/models/latent_upscale_models/에 배치 @@ -157,7 +157,7 @@ ComfyUI/ - Download the default input image, or use your own image. + 기본 입력 이미지를 다운로드하거나 직접 준비한 이미지를 사용하세요. @@ -167,19 +167,19 @@ I2V 워크플로는 텍스트-투-비디오와 동일한 모델 세트를 사용 - Place in ComfyUI/models/checkpoints/ + ComfyUI/models/checkpoints/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/text_encoders/ + ComfyUI/models/text_encoders/에 배치 - Place in ComfyUI/models/latent_upscale_models/ + ComfyUI/models/latent_upscale_models/에 배치 @@ -203,7 +203,7 @@ ComfyUI/ ### LTX-2.3 처음-마지막 프레임 투 비디오 {#video_ltx2_3_flf2v} -시작 이미지와 종료 이미지 사이를 보간합니다. +시작 이미지와 종료 이미지 사이를 보간하여 부드러운 비디오 전환을 생성합니다. @@ -220,10 +220,10 @@ ComfyUI/ - First frame of the video. + 비디오의 첫 프레임입니다. - Last frame of the video. + 비디오의 마지막 프레임입니다. @@ -233,10 +233,10 @@ FLF2V 워크플로는 dev 체크포인트 대신 distilled 체크포인트를 - Place in ComfyUI/models/checkpoints/ + ComfyUI/models/checkpoints/에 배치 - Place in ComfyUI/models/text_encoders/ + ComfyUI/models/text_encoders/에 배치 @@ -272,10 +272,10 @@ ComfyUI/ - Reference image for the speaking character. + 말하는 캐릭터의 참조 이미지입니다. - Audio track for lip synchronization. + 립싱크용 오디오 트랙입니다. @@ -285,19 +285,19 @@ IA2V 워크플로는 텍스트-투-비디오와 동일한 모델 세트를 사 - Place in ComfyUI/models/checkpoints/ + ComfyUI/models/checkpoints/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/text_encoders/ + ComfyUI/models/text_encoders/에 배치 - Place in ComfyUI/models/latent_upscale_models/ + ComfyUI/models/latent_upscale_models/에 배치 @@ -322,7 +322,7 @@ ComfyUI/ ### LTX-2.3 IC-LoRA 유니온 컨트롤 {#video_ltx2_3_ic_lora} 깊이, 포즈 또는 에지와 같은 정렬된 제어 입력을 사용하여 IC-LoRA로 LTX-2.3 비디오를 생성합니다. IC-LoRA는 LTX-2.3 위에 학습된 인컨텍스트 LoRA로, 참조 비디오의 구조적 가이던스를 적용합니다. 깊이 맵, Canny 에지 및 포즈 스켈레톤을 포함한 다양한 전처리기의 제어 신호를 수용합니다. 이 워크플로는 모듈식 처리를 위해 서브그래프를 사용합니다. -![LTX-2.3 IC-LoRA preview](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_ltx2_3_ic_lora-1.webp) +![LTX-2.3 IC-LoRA 워크플로 미리보기](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_ltx2_3_ic_lora-1.webp) @@ -341,10 +341,10 @@ ComfyUI/ - Driving video for control signal extraction. + 제어 신호 추출을 위한 구동 비디오입니다. - Reference image for style and content. + 스타일과 콘텐츠를 위한 참조 이미지입니다. @@ -352,19 +352,19 @@ ComfyUI/ - Place in ComfyUI/models/checkpoints/ + ComfyUI/models/checkpoints/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/text_encoders/ + ComfyUI/models/text_encoders/에 배치 - Place in ComfyUI/models/geometry_estimation/ + ComfyUI/models/geometry_estimation/에 배치 @@ -535,7 +535,7 @@ Remove subtitles, captions, and related text occlusions from the video, restorin ### LTX-2.3 ID LoRA {#video_ltx2_3_id_lora} -참조 이미지와 오디오 클립으로 동기화된 오디오가 포함된 개인화된 비디오를 생성합니다. +텍스트 프롬프트, 참조 이미지 및 짧은 오디오 클립으로 동기화된 오디오가 포함된 개인화된 비디오를 생성합니다. ID-LoRA를 사용하여 단일 생성 모델에서 사람의 외모와 목소리를 적용합니다. @@ -552,10 +552,10 @@ Remove subtitles, captions, and related text occlusions from the video, restorin - Reference image for the character appearance. + 캐릭터 외모를 위한 참조 이미지입니다. - Audio clip for voice cloning and lip sync. + 음성 복제 및 립싱크를 위한 오디오 클립입니다. @@ -563,19 +563,19 @@ Remove subtitles, captions, and related text occlusions from the video, restorin - Place in ComfyUI/models/checkpoints/ + ComfyUI/models/checkpoints/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/loras/ + ComfyUI/models/loras/에 배치 - Place in ComfyUI/models/text_encoders/ + ComfyUI/models/text_encoders/에 배치 - Place in ComfyUI/models/latent_upscale_models/ + ComfyUI/models/latent_upscale_models/에 배치 @@ -605,7 +605,7 @@ LTX-2.3용 프롬프트를 작성할 때는 동작과 장면에 대한 상세하 ## 리소스 -- [Hugging Face Model](https://huggingface.co/Lightricks/LTX-2.3) -- [GitHub Repository](https://github.com/Lightricks/LTX-2) +- [Hugging Face 모델](https://huggingface.co/Lightricks/LTX-2.3) +- [GitHub 저장소](https://github.com/Lightricks/LTX-2) - [ComfyUI-LTXVideo](https://github.com/Lightricks/ComfyUI-LTXVideo/) -- [IC-LoRA Model](https://huggingface.co/Lightricks/LTX-2.3-22b-IC-LoRA-Union-Control) +- [IC-LoRA 모델](https://huggingface.co/Lightricks/LTX-2.3-22b-IC-LoRA-Union-Control) diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index 877fb60bb9..5c57613506 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -162,7 +162,9 @@ Router 运行模型。文件上传、账户读取、资产管理、流式传输 Router 只读取每个参考的前 2 MiB 来查找其大小,因此如果某张图像的大小信息无法在该窗口内读取完(例如一个 JPEG 携带超过 2 MiB 的嵌入元数据,或一个调色板 PNG,其透明度数据,或在没有透明度数据时其第一个图像数据块的起始位置,位于 2 MiB 之后,比如在超过 2 MiB 的文本块或颜色配置文件块之后),就会被 `400` 拒绝,提示其大小头部不在前 2 MiB 之内,上传它也无济于事:请先在不含大型元数据的情况下重新保存它,或者把调色板 PNG 保存为非调色板(真彩色)PNG。国际化主机名请用其 ASCII(punycode)形式发送,例如 `xn--bcher-kva.de` 而不是 `bücher.de`:Router 会按原样查询主机,非 ASCII 名称会被当作不存在的主机拒绝。 -上传在每个环境中都可用,因此它是可移植的选择;请始终按上传返回的原样传入 `image_url`。如果你的图像还不在公开的 `https` 网址上,请先上传它:1. 将每张参考图像以 `multipart/form-data` 上传,图像放在表单字段 `file` 中(JPEG、PNG 或 WebP,最大 75 MB)。使用与 Router 相同的方式进行身份验证,即通过 `X-API-Key` 或 `Authorization: Bearer`。 +上传在每个环境中都可用,因此它是可移植的选择;请始终按上传返回的原样传入 `image_url`。如果你的图像还不在公开的 `https` 网址上,请先上传它: + +1. 将每张参考图像以 `multipart/form-data` 上传,图像放在表单字段 `file` 中(JPEG、PNG 或 WebP,最大 75 MB)。使用与 Router 相同的方式进行身份验证,即通过 `X-API-Key` 或 `Authorization: Bearer`。 ```bash curl -X POST https://api.comfy.org/proxy/krea/assets \ diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index e37c105668..534659f692 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -113,7 +113,8 @@ translationBlockHashes: - [Pika H3 Flex Text To Video](/zh/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code): `pika/pika-h3-flex-text-to-video` - [Pika Soundtrack](/zh/development/comfy-router/models/pika/pika-soundtrack/code): `pika/pika-soundtrack` - [V3.5](/zh/development/comfy-router/models/pixverse/v3-5/code): `pixverse/v3.5` -- [V6 Max](/zh/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max`- [V6](/zh/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` +- [V6 Max](/zh/development/comfy-router/models/pixverse/v6-max/code): `pixverse/v6-max` +- [V6](/zh/development/comfy-router/models/pixverse/v6/code): `pixverse/v6` - [P Video 2](/zh/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2` - [Aleph 2](/zh/development/comfy-router/models/runway/aleph2/code): `runway/aleph2` - [Gen 4 Turbo](/zh/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo` @@ -220,7 +221,8 @@ translationBlockHashes: - [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code):`openai/gpt-image-1.5` - [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code):`openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code):`openai/gpt-image-2.5-sunburst` -- [GPT Image 2.6 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code):`openai/gpt-image-2.6-flare`- [GPT Image 2.6 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` +- [GPT Image 2.6 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code):`openai/gpt-image-2.6-flare` +- [GPT Image 2.6 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code): `openai/gpt-image-2.6-sunburst` - [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` - [Arrow 2 Telos](/zh/development/comfy-router/models/quiver/arrow-2-telos/code): `quiver/arrow-2-telos` - [Arrow 2](/zh/development/comfy-router/models/quiver/arrow-2/code): `quiver/arrow-2` @@ -270,7 +272,8 @@ translationBlockHashes: - [Wan 2.5 T2I Preview](/zh/development/comfy-router/models/wan/wan2-5-t2i-preview/code): `wan/wan2.5-t2i-preview` - [Seedvr 2](/zh/development/comfy-router/models/wavespeed/seedvr2/code): `wavespeed/seedvr2` - [Ultimate Image Upscaler](/zh/development/comfy-router/models/wavespeed/ultimate-image-upscaler/code): `wavespeed/ultimate-image-upscaler` -- [Grok Imagine Image 2.0](/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0`- [Grok Imagine Image Pro](/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code):`xai/grok-imagine-image-pro` +- [Grok Imagine Image 2.0](/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code): `xai/grok-imagine-image-2.0` +- [Grok Imagine Image Pro](/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code):`xai/grok-imagine-image-pro` - [Grok Imagine Image Quality](/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code):`xai/grok-imagine-image-quality` - [Grok Imagine Image](/zh/development/comfy-router/models/xai/grok-imagine-image/code):`xai/grok-imagine-image` @@ -330,7 +333,8 @@ translationBlockHashes: - [Animations](/zh/development/comfy-router/models/meshy/animations/code):`meshy/animations` - [Meshy 6](/zh/development/comfy-router/models/meshy/meshy-6/code):`meshy/meshy-6` -- [Meshy 7.1](/zh/development/comfy-router/models/meshy/meshy-7-1/code):`meshy/meshy-7.1`- [Meshy 7](/zh/development/comfy-router/models/meshy/meshy-7/code):`meshy/meshy-7` +- [Meshy 7.1](/zh/development/comfy-router/models/meshy/meshy-7-1/code):`meshy/meshy-7.1` +- [Meshy 7](/zh/development/comfy-router/models/meshy/meshy-7/code):`meshy/meshy-7` - [Remesh](/zh/development/comfy-router/models/meshy/remesh/code):`meshy/remesh` - [Rigging](/zh/development/comfy-router/models/meshy/rigging/code):`meshy/rigging` - [Stable Fast 3D](/zh/development/comfy-router/models/stability/stable-fast-3d/code):`stability/stable-fast-3d` @@ -385,7 +389,8 @@ translationBlockHashes: - [GPT 5 Nano](/zh/development/comfy-router/models/openai/gpt-5-nano/code):`openai/gpt-5-nano` - [GPT 5](/zh/development/comfy-router/models/openai/gpt-5/code):`openai/gpt-5` - [GPT 6.1 Sol](/zh/development/comfy-router/models/openai/gpt-6-1-sol/code):`openai/gpt-6.1-sol` -- [GPT 6.1 Terra](/zh/development/comfy-router/models/openai/gpt-6-1-terra/code):`openai/gpt-6.1-terra`- [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code):`openai/gpt-6-astra` +- [GPT 6.1 Terra](/zh/development/comfy-router/models/openai/gpt-6-1-terra/code):`openai/gpt-6.1-terra` +- [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code):`openai/gpt-6-astra` - [GPT 6 Luna](/zh/development/comfy-router/models/openai/gpt-6-luna/code):`openai/gpt-6-luna` - [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code):`openai/gpt-6-sol` - [o3](/zh/development/comfy-router/models/openai/o3/code):`openai/o3` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 83ce7d1d24..4f0face0dc 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -312,7 +312,7 @@ Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 true:模型输出带同步音频的视频。 -false:模型输出无声视频。`support 支持` 的模型上,已生成的音轨会由提供商与视频分开进行内容检查;若音频被拒,会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能间歇性出现。若遇到这种情况,可发送 `false` 以生成无声视频;只有当音频才是被拒的模态时这才有帮助,同步 Router 响应会将其标记为 `refusal_subject: output_audio`(队列请求尚无法标识这一点)。Seedance 2.5 的最终渲染会从它的 Draft 任务继承 `generate_audio`,因此应改用 `false` 重新创建 Draft。 +false:模型输出无声视频。在支持这一功能的模型上,已生成的音轨会由提供商与视频分开进行内容检查;若音频被拒,会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对于提供商原本可以接受的输入,这种拒绝可能间歇性出现。若遇到这种情况,可发送 `false` 以生成无声视频;只有当音频才是被拒的模态时这才有帮助,同步 Router 响应会将其标记为 `refusal_subject: output_audio`(队列请求尚无法标识这一点)。Seedance 2.5 的最终渲染会从它的 Draft 任务继承 `generate_audio`,因此应改用 `false` 重新创建 Draft。 @@ -326,7 +326,7 @@ edit:修改所连接的参考视频。输出保留来源片段自身的长度 extend:延续参考视频。输出仅为新生成的片段,时长为请求的 `duration`;其宽高比跟随该片段。 显式取值会在提交时由提供商校验(`InvalidParameter.TaskTypeConstraint` / `TaskTypeMismatch`),因此与请求不匹配的取值会在生成开始之前失败,且不计费;自动模式没有此类校验。该校验仅在原生 BytePlus 路径上执行:备用提供商路径(回退时,或通过 `model_provider` 选择)没有任务类型字段,会丢弃该值,并由该提供商自行推断任务,与自动模式相同。丢弃情况会在 `X-Comfy-Router-Dropped-Params` 中披露,包括同步运行路由的响应以及队列提交的 `201` 响应。队列路由没有回退,因此只能通过 `model_provider` 到达备用路径。 - 可能取值:`reference`、`edit`、`extend` + 可能的值:`reference`、`edit`、`extend` @@ -334,21 +334,21 @@ extend:延续参考视频。输出仅为新生成的片段,时长为请求 mp4:通用容器(H.264/AAC,yuv420p),兼容性广、文件大小更小。 mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可能取值:`mp4`、`mov` + 可能的值:`mp4`、`mov` 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 Seedance 2.5 首帧 / 首尾帧生成:输出遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可能取值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - 可能取值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` @@ -366,7 +366,7 @@ false:不返回已生成视频的最后一帧图像。 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可能取值:`default`、`flex` + 可能的值:`default`、`flex` diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index e45d2a78e3..1bce88c448 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -180,14 +180,14 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ -## Serving providers +## 服务提供商 除非请求中指定了其他提供商,否则该模型由 Comfy Router 直接提供服务。以下提供商也可以提供该模型,使用相同的端点、相同的模型 ID,通过 `model_provider` 查询参数进行选择。 - **Comfy**(默认):`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128` - **Kelly**,名为 `kelly/kelly-seedance-2.0-fast`:`POST https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128?model_provider=kelly` -`strict_mode` 默认为 false,因此 Router 会将本页记载的原生请求体转换为提供商自身的 schema,并将响应转换回来。请参阅 API 参考中的 [`model_provider`、`strict_mode` 与 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel),以及 [Serving providers](/zh/development/comfy-router/providers) 了解所有以这种方式路由的模型。 +`strict_mode` 默认为 false,因此 Router 会将本页记载的原生请求体转换为提供商自身的 schema,并将响应转换回来。请参阅 API 参考中的 [`model_provider`、`strict_mode` 与 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel),以及 [服务提供商](/zh/development/comfy-router/providers) 了解所有以这种方式路由的模型。 ## Schema @@ -249,13 +249,13 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 文本提示词(必填):使用中英文字符描述要生成的视频。 参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: -- --resolution (--rs): 480p, 720p, 1080p (default: 720p) -- --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (default: 16:9 or adaptive) -- --duration (--dur): 3-12 seconds (default: 5) -- --framepersecond (--fps): 24 (default: 24) -- --watermark (--wm): true/false (default: false) -- --seed (--seed): -1 to 2^32-1 (default: -1) -- --camerafixed (--cf): true/false (default: false) +- --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" @@ -299,9 +299,8 @@ Comfy 侧的防护措施,并非 BytePlus 的限制。BytePlus 未公布文本 受 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与视觉同步的音频。 true: 模型输出带有同步音频的视频。 false: 模型输出无声视频。 - - 在支持该功能的模型上,已生成的音频轨道由提供商单独于视频进行内容检查;若此处被拒绝,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商本会接受的输入,该拒绝可能是间歇性的。如果出现这种情况,请发送 `false` 以获取无声视频;这仅在音频是被拒绝的模态时才有帮助,同步 Router 响应会将其标为 `refusal_subject: output_audio`(排队中的请求尚不会指明它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 + 要调用的模型 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。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段中填充它,因此 Router 调用方会省略它。 @@ -416,7 +415,7 @@ false: 不返回已生成视频的最后一帧图像。 - The ID of the video generation task + 视频生成任务的 ID diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 134328f900..a83a630721 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -206,7 +206,7 @@ Base64:格式为 data:audio/\;base64,\ 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。在此请求上设置 resolution 以确定最终视频的输出档位,包括 4k;若省略,则最终视频为 1080p。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。在此请求上设置分辨率以确定最终视频的输出档位,包括 4k;若省略,则最终视频为 1080p。 @@ -277,8 +277,8 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; - 仅 Seedance 2.5。生成 480p 的 Draft 视频;resolution 必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;若省略 resolution,则最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;若省略分辨率,则最终视频为 1080p。Draft 任务 ID 的有效期为 7 天。 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 87b2e5081a..ca9368f50c 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -404,8 +404,7 @@ false:不返回已生成视频的最后一帧图像。 - -The ID of the video generation task + 视频生成任务的 ID diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx deleted file mode 100644 index 79ce67fcf9..0000000000 --- a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ /dev/null @@ -1,485 +0,0 @@ ---- -title: "通过 Comfy Router 使用 Seedance 1.5 Pro 251215" -description: "通过 Comfy Router 调用 byteplus/seedance-1-5-pro-251215:endpoint、请求形状以及 Router 返回的响应。" -sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 8c658f01 -translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx -translationBlockHashes: - "_intro": 5f93a1f1 - "Quick start": 71aafccf - "Schema": b9957cb9 - "Examples": 7e73ac5c ---- - - - - - -{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedance-1-5-pro-251215.json 生成。 */} - -import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; - -`byteplus/seedance-1-5-pro-251215` 的 API 参考文档,由 Comfy Router 从 BytePlus 提供。 - -**输入:** 文本, 图像 · **输出:** 视频 + 音频 - -## 快速开始 - -在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建一个密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm 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` - - - - -```python Python -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) -``` - -```typescript TypeScript -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); -``` - -```bash cURL -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`;结果就绪后,可以从本进程或其他进程收集。状态、取消与收集的细节见 [队列投递](/zh/development/comfy-router/queue)。 - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy - -# 从环境变量中读取 COMFY_API_KEY。 -# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用它。 -async def main(): - async with AsyncComfy() as client: - handle = await 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 等待。 - async for update in handle.iter_events(): - print(update.status, update.queue_position) - - # 提供商自己的负载,与 models.run() 返回的值相同。 - # 失败或已取消的请求会在此处抛出带类型的 Router 错误。 - result = await handle.get() - - print(result) - -asyncio.run(main()) -``` - -```typescript TypeScript -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() 返回的结果相同。失败或已取消的请求会在此处被拒绝。 -const result = await handle.get(); - -console.log(result.data); -``` - -```bash cURL -# 1. 提交。Router 返回 201,以及 request_id、status_url、response_url 和 cancel_url。 -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="" -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" -``` - - - - -## Schema - -### 输入 - - - 忽略。仅为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此不会发送任何回调;请改为轮询任务状态路由以获取结果。 - - 格式:`uri` - - - - 供模型生成视频的输入内容 - - - - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 - - - - 音频网址、Base64 编码或资产 ID。 -音频网址:音频的公开网址(wav、mp3)。 -Base64:格式 data:audio/\;base64,\ -资产 ID:格式 asset://\ - - - - 仅 Seedance 2.5 可用。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。在此请求中为最终视频的输出档位设置分辨率,包括 4k;省略时最终视频为 1080p。 - - - - 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 - - - - - - - - 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:确保图片网址可访问。 -Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式 asset://\ - - - - 内容项的角色/位置。 -对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - - 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - - - - 供模型使用的输入文本信息。包括文本提示词和可选参数。 - -文本提示词(必填):使用中英文字符描述要生成的视频。 - -参数(可选):在文本提示词后添加 --[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)。 -它按字符而非字节计数,因此多字节提示词在传输时可能达到此大小的数倍。 -它限制的是这一个字段,而不是整个请求: -`content` 是一个数组,而整个文档受每个请求的正文大小限制约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; -直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器作出响应。 -该限制设置得远高于真实流量,因此它永远不会裁决真实提示词;如果调用方需要更多,请提高该限制。 - - - - 输入内容的类型 - - 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` - - - - 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 - - - - 视频网址或资产 ID。 -视频网址:视频的公开网址(mp4、mov)。 -资产 ID:格式 asset://\ - - - - 仅 Seedance 2.5 可用。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终视频。该请求会设置最终视频的分辨率,包括 4k;省略分辨率时,最终视频为 1080p。Draft 任务 ID 有效期为 7 天。 - - - - 视频时长,单位为秒。Seedance 1.5 pro:[4,12] 或 -1(自动)。 - - 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12` - - - - 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 - - 范围:`3600` 到 `259200` - - - - 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音频轨道会由提供商与视频分开进行内容检查;此处的拒绝会以 `content_policy_violation` 报告,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种拒绝可能是间歇性的。如果出现这种情况,请为无声视频发送 `false`;这仅在音频正是被拒绝的模态时才有帮助,同步 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求尚无法识别它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - - - - 要调用的模型 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 拒绝任何其他值以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略它。 - - - - 仅 Seedance 2.5。输出视频的容器格式。 -mp4: 通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),色彩精度高,适合后期制作;文件大小更大。 - - Possible values: `mp4`, `mov` - - - - 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧 / 首末帧生成:输出遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - - Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - - - - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p、1080p 和 4k。 - - Possible values: `480p`, `720p`, `1080p`, `4k` - - - - 是否返回已生成视频的最后一帧图像。 -true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,你可以通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false: 不返回已生成视频的最后一帧图像。 - - - - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - - Range: `-1` to `4294967295` - - - - 处理服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - - Possible values: `default`, `flex` - - - - 已生成视频是否包含水印。 - - -该内容生成自 Router 在 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` 提供的 schema,与它在请求到达提供商之前用于校验调用的文档相同。 - -### 输出 - - - 视频生成任务完成后的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询一条已成功的文档时,`content` 可能缺失或为 null。 - - - - 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游 Content-Type 或内容嗅探来确定其类型,只有在两者都失败时,`image/jpeg` 才是最后的兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签为 24 小时,并从一份 23 小时的缓存记录中重放,因此后续轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它。无论哪种情况链接都会过期,因此请下载该帧,而不要保存 URL。 - - - - 已生成视频的容器格式(mp4 或 mov),在 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参见顶层 `output_format` 字段,Router 会读取两者中存在的那个。 - - - - RFC 3339 时间,表示上游 URL 停止可用的时间:即 URL 自身携带的最早签发时间加有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记录的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时出现,当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 - - 格式:`date-time` - - - - BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一同逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,且在 `upstream_expires_at` 之前一直是一个持有者凭证。 - - - - BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一同逐字节原样返回。仅当任务由 Comfy 在服务端选择加入的工作区轮询 Seedance 2.x 任务时才会出现(没有对应的请求参数);对其他所有情况都不出现,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名对象存储 URL,因此也是一种持有者凭证:任何持有它的人都能在过期前下载视频,请像对待密钥一样对待它。它在 `upstream_expires_at` 过期,而在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - - - - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签为 24 小时,并从一份 23 小时的缓存记录中重放,因此后续轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并且在某些模型上将其限制为 100 次下载。无论哪种情况链接都会过期,因此请下载视频,而不要保存 URL。 - - - - 任务创建的时间。该值为 UNIX 时间戳(秒)。 - - - - 已生成视频的时长,单位为秒。声明为数字而非整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他界面会报告带小数的时长,因此客户端不应假定其值为整数。这是 BytePlus 的自有字段,在已成功的视频任务上返回并原样转发。 - - - - 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 - - - - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一系列可能带有点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证与提供商故障。Router 会在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略类错误,同时不会覆盖传输层故障。 - - - - 报错信息 - - - - 视频生成任务的 ID - - - - 该任务所使用的模型名称和版本 - - - - 已生成视频的容器格式(mp4 或 mov),在**顶层**返回,作为 `content` 的同级字段。Seedance 视频任务查询就是在这里返回该字段的。这是 BytePlus 自身的字段,原样透传。 - - - - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自身的字段,在成功的视频任务中返回,并原样透传。 - - - - 该任务实际使用的生成种子。这是 BytePlus 自身的字段,在成功的视频任务中返回,并原样透传。 - - 格式:`int64` - - - - 任务状态 - - 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - - - - 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 - - - - 该请求的 token 用量 - - - - 模型生成的 token 数量 - - - - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 - - -## 示例 - -### 输入 - -```json -{ - "content": [ - { - "text": "A red fox trotting through a snowy pine forest", - "type": "text" - } - ], - "duration": 5, - "ratio": "16:9", - "resolution": "720p" -} -``` - -### 输出 - -```json -{ - "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 -} -``` - - diff --git a/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx index 00da72539f..562536212f 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx @@ -232,6 +232,8 @@ fast = 速度更快,但质量较为一般。 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持该参数。seedream-5.5 默认为 png。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。 + + 可能的值:`png`、`jpeg` diff --git a/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx index 683d55f04d..7d10badab2 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx @@ -229,7 +229,9 @@ false: 标准图像生成模式;不执行图层分离。 - 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持此参数。seedream-5.5 默认为 png。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。Possible values: `png`、`jpeg` + 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持此参数。seedream-5.5 默认为 png。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。 + + 可能的值:`png`、`jpeg` @@ -240,7 +242,7 @@ false: 标准图像生成模式;不执行图层分离。 指定响应中返回的已生成图像的格式。 - Possible values: `url`、`b64_json` + 可能的值:`url`、`b64_json` @@ -254,7 +256,7 @@ false: 标准图像生成模式;不执行图层分离。 auto:在自动模式下,模型会根据用户的提示词自动决定是否返回多张图像以及包含多少张图像。 disabled:禁用批处理生成功能。模型将只生成一张图像。 - Possible values: `auto`、`disabled` + 可能的值:`auto`、`disabled` diff --git a/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx index 7611badeee..572dff0f33 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx @@ -232,7 +232,7 @@ false: 标准图像生成模式;不执行图层分离。 指定输出图像的格式。仅 seedream-5.0-pro、5.0-flash、5.0-lite 和 5.5 支持该参数。seedream-5.5 默认使用 png。在图层分离场景中,output_format 仅控制基础图像的格式;每个图层始终以 png 输出。 - Possible values: `png`, `jpeg` + 可能的值:`png`、`jpeg` @@ -355,7 +355,7 @@ disabled: 禁用批处理生成功能。模型只会生成一张图像。 用于图像下载的 URL(当 response_format 为 "url" 时返回) - Format: `uri` + 格式:`uri` diff --git a/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx index 104585e46e..2315924d01 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx @@ -153,7 +153,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedream-5-0-flash-260915/requests ## Schema -### Input +### 输入 控制生成的图像是否具有透明背景(alpha 通道)。seedream-5.0-pro、5.0-flash 以及自身 schema 中记录了该参数的较新 Seedream 模型支持此参数。 diff --git a/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx index 44578cb368..98b77d067c 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx @@ -236,10 +236,11 @@ false:标准图像生成模式;不执行图层分离。 - 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。有效取值:auto: 在自动模式下,模型根据用户的提示词自动决定是否返回多张图像,以及返回的图像中包含几张图像。 + 控制是否禁用批处理生成功能。此参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。有效取值: +auto: 在自动模式下,模型根据用户的提示词自动决定是否返回多张图像,以及返回的图像中包含几张图像。 disabled: 禁用批处理生成功能。模型将只生成一张图像。 - 可选值:`auto`、`disabled` + 可能的取值:`auto`、`disabled` diff --git a/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx b/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx index 6104eecdf9..f120f2c758 100644 --- a/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedream-5-5-261028/code.mdx @@ -231,7 +231,8 @@ false: 标准图像生成模式;不执行图层分离。 - 控制是否禁用批处理生成功能。该参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。有效值:auto: 在自动模式下,模型会根据用户提示词自动决定是否返回多张图像以及其中包含多少张图像。 + 控制是否禁用批处理生成功能。该参数仅在 seedream-5.0-lite、4.5 和 4.0 上受支持(seedream-5.0-pro、5.0-flash 和 5.5 不支持)。有效值: +auto: 在自动模式下,模型会根据用户提示词自动决定是否返回多张图像以及其中包含多少张图像。 disabled: 禁用批处理生成功能。模型将只生成一张图像。 可选值:`auto`、`disabled` diff --git a/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx b/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx index 037773078f..432d9042bf 100644 --- a/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-3-1-flash-lite/code.mdx @@ -278,10 +278,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$RE + 当 seed 被固定为某个特定值时,模型会尽最大努力对重复请求给出相同的响应,但不保证输出具有确定性。此外,即使使用相同的 seed 值,更改模型或参数设置(例如 temperature)也可能导致响应发生变化。默认情况下会使用随机 seed 值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 -当 seed 被固定为某个特定值时,模型会尽最大努力对重复请求给出相同的响应,但不保证输出具有确定性。此外,即使使用相同的 seed 值,更改模型或参数设置(例如 temperature)也可能导致响应发生变化。默认情况下会使用随机 seed 值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 - @@ -559,13 +558,13 @@ Top-P 会改变模型选择输出 token 的方式。token 会按概率从最高 - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` 内容违反指定安全类别的概率 - 可选值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` + 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` @@ -591,7 +590,7 @@ Top-P 会改变模型选择输出 token 的方式。token 会按概率从最高 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -609,7 +608,7 @@ Top-P 会改变模型选择输出 token 的方式。token 会按概率从最高 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` @@ -631,7 +630,7 @@ Top-P 会改变模型选择输出 token 的方式。token 会按概率从最高 输入或输出内容的模态类型。 - 可选值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` + 可能的值:`MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT` diff --git a/zh/development/comfy-router/models/google/gemini-3-7-flash/code.mdx b/zh/development/comfy-router/models/google/gemini-3-7-flash/code.mdx index 4be1716575..13e895d9ac 100644 --- a/zh/development/comfy-router/models/google/gemini-3-7-flash/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-3-7-flash/code.mdx @@ -298,7 +298,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.7-flash/requests/$REQUEST - 可选。如果为是,模型将在响应中包含其思考内容。 + 可选。如果为 true,模型将在响应中包含其思考内容。 @@ -558,8 +558,6 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 内容违反的指定安全类别 - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/zh/development/comfy-router/models/google/gemini-4-argon/code.mdx b/zh/development/comfy-router/models/google/gemini-4-argon/code.mdx index 8fe3039957..cf491065f3 100644 --- a/zh/development/comfy-router/models/google/gemini-4-argon/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-4-argon/code.mdx @@ -200,7 +200,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_I `data` 或 `fileUri` 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` @@ -210,13 +210,13 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_I 要在提示中内联包含的图像、PDF 或视频的 base64 编码。内联包含媒体时,还必须指定数据的媒体类型(mimeType)。大小限制:20MB - Format: `byte` + 格式:`byte` `data` 或 `fileUri` 字段中指定的文件的媒体类型。可接受的值包括以下内容。对于 gemini-2.0-flash-lite 和 gemini-2.0-flash,音频文件的最大长度为 8.4 小时,视频文件(不含音频)的最大长度为一小时。有关更多信息,请参阅 Gemini 音频和视频要求。文本文件必须采用 UTF-8 编码。文本文件的内容计入 token 限制。图像分辨率无限制。 - Possible values: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm` + 可能的值:`application/pdf`、`audio/mpeg`、`audio/mp3`、`audio/wav`、`image/png`、`image/jpeg`、`image/webp`、`text/plain`、`video/mov`、`video/mpeg`、`video/mp4`、`video/mpg`、`video/avi`、`video/wmv`、`video/mpegps`、`video/flv`、`image/heic`、`image/heif`、`audio/flac`、`video/webm` @@ -256,7 +256,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_I - 可选。输出应保存为的图像格式,适用于 Vertex AI 路径:由 ComfyUI 自身凭据提供的请求,以及使用 GCP 服务账号认证的 BYOK 请求。这些路径接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求前规范化为小写;任何其他值都会以 400 拒绝并指明此字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥认证的 BYOK 请求是例外:该上游没有此属性,如果存在则会拒绝整个调用,因此该字段会从请求中删除,而不是被采纳或拒绝,输出格式由 AI Studio 选择。在所有路径上,请从返回的响应部分读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假设你发送的值。 + 可选。输出应保存为的图像格式,适用于 Vertex AI 路径:由 Comfy 自身凭据提供的请求,以及使用 GCP 服务账号认证的 BYOK 请求。这些路径接受的值是 `image/png` 和 `image/jpeg`,匹配时不区分大小写,并在转发请求前规范化为小写;任何其他值都会以 400 拒绝并指明此字段。省略时默认为 `image/png`。使用 Google AI Studio API 密钥认证的 BYOK 请求是例外:该上游没有此属性,如果存在则会拒绝整个调用,因此该字段会从请求中删除,而不是被采纳或拒绝,输出格式由 AI Studio 选择。在所有路径上,请从返回的响应部分读回媒体类型(`inlineData.mimeType`,或者当设置了 `uploadImagesToStorage` 时使用 `fileData.mimeType`),而不是假设你发送的值。 @@ -266,7 +266,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-argon/requests/$REQUEST_I 响应中可以生成的最大 token 数量。一个 token 大约相当于 4 个字符。100 个 token 大约对应 60-80 个单词。 - Range: `16` to `65536` + 范围:`16` 至 `65536` @@ -554,8 +554,10 @@ Top-P 会改变模型为输出选择 token 的方式。系统会从概率最高 + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - + + 内容违反指定安全类别的概率 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` diff --git a/zh/development/comfy-router/models/google/gemini-4-carbon/code.mdx b/zh/development/comfy-router/models/google/gemini-4-carbon/code.mdx index 6cf2b3daeb..2cb44d816c 100644 --- a/zh/development/comfy-router/models/google/gemini-4-carbon/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-4-carbon/code.mdx @@ -274,7 +274,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-carbon/requests/$REQUEST_ - When seed is fixed to a specific value, the model makes a best effort to provide the same response for repeated requests. 不保证输出具有确定性。此外,更改模型或参数设置(例如温度)即使在种子值相同的情况下也可能导致响应发生变化。默认使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + 当种子固定为某个特定值时,模型会尽力为重复请求提供相同的响应。不保证输出具有确定性。此外,更改模型或参数设置(例如温度)即使在种子值相同的情况下也可能导致响应发生变化。默认使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 @@ -553,9 +553,7 @@ Top-P 会改变模型为输出选择 token 的方式。从概率最高(参见 - - 内容违反的安全类别 - + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/zh/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx b/zh/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx index 27aec713a7..7341e4b187 100644 --- a/zh/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx +++ b/zh/development/comfy-router/models/google/gemini-4-hydrogen/code.mdx @@ -274,8 +274,7 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-4-hydrogen/requests/$REQUES - -当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 + 当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 @@ -389,13 +388,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 以纳秒精度表示的带符号秒的小数部分。秒值为负数且带小数部分时,其 nanos 值仍必须为非负数。 - Range: `0` 到 `999999999` + 范围:`0` 到 `999999999` 带符号的秒数,表示时间跨度。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 - Range: `-315576000000` 到 `315576000000` + 范围:`-315576000000` 到 `315576000000` @@ -405,13 +404,13 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 以纳秒精度表示的带符号秒的小数部分。秒值为负数且带小数部分时,其 nanos 值仍必须为非负数。 - Range: `0` 到 `999999999` + 范围:`0` 到 `999999999` 带符号的秒数,表示时间跨度。必须介于 -315,576,000,000 到 +315,576,000,000 之间(含边界值)。 - Range: `-315576000000` 到 `315576000000` + 范围:`-315576000000` 到 `315576000000` 该内容由 Router 在 `GET /v2/models/vertexai/gemini-4-hydrogen/openapi.json` 处提供的 schema 生成,它也是请求到达提供商之前 Router 用来校验调用的同一份文档。 @@ -555,8 +554,6 @@ Top-P 会改变模型为输出选择 token 的方式。token 会按概率从最 - 内容所违反的安全类别 - 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/zh/development/comfy-router/models/google/nano-banana-2-lite/code.mdx b/zh/development/comfy-router/models/google/nano-banana-2-lite/code.mdx index b6d3a911fd..5bdc6242d4 100644 --- a/zh/development/comfy-router/models/google/nano-banana-2-lite/code.mdx +++ b/zh/development/comfy-router/models/google/nano-banana-2-lite/code.mdx @@ -310,11 +310,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite-image/reques - + 当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出完全确定。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,使用随机种子值。适用于以下模型:gemini-2.5-flash、gemini-2.5-pro、gemini-2.5-flash-preview-04-1、gemini-2.5-pro-preview-05-0、gemini-2.0-flash-lite-00、gemini-2.0-flash-001 -当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出完全确定。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,使用随机种子值。适用于以下模型:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 - @@ -592,7 +590,7 @@ Top-P 会改变模型选择输出 token 的方式。token 会按概率从高( - Possible values: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT` + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/zh/development/comfy-router/models/google/nano-banana-2/code.mdx b/zh/development/comfy-router/models/google/nano-banana-2/code.mdx index c86059e4a3..bdb67e212d 100644 --- a/zh/development/comfy-router/models/google/nano-banana-2/code.mdx +++ b/zh/development/comfy-router/models/google/nano-banana-2/code.mdx @@ -440,13 +440,13 @@ Top-P 改变模型选择输出 token 的方式。token 按概率从高(参见 以纳秒精度表示的有符号秒的小数部分。带小数的负秒值其 nanos 值仍必须为非负数。 - Range: `0` 至 `999999999` + 范围:`0` 至 `999999999` 时间跨度的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 - Range: `-315576000000` 至 `315576000000` + 范围:`-315576000000` 至 `315576000000` @@ -456,13 +456,13 @@ Top-P 改变模型选择输出 token 的方式。token 按概率从高(参见 以纳秒精度表示的有符号秒的小数部分。带小数的负秒值其 nanos 值仍必须为非负数。 - Range: `0` 至 `999999999` + 范围:`0` 至 `999999999` 时间跨度的有符号秒数。必须在 -315,576,000,000 到 +315,576,000,000 之间(含边界)。 - Range: `-315576000000` 至 `315576000000` + 范围:`-315576000000` 至 `315576000000` 生成自 Router 在 `GET /v2/models/vertexai/gemini-3.1-flash-image/openapi.json` 提供的 schema,与它在请求到达提供商之前校验调用时所使用的是同一份文档。 @@ -605,9 +605,7 @@ Top-P 改变模型选择输出 token 的方式。token 按概率从高(参见 - - 内容所属的安全类别 - + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` diff --git a/zh/development/comfy-router/models/google/nano-banana-pro/code.mdx b/zh/development/comfy-router/models/google/nano-banana-pro/code.mdx index 07dc50daab..e31da46fd1 100644 --- a/zh/development/comfy-router/models/google/nano-banana-pro/code.mdx +++ b/zh/development/comfy-router/models/google/nano-banana-pro/code.mdx @@ -326,11 +326,9 @@ curl https://api.comfy.org/v2/models/vertexai/gemini-3-pro-image/requests/$REQUE - + 当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,会使用随机种子值。适用于以下模型:gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 -当种子固定为特定值时,模型会尽最大努力为重复请求提供相同的响应。不保证输出具有确定性。此外,即使使用相同的种子值,更改模型或参数设置(例如温度)也可能导致响应发生变化。默认情况下,会使用随机种子值。适用于以下模型:gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001 - @@ -608,8 +606,10 @@ Top-P 会改变模型为输出选择 token 的方式。token 会从概率最高 + 可能的值:`HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT` - + + 内容违反指定安全类别的概率 可能的值:`NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN` diff --git a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx index d7bd91cba9..2c0b6d0ce7 100644 --- a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx @@ -310,7 +310,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成的视频时长更长,但输出质量更高。 - 可能的值:`std`、`pro` + 可选值:`std`、`pro` 根据 Router 在 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` 提供的 schema 生成,它与 Router 在请求到达提供商之前校验调用所用的文档相同。 diff --git a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx index 79e9e5106e..cdae8dc5ef 100644 --- a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx +++ b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx @@ -331,19 +331,19 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \ 已生成的视频的 URL - Format: `uri` + 格式:`uri` 带水印的已生成视频的 URL,防盗链格式 - Format: `uri` + 格式:`uri` 任务状态 - Possible values: `submitted`, `processing`, `succeed`, `failed` + 可选值:`submitted`、`processing`、`succeed`、`failed` diff --git a/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx b/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx index 406b5ef86c..ea3f524197 100644 --- a/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx +++ b/zh/development/comfy-router/models/ltx/ltx-video-to-video-reframe/code.mdx @@ -156,37 +156,37 @@ curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$RE 视频所贴靠的输出画面边缘或角落。 - Possible values: `center`, `top`, `bottom`, `left`, `right`, `top_left`, `top_right`, `bottom_left`, `bottom_right` + 可选值:`center`、`top`、`bottom`、`left`、`right`、`top_left`、`top_right`、`bottom_left`、`bottom_right` 放置视频的高度,以输出高度的比例表示。 - Format: `double` + 格式:`double` 放置视频的宽度,以输出宽度的比例表示。 - Format: `double` + 格式:`double` 放置视频的左边缘,以输出宽度的比例表示。 - Format: `double` + 格式:`double` 放置视频的上边缘,以输出高度的比例表示。 - Format: `double` + 格式:`double` 目标输出分辨率。来源视频会被扩展以填满该画面。 - Possible values: `720x720`, `1080x1080`, `720x900`, `1080x1350`, `900x720`, `1350x1080`, `720x1280`, `1080x1920`, `1280x720`, `1920x1080` + 可选值:`720x720`、`1080x1080`、`720x900`、`1080x1350`、`900x720`、`1350x1080`、`720x1280`、`1080x1920`、`1280x720`、`1920x1080` @@ -230,7 +230,7 @@ curl https://api.comfy.org/v2/models/ltx/ltx-video-to-video-reframe/requests/$RE - 任务状态(待定、处理中、已完成、失败) + 任务状态(`pending`、`processing`、`completed`、`failed`) ## 示例 diff --git a/zh/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx b/zh/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx index f2f5795337..a6a76fc272 100644 --- a/zh/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx +++ b/zh/development/comfy-router/models/ltx/ltx-video-upscale/code.mdx @@ -172,7 +172,7 @@ curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID - 当 status 为失败时存在 + 当 status 为 failed 时存在 @@ -188,7 +188,7 @@ curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID - 当 status 为已完成时存在;输出 URL 在完成 24 小时后过期 + 当 status 为 completed 时存在;输出 URL 在完成 24 小时后过期 @@ -196,7 +196,7 @@ curl https://api.comfy.org/v2/models/ltx/ltx-video-upscale/requests/$REQUEST_ID - 任务状态(待定、处理中、已完成、失败) + 任务状态(pending、processing、completed、failed) ## 示例 diff --git a/zh/development/comfy-router/models/minimax/minimax-h3-image/code.mdx b/zh/development/comfy-router/models/minimax/minimax-h3-image/code.mdx index 870a098303..5443b24b93 100644 --- a/zh/development/comfy-router/models/minimax/minimax-h3-image/code.mdx +++ b/zh/development/comfy-router/models/minimax/minimax-h3-image/code.mdx @@ -150,11 +150,11 @@ curl https://api.comfy.org/v2/models/minimax/minimax-h3-image/requests/$REQUEST_ ### 输入 - 当省略 `size` 或 `size` 为 `auto` 时的输出面积级别。取值为 `1K`、`2K`、`4K`(默认)。 + 当省略 `size` 或为 `auto` 时,输出面积级别。取值为 `1K`、`2K`、`4K`(默认)。 - 当省略 `size` 或 `size` 为 `auto` 时的输出宽高比。`auto`(默认),或 1:3 到 3:1 之间的 `X:Y`,例如 `16:9`。 + 当省略 `size` 或为 `auto` 时,输出宽高比。`auto`(默认),或 1:3 到 3:1 之间的 `X:Y`,例如 `16:9`。 diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx index 26423da63a..aae2c720b2 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx @@ -162,6 +162,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare/requests/$REQUES - **Comfy**(默认):`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare` - **fal**,名称为 `fal/fal-gpt-image-2.5-flare`:`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=fal` +- **MiniMax**,名称为 `minimax/minimax-gpt-image-2.5-flare`:`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=minimax` - **Runware**,名称为 `runware/runware-gpt-image-2.5-flare`:`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=runware` - **WaveSpeed**,名称为 `wavespeed/wavespeed-gpt-image-2.5-flare`:`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-flare?model_provider=wavespeed` diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx index 3fdb1cc07f..41e7c9ba2a 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx @@ -162,6 +162,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ - **Comfy**(默认):`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst` - **fal**,名称为 `fal/fal-gpt-image-2.5-sunburst`:`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=fal` +- **MiniMax**,名称为 `minimax/minimax-gpt-image-2.5-sunburst`:`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=minimax` - **Runware**,名称为 `runware/runware-gpt-image-2.5-sunburst`:`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=runware` - **WaveSpeed**,名称为 `wavespeed/wavespeed-gpt-image-2.5-sunburst`:`POST https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst?model_provider=wavespeed` @@ -174,7 +175,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ 背景透明度。`auto` 表示由模型自行选择。 - 可选值:`transparent`、`opaque`、`auto` + 可能的值:`transparent`、`opaque`、`auto` @@ -194,9 +195,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.5-sunburst/requests/$REQ 第二项是按账号启用,而不是一次性对所有人启用,因为这些主机背后的存储桶属于你而非我们:即使上面的切换已开启,未启用第三方入站媒体的账号也会被拒绝,并且会用这些措辞告知,而不是告知主机不受支持。请联系你的 Comfy 联系人,为你的账号启用它。它还会额外允许以下第三方对象存储主机,这些主机的存储桶属于你,Router 不对其主张任何所属权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 和 `s3..amazonaws.com`,采用路径风格或带 `.` 前缀的形式)、Azure Blob Storage(`.blob.core.windows.net`)以及阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域名下的通用端点,例如阿里云函数计算触发器,不在列表中,会被拒绝。 匹配的是主机名形式,而不是提供商,因此上面列出某个提供商并不意味着该提供商能签发的每个 URL 都会被接受,有三个近似但不符合的情况值得直接说明,因为调用方有可能合理地带着其中任何一个前来。R2 的自定义域名(`cdn.example.com`)不被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并把生产流量指向自定义域名,但自定义域名的主机名中不含任何可标识其为 R2 的信息,因此 Router 无法将其与任何其他主机区分开,会拒绝它:请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 dualstack 端点(`s3.dualstack..amazonaws.com`)同样不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)也不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些同样的形式,因此你不必回到这里查看它们。 上面的 `` 和 `pub-` 占位符展示的是你通常传入的形式;它们并不是深度限制。匹配依据是对象存储的域后缀,因此同一命名空间下更深层的名称(`a.b.pub-.r2.dev`)也会被接受。这并不会放宽命名空间本身:后缀仍必须是所列出的之一。 - 下面的示例仅展示形状:真实值还会携带签名查询参数,这里有意省略它们,因为已发布的示例会永远留在规范中,而真实签名既是被泄露的凭据,也是一个会失效的链接。 - 每张图像上限为 25 MiB,单个请求的图像总计上限为 64 MiB。唯一例外是 ideogram/ideogram-4-5 Precise Edit(发送 `image` 的调用),其中 `context_window` 可用:此时每张图像最高可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总计最高可达 128 MiB。 diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx index 1157976d5c..ea845bfcde 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx @@ -155,8 +155,8 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare/requests/$REQUES 除非请求中指定了其他提供商,否则此模型由 Comfy Router 直接提供服务。以下提供商也在同一端点上、使用相同的模型 ID 提供该模型,并通过 `model_provider` 查询参数进行选择。 -- **Comfy**(默认): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare` -- **MiniMax**,以 `minimax/minimax-gpt-image-2-6-flare` 的形式: `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-flare?model_provider=minimax` +- **Comfy**(默认): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare` +- **MiniMax**,以 `minimax/minimax-gpt-image-2.6-flare` 的形式: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-flare?model_provider=minimax` `strict_mode` 默认为 false,因此 Router 会将本页记录的原生请求体转换为提供商自己的 schema,并把响应转换回来。请参阅 API 参考中的 [`model_provider`、`strict_mode` 和 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel),以及[服务提供商](/zh/development/comfy-router/providers),了解所有以这种方式路由的模型。 diff --git a/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx index 4e336a28fb..9e5e273b85 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx @@ -155,8 +155,8 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst/requests/$REQ 除非请求中指定了其他提供商,否则此模型由 Comfy Router 直接提供服务。以下提供商也在同一端点上、使用相同的模型 ID 提供该模型,并通过 `model_provider` 查询参数进行选择。 -- **Comfy**(默认): `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst` -- **MiniMax**,以 `minimax/minimax-gpt-image-2-6-sunburst` 的形式: `POST https://api.comfy.org/v2/models/openai/gpt-image-2-6-sunburst?model_provider=minimax` +- **Comfy**(默认): `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst` +- **MiniMax**,以 `minimax/minimax-gpt-image-2.6-sunburst` 的形式: `POST https://api.comfy.org/v2/models/openai/gpt-image-2.6-sunburst?model_provider=minimax` `strict_mode` 默认为 false,因此 Router 会将本页记录的原生请求体转换为提供商自己的 schema,并把响应转换回来。请参阅 API 参考中的 [`model_provider`、`strict_mode` 和 `fallback_provider`](/zh/development/comfy-router/reference#post-v2modelsprovidermodel),以及[服务提供商](/zh/development/comfy-router/providers),了解所有以这种方式路由的模型。 @@ -197,12 +197,11 @@ URL 必须在不携带你的凭证的情况下解析成功。Router 在服务器 两项放宽正在逐步推出,且目前都默认关闭。它们通过一个切换开关发布并一起启用,因此请把下面所有内容视为尚未到来,而不是现在就能依赖的东西:在依赖其中任何一项之前请先询问。 第一项是 `POST /customers/storage` 为你的上传签名的桶。在推出到达你的环境之前,来自该端点的上传 URL 会在这里被拒绝,即使该桶属于 Comfy 且主机也是同一个:因此“先上传到 Comfy,再传入 URL”目前并不成立,可行的形式是 `/api/assets/{id}/content` 重定向到的已签名 URL。 第二项是按账号启用,而不是对所有人一次性启用,因为这些主机背后的桶属于你而不是我们:即使上面的开关已打开,未启用第三方入站媒体的账号仍会被拒绝,并会明确告知这一点,而不是被告知主机不受支持。请联系你的 Comfy 联系人,为你的账号启用它。它还会额外允许以下第三方对象存储主机,这些主机上的桶属于你,Router 不对其主张任何所属权:Cloudflare R2(`.r2.cloudflarestorage.com`、`pub-.r2.dev`)、Amazon S3(`s3.amazonaws.com` 以及 `s3..amazonaws.com`,采用路径式或 `.` 前缀式均可)、Azure Blob Storage(`.blob.core.windows.net`)和阿里云 OSS(`.oss-.aliyuncs.com`,包括 `oss-accelerate` 端点)。这些具体是对象存储端点:同一提供商域上的通用端点,例如阿里云函数计算的触发器,不在该列表上,会被拒绝。 - - 匹配的是主机名形式,而不是提供商,因此在上文指定提供商并不代表该提供商能签发的每个 URL 都会被接受;有三种近似但不被接受的形式值得直接说明,因为调用方完全可能带着其中任何一种形式到来。R2 自定义域名(`cdn.example.com`)不会被接受:Cloudflare 将 `pub-.r2.dev` 记录为受速率限制的调试主机名,并将生产流量改为指向自定义域名,但自定义域名的主机名中没有任何内容能表明它属于 R2,因此 Router 无法将其与任何其他主机区分开来,并会拒绝它。请对 `.r2.cloudflarestorage.com` 端点进行预签名,或使用 `pub-.r2.dev` 形式。S3 的 IPv6 双栈端点(`s3.dualstack..amazonaws.com`)同样不被接受;请使用普通的区域端点。Azure Blob 的备用 DNS 区域(`.z.blob.storage.azure.net`)也不被接受;请使用 `.blob.core.windows.net`。你收到的拒绝信息会列出这些相同的形式,因此你不必特意来这里阅读它们。 上面的 `` 和 `pub-` 占位符展示了你通常会带来的形式;它们不是深度限制。匹配依据是对象存储域名后缀,因此同一命名空间下更深的名称(`a.b.pub-.r2.dev`)也会被接受。但这并不会放宽命名空间本身:后缀仍然必须是所列后缀之一。 下面的示例仅展示形式:真实值还会带有签名查询参数,这里有意省略了它们,因为已发布的示例会永远留在规范中,而真实签名既是被泄露的凭据,也是会失效的链接。 每张图像上限为 25 MiB,单个请求的图像总量上限为 64 MiB。唯一的例外是 ideogram/ideogram-4-5 Precise Edit(即发送 `image` 且 `context_window` 可用的调用):在该调用中,每张图像最大可达 50 MB(50,000,000 字节)和 67,108,864 像素,单个请求的图像总量最大可达 128 MiB。 + 要运行的 gpt-image 模型。Router 会把所寻址的模型 ID 拼接进去,因此寻址 /v2/models/openai/gpt-image-2.6-flare 的调用方无需发送此字段。 diff --git a/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx b/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx index 55cb30bcf4..88f7d48544 100644 --- a/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx +++ b/zh/development/comfy-router/models/openai/gpt-image-2/code.mdx @@ -184,7 +184,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2/requests/$REQUEST_ID \ 要编辑的来源图像。此字段一旦出现即选定编辑操作:若要执行文生图,请将其完全省略。 模型公布的示例是生成调用,它省略了此字段。添加 `image` 就是两种模式之间的全部差异:相同的端点、相同的模型 id,只不过编辑提示词描述的是你想要的改动,而不是场景,所以下面的编辑请求体读起来与生成示例不同,尽管结构上新出现的只有这一个字段。 -它可以按原样直接复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。其中的 payload 是一个完整的 1x1 PNG,而不是缩写占位,并且这个请求体在 Router 自身的请求验证测试中被顶固为一个被接受的用例。请替换成你自己图像的字节。 +它可以按原样直接复制:`{"prompt": "give the rocketship rainbow coloring", "image": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="], "size": "1024x1024"}`。其中的 payload 是一个完整的 1x1 PNG,而不是缩写占位,并且这个请求体在 Router 自身的请求验证测试中被固定为可接受的用例。请替换成你自己图像的字节。 接受一张图像,或一个图像数组;gpt-image-1 及更高版本最多接受 16 张,Router 会在派发之前依据此 schema 强制执行该限制。 @@ -325,7 +325,7 @@ curl https://api.comfy.org/v2/models/openai/gpt-image-2/requests/$REQUEST_ID \ Unix 时间戳,单位为秒,表示生成完成的时间。它是 OpenAI 在图像生成响应中声明的唯一 REQUIRED 成员,因此只要由 OpenAI 作为生产者,它就一定存在;而在任何 alt 后端的 id 上由 fal、minimax、pika、wavespeed 或 runware 提供的响应会完全省略它,就像其他四个已解析参数成员一样。声明为 `int64`,是因为当前的 epoch 值已接近 2^31,在许多 SDK 生成器中,未格式化的 `integer` 会生成 32 位字段。 - Format: `int64` + 格式:`int64` diff --git a/zh/development/comfy-router/models/pixverse/v6/code.mdx b/zh/development/comfy-router/models/pixverse/v6/code.mdx index 8b36267703..7799e0737e 100644 --- a/zh/development/comfy-router/models/pixverse/v6/code.mdx +++ b/zh/development/comfy-router/models/pixverse/v6/code.mdx @@ -18,8 +18,6 @@ import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; **输入:** 文本 · **输出:** 视频 - - ## 快速开始 在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并把它导出为 `COMFY_API_KEY`。Python 和 TypeScript 片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 片段则是通过原始 HTTP 发出的同一调用。 diff --git a/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx b/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx index 200510cc86..1cd1c3c927 100644 --- a/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx +++ b/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code.mdx @@ -337,7 +337,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ 已生成视频的目标时长,单位为秒。Veo 2:5-8。Veo 3/3.1:4、6 或 8。默认值:8 - + 自动优化提示词以获得更高质量。默认为 true。 @@ -357,7 +357,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ 控制已生成视频中的人物。默认:allow_adult。 出于相同的兼容性原因,也接受 `ALLOW` 和 `BLOCK`:Veo2GenVidRequest 的 personGeneration 枚举同样包含它们(参见该组件处的说明)。ComfyUI 的 Veo 3 合作伙伴节点(comfy_api_nodes/nodes_veo2.py)始终向 `/proxy/veo/{model}/generate` 发送这两种写法之一,而从不发送 Vertex 自己的写法,涉及 veo-3.1-generate-001、veo-3.1-fast-generate-001 和 veo-3.1-lite-generate-001,也就是本组件作为 Router 输入 schema 所对应的三个模型 ID。对于这些模型 ID 之一,在 Router 调度(`model_provider=veo`)时,无论是同步调用还是排队调用(`/v2/models/veo/{model}/requests`),`ALLOW` 都会在请求到达 Vertex 之前映射为 `allow_adult`,`BLOCK` 映射为 `dont_allow`(routerVeoMapPersonGeneration,server/middleware/router_veo_person_generation.go),因为 Vertex 本身两种写法都不接受。直接调用 v1 `/proxy/veo/:modelId/generate` 的调用方则两种情况下都不受影响:comfy-api 未在 `/proxy/*` 上安装任何请求校验器,因此该枚举在那里本来就是未强制执行的文档说明,而仅适用于 Router 的映射不会对它运行。 - 可选值:`dont_allow`、`allow_adult`、`allowAll`、`ALLOW`、`BLOCK` + 可能的值:`dont_allow`、`allow_adult`、`allowAll`、`ALLOW`、`BLOCK` @@ -367,13 +367,13 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ 输入图像的调整大小方式。默认:pad - 可选值:`pad`、`crop` + 可能的值:`pad`、`crop` 输出视频分辨率。由 Veo 3.0+ 模型支持。默认:720p - 可选值:`720p`、`1080p`、`4k` + 可能的值:`720p`、`1080p`、`4k` @@ -396,7 +396,7 @@ curl https://api.comfy.org/v2/models/veo/veo-3.1-fast-generate-001/requests/$REQ 视频生成请求的操作类型 - 可选值:`textToVideo`、`imageToVideo`、`referenceToVideo`、`edit`、`extend`、`upscale` + 可能的值:`textToVideo`、`imageToVideo`、`referenceToVideo`、`edit`、`extend`、`upscale` 本文档根据 Router 在 `GET /v2/models/veo/veo-3.1-fast-generate-001/openapi.json` 提供的 schema 生成,该文档也正是请求到达提供商之前 Router 用于校验调用的同一份文档。 diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx index 0070ff01a0..9ac97ee2cf 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code.mdx @@ -309,7 +309,7 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-i2v/requests/$REQUEST_ID 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则会根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的宽高比根据输入媒体的比例和意图确定。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可能的值:`adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx index fe2e7a4026..dbcd06135f 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-r2v/code.mdx @@ -230,9 +230,9 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v/requests/$REQUEST_ID - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记录任何媒体输入,因此请不要设置此字段。 - wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:该组件未为这些写法枚举媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧;wan2.6-r2v 在 reference_video_urls 中接收参考片段。 上文中按模型给出的数量是合作伙伴的限制,而不是此 schema 的限制:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不代表提供商会接受;反过来,上文中按资产给出的“最大 20MB”数值(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终获得的资产所设的上限;当资产是公共网址时,这些数值按原样适用,因为这些字节从不经过 Comfy。内联 `data:\{MIME_type};base64,...` URL 确实会经过 Comfy,并且也会遇到传输上限:Comfy Router POST 请求体总计限制为 100 MiB,超过后返回 413;base64 会使负载膨胀约 4/3,因此单个内联资产超过约 75 MB 时,会在触及这里的任何合作伙伴规则之前被拒绝。在这一大小下,单个资产按合作伙伴自身的 +20MB 的上限可以轻松容纳内联内容,因此对单个资产而言,真正起约束作用的是合作伙伴规则;而对多个资产来说,起约束作用的是传输上限,因为 100 MiB 的 Router 上限限制的是整个请求,并非每个元素。任何接近这些上限的内容,请以公开 URL 形式发送。 -20MB 的上限可以轻松容纳内联内容,因此对单个资产而言,真正起约束作用的是合作伙伴规则;而对多个资产来说,起约束作用的是传输上限,因为 100 MiB 的 Router 上限限制的是整个请求,并非每个元素。任何接近这些上限的内容,请以公开 URL 形式发送。 媒体资产类型 @@ -308,7 +308,7 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-r2v/requests/$REQUEST_ID 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则根据分辨率档位给出默认值。 -对于 wan3.0-video,adaptive(默认)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx index 75d8888825..24c2d3888f 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-t2v/code.mdx @@ -284,7 +284,7 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.0-t2v/requests/$REQUEST_ID 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,如果未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的基于输入媒体的比例与意图确定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例与意图自动推荐合适的宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx index 356e7d54e3..ef878c2ff9 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-0-video-edit/code.mdx @@ -359,7 +359,7 @@ POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,未提供时根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx index ab744664bd..a2ced550a2 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-1-i2v/code.mdx @@ -229,10 +229,9 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v/requests/$REQUEST_ID - happyhorse-1.0-video-edit:video(必须为 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公开的 HTTP/HTTPS 网址;不接受内联 data: 网址),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,可以是公开网址或 data:\{MIME_type};base64,... 网址)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。它们的合作伙伴参考文档未记载任何 media 输入,因此请勿设置该字段。 - wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:本组件没有为这些写法枚举任何 media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 -上述各模型的数量是合作伙伴的约束,而不是本 Schema 的约束:media 上没有声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受;反过来说,上文每个资产“最大 20MB”的数值(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终拿到的资产所设的上限,当资产是公开网址时,这些限制按原文生效,因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... 网址确实会经过 Comfy,并且还要受到传输层上限的约束:Comfy Router 的 POST 请求体总量上限为 100 MiB,超过即返回 413,而 base64 会使负载膨胀约 4/3,因此单个内联资产若超过约 75 MB,会在触达此处任何合作伙伴规则之前就被拒绝。在这种大小下,单个资产按合作伙伴自己的 +上述各模型的数量是合作伙伴的约束,而不是本 Schema 的约束:media 上没有声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受;反过来说,上文每个资产“最大 20MB”的数值(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终拿到的资产所设的上限,当资产是公开网址时,这些限制按原文生效,因为这些字节从不经过 Comfy。内联的 data:\{MIME_type};base64,... 网址确实会经过 Comfy,并且还要受到传输层上限的约束:Comfy Router 的 POST 请求体总量上限为 100 MiB,超过即返回 413,而 base64 会使负载膨胀约 4/3,因此单个内联资产若超过约 75 MB,会在触达此处任何合作伙伴规则之前就被拒绝。在这种大小下,单个资产按合作伙伴自己的 20MB 上限对于内联载荷而言绰绰有余,因此对于单个资产,真正起作用的是合作伙伴的规则;而当资产有多个时,起作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。接近这些上限的任何内容,都请以公共 URL 发送。 -20MB 上限对于内联载荷而言绰绰有余,因此对于单个资产,真正起作用的是合作伙伴的规则;而当资产有多个时,起作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是其中的每个元素。接近这些上限的任何内容,都请以公共 URL 发送。 媒体资产类型 @@ -309,7 +308,7 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-i2v/requests/$REQUEST_ID 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的宽高比,根据输入媒体的比例和意图确定。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx index 9203fb343f..f3f9c6ea3e 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-1-r2v/code.mdx @@ -228,10 +228,9 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-r2v/requests/$REQUEST_ID - happyhorse-1.0-video-edit: video(恰好 1 个,即正在编辑的片段:MP4/MOV,3-60 秒,较长边最大 4096 像素,较短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v, happyhorse-1.1-t2v, wan2.7-t2v, wan2.6-t2v, wan2.5-t2v-preview: 文生视频操作。它们的合作伙伴参考文档未记录媒体输入,因此请勿设置此字段。 - wan2.5-i2v-preview, wan2.6-i2v, wan2.6-r2v: 此组件没有为这些写法枚举任何媒体词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收首帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上述按模型的数量限制是合作伙伴的约束,而不是此 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。通过 Schema 校验并不代表提供商会接受;反过来说,上文每个资产“最多 20MB”的数字(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终接收到的资产的上限,并且当资产是公共 URL 时这些数字按字面适用,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,并且也会遇到传输上限:Comfy Router POST 请求体的总上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个超过约 75 MB 的内联资产会在触达此处的任何合作伙伴规则之前被拒绝。达到该大小时,单个资产按合作伙伴自身的 +上述按模型的数量限制是合作伙伴的约束,而不是此 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。通过 Schema 校验并不代表提供商会接受;反过来说,上文每个资产“最多 20MB”的数字(即图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终接收到的资产的上限,并且当资产是公共 URL 时这些数字按字面适用,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,并且也会遇到传输上限:Comfy Router POST 请求体的总上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个超过约 75 MB 的内联资产会在触达此处的任何合作伙伴规则之前被拒绝。达到该大小时,单个资产按合作伙伴自身的 20MB 上限足以轻松容纳内联内容,因此对单个资产而言,真正起约束作用的是合作伙伴规则;涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。凡是接近这些上限的内容,请以公共 URL 形式发送。 -20MB 上限足以轻松容纳内联内容,因此对单个资产而言,真正起约束作用的是合作伙伴规则;涉及多个资产时,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。凡是接近这些上限的内容,请以公共 URL 形式发送。 媒体资产类型 @@ -306,7 +305,7 @@ curl https://api.comfy.org/v2/models/wan/happyhorse-1.1-r2v/requests/$REQUEST_ID 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,如果未提供,则根据分辨率档位确定默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定比例。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx b/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx index 07c1e4c36c..59fd9ad1fb 100644 --- a/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx +++ b/zh/development/comfy-router/models/wan/happyhorse-1-1-t2v/code.mdx @@ -263,7 +263,7 @@ reference_video_urls 中,都因模型而异。各模型支持的 type 值: data:\{MIME_type};base64,... 网址确实会经过 Comfy,因此也会遇到传输上限: Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 负载膨胀约 4/3,因此单个内联资产大约超过 75 MB 就会在触及此处任何 -合作伙伴规则之前被拒绝。在这个大小下,单个资产按合作伙伴自身的20MB 的上限对内联数据来说足够宽裕,因此对单个资产而言,起约束作用的是合作伙伴的规则;而传输上限会在涉及多个资产时产生约束,因为 100 MiB 的 Router 上限限制的是整个请求,而不是每个元素。接近这些上限的内容请以公共 URL 的形式发送。 +合作伙伴规则之前被拒绝。在这个大小下,单个资产按合作伙伴自身 20MB 的上限对内联数据来说足够宽裕,因此对单个资产而言,起约束作用的是合作伙伴的规则;而传输上限会在涉及多个资产时产生约束,因为 100 MiB 的 Router 上限限制的是整个请求,而不是每个元素。接近这些上限的内容请以公共 URL 的形式发送。 @@ -342,7 +342,7 @@ Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413, 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,如果未提供,则根据分辨率档位设置默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` diff --git a/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx b/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx index 18954c07ac..a78ce9d18c 100644 --- a/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-5-i2i-preview/code.mdx @@ -181,7 +181,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-i2i-preview/requests/$REQUEST_ID - 由 1 到 3 个图像 URL 组成的数组,用于图生图生成 + 由 1 到 3 个图像网址组成的数组,用于图生图生成 diff --git a/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx b/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx index 841b6e93a4..5487dd5d12 100644 --- a/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-5-i2v-preview/code.mdx @@ -260,7 +260,7 @@ minItems/maxItems,因为可接受的类型及其上限因模型而异。schema URL 确实会经过 Comfy,因此还会遇到传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 负载膨胀约 4/3,因此单个内联资产超过约 75 MB 时,就会在触达这里的任何 -合作伙伴规则之前被拒绝。在这种大小下,单个资产达到合作伙伴自身20MB 的上限对 inline 内容而言绰绰有余,因此单个资产受合作伙伴规则的约束,而多个资产则受传输上限的约束,因为 Router 的 100 MiB 上限约束的是整个请求,而不是每个元素。接近这些上限的任何内容请以公共 URL 发送。 +合作伙伴规则之前被拒绝。在这种大小下,单个资产达到合作伙伴自身 20MB 的上限,以内联方式发送也绰绰有余,因此单个资产受合作伙伴规则的约束,而多个资产则受传输上限的约束,因为 Router 的 100 MiB 上限约束的是整个请求,而不是每个元素。接近这些上限的任何内容请以公共 URL 发送。 @@ -338,7 +338,7 @@ POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4` @@ -471,7 +471,7 @@ POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使 任务状态 - 可能的值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` + 可选值:`PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`、`CANCELED`、`UNKNOWN` diff --git a/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx b/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx index 8a5c64c373..2aae613917 100644 --- a/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code.mdx @@ -205,7 +205,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests/$REQUEST_ID - happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最多 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最多 100MB,公网 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/BMP/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最多 20MB,公网 URL 或 data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记载任何媒体输入,因此请保持此字段未设置。 - wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些写法枚举任何媒体词汇。wan2.5-i2v-preview 与 wan2.6-i2v 在 img_url 中传入首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 -上述各模型的数量是合作伙伴的约束,而不是本 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受;而反过来说,上文每个资产“最多 20MB”的数字(这是图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产的上限,当资产是公网 URL 时,这些限制按字面生效,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,因此也要满足传输层的上限:Comfy Router 的 POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个内联资产超过约 75 MB 就会在这里的任何合作伙伴规则被触及之前遭到拒绝。在这种大小下,单个资产按合作伙伴自身的20MB 的上限以内可以轻松内联,因此面对单个资产时真正起约束作用的是合作伙伴规则,而传输上限则约束多个资产的情况,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,请以公共 URL 发送。 +上述各模型的数量是合作伙伴的约束,而不是本 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 接受并不意味着提供商接受;而反过来说,上文每个资产“最多 20MB”的数字(这是图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产的上限,当资产是公网 URL 时,这些限制按字面生效,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,因此也要满足传输层的上限:Comfy Router 的 POST 请求体总上限为 100 MiB,超过即返回 413,而 base64 会使载荷膨胀约 4/3,因此单个内联资产超过约 75 MB 就会在这里的任何合作伙伴规则被触及之前遭到拒绝。在这种大小下,按合作伙伴自身 20MB 的上限,单个资产可以轻松内联,因此面对单个资产时真正起约束作用的是合作伙伴规则,而传输上限则约束多个资产的情况,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,请以公共 URL 发送。 @@ -284,7 +284,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.5-t2v-preview/requests/$REQUEST_ID 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则根据分辨率档位确定默认值。 -对于 wan3.0-video,adaptive(默认)会自动推荐合适的基于输入媒体的比例和意图确定的宽高比。 +对于 wan3.0-video,adaptive(默认)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/wan2-6-i2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-6-i2v/code.mdx index cec3ec92fd..3fa7747235 100644 --- a/zh/development/comfy-router/models/wan/wan2-6-i2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-6-i2v/code.mdx @@ -209,10 +209,9 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ - happyhorse-1.0-video-edit:video(恰好 1 个,即被编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。它们的合作伙伴参考文档未记录任何媒体输入,因此请保持此字段未设置。 - wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件没有为这些写法枚举任何 media 类型。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中接收其第一帧;wan2.6-r2v 在 reference_video_urls 中接收其参考片段。 -上述各模型的数量是合作伙伴的约束,而不是此 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 通过校验并不意味着提供商会接受;反过来,上文每个资产的“最大 20MB”数值(图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产所设的上限,当资产是公共 URL 时,它们按原文适用,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,并且也会遇到传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使负载膨胀约 4/3,因此单个内联资产只要超过约 75 MB,就会在触达这里的任何合作伙伴规则之前被拒绝。在这种大小下,单个资产在合作伙伴自身的 +上述各模型的数量是合作伙伴的约束,而不是此 Schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。Schema 通过校验并不意味着提供商会接受;反过来,上文每个资产的“最大 20MB”数值(图像输入的上限,而图像输入是唯一可以内联发送的输入)是合作伙伴对其最终收到的资产所设的上限,当资产是公共 URL 时,它们按原文适用,因为这些字节从不经过 Comfy 传输。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy 传输,并且也会遇到传输上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413,而 base64 会使负载膨胀约 4/3,因此单个内联资产只要超过约 75 MB,就会在触达这里的任何合作伙伴规则之前被拒绝。在这种大小下,单个资产在合作伙伴自身的 20MB 上限对于内联数据来说足够宽裕,因此单个资产真正受限的是合作伙伴规则;多个资产则会触及传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。接近这些上限的任何内容都应作为公共 URL 发送。 -20MB 上限对于内联数据来说足够宽裕,因此单个资产真正受限的是合作伙伴规则;多个资产则会触及传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。接近这些上限的任何内容都应作为公共 URL 发送。 媒体资产类型 @@ -287,7 +286,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-i2v/requests/$REQUEST_ID \ 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,如果未提供,则根据分辨率档位确定默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx index ab3654e9e0..3465c24fad 100644 --- a/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-6-r2v/code.mdx @@ -293,7 +293,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.6-r2v/requests/$REQUEST_ID \ 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可能的值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/wan2-6-t2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-6-t2v/code.mdx index f54c550cfd..c3c72cf6b3 100644 --- a/zh/development/comfy-router/models/wan/wan2-6-t2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-6-t2v/code.mdx @@ -340,7 +340,7 @@ URL 确实会经过 Comfy 传输,并且同样会遇到传输层上限:Comfy 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图决定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/wan2-7-i2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-7-i2v/code.mdx index 347ec603bb..c2c949f7fe 100644 --- a/zh/development/comfy-router/models/wan/wan2-7-i2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-7-i2v/code.mdx @@ -307,7 +307,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-i2v/requests/$REQUEST_ID \ 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,若未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx index 62e949215a..a53743d58d 100644 --- a/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-7-r2v/code.mdx @@ -231,8 +231,8 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-r2v/requests/$REQUEST_ID \ - happyhorse-1.0-video-edit:video(恰好 1 个,即正在编辑的片段:MP4/MOV,3-60 秒,长边最大 4096 像素,短边至少 360 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 100MB,公共 HTTP/HTTPS URL;不接受内联 data: URL),外加可选的 0 到 5 个 reference_image(JPEG/JPG/PNG/WEBP,至少 300x300 像素,宽高比在 1:2.5 到 2.5:1 之间,最大 20MB,公共 URL 或 data:\{MIME_type};base64,... URL)。 - happyhorse-1.0-t2v、happyhorse-1.1-t2v、wan2.7-t2v、wan2.6-t2v、wan2.5-t2v-preview:文生视频操作。其合作伙伴参考文档未记录任何 media 输入,因此不要设置此字段。 - wan2.5-i2v-preview、wan2.6-i2v、wan2.6-r2v:此组件未为这些写法枚举任何 media 词汇。wan2.5-i2v-preview 和 wan2.6-i2v 在 img_url 中传入其首帧;wan2.6-r2v 在 reference_video_urls 中传入其参考片段。 -上述各模型的计数是合作伙伴的约束,不是此 schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不意味着提供商接受;另一方面,上面每个资产“最大 20MB”的数值(即图像输入的上限,也是唯一可能以内联方式发送的输入)是合作伙伴对其最终获得的资产的上限,并且当资产是公共 URL 时按原文适用,因为这些字节从不经过 Comfy。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy,并且还会遇到传输上限:Comfy Router 的 POST 正文总计上限为 100 MiB,超过即返回 413;base64 会使负载膨胀约 4/3,因此单个内联资产若超过大约 75 MB,就会在触达这里的任何合作伙伴规则之前被拒绝。在这种大小下,单个资产在合作伙伴自身的 -20MB 的上限可以轻松容纳内联数据,因此对于单个资产而言,真正起约束作用的是合作伙伴规则;而对于多个资产,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,请以公共 URL 的形式发送。 +上述各模型的计数是合作伙伴的约束,不是此 schema 的约束:media 上未声明 minItems/maxItems,因为可接受的类型及其上限因模型而异。schema 接受并不意味着提供商接受;另一方面,上面每个资产“最大 20MB”的数值(即图像输入的上限,也是唯一可能以内联方式发送的输入)是合作伙伴对其最终获得的资产的上限,并且当资产是公共 URL 时按原文适用,因为这些字节从不经过 Comfy。内联 data:\{MIME_type};base64,... URL 确实会经过 Comfy,并且还会遇到传输上限:Comfy Router 的 POST 正文总计上限为 100 MiB,超过即返回 413;base64 会使负载膨胀约 4/3,因此单个内联资产若超过大约 75 MB,就会在触达这里的任何合作伙伴规则之前被拒绝。在这种大小下,即使单个资产达到合作伙伴自身的 +20MB 的上限,也能以内联方式轻松容纳,因此对于单个资产而言,真正起约束作用的是合作伙伴规则;而对于多个资产,起约束作用的则是传输上限,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。任何接近这些上限的内容,请以公共 URL 的形式发送。 @@ -311,7 +311,7 @@ curl https://api.comfy.org/v2/models/wan/wan2.7-r2v/requests/$REQUEST_ID \ 生成视频的比例。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,如果未提供,则根据分辨率档位确定默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的基于输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/wan2-7-t2v/code.mdx b/zh/development/comfy-router/models/wan/wan2-7-t2v/code.mdx index 2cedb2a259..28b87c1a6f 100644 --- a/zh/development/comfy-router/models/wan/wan2-7-t2v/code.mdx +++ b/zh/development/comfy-router/models/wan/wan2-7-t2v/code.mdx @@ -339,7 +339,7 @@ POST 请求体总大小上限为 100 MiB,超过则返回 413,而 base64 会 生成视频的宽高比。仅适用于 wan2.7 和 wan3.0 模型。 对于 wan2.7 模型,如果未提供,则根据分辨率档位取默认值。 -对于 wan3.0-video,adaptive(默认值)会自动推荐合适的根据输入媒体的比例和意图确定宽高比。 +对于 wan3.0-video,adaptive(默认值)会根据输入媒体的比例和意图自动推荐合适的宽高比。 可选值:`adaptive`、`16:9`、`9:16`、`1:1`、`4:3`、`3:4` diff --git a/zh/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx b/zh/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx index 604224e8aa..79cdab44c6 100644 --- a/zh/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx +++ b/zh/development/comfy-router/models/wan/wan3-0-video-prime/code.mdx @@ -259,7 +259,7 @@ media 中接收其参考资产。图像格式:JPEG、JPG、PNG、BMP、WEBP。 URL 确实会经过 Comfy,并且还会遇到传输层上限:Comfy Router 的 POST 请求体总计上限为 100 MiB,超过即返回 413;而 base64 会使 载荷膨胀约 4/3,因此单个内联资产超过大约 75 MB 时,会在触及此处任何 -合作伙伴规则之前就被拒绝。在这个尺寸下,单个资产即便符合合作伙伴自身的20MB 的上限对内联而言完全够用,因此对于单个资产来说,真正起约束作用的是合作伙伴规则;而传输上限则在同时有多个资产时生效,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。凡是接近这些上限的内容,请以公共 URL 的形式发送。 +合作伙伴规则之前就被拒绝。在这个尺寸下,单个资产按合作伙伴自身的 20MB 上限能轻松地以内联方式容纳,因此对于单个资产来说,真正起约束作用的是合作伙伴规则;而传输上限则在同时有多个资产时生效,因为 100 MiB 的 Router 上限约束的是整个请求,而不是每个元素。凡是接近这些上限的内容,请以公共 URL 的形式发送。 @@ -349,7 +349,7 @@ POST 请求体总计上限为 100 MiB,超过即返回 413;而 base64 会使 - wan3.0-video、wan3.0-video-prime:480P、720P、1080P(上游默认 1080P) - happyhorse-1.0-*(t2v、i2v、r2v、video-edit):720P、1080P - happyhorse-1.1-*(t2v、i2v、r2v):480P、720P、1080P -此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查前将 resolution 转为大写并转发大写后的值,返回 400值超出此枚举范围时会报错,并且在上面列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型上,对 480P(无论以 resolution 还是以 480P 尺寸的形式发送)返回 400。 +此代理会拒绝既未提供 resolution 也未提供 size 的视频生成请求,因为分辨率档位决定计费费率。它会在检查前将 resolution 转为大写并转发大写后的值,对于超出此枚举的值返回 400,并且在上面列为不支持 480P 的 wan2.6、wan2.7 和 happyhorse-1.0 模型上,对 480P(无论以 resolution 还是以 480P 尺寸的形式发送)返回 400。 可能的值:`480P`、`720P`、`1080P` diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index c0b590c16a..a5af9d6e13 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -439,49 +439,49 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭 OK - 该模型的输入和输出 schema,以独立的 OpenAPI 文档形式返回。 - Body:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- Headers:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 响应体:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该文档未发生变化。 - Headers:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` + 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control` 凭证缺失或无效。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 该调用方或该模型不允许此请求。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router 无法完成该请求。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` `rate_limited`:该调用方的请求配额已用尽。请等待 `Retry-After` 后再发送下一个请求。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` Router 暂时不可用。请使用退避策略重试。 - Body:[`RouterErrorResponse`](#routererrorresponse) -- Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `POST /v2/models/{provider}/{model}/requests` @@ -577,7 +577,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ - Inspect `X-Comfy-Error-Type` 响应头:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此应等待 `Retry-After` 指示的时间并复用同一个 key;`invalid_input` 则需要新的 key。此路由上的两种 `invalid_input` 冲突与 key 完全无关,换用新 key 也无法消除:当请求体选择了该提供商针对此模型无法处理的多部分操作(编辑)时,用 `model_provider` 指定替代提供商就会被拒绝,其 `detail` 以 “this request's `image` selects the edit operation” 开头;此外,在该检查之后还会进行另一项检查,如果请求已经为路径中的提供商解析了自带密钥(BYOK)凭据,也会被拒绝,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭据(多部分场景下还不带编辑)。 + 检查 `X-Comfy-Error-Type` 响应头:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此应等待 `Retry-After` 指示的时间并复用同一个 key;`invalid_input` 则需要新的 key。此路由上的两种 `invalid_input` 冲突与 key 完全无关,换用新 key 也无法消除:当请求体选择了该提供商针对此模型无法处理的多部分操作(编辑)时,用 `model_provider` 指定替代提供商就会被拒绝,其 `detail` 以 “this request's `image` selects the edit operation” 开头;此外,在该检查之后还会进行另一项检查,如果请求已经为路径中的提供商解析了自带密钥(BYOK)凭据,也会被拒绝,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭据(多部分场景下还不带编辑)。 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当为 `concurrency_limit_exceeded` 时) @@ -637,67 +637,67 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ OK,即针对一个产生了结果的请求所存储的结果。该请求可以是成功完成的请求,也可以是同时带有已记录扣费和已存储结果的终端请求。结果在合作伙伴自己的媒体类型下原样返回,与同步路由的 `200` 返回完全一致,并遵循提交时所接受的同一套提供商选择约定:不带 `model_provider`,或带 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回本模型的原生约定,转换失败时回退到替代提供商自己的原始响应,并记录日志,绝不静默)时,形状为本模型自己的原生输出;当 `strict_mode=true` 时,返回的是替代提供商的响应,原样不变。对于合作伙伴直接以字节返回生成结果的模型,正文就是这些字节,使用合作伙伴自己的 `Content-Type` 而非 `application/json`;请根据响应的 `Content-Type` 进行分支处理,不要假定它是 JSON 文档。 - Body: [`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`)。Headers: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used` + 响应体:[`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`)。响应头:`X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Credits-Used` Accepted,请求尚未完成。 - Body: [`RouterQueueStatusResponse`](#routerqueuestatusresponse)。Headers: `X-Comfy-Request-Id`, `Retry-After` + 响应体:[`RouterQueueStatusResponse`](#routerqueuestatusresponse)。响应头:`X-Comfy-Request-Id`、`Retry-After` 凭据缺失或无效。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 该调用方或模型不允许此请求。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` `rate_limited`:每个调用方的请求配额已用尽。请等待 `Retry-After` 之后再发送下一个请求。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` Router 暂时不可用。请使用退避策略重试。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 请求处于与该操作冲突的状态。请检查错误类型。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 请求超出了截止时间。重试前请检查错误类型。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。 - Body: [`RouterErrorResponse`](#routererrorresponse)。Headers: `X-Comfy-Error-Type`, `X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` ### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel` @@ -813,49 +813,49 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{ OK,请求当前的队列状态。 - Body:[`RouterQueueStatusResponse`](#routerqueuestatusresponse) ,Headers:`X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` + 响应体:[`RouterQueueStatusResponse`](#routerqueuestatusresponse) ,响应头:`X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source` 凭证缺失或无效。 - Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) ,响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 该调用方或模型无权发起此请求。 - Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) ,响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 未找到该模型 ID。 - Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) ,响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router 请求级别的失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。 - Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) ,响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` `rate_limited`:该调用方的请求配额已用尽。请等待 `Retry-After` 之后再发送下一个请求。 - Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` + 响应体:[`RouterErrorResponse`](#routererrorresponse) ,响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After` Router 暂时不可用。请使用退避策略重试。 - Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) ,响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` Router 请求级别的失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。 - Body:[`RouterErrorResponse`](#routererrorresponse) ,Headers:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` + 响应体:[`RouterErrorResponse`](#routererrorresponse) ,响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id` 此处的描述较为简短。模型选择、验证、重试和计费请参阅[使用 Comfy Router API](/zh/development/comfy-router/api),请求头行为请参阅[请求头](/zh/development/comfy-router/headers)。 @@ -1208,7 +1208,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ 针对 Router 失败的粗粒度、机器可读的分桶,会同步反映在 `X-Comfy-Error-Type` 响应头上,使调用方无需解析响应体即可分支。该集合封闭为二十个值:六个请求级桶 `invalid_input`、`content_policy_violation`、`provider_error`、`provider_timeout`、`insufficient_credits` 和 `model_not_found`,加上传输级的 `unauthorized`、`forbidden`、`concurrency_limit_exceeded`、`client_disconnected`、`internal_error`、`deadline_exceeded`、`not_enabled`、`service_unavailable`、`rate_limited`、`cancelled`、`queue_timeout`、`request_not_found`、`queue_backlog_full` 和 `result_expired`。“封闭”描述的是当前文档所载的集合,并非永远成立的边界:该集合预期会增长,这正是此处刻意使用普通字符串而非 `enum` 的原因,因此客户端必须将无法识别的值视为 `internal_error`,而不是对上表做穷举式 switch,从而在下次新增时出错。 - Type: [`RouterErrorType`](#routererrortype) + 类型:[`RouterErrorType`](#routererrortype) @@ -1226,7 +1226,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ 被拒调用本应扣费的钱包,位于 `RouterErrorResponse.billed_workspace`。它回答“哪个钱包是空的?”:它不一定是调用方 UI 当前选中的工作区;即使打开了资金充足的团队,团队成员的个人凭证也会在此指明其个人钱包。仅与 `denied_reason` 一同存在。 - Type: [`RouterBilledWorkspace`](#routerbilledworkspace) + 类型:[`RouterBilledWorkspace`](#routerbilledworkspace) @@ -1237,7 +1237,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/ 机器可读的 Router 错误类别,同时也会随 `X-Comfy-Error-Type` 响应头一同发送。 -Type: `string` +类型:`string` ### RouterModelBilling @@ -1275,7 +1275,7 @@ Type: `string` 用于 `POST /v2/models/{provider}/{model}` 的模型 ID。 -Type: `string`:模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 +类型:`string`,模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个字符 ### RouterModelInput @@ -1287,7 +1287,7 @@ Type: `string`:模型 ID,例如 `anthropic/claude-opus-4-6`,最多 193 个 用于单个模型输入与输出的独立 OpenAPI 文档。 -Type: `object` +类型:`object` ### RouterModelListEntry diff --git a/zh/development/serverless/library-models.mdx b/zh/development/serverless/library-models.mdx deleted file mode 100644 index d663ff6d05..0000000000 --- a/zh/development/serverless/library-models.mdx +++ /dev/null @@ -1,171 +0,0 @@ ---- -title: "在 Comfy API 部署上使用工作区模型库" -sidebarTitle: "模型库" -description: "将 LoRA 或其他 .safetensors 模型上传到你的工作区模型库,无需新的构建、发布或重新部署,即可在 Comfy API 部署上运行它。" -icon: "folder-open" -translationSourceHash: ece5d691 -translationFrom: development/serverless/library-models.mdx -translationBlockHashes: - "_intro": 6a0b3555 - "Before you start": c7b9ddf9 - "Upload a model to the workspace library": 693a12a3 - "Run the model on your deployment": 8b7df85e - "Follow the limits and naming rules": 5b0d3461 - "Change or delete a library model": dda1b7bd ---- -Comfy API 会运行来自你工作区库中的模型,即使部署的 Release 不包含这些模型。将 LoRA 或其他 `.safetensors` 模型上传到库中,即可在部署上运行它,而无需新的 Build、Release 或重新部署。 - -使用工作区库,可以在部署上试用你训练好的 LoRA,或者通过修改工作流中的一个文件名,为每个 API 请求选用不同的 LoRA。 - -## 开始之前 - -在上传模型到工作区库之前,请确保满足以下要求: - -- **套餐**:你的工作区需要有效的 Pro、Creator、Team 或企业版套餐。 -- **模型文件**:文件必须是大小不超过 2 GB 的 `.safetensors` 文件。较大的基础模型(例如 SDXL 或 Flux)仍应放在 Build 中。 -- **有效部署**:该部署必须与库位于同一工作区。 - - - 部分在工作区库模型可用之前创建的部署无法加载这些模型。要使用工作区库模型,请创建新部署。在较旧的部署上,任务可能会失败,并显示 `Library model "" is unavailable on this deployment. Retry the job. If it still fails, contact support with the job ID.` - - -## 将模型上传到工作区模型库 - -你可以使用以下任意三种工具上传模型: - -- **云端编辑器**:上传文件,或从 Civitai 或 Hugging Face 链接导入。 -- **comfy-cli**:从终端或脚本上传。 -- **开发者平台**:从 Build 的模型步骤上传。 - -选择你所使用工具对应的标签页。 - - - - 1. 在 **运行** 左侧的部署菜单中,确保 **运行于** 下已选择 **Comfy Cloud**。 - 2. 在**左侧边栏**中,点击 **模型库**,然后点击 **导入**。 - 3. 点击 **选择文件**,或将 `.safetensors` 文件拖入对话框。 - 4. 在 **这是什么类型的模型?** 下,如果文件是 LoRA,请保留 **LoRA**,或选择与该文件匹配的类型。 - 5. 点击 **上传**。上传完成后,点击 **完成**。 - - ![导入模型对话框,已选择 my_style_lora_9e2417.safetensors(97.37 MB),这是什么类型的模型?设为 LoRA,并显示返回和上传按钮](/images/development/serverless/library-models-editor-import.png) - - 若要改为从 Civitai 或 Hugging Face 链接导入模型: - - 1. 在 **导入** 对话框中,将模型的链接粘贴到 **粘贴链接到此** 中。 - 2. 点击 **继续**。 - 3. 在 **这是什么类型的模型?** 下,选择模型类型。 - 4. 点击 **导入**。 - - 只有 `.safetensors` 文件才能在部署上运行。以其他格式(例如 `.ckpt`)通过链接导入的模型会导入到模型库中,但无法在部署上运行。 - - - 上传文件,并使用 `--type` 设置其模型类型: - - ```bash - comfy assets library upload my_style.safetensors --type loras - ``` - - 检查文件是否已在模型库中: - - ```bash - comfy assets library ls --tags models,loras - ``` - - - 1. 在开发者平台上,打开某个 Build 的模型步骤,然后点击 **上传模型**。 - 2. 选择 **工作区模型库**。 - 3. 将 `.safetensors` 文件拖到拖放区域,或点击该区域进行浏览。 - 4. 在 **模型类型** 下,如果文件是 LoRA,请保留 **LoRA**,或选择与该文件匹配的类型。 - 5. 点击 **上传**。 - - ![Build 的“哪些模型随构建发布?”步骤上的上传模型对话框,包含公开、私有和工作区模型库标签页,已选择工作区模型库,显示拖放区域,模型类型设为 LoRA,一行文字说明文件已在你的工作区模型库中,以及取消和上传按钮](/images/development/serverless/library-models-platform-upload.png) - - - -模型进入模型库后,工作区的每位成员都可以使用它。模型库接受任何模型类型,不仅限于 LoRA。选择与加载器节点所读取的文件夹相匹配的类型,例如 LoRA 使用 `loras`,VAE 使用 `vae`。 - -## 在您的部署上运行模型 - -模型进入模型库后,您可以从云端编辑器或通过 API 在您的部署上运行它。请根据您提交任务的方式选择对应的选项卡。 - - - - 1. 点击 **Run** 左侧的部署菜单。在 **Run on** 下,选择您的部署。编辑器会重新加载,选项卡会保持打开。 - 2. 添加 `Load LoRA (Model and CLIP)` 节点,或打开包含该节点的工作流。 - 3. 在该节点的 `lora_name` 列表中,选择您的文件。列表会将模型库中的模型与 Release 的模型并列显示。 - 4. 点击 **Run**。 - - 首次运行时,队列中该任务所在的行会显示 `Downloading my_style.safetensors`,同时 worker 正在下载该文件。当任务下载多个模型时,该行会显示 `Downloading ( of )`。 - - ![包含 Load Checkpoint 和 Load LoRA (Model and CLIP) 节点的工作流,在 lora_name 中已选择上传的 LoRA,且队列面板的顶行显示 Downloading my_style_lora_9e2417.safetensors 0 B of 97.37 MB](/images/development/serverless/library-models-editor-downloading.png) - - - 在 [API 格式的工作流](/zh/development/api-development/workflow-api-format) 中,将 `LoraLoader` 节点的 `lora_name` 输入设置为模型库中的文件名,包括 `.safetensors`: - - ```json - "10": { - "class_type": "LoraLoader", - "inputs": { - "lora_name": "my_style.safetensors", - "strength_model": 1.0, - "strength_clip": 1.0, - "model": ["4", 0], - "clip": ["4", 1] - } - } - ``` - - 使用 `comfy deploy run`、[Comfy SDKs](/zh/development/api-development/sdks) 或 [Comfy API v2](/zh/api-reference/v2/overview) 发送工作流: - - ```bash - comfy deploy run --deployment --workflow workflow_api.json - ``` - - 要使用其他 LoRA,请在下一个请求中将 `lora_name` 更改为模型库中的另一个文件名。您无需创建新的 Build 或 Release,也无需重新部署。 - - - - - 使用模型库中的模型时,worker 上的首个任务会耗时更长,因为 worker 会先下载该模型。同一 worker 上的后续任务会使用缓存副本。新的 worker 会再次下载该模型;已将模型从缓存中移除以为其他模型腾出空间的 worker 也会如此。要跳过下载,请将模型添加到 Build。 - - -## 遵守限制和命名规则 - -除了 [开始之前](#开始之前) 中的文件大小和格式限制外,以下限制同样适用: - -| 限制 | 值 | -| --- | --- | -| 工作区存储 | 每个工作区 1 TB 模型,包括通过链接导入的模型 | -| 每个工作流的库模型名称数 | 100 | - -如果加载器引用第 101 个库模型,就会像该文件不在库中一样失败。 - -遵循以下规则,以便任务找到正确的文件: - -- **使用加载器读取的文件夹。** 加载器只会找到其自身模型类型的库文件。`Load LoRA` 节点会找到以 `loras` 上传的文件,而不是以 `checkpoints` 上传的文件。 -- **使用纯文件名。** 将加载器输入仅设置为文件名,例如 `my_style.safetensors`,且文件名前面不带文件夹。 -- **不要复用发布版本中的模型名称。** 如果发布版本已有同名文件,工作进程会使用发布版本的文件,而不是你的库文件。 -- **确保名称在不同文件夹中保持唯一。** 如果库在两个文件夹中有同名文件,而同一个加载器会读取这两个文件夹,那么通过 API 发送的任务不会加载其中任何一个文件。 -- **预期最新文件会胜出。** 如果库在一个文件夹中有两个同名文件,任务会使用最后添加的那个文件。 -- **匹配基础模型。** LoRA 必须与工作流加载的基础模型匹配。 -- **使用部署中提供的加载器。** 加载器节点必须在部署中可用。库模型只能通过 Comfy Cloud 提供的加载器节点加载。如果你的加载器来自 Comfy Cloud 没有的自定义节点,请将其模型添加到 Build 中。 - -## 更改或删除模型库中的模型 - -当在 **运行于** 下选择了部署时,**模型库**只列出该 Release 的模型。要更改或删除模型库中的模型,请先切换回 Comfy Cloud: - -1. 点击 **运行** 左侧的部署菜单。在 **运行于** 下,选择 **Comfy Cloud**。 -2. 在**左侧边栏**中,点击**模型库**。 - -要更改模型类型: - -- 将鼠标悬停在模型卡片上,点击**模型信息**,然后选择新的**模型类型**。 - - - 删除模型会将其从所有成员的工作区模型库中移除。仍引用该文件的任务或 API 请求会在加载器输入处失败,并报 `Value not in list` 错误。 - - -要删除模型: - -1. 将鼠标悬停在模型卡片上,点击**更多**,然后点击**删除**。 -2. 在**删除此模型?**中,点击**删除**。 diff --git a/zh/development/serverless/overview.mdx b/zh/development/serverless/overview.mdx index 04bb31d86a..94136f73ca 100644 --- a/zh/development/serverless/overview.mdx +++ b/zh/development/serverless/overview.mdx @@ -174,7 +174,7 @@ comfy deploy events --deployment dep_123456 存储计费从部署开始: - - 部署某个发布版本时,其模型会被暂存到该部署的 worker 共享的网络存储上。部署完成后该存储为只读,只要该区域内还存在该 Build 的任何部署,就会按 GB-月 计费,包括使用 `comfy deploy stop` 暂停部署期间。任务从你的[工作区库](/zh/development/serverless/library-models)中使用的模型不会暂存到那里,而是由 worker 为该任务下载。 + - 部署某个发布版本时,其模型会被暂存到该部署的 worker 共享的网络存储上。部署完成后该存储为只读,只要该区域内还存在该 Build 的任何部署,就会按 GB-月 计费,包括使用 `comfy deploy stop` 暂停部署期间。任务从你的[工作区库](/zh/development/deploy/cloud-custom-builds#添加自己的-lora-或模型)中使用的模型不会暂存到那里,而是由 worker 为该任务下载。 - 每个 worker 还会获得一块固定的 50 GB 容器磁盘。它是临时的,仅在 worker 运行期间计费,并计入该 worker 的计算费用。 - 删除部署会释放其计算资源。当该区域内最后一个使用该暂存网络存储的部署被删除后,存储会很快被清理,其计费也随之结束。 diff --git a/zh/tutorials/flux/flux-3-klein.mdx b/zh/tutorials/flux/flux-3-klein.mdx index 2574baa123..b300470b74 100644 --- a/zh/tutorials/flux/flux-3-klein.mdx +++ b/zh/tutorials/flux/flux-3-klein.mdx @@ -87,10 +87,10 @@ FLUX.3 [klein] 是 Black Forest Labs 面向本地 ComfyUI 的开源权重 FLUX.3 FLUX 3 Image Klein 图像编辑工作流预览 - + 在 Comfy Cloud 中打开 - + 下载 JSON,或在模板库中搜索 "FLUX 3 Image Klein: Image Edit" @@ -113,7 +113,7 @@ FLUX.3 [klein] 是 Black Forest Labs 面向本地 ComfyUI 的开源权重 FLUX.3 2. 将其连接到 `Set Reference Multi Latent`。第一个参考在提示词中为 ``,下一个为 ``,依此类推 3. 将编辑内容写为对结果的完整描述,写在 `FLUX 3 Image Layout Prompt` 节点里。随附的示例中,提示词为 `In , change the dress color to red` 4. 如果想要不同的输出尺寸,可使用 `Empty Flux 2 Latent` 调整画布(模板中为 1024 x 1024) -5. 点击 **队列**。`ImageCompare` 会并排显示输入和结果 +5. 点击 **Queue**。`ImageCompare` 会并排显示输入和结果 **示例输出** @@ -154,7 +154,7 @@ FLUX.3 [klein] 是 Black Forest Labs 面向本地 ComfyUI 的开源权重 FLUX.3 1. 加载要编辑的图像,并将其连接到 `Set Reference Multi Latent` 2. 在 `FLUX 3 Image Layout Prompt` 节点中编写编辑提示词。随附的示例会替换耳环,并详细描述新的耳环,包括哪些内容不能出现 3. 将 `steps` 保持在 4 到 16 的范围内,并将 `cfg` 保持为 1 -4. 点击 **队列**,在 `ImageCompare` 中对比输入与结果 +4. 点击 **Queue**,在 `ImageCompare` 中对比输入与结果 ## FLUX 3 Image Klein 模型下载 diff --git a/zh/tutorials/video/ltx/ltx-2-3.mdx b/zh/tutorials/video/ltx/ltx-2-3.mdx index b8b84d471d..85b219d1c5 100644 --- a/zh/tutorials/video/ltx/ltx-2-3.mdx +++ b/zh/tutorials/video/ltx/ltx-2-3.mdx @@ -200,7 +200,7 @@ ComfyUI/ --- ### LTX-2.3 首尾帧转视频(`video_ltx2_3_flf2v`) {#video_ltx2_3_flf2v} -在起始图像和结束图像之间进行插值。 +在起始图像和结束图像之间进行插值,生成流畅的视频过渡。 @@ -530,7 +530,7 @@ Remove subtitles, captions, and related text occlusions from the video, restorin --- ### LTX-2.3 ID LoRA(`video_ltx2_3_id_lora`) {#video_ltx2_3_id_lora} -从参考图像和音频片段生成带同步音频的个性化视频。 +根据文本提示、参考图像和短音频片段生成带同步音频的个性化视频。使用 ID-LoRA 在单个生成模型中适配人物的外貌和声音。